zombie-mermaid 5.11.2 → 5.12.0

package/README.md

@@ -30,7 +30,7 @@ Ultra-fast, fully themeable, zero DOM dependencies. A maintained fork of [`beaut
 
 `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 (54 fixes): 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 (55 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. Who maintains it, how releases are published, and what is claimed: [provenance and continuity](docs/provenance.md).
 
@@ -214,6 +214,7 @@ zombie-mermaid render diagram.mmd --ascii -o out.txt    # Write the ASCII render
 zombie-mermaid render diagram.mmd --html                # Self-contained pan/zoom HTML viewer
 zombie-mermaid render diagram.mmd --png                 # Rasterize to diagram.png
 cat diagram.mmd | zombie-mermaid render --ascii         # Read from stdin
+zombie-mermaid --check README.md docs/*.md              # Validate every mermaid block in Markdown; exit 1 with file:line diagnostics
 zombie-mermaid themes                                   # List built-in theme names
 zombie-mermaid --help                                   # Show all options
 ```

package/dist/cli.js

@@ -45,7 +45,7 @@ var T = {
 		label: "the PNG rasterization"
 	}
 }, E = Object.keys(T);
-function D(e, t) {
+function ee(e, t) {
 	let i = r(e);
 	return n({
 		dir: i.dir,
@@ -53,12 +53,21 @@ function D(e, t) {
 		ext: t
 	});
 }
-function O(e) {
+function D(e) {
 	let [t, ...n] = e;
 	if (t === void 0 || t === "--help" || t === "-h") return { command: "help" };
 	if (t === "--version" || t === "-v") return { command: "version" };
+	if (t === "--check") {
+		if (n.length === 0) throw Error("--check requires at least one Markdown file");
+		let e = n.find((e) => e.startsWith("-"));
+		if (e !== void 0) throw Error(`Unknown flag: ${e}`);
+		return {
+			command: "check",
+			files: n
+		};
+	}
 	if (t === "themes") return { command: "themes" };
-	if (t === "render") return M(n);
+	if (t === "render") return j(n);
 	if (t === "validate") {
 		let e = n.find((e, t) => t > 0 || e.startsWith("-"));
 		if (e !== void 0) throw Error(`Unexpected argument: ${e}`);
@@ -67,17 +76,17 @@ function O(e) {
 			input: n[0]
 		};
 	}
-	if (t === "web") return ee(n);
+	if (t === "web") return M(n);
 	if (t === "mcp") return { command: "mcp" };
 	throw Error(`Unknown command: ${t}`);
 }
-function k(e, t, n) {
+function O(e, t, n) {
 	let r = e[t + 1];
 	if (t + 1 >= e.length || r === void 0) throw Error(`${n} requires a numeric value`);
 	if (!/^\d+$/.test(r)) throw Error(`${n} requires a non-negative integer, got: "${r}"`);
 	return Number(r);
 }
-function A(e, t, n) {
+function k(e, t, n) {
 	let r = e[t + 1];
 	if (t + 1 >= e.length || r === void 0) throw Error(`${n} requires a value ("auto" or a positive integer)`);
 	if (r === "auto") return "auto";
@@ -85,14 +94,14 @@ function A(e, t, n) {
 	if (!/^\d+$/.test(r) || i === 0 || !Number.isSafeInteger(i)) throw Error(`${n} requires "auto" or a positive integer, got: "${r}"`);
 	return i;
 }
-function j(e, t, n) {
+function A(e, t, n) {
 	let r = e[t + 1];
 	if (t + 1 >= e.length || r === void 0) throw Error(`${n} requires a value (one of TD, TB, BT, LR, RL)`);
 	let i = r.toUpperCase();
 	if (!s(i)) throw Error(`${n} requires one of TD, TB, BT, LR, RL, got: "${r}"`);
 	return i;
 }
-function M(e) {
+function j(e) {
 	let t, n = !1, r = !1, i = !1, a = !1, o = !1, s, c = !1, l, u, d, f, p = !1, m = !1, h, g, _, v, y = 0;
 	for (; y < e.length;) {
 		let b = e[y];
@@ -109,12 +118,12 @@ function M(e) {
 		else if (b === "--theme") {
 			if (y + 1 >= e.length) throw Error("--theme requires a theme name");
 			l = e[y + 1], y += 2;
-		} else if (b === "-x" || b === "--paddingX") u = k(e, y, b), y += 2;
-		else if (b === "-y" || b === "--paddingY") d = k(e, y, b), y += 2;
-		else if (b === "-p" || b === "--borderPadding") f = k(e, y, b), y += 2;
+		} else if (b === "-x" || b === "--paddingX") u = O(e, y, b), y += 2;
+		else if (b === "-y" || b === "--paddingY") d = O(e, y, b), y += 2;
+		else if (b === "-p" || b === "--borderPadding") f = O(e, y, b), y += 2;
 		else if (b === "--coords") p = !0, y++;
 		else if (b === "--hyperlinks") m = !0, y++;
-		else if (b === "-w" || b === "--max-width") h = A(e, y, b), y += 2;
+		else if (b === "-w" || b === "--max-width") h = k(e, y, b), y += 2;
 		else if (b === "--profile") {
 			let t = e[y + 1];
 			if (t !== "markdown") throw Error(`--profile requires one of: markdown, got: "${t ?? ""}"`);
@@ -123,7 +132,7 @@ function M(e) {
 			let t = b.indexOf("="), n = t === -1 ? e[y + 1] : b.slice(t + 1);
 			if (n !== "mermaid" && n !== "mermaid-wide") throw Error(`--layout requires one of: mermaid, mermaid-wide, got: "${n ?? ""}"`);
 			_ = n, y += t === -1 ? 2 : 1;
-		} else if (b === "--direction") v = j(e, y, b), y += 2;
+		} else if (b === "--direction") v = A(e, y, b), y += 2;
 		else if (!b.startsWith("-") || b === "-") {
 			if (b === "-") throw Error("Unexpected argument: - (use -o - to write output to stdout; omit the input file to read stdin)");
 			if (t !== void 0) throw Error(`Unexpected argument: ${b} (input file already set to "${t}")`);
@@ -162,19 +171,19 @@ function M(e) {
 		}
 		throw Error("Specify --ascii, --svg, --html, and/or --png (or -o <path> with a .svg/.txt/.html/.png extension)");
 	}
-	let O = {
+	let D = {
 		svg: r,
 		html: a,
 		png: o
-	}, M = E.find((e) => O[e]);
-	if (s === "-" && n && M !== void 0) {
-		let e = T[M].display;
+	}, j = E.find((e) => D[e]);
+	if (s === "-" && n && j !== void 0) {
+		let e = T[j].display;
 		throw Error(`-o - would send both ASCII and ${e} to stdout; drop --ascii, or write the ${e} to a file path`);
 	}
-	if (M !== void 0 && s === void 0) {
-		let { flag: e, ext: n } = T[M];
+	if (j !== void 0 && s === void 0) {
+		let { flag: e, ext: n } = T[j];
 		if (t === void 0) throw Error(`${e} needs -o <path> (or -o - for stdout) when reading from stdin — there is no input file name to derive an output name from`);
-		s = D(t, n);
+		s = ee(t, n);
 	}
 	if (h !== void 0 && !n) throw Error("-w/--max-width requires --ascii");
 	if (g !== void 0 && !n) throw Error("--profile requires --ascii");
@@ -203,12 +212,12 @@ function M(e) {
 		direction: v
 	};
 }
-function ee(e) {
+function M(e) {
 	let t = S, n = 0;
 	for (; n < e.length;) {
 		let r = e[n];
 		if (r === void 0) throw Error(`parseArgs: index ${n} out of range while parsing arguments`);
-		if (r === "--port") t = k(e, n, r), n += 2;
+		if (r === "--port") t = O(e, n, r), n += 2;
 		else throw Error(`Unknown flag: ${r}`);
 	}
 	return {
@@ -456,8 +465,47 @@ async function Y() {
 	});
 }
 //#endregion
+//#region src/cli/check.ts
+var he = /^ {0,3}(`{3,}|~{3,})\s*mermaid\b[^`]*$/i, ge = /^ {0,3}(`+|~+)\s*$/;
+function _e(e, t) {
+	let n = ge.exec(e)?.[1];
+	return !!n && n[0] === t[0] && n.length >= t.length;
+}
+function ve(e) {
+	let t = e.split(/\r?\n/), n = [];
+	for (let e = 0; e < t.length; e++) {
+		let r = he.exec(t[e]);
+		if (!r) continue;
+		let i = r[1], a = [], o = e + 1;
+		for (; o < t.length && !_e(t[o], i);) a.push(t[o++]);
+		n.push({
+			startLine: e + 2,
+			source: a.join("\n")
+		}), e = o;
+	}
+	return n;
+}
+async function ye(e) {
+	let t = 0, n = 0;
+	for (let r of e.files) {
+		let e = await u(r, "utf-8");
+		for (let i of ve(e)) {
+			n++;
+			try {
+				g(i.source);
+			} catch (e) {
+				t++;
+				let n = N(e, i.source), a = i.startLine + (n ? n.line - 1 : 0), o = n ? n.message : e instanceof Error ? e.message : String(e);
+				console.error(`${r}:${a}: ${o}`), n && console.error(`  ${a} | ${n.sourceLine}`);
+			}
+		}
+	}
+	if (t > 0) throw Error(`${t} of ${n} Mermaid block(s) invalid`);
+	console.log(`${n} Mermaid block(s) valid`);
+}
+//#endregion
 //#region src/cli/validate.ts
-async function he(e, t) {
+async function be(e, t) {
 	let n;
 	if (e.input !== void 0) n = await u(e.input, "utf-8");
 	else if (t !== void 0) n = t;
@@ -476,12 +524,12 @@ async function he(e, t) {
 }
 //#endregion
 //#region src/cli/web.ts
-var ge = 1e6;
-function _e(e) {
+var xe = 1e6;
+function Se(e) {
 	return new Promise((t, n) => {
 		let r = [], i = 0;
 		e.on("data", (t) => {
-			if (i += t.length, i > ge) {
+			if (i += t.length, i > xe) {
 				n(/* @__PURE__ */ Error("Request body too large")), e.destroy();
 				return;
 			}
