@forsakringskassan/docs-generator 2.29.3 → 2.30.0

package/dist/index.mjs

@@ -4,8 +4,8 @@ const require = $createRequire(import.meta.url);
 
 import fs from 'node:fs/promises';
 import path from 'node:path/posix';
-import { g as globSync, m as minimatch, M as MarkdownIt, d as dedent, b as closest, e as distance, f as fm, i as isCI, h as glob, j as moduleImporter, k as cliProgress, t as tinylr, w as watch, l as createInstance, n as fse } from './vendor-COMHgwYY.mjs';
-import { g as generateId, p as parseInfostring, i as isDocumentPage, n as normalizePath, a as getFingerprint, h as hasTag, f as findTag, b as getOutputFilePath, d as htmlencode, e as exampleWorkerUrl, c as createMarkdownRenderer, j as generateExample } from './create-markdown-renderer-Bqm7kdpQ.mjs';
+import { g as globSync, m as minimatch, M as MarkdownIt, d as dedent, b as closest, e as distance, f as fm, i as isCI, h as glob, j as moduleImporter, k as cliProgress, t as tinylr, w as watch, l as createInstance, n as fse, o as inter } from './vendor-B6t9njJr.mjs';
+import { g as generateId, p as parseInfostring, i as isDocumentPage, n as normalizePath, a as getFingerprint, h as hasTag, f as findTag, b as getOutputFilePath, d as htmlencode, e as exampleWorkerUrl, c as createMarkdownRenderer, j as generateExample } from './create-markdown-renderer-D5LtM0yF.mjs';
 import path$1 from 'node:path';
 import require$$1 from 'crypto';
 import 'node:crypto';
