feat(/xref): expose htmlProse field from webref

@types/webref.d.ts

@@ -18,6 +18,7 @@ declare module "webref" {
     informative: boolean;
     heading: Record<string, string>;
     definedIn: string;
+    htmlProse: string;
   }
 
   interface SpecVersion {

routes/xref/lib/scraper.ts

@@ -146,6 +146,7 @@ function mapDefinition(
     uri: dfn.href.replace(spec.url, ""), // This is full URL to term here
     normative: !dfn.informative,
     for: dfn.for.length > 0 ? dfn.for : undefined,
+    htmlProse: dfn.htmlProse,
   };
 }
 

routes/xref/lib/search.ts

@@ -26,6 +26,7 @@ export interface DataEntry {
   uri: string;
   normative: boolean;
   for?: string[];
+  htmlProse?: string;
 }
 
 type SpecType = DataEntry["status"] | "draft" | "official";
@@ -58,7 +59,7 @@ const specStatusAlias = new Map([
 ]);
 
 export const defaultOptions: Options = {
-  fields: ["shortname", "spec", "type", "for", "normative", "uri"],
+  fields: ["shortname", "spec", "type", "for", "normative", "uri", "htmlProse"],
   spec_type: ["draft", "official"],
   types: [],
 };

tests/routes/xref/lib/data-by-term.js

@@ -41,6 +41,8 @@ export default {
       shortname: "font-metrics-api",
       status: "current",
       uri: "#baseline",
+      normative: true,
+      htmlProse: "test html Prose",
     },
   ],
   baseline: [

tests/routes/xref/lib/search.test.js

@@ -60,6 +60,9 @@ describe("xref - search", () => {
             spec: "font-metrics-api-1",
             type: "interface",
             uri: "#baseline",
+            normative: true,
+            htmlProse: "test html Prose",
+            for: undefined,
           },
         ]);
       });

tests/routes/xref/lib/utils.test.js

@@ -24,7 +24,8 @@ describe("xref - utils", () => {
     });
     expect(utils.pickFields(object, ["foo", "nope", "bar"])).toEqual({
       foo: object.foo,
-      bar: object.foo,
+      bar: object.bar,
+      nope: undefined,
     });
     expect(utils.pickFields(object, ["bar"]).bar).toBe(object.bar);
   });