@forsakringskassan/docs-generator 2.38.0 → 2.38.1

package/dist/index.mjs

@@ -4,11 +4,10 @@ const require = $createRequire(import.meta.url);
 
 import fs from 'node:fs/promises';
 import path from 'node:path/posix';
-import { t as ts, m as minimatch, M as MarkdownIt, d as dedent, g as closest, h as distance, i as fm, j as isCI, Z as Ze, k as moduleImporter, l as cliProgress, n as tinylr, w as watch, o as createInstance, p as fse, q as inter } from './vendor-DV7BHNMM.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 filePath, c as createMarkdownRenderer, j as generateExample } from './create-markdown-renderer-DFoBsWJN.mjs';
+import { t as ts, m as minimatch, M as MarkdownIt, d as dedent, g as closest, h as distance, i as fm, j as isCI, Z as Ze, k as moduleImporter, l as cliProgress, n as tinylr, w as watch, o as createInstance, p as fse, q as inter } from './vendor-BK-uA6Uv.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 filePath, c as createMarkdownRenderer, j as generateExample } from './create-markdown-renderer-1_yCrnbT.mjs';
 import path__default from 'node:path';
-import require$$1 from 'crypto';
-import 'node:crypto';
+import crypto from 'node:crypto';
 import { exec, execSync } from 'node:child_process';
 import util, { promisify } from 'node:util';
 import { codeFrameColumns } from '@babel/code-frame';
@@ -40,6 +39,7 @@ import 'http';
 import 'https';
 import 'url';
 import 'buffer';
+import 'crypto';
 import 'net';
 import 'tls';
 import 'tty';
@@ -50,7 +50,7 @@ import 'fs/promises';
 import 'process';
 import 'v8';
 import 'vue';
