zombie-mermaid 5.2.0 → 5.4.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 (38 fixes): 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.
@@ -210,6 +223,7 @@ zombie-mermaid --help                                   # Show all options
 `--hyperlinks` (with `--ascii`) turns `click` hrefs into OSC 8 terminal
 hyperlinks — off by default, since terminal and pager support varies (see
 [ASCII terminal hyperlinks](docs/diagrams.md#ascii-terminal-hyperlinks)).
+`--profile markdown` (with `--ascii`) emits plain ASCII characters with no color, for pasting into issues, commits and fenced blocks (the `profile` option in the library and the MCP `render_mermaid_ascii` tool).
 
 **Output rules.** `-o` is the destination for the run's _file_ output — SVG, HTML, or PNG when `--svg`/`--html`/`--png` is given, otherwise the ASCII rendering — and `-o -` sends it to stdout instead. A recognised extension (`.svg`, `.html`/`.htm`, `.txt`, `.png`) picks the format on its own, so the flag can be dropped; an extension that contradicts an explicit flag (`--svg -o out.txt`) is an error, while unrecognised ones are simply used as given. `--svg`/`--html`/`--png` with no `-o` writes `<input stem>.svg`/`.html`/`.png` beside the input (stdin input has no name to derive from, so it must pass `-o`). Only one of `--svg`/`--html`/`--png` can be set at a time — run the command twice for more than one. ASCII always prints to the terminal when one of them is also requested (`--ascii --svg -o out.svg`), and never carries ANSI colour codes when written to a file. **An existing output file is never overwritten unless you pass `--force`/`-f`.**
 

package/dist/cli.js

@@ -1,28 +1,28 @@
 #!/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 { createRequire as q } from "node:module";
+import { extname as H, format as j, parse as F } from "node:path";
+import { MermaidParseError as K, THEMES as O, escapeXml as J, isDirection as Z, isWideChar as Q } from "@zombie-mermaid/core";
+import { access as ee, readFile as G, writeFile as te } from "node:fs/promises";
+import { diagramColorsToAsciiTheme as ne, renderMermaidASCII as _ } 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;
-var G = {
+import { registerElk as re, renderMermaidSVG as z, validateMermaid as oe } from "@zombie-mermaid/svg-renderer";
+import { createServer as ie } from "node:http";
+import { StdioServerTransport as ae } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createMcpServer as se } from "@zombie-mermaid/mcp";
+import de from "elkjs/lib/elk.bundled.js";
+var ce = 3e3;
+var W = {
   ".svg": "svg",
   ".txt": "ascii",
   ".html": "html",
   ".htm": "html",
   ".png": "png"
 };
-function de(e) {
+function le(e) {
   if (!(e === void 0 || e === "-"))
-    return G[H(e).toLowerCase()];
+    return W[H(e).toLowerCase()];
 }
-var w = {
+var b = {
   svg: {
     flag: "--svg",
     ext: ".svg",
@@ -44,41 +44,41 @@ var w = {
     display: "PNG",
     label: "the PNG rasterization"
   }
-}, T = Object.keys(w);
-function ce(e, n) {
-  const t = D(e);
-  return q({
+}, I = Object.keys(b);
+function me(e, n) {
+  const t = F(e);
+  return j({
     dir: t.dir,
     name: t.name,
     ext: n
   });
 }
-function le(e) {
+function ue(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 he(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 ge(t);
   if (n === "mcp") return { command: "mcp" };
   throw new Error(`Unknown command: ${n}`);
 }
-function z(e, n, t) {
+function $(e, n, t) {
   const r = e[n + 1];
   if (n + 1 >= e.length || r === void 0) throw new Error(`${t} requires a numeric value`);
   if (!/^\d+$/.test(r)) throw new Error(`${t} requires a non-negative integer, got: "${r}"`);
   return Number(r);
 }
-function me(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 ("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 fe(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 (!Z(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 he(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, v, y, 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") {
@@ -117,72 +117,77 @@ function pe(e) {
       if (i + 1 >= e.length) throw new Error("--theme requires a theme name");
       E = e[i + 1], i += 2;
     } else if (o === "-x" || o === "--paddingX")
-      S = z(e, i, o), i += 2;
+      S = $(e, i, o), i += 2;
     else if (o === "-y" || o === "--paddingY")
-      k = z(e, i, o), i += 2;
+      k = $(e, i, o), i += 2;
     else if (o === "-p" || o === "--borderPadding")
-      s = z(e, i, o), i += 2;
+      s = $(e, i, o), i += 2;
     else if (o === "--coords")
       u = !0, i++;
     else if (o === "--hyperlinks")
       p = !0, i++;
     else if (o === "-w" || o === "--max-width")
-      h = me(e, i, o), i += 2;
-    else if (o === "--direction")
-      b = ue(e, i, o), i += 2;
+      h = pe(e, i, o), i += 2;
+    else if (o === "--profile") {
+      const c = e[i + 1];
+      if (c !== "markdown") throw new Error(`--profile requires one of: markdown, got: "${c ?? ""}"`);
+      v = c, i += 2;
+    } else if (o === "--direction")
+      y = fe(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}")`);
       n = o, i++;
     } else throw new Error(`Unknown flag: ${o}`);
   }
-  const v = {
+  const w = {
     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.`);
+  }, C = I.filter((o) => w[o]);
+  if (C.length > 1) {
+    const [o, c] = C;
+    throw new Error(`${b[o].flag} and ${b[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 = le(m);
   if (f !== void 0 && f !== "ascii") {
-    const o = T.find((d) => d !== f && v[d]);
+    const o = I.find((c) => c !== f && w[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 = b[f], P = b[o];
+      throw new Error(`-o ${m} has ${c.article} ${c.ext} extension, but ${P.flag} output would be written to it. Use a ${P.ext} path (or -o - for stdout) for ${P.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 = I.find((c) => w[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 = b[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(", ");
+      const o = Object.keys(W).join(", ");
       throw new Error(`Cannot infer an output format from "${m}" — pass --ascii, --svg, --html, or --png, or use a recognised extension (${o})`);
     }
     throw new Error("Specify --ascii, --svg, --html, and/or --png (or -o <path> with a .svg/.txt/.html/.png extension)");
   }
-  const C = {
+  const T = {
     svg: r,
-    html: c,
+    html: d,
     png: l
-  }, x = T.find((o) => C[o]);
+  }, x = I.find((o) => T[o]);
   if (m === "-" && t && x !== void 0) {
-    const o = w[x].display;
+    const o = b[x].display;
     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 } = b[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 = me(n, c);
   }
   if (h !== void 0 && !t) throw new Error("-w/--max-width requires --ascii");
+  if (v !== void 0 && !t) throw new Error("--profile requires --ascii");
   if (p && !t) throw new Error("--hyperlinks requires --ascii");
   if (a && !r) throw new Error("--resolve-colors requires --svg");
   return {
@@ -191,7 +196,7 @@ function pe(e) {
     ascii: t,
     svg: r,
     resolveColors: a,
-    html: c,
+    html: d,
     png: l,
     output: m,
     force: g,
@@ -202,16 +207,17 @@ function pe(e) {
     coords: u,
     hyperlinks: p,
     maxWidth: h,
-    direction: b
+    profile: v,
+    direction: y
   };
 }
-function fe(e) {
-  let n = se, t = 0;
+function ge(e) {
+  let n = ce, 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`);
     if (r === "--port")
-      n = z(e, t, r), t += 2;
+      n = $(e, t, r), t += 2;
     else throw new Error(`Unknown flag: ${r}`);
   }
   return {
@@ -219,52 +225,51 @@ function fe(e) {
     port: n
   };
 }
-var he = /\p{Mn}|\p{Me}/u;
-function ge(e) {
-  return he.test(e);
+var ve = /\p{Mn}|\p{Me}/u;
+function we(e) {
+  return ve.test(e);
 }
-var ve = new Intl.Segmenter(void 0, { granularity: "grapheme" }), we = "️";
-function be(e) {
+var be = new Intl.Segmenter(void 0, { granularity: "grapheme" }), ye = "️";
+function xe(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 be.segment(e)) n.push(t);
   return n;
 }
-function ye(e) {
-  if (e.includes(we)) return 2;
+function Ee(e) {
+  if (e.includes(ye)) return 2;
   let n = !1, t = !1;
   for (const r of e)
-    J(r) && (n = !0), ge(r) || (t = !0);
+    Q(r) && (n = !0), we(r) || (t = !0);
   return n ? 2 : t ? 1 : 0;
 }
-function xe(e) {
+function Se(e) {
   let n = 0;
-  for (const t of be(e)) n += ye(t);
+  for (const t of xe(e)) n += Ee(t);
   return n;
 }
-var Ee = /\x1b\]8;[^\x07\x1b]*(?:\x1b\\|\x07)/g;
-function Se(e) {
-  return e.replace(Ee, "");
+var ke = /\x1b\]8;[^\x07\x1b]*(?:\x1b\\|\x07)/g;
+function Ce(e) {
+  return e.replace(ke, "");
 }
-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 Te = /^Line (\d+): ([\s\S]*)$/;
+function Ie(e, n) {
+  if (!(e instanceof K) || e.line === void 0) return;
+  const { line: t, message: r } = e, a = Te.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) {
+function X(e, n) {
   if (!(e instanceof Error)) return e;
-  const t = Ce(e.message, n);
+  const t = Ie(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 +561,7 @@ var Te = `// @ts-check
   fit()
   stage.focus({ preventScroll: true })
 })()
-`, Ae = `
+`, Me = `
   :root {
     color-scheme: light dark;
     --bg: #f4f4f5;
@@ -663,16 +668,16 @@ var Te = `// @ts-check
     #diagram { position: static; transform: none !important; }
   }
 `.trim();
-function Ie(e) {
+function ze(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>${J(n)}</title>
 <style>
-${Ae}
+${Me}
 </style>
 </head>
 <body>
@@ -690,13 +695,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 $e(e) {
   let n;
   try {
     n = await import("@resvg/resvg-js");
@@ -707,73 +712,73 @@ ${r}`);
   }
   return (await n.renderAsync(e)).asPng();
 }
-var ze = 80, P = 1, L = 1, R = 0, $e = /\x1b\[[0-9;]*m/g;
-function _(e) {
+var Pe = 80, L = 1, R = 1, B = 0, Le = /\x1b\[[0-9;]*m/g;
+function N(e) {
   return e.split(`
-`).reduce((n, t) => Math.max(n, xe(Se(t.replace($e, "")))), 0);
+`).reduce((n, t) => Math.max(n, Se(Ce(t.replace(Le, "")))), 0);
 }
-function Pe(e) {
-  return e !== "auto" ? e : process.stdout.columns ?? ze;
+function Re(e) {
+  return e !== "auto" ? e : process.stdout.columns ?? Pe;
 }
-async function Le(e, n, t, r) {
-  const a = n ?? process.stdout, c = r ?? process.stderr;
+async function Be(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");
+  if (e.input !== void 0) l = await G(e.input, "utf-8");
   else if (t !== void 0) l = t;
   else {
     if (process.stdin.isTTY) throw new Error("No input file specified and stdin is a terminal. Pipe a diagram or pass a file path.");
-    l = await Y();
+    l = await U();
   }
   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 Oe(e, l, a, d);
   } catch (m) {
-    throw W(m, l);
+    throw X(m, l);
   }
 }
-async function Re(e, n, t, r) {
+async function Oe(e, n, t, r) {
   let a;
-  if (e.theme !== void 0 && (a = B[e.theme], a === void 0)) {
-    const s = Object.keys(B).join(", ");
+  if (e.theme !== void 0 && (a = O[e.theme], a === void 0)) {
+    const s = Object.keys(O).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 _e(s, e.force);
   if (e.ascii) {
     const s = a && g === void 0 ? {
       colorMode: "auto",
-      theme: ee(a)
+      theme: ne(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);
+    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.profile !== void 0 && (s.profile = e.profile), e.direction !== void 0 && (s.direction = e.direction), e.hyperlinks && g === void 0 && (s.hyperlinks = !0);
+    let u = _(n, s);
     if (e.maxWidth !== void 0) {
-      const p = Pe(e.maxWidth);
-      let h = _(u), b = !1;
+      const p = Re(e.maxWidth);
+      let h = N(u), v = !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);
-        if (f < i || C < v || x < y) {
-          const o = O(n, {
+        const y = s.paddingX ?? 5, i = s.paddingY ?? 5, w = s.boxBorderPadding ?? 1, C = Math.min(y, L), f = Math.min(i, R), T = Math.min(w, B);
+        if (C < y || f < i || T < w) {
+          const x = _(n, {
             ...s,
-            paddingX: f,
-            paddingY: C,
-            boxBorderPadding: x
-          }), d = _(o);
-          d < h && (u = o, h = d, b = !0);
+            paddingX: C,
+            paddingY: f,
+            boxBorderPadding: T
+          }), o = N(x);
+          o < h && (u = x, h = o, v = !0);
         }
       }
       if (h > p) {
-        const i = e.maxWidth === "auto" ? "detected terminal width" : "--max-width", v = b ? `Compact spacing (-x ${P} -y ${L} -p ${R}) was already applied automatically. ` : "", y = b ? "Try a narrower direction (LR vs TD), shorter labels, or widen your terminal." : "Try -x/-y/-p for tighter spacing, a narrower direction (LR vs TD), or widen your terminal.";
-        r.write(`Warning: ASCII output is ${h} columns wide, exceeding ${i} of ${p}. ${v}zombie-mermaid does not reflow diagram structure to fit (no label wrapping or direction-flip cascade — see https://github.com/dfadler/zombie-mermaid/issues/335). ${y}
+        const y = e.maxWidth === "auto" ? "detected terminal width" : "--max-width", i = v ? `Compact spacing (-x ${L} -y ${R} -p ${B}) was already applied automatically. ` : "", w = v ? "Try a narrower direction (LR vs TD), shorter labels, or widen your terminal." : "Try -x/-y/-p for tighter spacing, a narrower direction (LR vs TD), or widen your terminal.";
+        r.write(`Warning: ASCII output is ${h} columns wide, exceeding ${y} of ${p}. ${i}zombie-mermaid does not reflow diagram structure to fit (no label wrapping or direction-flip cascade — see https://github.com/dfadler/zombie-mermaid/issues/335). ${w}
 `);
-      } else b && r.write(`Note: ASCII output exceeded ${p} columns at the requested spacing; applied compact spacing automatically (-x ${P} -y ${L} -p ${R}) to fit.
+      } else v && r.write(`Note: ASCII output exceeded ${p} columns at the requested spacing; applied compact spacing automatically (-x ${L} -y ${R} -p ${B}) to fit.
 `);
     }
-    await I(A(g === void 0, g), u + `
+    await M(A(g === void 0, g), u + `
 `, t, e.force);
   }
   if (e.svg) {
@@ -782,15 +787,15 @@ async function Re(e, n, t, r) {
       resolveColors: e.resolveColors
     };
     e.direction !== void 0 && (s.direction = e.direction);
-    const u = M(n, s);
-    await I(A(c, E), u, t, e.force);
+    const u = z(n, s);
+    await M(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 = z(n, a ?? {}), u = e.input ? F(e.input).name : void 0, p = ze({
       svg: s,
       title: u
     });
-    await I(A(l, S), p, t, e.force);
+    await M(A(l, S), p, t, e.force);
   }
   if (e.png) {
     const s = {
@@ -798,8 +803,8 @@ 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);
-    await I(A(m, k), p, t, e.force);
+    const u = z(n, s), p = await $e(u);
+    await M(A(m, k), p, t, e.force);
   }
 }
 function A(e, n) {
@@ -808,86 +813,86 @@ function A(e, n) {
     path: n
   } : { kind: "skip" };
 }
-async function I(e, n, t, r) {
+async function M(e, n, t, r) {
   switch (e.kind) {
     case "stdout":
       t.write(n);
       break;
     case "file":
-      await Oe(e.path, n, r);
+      await Ne(e.path, n, r);
   }
 }
-function X(e) {
+function Y(e) {
   return /* @__PURE__ */ new Error(`Refusing to overwrite existing file "${e}" — pass --force to replace it`);
 }
-async function Be(e, n) {
+async function _e(e, n) {
   if (n) return;
   let t = !0;
   try {
-    await Z(e);
+    await ee(e);
   } catch {
     t = !1;
   }
-  if (t) throw X(e);
+  if (t) throw Y(e);
 }
-async function Oe(e, n, t) {
+async function Ne(e, n, t) {
   try {
-    await Q(e, n, {
+    await te(e, n, {
       encoding: "utf-8",
       flag: t ? "w" : "wx"
     });
   } catch (r) {
-    throw !t && r instanceof Error && "code" in r && r.code === "EEXIST" ? X(e) : r;
+    throw !t && r instanceof Error && "code" in r && r.code === "EEXIST" ? Y(e) : r;
   }
 }
-async function Y() {
+async function U() {
   const e = [], n = process.stdin;
   return n.setEncoding("utf-8"), new Promise((t, r) => {
     n.on("data", (a) => e.push(a)), n.on("end", () => t(e.join(""))), n.on("error", r);
   });
 }
-async function _e(e, n) {
+async function De(e, n) {
   let t;
-  if (e.input !== void 0) t = await F(e.input, "utf-8");
+  if (e.input !== void 0) t = await G(e.input, "utf-8");
   else if (n !== void 0) t = n;
   else {
     if (process.stdin.isTTY) throw new Error("No input file specified and stdin is a terminal. Pipe a diagram or pass a file path.");
-    t = await Y();
+    t = await U();
   }
   const r = t;
   if (r.trim().length === 0) throw new Error("Empty input — provide a Mermaid diagram via file or stdin");
   try {
-    ne(r);
+    oe(r);
   } catch (a) {
-    throw W(a, r);
+    throw X(a, r);
   }
   console.log("valid");
 }
-var Ne = 1e6;
-function De(e) {
+var Fe = 1e6;
+function Ge(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 > Fe) {
         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) {
+function V(e) {
   return typeof e == "object" && e !== null;
 }
-function Fe(e) {
+function We(e) {
   let n;
   try {
     n = JSON.parse(e);
   } catch {
     throw new Error("Invalid JSON in request body");
   }
-  if (!U(n)) throw new Error("Request body must be a JSON object");
+  if (!V(n)) throw new Error("Request body must be a JSON object");
   const t = n.source;
   if (typeof t != "string" || t.trim().length === 0) throw new Error('Provide Mermaid source as a non-empty "source" string');
   return {
@@ -895,25 +900,25 @@ function Fe(e) {
     format: n.format === "svg" ? "svg" : "ascii"
   };
 }
-function N(e, n, t) {
+function D(e, n, t) {
   const r = JSON.stringify(t);
   e.writeHead(n, {
     "Content-Type": "application/json; charset=utf-8",
     "Content-Length": Buffer.byteLength(r)
   }), e.end(r);
 }
-async function Ge(e, n) {
+async function Xe(e, n) {
   try {
-    const { source: t, format: r } = Fe(await De(e));
-    N(n, 200, {
-      output: r === "svg" ? M(t) : O(t),
+    const { source: t, format: r } = We(await Ge(e));
+    D(n, 200, {
+      output: r === "svg" ? z(t) : _(t),
       format: r
     });
   } catch (t) {
-    N(n, 400, { error: t instanceof Error ? t.message : String(t) });
+    D(n, 400, { error: t instanceof Error ? t.message : String(t) });
   }
 }
-var We = `<!doctype html>
+var Ye = `<!doctype html>
 <html lang="en">
 <head>
 <meta charset="utf-8" />
@@ -979,92 +984,92 @@ var We = `<!doctype html>
 </body>
 </html>
 `;
-function Xe() {
-  return re((e, n) => {
+function Ue() {
+  return ie((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(Ye);
       return;
     }
     if (e.method === "POST" && t === "/render") {
-      Ge(e, n);
+      Xe(e, n);
       return;
     }
     n.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" }), n.end("Not found");
   });
 }
-function Ye(e) {
+function Ve(e) {
   return new Promise((n, t) => {
-    const r = Xe();
+    const r = Ue();
     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();
-  return n(`zombie-mermaid web running at http://localhost:${U(r) && typeof r.port == "number" ? r.port : e.port}`), t;
+async function qe(e, n = console.log) {
+  const t = await Ve(e.port), r = t.address();
+  return n(`zombie-mermaid web running at http://localhost:${V(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 = se(), t = new ae();
   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() {
-  const e = V(import.meta.url)("../package.json");
+function je() {
+  const e = q(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() {
+re(de);
+var Ke = je();
+async function Je() {
   const e = process.argv.slice(2);
   let n;
   try {
-    n = le(e);
+    n = ue(e);
   } catch (t) {
     console.error(`Error: ${t instanceof Error ? t.message : String(t)}`), process.exit(1);
   }
   switch (n.command) {
     case "help":
-      Ke();
+      Ze();
       break;
     case "version":
-      console.log(`zombie-mermaid ${qe}`);
+      console.log(`zombie-mermaid ${Ke}`);
       break;
     case "themes":
       console.log(`Available themes:
 `);
-      for (const t of Object.keys(B)) console.log(`  ${t}`);
+      for (const t of Object.keys(O)) console.log(`  ${t}`);
       break;
     case "render":
       try {
-        await Le(n);
+        await Be(n);
       } catch (t) {
         console.error(`Error: ${t instanceof Error ? t.message : String(t)}`), process.exit(1);
       }
       break;
     case "validate":
       try {
-        await _e(n);
+        await De(n);
       } catch (t) {
         console.error(`Error: ${t instanceof Error ? t.message : String(t)}`), process.exit(1);
       }
       break;
     case "web":
       try {
-        await Ue(n);
+        await qe(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 Ze() {
   console.log(`
 zombie-mermaid — render Mermaid diagrams from the command line
 
@@ -1129,6 +1134,10 @@ Options:
                        VTE-based terminals render them as clickable links;
                        others may show the URL or nothing. Pagers need
                        OSC 8 support too (\`less -R\`, recent versions).
+  --profile <name>     ASCII preset: 'markdown' = plain ASCII characters, no
+                       color, for pasting into issues/commits/fenced blocks
+                       (explicit flags like --coords still win). Requires
+                       --ascii.
   -w, --max-width <n|auto>  Fit ASCII output within this many columns
                        ('auto' detects the terminal width): applies compact
                        spacing automatically when needed, and warns on
@@ -1139,7 +1148,7 @@ Options:
   -v, --version        Show version
 `.trim());
 }
-je();
+Je();
 export {
-  je as main
+  Je 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.4.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",
@@ -88,20 +88,24 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "elkjs": "^0.11.0",
+    "elkjs": "^0.12.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.4.0",
+    "@zombie-mermaid/core": "5.4.0",
+    "@zombie-mermaid/mcp": "5.4.0",
+    "@zombie-mermaid/mermaid-parser": "5.4.0",
+    "@zombie-mermaid/svg-renderer": "5.4.0"
   },
   "devDependencies": {
+    "@arethetypeswrong/cli": "0.18.5",
     "@axe-core/playwright": "^4.13.0",
     "@changesets/changelog-github": "^1.0.0",
     "@changesets/cli": "^3.0.1",
+    "@fast-check/vitest": "0.5.0",
     "@microsoft/api-extractor": "^7.59.0",
     "@playwright/test": "1.62.1",
+    "@stryker-mutator/core": "10.0.0",
+    "@stryker-mutator/vitest-runner": "10.0.0",
     "@testing-library/jest-dom": "^7.0.1",
     "@testing-library/react": "^16.3.3",
     "@testing-library/user-event": "^14.6.7",
@@ -114,12 +118,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 +143,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,11 +173,15 @@
     "check:changesets": "tsx scripts/check-changesets.ts",
     "check:docs": "tsx scripts/check-docs.ts",
     "smoke:packed": "node scripts/smoke-test-packed.mjs",
+    "check:pack-dist": "node scripts/check-pack-dist.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",
     "generate:primitives-classes": "tsx scripts/generate-primitives-classes.ts && prettier --write demo/components/generated/primitives-classes.ts",
     "generate:logo-lockup": "tsx scripts/generate-logo-lockup.ts",
+    "api:report": "tsx scripts/api-report.ts",
+    "mutation": "stryker run",
     "docs:scripts": "tsx scripts/generate-development-scripts-doc.ts && prettier --write docs/development-scripts.md",
     "badge:bundle-size": "tsx scripts/generate-bundle-badge.ts",
     "visual-diff": "tsx scripts/visual-diff.ts",