zombie-mermaid 5.2.0 → 5.3.0

package/README.md

@@ -28,12 +28,25 @@ Ultra-fast, fully themeable, zero DOM dependencies. A maintained fork of [`beaut
 
 ## Why This Fork Exists
 
-`beautiful-mermaid` is a genuinely good library — fast, beautiful, and works everywhere from rich UIs to plain terminals. But upstream development has stalled: dozens of [pull requests](https://github.com/lukilabs/beautiful-mermaid/pulls) sit open, some for over half a year, and nothing has merged in months — by most definitions, it's dead. I maintain `zombie-mermaid` as the fork that won't stay buried: pulling in upstream fixes, giving PRs stuck in the upstream queue a home, and actually shipping releases. Craft and Craft Agents aren't part of this project's process going forward; this is an independently maintained continuation.
+`beautiful-mermaid` is a genuinely good library — fast, beautiful, and works everywhere from rich UIs to plain terminals. Checkable facts, as of 2026-10-13: the last push to upstream's `main` was 2026-05-06 and its latest release is v1.1.2 (2026-02-26); it has [43 open pull requests](https://github.com/lukilabs/beautiful-mermaid/pulls) (19 opened before 2026-04-13) and [50 open issues](https://github.com/lukilabs/beautiful-mermaid/issues) (live counts at those links; the figures above are a dated snapshot). I maintain `zombie-mermaid` as the fork that won't stay buried: pulling in upstream fixes, giving PRs stuck in the upstream queue a home, and actually shipping releases. Craft and Craft Agents aren't part of this project's process going forward; this is an independently maintained continuation.
 
-This isn't just a claim — see **[what this fork fixes](https://dfadler.github.io/zombie-mermaid/fork-fixes.html)** for an evidence-based before/after showcase: every bug listed there is rendered by the actual pre-fix and post-fix code, not described from memory.
+This isn't just a claim — see **[what this fork fixes](https://dfadler.github.io/zombie-mermaid/fork-fixes.html)** for an evidence-based before/after showcase (37 fixes as of 2026-10-13): every bug listed there is rendered by the actual pre-fix and post-fix code, not described from memory.
 
 It's still MIT-licensed, still built on the same foundation, and still credits the original authors — including the ASCII rendering engine's origins — in [Attribution](#attribution) below.
 
+### Migrating from `beautiful-mermaid`
+
+Swap the package (`npm uninstall beautiful-mermaid && npm install zombie-mermaid`, Node.js 24+) and change the import path; `renderMermaidSVG`, `renderMermaidSVGAsync`, `renderMermaidASCII` and `parseMermaid` keep the same signatures. In browsers and bundlers, also register `elkjs` once (Node, Bun, the CLI and MCP do it for you):
+
+```ts
+import ELK from 'elkjs/lib/elk.bundled.js'
+import { registerElk, renderMermaidSVG } from 'zombie-mermaid'
+
+registerElk(ELK) // once, before the first render
+```
+
+Some fixes change existing output, so diff your stored diagrams first: see the [migration guide](docs/migrating-from-beautiful-mermaid.md) and the [`elkjs` guide](docs/guides/elkjs-optional-peer.md).
+
 ## The Problem With Default Mermaid Rendering
 
 Diagrams are essential for AI-assisted programming. When you're working with an AI coding assistant, being able to visualize data flows, state machines, and system architecture—directly in your terminal or chat interface—makes complex concepts instantly graspable.

package/dist/cli.js

@@ -1,16 +1,16 @@
 #!/usr/bin/env node
 import { createRequire as V } from "node:module";
 import { extname as H, format as q, parse as D } from "node:path";
-import { THEMES as B, escapeXml as j, isDirection as K, isWideChar as J } from "@zombie-mermaid/core";
-import { access as Z, readFile as F, writeFile as Q } from "node:fs/promises";
-import { diagramColorsToAsciiTheme as ee, renderMermaidASCII as O } from "@zombie-mermaid/ascii-renderer";
+import { MermaidParseError as j, THEMES as B, escapeXml as K, isDirection as J, isWideChar as Z } from "@zombie-mermaid/core";
+import { access as Q, readFile as F, writeFile as ee } from "node:fs/promises";
+import { diagramColorsToAsciiTheme as te, renderMermaidASCII as O } from "@zombie-mermaid/ascii-renderer";
 import "@zombie-mermaid/mermaid-parser";
-import { registerElk as te, renderMermaidSVG as M, validateMermaid as ne } from "@zombie-mermaid/svg-renderer";
-import { createServer as re } from "node:http";
-import { StdioServerTransport as oe } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { createMcpServer as ie } from "@zombie-mermaid/mcp";
-import ae from "elkjs/lib/elk.bundled.js";
-var se = 3e3;
+import { registerElk as ne, renderMermaidSVG as M, validateMermaid as re } from "@zombie-mermaid/svg-renderer";
+import { createServer as oe } from "node:http";
+import { StdioServerTransport as ie } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createMcpServer as ae } from "@zombie-mermaid/mcp";
+import se from "elkjs/lib/elk.bundled.js";
+var de = 3e3;
 var G = {
   ".svg": "svg",
   ".txt": "ascii",
@@ -18,7 +18,7 @@ var G = {
   ".htm": "html",
   ".png": "png"
 };
-function de(e) {
+function ce(e) {
   if (!(e === void 0 || e === "-"))
     return G[H(e).toLowerCase()];
 }
@@ -45,7 +45,7 @@ var w = {
     label: "the PNG rasterization"
   }
 }, T = Object.keys(w);
-function ce(e, n) {
+function le(e, n) {
   const t = D(e);
   return q({
     dir: t.dir,
@@ -53,22 +53,22 @@ function ce(e, n) {
     ext: n
   });
 }
-function le(e) {
+function me(e) {
   const [n, ...t] = e;
   if (n === void 0) return { command: "help" };
   if (n === "--help" || n === "-h") return { command: "help" };
   if (n === "--version" || n === "-v") return { command: "version" };
   if (n === "themes") return { command: "themes" };
-  if (n === "render") return pe(t);
+  if (n === "render") return fe(t);
   if (n === "validate") {
-    const r = t.find((a, c) => c > 0 || a.startsWith("-"));
+    const r = t.find((a, d) => d > 0 || a.startsWith("-"));
     if (r !== void 0) throw new Error(`Unexpected argument: ${r}`);
     return {
       command: "validate",
       input: t[0]
     };
   }
-  if (n === "web") return fe(t);
+  if (n === "web") return he(t);
   if (n === "mcp") return { command: "mcp" };
   throw new Error(`Unknown command: ${n}`);
 }
@@ -78,7 +78,7 @@ function z(e, n, t) {
   if (!/^\d+$/.test(r)) throw new Error(`${t} requires a non-negative integer, got: "${r}"`);
   return Number(r);
 }
-function me(e, n, t) {
+function ue(e, n, t) {
   const r = e[n + 1];
   if (n + 1 >= e.length || r === void 0) throw new Error(`${t} requires a value ("auto" or a positive integer)`);
   if (r === "auto") return "auto";
@@ -86,15 +86,15 @@ function me(e, n, t) {
   if (!/^\d+$/.test(r) || a === 0 || !Number.isSafeInteger(a)) throw new Error(`${t} requires "auto" or a positive integer, got: "${r}"`);
   return a;
 }
-function ue(e, n, t) {
+function pe(e, n, t) {
   const r = e[n + 1];
   if (n + 1 >= e.length || r === void 0) throw new Error(`${t} requires a value (one of TD, TB, BT, LR, RL)`);
   const a = r.toUpperCase();
-  if (!K(a)) throw new Error(`${t} requires one of TD, TB, BT, LR, RL, got: "${r}"`);
+  if (!J(a)) throw new Error(`${t} requires one of TD, TB, BT, LR, RL, got: "${r}"`);
   return a;
 }
-function pe(e) {
-  let n, t = !1, r = !1, a = !1, c = !1, l = !1, m, g = !1, E, S, k, s, u = !1, p = !1, h, b, i = 0;
+function fe(e) {
+  let n, t = !1, r = !1, a = !1, d = !1, l = !1, m, g = !1, E, S, k, s, u = !1, p = !1, h, b, i = 0;
   for (; i < e.length; ) {
     const o = e[i];
     if (o === void 0) throw new Error(`parseArgs: index ${i} out of range while parsing arguments`);
@@ -105,7 +105,7 @@ function pe(e) {
     else if (o === "--resolve-colors")
       a = !0, i++;
     else if (o === "--html")
-      c = !0, i++;
+      d = !0, i++;
     else if (o === "--png")
       l = !0, i++;
     else if (o === "-o" || o === "--output") {
@@ -127,9 +127,9 @@ function pe(e) {
     else if (o === "--hyperlinks")
       p = !0, i++;
     else if (o === "-w" || o === "--max-width")
-      h = me(e, i, o), i += 2;
+      h = ue(e, i, o), i += 2;
     else if (o === "--direction")
-      b = ue(e, i, o), i += 2;
+      b = pe(e, i, o), i += 2;
     else if (!o.startsWith("-") || o === "-") {
       if (o === "-") throw new Error("Unexpected argument: - (use -o - to write output to stdout; omit the input file to read stdin)");
       if (n !== void 0) throw new Error(`Unexpected argument: ${o} (input file already set to "${n}")`);
@@ -138,30 +138,30 @@ function pe(e) {
   }
   const v = {
     svg: r,
-    html: c,
+    html: d,
     png: l
   }, y = T.filter((o) => v[o]);
   if (y.length > 1) {
-    const [o, d] = y;
-    throw new Error(`${w[o].flag} and ${w[d].flag} cannot both be set — they would write different content to the same output path. Run the command twice with different -o paths for each.`);
+    const [o, c] = y;
+    throw new Error(`${w[o].flag} and ${w[c].flag} cannot both be set — they would write different content to the same output path. Run the command twice with different -o paths for each.`);
   }
-  const f = de(m);
+  const f = ce(m);
   if (f !== void 0 && f !== "ascii") {
-    const o = T.find((d) => d !== f && v[d]);
+    const o = T.find((c) => c !== f && v[c]);
     if (o !== void 0) {
-      const d = w[f], $ = w[o];
-      throw new Error(`-o ${m} has ${d.article} ${d.ext} extension, but ${$.flag} output would be written to it. Use a ${$.ext} path (or -o - for stdout) for ${$.label}.`);
+      const c = w[f], $ = w[o];
+      throw new Error(`-o ${m} has ${c.article} ${c.ext} extension, but ${$.flag} output would be written to it. Use a ${$.ext} path (or -o - for stdout) for ${$.label}.`);
     }
-    f === "svg" ? r = !0 : f === "html" ? c = !0 : l = !0;
+    f === "svg" ? r = !0 : f === "html" ? d = !0 : l = !0;
   } else if (f === "ascii") {
-    const o = T.find((d) => v[d]);
+    const o = T.find((c) => v[c]);
     if (o !== void 0) {
-      const d = w[o];
-      throw new Error(`-o ${m} has a .txt extension, but ${d.flag} output would be written to it. Use a ${d.ext} path (or -o - for stdout) instead.`);
+      const c = w[o];
+      throw new Error(`-o ${m} has a .txt extension, but ${c.flag} output would be written to it. Use a ${c.ext} path (or -o - for stdout) instead.`);
     }
     t = !0;
   }
-  if (!t && !r && !c && !l) {
+  if (!t && !r && !d && !l) {
     if (m !== void 0 && m !== "-") {
       const o = Object.keys(G).join(", ");
       throw new Error(`Cannot infer an output format from "${m}" — pass --ascii, --svg, --html, or --png, or use a recognised extension (${o})`);
@@ -170,7 +170,7 @@ function pe(e) {
   }
   const C = {
     svg: r,
-    html: c,
+    html: d,
     png: l
   }, x = T.find((o) => C[o]);
   if (m === "-" && t && x !== void 0) {
@@ -178,9 +178,9 @@ function pe(e) {
     throw new Error(`-o - would send both ASCII and ${o} to stdout; drop --ascii, or write the ${o} to a file path`);
   }
   if (x !== void 0 && m === void 0) {
-    const { flag: o, ext: d } = w[x];
+    const { flag: o, ext: c } = w[x];
     if (n === void 0) throw new Error(`${o} needs -o <path> (or -o - for stdout) when reading from stdin — there is no input file name to derive an output name from`);
-    m = ce(n, d);
+    m = le(n, c);
   }
   if (h !== void 0 && !t) throw new Error("-w/--max-width requires --ascii");
   if (p && !t) throw new Error("--hyperlinks requires --ascii");
@@ -191,7 +191,7 @@ function pe(e) {
     ascii: t,
     svg: r,
     resolveColors: a,
-    html: c,
+    html: d,
     png: l,
     output: m,
     force: g,
@@ -205,8 +205,8 @@ function pe(e) {
     direction: b
   };
 }
-function fe(e) {
-  let n = se, t = 0;
+function he(e) {
+  let n = de, t = 0;
   for (; t < e.length; ) {
     const r = e[t];
     if (r === void 0) throw new Error(`parseArgs: index ${t} out of range while parsing arguments`);
@@ -219,52 +219,51 @@ function fe(e) {
     port: n
   };
 }
-var he = /\p{Mn}|\p{Me}/u;
-function ge(e) {
-  return he.test(e);
+var ge = /\p{Mn}|\p{Me}/u;
+function ve(e) {
+  return ge.test(e);
 }
-var ve = new Intl.Segmenter(void 0, { granularity: "grapheme" }), we = "️";
-function be(e) {
+var we = new Intl.Segmenter(void 0, { granularity: "grapheme" }), be = "️";
+function ye(e) {
   if (/^[\x20-\x7e]*$/.test(e)) return e.split("");
   const n = [];
-  for (const { segment: t } of ve.segment(e)) n.push(t);
+  for (const { segment: t } of we.segment(e)) n.push(t);
   return n;
 }
-function ye(e) {
-  if (e.includes(we)) return 2;
+function xe(e) {
+  if (e.includes(be)) return 2;
   let n = !1, t = !1;
   for (const r of e)
-    J(r) && (n = !0), ge(r) || (t = !0);
+    Z(r) && (n = !0), ve(r) || (t = !0);
   return n ? 2 : t ? 1 : 0;
 }
-function xe(e) {
+function Ee(e) {
   let n = 0;
-  for (const t of be(e)) n += ye(t);
+  for (const t of ye(e)) n += xe(t);
   return n;
 }
-var Ee = /\x1b\]8;[^\x07\x1b]*(?:\x1b\\|\x07)/g;
-function Se(e) {
-  return e.replace(Ee, "");
+var Se = /\x1b\]8;[^\x07\x1b]*(?:\x1b\\|\x07)/g;
+function ke(e) {
+  return e.replace(Se, "");
 }
-var ke = /^Line (\d+): ([\s\S]*)$/;
-function Ce(e, n) {
-  const t = ke.exec(e);
-  if (t === null) return;
-  const r = Number(t[1]), a = n.split(/\r?\n/)[r - 1];
-  if (!(!Number.isSafeInteger(r) || r < 1 || a === void 0))
+var Ce = /^Line (\d+): ([\s\S]*)$/;
+function Te(e, n) {
+  if (!(e instanceof j) || e.line === void 0) return;
+  const { line: t, message: r } = e, a = Ce.exec(r), d = n.split(/\r?\n/)[t - 1];
+  if (!(t < 1 || d === void 0))
     return {
-      line: r,
-      sourceLine: a,
-      message: t[2] ?? ""
+      line: t,
+      sourceLine: d,
+      message: a?.[2] ?? r
     };
 }
 function W(e, n) {
   if (!(e instanceof Error)) return e;
-  const t = Ce(e.message, n);
+  const t = Te(e, n);
   return t === void 0 ? e : /* @__PURE__ */ new Error(`${e.message}
   ${t.line} | ${t.sourceLine}`);
 }
-var Te = `// @ts-check
+var Ae = `// @ts-check
 /// <reference lib="dom" />
 // ============================================================================
 // Client script for the CLI's self-contained HTML viewer (\`render --html\`).
@@ -556,7 +555,7 @@ var Te = `// @ts-check
   fit()
   stage.focus({ preventScroll: true })
 })()