@@ -492,7 +540,7 @@ function _e(e) {
 function X(e) {
 	return typeof e == "object" && !!e;
 }
-function ve(e) {
+function Z(e) {
 	let t;
 	try {
 		t = JSON.parse(e);
@@ -507,80 +555,80 @@ function ve(e) {
 		format: t.format === "svg" ? "svg" : "ascii"
 	};
 }
-function Z(e, t, n) {
+function Q(e, t, n) {
 	let r = JSON.stringify(n);
 	e.writeHead(t, {
 		"Content-Type": "application/json; charset=utf-8",
 		"Content-Length": Buffer.byteLength(r)
 	}), e.end(r);
 }
-async function ye(e, t) {
+async function Ce(e, t) {
 	try {
-		let { source: n, format: r } = ve(await _e(e));
-		Z(t, 200, {
+		let { source: n, format: r } = Z(await Se(e));
+		Q(t, 200, {
 			output: r === "svg" ? h(n) : p(n),
 			format: r
 		});
 	} catch (e) {
-		Z(t, 400, { error: e instanceof Error ? e.message : String(e) });
+		Q(t, 400, { error: e instanceof Error ? e.message : String(e) });
 	}
 }
-var be = "<!doctype html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\" />\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n<title>zombie-mermaid</title>\n<style>\n  body { font-family: system-ui, sans-serif; margin: 2rem; max-width: 900px; }\n  h1 { font-size: 1.25rem; }\n  textarea { width: 100%; height: 200px; font-family: monospace; font-size: 14px; box-sizing: border-box; }\n  pre { white-space: pre; overflow: auto; background: #111; color: #eee; padding: 1rem; border-radius: 4px; }\n  .row { display: flex; gap: 1rem; align-items: center; margin: 0.75rem 0; }\n  #error { color: #c00; white-space: pre-wrap; }\n  #output svg { max-width: 100%; }\n</style>\n</head>\n<body>\n<h1>zombie-mermaid</h1>\n<textarea id=\"source\" placeholder=\"graph LR\n  A --> B\">graph LR\n  A --> B --> C</textarea>\n<div class=\"row\">\n  <label><input type=\"radio\" name=\"format\" value=\"ascii\" checked /> ASCII</label>\n  <label><input type=\"radio\" name=\"format\" value=\"svg\" /> SVG</label>\n  <button id=\"render\" type=\"button\">Render</button>\n</div>\n<div id=\"error\"></div>\n<div id=\"output\"></div>\n<script>\n  const sourceEl = document.getElementById('source')\n  const outputEl = document.getElementById('output')\n  const errorEl = document.getElementById('error')\n\n  async function render() {\n    errorEl.textContent = ''\n    outputEl.innerHTML = ''\n    const formatInput = document.querySelector('input[name=\"format\"]:checked')\n    const format = formatInput ? formatInput.value : 'ascii'\n    try {\n      const res = await fetch('/render', {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ source: sourceEl.value, format }),\n      })\n      const data = await res.json()\n      if (!res.ok) {\n        errorEl.textContent = data.error || 'Render failed'\n        return\n      }\n      if (format === 'svg') {\n        outputEl.innerHTML = data.output\n      } else {\n        const pre = document.createElement('pre')\n        pre.textContent = data.output\n        outputEl.appendChild(pre)\n      }\n    } catch (err) {\n      errorEl.textContent = String(err)\n    }\n  }\n\n  document.getElementById('render').addEventListener('click', render)\n<\/script>\n</body>\n</html>\n";
-function xe() {
+var we = "<!doctype html>\n<html lang=\"en\">\n<head>\n<meta charset=\"utf-8\" />\n<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\" />\n<title>zombie-mermaid</title>\n<style>\n  body { font-family: system-ui, sans-serif; margin: 2rem; max-width: 900px; }\n  h1 { font-size: 1.25rem; }\n  textarea { width: 100%; height: 200px; font-family: monospace; font-size: 14px; box-sizing: border-box; }\n  pre { white-space: pre; overflow: auto; background: #111; color: #eee; padding: 1rem; border-radius: 4px; }\n  .row { display: flex; gap: 1rem; align-items: center; margin: 0.75rem 0; }\n  #error { color: #c00; white-space: pre-wrap; }\n  #output svg { max-width: 100%; }\n</style>\n</head>\n<body>\n<h1>zombie-mermaid</h1>\n<textarea id=\"source\" placeholder=\"graph LR\n  A --> B\">graph LR\n  A --> B --> C</textarea>\n<div class=\"row\">\n  <label><input type=\"radio\" name=\"format\" value=\"ascii\" checked /> ASCII</label>\n  <label><input type=\"radio\" name=\"format\" value=\"svg\" /> SVG</label>\n  <button id=\"render\" type=\"button\">Render</button>\n</div>\n<div id=\"error\"></div>\n<div id=\"output\"></div>\n<script>\n  const sourceEl = document.getElementById('source')\n  const outputEl = document.getElementById('output')\n  const errorEl = document.getElementById('error')\n\n  async function render() {\n    errorEl.textContent = ''\n    outputEl.innerHTML = ''\n    const formatInput = document.querySelector('input[name=\"format\"]:checked')\n    const format = formatInput ? formatInput.value : 'ascii'\n    try {\n      const res = await fetch('/render', {\n        method: 'POST',\n        headers: { 'Content-Type': 'application/json' },\n        body: JSON.stringify({ source: sourceEl.value, format }),\n      })\n      const data = await res.json()\n      if (!res.ok) {\n        errorEl.textContent = data.error || 'Render failed'\n        return\n      }\n      if (format === 'svg') {\n        outputEl.innerHTML = data.output\n      } else {\n        const pre = document.createElement('pre')\n        pre.textContent = data.output\n        outputEl.appendChild(pre)\n      }\n    } catch (err) {\n      errorEl.textContent = String(err)\n    }\n  }\n\n  document.getElementById('render').addEventListener('click', render)\n<\/script>\n</body>\n</html>\n";
+function Te() {
 	return v((e, t) => {
 		let n = (e.url ?? "/").split("?")[0];
 		if (e.method === "GET" && (n === "/" || n === "")) {
-			t.writeHead(200, { "Content-Type": "text/html; charset=utf-8" }), t.end(be);
+			t.writeHead(200, { "Content-Type": "text/html; charset=utf-8" }), t.end(we);
 			return;
 		}
 		if (e.method === "POST" && n === "/render") {
-			ye(e, t);
+			Ce(e, t);
 			return;
 		}
 		t.writeHead(404, { "Content-Type": "text/plain; charset=utf-8" }), t.end("Not found");
 	});
 }
-function Se(e) {
+function Ee(e) {
 	return new Promise((t, n) => {
-		let r = xe();
+		let r = Te();
 		r.once("error", n), r.listen(e, "127.0.0.1", () => {
 			r.removeListener("error", n), t(r);
 		});
 	});
 }
-async function Ce(e, t = console.log) {
-	let n = await Se(e.port), r = n.address();
+async function De(e, t = console.log) {
+	let n = await Ee(e.port), r = n.address();
 	return t(`zombie-mermaid web running at http://localhost:${X(r) && typeof r.port == "number" ? r.port : e.port}`), n;
 }
 //#endregion
 //#region src/cli/mcp.ts
-async function we(e = (e) => console.error(e)) {
+async function Oe(e = (e) => console.error(e)) {
 	let t = b(), n = new y();
 	return await t.connect(n), e("zombie-mermaid MCP server running on stdio (experimental — feedback welcome: https://github.com/dfadler/zombie-mermaid/issues)"), t;
 }
 //#endregion
 //#region src/package-info.ts
-function Q() {
+function ke() {
 	let t = e(import.meta.url)("../package.json");
 	return typeof t == "object" && t && "version" in t && typeof t.version == "string" ? t.version : "unknown";
 }
 //#endregion
 //#region src/cli.ts
 m(x);
-var Te = Q();
+var Ae = ke();
 async function $() {
 	let e = process.argv.slice(2), t;
 	try {
-		t = O(e);
+		t = D(e);
 	} catch (e) {
 		console.error(`Error: ${e instanceof Error ? e.message : String(e)}`), process.exit(1);
 	}
 	switch (t.command) {
 		case "help":
-			Ee();
+			je();
 			break;
 		case "version":
-			console.log(`zombie-mermaid ${Te}`);
+			console.log(`zombie-mermaid ${Ae}`);
 			break;
 		case "themes":
 			console.log("Available themes:\n");
@@ -595,27 +643,34 @@ async function $() {
 			break;
 		case "validate":
 			try {
-				await he(t);
+				await be(t);
+			} catch (e) {
+				console.error(`Error: ${e instanceof Error ? e.message : String(e)}`), process.exit(1);
+			}
+			break;
+		case "check":
+			try {
+				await ye(t);
 			} catch (e) {
 				console.error(`Error: ${e instanceof Error ? e.message : String(e)}`), process.exit(1);
 			}
 			break;
 		case "web":
 			try {
-				await Ce(t);
+				await De(t);
 			} catch (e) {
 				console.error(`Error: ${e instanceof Error ? e.message : String(e)}`), process.exit(1);
 			}
 			break;
 		case "mcp": try {
-			await we();
+			await Oe();
 		} catch (e) {
 			console.error(`Error: ${e instanceof Error ? e.message : String(e)}`), process.exit(1);
 		}
 	}
 }
-function Ee() {
-	console.log("zombie-mermaid — render Mermaid diagrams from the command line\n\nUsage:\n  zombie-mermaid render <file> --ascii              Render to ASCII in terminal\n  zombie-mermaid render <file> --svg                Render to <file stem>.svg\n  zombie-mermaid render <file> --svg -o <out.svg>   Render to a named SVG file\n  zombie-mermaid render <file> -o out.svg           Format inferred from the extension\n  zombie-mermaid render <file> --svg -o -           Write SVG to stdout\n  zombie-mermaid render <file> --ascii --svg -o <out.svg>   Both (ASCII to terminal)\n  zombie-mermaid render <file> --html               Self-contained pan/zoom HTML viewer\n  zombie-mermaid render <file> --png                Rasterize to <file stem>.png\n  cat file.mmd | zombie-mermaid render --ascii      Read from stdin\n  zombie-mermaid validate [file]                    Parse only; exit 1 with line diagnostics if invalid\n  zombie-mermaid themes                             List available themes\n  zombie-mermaid web [--port <n>]                   Start a local web UI (default port: 3000)\n  zombie-mermaid mcp                                Start an MCP server on stdio (render tools)\n  zombie-mermaid --help                             Show this help\n  zombie-mermaid --version                          Show version\n\nOptions:\n  --ascii              Print ASCII/Unicode diagram to terminal, or to -o <file.txt>\n                       when it is the only format\n  --svg                Render SVG to -o <path> (default: <input stem>.svg;\n                       stdin input must give -o)\n  --resolve-colors     Replace CSS var()/color-mix() in the SVG with computed\n                       sRGB values, for rasterizers and other non-browser SVG\n                       consumers (resvg, librsvg, Inkscape) that don't\n                       evaluate them. The default output stays a live function\n                       of its CSS variables. Requires --svg.\n  --html               Render a self-contained HTML pan/zoom viewer to -o\n                       <path> (default: <input stem>.html). Embeds the SVG;\n                       no server, no network, opens from disk. Cannot be\n                       combined with --svg/--png (different content, same\n                       slot).\n  --png                Rasterize to PNG at -o <path> (default: <input\n                       stem>.png), via the optional @resvg/resvg-js native\n                       dependency — install it with `pnpm add\n                       @resvg/resvg-js` if it's missing. Always resolves\n                       CSS var()/color-mix() first (as --resolve-colors\n                       does for --svg), since a rasterizer can't evaluate\n                       them. 1:1 with the SVG's own pixel size, no scaling.\n                       Cannot be combined with --svg/--html.\n  -o, --output <path>  Output file for the SVG/HTML/PNG (or for ASCII when\n                       none of those is given). '-' writes to stdout. A\n                       .svg, .html, .txt, or .png extension selects the\n                       format when no --svg/--html/--png/--ascii flag is\n                       given; one that contradicts the flags is an error.\n                       Existing files are never overwritten without --force.\n  -f, --force          Overwrite an existing output file\n  --theme <name>       Apply a built-in theme (see 'themes' command)\n  --direction <dir>    Override the diagram's layout direction: TD, TB, BT, LR, or RL\n                       (flowchart, state, and ER diagrams; nested subgraph\n                       directions still apply on top of it)\n  -x, --paddingX <n>   Horizontal spacing between nodes (ASCII, default: 5)\n  -y, --paddingY <n>   Vertical spacing between nodes (ASCII, default: 5; LR/RL sibling gap is n-1, min 1)\n  -p, --borderPadding <n>  Padding inside node boxes (ASCII, default: 1)\n  --coords             Overlay row/column index rulers (ASCII, debug layout)\n  --hyperlinks         Emit OSC 8 terminal hyperlinks for `click` hrefs\n                       (ASCII). Off by default: terminal support varies —\n                       iTerm2, WezTerm, kitty, Windows Terminal, and\n                       VTE-based terminals render them as clickable links;\n                       others may show the URL or nothing. Pagers need\n                       OSC 8 support too (`less -R`, recent versions).\n  --profile <name>     ASCII preset: 'markdown' = plain ASCII characters, no\n                       color, for pasting into issues/commits/fenced blocks\n                       (explicit flags like --coords still win). Requires\n                       --ascii.\n  -w, --max-width <n|auto>  Fit ASCII output within this many columns\n                       ('auto' detects the terminal width): applies compact\n                       spacing automatically when needed, and warns on\n                       stderr if it still doesn't fit (no label wrapping or\n                       direction-flip — see issue #335).\n  --layout mermaid     Opt in (flowcharts, --ascii): draw mermaid's own ELK layout\n                       instead of the grid renderer. Subgraphs, some shapes,\n                       other diagram types, layout failures and drawings that\n                       cannot fit 120 columns (or -w <n>, used as the cap)\n                       fall back to the default renderer; stderr says which\n                       one ran. --layout mermaid-wide drops the cap and always\n                       draws the (possibly wide) layout-faithful text. Merged\n                       parallel edges hide edge multiplicity. Depends on\n                       mermaid 12.1.0 + elkjs 0.9.3: install the optional peer\n                       with `pnpm add elkjs-0.9.3@npm:elkjs@0.9.3`. -x/-y/-p\n                       and --coords do not apply to the layout-faithful drawing.\n  --port <n>           Port for the 'web' command (default: 3000)\n  -h, --help           Show help\n  -v, --version        Show version");
+function je() {
+	console.log("zombie-mermaid — render Mermaid diagrams from the command line\n\nUsage:\n  zombie-mermaid render <file> --ascii              Render to ASCII in terminal\n  zombie-mermaid render <file> --svg                Render to <file stem>.svg\n  zombie-mermaid render <file> --svg -o <out.svg>   Render to a named SVG file\n  zombie-mermaid render <file> -o out.svg           Format inferred from the extension\n  zombie-mermaid render <file> --svg -o -           Write SVG to stdout\n  zombie-mermaid render <file> --ascii --svg -o <out.svg>   Both (ASCII to terminal)\n  zombie-mermaid render <file> --html               Self-contained pan/zoom HTML viewer\n  zombie-mermaid render <file> --png                Rasterize to <file stem>.png\n  cat file.mmd | zombie-mermaid render --ascii      Read from stdin\n  zombie-mermaid validate [file]                    Parse only; exit 1 with line diagnostics if invalid\n  zombie-mermaid --check <file.md>...               Validate every mermaid fenced block in Markdown; exit 1 with file:line diagnostics\n  zombie-mermaid themes                             List available themes\n  zombie-mermaid web [--port <n>]                   Start a local web UI (default port: 3000)\n  zombie-mermaid mcp                                Start an MCP server on stdio (render tools)\n  zombie-mermaid --help                             Show this help\n  zombie-mermaid --version                          Show version\n\nOptions:\n  --ascii              Print ASCII/Unicode diagram to terminal, or to -o <file.txt>\n                       when it is the only format\n  --svg                Render SVG to -o <path> (default: <input stem>.svg;\n                       stdin input must give -o)\n  --resolve-colors     Replace CSS var()/color-mix() in the SVG with computed\n                       sRGB values, for rasterizers and other non-browser SVG\n                       consumers (resvg, librsvg, Inkscape) that don't\n                       evaluate them. The default output stays a live function\n                       of its CSS variables. Requires --svg.\n  --html               Render a self-contained HTML pan/zoom viewer to -o\n                       <path> (default: <input stem>.html). Embeds the SVG;\n                       no server, no network, opens from disk. Cannot be\n                       combined with --svg/--png (different content, same\n                       slot).\n  --png                Rasterize to PNG at -o <path> (default: <input\n                       stem>.png), via the optional @resvg/resvg-js native\n                       dependency — install it with `pnpm add\n                       @resvg/resvg-js` if it's missing. Always resolves\n                       CSS var()/color-mix() first (as --resolve-colors\n                       does for --svg), since a rasterizer can't evaluate\n                       them. 1:1 with the SVG's own pixel size, no scaling.\n                       Cannot be combined with --svg/--html.\n  -o, --output <path>  Output file for the SVG/HTML/PNG (or for ASCII when\n                       none of those is given). '-' writes to stdout. A\n                       .svg, .html, .txt, or .png extension selects the\n                       format when no --svg/--html/--png/--ascii flag is\n                       given; one that contradicts the flags is an error.\n                       Existing files are never overwritten without --force.\n  -f, --force          Overwrite an existing output file\n  --theme <name>       Apply a built-in theme (see 'themes' command)\n  --direction <dir>    Override the diagram's layout direction: TD, TB, BT, LR, or RL\n                       (flowchart, state, and ER diagrams; nested subgraph\n                       directions still apply on top of it)\n  -x, --paddingX <n>   Horizontal spacing between nodes (ASCII, default: 5)\n  -y, --paddingY <n>   Vertical spacing between nodes (ASCII, default: 5; LR/RL sibling gap is n-1, min 1)\n  -p, --borderPadding <n>  Padding inside node boxes (ASCII, default: 1)\n  --coords             Overlay row/column index rulers (ASCII, debug layout)\n  --hyperlinks         Emit OSC 8 terminal hyperlinks for `click` hrefs\n                       (ASCII). Off by default: terminal support varies —\n                       iTerm2, WezTerm, kitty, Windows Terminal, and\n                       VTE-based terminals render them as clickable links;\n                       others may show the URL or nothing. Pagers need\n                       OSC 8 support too (`less -R`, recent versions).\n  --profile <name>     ASCII preset: 'markdown' = plain ASCII characters, no\n                       color, for pasting into issues/commits/fenced blocks\n                       (explicit flags like --coords still win). Requires\n                       --ascii.\n  -w, --max-width <n|auto>  Fit ASCII output within this many columns\n                       ('auto' detects the terminal width): applies compact\n                       spacing automatically when needed, and warns on\n                       stderr if it still doesn't fit (no label wrapping or\n                       direction-flip — see issue #335).\n  --layout mermaid     Opt in (flowcharts, --ascii): draw mermaid's own ELK layout\n                       instead of the grid renderer. Subgraphs, some shapes,\n                       other diagram types, layout failures and drawings that\n                       cannot fit 120 columns (or -w <n>, used as the cap)\n                       fall back to the default renderer; stderr says which\n                       one ran. --layout mermaid-wide drops the cap and always\n                       draws the (possibly wide) layout-faithful text. Merged\n                       parallel edges hide edge multiplicity. Depends on\n                       mermaid 12.1.0 + elkjs 0.9.3: install the optional peer\n                       with `pnpm add elkjs-0.9.3@npm:elkjs@0.9.3`. -x/-y/-p\n                       and --coords do not apply to the layout-faithful drawing.\n  --port <n>           Port for the 'web' command (default: 3000)\n  -h, --help           Show help\n  -v, --version        Show version");
 }
 $();
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zombie-mermaid",
-  "version": "5.11.2",
+  "version": "5.12.0",
   "license": "MIT",
   "mcpName": "io.github.dfadler/zombie-mermaid",
   "description": "Render Mermaid diagrams as beautiful SVGs or ASCII art. Ultra-fast, fully themeable, zero DOM dependencies. Maintained fork of beautiful-mermaid.",
@@ -115,11 +115,11 @@
     "@modelcontextprotocol/sdk": "^1.32.1",
     "elkjs": "^0.12.0",
     "entities": "^7.0.1",
-    "@zombie-mermaid/ascii-renderer": "5.11.2",
-    "@zombie-mermaid/core": "5.11.2",
-    "@zombie-mermaid/mermaid-parser": "5.11.2",
-    "@zombie-mermaid/svg-renderer": "5.11.2",
-    "@zombie-mermaid/mcp": "5.11.2"
+    "@zombie-mermaid/ascii-renderer": "5.12.0",
+    "@zombie-mermaid/core": "5.12.0",
+    "@zombie-mermaid/mcp": "5.12.0",
+    "@zombie-mermaid/mermaid-parser": "5.12.0",
+    "@zombie-mermaid/svg-renderer": "5.12.0"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "0.18.5",
@@ -213,6 +213,7 @@
     "generate:logo-lockup": "tsx scripts/generate-logo-lockup.ts",
     "api:report": "tsx scripts/api-report.ts",
     "mutation": "stryker run",
+    "docs:llms": "tsx scripts/generate-llms-full.ts",
     "docs:scripts": "tsx scripts/generate-development-scripts-doc.ts && oxfmt docs/development-scripts.md",
     "badge:bundle-size": "tsx scripts/generate-bundle-badge.ts",
     "visual-diff": "tsx scripts/visual-diff.ts",