@forsakringskassan/docs-generator 1.27.0 → 1.29.0

package/dist/{generator.js → index.js}

@@ -1,37 +1,37 @@
 'use strict';
 
-var fs$1 = require('node:fs');
 var fs = require('node:fs/promises');
 var path = require('node:path');
-var vendor = require('./vendor-Dmnzl4fQ.js');
+var vendor = require('./vendor-uab7h6x-.js');
+var createMarkdownRenderer = require('./create-markdown-renderer-D1cATjO1.js');
 var require$$1 = require('crypto');
 require('node:crypto');
+var vueDocgenApi = require('vue-docgen-api');
 var path$1 = require('node:path/posix');
+var fs$1 = require('node:fs');
 var sass = require('sass');
 var node_url = require('node:url');
-var createMarkdownRenderer = require('./create-markdown-renderer--V6N9Daq.js');
 var esbuild = require('esbuild');
-var vueDocgenApi = require('vue-docgen-api');
 var node_util = require('node:util');
 var nunjucks = require('nunjucks');
 var vue = require('vue');
-var vue2 = require('./vue2-DYKDshbg.js');
-var vue3 = require('./vue3-CEA3zw16.js');
+var vue2 = require('./vue2-CBDrnmVO.js');
+var vue3 = require('./vue3-xJIC7Aol.js');
 var express = require('express');
-require('fs');
-require('constants');
-require('stream');
-require('util');
-require('assert');
+var childProcess = require('node:child_process');
 require('path');
 require('url');
+require('fs');
 require('fs/promises');
 require('events');
+require('stream');
 require('string_decoder');
+require('constants');
+require('util');
+require('assert');
 require('readline');
 require('child_process');
 require('node:buffer');
-require('node:child_process');
 require('node:process');
 require('node:os');
 require('node:timers/promises');
@@ -46,6 +46,10 @@ require('tls');
 require('tty');
 require('querystring');
 
