zombie-mermaid 5.0.1 → 5.2.0

package/README.md

@@ -73,7 +73,7 @@ the SVG renderer at all (see [ASCII Output](#ascii-output)).
 
 ## Features
 
-- **6 diagram types** — Flowcharts, State, Sequence, Class, ER, and XY Charts (bar, line, combined)
+- **8 diagram types** — Flowcharts (including State), Sequence, Class, ER, XY Charts (bar, line, combined), Architecture, C4, and Pie
 - **Dual output** — SVG for rich UIs, ASCII/Unicode for terminals
 - **Synchronous rendering** — No async, no flash. Works with React `useMemo()`
 - **15 built-in themes** — And dead simple to add your own
@@ -86,6 +86,8 @@ the SVG renderer at all (see [ASCII Output](#ascii-output)).
 
 ## Installation
 
+Requires Node.js 24 or newer (`engines` in `package.json`).
+
 ```bash
 npm install zombie-mermaid
 # or
@@ -94,9 +96,16 @@ bun add zombie-mermaid
 pnpm add zombie-mermaid
 ```
 
-> **Upgrading from 4.x?** `elkjs` is now an optional peer dependency: browser and
-> bundler apps must call `registerElk(ELK)` once. See the
-> [migration guide](docs/guides/elkjs-optional-peer.md).
+> Not sure this is the right package? See [Which package do I install?](docs/guides/choosing-a-package.md).
+
+> **Upgrading from 4.x?** Node.js 24 or newer is now required. `elkjs` is now an
+> optional peer dependency: browser and bundler apps must call `registerElk(ELK)`
+> once (see the [migration guide](docs/guides/elkjs-optional-peer.md)). The
+> package no longer ships `src/` (see [#1538](https://github.com/dfadler/zombie-mermaid/issues/1538)).
+
+> **`elkjs` in the umbrella package:** the sub-packages (`@zombie-mermaid/svg-renderer`) treat `elkjs` as an
+> optional peer, but `zombie-mermaid` itself lists it as a regular dependency so the CLI and MCP server work
+> out of the box. See [what happens if you remove it](docs/guides/elkjs-optional-peer.md#removing-elkjs-from-zombie-mermaid).
 
 Only need one output format? `@zombie-mermaid/ascii-renderer` and `@zombie-mermaid/svg-renderer` are published standalone — see [Packages](#packages) below.
 
@@ -129,10 +138,23 @@ import { registerElk } from 'zombie-mermaid'
 registerElk(ELK)
 ```
 
+Architecture diagrams (`architecture-beta`, see [Supported Diagrams](docs/diagrams.md#architecture-diagrams)) are laid out by `elkjs` too.
 Sequence, pie, xychart and C4 diagrams, and all ASCII output, need no `elkjs`
 and no registration. Rendering a graph diagram with no `elkjs` available throws an
 `ElkNotRegisteredError` that says how to fix it.
 
+**Flowcharts without `elkjs`.** Pass `layout: 'simple'` to lay a flowchart out with a
+small built-in layered layout instead of ELK. It needs no `elkjs`, adds about 3.5 KB
+gzipped, and is opt-in: the default output never changes. It is a rougher match for
+ELK on edge routing, and a subgraph's own `direction` is ignored. State, class, ER
+and architecture diagrams still need `elkjs`. See
+[the decision record](docs/decisions/simple-layout-1685.md) for the measured quality
+gap.
+
+```typescript
+const svg = renderMermaidSVG('graph TD\n  A --> B', { layout: 'simple' }) // no registerElk()
+```
+
 Need async? Use `renderMermaidSVGAsync()` — same output, returns a `Promise<string>`.
 
 ### ASCII Output
@@ -201,7 +223,7 @@ hyperlinks — off by default, since terminal and pager support varies (see
 
 > 🧪 **Experimental — shipped to gauge interest, not a finished or best-effort implementation.** This is a first cut covering the common case; the tool surface may change based on feedback. Try it and [open an issue](https://github.com/dfadler/zombie-mermaid/issues/new) with what you'd want from it.
 
-`zombie-mermaid mcp` starts a [Model Context Protocol](https://modelcontextprotocol.io/) server on stdio, exposing the library's rendering as six tools: `render_mermaid_svg`, `render_mermaid_ascii`, `check_mermaid_sequence_activations`, `fix_mermaid_sequence_activations`, `list_themes`, and `list_diagram_types`. `render_mermaid_svg` also takes optional `bg`/`fg` hex color overrides (applied on top of `theme`) and an optional `outputPath` that writes the SVG to disk and returns `{ saved, size }` instead of the SVG text. `outputPath` must end in `.svg` and resolve inside the server's working directory (the directory your MCP client launched it from); its parent directory must already exist, symlinks and non-regular files are refused, and an existing `.svg` file at that path is overwritten. Point an MCP client (Claude Desktop, Claude Code, or anything else that speaks MCP) at it to render Mermaid diagrams directly in a conversation, without shelling out to the CLI or importing the library.
+`zombie-mermaid mcp` starts a [Model Context Protocol](https://modelcontextprotocol.io/) server on stdio, exposing the library's rendering as seven tools: `render_mermaid_svg`, `render_mermaid_ascii`, `validate_mermaid`, `check_mermaid_sequence_activations`, `fix_mermaid_sequence_activations`, `list_themes`, and `list_diagram_types`. `render_mermaid_svg` also takes optional `bg`/`fg` hex color overrides (applied on top of `theme`) and an optional `outputPath` that writes the SVG to disk and returns `{ saved, size }` instead of the SVG text. `outputPath` must end in `.svg` and resolve inside the server's working directory (the directory your MCP client launched it from); its parent directory must already exist, symlinks and non-regular files are refused, and an existing `.svg` file at that path is overwritten. Per-tool arguments and return shapes are in the [MCP tool reference](docs/mcp-tools.md). Point an MCP client (Claude Desktop, Claude Code, or anything else that speaks MCP) at it to render Mermaid diagrams directly in a conversation, without shelling out to the CLI or importing the library.
 
 Example Claude Desktop / Claude Code MCP server config:
 
@@ -216,7 +238,7 @@ Example Claude Desktop / Claude Code MCP server config:
 }
 ```
 
-All three tools accept a `diagram` string. The two render tools also take a handful of rendering options (`theme`, `transparent`, `font` for SVG; `useAscii`, `paddingX`/`paddingY`/`boxBorderPadding` for ASCII) — see each tool's `inputSchema` for the full, current list. Invalid Mermaid syntax comes back as a normal tool error (`isError: true`) rather than crashing the connection.
+The five diagram tools (including `validate_mermaid`, parse-only) accept a `diagram` string (`list_themes` and `list_diagram_types` take no arguments). The two render tools also take a handful of rendering options (`theme`, `transparent`, `font` for SVG; `useAscii`, `paddingX`/`paddingY`/`boxBorderPadding` for ASCII) — see each tool's `inputSchema` for the full, current list. Invalid Mermaid syntax comes back as a normal tool error (`isError: true`) rather than crashing the connection; `validate_mermaid` is the exception and reports it as a normal `{ valid: false, diagnostics }` result.
 
 `check_mermaid_sequence_activations` is a mechanical, deterministic check — no LLM judgment involved — for a specific gap in existing Mermaid validators: every `activate X` (or `+` arrow shorthand) in a `sequenceDiagram` must be closed by a matching `deactivate X` (`-` shorthand) before the diagram ends. It returns a JSON report (`{ ok, issues }`) rather than rendering anything, and errors (`isError: true`) if given a non-sequence diagram.
 
@@ -266,12 +288,13 @@ See [docs/decisions/monorepo-conversion.md](docs/decisions/monorepo-conversion.m
 
 ## Docs
 
-- [Guides](docs/guides/) — task-oriented walkthroughs: [browsing the samples](docs/guides/samples.md), [choosing a theme](docs/guides/theming.md), [using the HTML viewer](docs/guides/html-viewer.md)
+- [Guides](docs/guides/) — task-oriented walkthroughs: [browsing the samples](docs/guides/samples.md), [choosing a theme](docs/guides/theming.md), [using the HTML viewer](docs/guides/html-viewer.md), [upgrading from 2.x to 5.x](docs/guides/upgrading-2x-to-5x.md)
 - [Accessibility](docs/accessibility.md) — conformance statement: what's guaranteed (and CI-enforced), what's implemented but unverified by automation, and what isn't covered
 - [Theming](docs/theming.md) — the two-color foundation, enriched mode, built-in themes, custom themes, Shiki compatibility
 - [Supported Diagrams](docs/diagrams.md) — syntax for every diagram type, XY chart styling, and ASCII rendering options
 - [React Integration](docs/react-integration.md) — zero-flash rendering with `useMemo()`
 - [API Reference](docs/api-reference.md) — full function and options reference
+- [Versioning and deprecation policy](docs/decisions/versioning-and-deprecation-policy-1568.md) — what counts as a breaking change, and how old majors are supported and deprecated
 - [Migrating from `beautiful-mermaid`](docs/migrating-from-beautiful-mermaid.md) — what's drop-in, which fixes change rendered output, and how to audit your own diagrams before upgrading
 
 More design write-ups and reference material live in [docs/](docs/).

package/THIRD_PARTY_NOTICES.md

@@ -0,0 +1,14 @@
+# Third-party notices
+
+This repository includes material from the projects below. Each published
+package ships only the notices that apply to it (see its own
+`THIRD_PARTY_NOTICES.md`).
+
+- ASCII renderer: based on [mermaid-ascii](https://github.com/AlexanderGrooff/mermaid-ascii), MIT,
+  Copyright (c) 2023 Alexander Grooff
+  (`packages/ascii-renderer/THIRD_PARTY_NOTICES.md`).
+- JetBrains Mono NL font subset: SIL OFL 1.1, Copyright 2020 The JetBrains Mono
+  Project Authors (`packages/svg-renderer/THIRD_PARTY_NOTICES.md`,
+  `third_party/fonts/`).
+- Forked from [beautiful-mermaid](https://github.com/lukilabs/beautiful-mermaid),
+  MIT, Copyright (c) 2026 Craft Docs (see `LICENSE`).

package/dist/cli.js

@@ -1,28 +1,28 @@
 #!/usr/bin/env node
-import { createRequire as U } from "node:module";
-import { extname as V, format as H, parse as G } from "node:path";
-import { THEMES as B, escapeXml as q, isDirection as j, isWideChar as K } from "@zombie-mermaid/core";
-import { access as J, readFile as Z, writeFile as Q } from "node:fs/promises";
+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 "@zombie-mermaid/mermaid-parser";
-import { registerElk as te, renderMermaidSVG as z } from "@zombie-mermaid/svg-renderer";
-import { createServer as ne } from "node:http";
-import { StdioServerTransport as re } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { createMcpServer as oe } from "@zombie-mermaid/mcp";
-import ie from "elkjs/lib/elk.bundled.js";
-var ae = 3e3;
-var W = {
+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 = {
   ".svg": "svg",
   ".txt": "ascii",
   ".html": "html",
   ".htm": "html",
   ".png": "png"
 };
-function se(e) {
+function de(e) {
   if (!(e === void 0 || e === "-"))
-    return W[V(e).toLowerCase()];
+    return G[H(e).toLowerCase()];
 }
-var v = {
+var w = {
   svg: {
     flag: "--svg",
     ext: ".svg",
@@ -44,49 +44,57 @@ var v = {
     display: "PNG",
     label: "the PNG rasterization"
   }
-}, A = Object.keys(v);
-function de(e, n) {
-  const t = G(e);
-  return H({
+}, T = Object.keys(w);
+function ce(e, n) {
+  const t = D(e);
+  return q({
     dir: t.dir,
     name: t.name,
     ext: n
   });
 }
-function ce(e) {
+function le(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 ue(t);
-  if (n === "web") return pe(t);
+  if (n === "render") return pe(t);
+  if (n === "validate") {
+    const r = t.find((a, c) => c > 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 === "mcp") return { command: "mcp" };
   throw new Error(`Unknown command: ${n}`);
 }
-function $(e, n, t) {
+function z(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 le(e, n, t) {
+function me(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";
-  const s = Number(r);
-  if (!/^\d+$/.test(r) || s === 0 || !Number.isSafeInteger(s)) throw new Error(`${t} requires "auto" or a positive integer, got: "${r}"`);
-  return s;
+  const a = Number(r);
+  if (!/^\d+$/.test(r) || a === 0 || !Number.isSafeInteger(a)) throw new Error(`${t} requires "auto" or a positive integer, got: "${r}"`);
+  return a;
 }
-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 (one of TD, TB, BT, LR, RL)`);
-  const s = r.toUpperCase();
-  if (!j(s)) throw new Error(`${t} requires one of TD, TB, BT, LR, RL, got: "${r}"`);
-  return s;
+  const a = r.toUpperCase();
+  if (!K(a)) throw new Error(`${t} requires one of TD, TB, BT, LR, RL, got: "${r}"`);
+  return a;
 }
-function ue(e) {
-  let n, t = !1, r = !1, s = !1, m = !1, c = !1, d, E = !1, S, k, g, C, T = !1, b = !1, a, u, i = 0;
+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;
   for (; i < e.length; ) {
     const o = e[i];
     if (o === void 0) throw new Error(`parseArgs: index ${i} out of range while parsing arguments`);
@@ -95,115 +103,115 @@ function ue(e) {
     else if (o === "--svg")
       r = !0, i++;
     else if (o === "--resolve-colors")
-      s = !0, i++;
+      a = !0, i++;
     else if (o === "--html")
-      m = !0, i++;
-    else if (o === "--png")
       c = !0, i++;
+    else if (o === "--png")
+      l = !0, i++;
     else if (o === "-o" || o === "--output") {
       if (i + 1 >= e.length) throw new Error("-o requires a file path (or - for stdout)");
-      d = e[i + 1], i += 2;
+      m = e[i + 1], i += 2;
     } else if (o === "-f" || o === "--force")
-      E = !0, i++;
+      g = !0, i++;
     else if (o === "--theme") {
       if (i + 1 >= e.length) throw new Error("--theme requires a theme name");
-      S = e[i + 1], i += 2;
+      E = e[i + 1], i += 2;
     } else if (o === "-x" || o === "--paddingX")
-      k = $(e, i, o), i += 2;
+      S = z(e, i, o), i += 2;
     else if (o === "-y" || o === "--paddingY")
-      g = $(e, i, o), i += 2;
+      k = z(e, i, o), i += 2;
     else if (o === "-p" || o === "--borderPadding")
-      C = $(e, i, o), i += 2;
+      s = z(e, i, o), i += 2;
     else if (o === "--coords")
-      T = !0, i++;
+      u = !0, i++;
     else if (o === "--hyperlinks")
-      b = !0, i++;
+      p = !0, i++;
     else if (o === "-w" || o === "--max-width")
-      a = le(e, i, o), i += 2;
+      h = me(e, i, o), i += 2;
     else if (o === "--direction")
-      u = me(e, i, o), i += 2;
+      b = ue(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 h = {
+  const v = {
     svg: r,
-    html: m,
-    png: c
-  }, w = A.filter((o) => h[o]);
-  if (w.length > 1) {
-    const [o, l] = w;
-    throw new Error(`${v[o].flag} and ${v[l].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.`);
+    html: c,
+    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 p = se(d);
-  if (p !== void 0 && p !== "ascii") {
-    const o = A.find((l) => l !== p && h[l]);
+  const f = de(m);
+  if (f !== void 0 && f !== "ascii") {
+    const o = T.find((d) => d !== f && v[d]);
     if (o !== void 0) {
-      const l = v[p], x = v[o];
-      throw new Error(`-o ${d} has ${l.article} ${l.ext} extension, but ${x.flag} output would be written to it. Use a ${x.ext} path (or -o - for stdout) for ${x.label}.`);
+      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}.`);
     }
-    p === "svg" ? r = !0 : p === "html" ? m = !0 : c = !0;
-  } else if (p === "ascii") {
-    const o = A.find((l) => h[l]);
+    f === "svg" ? r = !0 : f === "html" ? c = !0 : l = !0;
+  } else if (f === "ascii") {
+    const o = T.find((d) => v[d]);
     if (o !== void 0) {
-      const l = v[o];
-      throw new Error(`-o ${d} has a .txt extension, but ${l.flag} output would be written to it. Use a ${l.ext} path (or -o - for stdout) instead.`);
+      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.`);
     }
     t = !0;
   }
-  if (!t && !r && !m && !c) {
-    if (d !== void 0 && d !== "-") {
-      const o = Object.keys(W).join(", ");
-      throw new Error(`Cannot infer an output format from "${d}" — pass --ascii, --svg, --html, or --png, or use a recognised extension (${o})`);
+  if (!t && !r && !c && !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})`);
     }
     throw new Error("Specify --ascii, --svg, --html, and/or --png (or -o <path> with a .svg/.txt/.html/.png extension)");
   }
-  const y = {
+  const C = {
     svg: r,
-    html: m,
-    png: c
-  }, f = A.find((o) => y[o]);
-  if (d === "-" && t && f !== void 0) {
-    const o = v[f].display;
+    html: c,
+    png: l
+  }, x = T.find((o) => C[o]);
+  if (m === "-" && t && x !== void 0) {
+    const o = w[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 (f !== void 0 && d === void 0) {
-    const { flag: o, ext: l } = v[f];
+  if (x !== void 0 && m === void 0) {
+    const { flag: o, ext: d } = 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`);
-    d = de(n, l);
+    m = ce(n, d);
   }
-  if (a !== void 0 && !t) throw new Error("-w/--max-width requires --ascii");
-  if (b && !t) throw new Error("--hyperlinks requires --ascii");
-  if (s && !r) throw new Error("--resolve-colors requires --svg");
+  if (h !== void 0 && !t) throw new Error("-w/--max-width requires --ascii");
+  if (p && !t) throw new Error("--hyperlinks requires --ascii");
+  if (a && !r) throw new Error("--resolve-colors requires --svg");
   return {
     command: "render",
     input: n,
     ascii: t,
     svg: r,
-    resolveColors: s,
-    html: m,
-    png: c,
-    output: d,
-    force: E,
-    theme: S,
-    paddingX: k,
-    paddingY: g,
-    borderPadding: C,
-    coords: T,
-    hyperlinks: b,
-    maxWidth: a,
-    direction: u
+    resolveColors: a,
+    html: c,
+    png: l,
+    output: m,
+    force: g,
+    theme: E,
+    paddingX: S,
+    paddingY: k,
+    borderPadding: s,
+    coords: u,
+    hyperlinks: p,
+    maxWidth: h,
+    direction: b
   };
 }
-function pe(e) {
-  let n = ae, t = 0;
+function fe(e) {
+  let n = se, 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 = $(e, t, r), t += 2;
+      n = z(e, t, r), t += 2;
     else throw new Error(`Unknown flag: ${r}`);
   }
   return {
@@ -212,33 +220,51 @@ function pe(e) {
   };
 }
 var he = /\p{Mn}|\p{Me}/u;
-function fe(e) {
+function ge(e) {
   return he.test(e);
 }
-var ge = new Intl.Segmenter(void 0, { granularity: "grapheme" }), ve = "️";
-function we(e) {
+var ve = new Intl.Segmenter(void 0, { granularity: "grapheme" }), we = "️";
+function be(e) {
   if (/^[\x20-\x7e]*$/.test(e)) return e.split("");
   const n = [];
-  for (const { segment: t } of ge.segment(e)) n.push(t);
+  for (const { segment: t } of ve.segment(e)) n.push(t);
   return n;
 }
-function be(e) {
-  if (e.includes(ve)) return 2;
+function ye(e) {
+  if (e.includes(we)) return 2;
   let n = !1, t = !1;
   for (const r of e)
-    K(r) && (n = !0), fe(r) || (t = !0);
+    J(r) && (n = !0), ge(r) || (t = !0);
   return n ? 2 : t ? 1 : 0;
 }
-function ye(e) {
+function xe(e) {
   let n = 0;
-  for (const t of we(e)) n += be(t);
+  for (const t of be(e)) n += ye(t);
   return n;
 }
-var xe = /\x1b\]8;[^\x07\x1b]*(?:\x1b\\|\x07)/g;
-function Ee(e) {
-  return e.replace(xe, "");
+var Ee = /\x1b\]8;[^\x07\x1b]*(?:\x1b\\|\x07)/g;
+function Se(e) {
+  return e.replace(Ee, "");
 }
-var Se = `// @ts-check
+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))
+    return {
+      line: r,
+      sourceLine: a,
+      message: t[2] ?? ""
+    };
+}
+function W(e, n) {
+  if (!(e instanceof Error)) return e;
+  const t = Ce(e.message, n);
+  return t === void 0 ? e : /* @__PURE__ */ new Error(`${e.message}
+  ${t.line} | ${t.sourceLine}`);
+}
+var Te = `// @ts-check
 /// <reference lib="dom" />
 // ============================================================================
 // Client script for the CLI's self-contained HTML viewer (\`render --html\`).
@@ -530,7 +556,7 @@ var Se = `// @ts-check
   fit()
   stage.focus({ preventScroll: true })
 })()
-`, ke = `
+`, Ae = `
   :root {
     color-scheme: light dark;
     --bg: #f4f4f5;
@@ -637,16 +663,16 @@ var Se = `// @ts-check
     #diagram { position: static; transform: none !important; }
   }
 `.trim();
-function Ce(e) {
+function Ie(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>${q(n)}</title>
+<title>${j(n)}</title>
 <style>
-${ke}
+${Ae}
 </style>
 </head>
 <body>
@@ -664,13 +690,13 @@ ${e.svg}
   <button id="theme" type="button" aria-pressed="false" aria-label="Switch to dark mode (T)">Dark</button>
 </div>
 <script>
-${Se}
+${Te}
 <\/script>
 </body>
 </html>
 `;
 }
-async function Te(e) {
+async function Me(e) {
   let n;
   try {
     n = await import("@resvg/resvg-js");
@@ -681,123 +707,130 @@ ${r}`);
   }
   return (await n.renderAsync(e)).asPng();
 }
-var Ae = 80, P = 1, L = 1, R = 0, Ie = /\x1b\[[0-9;]*m/g;
-function D(e) {
+var ze = 80, P = 1, L = 1, R = 0, $e = /\x1b\[[0-9;]*m/g;
+function _(e) {
   return e.split(`
-`).reduce((n, t) => Math.max(n, ye(Ee(t.replace(Ie, "")))), 0);
+`).reduce((n, t) => Math.max(n, xe(Se(t.replace($e, "")))), 0);
 }
-function Me(e) {
-  return e !== "auto" ? e : process.stdout.columns ?? Ae;
+function Pe(e) {
+  return e !== "auto" ? e : process.stdout.columns ?? ze;
 }
-async function ze(e, n, t, r) {
-  const s = n ?? process.stdout, m = r ?? process.stderr;
-  let c;
-  if (e.input !== void 0) c = await Z(e.input, "utf-8");
-  else if (t !== void 0) c = t;
+async function Le(e, n, t, r) {
+  const a = n ?? process.stdout, c = r ?? process.stderr;
+  let l;
+  if (e.input !== void 0) l = await F(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.");
-    c = await Le();
+    l = await Y();
   }
-  if (c = c.trim(), c.length === 0) throw new Error("Empty input — provide a Mermaid diagram via file or stdin");
-  let d;
-  if (e.theme !== void 0 && (d = B[e.theme], d === void 0)) {
-    const a = Object.keys(B).join(", ");
-    throw new Error(`Unknown theme: "${e.theme}". Available themes: ${a}`);
+  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);
+  } catch (m) {
+    throw W(m, l);
   }
-  const E = e.svg && e.output === "-", S = e.html && e.output === "-", k = e.png && e.output === "-", g = e.ascii && !e.svg && !e.html && !e.png && e.output !== void 0 && e.output !== "-" ? e.output : void 0, C = e.svg && !E ? e.output : void 0, T = e.html && !S ? e.output : void 0, b = e.png && !k ? e.output : void 0;
-  for (const a of [
+}
+async function Re(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;
+  for (const s of [
     g,
-    C,
-    T,
-    b
-  ]) a !== void 0 && await $e(a, e.force);
+    E,
+    S,
+    k
+  ]) s !== void 0 && await Be(s, e.force);
   if (e.ascii) {
-    const a = d && g === void 0 ? {
+    const s = a && g === void 0 ? {
       colorMode: "auto",
-      theme: ee(d)
+      theme: ee(a)
     } : { colorMode: "none" };
-    e.paddingX !== void 0 && (a.paddingX = e.paddingX), e.paddingY !== void 0 && (a.paddingY = e.paddingY), e.borderPadding !== void 0 && (a.boxBorderPadding = e.borderPadding), e.coords && (a.showCoords = !0), e.direction !== void 0 && (a.direction = e.direction), e.hyperlinks && g === void 0 && (a.hyperlinks = !0);
-    let u = O(c, a);
+    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 i = Me(e.maxWidth);
-      let h = D(u), w = !1;
-      if (h > i) {
-        const p = a.paddingX ?? 5, y = a.paddingY ?? 5, f = a.boxBorderPadding ?? 1, o = Math.min(p, P), l = Math.min(y, L), x = Math.min(f, R);
-        if (o < p || l < y || x < f) {
-          const _ = O(c, {
-            ...a,
-            paddingX: o,
-            paddingY: l,
+      const p = Pe(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);
+        if (f < i || C < v || x < y) {
+          const o = O(n, {
+            ...s,
+            paddingX: f,
+            paddingY: C,
             boxBorderPadding: x
-          }), N = D(_);
-          N < h && (u = _, h = N, w = !0);
+          }), d = _(o);
+          d < h && (u = o, h = d, b = !0);
         }
       }
-      if (h > i) {
-        const p = e.maxWidth === "auto" ? "detected terminal width" : "--max-width", y = w ? `Compact spacing (-x ${P} -y ${L} -p ${R}) was already applied automatically. ` : "", f = w ? "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.";
-        m.write(`Warning: ASCII output is ${h} columns wide, exceeding ${p} of ${i}. ${y}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). ${f}
+      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}
 `);
-      } else w && m.write(`Note: ASCII output exceeded ${i} columns at the requested spacing; applied compact spacing automatically (-x ${P} -y ${L} -p ${R}) to fit.
+      } 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.
 `);
     }
-    await M(I(g === void 0, g), u + `
-`, s, e.force);
+    await I(A(g === void 0, g), u + `
+`, t, e.force);
   }
   if (e.svg) {
-    const a = {
-      ...d,
+    const s = {
+      ...a,
       resolveColors: e.resolveColors
     };
-    e.direction !== void 0 && (a.direction = e.direction);
-    const u = z(c, a);
-    await M(I(E, C), u, s, e.force);
+    e.direction !== void 0 && (s.direction = e.direction);
+    const u = M(n, s);
+    await I(A(c, E), u, t, e.force);
   }
   if (e.html) {
-    const a = z(c, d ?? {}), u = e.input ? G(e.input).name : void 0, i = Ce({
-      svg: a,
+    const s = M(n, a ?? {}), u = e.input ? D(e.input).name : void 0, p = Ie({
+      svg: s,
       title: u
     });
-    await M(I(S, T), i, s, e.force);
+    await I(A(l, S), p, t, e.force);
   }
   if (e.png) {
-    const a = {
-      ...d,
+    const s = {
+      ...a,
       resolveColors: !0
     };
-    e.direction !== void 0 && (a.direction = e.direction);
-    const u = z(c, a), i = await Te(u);
-    await M(I(k, b), i, s, e.force);
+    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);
   }
 }
-function I(e, n) {
+function A(e, n) {
   return e ? { kind: "stdout" } : n !== void 0 ? {
     kind: "file",
     path: n
   } : { kind: "skip" };
 }
-async function M(e, n, t, r) {
+async function I(e, n, t, r) {
   switch (e.kind) {
     case "stdout":
       t.write(n);
       break;
     case "file":
-      await Pe(e.path, n, r);
+      await Oe(e.path, n, r);
   }
 }
 function X(e) {
   return /* @__PURE__ */ new Error(`Refusing to overwrite existing file "${e}" — pass --force to replace it`);
 }
-async function $e(e, n) {
+async function Be(e, n) {
   if (n) return;
   let t = !0;
   try {
-    await J(e);
+    await Z(e);
   } catch {
     t = !1;
   }
   if (t) throw X(e);
 }
-async function Pe(e, n, t) {
+async function Oe(e, n, t) {
   try {
     await Q(e, n, {
       encoding: "utf-8",
@@ -807,37 +840,54 @@ async function Pe(e, n, t) {
     throw !t && r instanceof Error && "code" in r && r.code === "EEXIST" ? X(e) : r;
   }
 }
-async function Le() {
+async function Y() {
   const e = [], n = process.stdin;
   return n.setEncoding("utf-8"), new Promise((t, r) => {
-    n.on("data", (s) => e.push(s)), n.on("end", () => t(e.join(""))), n.on("error", r);
+    n.on("data", (a) => e.push(a)), n.on("end", () => t(e.join(""))), n.on("error", r);
   });
 }
-var Re = 1e6;
-function Be(e) {
+async function _e(e, n) {
+  let t;
+  if (e.input !== void 0) t = await F(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();
+  }
+  const r = t;
+  if (r.trim().length === 0) throw new Error("Empty input — provide a Mermaid diagram via file or stdin");
+  try {
+    ne(r);
+  } catch (a) {
+    throw W(a, r);
+  }
+  console.log("valid");
+}
+var Ne = 1e6;
+function De(e) {
   return new Promise((n, t) => {
     const r = [];
-    let s = 0;
-    e.on("data", (m) => {
-      if (s += m.length, s > Re) {
+    let a = 0;
+    e.on("data", (c) => {
+      if (a += c.length, a > Ne) {
         t(/* @__PURE__ */ new Error("Request body too large")), e.destroy();
         return;
       }
-      r.push(m);
+      r.push(c);
     }), e.on("end", () => n(Buffer.concat(r).toString("utf-8"))), e.on("error", t);
   });
 }
-function Y(e) {
+function U(e) {
   return typeof e == "object" && e !== null;
 }
-function Oe(e) {
+function Fe(e) {
   let n;
   try {
     n = JSON.parse(e);
   } catch {
     throw new Error("Invalid JSON in request body");
   }
-  if (!Y(n)) throw new Error("Request body must be a JSON object");
+  if (!U(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 {
@@ -845,25 +895,25 @@ function Oe(e) {
     format: n.format === "svg" ? "svg" : "ascii"
   };
 }
-function F(e, n, t) {
+function N(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 _e(e, n) {
+async function Ge(e, n) {
   try {
-    const { source: t, format: r } = Oe(await Be(e));
-    F(n, 200, {
-      output: r === "svg" ? z(t) : O(t),
+    const { source: t, format: r } = Fe(await De(e));
+    N(n, 200, {
+      output: r === "svg" ? M(t) : O(t),
       format: r
     });
   } catch (t) {
-    F(n, 400, { error: t instanceof Error ? t.message : String(t) });
+    N(n, 400, { error: t instanceof Error ? t.message : String(t) });
   }
 }
-var Ne = `<!doctype html>
+var We = `<!doctype html>
 <html lang="en">
 <head>
 <meta charset="utf-8" />
@@ -929,56 +979,56 @@ var Ne = `<!doctype html>
 </body>
 </html>
 `;
-function De() {
-  return ne((e, n) => {
+function Xe() {
+  return re((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(Ne);
+      n.writeHead(200, { "Content-Type": "text/html; charset=utf-8" }), n.end(We);
       return;
     }
     if (e.method === "POST" && t === "/render") {
-      _e(e, n);
+      Ge(e, n);
       return;
     }
     n.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" }), n.end("Not found");
   });
 }
-function Fe(e) {
+function Ye(e) {
   return new Promise((n, t) => {
-    const r = De();
+    const r = Xe();
     r.once("error", t), r.listen(e, "127.0.0.1", () => {
       r.removeListener("error", t), n(r);
     });
   });
 }
-async function Ge(e, n = console.log) {
-  const t = await Fe(e.port), r = t.address();
-  return n(`zombie-mermaid web running at http://localhost:${Y(r) && typeof r.port == "number" ? r.port : e.port}`), t;
+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 We(e = (n) => console.error(n)) {
-  const n = oe(), t = new re();
+async function Ve(e = (n) => console.error(n)) {
+  const n = ie(), t = new oe();
   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 Xe() {
-  const e = U(import.meta.url)("../package.json");
+function He() {
+  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(ie);
-var Ye = Xe();
-async function Ue() {
+te(ae);
+var qe = He();
+async function je() {
   const e = process.argv.slice(2);
   let n;
   try {
-    n = ce(e);
+    n = le(e);
   } catch (t) {
     console.error(`Error: ${t instanceof Error ? t.message : String(t)}`), process.exit(1);
   }
   switch (n.command) {
     case "help":
-      Ve();
+      Ke();
       break;
     case "version":
-      console.log(`zombie-mermaid ${Ye}`);
+      console.log(`zombie-mermaid ${qe}`);
       break;
     case "themes":
       console.log(`Available themes:
@@ -987,27 +1037,34 @@ async function Ue() {
       break;
     case "render":
       try {
-        await ze(n);
+        await Le(n);
+      } catch (t) {
+        console.error(`Error: ${t instanceof Error ? t.message : String(t)}`), process.exit(1);
+      }
+      break;
+    case "validate":
+      try {
+        await _e(n);
       } catch (t) {
         console.error(`Error: ${t instanceof Error ? t.message : String(t)}`), process.exit(1);
       }
       break;
     case "web":
       try {
-        await Ge(n);
+        await Ue(n);
       } catch (t) {
         console.error(`Error: ${t instanceof Error ? t.message : String(t)}`), process.exit(1);
       }
       break;
     case "mcp":
       try {
-        await We();
+        await Ve();
       } catch (t) {
         console.error(`Error: ${t instanceof Error ? t.message : String(t)}`), process.exit(1);
       }
   }
 }
-function Ve() {
+function Ke() {
   console.log(`
 zombie-mermaid — render Mermaid diagrams from the command line
 
@@ -1021,6 +1078,7 @@ Usage:
   zombie-mermaid render <file> --html               Self-contained pan/zoom HTML viewer
   zombie-mermaid render <file> --png                Rasterize to <file stem>.png
   cat file.mmd | zombie-mermaid render --ascii      Read from stdin
+  zombie-mermaid validate [file]                    Parse only; exit 1 with line diagnostics if invalid
   zombie-mermaid themes                             List available themes
   zombie-mermaid web [--port <n>]                   Start a local web UI (default port: 3000)
   zombie-mermaid mcp                                Start an MCP server on stdio (render tools)
@@ -1081,7 +1139,7 @@ Options:
   -v, --version        Show version
 `.trim());
 }
-Ue();
+je();
 export {
-  Ue 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,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}});

package/dist/index.d.cts

@@ -27,6 +27,7 @@ import { SequenceRenderOptions } from '@zombie-mermaid/core';
 import { themeCssVariables } from '@zombie-mermaid/svg-renderer';
 import { ThemeName } from '@zombie-mermaid/core';
 import { THEMES } from '@zombie-mermaid/core';
+import { validateMermaid } from '@zombie-mermaid/svg-renderer';
 import { XyChartRenderOptions } from '@zombie-mermaid/core';
 
 export { AsciiRenderOptions }
@@ -87,6 +88,8 @@ export { ThemeName }
 
 export { THEMES }
 
+export { validateMermaid }
+
 export { XyChartRenderOptions }
 
 export { }

package/dist/index.d.ts

@@ -27,6 +27,7 @@ import { SequenceRenderOptions } from '@zombie-mermaid/core';
 import { themeCssVariables } from '@zombie-mermaid/svg-renderer';
 import { ThemeName } from '@zombie-mermaid/core';
 import { THEMES } from '@zombie-mermaid/core';
+import { validateMermaid } from '@zombie-mermaid/svg-renderer';
 import { XyChartRenderOptions } from '@zombie-mermaid/core';
 
 export { AsciiRenderOptions }
@@ -87,6 +88,8 @@ export { ThemeName }
 
 export { THEMES }
 
+export { validateMermaid }
+
 export { XyChartRenderOptions }
 
 export { }

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 } 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 };
+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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zombie-mermaid",
-  "version": "5.0.1",
+  "version": "5.2.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",
@@ -80,6 +80,7 @@
   "files": [
     "dist/",
     "LICENSE",
+    "THIRD_PARTY_NOTICES.md",
     "README.md"
   ],
   "engines": {
@@ -89,13 +90,14 @@
     "@modelcontextprotocol/sdk": "^1.30.0",
     "elkjs": "^0.11.0",
     "entities": "^7.0.1",
-    "@zombie-mermaid/ascii-renderer": "5.0.1",
-    "@zombie-mermaid/mcp": "5.0.1",
-    "@zombie-mermaid/core": "5.0.1",
-    "@zombie-mermaid/svg-renderer": "5.0.1",
-    "@zombie-mermaid/mermaid-parser": "5.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"
   },
   "devDependencies": {
+    "@axe-core/playwright": "^4.13.0",
     "@changesets/changelog-github": "^1.0.0",
     "@changesets/cli": "^3.0.1",
     "@microsoft/api-extractor": "^7.59.0",
@@ -116,7 +118,7 @@
     "jsdom": "^30.0.1",
     "lightningcss": "^1.33.0",
     "marked": "^18.0.11",
-    "mermaid": "11.17.2",
+    "mermaid": "12.1.0",
     "prettier": "^3.9.6",
     "react": "^19.2.8",
     "react-dom": "^19.2.8",
@@ -138,7 +140,9 @@
     "test:watch": "vitest -c config/vitest.config.ts",
     "test:coverage": "vitest run -c config/vitest.config.ts --coverage",
     "test:visual": "playwright test",
+    "test:a11y": "playwright test -c playwright.a11y.config.ts",
     "test:visual:watch": "playwright test --ui",
+    "test:ascii-text:update": "vitest run -c config/vitest.config.ts __tests__/ascii-text-snapshots.test.ts -u",
     "test:visual:update": "playwright test --update-snapshots",
     "coverage:diff": "tsx scripts/check-diff-coverage.ts",
     "samples": "scripts/tsx-css.sh packages/site/index.ts",
@@ -156,8 +160,12 @@
     "bench:ascii-renderer": "tsx scripts/bench-ascii-renderer.ts",
     "bench:package-compare": "tsx scripts/bench-package-compare.ts",
     "bench:history:append": "tsx scripts/bench-history-append.ts",
+    "metrics:history:append": "tsx scripts/metrics-history-append.ts",
     "bench:trend": "tsx scripts/bench-trend.ts",
     "bench:mcp": "tsx scripts/bench-mcp.ts",
+    "check:changesets": "tsx scripts/check-changesets.ts",
+    "check:docs": "tsx scripts/check-docs.ts",
+    "smoke:packed": "node scripts/smoke-test-packed.mjs",
     "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",
@@ -170,6 +178,7 @@
     "form-facts": "tsx scripts/form-facts.ts",
     "form-judge-prepare": "tsx scripts/form-judge-prepare.ts",
     "form-judge-finalize-cache": "tsx scripts/form-judge-finalize-cache.ts",
+    "form-judge-calibrate": "tsx scripts/form-judge-calibrate.ts",
     "build": "pnpm run build:packages && vite build --app --config config/vite.config.lib.ts",
     "build:packages": "vite build --app --config packages/core/vite.config.ts && vite build --app --config packages/mermaid-parser/vite.config.ts && vite build --app --config packages/svg-renderer/vite.config.ts && vite build --app --config packages/ascii-renderer/vite.config.ts && vite build --app --config packages/mcp/vite.config.ts",
     "build:site": "rm -rf site && mkdir -p site && SITE_OUT_DIR=site scripts/tsx-css.sh packages/site/index.ts && SITE_OUT_DIR=site scripts/tsx-css.sh packages/site/editor.ts && SITE_OUT_DIR=site scripts/tsx-css.sh packages/site/fork-fixes.ts && SITE_OUT_DIR=site scripts/tsx-css.sh packages/site/pages.ts && SITE_OUT_DIR=site scripts/tsx-css.sh packages/site/blog.ts && SITE_OUT_DIR=site scripts/tsx-css.sh packages/site/dashboard.ts && cp -r public/* site/",
@@ -183,6 +192,9 @@
     "upstream:pr-candidates": "tsx scripts/list-upstream-pr-rescue-candidates.ts",
     "audit:responsive": "tsx scripts/audit-responsive.ts",
     "layout:oracle": "tsx scripts/layout-oracle.ts",
-    "label:oracle": "tsx scripts/label-position-oracle.ts"
+    "layout:scorecard": "tsx scripts/layout-oracle.ts --history=layout-fidelity-history.jsonl --scorecard=docs/layout-fidelity-scorecard.md && prettier --write docs/layout-fidelity-scorecard.md",
+    "label:oracle": "tsx scripts/label-position-oracle.ts",
+    "verify": "scripts/verify.sh",
+    "doctor": "scripts/doctor.sh"
   }
 }