@forsakringskassan/docs-generator 2.12.0 → 2.14.0

package/dist/index.js

@@ -1,13 +1,13 @@
 'use strict';
 
 var fs = require('node:fs/promises');
-var vendor = require('./vendor-CJBsNZrh.js');
-var path = require('node:path');
+var path = require('node:path/posix');
+var vendor = require('./vendor-Bb38Rlio.js');
+var path$1 = require('node:path');
 var require$$1 = require('crypto');
-var createMarkdownRenderer = require('./create-markdown-renderer-D5z4jt-T.js');
-var node_child_process = require('node:child_process');
-var path$1 = require('node:path/posix');
 require('node:crypto');
+var createMarkdownRenderer = require('./create-markdown-renderer-DVss8WXD.js');
+var node_child_process = require('node:child_process');
 var util = require('node:util');
 var vueDocgenApi = require('vue-docgen-api');
 var fs$1 = require('node:fs');
@@ -16,13 +16,13 @@ var node_url = require('node:url');
 var Module = require('node:module');
 var esbuild$1 = require('esbuild');
 var nunjucks = require('nunjucks');
-var vue = require('vue');
-var vue3 = require('./vue3-rkJOanAd.js');
 var express = require('express');
 require('fs');
 require('node:events');
 require('node:stream');
 require('node:string_decoder');
+require('@vue/compiler-sfc');
+require('typescript');
 require('constants');
 require('stream');
 require('util');
@@ -32,8 +32,6 @@ require('readline');
 require('events');
 require('node:process');
 require('node:stream/promises');
-require('@vue/compiler-sfc');
-require('typescript');
 require('fs/promises');
 require('os');
 require('http');
@@ -44,6 +42,8 @@ require('net');
 require('tls');
 require('tty');
 require('querystring');
+require('vue');
+require('./vue3-BqgRpcI0.js');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function toArray$2(value) {
@@ -225,21 +225,6 @@ function interpolate(value, data) {
   });
 }
 
