@mermanjs/node 0.9.1 → 0.9.3

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 All notable changes to the `@mermanjs/node` package group will be documented in this file.
 
+## [0.9.3] - 2026-10-30
+
+- Sequence diagrams and GitGraph tag backgrounds resolve their diagram-scoped built-in Neo shadows. Sequence viewports include box-frame strokes and restored built-in Neo shadows to prevent clipping. [#255](https://github.com/Latias94/merman/pull/255)
+
+- Flowchart preserves percent-containing node IDs, and YAML frontmatter no longer mistakes brackets in comments or block text for nested collections. [#241](https://github.com/Latias94/merman/pull/241), [#251](https://github.com/Latias94/merman/pull/251)
+- `createNodeEngine({ iconPacks })` accepts already-loaded Iconify JSON for icons scoped to that engine. The application owns loading and credentials. [#247](https://github.com/Latias94/merman/pull/247)
+- Correct label sizing, configured fonts, literal text, and HTML/entity handling across SVG diagrams, including wrapped Swimlane edge labels and valid Class-note XML. Review updated output snapshots. [#245](https://github.com/Latias94/merman/pull/245), [#247](https://github.com/Latias94/merman/pull/247), [#250](https://github.com/Latias94/merman/pull/250)
+- Apply Gantt `tickInterval`, Mindmap root padding and width settings, and Sequence numbering, participant visibility, and note alignment. Init directives follow Mermaid 12.1.0's filtering and merge order. [#252](https://github.com/Latias94/merman/pull/252)
+- Refresh the native and WASM dependency graphs while retaining Mermaid 12.1.0, Options JSON schema 2, Node transport 1, and text-measurement protocol 1 with its 22 operations (0..21). The host literal-height extension (operation 22) is deferred; see the [host guide](../../docs/bindings/HOST_TEXT_MEASUREMENT.md) for callback limits. Native C/WASI SDK archives have separate APIs and capabilities; this package continues to provide its own SVG recipe. See the [workspace changelog](../../CHANGELOG.md). [#245](https://github.com/Latias94/merman/pull/245), [#247](https://github.com/Latias94/merman/pull/247)
+
+## [0.9.2] - 2026-10-22
+
+- Host themes keep C4 boundary contents and relationships visible, color Wardley anchors, and apply a coherent ZenUML palette. Diagram-selected Mermaid palettes retain matching text and fills. [#235](https://github.com/Latias94/merman/pull/235), [issue #229](https://github.com/Latias94/merman/issues/229), [issue #230](https://github.com/Latias94/merman/issues/230), [issue #231](https://github.com/Latias94/merman/issues/231), [issue #232](https://github.com/Latias94/merman/issues/232)
+- Look selectors and Block/Requirement source CSS are validated before SVG emission. SVG CSS cleanup rejects unterminated strings, comments, and URLs while preserving safe neighboring declarations. [#227](https://github.com/Latias94/merman/pull/227), [#235](https://github.com/Latias94/merman/pull/235), [#237](https://github.com/Latias94/merman/pull/237)
+- Repeated Flowchart `classDef` declarations retain earlier styles, and unsupported Unicode characters preserve valid error spans and lexer progress. Malformed Pie/Info headers and empty XYChart sources behave consistently across parser and editor entrypoints. [#178](https://github.com/Latias94/merman/pull/178), [#227](https://github.com/Latias94/merman/pull/227), [#237](https://github.com/Latias94/merman/pull/237)
+
+The existing Presentation and binding options contracts are unchanged. Review regenerated SVG and exported-image snapshots; see the [workspace changelog](../../CHANGELOG.md) for the complete maintenance release.
+
 ## [0.9.1] - 2026-10-18
 
 - ER diagram SVG emission reuses prepared entity geometry, avoiding false missing-size errors on larger diagrams.

package/README.md

@@ -89,5 +89,39 @@ or transport-admission checkpoint and reports Merman's typed cancellation detail
 Use `renderSvgSync()` only for an explicitly synchronous static-site build path. It refuses to run
 while asynchronous operations are active or queued.
 
+## Loaded icon packs (unreleased)
+
+Load Iconify pack JSON in the host and pass its text as a constructor service:
+
+```js
+import { readFile } from "node:fs/promises";
+import { createNodeEngine } from "@mermanjs/node";
+
+const json = await readFile("./icons.json", "utf8");
+const engine = await createNodeEngine({
+  iconPacks: [{ json, registrationName: "app" }],
+});
+try {
+  const svg = await engine.renderSvg('flowchart TD\nA@{ icon: "app:rocket", label: "Launch" }');
+  console.log(svg);
+} finally {
+  await engine.dispose();
+}
+```
+
+The example assumes the pack contains `rocket`. `json` must be the loaded JSON string.
+Omit `registrationName` to use the pack's prefix. A registered icon takes precedence over a
+matching built-in icon in that engine. Packs are admitted once into immutable engine-local
+state; changing the original array or rendering through another engine does not change it.
+Per-request options preserve the installed registry.
+
+`iconPacks` belongs to `CreateNodeEngineOptions`, separately from `bindingOptions`.
+An omitted value or `[]` retains ordinary rendering. The constructor performs no network or
+filesystem access. The fixed pack/content limits advertised by the `icon-registry` constructor
+contract apply across native and Node-WASM. Content failures retain
+`MermanOperationError.iconRegistryDetails`, and resource failures also retain
+`resourceDetails`. A failed constructor publishes no engine. Dispose engines when their build
+or request scope ends.
+
 See the [Node.js package guide](https://github.com/Latias94/merman/blob/main/platforms/node/README.md)
 for source-checkout development, package verification, and release design.