+function defineSources(sources) {
+  return sources;
+}
+
 function formatSize(value) {
   const suffices = ["kB", "MB"];
   if (value < 1e3) {
@@ -106,6 +110,13 @@ function haveOutput(doc) {
   return Boolean(fileInfo.outputName);
 }
 
+function interpolate(value, data) {
+  return value.replace(/{{([^}]+)}}/g, (match, raw) => {
+    const key = raw.trim();
+    return data[key] ?? match;
+  });
+}
+
 function parseImport(raw) {
   const comments = [];
   const stripped = raw.replace(/<!--.*?-->/gms, (match) => {
@@ -158,214 +169,7 @@ function slugify(value) {
   return value.toLowerCase().replace(/\//g, "--").replace(/[^a-z]+/g, "-").replace(/(^-+|-+$)/, "");
 }
 
-function resolveScssImport(filePath) {
-  const { dir, base } = path$1.parse(filePath);
-  const search = [`${base}.css`, `${base}.scss`, `_${base}.scss`, `${base}`];
-  for (const variant of search) {
-    try {
-      const moduleName = path$1.join(dir, variant);
-      const resolved = require.resolve(moduleName);
-      return node_url.pathToFileURL(resolved);
-    } catch (err) {
-      if (err.code !== "MODULE_NOT_FOUND") {
-        throw err;
-      }
-    }
-  }
-  throw new Error(`Failed to resolve "${filePath}"`);
-}
-const tildeImporter = {
-  canonicalize(url) {
-    const indexOfTilde = url.indexOf("~");
-    if (indexOfTilde >= 0) {
-      return resolveScssImport(url.slice(indexOfTilde + 1));
-    }
-    if (url.startsWith("file://")) {
-      const path$1 = node_url.fileURLToPath(url);
-      const relative = path.isAbsolute(path$1) ? path.relative(__dirname, path$1) : path$1;
-      return resolveScssImport(relative.replace(/\\/g, "/"));
-    }
-    return null;
-  },
-  async load(url) {
-    const filepath = node_url.fileURLToPath(url);
-    const parsed = path.parse(filepath);
-    const contents = await fs.readFile(filepath, "utf-8");
-    return {
-      contents,
-      syntax: parsed.ext.slice(1) === "scss" ? "scss" : "css"
-    };
-  }
-};
-
-async function compileSassString(dst, style) {
-  const result = await sass.compileStringAsync(style, {
-    style: "expanded",
-    importers: [tildeImporter]
-  });
-  await fs.mkdir(path.dirname(dst), { recursive: true });
-  await fs.writeFile(dst, result.css, "utf-8");
-}
-
-async function compileStyle(assetFolder, name, src) {
-  try {
-    const outfile = path$1.join("temp", `asset-${name}.css`);
-    const source = await fs.readFile(src, "utf-8");
-    await compileSassString(outfile, source);
-    const content = await fs.readFile(outfile, "utf-8");
-    const fingerprint = createMarkdownRenderer.getFingerprint(content);
-    const integrity = getIntegrity(content);
-    const filename = `${name}-${fingerprint}.css`;
-    const dst = path$1.join(assetFolder, filename);
-    await fs.rename(outfile, dst);
-    const stat = await fs.stat(dst);
-    return {
-      name,
-      filename,
-      publicPath: `./assets/${filename}`,
-      integrity,
-      size: stat.size,
-      type: "css"
-    };
-  } catch (err) {
-    console.error(err);
-    throw new Error(`Failed to compile style "${name}"`);
-  }
-}
-
-function cssAssetProcessor(assetFolder, assets) {
-  return {
-    name: "css-asset-processor",
-    after: "assets",
-    async handler(context) {
-      const assetInfo = context.getTemplateData("assets") ?? {};
-      const head = context.getTemplateData("injectHead") ?? [];
-      const body = context.getTemplateData("injectBody") ?? [];
-      for (const asset of assets) {
-        const info = await compileStyle(
-          assetFolder,
-          asset.name,
-          asset.src
-        );
-        const attrs = serializeAttrs(asset.options.attributes);
-        const inject = { ...info, attrs: Array.from(attrs).join(" ") };
-        assetInfo[asset.name] = info;
-        switch (asset.options.appendTo) {
-          case "none":
-            break;
-          case "head":
-            head.push(inject);
-            break;
-          case "body":
-            body.push(inject);
-            break;
-        }
-        context.setTemplateData("injectHead", head);
-        context.setTemplateData("injectBody", body);
-        context.log(info.filename, formatSize(info.size));
-      }
-      context.setTemplateData("assets", assetInfo);
-    }
-  };
-}
-
 function toArray$3(value) {
-  if (Array.isArray(value)) {
-    return value;
-  } else {
-    return [value];
-  }
-}
-async function compileScript(assetFolder, name, src, options) {
-  const iconLib = process.env.DOCS_ICON_LIB ?? "@fkui/icon-lib-default";
-  try {
-    const outfile = path.join("temp", `asset-${name}.js`);
-    await esbuild.build({
-      entryPoints: toArray$3(src),
-      outfile,
-      bundle: true,
-      format: "iife",
-      platform: "browser",
-      external: ["vue", "@fkui/vue"],
-      tsconfig: path.join(__dirname, "../tsconfig-examples.json"),
-      define: {
-        "process.env.DOCS_ICON_LIB": JSON.stringify(iconLib)
-      },
-      ...options
-    });
-    const content = await fs.readFile(outfile, "utf-8");
-    const fingerprint = createMarkdownRenderer.getFingerprint(content);
-    const integrity = getIntegrity(content);
-    const filename = `${name}-${fingerprint}.js`;
-    const dst = path.join(assetFolder, filename);
-    await fs.rename(outfile, dst);
-    const stat = await fs.stat(dst);
-    return {
-      name,
-      filename,
-      publicPath: `./assets/${filename}`,
-      integrity,
-      size: stat.size,
-      type: "js"
-    };
-  } catch {
-    throw new Error(`Failed to compile script "${name}"`);
-  }
-}
-
-function jsAssetProcessor(assetFolder, assets) {
-  return {
-    name: "js-asset-processor",
-    after: "assets",
-    async handler(context) {
-      const assetInfo = context.getTemplateData("assets") ?? {};
-      const head = context.getTemplateData("injectHead") ?? [];
-      const body = context.getTemplateData("injectBody") ?? [];
-      for (const asset of assets) {
-        const info = await compileScript(
-          assetFolder,
-          asset.name,
-          asset.src
-        );
-        const attrs = serializeAttrs(asset.options.attributes);
-        const inject = { ...info, attrs: Array.from(attrs).join(" ") };
-        assetInfo[asset.name] = info;
-        switch (asset.options.appendTo) {
-          case "none":
-            break;
-          case "head":
-            head.push(inject);
-            break;
-          case "body":
-            body.push(inject);
-            break;
-        }
-        context.setTemplateData("injectHead", head);
-        context.setTemplateData("injectBody", body);
-        context.log(info.filename, formatSize(info.size));
-      }
-    }
-  };
-}
-
-function staticResourcesProcessor(assetFolder, resources) {
-  return {
-    name: "static-resources-processor",
-    after: "render",
-    async handler(context) {
-      for (const resource of [...resources, ...context.resources]) {
-        const src = resource.from;
-        const dst = path$1.join(assetFolder, resource.to);
-        await fs.cp(src, dst, {
-          recursive: true
-        });
-        context.log(src, "->", dst);
-      }
-    }
-  };
-}
-
-function toArray$2(value) {
   return Array.isArray(value) ? value : [value];
 }
 function isIndexPage(parsed) {
@@ -401,7 +205,7 @@ function getBadge(attrs) {
 }
 function getComponentAlias(attrs) {
   if (attrs.component) {
-    return toArray$2(attrs.component).map((it) => `component:${it}`);
+    return toArray$3(attrs.component).map((it) => `component:${it}`);
   } else {
     return [];
   }
@@ -416,6 +220,7 @@ function parseFile$1(filePath, basePath, content) {
   const name = attributes.name ? attributes.name : parsed.name;
   const urlpath = parsed.dir;
   const outline = getDocumentOutline(blocks.body);
+  const include = attributes.include ?? true;
   return {
     id: `fs:${filePath.replace(/\\/g, "/")}`,
     name,
@@ -426,7 +231,7 @@ function parseFile$1(filePath, basePath, content) {
       layout: attributes.layout,
       status: attributes.status,
       badge: getBadge(attributes),
-      component: attributes.component ? toArray$2(attributes.component) : void 0,
+      component: attributes.component ? toArray$3(attributes.component) : void 0,
       sortorder: attributes.sortorder ?? Infinity
     },
     body: blocks.body,
@@ -438,7 +243,7 @@ function parseFile$1(filePath, basePath, content) {
       path: ["", "."].includes(urlpath) ? "." : `./${createMarkdownRenderer.normalizePath(urlpath)}`,
       name: filename,
       fullPath: createMarkdownRenderer.normalizePath(filePath),
-      outputName: `${filename}.html`
+      outputName: include ? `${filename}.html` : false
     }
   };
 }
@@ -698,25 +503,232 @@ async function navigationFileReader(filePath, basePath) {
   return [doc];
 }
 
-function getExampleImport(searchDirs, filename) {
-  const pattern = searchDirs.map((dir) => `${dir}/**/${filename}`);
-  const matches = vendor.globSync(pattern);
-  if (matches.length === 0) {
-    const message = `No files matched import "${filename}"`;
-    throw new Error(message);
-  } else if (matches.length > 1) {
-    const message = `Multiple files matched import "${filename}"`;
-    throw new Error(message);
-  } else {
-    return createMarkdownRenderer.normalizePath(matches[0]);
+function resolveScssImport(filePath) {
+  const { dir, base } = path$1.parse(filePath);
+  const search = [`${base}.css`, `${base}.scss`, `_${base}.scss`, `${base}`];
+  for (const variant of search) {
+    try {
+      const moduleName = path$1.join(dir, variant);
+      const resolved = require.resolve(moduleName);
+      return node_url.pathToFileURL(resolved);
+    } catch (err) {
+      if (err.code !== "MODULE_NOT_FOUND") {
+        throw err;
+      }
+    }
   }
+  throw new Error(`Failed to resolve "${filePath}"`);
 }
-
-function getExampleName(filename) {
-  return path.parse(filename).name;
-}
-
-const vueMajor = parseInt(vue.version.split(".", 2)[0], 10);
+const tildeImporter = {
+  canonicalize(url) {
+    const indexOfTilde = url.indexOf("~");
+    if (indexOfTilde >= 0) {
+      return resolveScssImport(url.slice(indexOfTilde + 1));
+    }
+    if (url.startsWith("file://")) {
+      const path$1 = node_url.fileURLToPath(url);
+      const relative = path.isAbsolute(path$1) ? path.relative(__dirname, path$1) : path$1;
+      return resolveScssImport(relative.replace(/\\/g, "/"));
+    }
+    return null;
+  },
+  async load(url) {
+    const filepath = node_url.fileURLToPath(url);
+    const parsed = path.parse(filepath);
+    const contents = await fs.readFile(filepath, "utf-8");
+    return {
+      contents,
+      syntax: parsed.ext.slice(1) === "scss" ? "scss" : "css"
+    };
+  }
+};
+
+async function compileSassString(dst, style) {
+  const result = await sass.compileStringAsync(style, {
+    style: "expanded",
+    importers: [tildeImporter]
+  });
+  await fs.mkdir(path.dirname(dst), { recursive: true });
+  await fs.writeFile(dst, result.css, "utf-8");
+}
+
+async function compileStyle(assetFolder, name, src) {
+  try {
+    const outfile = path$1.join("temp", `asset-${name}.css`);
+    const source = await fs.readFile(src, "utf-8");
+    await compileSassString(outfile, source);
+    const content = await fs.readFile(outfile, "utf-8");
+    const fingerprint = createMarkdownRenderer.getFingerprint(content);
+    const integrity = getIntegrity(content);
+    const filename = `${name}-${fingerprint}.css`;
+    const dst = path$1.join(assetFolder, filename);
+    await fs.rename(outfile, dst);
+    const stat = await fs.stat(dst);
+    return {
+      name,
+      filename,
+      publicPath: `./assets/${filename}`,
+      integrity,
+      size: stat.size,
+      type: "css"
+    };
+  } catch (err) {
+    console.error(err);
+    throw new Error(`Failed to compile style "${name}"`);
+  }
+}
+
+function cssAssetProcessor(assetFolder, assets) {
+  return {
+    name: "css-asset-processor",
+    after: "assets",
+    async handler(context) {
+      const assetInfo = context.getTemplateData("assets") ?? {};
+      const head = context.getTemplateData("injectHead") ?? [];
+      const body = context.getTemplateData("injectBody") ?? [];
+      for (const asset of assets) {
+        const info = await compileStyle(
+          assetFolder,
+          asset.name,
+          asset.src
+        );
+        const attrs = serializeAttrs(asset.options.attributes);
+        const inject = { ...info, attrs: Array.from(attrs).join(" ") };
+        assetInfo[asset.name] = info;
+        switch (asset.options.appendTo) {
+          case "none":
+            break;
+          case "head":
+            head.push(inject);
+            break;
+          case "body":
+            body.push(inject);
+            break;
+        }
+        context.setTemplateData("injectHead", head);
+        context.setTemplateData("injectBody", body);
+        context.log(info.filename, formatSize(info.size));
+      }
+      context.setTemplateData("assets", assetInfo);
+    }
+  };
+}
+
+function toArray$2(value) {
+  if (Array.isArray(value)) {
+    return value;
+  } else {
+    return [value];
+  }
+}
+async function compileScript(assetFolder, name, src, options) {
+  const iconLib = process.env.DOCS_ICON_LIB ?? "@fkui/icon-lib-default";
+  try {
+    const outfile = path.join("temp", `asset-${name}.js`);
+    await esbuild.build({
+      entryPoints: toArray$2(src),
+      outfile,
+      bundle: true,
+      format: "iife",
+      platform: "browser",
+      external: ["vue", "@fkui/vue"],
+      tsconfig: path.join(__dirname, "../tsconfig-examples.json"),
+      define: {
+        "process.env.DOCS_ICON_LIB": JSON.stringify(iconLib)
+      },
+      ...options
+    });
+    const content = await fs.readFile(outfile, "utf-8");
+    const fingerprint = createMarkdownRenderer.getFingerprint(content);
+    const integrity = getIntegrity(content);
+    const filename = `${name}-${fingerprint}.js`;
+    const dst = path.join(assetFolder, filename);
+    await fs.rename(outfile, dst);
+    const stat = await fs.stat(dst);
+    return {
+      name,
+      filename,
+      publicPath: `./assets/${filename}`,
+      integrity,
+      size: stat.size,
+      type: "js"
+    };
+  } catch {
+    throw new Error(`Failed to compile script "${name}"`);
+  }
+}
+
+function jsAssetProcessor(assetFolder, assets) {
+  return {
+    name: "js-asset-processor",
+    after: "assets",
+    async handler(context) {
+      const assetInfo = context.getTemplateData("assets") ?? {};
+      const head = context.getTemplateData("injectHead") ?? [];
+      const body = context.getTemplateData("injectBody") ?? [];
+      for (const asset of assets) {
+        const info = await compileScript(
+          assetFolder,
+          asset.name,
+          asset.src
+        );
+        const attrs = serializeAttrs(asset.options.attributes);
+        const inject = { ...info, attrs: Array.from(attrs).join(" ") };
+        assetInfo[asset.name] = info;
+        switch (asset.options.appendTo) {
+          case "none":
+            break;
+          case "head":
+            head.push(inject);
+            break;
+          case "body":
+            body.push(inject);
+            break;
+        }
+        context.setTemplateData("injectHead", head);
+        context.setTemplateData("injectBody", body);
+        context.log(info.filename, formatSize(info.size));
+      }
+    }
+  };
+}
+
+function staticResourcesProcessor(assetFolder, resources) {
+  return {
+    name: "static-resources-processor",
+    after: "render",
+    async handler(context) {
+      for (const resource of [...resources, ...context.resources]) {
+        const src = resource.from;
+        const dst = path$1.join(assetFolder, resource.to);
+        await fs.cp(src, dst, {
+          recursive: true
+        });
+        context.log(src, "->", dst);
+      }
+    }
+  };
+}
+
+function getExampleImport(searchDirs, filename) {
+  const pattern = searchDirs.map((dir) => `${dir}/**/${filename}`);
+  const matches = vendor.globSync(pattern);
+  if (matches.length === 0) {
+    const message = `No files matched import "${filename}"`;
+    throw new Error(message);
+  } else if (matches.length > 1) {
+    const message = `Multiple files matched import "${filename}"`;
+    throw new Error(message);
+  } else {
+    return createMarkdownRenderer.normalizePath(matches[0]);
+  }
+}
+
+function getExampleName(filename) {
+  return path.parse(filename).name;
+}
+
+const vueMajor = parseInt(vue.version.split(".", 2)[0], 10);
 const vueGenerator = {
   [2]: vue2.generateCode,
   [3]: vue3.generateCode
@@ -982,6 +994,54 @@ function sortNavigationTree(tree) {
   }
 }
 
+class TemplateLoader {
+  async = true;
+  folders;
+  templateCache;
+  constructor(folders = []) {
+    this.folders = [...folders, path.join(__dirname, "../templates")];
+    this.templateCache = /* @__PURE__ */ new Map();
+  }
+  async getSource(name, callback) {
+    try {
+      const { content, filePath } = await this.resolveTemplate(name);
+      callback(null, {
+        src: content,
+        path: filePath,
+        noCache: false
+      });
+    } catch (err) {
+      if (err instanceof Error) {
+        callback(err, null);
+      } else {
+        callback(new Error(String(err)), null);
+      }
+    }
+  }
+  async resolveTemplate(name) {
+    const { templateCache, folders } = this;
+    const cached = templateCache.get(name);
+    if (cached) {
+      return cached;
+    }
+    const searchPaths = folders.map((it) => path.join(it, name));
+    const filePath = searchPaths.find((it) => fs$1.existsSync(it));
+    if (!filePath) {
+      const searched = folders.map((it) => `  - "${it}"`).join("\n");
+      const message = `Failed to resolve template "${name}", searched in:
+
+${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 resolved = { content, filePath };
+    templateCache.set(name, resolved);
+    return resolved;
+  }
+}
+
 function dump(value) {
   return `<pre>${JSON.stringify(value, null, 2)}</pre>`;
 }
@@ -1065,53 +1125,6 @@ function findTemplate(from, src, format) {
   return template;
 }
 
-class Loader {
-  async = true;
-  folders;
-  templateCache;
-  constructor(folders) {
-    this.folders = [...folders, path.join(__dirname, "../templates")];
-    this.templateCache = /* @__PURE__ */ new Map();
-  }
-  async getSource(name, callback) {
-    try {
-      const { content, filePath } = await this.resolveTemplate(name);
-      callback(null, {
-        src: content,
-        path: filePath,
-        noCache: false
-      });
-    } catch (err) {
-      if (err instanceof Error) {
-        callback(err, null);
-      } else {
-        callback(new Error(String(err)), null);
-      }
-    }
-  }
-  async resolveTemplate(name) {
-    const { templateCache, folders } = this;
-    const cached = templateCache.get(name);
-    if (cached) {
-      return cached;
-    }
-    const searchPaths = folders.map((it) => path.join(it, name));
-    const filePath = searchPaths.find((it) => fs$1.existsSync(it));
-    if (!filePath) {
-      const searched = folders.map((it) => `  - "${it}"`).join("\n");
-      const message = `Failed to resolve template "${name}", searched in:
-
-${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 resolved = { content, filePath };
-    templateCache.set(name, resolved);
-    return resolved;
-  }
-}
 const scriptPath = path.join(__dirname, "compile-example.js");
 let loader = null;
 function haveOutputFile(fileInfo) {
@@ -1165,6 +1178,9 @@ async function compileExamples(options) {
   const outputFolder = path.posix.join(options.outputFolder, fileInfo.path);
   const cacheMiss = cache(cacheFolder, outputFolder);
   const dirtyTasks = tasks.filter(cacheMiss);
+  if (dirtyTasks.length === 0) {
+    return;
+  }
   const batch = {
     outputFolder,
     external: vendors.map((it) => it.package),
@@ -1199,7 +1215,7 @@ async function compileStandalones(options) {
   }
 }
 function createTemplateLoader(folders) {
-  loader = new Loader(folders);
+  loader = new TemplateLoader(folders);
 }
 async function render(doc, docs, nav, vendors, options) {
   const { fileInfo } = doc;
@@ -1279,9 +1295,10 @@ async function render(doc, docs, nav, vendors, options) {
       const blocks = options.templateBlocks.get(container) ?? [];
       const promises = blocks.map(({ renderer }) => {
         if ("filename" in renderer) {
+          const data = renderer.data;
           return renderTemplate(renderer.filename, {
             ...ctx,
-            ...renderer.data
+            ...data
           });
         }
         if ("render" in renderer) {
@@ -1661,214 +1678,6 @@ async function serve(options) {
 function toArray$1(value) {
   return Array.isArray(value) ? value : [value];
 }
-function matomoProcessor(options) {
-  const { enabled, siteId, apiUrl, trackerUrl, hostname } = options;
-  return {
-    after: "generate-docs",
-    name: "matomo-processor",
-    enabled,
-    handler(context) {
-      context.addTemplateBlock("head", "matomo", {
-        filename: "partials/matomo.html",
-        data: {
-          siteId,
-          apiUrl,
-          trackerUrl,
-          hostname: hostname ? toArray$1(hostname) : []
-        }
-      });
-    }
-  };
-}
-
-function renderMarkdown(manifest) {
-  return [
-    "## Documentation manifest",
-    "",
-    "> Do not edit this file. It is a automatically generated by `@forsakringskassan/docs-generator`.",
-    "",
-    "```",
-    ...manifest.pages.map((it) => it.path),
-    "```",
-    ""
-  ].join("\n");
-}
-function renderJSON(manifest) {
-  return JSON.stringify(manifest, null, 2);
-}
-function manifestProcessor(options) {
-  const { markdown, json } = options;
-  return {
-    name: "manifestProcessor",
-    before: "render",
-    async handler(context) {
-      const docs = context.docs.filter(haveOutput);
-      const pages = docs.map(manifestPageFromDocument);
-      pages.sort((a, b) => {
-        return a.path.localeCompare(b.path);
-      });
-      const manifest = { pages };
-      if (markdown) {
-        const content = renderMarkdown(manifest);
-        await fs.writeFile(markdown, content, "utf-8");
-      }
-      if (json) {
-        const content = renderJSON(manifest);
-        await fs.writeFile(json, content, "utf-8");
-      }
-    }
-  };
-}
-
-function themeSelectProcessor() {
-  return {
-    name: "theme-select-processor",
-    after: "generate-docs",
-    handler(context) {
-      context.addTemplateBlock("toolbar", "theme-select", {
-        filename: "partials/theme-select.html"
-      });
-    }
-  };
-}
-
-function versionProcessor(pkg, container) {
-  return {
-    name: "version-processor",
-    after: "generate-docs",
-    handler(context) {
-      context.addTemplateBlock(container, "version", {
-        filename: "partials/version.html",
-        data: { pkg }
-      });
-    }
-  };
-}
-
-function selectableVersionProcessor(pkg, container) {
-  return {
-    name: "selectable-version-processor",
-    after: "generate-docs",
-    handler(context) {
-      context.addTemplateBlock(container, "version", {
-        filename: "partials/selectable-version.html",
-        data: { pkg }
-      });
-    }
-  };
-}
-
-function versionBannerProcessor(message, container) {
-  return {
-    name: "version-banner-processor",
-    after: "generate-docs",
-    handler(context) {
-      context.addTemplateBlock(container, "version-banner", {
-        filename: "partials/version-banner.html",
-        data: { message }
-      });
-    }
-  };
-}
-
-function generateIndex(entries) {
-  const index = {
-    terms: [],
-    results: [],
-    mapping: {}
-  };
-  for (const entry of entries) {
-    index.results.push({
-      url: entry.url,
-      title: entry.title
-    });
-    const resultIndex = index.results.length - 1;
-    for (const word of entry.words) {
-      index.terms.push(word);
-      const termIndex = index.terms.length - 1;
-      index.mapping[termIndex] = resultIndex;
-    }
-  }
-  return index;
-}
-
-function extractTerms(doc) {
-  const { title, component } = doc.attributes;
-  if (title && component) {
-    return component.map((it) => `${title} (${it})`);
-  } else if (component) {
-    return component;
-  } else if (title) {
-    return [title];
-  } else {
-    return [];
-  }
-}
-function isIndexable(doc) {
-  return Boolean(doc.visible && doc.fileInfo.outputName);
-}
-function getTerms(doc) {
-  return {
-    url: createMarkdownRenderer.getOutputFilePath(".", doc.fileInfo) ?? "",
-    title: doc.name,
-    words: extractTerms(doc)
-  };
-}
-function searchProcessor() {
-  return {
-    after: "generate-docs",
-    name: "search-processor",
-    handler(context) {
-      const entries = context.docs.filter(isIndexable).map(getTerms);
-      const index = generateIndex(entries);
-      const body = JSON.stringify(index);
-      const fingerprint = createMarkdownRenderer.getFingerprint(body);
-      const integrity = getIntegrity(body);
-      const outputName = `search-data-[hash].json`;
-      const expandedName = `search-data-${fingerprint}.json`;
-      context.setTemplateData("searchDataUrl", expandedName);
-      context.setTemplateData("searchDataIntegrity", integrity);
-      context.addDocument({
-        id: "search:data",
-        name: "search-data",
-        alias: [],
-        visible: false,
-        attributes: {
-          sortorder: Infinity
-        },
-        body,
-        outline: [],
-        format: "json",
-        tags: [],
-        template: "json",
-        fileInfo: {
-          path: "",
-          name: "virtual:search-data",
-          fullPath: "virtual:search-data",
-          outputName
-        }
-      });
-      context.addTemplateBlock("toolbar", "search-toolbar", {
-        filename: "partials/search-toolbar.html",
-        data: {
-          rootUrl(doc) {
-            const { fileInfo } = doc;
-            const relative = path$1.relative(fileInfo.path, ".");
-            return relative !== "" ? relative : ".";
-          }
-        }
-      });
-      context.addTemplateBlock("body:end", "search-dialog", {
-        filename: "partials/search-dialog.html"
-      });
-      context.log("Indexed", entries.length, "documents");
-    }
-  };
-}
-
-function toArray(value) {
-  return Array.isArray(value) ? value : [value];
-}
 function filterProcessors(stage2, processors) {
   const before = [];
   const during = [];
@@ -1958,10 +1767,10 @@ function createContext() {
       return sidenav;
     },
     addDocument(document) {
-      docs = [...docs, ...toArray(document)];
+      docs = [...docs, ...toArray$1(document)];
     },
     addVendorAsset(asset) {
-      vendors = [...vendors, ...toArray(asset)];
+      vendors = [...vendors, ...toArray$1(asset)];
     },
     addResource(dst, src) {
       resources.push({
@@ -2151,7 +1960,319 @@ class Generator {
   }
 }
 
+function toArray(value) {
+  return Array.isArray(value) ? value : [value];
+}
+function matomoProcessor(options) {
+  const { enabled, siteId, apiUrl, trackerUrl, hostname } = options;
+  return {
+    after: "generate-docs",
+    name: "matomo-processor",
+    enabled,
+    handler(context) {
+      context.addTemplateBlock("head", "matomo", {
+        filename: "partials/matomo.html",
+        data: {
+          siteId,
+          apiUrl,
+          trackerUrl,
+          hostname: hostname ? toArray(hostname) : []
+        }
+      });
+    }
+  };
+}
+
+function renderMarkdown(manifest) {
+  return [
+    "## Documentation manifest",
+    "",
+    "> Do not edit this file. It is a automatically generated by `@forsakringskassan/docs-generator`.",
+    "",
+    "```",
+    ...manifest.pages.map((it) => it.path),
+    "```",
+    ""
+  ].join("\n");
+}
+function renderJSON(manifest) {
+  return JSON.stringify(manifest, null, 2);
+}
+function manifestProcessor(options) {
+  const { markdown, json } = options;
+  return {
+    name: "manifestProcessor",
+    before: "render",
+    async handler(context) {
+      const docs = context.docs.filter(haveOutput);
+      const pages = docs.map(manifestPageFromDocument);
+      pages.sort((a, b) => {
+        return a.path.localeCompare(b.path);
+      });
+      const manifest = { pages };
+      if (markdown) {
+        const content = renderMarkdown(manifest);
+        await fs.writeFile(markdown, content, "utf-8");
+      }
+      if (json) {
+        const content = renderJSON(manifest);
+        await fs.writeFile(json, content, "utf-8");
+      }
+    }
+  };
+}
+
+function themeSelectProcessor() {
+  return {
+    name: "theme-select-processor",
+    after: "generate-docs",
+    handler(context) {
+      context.addTemplateBlock("toolbar", "theme-select", {
+        filename: "partials/theme-select.html"
+      });
+    }
+  };
+}
+
+function selectableVersionProcessor(pkg, container) {
+  return {
+    name: "selectable-version-processor",
+    after: "generate-docs",
+    handler(context) {
+      context.addTemplateBlock(container, "version", {
+        filename: "partials/selectable-version.html",
+        data: { pkg }
+      });
+    }
+  };
+}
+
+function generateNavigation(entries) {
+  const children = entries.map((it, index) => {
+    const key = path$1.parse(it.path).name;
+    return {
+      key,
+      sortorder: index,
+      children: [],
+      ...it
+    };
+  });
+  return {
+    key: ".",
+    path: "./index.html",
+    sortorder: Infinity,
+    children
+  };
+}
+function topnavProcessor(filename, title) {
+  return {
+    after: "generate-nav",
+    name: "topnav-processor",
+    async handler(context) {
+      const content = await fs.readFile(filename, "utf-8");
+      const parsed = JSON.parse(content);
+      const rootNode = generateNavigation(parsed);
+      context.setTopNavigation({
+        title,
+        ...rootNode
+      });
+    }
+  };
+}
+
+function run(cmd, defaultValue) {
+  return new Promise((resolve) => {
+    childProcess.exec(cmd, { encoding: "utf-8" }, (error, stdout) => {
+      if (error) {
+        console.error(error);
+        resolve(defaultValue);
+      } else {
+        resolve(stdout.trim());
+      }
+    });
+  });
+}
+async function getGitBranch() {
+  const { CHANGE_BRANCH, CHANGE_NAME } = process.env;
+  if (CHANGE_BRANCH) {
+    return CHANGE_BRANCH;
+  }
+  if (CHANGE_NAME) {
+    return CHANGE_NAME;
+  }
+  const branch = await run("git rev-parse --abbrev-ref HEAD", "unknown");
+  if (branch === "HEAD" || branch === "") {
+    return "unknown";
+  } else {
+    return branch;
+  }
+}
+function getPullRequestID() {
+  return process.env.JOB_BASE_NAME;
+}
+async function getSCMData(pkg, options) {
+  const commitHash = await run(`git rev-parse HEAD`);
+  const commitShort = await run(`git rev-parse --short HEAD`);
+  if (!commitHash || !commitShort) {
+    return null;
+  }
+  const { homepage } = pkg;
+  const pr = getPullRequestID();
+  const prUrl = pr ? interpolate(options.prUrlFormat, { homepage, pr }) : void 0;
+  return {
+    branch: await getGitBranch(),
+    commitShort,
+    commitHash,
+    commitUrl: interpolate(options.commitUrlFormat, {
+      hash: commitHash,
+      short: commitShort,
+      homepage
+    }),
+    pr,
+    prUrl
+  };
+}
+function getBuildDatetime() {
+  const date = /* @__PURE__ */ new Date();
+  return {
+    date: date.toLocaleDateString("sv-SE"),
+    time: date.toLocaleTimeString("sv-SE")
+  };
+}
+function versionProcessor(pkg, container, options) {
+  const { enabled = true, scm = false } = options ?? {};
+  return {
+    name: "version-processor",
+    after: "generate-docs",
+    async handler(context) {
+      if (!enabled) {
+        return;
+      }
+      const scmData = scm ? await getSCMData(pkg, scm) : null;
+      const buildData = getBuildDatetime();
+      const data = {
+        pkg,
+        scm: scmData,
+        build: buildData
+      };
+      context.addTemplateBlock(container, "version", {
+        filename: "partials/version.njk.html",
+        data
+      });
+    }
+  };
+}
+
+function versionBannerProcessor(message, container) {
+  return {
+    name: "version-banner-processor",
+    after: "generate-docs",
+    handler(context) {
+      context.addTemplateBlock(container, "version-banner", {
+        filename: "partials/version-banner.html",
+        data: { message }
+      });
+    }
+  };
+}
+
+function generateIndex(entries) {
+  const index = {
+    terms: [],
+    results: [],
+    mapping: {}
+  };
+  for (const entry of entries) {
+    index.results.push({
+      url: entry.url,
+      title: entry.title
+    });
+    const resultIndex = index.results.length - 1;
+    for (const word of entry.words) {
+      index.terms.push(word);
+      const termIndex = index.terms.length - 1;
+      index.mapping[termIndex] = resultIndex;
+    }
+  }
+  return index;
+}
+
+function extractTerms(doc) {
+  const { title, component } = doc.attributes;
+  if (title && component) {
+    return component.map((it) => `${title} (${it})`);
+  } else if (component) {
+    return component;
+  } else if (title) {
+    return [title];
+  } else {
+    return [];
+  }
+}
+function isIndexable(doc) {
+  return Boolean(doc.visible && doc.fileInfo.outputName);
+}
+function getTerms(doc) {
+  return {
+    url: createMarkdownRenderer.getOutputFilePath(".", doc.fileInfo) ?? "",
+    title: doc.name,
+    words: extractTerms(doc)
+  };
+}
+function searchProcessor() {
+  return {
+    after: "generate-docs",
+    name: "search-processor",
+    handler(context) {
+      const entries = context.docs.filter(isIndexable).map(getTerms);
+      const index = generateIndex(entries);
+      const body = JSON.stringify(index);
+      const fingerprint = createMarkdownRenderer.getFingerprint(body);
+      const integrity = getIntegrity(body);
+      const outputName = `search-data-[hash].json`;
+      const expandedName = `search-data-${fingerprint}.json`;
+      context.setTemplateData("searchDataUrl", expandedName);
+      context.setTemplateData("searchDataIntegrity", integrity);
+      context.addDocument({
+        id: "search:data",
+        name: "search-data",
+        alias: [],
+        visible: false,
+        attributes: {
+          sortorder: Infinity
+        },
+        body,
+        outline: [],
+        format: "json",
+        tags: [],
+        template: "json",
+        fileInfo: {
+          path: "",
+          name: "virtual:search-data",
+          fullPath: "virtual:search-data",
+          outputName
+        }
+      });
+      context.addTemplateBlock("toolbar", "search-toolbar", {
+        filename: "partials/search-toolbar.html",
+        data: {
+          rootUrl(doc) {
+            const { fileInfo } = doc;
+            const relative = path$1.relative(fileInfo.path, ".");
+            return relative !== "" ? relative : ".";
+          }
+        }
+      });
+      context.addTemplateBlock("body:end", "search-dialog", {
+        filename: "partials/search-dialog.html"
+      });
+      context.log("Indexed", entries.length, "documents");
+    }
+  };
+}
+
 exports.Generator = Generator;
+exports.defineSources = defineSources;
 exports.frontMatterFileReader = frontMatterFileReader;
 exports.livereloadProcessor = livereloadProcessor;
 exports.manifestProcessor = manifestProcessor;
@@ -2160,6 +2281,7 @@ exports.navigationFileReader = navigationFileReader;
 exports.searchProcessor = searchProcessor;
 exports.selectableVersionProcessor = selectableVersionProcessor;
 exports.themeSelectProcessor = themeSelectProcessor;
+exports.topnavProcessor = topnavProcessor;
 exports.versionBannerProcessor = versionBannerProcessor;
 exports.versionProcessor = versionProcessor;
 exports.vueFileReader = vueFileReader;