-function parseImport(raw) {
-  const comments = [];
-  const stripped = raw.replace(/<!--.*?-->/gms, (match) => {
-    comments.push(match);
-    return "";
-  });
-  const filename = stripped.trim();
-  const extension = path.parse(filename).ext.slice(1);
-  return {
-    filename,
-    extension,
-    comments
-  };
-}
-
 function quote(text) {
   return String(text).replace(/"/g, "&quot;");
 }
@@ -277,6 +262,108 @@ function slugify(value) {
   return value.toLowerCase().replace(/\//g, "--").replace(/[^a-z]+/g, "-").replace(/(^-+|-+$)/, "");
 }
 
+const md$2 = vendor.MarkdownIt();
+md$2.renderer.rules.fence = (tokens, idx, _options, collected) => {
+  const { content, info } = tokens[idx];
+  const { language, tags } = createMarkdownRenderer.parseInfostring(info);
+  if (language === "import") {
+    return "";
+  }
+  collected.push({
+    content,
+    language,
+    tags
+  });
+  return "";
+};
+function findExamples$1(doc) {
+  if (doc.format !== "markdown") {
+    return [];
+  }
+  const collected = [];
+  md$2.render(doc.body, collected);
+  return collected;
+}
+function getSuffix(tags) {
+  const relevant = tags.filter((it) => ["nocompile", "nolint"].includes(it));
+  if (relevant.length > 0) {
+    return `-${relevant.join("-")}`;
+  } else {
+    return "";
+  }
+}
+function getExtension(lang) {
+  switch (lang) {
+    case "typescript":
+      return "ts";
+    case "javascript":
+      return "js";
+    default:
+      return lang;
+  }
+}
+function extractExamplesProcessor(options) {
+  const {
+    enabled = true,
+    outputFolder,
+    languages = ["javascript", "typescript", "css", "scss"]
+  } = options;
+  function isRelevant(example) {
+    return languages.includes(example.language);
+  }
+  return {
+    stage: "render",
+    name: "extract-examples-processor",
+    async handler(context) {
+      if (!enabled) {
+        return;
+      }
+      if (!outputFolder) {
+        throw new Error(
+          `"outputFolder" not set in "extractExamplesProcessor(..)"`
+        );
+      }
+      await fs.rm(outputFolder, { recursive: true, force: true });
+      let total = 0;
+      for (const doc of context.docs.filter(haveOutput)) {
+        const examples = findExamples$1(doc).filter(isRelevant);
+        if (examples.length === 0) {
+          continue;
+        }
+        const dir = createMarkdownRenderer.normalizePath(outputFolder, doc.fileInfo.fullPath);
+        await fs.mkdir(dir, { recursive: true });
+        let n = 1;
+        for (const example of examples) {
+          const suffix = getSuffix(example.tags);
+          const extension = getExtension(example.language);
+          const filename = `example-${String(n++)}${suffix}.${extension}`;
+          const filePath = path.join(dir, filename);
+          await fs.writeFile(filePath, example.content, "utf-8");
+          total++;
+        }
+      }
+      context.log(total, "examples extracted");
+    }
+  };
+}
+
+const md$1 = vendor.MarkdownIt();
+md$1.renderer.rules.fence = (tokens, idx, _options, collected) => {
+  const { content, info, map } = tokens[idx];
+  const { language, tags } = createMarkdownRenderer.parseInfostring(info);
+  const hashContent = `${map?.[0]}:${map?.[1]}:${info}:${content}`;
+  const fingerprint = createMarkdownRenderer.getFingerprint(hashContent);
+  let extension = void 0;
+  if (language === "import") {
+    extension = content.split(".").at(-1)?.trim();
+  }
+  collected.push({
+    selector: `#example-${fingerprint}`,
+    language: extension ?? language,
+    tags
+  });
+  return "";
+};
 function flattenOutline(outline) {
   return outline.flatMap((entry) => {
     return [
@@ -290,24 +377,7 @@ function findExamples(doc) {
     return [];
   }
   const collected = [];
-  const md = vendor.MarkdownIt();
-  md.renderer.rules.fence = (tokens, idx) => {
-    const { content, info, map } = tokens[idx];
-    const [language, ...tags] = info.split(/\s+/);
-    const hashContent = `${map?.[0]}:${map?.[1]}:${info}:${content}`;
-    const fingerprint = createMarkdownRenderer.getFingerprint(hashContent);
-    let extension = void 0;
-    if (language === "import") {
-      extension = content.split(".").at(-1)?.trim();
-    }
-    collected.push({
-      selector: `#example-${fingerprint}`,
-      language: extension ?? language,
-      tags
-    });
-    return "";
-  };
-  md.render(doc.body);
+  md$1.render(doc.body, collected);
   return collected;
 }
 function manifestPageFromDocument(doc) {
@@ -374,7 +444,7 @@ function normalizeOptions(options) {
   };
   return { ...defaults, ...options };
 }
-function motdProcessor(options) {
+function motdProcessor(options = {}) {
   const { enabled, container, message } = normalizeOptions(options);
   return {
     name: "motd-processor",
@@ -466,7 +536,7 @@ function relative(url, { fileInfo }) {
   if (outputPath === url || `${outputPath}/` === url) {
     return "./";
   }
-  const relative2 = path$1.relative(outputPath, url);
+  const relative2 = path.relative(outputPath, url);
   const prefix = relative2.startsWith(".") ? "" : "./";
   const suffix = url.endsWith("/") ? "/" : "";
   return [prefix, relative2, suffix].join("");
@@ -506,7 +576,7 @@ function htmlRedirectProcessor() {
         const filePath = createMarkdownRenderer.getOutputFilePath(outputFolder, doc.fileInfo);
         const dst = relative(doc.body, doc);
         const content = template(dst);
-        await fs.mkdir(path$1.dirname(filePath), { recursive: true });
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
         await fs.writeFile(filePath, vendor.dedent(content), "utf-8");
       }
     }
@@ -531,8 +601,8 @@ function redirectFileProcessor(prefix = "/", filename = "_redirects") {
         return `${prefix}${src} ${prefix}${dst} 301
 `;
       });
-      const filePath = path$1.join(context.outputFolder, filename);
-      await fs.mkdir(path$1.dirname(filePath), { recursive: true });
+      const filePath = path.join(context.outputFolder, filename);
+      await fs.mkdir(path.dirname(filePath), { recursive: true });
       await fs.writeFile(filePath, lines.join(""), "utf-8");
       context.log(filename, "generated");
     }
@@ -562,7 +632,7 @@ function redirectProcessor() {
     async handler(context) {
       const redirects = getRedirects(context.docs);
       for (const redirect of redirects) {
-        const { dir, base, name } = path$1.parse(redirect.from);
+        const { dir, base, name } = path.parse(redirect.from);
         context.addDocument({
           id: `redirect:${redirect.from}-${redirect.to}`,
           name: `${redirect.from}-${redirect.to}`,
@@ -621,7 +691,7 @@ function selectableVersionProcessor(pkg, container, options) {
 
 function generateNavigation(entries) {
   const children = entries.map((it, index) => {
-    const key = path$1.parse(it.path).name;
+    const key = path.parse(it.path).name;
     return {
       key,
       sortorder: index,
@@ -805,7 +875,7 @@ function toArray$1(value) {
   return Array.isArray(value) ? value : [value];
 }
 function isIndexPage(parsed) {
-  const folder = path.basename(parsed.dir);
+  const folder = path$1.basename(parsed.dir);
   if (parsed.name === folder) {
     return true;
   }
@@ -857,8 +927,8 @@ function getComponent(attrs) {
   });
 }
 function parseFile$1(filePath, basePath, content) {
-  const relative = basePath ? path.relative(basePath, createMarkdownRenderer.normalizePath(filePath)) : createMarkdownRenderer.normalizePath(filePath);
-  const parsed = path.parse(relative);
+  const relative = basePath ? path$1.relative(basePath, createMarkdownRenderer.normalizePath(filePath)) : createMarkdownRenderer.normalizePath(filePath);
+  const parsed = path$1.parse(relative);
   const blocks = vendor.fm(content);
   const attributes = blocks.attributes;
   const isIndex = isIndexPage(parsed);
@@ -1038,7 +1108,7 @@ function parseAPIToArray(api) {
 }
 function parseAPI(filePath, api) {
   const relative = createMarkdownRenderer.normalizePath(filePath);
-  const parsedPath = path.parse(relative);
+  const parsedPath = path$1.parse(relative);
   const componentName = parsedPath.name;
   let html = "";
   if (api.props.length) {
@@ -1085,7 +1155,9 @@ async function globAll(pattern) {
   if (!Array.isArray(pattern)) {
     return globAll([pattern]);
   }
-  const results = await Promise.all(pattern.map((it) => vendor.glob(it)));
+  const results = await Promise.all(
+    pattern.map((it) => vendor.glob(it, { nodir: true }))
+  );
   return new Set(results.flat());
 }
 async function getDocumentsForSource(src) {
@@ -1126,8 +1198,8 @@ function parseFile(filePath, basePath, content) {
   if (!title) {
     throw new Error(`No title property set in "${filePath}"`);
   }
-  const relative = basePath ? path.relative(basePath, createMarkdownRenderer.normalizePath(filePath)) : createMarkdownRenderer.normalizePath(filePath);
-  const parsed = path.parse(relative);
+  const relative = basePath ? path$1.relative(basePath, createMarkdownRenderer.normalizePath(filePath)) : createMarkdownRenderer.normalizePath(filePath);
+  const parsed = path$1.parse(relative);
   const filename = parsed.name.toLowerCase();
   const name = parsed.name;
   const urlpath = parsed.dir;
@@ -1162,7 +1234,7 @@ async function navigationFileReader(filePath, basePath) {
 }
 
 function resolveFrom(fromDirectory, moduleId) {
-  const fromFile = path.join(fs$1.realpathSync(fromDirectory), "noop.js");
+  const fromFile = path$1.join(fs$1.realpathSync(fromDirectory), "noop.js");
   return Module._resolveFilename(moduleId, {
     id: fromFile,
     filename: fromFile,
@@ -1178,8 +1250,8 @@ function moduleImporter(options) {
       if (url.startsWith(WEBPACK_NODE_MODULE_PREFIX)) {
         findUrl = url.substring(1);
       }
-      const directory = path.dirname(findUrl);
-      const fileName = path.basename(findUrl);
+      const directory = path$1.dirname(findUrl);
+      const fileName = path$1.basename(findUrl);
       const search = [
         `${fileName}.css`,
         `${fileName}.scss`,
@@ -1188,7 +1260,7 @@ function moduleImporter(options) {
       ];
       for (const variant of search) {
         try {
-          const moduleName = path.posix.join(directory, variant);
+          const moduleName = path$1.posix.join(directory, variant);
           const resolved = resolveFrom(cwd, moduleName);
           return new URL(node_url.pathToFileURL(resolved));
         } catch (err) {
@@ -1208,21 +1280,21 @@ async function compileSassString(dst, style, options = {}) {
     style: "expanded",
     importers: [new sass.NodePackageImporter(), moduleImporter({ cwd })]
   });
-  await fs.mkdir(path.dirname(dst), { recursive: true });
+  await fs.mkdir(path$1.dirname(dst), { recursive: true });
   await fs.writeFile(dst, result.css, "utf-8");
 }
 
 async function compileStyle(assetFolder, name, src, options) {
   const { cwd } = options;
   try {
-    const outfile = path$1.join("temp", `asset-${name}.css`);
+    const outfile = path.join("temp", `asset-${name}.css`);
     const source = await fs.readFile(src, "utf-8");
     await compileSassString(outfile, source, { cwd });
     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);
+    const dst = path.join(assetFolder, filename);
     await fs.rename(outfile, dst);
     const stat = await fs.stat(dst);
     return {
@@ -1298,7 +1370,7 @@ async function compileScript(options) {
   const iconLib = process.env.DOCS_ICON_LIB ?? "@fkui/icon-lib-default";
   try {
     const entryPoints = [src instanceof URL ? node_url.fileURLToPath(src) : src];
-    const outfile = path.join("temp", `asset-${name}.js`);
+    const outfile = path$1.join("temp", `asset-${name}.js`);
     await esbuild({
       entryPoints,
       outfile,
@@ -1306,7 +1378,7 @@ async function compileScript(options) {
       format: "iife",
       platform: "browser",
       external: ["vue", "@fkui/vue"],
-      tsconfig: path.join(__dirname, "../tsconfig-examples.json"),
+      tsconfig: path$1.join(__dirname, "../tsconfig-examples.json"),
       ...buildOptions,
       define: {
         "process.env.DOCS_ICON_LIB": JSON.stringify(iconLib),
@@ -1317,8 +1389,8 @@ async function compileScript(options) {
     const fingerprint = createMarkdownRenderer.getFingerprint(content);
     const integrity = getIntegrity(content);
     const filename = `${name}-${fingerprint}.js`;
-    const dst = path.join(assetFolder, filename);
-    await fs$1.mkdir(path.dirname(dst), { recursive: true });
+    const dst = path$1.join(assetFolder, filename);
+    await fs$1.mkdir(path$1.dirname(dst), { recursive: true });
     await fs$1.rename(outfile, dst);
     const stat = await fs$1.stat(dst);
     return {
@@ -1384,7 +1456,7 @@ function staticResourcesProcessor(assetFolder, resources) {
     async handler(context) {
       for (const resource of [...resources, ...context.resources]) {
         const src = resource.from;
-        const dst = path$1.join(assetFolder, resource.to);
+        const dst = path.join(assetFolder, resource.to);
         await fs.cp(src, dst, {
           recursive: true
         });
@@ -1410,7 +1482,7 @@ function compileProcessorRuntime(generator, distDir, processors) {
       const assetName = [
         "processors",
         processor.name.replace(/-processor/, ""),
-        entry.name ?? path.parse(entry.src).name
+        entry.name ?? path$1.parse(entry.src).name
       ].join("/");
       const name = processorRuntimeName(processor, entry);
       const bundled = new URL(`${name}.js`, distDir);
@@ -1430,110 +1502,6 @@ function compileProcessorRuntime(generator, distDir, processors) {
   }
 }
 
-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);
-function vueGenerator() {
-  switch (vueMajor) {
-    case 2:
-      throw new Error(
-        "Vue 2 is no longer supported, upgrade to Vue 3 or downgrade docs-generator"
-      );
-    case 3:
-      return vue3.generateCode;
-  }
-}
-function generateExample(options) {
-  const { language } = options;
-  if (language === "import") {
-    const parsed = parseImport(options.source);
-    const filename = getExampleImport(
-      options.exampleFolders,
-      parsed.filename
-    );
-    const source = fs$1.readFileSync(filename, "utf-8");
-    const language2 = parsed.extension;
-    const comments = parsed.comments;
-    const example = generateExample({
-      ...options,
-      source,
-      language: language2,
-      filename
-    });
-    return { ...example, comments };
-  }
-  switch (language) {
-    case "vue":
-      return generateVueExample(options);
-    case "html":
-      return generateStaticExample(options);
-    default:
-      return generateStaticExample(options);
-  }
-}
-function generateVueExample(options) {
-  const { filename, source, parent, setupPath, tags } = options;
-  const fn = vueGenerator();
-  const slug = getExampleName(filename);
-  const fingerprint = createMarkdownRenderer.getFingerprint(source);
-  const { markup, sourcecode, output } = fn({
-    filename,
-    slug,
-    fingerprint,
-    code: source,
-    setupPath
-  });
-  return {
-    source,
-    language: options.language,
-    comments: [],
-    tags,
-    markup,
-    output,
-    runtime: true,
-    task: {
-      outputFile: output,
-      sourcecode,
-      sourceFile: filename,
-      parent
-    }
-  };
-}
-function generateStaticExample(options) {
-  const { filename, source, language, tags } = options;
-  const slug = getExampleName(filename);
-  const fingerprint = createMarkdownRenderer.getFingerprint(source);
-  const asset = `${slug}-${fingerprint}.${language}`;
-  const runtimeLanguages = ["html"];
-  const runtime = runtimeLanguages.includes(language);
-  return {
-    source,
-    language: options.language,
-    comments: [],
-    tags,
-    markup: source,
-    output: runtime ? asset : null,
-    runtime,
-    task: null
-  };
-}
-
 function isNavigationSection(node) {
   return "key" in node;
 }
@@ -1542,7 +1510,7 @@ function pathFromDoc({ fileInfo }) {
     return [fileInfo.path.replace(/\\/g, "/"), true];
   } else {
     return [
-      `./${path.join(fileInfo.path, fileInfo.name).replace(/\\/g, "/")}`,
+      `./${path$1.join(fileInfo.path, fileInfo.name).replace(/\\/g, "/")}`,
       false
     ];
   }
@@ -1740,7 +1708,7 @@ class TemplateLoader {
   folders;
   templateCache;
   constructor(folders = []) {
-    this.folders = [...folders, path.join(__dirname, "../templates")];
+    this.folders = [...folders, path$1.join(__dirname, "../templates")];
     this.templateCache = /* @__PURE__ */ new Map();
   }
   async getSource(name, callback) {
@@ -1791,7 +1759,7 @@ Make sure the name is correct and the template file exists in one of the listed
   }
   findTemplateFile(name) {
     const { folders } = this;
-    const searchPaths = folders.map((it) => path.join(it, name));
+    const searchPaths = folders.map((it) => path$1.join(it, name));
     return searchPaths.find((it) => fs$1.existsSync(it));
   }
 }
@@ -1813,7 +1781,7 @@ class MissingTemplateError extends Error {
     ].join("\n");
   }
 }
-const templateDirectory = path.join(__dirname, "../templates");
+const templateDirectory = path$1.join(__dirname, "../templates");
 const cache$1 = /* @__PURE__ */ new Map();
 function cacheKey(layout, extension) {
   return [layout, extension].join("|");
@@ -1835,7 +1803,7 @@ function findTemplate(folders, from, src, format) {
   folders = [...folders, templateDirectory];
   const template = `${layout}.template.${format}`;
   const searchPaths = folders.map((it) => {
-    return path.join(it, template);
+    return path$1.join(it, template);
   });
   const found = searchPaths.find((it) => fs$1.existsSync(it));
   if (!found) {
@@ -1845,7 +1813,7 @@ function findTemplate(folders, from, src, format) {
   return template;
 }
 
-const scriptPath = path.join(__dirname, "compile-example.js");
+const scriptPath = path$1.join(__dirname, "compile-example.js");
 let loader = null;
 function haveOutputFile(fileInfo) {
   return fileInfo.outputName !== false;
@@ -1879,8 +1847,8 @@ function findSidenav(doc, tree) {
 }
 function cache(cacheFolder, outputFolder) {
   return (it) => {
-    const cacheFile = path.join(cacheFolder, it.outputFile);
-    const outputFile = path.join(outputFolder, it.outputFile);
+    const cacheFile = path$1.join(cacheFolder, it.outputFile);
+    const outputFile = path$1.join(outputFolder, it.outputFile);
     if (fs$1.existsSync(cacheFile)) {
       fs$1.copyFileSync(cacheFile, outputFile);
       return false;
@@ -1894,8 +1862,8 @@ async function compileExamples(options) {
   if (tasks.length === 0) {
     return;
   }
-  const cacheFolder = path.posix.join(options.cacheFolder, fileInfo.path);
-  const outputFolder = path.posix.join(options.outputFolder, fileInfo.path);
+  const cacheFolder = path$1.posix.join(options.cacheFolder, fileInfo.path);
+  const outputFolder = path$1.posix.join(options.outputFolder, fileInfo.path);
   const cacheMiss = cache(cacheFolder, outputFolder);
   const dirtyTasks = tasks.filter(cacheMiss);
   if (dirtyTasks.length === 0) {
@@ -1918,8 +1886,8 @@ async function compileStandalones(options) {
   if (tasks.length === 0) {
     return;
   }
-  const cacheFolder = path.posix.join(options.cacheFolder, fileInfo.path);
-  const outputFolder = path.posix.join(options.outputFolder, fileInfo.path);
+  const cacheFolder = path$1.posix.join(options.cacheFolder, fileInfo.path);
+  const outputFolder = path$1.posix.join(options.outputFolder, fileInfo.path);
   const cacheMiss = cache(cacheFolder, outputFolder);
   const dirtyTasks = tasks.filter(cacheMiss);
   const standaloneTemplate = findTemplate(
@@ -1928,7 +1896,7 @@ async function compileStandalones(options) {
     "example"
   );
   for (const task of dirtyTasks) {
-    const outputFile = path.join(outputFolder, task.outputFile);
+    const outputFile = path$1.join(outputFolder, task.outputFile);
     const content = await renderTemplate(standaloneTemplate, {
       ...templateData,
       content: task.content
@@ -1947,7 +1915,7 @@ async function render(doc, docs, nav, vendors, options) {
     return null;
   }
   const dst = createMarkdownRenderer.getOutputFilePath(outputFolder, fileInfo);
-  const mkdir = fs.mkdir(path.dirname(dst), { recursive: true });
+  const mkdir = fs.mkdir(path$1.dirname(dst), { recursive: true });
   const topnav = nav.topnav;
   const sidenav = findSidenav(doc, nav.sidenav);
   if (sidenav && isNavigationSection(sidenav)) {
@@ -1964,7 +1932,7 @@ async function render(doc, docs, nav, vendors, options) {
     topnav,
     rootUrl(doc2) {
       const { fileInfo: fileInfo2 } = doc2;
-      const relative = path$1.relative(fileInfo2.path, ".");
+      const relative = path.relative(fileInfo2.path, ".");
       return relative !== "" ? relative : ".";
     },
     sidenav,
@@ -1975,7 +1943,7 @@ async function render(doc, docs, nav, vendors, options) {
   const markdownRenderer = createMarkdownRenderer.createMarkdownRenderer({
     docs,
     generateExample({ source, language, filename, tags }) {
-      const example = generateExample({
+      const example = createMarkdownRenderer.generateExample({
         source,
         language,
         filename,
@@ -1985,12 +1953,12 @@ async function render(doc, docs, nav, vendors, options) {
         tags
       });
       if (example.output) {
-        const { dir, name } = path.parse(example.output);
+        const { dir, name } = path$1.parse(example.output);
         if (example.task) {
           generatedExamples.push(example.task);
         }
         generatedStandalone.push({
-          outputFile: path.join(dir, `${name}.html`),
+          outputFile: path$1.join(dir, `${name}.html`),
           content: example.markup
         });
       }
@@ -2190,12 +2158,12 @@ function getAssetSource(asset, require) {
   return lines.join("\n");
 }
 async function compileVendor(assetFolder, vendor, options) {
-  const name = path.isAbsolute(vendor.package) ? path.basename(vendor.package) : vendor.package;
+  const name = path$1.isAbsolute(vendor.package) ? path$1.basename(vendor.package) : vendor.package;
   const slug = slugify(name);
   const outfile = `temp/vendor-${slug}.out.js`;
   const tmpfile = `temp/vendor-${slug}.in.js`;
   const source = getAssetSource(vendor, customRequire.toString());
-  const tsconfig = path.resolve(__dirname, "../tsconfig-examples.json");
+  const tsconfig = path$1.resolve(__dirname, "../tsconfig-examples.json");
   await fs.writeFile(tmpfile, source, "utf-8");
   await esbuild$1.build({
     entryPoints: [tmpfile],
@@ -2217,7 +2185,7 @@ async function compileVendor(assetFolder, vendor, options) {
   const fingerprint = createMarkdownRenderer.getFingerprint(content);
   const integrity = getIntegrity(content);
   const filename = `vendor-${slug}-${fingerprint}.js`;
-  const dst = path.join(assetFolder, filename).replace(/\\/g, "/");
+  const dst = path$1.join(assetFolder, filename).replace(/\\/g, "/");
   await fs.rename(outfile, dst);
   const stat = await fs.stat(dst);
   return {
@@ -2270,7 +2238,7 @@ function vendorProcessor(assetFolder, vendor) {
       const assets = await generateVendorAssets(assetFolder, vendor);
       context.addVendorAsset(assets);
       for (const asset of assets) {
-        const filename = path$1.basename(asset.publicPath);
+        const filename = path.basename(asset.publicPath);
         context.log(filename, formatSize(asset.size));
       }
     }
@@ -2350,7 +2318,7 @@ async function serve(options) {
   const watcher = vendor.watch(options.watch);
   const rebuild = createRebuilder(options.rebuild, (filePath) => {
     const files = filePath.map((it) => {
-      return path$1.relative(options.outputFolder, it);
+      return path.relative(options.outputFolder, it);
     });
     livereload.changed({ body: { files } });
   });
@@ -2529,10 +2497,10 @@ class Generator {
       throw new Error("site metadata not set in configuration");
     }
     this.site = options.site;
-    this.outputFolder = options.outputFolder;
-    this.cacheFolder = options.cacheFolder;
-    this.assetFolder = path.posix.join(options.outputFolder, "assets");
-    this.exampleFolders = options.exampleFolders;
+    this.outputFolder = options.outputFolder ?? "./public";
+    this.cacheFolder = options.cacheFolder ?? "./temp/docs";
+    this.assetFolder = path$1.posix.join(this.outputFolder, "assets");
+    this.exampleFolders = options.exampleFolders ?? [];
     this.templateFolders = options.templateFolders ?? [];
     this.processors = options.processors ?? [];
     this.vendor = options.vendor ?? [];
@@ -2670,7 +2638,7 @@ class Generator {
     const { outputFolder, cacheFolder, assetFolder } = this;
     await fs.rm(cacheFolder, { force: true, recursive: true });
     if (fs$1.existsSync(outputFolder)) {
-      await fs.mkdir(path.dirname(cacheFolder), { recursive: true });
+      await fs.mkdir(path$1.dirname(cacheFolder), { recursive: true });
       await vendor.fse.copy(outputFolder, cacheFolder);
       await fs.rm(outputFolder, { recursive: true });
     }
@@ -2775,6 +2743,7 @@ exports.Generator = Generator;
 exports.availableProcessors = availableProcessors;
 exports.cookieProcessor = cookieProcessor;
 exports.defineSources = defineSources;
+exports.extractExamplesProcessor = extractExamplesProcessor;
 exports.frontMatterFileReader = frontMatterFileReader;
 exports.htmlRedirectProcessor = htmlRedirectProcessor;
 exports.livereloadProcessor = livereloadProcessor;