@forsakringskassan/docs-generator 1.25.2 → 1.26.0

package/dist/markdown.d.ts

@@ -135,7 +135,13 @@ export declare interface FileInfo {
     name: string;
     /** path relative to project root */
     fullPath: string;
-    /** output filename or `false` to disable writing result to a file */
+    /**
+     * Output filename or `false` to disable writing result to a file.
+     *
+     * When passing a filename these optional placeholders can be used:
+     *
+     * - `[hash]` - replaced with the hash of the content body.
+     */
     outputName: string | false;
 }
 

package/dist/markdown.js

@@ -18825,6 +18825,12 @@ function generateId(text2) {
   return text2.toLowerCase().trim().replace(/[åäö]/g, (m) => replacements[m]).replace(/[^a-z0-9]+/g, "_").replace(/^_+/, "").replace(/_+$/, "");
 }
 
+// src/utils/get-fingerprint.ts
+var import_node_crypto = __toESM(require("node:crypto"));
+function getFingerprint(source) {
+  return import_node_crypto.default.createHash("md5").update(source).digest("hex").slice(0, 6);
+}
+
 // src/utils/normalize-path.ts
 var import_posix = __toESM(require("node:path/posix"));
 function normalizePath(...pathSegments) {
@@ -19002,8 +19008,7 @@ function codePreview(options) {
   };
   function fence2(_md, tokens, idx, _options, env) {
     const { fileInfo } = env;
-    const { content: source } = tokens[idx];
-    const { info } = tokens[idx];
+    const { content: source, info, map } = tokens[idx];
     const [language, ...rawTags] = info.split(/\s+/);
     if (language === "mermaid") {
       return (
@@ -19020,6 +19025,8 @@ function codePreview(options) {
       tags: rawTags
     });
     const { tags } = example;
+    const hashContent = `${map == null ? void 0 : map[0]}:${map == null ? void 0 : map[1]}:${info}:${source}`;
+    const fingerprint = getFingerprint(hashContent);
     const highlightedCode = replaceAtLink(highlight(example));
     const testId = findTestId(tags);
     const liveExample = tags.includes("live-example");
@@ -19034,6 +19041,7 @@ function codePreview(options) {
         /* HTML */
         `
                 <div
+                    id="example-${fingerprint}"
                     class="code-preview code-preview--borderless"
                     ${testIdAttr}
                 >
@@ -19046,7 +19054,11 @@ function codePreview(options) {
       return (
         /* HTML */
         `
-                <div class="code-preview ${modifier}" ${testIdAttr}>
+                <div
+                    id="example-${fingerprint}"
+                    class="code-preview ${modifier}"
+                    ${testIdAttr}
+                >
                     ${example.comments.join("\n")}
                     <pre class="code-preview__markup">${highlightedCode}</pre>
                 </div>
@@ -19057,7 +19069,11 @@ function codePreview(options) {
       return (
         /* HTML */
         `
-                <div class="code-preview ${modifier}" ${testIdAttr}>
+                <div
+                    id="example-${fingerprint}"
+                    class="code-preview ${modifier}"
+                    ${testIdAttr}
+                >
                     ${example.comments.join("\n")}
                     <div class="code-preview__preview">${example.markup}</div>
                 </div>
@@ -19090,7 +19106,11 @@ function codePreview(options) {
     return (
       /* HTML */
       `
-            <div class="code-preview ${modifier}" ${testIdAttr}>
+            <div
+                id="example-${fingerprint}"
+                class="code-preview ${modifier}"
+                ${testIdAttr}
+            >
                 ${example.comments.join("\n")}
                 <div class="code-preview__preview">${example.markup}</div>
                 <div>${toggleMarkup} ${toggleFullscreen}</div>
@@ -19143,9 +19163,9 @@ function headingLevel(options) {
 
 // src/render/markdown/image-resources.ts
 var import_posix3 = __toESM(require("node:path/posix"));
-var import_node_crypto = __toESM(require("node:crypto"));
+var import_node_crypto2 = __toESM(require("node:crypto"));
 function computeHash(source) {
-  return import_node_crypto.default.createHash("md5").update(source).digest("hex");
+  return import_node_crypto2.default.createHash("md5").update(source).digest("hex");
 }
 function getFilename(fileInfo, src) {
   const key = [fileInfo.fullPath, src].join("-");

package/dist/style/core.css

@@ -5,10 +5,13 @@ h3,
 h4,
 h5,
 h6 {
-  font-weight: var(--docs-font-weight);
-  line-height: var(--f-line-height-medium);
+  font-family: var(--docs-heading-font-family);
+  font-weight: var(--docs-heading-font-weight);
+  line-height: var(--docs-heading-line-height);
   margin-top: 0;
   margin-bottom: 0.25rem;
+  text-wrap: balance;
+  text-wrap: pretty;
 }
 
 h1 {

package/dist/style/index.css

@@ -5,10 +5,13 @@ h3,
 h4,
 h5,
 h6 {
-  font-weight: var(--docs-font-weight);
-  line-height: var(--f-line-height-medium);
+  font-family: var(--docs-heading-font-family);
+  font-weight: var(--docs-heading-font-weight);
+  line-height: var(--docs-heading-line-height);
   margin-top: 0;
   margin-bottom: 0.25rem;
+  text-wrap: balance;
+  text-wrap: pretty;
 }
 
 h1 {
@@ -836,6 +839,15 @@ kbd {
   background-color: #f4f4f4;
 }
 
+:root {
+  --docs-font-family: arial, "Helvetica Neue", sans-serif;
+  --docs-font-weight: normal;
+  --docs-heading-font-family: arial, "Helvetica Neue", sans-serif;
+  --docs-heading-font-weight: normal;
+  --docs-heading-line-height: 1.4;
+  --docs-menu-width-expanded: 230px;
+}
+
 *,
 *::before,
 *::after {
@@ -897,9 +909,6 @@ textarea {
 }
 
 html {
-  --docs-font-family: arial, "Helvetica Neue", sans-serif;
-  --docs-font-weight: normal;
-  --docs-menu-width-expanded: 230px;
   scroll-behavior: smooth;
 }
 

package/dist/style/site.css

@@ -1,3 +1,12 @@
+:root {
+  --docs-font-family: arial, "Helvetica Neue", sans-serif;
+  --docs-font-weight: normal;
+  --docs-heading-font-family: arial, "Helvetica Neue", sans-serif;
+  --docs-heading-font-weight: normal;
+  --docs-heading-line-height: 1.4;
+  --docs-menu-width-expanded: 230px;
+}
+
 *,
 *::before,
 *::after {
@@ -59,9 +68,6 @@ textarea {
 }
 
 html {
-  --docs-font-family: arial, "Helvetica Neue", sans-serif;
-  --docs-font-weight: normal;
-  --docs-menu-width-expanded: 230px;
   scroll-behavior: smooth;
 }
 

package/package.json

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