@forsakringskassan/docs-generator 3.3.1 → 3.3.3

package/dist/index.mjs

@@ -3,12 +3,12 @@ import { createRequire as $createRequire } from "node:module";
 const require = $createRequire(import.meta.url);
 
 import { ApiItemKind, ApiModel } from '@microsoft/api-extractor-model';
-import { t as ts, Z as Ze, M as MarkdownIt, d as dedent, g as closest, h as distance, i as fm, j as isCI, m as moduleImporter, k as cliProgress, l as tinylr, w as watch, n as createInstance, o as fse, p as inter } from './vendor-DjC7coI1.mjs';
+import { t as ts, Z as Ze, M as MarkdownIt, d as dedent, g as closest, h as distance, i as fm, j as isCI, m as moduleImporter, k as cliProgress, l as tinylr, w as watch, n as createInstance, o as fse, p as inter } from './vendor-CjH-H-vc.mjs';
 import path__default from 'node:path';
 import crypto from 'node:crypto';
 import path from 'node:path/posix';
 import { exec, execSync } from 'node:child_process';
-import { g as generateId, f as formatCode, p as parseInfostring, i as isDocumentPage, n as normalizePath, a as getFingerprint, h as hasTag, b as parseImport, d as findTag, e as getOutputFilePath, j as htmlencode, k as filePath, c as createMarkdownRenderer, l as generateExample } from './create-markdown-renderer-39oFx5NW.mjs';
+import { g as generateId, f as formatCode, p as parseInfostring, i as isDocumentPage, n as normalizePath, a as getFingerprint, h as hasTag, b as parseImport, d as findTag, e as getOutputFilePath, j as htmlencode, k as filePath, c as createMarkdownRenderer, l as generateExample } from './create-markdown-renderer-O3H4lWpJ.mjs';
 import { DocExcerpt } from '@microsoft/tsdoc';
 import fs from 'node:fs/promises';
 import util, { promisify, styleText } from 'node:util';
@@ -51,7 +51,7 @@ import 'fs/promises';
 import 'process';
 import 'v8';
 import 'vue';