-import './vue3-DtTC1eal.mjs';
+import './vue3-fRI2JWNs.mjs';
 
 function toArray$2(value) {
   return Array.isArray(value) ? value : [value];
@@ -162,7 +162,7 @@ function getDocumentOutline(text, _format) {
   const entries = getHeadings(text);
   const root = { title: "", rank: 0, anchor: "", subheadings: [] };
   const stack = [root];
-  const top = () => stack[stack.length - 1];
+  const top = () => stack.at(-1);
   for (const entry of entries) {
     const heading = {
       title: entry.title,
@@ -180,7 +180,7 @@ function getDocumentOutline(text, _format) {
 }
 
 function getIntegrity(source) {
-  const hash = require$$1.createHash("sha384").update(source).digest("base64");
+  const hash = crypto.createHash("sha384").update(source).digest("base64");
   return `sha384-${hash}`;
 }
 
@@ -207,19 +207,19 @@ function getRepositoryUrl(value) {
     }
     value = url;
   }
-  value = value.replace(/^git[+]/, "");
+  value = value.replace(/^git\+/, "");
   const ssh = RE_MATCH_SSH.exec(value);
   if (ssh) {
     const { host, path } = ssh.groups;
     value = `https://${host}/${path}`;
   }
-  value = value.replace(/[.]git$/, "");
+  value = value.replace(/\.git$/, "");
   return value;
 }
 
 function runCommand(cmd, defaultValue) {
   return new Promise((resolve) => {
-    exec(cmd, { encoding: "utf-8" }, (error, stdout) => {
+    exec(cmd, { encoding: "utf8" }, (error, stdout) => {
       if (error) {
         console.error(error);
         resolve(defaultValue);
@@ -244,7 +244,7 @@ function haveOutput(doc) {
 }
 
 function interpolate(value, data) {
-  return value.replace(/{{([^{}]+)}}/g, (match, raw) => {
+  return value.replaceAll(/{{([^{}]+)}}/g, (match, raw) => {
     const key = raw.trim();
     const value2 = data[key];
     return value2 ?? match;
@@ -252,7 +252,7 @@ function interpolate(value, data) {
 }
 
 function quote(text) {
-  return String(text).replace(/"/g, """);
+  return String(text).replaceAll('"', """);
 }
 function* serializeAttr(key, value) {
   if (value === null || value === false) {
@@ -285,13 +285,13 @@ function difference(a, b) {
 }
 
 function slugify(value) {
-  return value.toLowerCase().replace(/\//g, "--").replace(/[^a-z]+/g, "-").replace(/(^-+|-+$)/, "");
+  return value.toLowerCase().replaceAll("/", "--").replaceAll(/[^a-z]+/g, "-").replace(/(^-+|-+$)/, "");
 }
 
 function isRelease() {
   try {
     const cmd = `git log -n1 --format=format:%s`;
-    const message = execSync(cmd, { encoding: "utf-8" }).trim();
+    const message = execSync(cmd, { encoding: "utf8" }).trim();
     return message.startsWith("chore(release):");
   } catch (err) {
     console.error(err);
@@ -379,7 +379,7 @@ function extractExamplesProcessor(options) {
           const extension = getExtension(example.language);
           const filename = `example-${example.name ?? String(n++)}${suffix}.${extension}`;
           const filePath = path.join(dir, filename);
-          await fs.writeFile(filePath, example.content, "utf-8");
+          await fs.writeFile(filePath, example.content, "utf8");
           total++;
         }
       }
@@ -463,12 +463,13 @@ function renderJSON(manifest) {
   return JSON.stringify(manifest, null, 2);
 }
 function normalize(text) {
-  return text.replace(/\r\n/g, "\n");
+  return text.replaceAll("\r\n", "\n");
 }
 class ManifestError extends Error {
   filename;
   constructor(filename) {
     super(`Documentation manifest "${filename}" is not up-to-date!`);
+    this.name = "ManifestError";
     this.filename = filename;
   }
   prettyError() {
@@ -496,18 +497,18 @@ function manifestProcessor(options = {}) {
         const content = normalize(renderMarkdown(manifest));
         if (verify) {
           const actual = normalize(
-            await fs.readFile(markdown, "utf-8")
+            await fs.readFile(markdown, "utf8")
           );
           if (actual !== content) {
             throw new ManifestError(markdown);
           }
         } else {
-          await fs.writeFile(markdown, content, "utf-8");
+          await fs.writeFile(markdown, content, "utf8");
         }
       }
       if (json) {
         const content = renderJSON(manifest);
-        await fs.writeFile(json, content, "utf-8");
+        await fs.writeFile(json, content, "utf8");
       }
     }
   };
@@ -655,7 +656,7 @@ function htmlRedirectProcessor() {
         const dst = relative(doc.body, doc);
         const content = template(dst);
         await fs.mkdir(path.dirname(filePath), { recursive: true });
-        await fs.writeFile(filePath, dedent(content), "utf-8");
+        await fs.writeFile(filePath, dedent(content), "utf8");
       }
     }
   };
@@ -681,14 +682,14 @@ function redirectFileProcessor(prefix = "/", filename = "_redirects") {
       });
       const filePath = path.join(context.outputFolder, filename);
       await fs.mkdir(path.dirname(filePath), { recursive: true });
-      await fs.writeFile(filePath, lines.join(""), "utf-8");
+      await fs.writeFile(filePath, lines.join(""), "utf8");
       context.log(filename, "generated");
     }
   };
 }
 
 function getRedirects(docs) {
-  return docs.filter(isDocumentPage).map((it) => {
+  return docs.filter(isDocumentPage).flatMap((it) => {
     const { fileInfo } = it;
     const { path, outputName } = fileInfo;
     if (outputName === false) {
@@ -700,7 +701,7 @@ function getRedirects(docs) {
         to: normalizePath(path, outputName)
       };
     });
-  }).flat();
+  });
 }
 
 function redirectProcessor() {
@@ -793,7 +794,7 @@ function topnavProcessor(filename, title) {
     after: "generate-nav",
     name: "topnav-processor",
     async handler(context) {
-      const content = await fs.readFile(filename, "utf-8");
+      const content = await fs.readFile(filename, "utf8");
       const parsed = JSON.parse(content);
       const rootNode = generateNavigation(parsed);
       context.setTopNavigation({
@@ -963,7 +964,7 @@ function findLocation(content, attr) {
   const yaml = match[1];
   const lines = yaml.split("\n");
   const index = lines.findIndex((it) => it.startsWith(`${attr}:`));
-  if (index < 0) {
+  if (index === -1) {
     return null;
   }
   const blockBegin = 2;
@@ -1096,7 +1097,7 @@ function parseFile$1(filePath, basePath, content) {
   validateAttributes(attributes, filePath, content);
   return {
     kind: "page",
-    id: `fs:${filePath.replace(/\\/g, "/")}`,
+    id: `fs:${filePath.replaceAll("\\", "/")}`,
     name,
     alias: Array.from(getDocumentAlias(attributes)),
     visible: attributes.visible ?? true,
@@ -1127,7 +1128,7 @@ function parseFile$1(filePath, basePath, content) {
   };
 }
 async function frontMatterFileReader(filePath, basePath) {
-  const content = await fs.readFile(filePath, "utf-8");
+  const content = await fs.readFile(filePath, "utf8");
   const doc = parseFile$1(filePath, basePath, content);
   return [doc];
 }
@@ -1149,7 +1150,7 @@ function getDescription(node) {
   if (!text.startsWith("*")) {
     return null;
   }
-  return node.value.replace(/^\s*[*]\s/gm, "").replace(/\s+$/gm, "");
+  return node.value.replaceAll(/^\s*\*\s/gm, "").replaceAll(/\s+$/gm, "");
 }
 function flattenMemberExpression(node) {
   const { object, property } = node;
@@ -1602,7 +1603,7 @@ function getEventDeprecated(event) {
   }
 }
 function isSimpleName(name) {
-  return /^[a-z0-9]+$/i.test(name);
+  return /^[\da-z]+$/i.test(name);
 }
 function getPropType(prop) {
   const { type } = prop;
@@ -1676,7 +1677,7 @@ function translateEvents(events) {
 function translateEventProperties(event) {
   const properties = event.properties;
   const types = event.type ? Object.values(event.type.names) : [];
-  if (!properties && !types.length) {
+  if (!properties && types.length === 0) {
     return [];
   }
   if (!properties) {
@@ -1685,8 +1686,7 @@ function translateEventProperties(event) {
     ];
   }
   const translatedProperties = [];
-  for (let i = 0; i < properties.length; i++) {
-    const property = properties[i];
+  for (const [i, property] of properties.entries()) {
     const name = property.name ?? "<anonymous>";
     const eventType = types[i];
     const hasEventType = Boolean(eventType) && eventType !== "undefined";
@@ -1784,21 +1784,21 @@ function parseAPI(filePath, api) {
   const parsedPath = path__default.parse(relative);
   const componentName = parsedPath.name;
   let html = "";
-  if (api.models.length) {
+  if (api.models.length > 0) {
     html += generateModelTable(api.slug, api.models);
   }
-  if (api.props.length) {
+  if (api.props.length > 0) {
     html += generatePropTable(api.slug, api.props);
   }
-  if (api.events.length) {
+  if (api.events.length > 0) {
     html += generateEventTable(api.slug, api.events);
   }
-  if (api.slots.length) {
+  if (api.slots.length > 0) {
     html += generateSlotTable(api.slug, api.slots);
   }
   return {
     kind: "partial",
-    id: `fs:${filePath.replace(/\\/g, "/")}:api`,
+    id: `fs:${filePath.replaceAll("\\", "/")}:api`,
     name: `vue:${componentName}`,
     alias: [],
     body: html,
@@ -1812,10 +1812,10 @@ async function parseTranslation(slug, filePath) {
   const relative = normalizePath(filePath);
   const parsedPath = path__default.parse(relative);
   const componentName = parsedPath.name;
-  const content = await fs.readFile(filePath, "utf-8");
+  const content = await fs.readFile(filePath, "utf8");
   return {
     kind: "partial",
-    id: `fs:${filePath.replace(/\\/g, "/")}:translation`,
+    id: `fs:${filePath.replaceAll("\\", "/")}:translation`,
     name: `translation:${componentName}`,
     alias: [],
     get body() {
@@ -1892,7 +1892,7 @@ function parseFile(filePath, basePath, content) {
   const urlpath = parsed.dir;
   return {
     kind: "page",
-    id: `nav:${filePath.replace(/\\/g, "/")}`,
+    id: `nav:${filePath.replaceAll("\\", "/")}`,
     name,
     alias: [],
     visible: attributes.href ? true : false,
@@ -1917,7 +1917,7 @@ function parseFile(filePath, basePath, content) {
   };
 }
 async function navigationFileReader(filePath, basePath) {
-  const content = await fs.readFile(filePath, "utf-8");
+  const content = await fs.readFile(filePath, "utf8");
   const doc = parseFile(filePath, basePath, content);
   return [doc];
 }
@@ -1928,15 +1928,15 @@ async function compileSassString(dst, style) {
     importers: [new NodePackageImporter(), moduleImporter]
   });
   await fs.mkdir(path__default.dirname(dst), { recursive: true });
-  await fs.writeFile(dst, result.css, "utf-8");
+  await fs.writeFile(dst, result.css, "utf8");
 }
 
 async function compileStyle(assetFolder, name, src) {
   try {
     const outfile = path.join("temp", `asset-${name}.css`);
-    const source = await fs.readFile(src, "utf-8");
+    const source = await fs.readFile(src, "utf8");
     await compileSassString(outfile, source);
-    const content = await fs.readFile(outfile, "utf-8");
+    const content = await fs.readFile(outfile, "utf8");
     const fingerprint = getFingerprint(content);
     const integrity = getIntegrity(content);
     const filename = `${name}-${fingerprint}.css`;
@@ -1961,9 +1961,6 @@ async function compileStyle(assetFolder, name, src) {
 function byPriority$1({ options: a }, { options: b }) {
   return b.priority - a.priority;
 }
-function toSorted$1(values, comparator) {
-  return [...values].sort(comparator);
-}
 function cssAssetProcessor(assetFolder, assets) {
   return {
     name: "css-asset-processor",
@@ -1972,7 +1969,7 @@ function cssAssetProcessor(assetFolder, assets) {
       const assetInfo = context.getTemplateData("assets", {});
       const head = context.getTemplateData("injectHead", []);
       const body = context.getTemplateData("injectBody", []);
-      for (const asset of toSorted$1(assets, byPriority$1)) {
+      for (const asset of assets.toSorted(byPriority$1)) {
         const info = await compileStyle(
           assetFolder,
           asset.name,
@@ -2037,7 +2034,7 @@ async function compileScript(options) {
         ...buildOptions.define
       }
     });
-    const content = await fs$1.readFile(outfile, "utf-8");
+    const content = await fs$1.readFile(outfile, "utf8");
     const fingerprint = getFingerprint(content);
     const integrity = getIntegrity(content);
     const filename = `${name}-${fingerprint}.js`;
@@ -2063,9 +2060,6 @@ async function compileScript(options) {
 function byPriority({ options: a }, { options: b }) {
   return b.priority - a.priority;
 }
-function toSorted(values, comparator) {
-  return [...values].sort(comparator);
-}
 function isExternal(asset) {
   return asset.options.appendTo === "none";
 }
@@ -2078,7 +2072,7 @@ function jsAssetProcessor(assetFolder, assets, vendor) {
       const assetInfo = context.getTemplateData("assets", {});
       const head = context.getTemplateData("injectHead", []);
       const body = context.getTemplateData("injectBody", []);
-      for (const asset of toSorted(assets, byPriority)) {
+      for (const asset of assets.toSorted(byPriority)) {
         const info = await compileScript({
           assetFolder,
           name: asset.name,
@@ -2205,10 +2199,10 @@ function isNavigationSection(node) {
 }
 function pathFromDoc({ fileInfo }) {
   if (fileInfo.name === "index") {
-    return [fileInfo.path.replace(/\\/g, "/"), true];
+    return [fileInfo.path.replaceAll("\\", "/"), true];
   } else {
     return [
-      `./${path__default.join(fileInfo.path, fileInfo.name).replace(/\\/g, "/")}`,
+      `./${path__default.join(fileInfo.path, fileInfo.name).replaceAll("\\", "/")}`,
       false
     ];
   }
@@ -2503,7 +2497,7 @@ ${searched}
 Make sure the name is correct and the template file exists in one of the listed directories.`;
       throw new Error(message);
     }
-    const content = await fs.readFile(filePath, "utf-8");
+    const content = await fs.readFile(filePath, "utf8");
     const resolved = { content, filePath };
     templateCache.set(name, resolved);
     return resolved;
@@ -2515,7 +2509,7 @@ Make sure the name is correct and the template file exists in one of the listed
   }
 }
 
-const messageRegex = /^[(][^)]+[)] \[Line \d+, Column \d+\]\n\s+Error: (.*)$/;
+const messageRegex = /^\([^)]+\) \[Line \d+, Column \d+]\n\s+Error: (.*)$/;
 function getActualMessage(message) {
   const match = messageRegex.exec(message);
   if (match) {
@@ -2528,7 +2522,7 @@ class TemplateRenderError extends Error {
   filename;
   constructor(message, filename) {
     super(getActualMessage(message));
-    this.name = "RenderError";
+    this.name = "TemplateRenderError";
     this.filename = filename;
   }
   prettyError() {
@@ -2651,7 +2645,7 @@ async function compileStandalones(options) {
       ...templateData,
       content: task.content
     });
-    await fs.writeFile(outputFile, content, "utf-8");
+    await fs.writeFile(outputFile, content, "utf8");
   }
 }
 function createTemplateLoader(folders) {
@@ -2659,7 +2653,7 @@ function createTemplateLoader(folders) {
   return loader;
 }
 function stripPrettierComments(content) {
-  return content.replace(/\s*<!-- prettier-ignore -->\s*/gm, "");
+  return content.replaceAll(/\s*<!-- prettier-ignore -->\s*/gm, "");
 }
 async function render(doc, docs, nav, vendors, options) {
   const { fileInfo } = doc;
@@ -2684,7 +2678,7 @@ async function render(doc, docs, nav, vendors, options) {
     site: options.site,
     doc,
     get layoutClass() {
-      return `layout--${doc.template.replace(/[.]/g, "--")}`;
+      return `layout--${doc.template.replaceAll(".", "--")}`;
     },
     topnav,
     rootUrl(doc2) {
@@ -2748,7 +2742,7 @@ async function render(doc, docs, nav, vendors, options) {
     getImportedSource(filename) {
       const context = `when importing example from "${fileInfo.fullPath}"`;
       const match = fileMatcher(filename, context);
-      return readFileSync(match, "utf-8");
+      return readFileSync(match, "utf8");
     },
     addResource(dst2, src) {
       if (!existsSync(src)) {
@@ -2811,14 +2805,14 @@ async function render(doc, docs, nav, vendors, options) {
     const message = err instanceof Error ? err.message : String(err);
     throw new Error(`${prefix}: ${message}`, { cause: err });
   }
-  const expandedDst = dst.replace(/\[([^]+)\]/g, (match, key) => {
+  const expandedDst = dst.replaceAll(/\[([^]+)]/g, (match, key) => {
     if (key === "hash") {
       return getFingerprint(doc.body);
     } else {
       return match;
     }
   });
-  const writeFile = fs.writeFile(expandedDst, content, "utf-8");
+  const writeFile = fs.writeFile(expandedDst, content, "utf8");
   try {
     const assets = Object.values(templateData.assets).filter(
       (it) => it.importmap
@@ -2881,9 +2875,9 @@ function nunjucksProcessor(options) {
           }
         });
       }
-      const formats = ["markdown", "json"];
+      const formats = /* @__PURE__ */ new Set(["markdown", "json"]);
       const docs = context.docs.filter(isDocumentPage).filter((it) => {
-        if (!formats.includes(it.format)) {
+        if (!formats.has(it.format)) {
           return false;
         }
         return it.fileInfo.outputName;
@@ -2932,7 +2926,7 @@ async function keypress() {
     process.stdin.once("data", (data) => {
       process.stdin.setRawMode(false);
       process.stdin.resume();
-      resolve(data.toString("utf-8"));
+      resolve(data.toString("utf8"));
     });
   });
 }
@@ -3028,7 +3022,7 @@ async function serve(options) {
 
 function getAssetSource(asset) {
   const lines = [];
-  const pkg = asset.package.replace(/\\/g, "/");
+  const pkg = asset.package.replaceAll("\\", "/");
   lines.push(`export * from "${pkg}";`);
   return lines.join("\n");
 }
@@ -3038,7 +3032,7 @@ async function compileVendor(assetFolder, vendor, options) {
   const outfile = `temp/vendor-${slug}.out.js`;
   const tmpfile = `temp/vendor-${slug}.in.js`;
   const source = getAssetSource(vendor);
-  await fs.writeFile(tmpfile, source, "utf-8");
+  await fs.writeFile(tmpfile, source, "utf8");
   await esbuild$1.build({
     entryPoints: [tmpfile],
     outfile,
@@ -3055,11 +3049,11 @@ async function compileVendor(assetFolder, vendor, options) {
     alias: vendor.alias ? { [vendor.package]: vendor.alias } : void 0,
     ...options
   });
-  const content = await fs.readFile(outfile, "utf-8");
+  const content = await fs.readFile(outfile, "utf8");
   const fingerprint = getFingerprint(content);
   const integrity = getIntegrity(content);
   const filename = `vendor-${slug}-${fingerprint}.js`;
-  const dst = path__default.join(assetFolder, filename).replace(/\\/g, "/");
+  const dst = path__default.join(assetFolder, filename).replaceAll("\\", "/");
   await fs.rename(outfile, dst);
   const stat = await fs.stat(dst);
   return {
@@ -3137,7 +3131,8 @@ function filterProcessors(stage2, processors) {
   }
   return [...before, ...during, ...after];
 }
-async function stage(stage2, context, processors, { verbose } = { verbose: true }) {
+async function stage(stage2, context, processors, options) {
+  const { verbose = true } = options ?? {};
   if (verbose) {
     console.log(`stage:${stage2}`);
   }
@@ -3215,7 +3210,7 @@ function createContext(outputFolder, templateLoader) {
     },
     addResource(dst, src) {
       resources.push({
-        from: src.replace(/\\/g, "/"),
+        from: src.replaceAll("\\", "/"),
         to: dst
       });
     },
@@ -3292,7 +3287,7 @@ class Generator {
         "[docs-generator] deprecated: not passing import.meta.url as the first argument is deprecated, assuming `process.cwd()`."
       );
     }
-    if (typeof options.site === "undefined") {
+    if (options.site === void 0) {
       throw new Error("site metadata not set in configuration");
     }
     this.cwd = cwd;
@@ -3305,7 +3300,7 @@ class Generator {
     this.templateFolders = options.templateFolders ?? [];
     this.processors = options.processors ?? [];
     this.vendor = options.vendor ?? [];
-    this.setupPath = options.setupPath.replace(/\\/g, "/");
+    this.setupPath = options.setupPath.replaceAll("\\", "/");
     this.scripts = [];
     this.styles = [];
     this.resources = [];
@@ -3357,7 +3352,7 @@ class Generator {
    */
   copyResource(dst, src) {
     this.resources.push({
-      from: src.replace(/\\/g, "/"),
+      from: src.replaceAll("\\", "/"),
       to: dst
     });
   }
@@ -3447,7 +3442,7 @@ class Generator {
    */
   serve() {
     const { outputFolder, sourceFiles } = this;
-    const watch = sourceFiles.map((it) => it.include).flat();
+    const watch = sourceFiles.flatMap((it) => it.include);
     return serve({
       outputFolder,
       watch,