@@ -125,16 +125,16 @@ function fileMatcher(patterns) {
 function formatSize(value) {
   const suffices = ["kB", "MB"];
   if (value < 1e3) {
-    return `${value}`;
+    return String(value);
   }
   for (const suffix of suffices) {
     value = Math.round(value / 1e3 * 100) / 100;
     if (value < 1e3) {
-      return `${value} ${suffix}`;
+      return `${String(value)} ${suffix}`;
     }
   }
   value = Math.round(value / 1e3 * 100) / 100;
-  return `${value} GB`;
+  return `${String(value)} GB`;
 }
 
 const matchHeading = /^(#+)(.*)$/gm;
@@ -183,12 +183,12 @@ function getIntegrity(source) {
 function getPullRequestID(env) {
   if (env.JOB_BASE_NAME) {
     const name = env.JOB_BASE_NAME;
-    const match = name.match(/^PR-(\d+)$/);
+    const match = /^PR-(\d+)$/.exec(name);
     return match ? match[1] : void 0;
   }
   if (env.GITHUB_REF) {
     const name = env.GITHUB_REF;
-    const match = name.match(/^refs\/pull\/([^/]+)\/merge$/);
+    const match = /^refs\/pull\/([^/]+)\/merge$/.exec(name);
     return match ? match[1] : void 0;
   }
   return void 0;
@@ -204,7 +204,7 @@ function getRepositoryUrl(value) {
     value = url;
   }
   value = value.replace(/^git[+]/, "");
-  const ssh = value.match(RE_MATCH_SSH);
+  const ssh = RE_MATCH_SSH.exec(value);
   if (ssh) {
     const { host, path } = ssh.groups;
     value = `https://${host}/${path}`;
@@ -242,7 +242,8 @@ function haveOutput(doc) {
 function interpolate(value, data) {
   return value.replace(/{{([^{}]+)}}/g, (match, raw) => {
     const key = raw.trim();
-    return data[key] ?? match;
+    const value2 = data[key];
+    return value2 ?? match;
   });
 }
 
@@ -376,7 +377,7 @@ const md$5 = MarkdownIt();
 md$5.renderer.rules.fence = (tokens, idx, _options, collected) => {
   const { content, info, map } = tokens[idx];
   const { language: rawLanguage, tags } = parseInfostring(info);
-  const hashContent = `${map?.[0]}:${map?.[1]}:${info}:${content}`;
+  const hashContent = `${String(map?.[0])}:${String(map?.[1])}:${info}:${content}`;
   const fingerprint = getFingerprint(hashContent);
   let extension = void 0;
   let language = rawLanguage;
@@ -418,7 +419,7 @@ function manifestPageFromDocument(doc) {
   const { body, fileInfo, format } = doc;
   return {
     path: getOutputFilePath("", fileInfo),
-    title: doc.attributes.title ?? doc.name ?? "",
+    title: doc.attributes.title ?? doc.name,
     redirect: format === "redirect" ? body : null,
     outline: flattenOutline(doc.outline),
     examples: findExamples(doc)
@@ -691,7 +692,7 @@ function redirectProcessor() {
   return {
     name: "redirect-processor",
     after: "generate-docs",
-    async handler(context) {
+    handler(context) {
       const redirects = getRedirects(context.docs);
       for (const redirect of redirects) {
         const { dir, base, name } = path.parse(redirect.from);
@@ -908,7 +909,7 @@ function cookieProcessor(options = {}) {
   return {
     after: "generate-docs",
     name: "cookie-processor",
-    async handler(context) {
+    handler(context) {
       if (!enabled) {
         return;
       }
@@ -940,7 +941,7 @@ const suggestions = {
   hidden: "visible"
 };
 function findLocation(content, attr) {
-  const match = content.match(/^---\n(.*?)^---/ms);
+  const match = /^---\n(.*?)^---/ms.exec(content);
   if (!match || match.index !== 0) {
     return null;
   }
@@ -1073,7 +1074,7 @@ function parseFile$1(filePath, basePath, content) {
   const attributes = blocks.attributes;
   const isIndex = isIndexPage(parsed);
   const filename = isIndex ? "index" : parsed.name.toLowerCase();
-  const name = attributes.name ? attributes.name : parsed.name;
+  const name = attributes.name ?? parsed.name;
   const urlpath = parsed.dir;
   const outline = getDocumentOutline(blocks.body);
   const include = attributes.include ?? true;
@@ -1118,10 +1119,10 @@ async function frontMatterFileReader(filePath, basePath) {
 
 function getPropSlotDeprecated(prop) {
   const tags = prop.tags;
-  if (!tags) {
+  if (!tags?.deprecated) {
     return null;
   }
-  const tag = tags["deprecated"]?.[0];
+  const tag = tags.deprecated[0];
   if (!tag?.description) {
     return null;
   }
@@ -1148,7 +1149,7 @@ function getEventDeprecated(event) {
 }
 function translateProps(props) {
   const isRelevant = (prop) => {
-    return prop.tags?.["ignore"] === void 0;
+    return prop.tags?.ignore === void 0;
   };
   return props.filter(isRelevant).map((prop) => {
     const defaultValue = prop.defaultValue ? { value: prop.defaultValue.value } : null;
@@ -1194,8 +1195,8 @@ function translateEventProperties(event) {
     const property = properties[i];
     const name = property.name ?? "<anonymous>";
     const eventType = types[i];
-    const hasEventType = !eventType || eventType !== "undefined";
-    const type = hasEventType ? eventType : String(property.type.names);
+    const hasEventType = Boolean(eventType) && eventType !== "undefined";
+    const type = hasEventType ? eventType : property.type.names.join(" ");
     const description = typeof property.description === "string" ? property.description : null;
     translatedProperties.push({
       name,
@@ -1262,19 +1263,26 @@ function filterModels(rawProps, rawEvents) {
   return { models, props, events };
 }
 async function translateAPI(filePath) {
-  const api = await parse(filePath);
-  const rawProps = api.props ? translateProps(api.props) : [];
-  const rawEvents = api.events ? translateEvents(api.events) : [];
-  const { models, props, events } = filterModels(rawProps, rawEvents);
-  const slots = api.slots ? translateSlots(api.slots) : [];
-  return {
-    name: api.displayName,
-    slug: slugify(api.displayName),
-    models,
-    props,
-    events,
-    slots
-  };
+  try {
+    const api = await parse(filePath);
+    const rawProps = api.props ? translateProps(api.props) : [];
+    const rawEvents = api.events ? translateEvents(api.events) : [];
+    const { models, props, events } = filterModels(rawProps, rawEvents);
+    const slots = api.slots ? translateSlots(api.slots) : [];
+    return {
+      name: api.displayName,
+      slug: slugify(api.displayName),
+      models,
+      props,
+      events,
+      slots
+    };
+  } catch (err) {
+    throw new Error(
+      `Failed to generate API description from "${filePath}"`,
+      { cause: err }
+    );
+  }
 }
 
 const md$4 = MarkdownIt();
@@ -1408,9 +1416,9 @@ function generateEventTable(slug, events) {
                             ${haveProperties ? `<p class="docs-api__list-title">Arguments:</p><ul class="docs-api__list">` : ""}
                             ${event.properties.map((it) => {
           if (it.description) {
-            return `<li><code>${htmlencode(it.name)}: ${htmlencode(it.type ?? "unknown")}</code> ${EM_DASH$2} ${renderInline$2(it.description)}</li>`;
+            return `<li><code>${htmlencode(it.name)}: ${htmlencode(it.type)}</code> ${EM_DASH$2} ${renderInline$2(it.description)}</li>`;
           } else {
-            return `<li><code>${htmlencode(it.name)}: ${htmlencode(it.type ?? "unknown")}</code></li>`;
+            return `<li><code>${htmlencode(it.name)}: ${htmlencode(it.type)}</code></li>`;
           }
         }).join("")}
                             ${haveProperties ? `</ul>` : ""}
@@ -1463,9 +1471,9 @@ function generateSlotTable(slug, slots) {
                             ${haveBindings ? `<p class="docs-api__list-title">Bindings:</p><ul class="docs-api__list">` : ""}
                             ${slot.bindings.map((it) => {
           if (it.description) {
-            return `<li><code>${htmlencode(it.name)}: ${htmlencode(it.type ?? "unknown")}</code> ${EM_DASH$1} ${renderInline$1(it.description)}</li>`;
+            return `<li><code>${htmlencode(it.name)}: ${htmlencode(it.type)}</code> ${EM_DASH$1} ${renderInline$1(it.description)}</li>`;
           } else {
-            return `<li><code>${htmlencode(it.name)}: ${htmlencode(it.type ?? "unknown")}</code></li>`;
+            return `<li><code>${htmlencode(it.name)}: ${htmlencode(it.type)}</code></li>`;
           }
         }).join("")}
                             ${haveBindings ? `</ul>` : ""}
@@ -1572,7 +1580,7 @@ function findDocComment(path, node) {
     }
   }
   const grandparent = path.parentPath?.parent;
-  if (parent.type === "VariableDeclarator" && grandparent && grandparent.leadingComments) {
+  if (parent.type === "VariableDeclarator" && grandparent?.leadingComments) {
     const doc = grandparent.leadingComments.find(isDocComment);
     if (doc) {
       return doc;
@@ -1971,7 +1979,7 @@ async function compileScript(options) {
       ...buildOptions,
       define: {
         "process.env.DOCS_ICON_LIB": JSON.stringify(iconLib),
-        ...buildOptions?.define
+        ...buildOptions.define
       }
     });
     const content = await fs$1.readFile(outfile, "utf-8");
@@ -2312,6 +2320,7 @@ class TemplateLoader {
     this.folders = [...folders, templateDirectory];
     this.templateCache = /* @__PURE__ */ new Map();
   }
+  /* eslint-disable-next-line @typescript-eslint/no-misused-promises -- technical debt */
   async getSource(name, callback) {
     try {
       const { content, filePath } = await this.resolveTemplate(name);
@@ -2415,7 +2424,7 @@ function findTemplate(folders, from, src, format) {
 
 const messageRegex = /^[(][^)]+[)] \[Line \d+, Column \d+\]\n\s+Error: (.*)$/;
 function getActualMessage(message) {
-  const match = message.match(messageRegex);
+  const match = messageRegex.exec(message);
   if (match) {
     return match[1].trim();
   } else {
@@ -2691,7 +2700,7 @@ async function render(doc, docs, nav, vendors, options) {
       });
       const content2 = await Promise.all(promises);
       const markup = content2.join("");
-      return callback(null, new nunjucks.runtime.SafeString(markup));
+      callback(null, new nunjucks.runtime.SafeString(markup));
     }
   });
   await mkdir;
@@ -2716,7 +2725,7 @@ async function render(doc, docs, nav, vendors, options) {
       return match;
     }
   });
-  const writeFile = fs.writeFile(expandedDst, content ?? "null", "utf-8");
+  const writeFile = fs.writeFile(expandedDst, content, "utf-8");
   try {
     const assets = Object.values(templateData.assets).filter(
       (it) => it.importmap
@@ -2873,7 +2882,7 @@ async function compileVendor(assetFolder, vendor, options) {
       __VUE_PROD_DEVTOOLS__: "true",
       __VUE_PROD_HYDRATION_MISMATCH_DETAILS__: "false"
     },
-    alias: vendor.alias ? { [`${vendor.package}`]: vendor.alias } : void 0,
+    alias: vendor.alias ? { [vendor.package]: vendor.alias } : void 0,
     ...options
   });
   const content = await fs.readFile(outfile, "utf-8");
@@ -2964,7 +2973,7 @@ async function keypress() {
 function printMenu(addr) {
   console.log();
   console.group(
-    `Starting development server at http://localhost:${addr.port}`
+    `Starting development server at http://localhost:${String(addr.port)}`
   );
   console.log();
   console.log("[q] quit");
@@ -3031,7 +3040,7 @@ async function serve(options) {
     });
     livereload.changed({ body: { files } });
   });
-  watcher.on("change", async (filePath) => {
+  watcher.on("change", (filePath) => {
     rebuild(filePath);
   });
   for (; ; ) {
@@ -3168,7 +3177,7 @@ function createContext(outputFolder, templateLoader) {
       return templateBlocks;
     },
     hasTemplate(name) {
-      return Boolean(templateLoader?.hasTemplate(name));
+      return templateLoader.hasTemplate(name);
     },
     setTopNavigation(root) {
       topnav = root;
@@ -3340,6 +3349,7 @@ class Generator {
     });
     await i18n.init();
     await this._prepareFolders();
+    await this._copyFonts();
     const processors = [
       fileReaderProcessor(sourceFiles),
       redirectProcessor(),
@@ -3401,6 +3411,17 @@ class Generator {
     await fs.mkdir(assetFolder, { recursive: true });
     await fs.mkdir("temp", { recursive: true });
   }
+  async _copyFonts() {
+    const { assetFolder } = this;
+    const files = inter.subsets.map((subset) => {
+      const filename = `inter-${subset}-wght-normal.woff2`;
+      const module = `@fontsource-variable/inter/files/${filename}`;
+      const src = fileURLToPath(import.meta.resolve(module));
+      const dst = path$1.join(assetFolder, filename);
+      return fs.copyFile(src, dst);
+    });
+    await Promise.all(files);
+  }
 }
 
 function generateIndex(entries) {