-import './vue3-B3-18vX3.mjs';
+import './vue3-DbJPWpmQ.mjs';
 
 function toArray$2(value) {
   return Array.isArray(value) ? value : [value];
@@ -104,21 +104,21 @@ function fileMatcher(patterns) {
       const additionalInfo = context ? ` (${context})` : "";
       const message = `No files matched pattern "${filename}"${additionalInfo}`;
       throw new Error(message);
-    } else if (matches.length > 1) {
+    }
+    if (matches.length > 1) {
       const additionalInfo = context ? ` (${context})` : "";
       const message = `Multiple files matched pattern "${filename}"${additionalInfo}. Searched in [${patterns.join(", ")}]`;
       throw new Error(message);
-    } else {
-      return matches[0];
     }
+    return matches[0];
   });
 }
 
 function formatSize(value) {
-  const suffices = ["kB", "MB"];
   if (value < 1e3) {
     return String(value);
   }
+  const suffices = ["kB", "MB"];
   for (const suffix of suffices) {
     value = Math.round(value / 1e3 * 100) / 100;
     if (value < 1e3) {
@@ -221,9 +221,8 @@ function runCommand(cmd, defaultValue) {
 const gitCommitHash = memoize((format = "short") => {
   if (format === "full") {
     return runCommand(`git rev-parse HEAD`);
-  } else {
-    return runCommand(`git rev-parse --short HEAD`);
   }
+  return runCommand(`git rev-parse --short HEAD`);
 });
 
 function haveOutput(doc) {
@@ -315,9 +314,8 @@ function documentation(node) {
   if (node && isDocumentedItem(node)) {
     const { tsdocComment } = node;
     return renderNode(tsdocComment?.summarySection).trim();
-  } else {
-    return void 0;
   }
+  return void 0;
 }
 function documentationComment(node) {
   const doc = documentation(node);
@@ -399,11 +397,14 @@ function collectMembers(item, inherit) {
   const hierarchy = getInheritance(item);
   const members = /* @__PURE__ */ new Map();
   for (const iface of hierarchy) {
-    for (const member of iface.members.filter(isSupported)) {
+    for (const member of iface.members) {
+      if (!isSupported(member)) {
+        continue;
+      }
       members.set(member.name, member);
     }
   }
-  return [...members.values()];
+  return members.values().toArray();
 }
 function isSupported(item) {
   return [
@@ -438,7 +439,7 @@ function renderProperties(members) {
       if (it2.trim() === "") {
         return "\n";
       }
-      const prefix = i === 0 ? ": " : "    ";
+      const prefix = i === 0 ? ": " : " ".repeat(4);
       return `${prefix}${it2.trim()}
 `;
     }) : [": &dash;\n"];
@@ -534,7 +535,8 @@ function apiExtractorProcessor(options = {}) {
       const symbols = {
         interface: []
       };
-      for (const filename of await getFilenames(patterns)) {
+      const filenames = await getFilenames(patterns);
+      for (const filename of filenames) {
         const apiModel = new ApiModel();
         const apiPackage = apiModel.loadPackage(filename);
         walk(apiPackage, {
@@ -613,9 +615,8 @@ function getSuffix(tags) {
   const relevant = tags.filter((it) => ["nocompile", "nolint"].includes(it));
   if (relevant.length > 0) {
     return `-${relevant.join("-")}`;
-  } else {
-    return "";
   }
+  return "";
 }
 function getExtension(lang) {
   switch (lang) {
@@ -925,7 +926,13 @@ function htmlRedirectProcessor() {
     after: "render",
     async handler(context) {
       const { docs, outputFolder } = context;
-      for (const doc of docs.filter(isDocumentPage).filter(haveOutput)) {
+      for (const doc of docs) {
+        if (!isDocumentPage(doc)) {
+          continue;
+        }
+        if (!haveOutput(doc)) {
+          continue;
+        }
         if (doc.format !== "redirect") {
           continue;
         }
@@ -1057,12 +1064,11 @@ function isNavigationSection(node) {
 function pathFromDoc({ fileInfo }) {
   if (fileInfo.name === "index") {
     return [fileInfo.path.replaceAll("\\", "/"), true];
-  } else {
-    return [
-      `./${path__default.join(fileInfo.path, fileInfo.name).replaceAll("\\", "/")}`,
-      false
-    ];
   }
+  return [
+    `./${path__default.join(fileInfo.path, fileInfo.name).replaceAll("\\", "/")}`,
+    false
+  ];
 }
 function getParentKey(name) {
   return name.split("/").slice(0, -1).join("/");
@@ -1110,7 +1116,7 @@ function generateNavtree(docs) {
     let current = parent;
     while (anchestor !== ".") {
       anchestor = getParentKey(anchestor);
-      if (section[anchestor]) {
+      if (Object.hasOwn(section, anchestor)) {
         section[anchestor].children.push(current);
         break;
       }
@@ -1204,16 +1210,15 @@ function generateNavtree(docs) {
   const root = section["."];
   if (root) {
     return root;
-  } else {
-    return {
-      key: ".",
-      title: "",
-      path: "",
-      sortorder: Infinity,
-      children: [],
-      visible: true
-    };
   }
+  return {
+    key: ".",
+    title: "",
+    path: "",
+    sortorder: Infinity,
+    children: [],
+    visible: true
+  };
 }
 
 function generateNavigation(entries, navtree) {
@@ -1280,9 +1285,8 @@ async function getGitBranch() {
   );
   if (branch === "HEAD" || branch === "") {
     return "unknown";
-  } else {
-    return branch;
   }
+  return branch;
 }
 async function getSCMData(pkg, options) {
   const commitHash = await gitCommitHash("full");
@@ -1459,11 +1463,11 @@ class AttributeError extends Error {
         message: suggestion
       });
       return [message, "", codeframe].join("\n");
-    } else if (d <= threshold) {
+    }
+    if (d <= threshold) {
       return [message, "", suggestion].join("\n");
-    } else {
-      return message;
     }
+    return message;
   }
 }
 
@@ -1518,9 +1522,8 @@ function normalizeComponent(value) {
     return {
       name: value
     };
-  } else {
-    return value;
   }
+  return value;
 }
 function getComponentAlias(value) {
   const { name } = normalizeComponent(value);
@@ -1757,11 +1760,11 @@ function findTranslations(filename, content) {
       const { node } = path;
       if (isTranslateCall(node)) {
         const [name, ...defaultOrParams] = node.arguments;
-        const textArgument = defaultOrParams.find(isStringLiteral);
-        const paramArgument = defaultOrParams.find(isObjectExpression);
         if (name.type !== "StringLiteral") {
           return;
         }
+        const textArgument = defaultOrParams.find(isStringLiteral);
+        const paramArgument = defaultOrParams.find(isObjectExpression);
         const defaultTranslation = textArgument ? textArgument.value : null;
         const docComment = findDocComment(path, node);
         result.push({
@@ -1816,9 +1819,8 @@ function generateEventTable(slug, events) {
                             ${event.properties.map((it) => {
           if (it.description) {
             return `<li><code>${htmlencode(it.name)}: ${htmlencode(it.type)}</code> ${EM_DASH$2} ${renderInline$4(it.description)}</li>`;
-          } else {
-            return `<li><code>${htmlencode(it.name)}: ${htmlencode(it.type)}</code></li>`;
           }
+          return `<li><code>${htmlencode(it.name)}: ${htmlencode(it.type)}</code></li>`;
         }).join("")}
                             ${haveProperties ? `</ul>` : ""}
                             ${event.deprecated ? `<p class="docs-api__deprecated docs-deprecated">Deprecated: ${renderInline$4(event.deprecated)}</p>` : ""}
@@ -1963,9 +1965,8 @@ function generateSlotTable(slug, slots) {
                             ${slot.bindings.map((it) => {
           if (it.description) {
             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)}</code></li>`;
           }
+          return `<li><code>${htmlencode(it.name)}: ${htmlencode(it.type)}</code></li>`;
         }).join("")}
                             ${haveBindings ? `</ul>` : ""}
                             ${slot.deprecated ? `<p class="docs-api__deprecated docs-deprecated">Deprecated: ${renderInline$1(slot.deprecated)}</p>` : ""}
@@ -2015,9 +2016,8 @@ function generateTranslationTable(slug, translations) {
                             ${translation.parameters.map((it) => {
           if (it.description) {
             return `<li><code>${htmlencode(it.name)}</code> ${EM_DASH} ${renderInline(it.description)}</li>`;
-          } else {
-            return `<li><code>${htmlencode(it.name)}</code></li>`;
           }
+          return `<li><code>${htmlencode(it.name)}</code></li>`;
         }).join("")}
                             ${haveParameters ? `</ul>` : ""}
                         </dd>
@@ -2040,9 +2040,8 @@ function getPropSlotDeprecated(prop) {
   }
   if (tag.description === true) {
     return "";
-  } else {
-    return tag.description;
   }
+  return tag.description;
 }
 function getEventDeprecated(event) {
   const tags = event.tags;
@@ -2055,9 +2054,8 @@ function getEventDeprecated(event) {
   }
   if (tag.content === true) {
     return "";
-  } else {
-    return tag.content;
   }
+  return tag.content;
 }
 function isSimpleName(name) {
   return /^[\da-z]+$/i.test(name);
@@ -2078,9 +2076,8 @@ function getPropType(prop) {
     }
     if (isSimpleName(element.name)) {
       return `${element.name}[]`;
-    } else {
-      return `Array<${element.name}>`;
     }
+    return `Array<${element.name}>`;
   }
   if (type.name === "tuple") {
     const param = type;
@@ -2297,7 +2294,7 @@ async function globAll(pattern) {
     return /* @__PURE__ */ new Set();
   }
   if (!Array.isArray(pattern)) {
-    return globAll([pattern]);
+    pattern = [pattern];
   }
   const results = await Promise.all(
     pattern.map((it) => Ze(it, { nodir: true }))
@@ -2333,9 +2330,8 @@ async function getDocumentsForSource(context, src, index) {
     const docs2 = await src.fileReader(it, src.basePath);
     if (transform) {
       return docs2.map((it2) => transform(it2));
-    } else {
-      return docs2;
     }
+    return docs2;
   });
   const docs = await Promise.all(promises);
   return docs.flat();
@@ -2614,8 +2610,8 @@ function compileProcessorRuntime(generator, distDir, processors) {
     if (processor.enabled === false) {
       continue;
     }
-    const { runtime } = processor;
-    for (const entry of runtime ?? []) {
+    const { runtime = [] } = processor;
+    for (const entry of runtime) {
       const assetName = [
         "processors",
         processor.name.replace(/-processor/, ""),
@@ -2711,7 +2707,8 @@ function sortNavigationTree(tree) {
   tree.children.sort((a, b) => {
     if (a.sortorder < b.sortorder) {
       return -1;
-    } else if (a.sortorder > b.sortorder) {
+    }
+    if (a.sortorder > b.sortorder) {
       return 1;
     }
     const titleA = a.title.toUpperCase();
@@ -2788,7 +2785,7 @@ function findTemplate(folders, from, src, format) {
   const searchPaths = folders.map((it) => {
     return path__default.join(it, template);
   });
-  const found = searchPaths.find((it) => fs__default.existsSync(it));
+  const found = searchPaths.some((it) => fs__default.existsSync(it));
   if (!found) {
     throw new MissingTemplateError(from, template, format, folders);
   }
@@ -2863,9 +2860,8 @@ function getActualMessage(message) {
   const match = messageRegex.exec(message);
   if (match) {
     return match[1].trim();
-  } else {
-    return message;
   }
+  return message;
 }
 class TemplateRenderError extends Error {
   filename;
@@ -2900,23 +2896,22 @@ function fillActiveNavigation(doc, node) {
     const children = node.children.map(
       (it) => fillActiveNavigation(doc, it)
     );
-    const active = children.some((it) => it.active);
+    const active2 = children.some((it) => it.active);
     return {
       ...node,
-      active,
+      active: active2,
       children
     };
-  } else {
-    const active = doc.id === node.id;
-    return {
-      ...node,
-      active
-    };
   }
+  const active = doc.id === node.id;
+  return {
+    ...node,
+    active
+  };
 }
 function findSidenav(doc, tree) {
   const { path: path2, name } = doc.fileInfo;
-  const category = path2 === "." ? name : path2.split("/")[1];
+  const category = path2 === "." ? name : path2.split("/", 2)[1];
   const sidenav = tree.children.filter(isNavigationSection).find((it) => it.key === `./${category}`);
   if (sidenav) {
     return fillActiveNavigation(doc, sidenav);
@@ -2929,9 +2924,8 @@ function cache(cacheFolder, outputFolder) {
     if (existsSync(cacheFile)) {
       copyFileSync(cacheFile, outputFile);
       return false;
-    } else {
-      return true;
     }
+    return true;
   };
 }
 async function compileExamples(options) {
@@ -2960,11 +2954,12 @@ async function compileExamples(options) {
   };
   return new Promise((resolve, reject) => {
     function onmessage(message2) {
-      if (message2.ref === ref) {
-        exampleWorker.off("message", onmessage);
-        exampleWorker.off("error", onerror);
-        resolve();
+      if (message2.ref !== ref) {
+        return;
       }
+      exampleWorker.off("message", onmessage);
+      exampleWorker.off("error", onerror);
+      resolve();
     }
     function onerror(err) {
       reject(err);
@@ -3167,9 +3162,8 @@ async function render(doc, docs, options) {
   const expandedDst = dst.replaceAll(/\[([\s\S]+)\]/g, (match, key) => {
     if (key === "hash") {
       return getFingerprint(doc.body);
-    } else {
-      return match;
     }
+    return match;
   });
   const writeFile = fs.writeFile(expandedDst, content, "utf8");
   try {
@@ -3343,9 +3337,8 @@ async function importExpress() {
         "docs-generator serve() requires the optional peerDependency express to be installed",
         { cause: err }
       );
-    } else {
-      throw err;
     }
+    throw err;
   }
 }
 async function serve(options) {
@@ -3433,12 +3426,11 @@ function normalizeVendorDefinition(vendor) {
       package: vendor,
       alias: void 0
     };
-  } else {
-    return {
-      package: vendor.package,
-      alias: vendor.alias ?? void 0
-    };
   }
+  return {
+    package: vendor.package,
+    alias: vendor.alias ?? void 0
+  };
 }
 
 function getPackageName(vendor) {
@@ -3509,10 +3501,9 @@ async function stage(stage2, context, processors, options) {
     try {
       const prefix = (() => {
         if (verbose) {
-          return isLast ? "      " : "  \u2502   ";
-        } else {
-          return "";
+          return isLast ? " ".repeat(6) : "  \u2502   ";
         }
+        return "";
       })();
       const result = await processor.handler({
         ...context,
@@ -3616,17 +3607,17 @@ function createContext(options) {
       sidenav = root;
     },
     getAllTemplateData() {
-      return Object.fromEntries(templateData.entries());
+      return Object.fromEntries(templateData);
     },
     getTemplateData(key, defaultValue) {
       if (templateData.has(key)) {
         return templateData.get(key);
-      } else if (defaultValue) {
+      }
+      if (defaultValue) {
         templateData.set(key, defaultValue);
         return defaultValue;
-      } else {
-        return void 0;
       }
+      return void 0;
     },
     setTemplateData(key, value) {
       templateData.set(key, value);
@@ -3638,9 +3629,8 @@ function getWorkingDir(value) {
     const url = typeof value === "string" ? new URL(value) : value;
     const normalized = normalizePath(fileURLToPath(url));
     return path__default.posix.dirname(normalized);
-  } else {
-    return normalizePath(process.cwd());
   }
+  return normalizePath(process.cwd());
 }
 class Generator {
   cwd;
@@ -3902,7 +3892,7 @@ function* extractTerms(doc) {
     yield doc.name;
   }
   if (component) {
-    for (const name of component.map((it) => it.name)) {
+    for (const { name } of component) {
       yield name;
     }
   }