zombie-mermaid 3.0.0 → 3.1.0

package/README.md

@@ -18,7 +18,7 @@ Ultra-fast, fully themeable, zero DOM dependencies. A maintained fork of [`beaut
 [![CI](https://github.com/dfadler/zombie-mermaid/actions/workflows/ci.yml/badge.svg)](https://github.com/dfadler/zombie-mermaid/actions/workflows/ci.yml)
 [![codecov](https://codecov.io/gh/dfadler/zombie-mermaid/branch/main/graph/badge.svg)](https://codecov.io/gh/dfadler/zombie-mermaid)
 [![Bundle Size](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/dfadler/zombie-mermaid/main/badges/bundle-size.json)](#bundle-size)
-[![Socket Security](https://socket.dev/api/badge/npm/package/zombie-mermaid)](https://socket.dev/npm/package/zombie-mermaid)
+[![Socket Security](https://badge.socket.dev/npm/package/zombie-mermaid)](https://socket.dev/npm/package/zombie-mermaid)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
 
 </div>
@@ -47,9 +47,12 @@ Diagrams are essential for AI-assisted programming. When you're working with an
 ### Bundle Size
 
 The **Bundle Size** badge above tracks the gzipped size of `zombie-mermaid`'s
-main entry point (`dist/index.js`) and updates automatically with every
-release — the same badge/CI-tracked pattern already backing the coverage and
-CI status badges. Need ASCII rendering only? `import { renderMermaidASCII }
+main entry point (`dist/index.js`) together with the `@zombie-mermaid/*`
+workspace packages it imports (third-party dependencies such as ELK.js are not
+counted), and updates automatically with every release — the same
+badge/CI-tracked pattern already backing the coverage and CI status badges.
+The standalone renderer packages under [Packages](#packages) get the same
+measurement for their own dependency closure. Need ASCII rendering only? `import { renderMermaidASCII }
 from 'zombie-mermaid/ascii'` skips [ELK.js](https://github.com/kieler/elkjs),
 the layout engine the SVG renderer depends on, for a substantially smaller
 bundle.
@@ -77,6 +80,8 @@ bun add zombie-mermaid
 pnpm add zombie-mermaid
 ```
 
+Only need one output format? `@zombie-mermaid/ascii-renderer` and `@zombie-mermaid/svg-renderer` are published standalone — see [Packages](#packages) below.
+
 ## Quick Start
 
 ### SVG Output
@@ -163,7 +168,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 four tools: `render_mermaid_svg`, `render_mermaid_ascii`, `check_mermaid_sequence_activations`, and `fix_mermaid_sequence_activations`. 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 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.
 
 Example Claude Desktop / Claude Code MCP server config:
 
@@ -212,6 +217,20 @@ the package.
 
 ---
 
+## Packages
+
+This repo is a pnpm-workspace monorepo. Most consumers only need the umbrella `zombie-mermaid` package above; internally it's built from workspace packages under `packages/`, all published under the `@zombie-mermaid` npm scope and version-locked with it:
+
+- **[`@zombie-mermaid/ascii-renderer`](packages/ascii-renderer)** — the ASCII/Unicode renderer, published standalone for anyone who wants terminal output without `svg-renderer`'s `elkjs` dependency. The exact code `zombie-mermaid/ascii` re-exports.  
+  [![npm](https://img.shields.io/npm/v/@zombie-mermaid/ascii-renderer.svg)](https://www.npmjs.com/package/@zombie-mermaid/ascii-renderer) [![gzip size](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/dfadler/zombie-mermaid/main/badges/bundle-size-ascii-renderer.json)](#bundle-size)
+- **[`@zombie-mermaid/svg-renderer`](packages/svg-renderer)** — the ELK.js-backed SVG layout and rendering engine, also published standalone.  
+  [![npm](https://img.shields.io/npm/v/@zombie-mermaid/svg-renderer.svg)](https://www.npmjs.com/package/@zombie-mermaid/svg-renderer) [![gzip size](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/dfadler/zombie-mermaid/main/badges/bundle-size-svg-renderer.json)](#bundle-size)
+- `@zombie-mermaid/core`, `@zombie-mermaid/mermaid-parser`, `@zombie-mermaid/mcp` — shared types/theming, the diagram parsers, and the MCP server implementation, respectively. Published under the scope (so the names can't be squatted) and version-locked with the rest, but internal-only: no standalone support commitment beyond backing the umbrella and the two renderer packages above.
+
+See [docs/decisions/monorepo-conversion.md](docs/decisions/monorepo-conversion.md) for the full package-split and publish-strategy history.
+
+---
+
 ## 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)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zombie-mermaid",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "license": "MIT",
   "description": "Render Mermaid diagrams as beautiful SVGs or ASCII art. Ultra-fast, fully themeable, zero DOM dependencies. Maintained fork of beautiful-mermaid.",
   "type": "module",
@@ -90,11 +90,11 @@
     "@modelcontextprotocol/sdk": "^1.30.0",
     "elkjs": "^0.11.0",
     "entities": "^7.0.1",
-    "@zombie-mermaid/ascii-renderer": "3.0.0",
-    "@zombie-mermaid/core": "3.0.0",
-    "@zombie-mermaid/mcp": "3.0.0",
-    "@zombie-mermaid/mermaid-parser": "3.0.0",
-    "@zombie-mermaid/svg-renderer": "3.0.0"
+    "@zombie-mermaid/ascii-renderer": "3.1.0",
+    "@zombie-mermaid/core": "3.1.0",
+    "@zombie-mermaid/svg-renderer": "3.1.0",
+    "@zombie-mermaid/mermaid-parser": "3.1.0",
+    "@zombie-mermaid/mcp": "3.1.0"
   },
   "devDependencies": {
     "@changesets/changelog-github": "^1.0.0",

package/src/__tests__/integration.test.ts

@@ -293,6 +293,33 @@ describe('renderMermaidSVG – custom class names on rendered elements', () => {
     expect(svg).toContain('<g class="node highlight" data-id="B"')
   })
 
+  // Upstream lukilabs/beautiful-mermaid#81: a className with no matching
+  // classDef must still reach the `class` attribute so consumers can style it
+  // with their own CSS.
+  it('emits class names from `:::` and `class X name` even with no classDef', () => {
+    const svg = renderMermaidSVG(`graph LR
+    A[Start]:::foo --> B[End]
+    A --> C[Other]
+    class B bar`)
+    expect(svg).toContain('<g class="node foo" data-id="A"')
+    expect(svg).toContain('<g class="node bar" data-id="B"')
+    expect(svg).toContain('<g class="node" data-id="C"')
+  })
+
+  it('drops class names that are not valid CSS identifiers instead of emitting them', () => {
+    const svg = renderMermaidSVG(`graph LR
+    A --> B
+    A --> C
+    class A 1bad
+    class B foo.bar
+    class C ok_name`)
+    expect(svg).toContain('<g class="node" data-id="A"')
+    expect(svg).toContain('<g class="node" data-id="B"')
+    expect(svg).toContain('<g class="node ok_name" data-id="C"')
+    expect(svg).not.toContain('1bad')
+    expect(svg).not.toContain('foo.bar')
+  })
+
   it('renders only the base class when no custom class is assigned (no regression)', () => {
     const svg = renderMermaidSVG('graph LR\n  A[Start] --> B[End]')
     expect(svg).toContain('<g class="node" data-id="A"')

package/src/__tests__/interactivity-config.test.ts

@@ -163,7 +163,10 @@ describe('edge curve styles (#198 row 9)', () => {
    * diagram traces the path Mermaid would draw, so an approximation that
    * merely looks smooth is still wrong. These values were taken from
    * d3-shape 3.2.0's own `curveBasis` output for the same points — d3
-   * serializes at 3 decimals, hence the rounding.
+   * serializes at 3 decimals; `pointsToPath` itself now rounds every
+   * coordinate to 2 decimals via the `f` tagged template (ported from
+   * lukilabs/beautiful-mermaid#77), so the expected values below are d3's
+   * reference geometry rounded to that same coarser precision.
    *
    * An earlier implementation led in at the midpoint `(p0 + p1) / 2` and
    * emitted a single cubic ending at `(p1 + p2) / 2`; it satisfied every
@@ -172,15 +175,15 @@ describe('edge curve styles (#198 row 9)', () => {
   it('matches d3 curveBasis geometry exactly', () => {
     const round = (d: string) =>
       (d.match(/[MLC]|-?\d+(?:\.\d+)?/g) ?? []).map((t) =>
-        /[MLC]/.test(t) ? t : +(+t).toFixed(3),
+        /[MLC]/.test(t) ? t : +(+t).toFixed(2),
       )
 
     // prettier-ignore
     expect(round(pointsToPath(points, 'basis'))).toEqual([
       'M', 0, 0,
-      'L', 1.667, 1.667,
-      'C', 3.333, 3.333, 6.667, 6.667, 10, 6.667,
-      'C', 13.333, 6.667, 16.667, 3.333, 18.333, 1.667,
+      'L', 1.67, 1.67,
+      'C', 3.33, 3.33, 6.67, 6.67, 10, 6.67,
+      'C', 13.33, 6.67, 16.67, 3.33, 18.33, 1.67,
       'L', 20, 0,
     ])
   })