@forsakringskassan/docs-generator 2.17.1 → 2.18.0

package/dist/compile-example.js

@@ -3,10 +3,10 @@
 var path$1 = require('node:path');
 var esbuild = require('esbuild');
 var vue = require('vue');
-var vue3 = require('./vue3-B1yNeGmz.js');
+var vue3 = require('./vue3-CEAR7ggN.js');
 var path = require('node:path/posix');
 require('@vue/compiler-sfc');
-require('./vendor-BeoVq2Sv.js');
+require('./vendor-Bagon7WF.js');
 require('node:url');
 require('fs');
 require('node:fs');

package/dist/{create-markdown-renderer-2ejm6Tub.js → create-markdown-renderer-CaJTFjAd.js}

@@ -1,6 +1,6 @@
 'use strict';
 
-var vendor = require('./vendor-BeoVq2Sv.js');
+var vendor = require('./vendor-Bagon7WF.js');
 var path = require('node:path/posix');
 var path$1 = require('node:path');
 require('crypto');
@@ -8,7 +8,7 @@ var crypto = require('node:crypto');
 require('node:child_process');
 var fs = require('node:fs');
 var vue = require('vue');
-var vue3 = require('./vue3-B1yNeGmz.js');
+var vue3 = require('./vue3-CEAR7ggN.js');
 
 function findDocument(haystack, needle) {
   const match = haystack.find((it) => {
@@ -538,13 +538,18 @@ function getStandalonePath(output) {
 function getSource(content, language, tags, { namedExamples }) {
   const compare = findTag(tags, "compare");
   if (compare && compare.value !== null) {
+    const { value: context } = findTag(tags, "context") ?? {};
     const reference = namedExamples.get(compare.value);
     if (!reference) {
       throw new Error(
         `Failed to find referenced example "${compare.value}"`
       );
     }
-    const diff = vendor.createTwoFilesPatch("a", "b", reference.content, content).split("\n").slice(3).filter((it) => !it.startsWith("@@")).join("\n");
+    const a = transformCode(reference.content, reference.language);
+    const b = transformCode(content, language);
+    const diff = vendor.createTwoFilesPatch("a", "b", a, b, "", "", {
+      context: context ? parseInt(context, 10) : 3
+    }).split("\n").slice(4).join("\n");
     return {
       source: diff,
       language: "diff"
@@ -566,7 +571,8 @@ function codePreview(options) {
       env.namedExamples.set(name, {
         name,
         tags: rawTags,
-        content: rawContent
+        content: rawContent,
+        language: rawLanguage
       });
     }
     if (hasTag(rawTags, "hidden")) {

package/dist/index.d.ts

@@ -325,6 +325,9 @@ export declare interface ManifestProcessorOptions {
     markdown?: string;
     /** If set, the manifest will be written as JSON to this destination */
     json?: string;
+    /** If set to `true` the markdown manifest will be verified instead of
+     * written (typically enabled during CI) */
+    verify?: boolean;
 }
 
 /**

package/dist/index.js

@@ -2,11 +2,11 @@
 
 var fs = require('node:fs/promises');
 var path = require('node:path/posix');
-var vendor = require('./vendor-BeoVq2Sv.js');
+var vendor = require('./vendor-Bagon7WF.js');
 var path$1 = require('node:path');
 var require$$1 = require('crypto');
 require('node:crypto');
-var createMarkdownRenderer = require('./create-markdown-renderer-2ejm6Tub.js');
+var createMarkdownRenderer = require('./create-markdown-renderer-CaJTFjAd.js');
 var node_child_process = require('node:child_process');
 var util = require('node:util');
 var codeFrame = require('@babel/code-frame');
@@ -44,7 +44,7 @@ require('tls');
 require('tty');
 require('querystring');
 require('vue');
-require('./vue3-B1yNeGmz.js');
+require('./vue3-CEAR7ggN.js');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 function toArray$2(value) {
@@ -424,8 +424,26 @@ function renderMarkdown(manifest) {
 function renderJSON(manifest) {
   return JSON.stringify(manifest, null, 2);
 }
+function normalize(text) {
+  return text.replace(/\r\n/g, "\n");
+}
+class ManifestError extends Error {
+  filename;
+  constructor(filename) {
+    super(`Documentation manifest "${filename}" is not up-to-date!`);
+    this.filename = filename;
+  }
+  prettyError() {
+    const { filename, message } = this;
+    return [
+      message,
+      "",
+      `Run the build locally and commit the content of "${filename}".`
+    ].join("\n");
+  }
+}
 function manifestProcessor(options = {}) {
-  const { markdown, json } = options;
+  const { markdown, json, verify } = options;
   return {
     name: "manifestProcessor",
     before: "render",
@@ -437,8 +455,17 @@ function manifestProcessor(options = {}) {
       });
       const manifest = { pages };
       if (markdown) {
-        const content = renderMarkdown(manifest);
-        await fs.writeFile(markdown, content, "utf-8");
+        const content = normalize(renderMarkdown(manifest));
+        if (verify) {
+          const actual = normalize(
+            await fs.readFile(markdown, "utf-8")
+          );
+          if (actual !== content) {
+            throw new ManifestError(markdown);
+          }
+        } else {
+          await fs.writeFile(markdown, content, "utf-8");
+        }
       }
       if (json) {
         const content = renderJSON(manifest);

package/dist/markdown.js

@@ -1,7 +1,7 @@
 'use strict';
 
-var createMarkdownRenderer = require('./create-markdown-renderer-2ejm6Tub.js');
-require('./vendor-BeoVq2Sv.js');
+var createMarkdownRenderer = require('./create-markdown-renderer-CaJTFjAd.js');
+require('./vendor-Bagon7WF.js');
 require('node:url');
 require('node:path');
 require('fs');
@@ -37,7 +37,7 @@ require('querystring');
 require('node:path/posix');
 require('node:crypto');
 require('vue');
-require('./vue3-B1yNeGmz.js');
+require('./vue3-CEAR7ggN.js');
 
 
 

package/dist/{vendor-BeoVq2Sv.js → vendor-Bagon7WF.js}

@@ -26515,6 +26515,11 @@ function formatPatch(diff) {
 }
 function createTwoFilesPatch(oldFileName, newFileName, oldStr, newStr, oldHeader, newHeader, options) {
   var _options2;
+  if (typeof options === 'function') {
+    options = {
+      callback: options
+    };
+  }
   if (!((_options2 = options) !== null && _options2 !== undefined && _options2.callback)) {
     var patchObj = structuredPatch(oldFileName, newFileName, oldStr, newStr, oldHeader, newHeader, options);
     if (!patchObj) {

package/dist/{vue3-B1yNeGmz.js → vue3-CEAR7ggN.js}

@@ -1,7 +1,7 @@
 'use strict';
 
 var require$$0 = require('@vue/compiler-sfc');
-require('./vendor-BeoVq2Sv.js');
+require('./vendor-Bagon7WF.js');
 
 var __create = Object.create;
 var __defProp = Object.defineProperty;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forsakringskassan/docs-generator",
-  "version": "2.17.1",
+  "version": "2.18.0",
   "description": "Documentation generator",
   "keywords": [
     "documentation"