-`, Ae = `
+`, Ie = `
   :root {
     color-scheme: light dark;
     --bg: #f4f4f5;
@@ -663,16 +662,16 @@ var Te = `// @ts-check
     #diagram { position: static; transform: none !important; }
   }
 `.trim();
-function Ie(e) {
+function Me(e) {
   const n = e.title?.trim() || "Mermaid diagram";
   return `<!doctype html>
 <html lang="en">
 <head>
 <meta charset="utf-8" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
-<title>${j(n)}</title>
+<title>${K(n)}</title>
 <style>
-${Ae}
+${Ie}
 </style>
 </head>
 <body>
@@ -690,13 +689,13 @@ ${e.svg}
   <button id="theme" type="button" aria-pressed="false" aria-label="Switch to dark mode (T)">Dark</button>
 </div>
 <script>
-${Te}
+${Ae}
 <\/script>
 </body>
 </html>
 `;
 }
-async function Me(e) {
+async function ze(e) {
   let n;
   try {
     n = await import("@resvg/resvg-js");
@@ -707,16 +706,16 @@ ${r}`);
   }
   return (await n.renderAsync(e)).asPng();
 }
-var ze = 80, P = 1, L = 1, R = 0, $e = /\x1b\[[0-9;]*m/g;
+var $e = 80, P = 1, L = 1, R = 0, Pe = /\x1b\[[0-9;]*m/g;
 function _(e) {
   return e.split(`
-`).reduce((n, t) => Math.max(n, xe(Se(t.replace($e, "")))), 0);
+`).reduce((n, t) => Math.max(n, Ee(ke(t.replace(Pe, "")))), 0);
 }
-function Pe(e) {
-  return e !== "auto" ? e : process.stdout.columns ?? ze;
+function Le(e) {
+  return e !== "auto" ? e : process.stdout.columns ?? $e;
 }
-async function Le(e, n, t, r) {
-  const a = n ?? process.stdout, c = r ?? process.stderr;
+async function Re(e, n, t, r) {
+  const a = n ?? process.stdout, d = r ?? process.stderr;
   let l;
   if (e.input !== void 0) l = await F(e.input, "utf-8");
   else if (t !== void 0) l = t;
@@ -726,33 +725,33 @@ async function Le(e, n, t, r) {
   }
   if (l.trim().length === 0) throw new Error("Empty input — provide a Mermaid diagram via file or stdin");
   try {
-    await Re(e, l, a, c);
+    await Be(e, l, a, d);
   } catch (m) {
     throw W(m, l);
   }
 }
-async function Re(e, n, t, r) {
+async function Be(e, n, t, r) {
   let a;
   if (e.theme !== void 0 && (a = B[e.theme], a === void 0)) {
     const s = Object.keys(B).join(", ");
     throw new Error(`Unknown theme: "${e.theme}". Available themes: ${s}`);
   }
-  const c = e.svg && e.output === "-", l = e.html && e.output === "-", m = e.png && e.output === "-", g = e.ascii && !e.svg && !e.html && !e.png && e.output !== void 0 && e.output !== "-" ? e.output : void 0, E = e.svg && !c ? e.output : void 0, S = e.html && !l ? e.output : void 0, k = e.png && !m ? e.output : void 0;
+  const d = e.svg && e.output === "-", l = e.html && e.output === "-", m = e.png && e.output === "-", g = e.ascii && !e.svg && !e.html && !e.png && e.output !== void 0 && e.output !== "-" ? e.output : void 0, E = e.svg && !d ? e.output : void 0, S = e.html && !l ? e.output : void 0, k = e.png && !m ? e.output : void 0;
   for (const s of [
     g,
     E,
     S,
     k
-  ]) s !== void 0 && await Be(s, e.force);
+  ]) s !== void 0 && await Oe(s, e.force);
   if (e.ascii) {
     const s = a && g === void 0 ? {
       colorMode: "auto",
-      theme: ee(a)
+      theme: te(a)
     } : { colorMode: "none" };
     e.paddingX !== void 0 && (s.paddingX = e.paddingX), e.paddingY !== void 0 && (s.paddingY = e.paddingY), e.borderPadding !== void 0 && (s.boxBorderPadding = e.borderPadding), e.coords && (s.showCoords = !0), e.direction !== void 0 && (s.direction = e.direction), e.hyperlinks && g === void 0 && (s.hyperlinks = !0);
     let u = O(n, s);
     if (e.maxWidth !== void 0) {
-      const p = Pe(e.maxWidth);
+      const p = Le(e.maxWidth);
       let h = _(u), b = !1;
       if (h > p) {
         const i = s.paddingX ?? 5, v = s.paddingY ?? 5, y = s.boxBorderPadding ?? 1, f = Math.min(i, P), C = Math.min(v, L), x = Math.min(y, R);
@@ -762,8 +761,8 @@ async function Re(e, n, t, r) {
             paddingX: f,
             paddingY: C,
             boxBorderPadding: x
-          }), d = _(o);
-          d < h && (u = o, h = d, b = !0);
+          }), c = _(o);
+          c < h && (u = o, h = c, b = !0);
         }
       }
       if (h > p) {
@@ -783,10 +782,10 @@ async function Re(e, n, t, r) {
     };
     e.direction !== void 0 && (s.direction = e.direction);
     const u = M(n, s);
-    await I(A(c, E), u, t, e.force);
+    await I(A(d, E), u, t, e.force);
   }
   if (e.html) {
-    const s = M(n, a ?? {}), u = e.input ? D(e.input).name : void 0, p = Ie({
+    const s = M(n, a ?? {}), u = e.input ? D(e.input).name : void 0, p = Me({
       svg: s,
       title: u
     });
@@ -798,7 +797,7 @@ async function Re(e, n, t, r) {
       resolveColors: !0
     };
     e.direction !== void 0 && (s.direction = e.direction);
-    const u = M(n, s), p = await Me(u);
+    const u = M(n, s), p = await ze(u);
     await I(A(m, k), p, t, e.force);
   }
 }
@@ -814,25 +813,25 @@ async function I(e, n, t, r) {
       t.write(n);
       break;
     case "file":
-      await Oe(e.path, n, r);
+      await _e(e.path, n, r);
   }
 }
 function X(e) {
   return /* @__PURE__ */ new Error(`Refusing to overwrite existing file "${e}" — pass --force to replace it`);
 }
-async function Be(e, n) {
+async function Oe(e, n) {
   if (n) return;
   let t = !0;
   try {
-    await Z(e);
+    await Q(e);
   } catch {
     t = !1;
   }
   if (t) throw X(e);
 }
-async function Oe(e, n, t) {
+async function _e(e, n, t) {
   try {
-    await Q(e, n, {
+    await ee(e, n, {
       encoding: "utf-8",
       flag: t ? "w" : "wx"
     });
@@ -846,7 +845,7 @@ async function Y() {
     n.on("data", (a) => e.push(a)), n.on("end", () => t(e.join(""))), n.on("error", r);
   });
 }
-async function _e(e, n) {
+async function Ne(e, n) {
   let t;
   if (e.input !== void 0) t = await F(e.input, "utf-8");
   else if (n !== void 0) t = n;
@@ -857,30 +856,30 @@ async function _e(e, n) {
   const r = t;
   if (r.trim().length === 0) throw new Error("Empty input — provide a Mermaid diagram via file or stdin");
   try {
-    ne(r);
+    re(r);
   } catch (a) {
     throw W(a, r);
   }
   console.log("valid");
 }
-var Ne = 1e6;
-function De(e) {
+var De = 1e6;
+function Fe(e) {
   return new Promise((n, t) => {
     const r = [];
     let a = 0;
-    e.on("data", (c) => {
-      if (a += c.length, a > Ne) {
+    e.on("data", (d) => {
+      if (a += d.length, a > De) {
         t(/* @__PURE__ */ new Error("Request body too large")), e.destroy();
         return;
       }
-      r.push(c);
+      r.push(d);
     }), e.on("end", () => n(Buffer.concat(r).toString("utf-8"))), e.on("error", t);
   });
 }
 function U(e) {
   return typeof e == "object" && e !== null;
 }
-function Fe(e) {
+function Ge(e) {
   let n;
   try {
     n = JSON.parse(e);
@@ -902,9 +901,9 @@ function N(e, n, t) {
     "Content-Length": Buffer.byteLength(r)
   }), e.end(r);
 }
-async function Ge(e, n) {
+async function We(e, n) {
   try {
-    const { source: t, format: r } = Fe(await De(e));
+    const { source: t, format: r } = Ge(await Fe(e));
     N(n, 200, {
       output: r === "svg" ? M(t) : O(t),
       format: r
@@ -913,7 +912,7 @@ async function Ge(e, n) {
     N(n, 400, { error: t instanceof Error ? t.message : String(t) });
   }
 }
-var We = `<!doctype html>
+var Xe = `<!doctype html>
 <html lang="en">
 <head>
 <meta charset="utf-8" />
@@ -979,56 +978,56 @@ var We = `<!doctype html>
 </body>
 </html>
 `;
-function Xe() {
-  return re((e, n) => {
+function Ye() {
+  return oe((e, n) => {
     const t = (e.url ?? "/").split("?")[0];
     if (e.method === "GET" && (t === "/" || t === "")) {
-      n.writeHead(200, { "Content-Type": "text/html; charset=utf-8" }), n.end(We);
+      n.writeHead(200, { "Content-Type": "text/html; charset=utf-8" }), n.end(Xe);
       return;
     }
     if (e.method === "POST" && t === "/render") {
-      Ge(e, n);
+      We(e, n);
       return;
     }
     n.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" }), n.end("Not found");
   });
 }
-function Ye(e) {
+function Ue(e) {
   return new Promise((n, t) => {
-    const r = Xe();
+    const r = Ye();
     r.once("error", t), r.listen(e, "127.0.0.1", () => {
       r.removeListener("error", t), n(r);
     });
   });
 }
-async function Ue(e, n = console.log) {
-  const t = await Ye(e.port), r = t.address();
+async function Ve(e, n = console.log) {
+  const t = await Ue(e.port), r = t.address();
   return n(`zombie-mermaid web running at http://localhost:${U(r) && typeof r.port == "number" ? r.port : e.port}`), t;
 }
-async function Ve(e = (n) => console.error(n)) {
-  const n = ie(), t = new oe();
+async function He(e = (n) => console.error(n)) {
+  const n = ae(), t = new ie();
   return await n.connect(t), e("zombie-mermaid MCP server running on stdio (experimental — feedback welcome: https://github.com/dfadler/zombie-mermaid/issues)"), n;
 }
-function He() {
+function qe() {
   const e = V(import.meta.url)("../package.json");
   return typeof e == "object" && e !== null && "version" in e && typeof e.version == "string" ? e.version : "unknown";
 }
-te(ae);
-var qe = He();
-async function je() {
+ne(se);
+var je = qe();
+async function Ke() {
   const e = process.argv.slice(2);
   let n;
   try {
-    n = le(e);
+    n = me(e);
   } catch (t) {
     console.error(`Error: ${t instanceof Error ? t.message : String(t)}`), process.exit(1);
   }
   switch (n.command) {
     case "help":
-      Ke();
+      Je();
       break;
     case "version":
-      console.log(`zombie-mermaid ${qe}`);
+      console.log(`zombie-mermaid ${je}`);
       break;
     case "themes":
       console.log(`Available themes:
@@ -1037,34 +1036,34 @@ async function je() {
       break;
     case "render":
       try {
-        await Le(n);
+        await Re(n);
       } catch (t) {
         console.error(`Error: ${t instanceof Error ? t.message : String(t)}`), process.exit(1);
       }
       break;
     case "validate":
       try {
-        await _e(n);
+        await Ne(n);
       } catch (t) {
         console.error(`Error: ${t instanceof Error ? t.message : String(t)}`), process.exit(1);
       }
       break;
     case "web":
       try {
-        await Ue(n);
+        await Ve(n);
       } catch (t) {
         console.error(`Error: ${t instanceof Error ? t.message : String(t)}`), process.exit(1);
       }
       break;
     case "mcp":
       try {
-        await Ve();
+        await He();
       } catch (t) {
         console.error(`Error: ${t instanceof Error ? t.message : String(t)}`), process.exit(1);
       }
   }
 }
-function Ke() {
+function Je() {
   console.log(`
 zombie-mermaid — render Mermaid diagrams from the command line
 
@@ -1139,7 +1138,7 @@ Options:
   -v, --version        Show version
 `.trim());
 }
-je();
+Ke();
 export {
-  je as main
+  Ke as main
 };

package/dist/index.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@zombie-mermaid/core"),t=require("@zombie-mermaid/mermaid-parser"),n=require("@zombie-mermaid/ascii-renderer"),r=require("@zombie-mermaid/svg-renderer");Object.defineProperty(exports,"DEFAULTS",{enumerable:!0,get:function(){return e.DEFAULTS}}),Object.defineProperty(exports,"ElkNotRegisteredError",{enumerable:!0,get:function(){return r.ElkNotRegisteredError}}),Object.defineProperty(exports,"THEMES",{enumerable:!0,get:function(){return e.THEMES}}),Object.defineProperty(exports,"createLayoutCache",{enumerable:!0,get:function(){return r.createLayoutCache}}),Object.defineProperty(exports,"fromShikiTheme",{enumerable:!0,get:function(){return e.fromShikiTheme}}),Object.defineProperty(exports,"parseMermaid",{enumerable:!0,get:function(){return t.parseMermaid}}),Object.defineProperty(exports,"registerElk",{enumerable:!0,get:function(){return r.registerElk}}),Object.defineProperty(exports,"renderMermaid",{enumerable:!0,get:function(){return r.renderMermaid}}),Object.defineProperty(exports,"renderMermaidASCII",{enumerable:!0,get:function(){return n.renderMermaidASCII}}),Object.defineProperty(exports,"renderMermaidAscii",{enumerable:!0,get:function(){return n.renderMermaidAscii}}),Object.defineProperty(exports,"renderMermaidSVG",{enumerable:!0,get:function(){return r.renderMermaidSVG}}),Object.defineProperty(exports,"renderMermaidSVGAsync",{enumerable:!0,get:function(){return r.renderMermaidSVGAsync}}),Object.defineProperty(exports,"renderMermaidSync",{enumerable:!0,get:function(){return r.renderMermaidSync}}),Object.defineProperty(exports,"themeCssVariables",{enumerable:!0,get:function(){return r.themeCssVariables}}),Object.defineProperty(exports,"validateMermaid",{enumerable:!0,get:function(){return r.validateMermaid}});
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("@zombie-mermaid/core"),t=require("@zombie-mermaid/mermaid-parser"),n=require("@zombie-mermaid/ascii-renderer"),r=require("@zombie-mermaid/svg-renderer");Object.defineProperty(exports,"DEFAULTS",{enumerable:!0,get:function(){return e.DEFAULTS}}),Object.defineProperty(exports,"DEFAULT_RENDER_LIMITS",{enumerable:!0,get:function(){return e.DEFAULT_RENDER_LIMITS}}),Object.defineProperty(exports,"ElkNotRegisteredError",{enumerable:!0,get:function(){return r.ElkNotRegisteredError}}),Object.defineProperty(exports,"LimitExceededError",{enumerable:!0,get:function(){return e.LimitExceededError}}),Object.defineProperty(exports,"THEMES",{enumerable:!0,get:function(){return e.THEMES}}),Object.defineProperty(exports,"createLayoutCache",{enumerable:!0,get:function(){return r.createLayoutCache}}),Object.defineProperty(exports,"fromShikiTheme",{enumerable:!0,get:function(){return e.fromShikiTheme}}),Object.defineProperty(exports,"parseMermaid",{enumerable:!0,get:function(){return t.parseMermaid}}),Object.defineProperty(exports,"registerElk",{enumerable:!0,get:function(){return r.registerElk}}),Object.defineProperty(exports,"renderMermaid",{enumerable:!0,get:function(){return r.renderMermaid}}),Object.defineProperty(exports,"renderMermaidASCII",{enumerable:!0,get:function(){return n.renderMermaidASCII}}),Object.defineProperty(exports,"renderMermaidAscii",{enumerable:!0,get:function(){return n.renderMermaidAscii}}),Object.defineProperty(exports,"renderMermaidSVG",{enumerable:!0,get:function(){return r.renderMermaidSVG}}),Object.defineProperty(exports,"renderMermaidSVGAsync",{enumerable:!0,get:function(){return r.renderMermaidSVGAsync}}),Object.defineProperty(exports,"renderMermaidSync",{enumerable:!0,get:function(){return r.renderMermaidSync}}),Object.defineProperty(exports,"themeCssVariables",{enumerable:!0,get:function(){return r.themeCssVariables}}),Object.defineProperty(exports,"validateMermaid",{enumerable:!0,get:function(){return r.validateMermaid}});

package/dist/index.d.cts

@@ -2,6 +2,7 @@ import { AsciiRenderOptions } from '@zombie-mermaid/ascii-renderer';
 import { ClassRenderOptions } from '@zombie-mermaid/core';
 import { CommonRenderOptions } from '@zombie-mermaid/core';
 import { createLayoutCache } from '@zombie-mermaid/svg-renderer';
+import { DEFAULT_RENDER_LIMITS } from '@zombie-mermaid/core';
 import { DEFAULTS } from '@zombie-mermaid/core';
 import { DiagramColors } from '@zombie-mermaid/core';
 import { Direction } from '@zombie-mermaid/core';
@@ -11,11 +12,13 @@ import { ErRenderOptions } from '@zombie-mermaid/core';
 import { FlowchartRenderOptions } from '@zombie-mermaid/core';
 import { fromShikiTheme } from '@zombie-mermaid/core';
 import { LayoutCache } from '@zombie-mermaid/svg-renderer';
+import { LimitExceededError } from '@zombie-mermaid/core';
 import { MermaidGraph } from '@zombie-mermaid/core';
 import { NodeInteraction } from '@zombie-mermaid/core';
 import { parseMermaid } from '@zombie-mermaid/mermaid-parser';
 import { PositionedGraph } from '@zombie-mermaid/core';
 import { registerElk } from '@zombie-mermaid/svg-renderer';
+import { RenderLimits } from '@zombie-mermaid/core';
 import { renderMermaid } from '@zombie-mermaid/svg-renderer';
 import { renderMermaidASCII } from '@zombie-mermaid/ascii-renderer';
 import { renderMermaidAscii } from '@zombie-mermaid/ascii-renderer';
@@ -38,6 +41,8 @@ export { CommonRenderOptions }
 
 export { createLayoutCache }
 
+export { DEFAULT_RENDER_LIMITS }
+
 export { DEFAULTS }
 
 export { DiagramColors }
@@ -56,6 +61,8 @@ export { fromShikiTheme }
 
 export { LayoutCache }
 
+export { LimitExceededError }
+
 export { MermaidGraph }
 
 export { NodeInteraction }
@@ -66,6 +73,8 @@ export { PositionedGraph }
 
 export { registerElk }
 
+export { RenderLimits }
+
 export { renderMermaid }
 
 export { renderMermaidASCII }

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import { AsciiRenderOptions } from '@zombie-mermaid/ascii-renderer';
 import { ClassRenderOptions } from '@zombie-mermaid/core';
 import { CommonRenderOptions } from '@zombie-mermaid/core';
 import { createLayoutCache } from '@zombie-mermaid/svg-renderer';
+import { DEFAULT_RENDER_LIMITS } from '@zombie-mermaid/core';
 import { DEFAULTS } from '@zombie-mermaid/core';
 import { DiagramColors } from '@zombie-mermaid/core';
 import { Direction } from '@zombie-mermaid/core';
@@ -11,11 +12,13 @@ import { ErRenderOptions } from '@zombie-mermaid/core';
 import { FlowchartRenderOptions } from '@zombie-mermaid/core';
 import { fromShikiTheme } from '@zombie-mermaid/core';
 import { LayoutCache } from '@zombie-mermaid/svg-renderer';
+import { LimitExceededError } from '@zombie-mermaid/core';
 import { MermaidGraph } from '@zombie-mermaid/core';
 import { NodeInteraction } from '@zombie-mermaid/core';
 import { parseMermaid } from '@zombie-mermaid/mermaid-parser';
 import { PositionedGraph } from '@zombie-mermaid/core';
 import { registerElk } from '@zombie-mermaid/svg-renderer';
+import { RenderLimits } from '@zombie-mermaid/core';
 import { renderMermaid } from '@zombie-mermaid/svg-renderer';
 import { renderMermaidASCII } from '@zombie-mermaid/ascii-renderer';
 import { renderMermaidAscii } from '@zombie-mermaid/ascii-renderer';
@@ -38,6 +41,8 @@ export { CommonRenderOptions }
 
 export { createLayoutCache }
 
+export { DEFAULT_RENDER_LIMITS }
+
 export { DEFAULTS }
 
 export { DiagramColors }
@@ -56,6 +61,8 @@ export { fromShikiTheme }
 
 export { LayoutCache }
 
+export { LimitExceededError }
+
 export { MermaidGraph }
 
 export { NodeInteraction }
@@ -66,6 +73,8 @@ export { PositionedGraph }
 
 export { registerElk }
 
+export { RenderLimits }
+
 export { renderMermaid }
 
 export { renderMermaidASCII }

package/dist/index.js

@@ -1,5 +1,5 @@
-import { DEFAULTS as e, THEMES as t, fromShikiTheme as n } from "@zombie-mermaid/core";
-import { parseMermaid as r } from "@zombie-mermaid/mermaid-parser";
-import { renderMermaidASCII as i, renderMermaidAscii as a } from "@zombie-mermaid/ascii-renderer";
-import { ElkNotRegisteredError as o, createLayoutCache as s, registerElk as c, renderMermaid as l, renderMermaidSVG as u, renderMermaidSVGAsync as d, renderMermaidSync as f, themeCssVariables as p, validateMermaid as m } from "@zombie-mermaid/svg-renderer";
-export { e as DEFAULTS, o as ElkNotRegisteredError, t as THEMES, s as createLayoutCache, n as fromShikiTheme, r as parseMermaid, c as registerElk, l as renderMermaid, i as renderMermaidASCII, a as renderMermaidAscii, u as renderMermaidSVG, d as renderMermaidSVGAsync, f as renderMermaidSync, p as themeCssVariables, m as validateMermaid };
+import { DEFAULTS as e, DEFAULT_RENDER_LIMITS as t, LimitExceededError as n, THEMES as r, fromShikiTheme as i } from "@zombie-mermaid/core";
+import { parseMermaid as a } from "@zombie-mermaid/mermaid-parser";
+import { renderMermaidASCII as o, renderMermaidAscii as s } from "@zombie-mermaid/ascii-renderer";
+import { ElkNotRegisteredError as c, createLayoutCache as l, registerElk as u, renderMermaid as d, renderMermaidSVG as f, renderMermaidSVGAsync as p, renderMermaidSync as m, themeCssVariables as h, validateMermaid as g } from "@zombie-mermaid/svg-renderer";
+export { e as DEFAULTS, t as DEFAULT_RENDER_LIMITS, c as ElkNotRegisteredError, n as LimitExceededError, r as THEMES, l as createLayoutCache, i as fromShikiTheme, a as parseMermaid, u as registerElk, d as renderMermaid, o as renderMermaidASCII, s as renderMermaidAscii, f as renderMermaidSVG, p as renderMermaidSVGAsync, m as renderMermaidSync, h as themeCssVariables, g as validateMermaid };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zombie-mermaid",
-  "version": "5.2.0",
+  "version": "5.3.0",
   "license": "MIT",
   "description": "Render Mermaid diagrams as beautiful SVGs or ASCII art. Ultra-fast, fully themeable, zero DOM dependencies. Maintained fork of beautiful-mermaid.",
   "type": "module",
@@ -90,14 +90,16 @@
     "@modelcontextprotocol/sdk": "^1.30.0",
     "elkjs": "^0.11.0",
     "entities": "^7.0.1",
-    "@zombie-mermaid/ascii-renderer": "5.2.0",
-    "@zombie-mermaid/core": "5.2.0",
-    "@zombie-mermaid/mcp": "5.2.0",
-    "@zombie-mermaid/svg-renderer": "5.2.0",
-    "@zombie-mermaid/mermaid-parser": "5.2.0"
+    "@zombie-mermaid/ascii-renderer": "5.3.0",
+    "@zombie-mermaid/mermaid-parser": "5.3.0",
+    "@zombie-mermaid/mcp": "5.3.0",
+    "@zombie-mermaid/core": "5.3.0",
+    "@zombie-mermaid/svg-renderer": "5.3.0"
   },
   "devDependencies": {
+    "@arethetypeswrong/cli": "0.18.5",
     "@axe-core/playwright": "^4.13.0",
+    "@fast-check/vitest": "0.5.0",
     "@changesets/changelog-github": "^1.0.0",
     "@changesets/cli": "^3.0.1",
     "@microsoft/api-extractor": "^7.59.0",
@@ -114,12 +116,14 @@
     "esbuild": "^0.28.2",
     "eslint": "^10.9.1",
     "eslint-config-prettier": "^10.1.8",
+    "fast-check": "4.10.2",
     "fontkit": "^2.0.4",
     "jsdom": "^30.0.1",
     "lightningcss": "^1.33.0",
     "marked": "^18.0.11",
     "mermaid": "12.1.0",
     "prettier": "^3.9.6",
+    "publint": "0.3.25",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
     "shiki": "^3.19.0",
@@ -137,6 +141,7 @@
   },
   "scripts": {
     "test": "vitest run -c config/vitest.config.ts",
+    "test:shuffle": "vitest run -c config/vitest.config.ts --sequence.shuffle.files --sequence.shuffle.tests",
     "test:watch": "vitest -c config/vitest.config.ts",
     "test:coverage": "vitest run -c config/vitest.config.ts --coverage",
     "test:visual": "playwright test",
@@ -166,6 +171,7 @@
     "check:changesets": "tsx scripts/check-changesets.ts",
     "check:docs": "tsx scripts/check-docs.ts",
     "smoke:packed": "node scripts/smoke-test-packed.mjs",
+    "check:package-types": "scripts/check-package-types.sh",
     "check:bundle-size": "tsx scripts/check-bundle-size.ts",
     "generate:hero": "tsx scripts/generate-hero.ts",
     "build:mono-font": "tsx scripts/build-mono-font-subset.ts && prettier --write demo/components/generated/mono-font-subset.ts demo/styles.css packages/svg-renderer/src/generated/mono-font-subset.ts",