@danielsimonjr/sciengjs 0.1.1 → 0.2.0

package/README.md

@@ -10,14 +10,16 @@ sciengjs turns diagram source into images on your own machine. It sends no sourc
 
 ## What this release does
 
-Release 0.1.0 holds the first input type: **Graphviz DOT**.
+Release 0.2.0 holds two input types: **Graphviz DOT** and **Mermaid** (class, state and sequence diagrams).
 
 | Input | Output | Engine |
 |---|---|---|
 | DOT | SVG | Graphviz 16.1.0, compiled to WASM (`@viz-js/viz`) |
 | DOT | PNG | Graphviz, then resvg compiled to WASM (`@resvg/resvg-wasm`), with a bundled font |
+| Mermaid (class, state, sequence) | SVG | The engine's own parsers and layouts. Class and state diagrams go through Graphviz. |
+| Mermaid (class, state, sequence) | PNG | The same SVG, then resvg compiled to WASM (`@resvg/resvg-wasm`), with a bundled font |
 
-- **No network.** The DOT path makes no network request.
+- **No network.** The DOT and Mermaid paths make no network request.
 - **Unsafe attributes are removed.** The engine removes each `image` and `stylesheet` attribute before the layout and gives a warning for each one. A DOT file cannot make the engine or a browser fetch a file or a URL. A `URL` attribute stays as a link in the SVG.
 - **The same text on every machine.** PNG text uses the bundled Liberation Serif font, not the fonts of the host. The engine gives a warning when the drawing asks for bold, italic or a character that the font does not have.
 - **Limits.** Each render has a time limit, a source size limit and a heap limit. A PNG has a pixel limit of 1024 MB.
@@ -137,6 +139,19 @@ const png = await svgToPng(svg, { scale: 1, maxMemoryMb: 512 });
 
 A subpath call runs in the calling thread, without the worker and its limits. Use `render` for input that you do not trust.
 
+## Mermaid
+
+The `mermaid` input draws class, state and sequence diagrams without a browser. A line outside the grammar rejects the render with `E_INPUT`, and the message names the line. Set `lenient` to `true` to skip such a line and get a warning instead.
+
+```js
+import { render } from "@danielsimonjr/sciengjs";
+
+const source = "sequenceDiagram\nAlice->>Bob: Hello Bob\nBob-->>Alice: Hi Alice";
+const { bytes, warnings } = await render({ type: "mermaid", source, format: "svg" }, {});
+```
+
+Other Mermaid diagram types reject with `E_UNSUPPORTED`.
+
 ## Roadmap
 
 The [build plan](docs/superpowers/plans/2026-11-01-scieng-engine-build.md) gives the order of the increments. Each increment adds one input type, its tests and one release. The [design](docs/superpowers/specs/2026-11-01-scieng-engine-design.md) gives the API, the stages, the security controls and the licence of each engine.
@@ -144,7 +159,7 @@ The [build plan](docs/superpowers/plans/2026-11-01-scieng-engine-build.md) gives
 | Input type | Stage | Status |
 |---|---|---|
 | DOT | graph, raster | released in 0.1.0 |
-| Mermaid | mermaid, browser | planned |
+| Mermaid | graph, mermaid, browser | class, state and sequence: released in 0.2.0; other types: planned |
 | LaTeX math | math (MathJax) | planned |
 | TikZ, circuitikz, LaTeX | tex (an own WASM build of `tex.web`) | trial builds pass |
 | Plots | plot | planned |

package/THIRD_PARTY_NOTICES.md

@@ -26,7 +26,7 @@ Version: each row gives the version that the engine pins.
 
 ### Graphviz (EPL-2.0)
 
-The Eclipse Public License 2.0 applies to Graphviz. The wrapper `@viz-js/viz` is licensed under MIT. The package does not ship a Graphviz licence file. The licence text of Graphviz is in `assets/licenses/EPL-2.0.txt`. The source repository of the wrapper is https://github.com/mdaines/viz-js.
+The Eclipse Public License 2.0 applies to Graphviz. The MIT licence applies to the wrapper `@viz-js/viz`. The package does not ship a Graphviz licence file. The licence text of Graphviz is in `assets/licenses/EPL-2.0.txt`. The MIT licence text of the wrapper is in `assets/licenses/MIT-viz-js.txt`, copied from the tag `release-viz-3.31.0` of the source repository https://github.com/mdaines/viz-js. The npm package does not ship this file.
 
 ### OpenCascade (LGPL-2.1)
 

package/assets/licenses/MIT-viz-js.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Michael Daines
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/graph/backend-png.d.ts

@@ -3,3 +3,8 @@ import type { BackendOutput, WorkerJob } from "../worker/protocol.ts";
 export declare function render(request: WorkerJob["request"]): Promise<BackendOutput>;
 /** Renders dot to png with the bundled font at the given path. The path is a parameter so that a test can name a missing or invalid bundled font. */
 export declare function renderPng(request: WorkerJob["request"], bundledFontPath: string): Promise<BackendOutput>;
+/**
+ * Rasterizes one SVG document to PNG at scale 1. The font follows render: the rasterFont setting when set,
+ * else the bundled font in the assets folder. The Mermaid PNG backend uses this function.
+ */
+export declare function svgDocumentToPng(svg: string, request: WorkerJob["request"]): Promise<BackendOutput>;

package/dist/graph/backend-png.js

@@ -21,6 +21,11 @@ function readFont(path, bundled) {
     }
     return bytes;
 }
+/** Reads the font of a render: the rasterFont setting when set, else the bundled font at the given path. */
+function fontOf(settings, bundledFontPath) {
+    const rasterFont = settings.rasterFont;
+    return readFont(rasterFont ?? bundledFontPath, rasterFont === undefined);
+}
 /** Renders dot to png: the SVG of the graph, then the PNG of that SVG at the option scale. The bundled font comes from the assets folder named in the settings. */
 export async function render(request) {
     return renderPng(request, bundledFontPathIn(request.settings.assetsUrl));
@@ -43,8 +48,7 @@ export async function renderPng(request, bundledFontPath) {
             throw new RenderError("E_INPUT", "option scale must be a finite number greater than 0");
         }
     }
-    const rasterFont = request.settings.rasterFont;
-    const font = readFont(rasterFont ?? bundledFontPath, rasterFont === undefined);
+    const font = fontOf(request.settings, bundledFontPath);
     const dot = await dotToSvg(dotSourceText(request.source));
     const bytes = await svgToPng(dot.svg, {
         scale,
@@ -54,4 +58,18 @@ export async function renderPng(request, bundledFontPath) {
     });
     return { bytes, warnings: [...dot.warnings, ...rasterWarnings(dot.svg, font)] };
 }
+/**
+ * Rasterizes one SVG document to PNG at scale 1. The font follows render: the rasterFont setting when set,
+ * else the bundled font in the assets folder. The Mermaid PNG backend uses this function.
+ */
+export async function svgDocumentToPng(svg, request) {
+    const font = fontOf(request.settings, bundledFontPathIn(request.settings.assetsUrl));
+    const bytes = await svgToPng(svg, {
+        scale: 1,
+        maxMemoryMb: request.settings.maxMemoryMb,
+        font,
+        assetsUrl: request.settings.assetsUrl,
+    });
+    return { bytes, warnings: rasterWarnings(svg, font) };
+}
 //# sourceMappingURL=backend-png.js.map

package/dist/graph/backend-png.js.map

@@ -1 +1 @@
-{"version":3,"file":"backend-png.js","sourceRoot":"","sources":["../../src/graph/backend-png.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"backend-png.js","sourceRoot":"","sources":["../../src/graph/backend-png.ts"],"names":[],"mappings":"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"}

package/dist/mermaid/backend-png.d.ts

@@ -0,0 +1,6 @@
+import type { BackendOutput, WorkerJob } from "../worker/protocol.ts";
+/**
+ * Renders one Mermaid source to PNG: the SVG of the diagram, then the PNG of that SVG.
+ * The worker calls this function for the mermaid:png pair.
+ */
+export declare function render(request: WorkerJob["request"]): Promise<BackendOutput>;

package/dist/mermaid/backend-png.js

@@ -0,0 +1,13 @@
+import { svgDocumentToPng } from "../graph/backend-png.js";
+import { sourceText } from "./common.js";
+import { renderMermaidSvg } from "./render.js";
+/**
+ * Renders one Mermaid source to PNG: the SVG of the diagram, then the PNG of that SVG.
+ * The worker calls this function for the mermaid:png pair.
+ */
+export async function render(request) {
+    const svg = await renderMermaidSvg(sourceText(request.source), request.options);
+    const png = await svgDocumentToPng(svg.svg, request);
+    return { bytes: png.bytes, warnings: [...svg.warnings, ...(png.warnings ?? [])] };
+}
+//# sourceMappingURL=backend-png.js.map

package/dist/mermaid/backend-png.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-png.js","sourceRoot":"","sources":["../../src/mermaid/backend-png.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAA6B;IACxD,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAChF,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACrD,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,GAAG,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;AACpF,CAAC"}

package/dist/mermaid/backend-svg.d.ts

@@ -0,0 +1,3 @@
+import type { BackendOutput, WorkerJob } from "../worker/protocol.ts";
+/** Renders one Mermaid source to SVG. The worker calls this function for the mermaid:svg pair. */
+export declare function render(request: WorkerJob["request"]): Promise<BackendOutput>;

package/dist/mermaid/backend-svg.js

@@ -0,0 +1,8 @@
+import { sourceText } from "./common.js";
+import { renderMermaidSvg } from "./render.js";
+/** Renders one Mermaid source to SVG. The worker calls this function for the mermaid:svg pair. */
+export async function render(request) {
+    const result = await renderMermaidSvg(sourceText(request.source), request.options);
+    return { bytes: new TextEncoder().encode(result.svg), warnings: result.warnings };
+}
+//# sourceMappingURL=backend-svg.js.map

package/dist/mermaid/backend-svg.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-svg.js","sourceRoot":"","sources":["../../src/mermaid/backend-svg.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,kGAAkG;AAClG,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,OAA6B;IACxD,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACnF,OAAO,EAAE,KAAK,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;AACpF,CAAC"}

package/dist/mermaid/class.d.ts

@@ -0,0 +1,37 @@
+import { type Source } from "./common.ts";
+/** The shape at one end of a class relation: none, an open arrow, a triangle, or a diamond that is filled or open. */
+export type Marker = "none" | "arrow" | "triangle" | "diamond" | "filled-diamond";
+/** The line style of a class relation and the marker at each end. The tail is the end at the first class. */
+export interface ClassArrow {
+    dashed: boolean;
+    tail: Marker;
+    head: Marker;
+}
+/** One class of the diagram: its name, its generic parameter, its members and the line that declares it. */
+export interface ClassDef {
+    name: string;
+    generic: string | undefined;
+    members: string[];
+    line: number;
+}
+/** One relation between two classes. It holds the arrow, the cardinality at each end, the label and the source line. */
+export interface ClassRelation {
+    from: string;
+    to: string;
+    token: string;
+    arrow: ClassArrow;
+    fromCardinality: string | undefined;
+    toCardinality: string | undefined;
+    label: string | undefined;
+    line: number;
+}
+/** A parsed class diagram: its direction, its classes and its relations. */
+export interface ClassModel {
+    direction: "TB" | "BT" | "LR" | "RL";
+    classes: ClassDef[];
+    relations: ClassRelation[];
+}
+/** Parses the content lines of a class diagram. A line outside the grammar rejects with E_INPUT. In lenient mode the line is skipped and a warning names it. */
+export declare function parseClassDiagram(src: Source): ClassModel;
+/** Builds the DOT source of a parsed class diagram. Each class is a record node. */
+export declare function classToDot(model: ClassModel): string;

package/dist/mermaid/class.js

@@ -0,0 +1,190 @@
+import { inputError, outside, xmlSafe } from "./common.js";
+const ARROW_SPECS = [
+    ["<|--", { dashed: false, tail: "triangle", head: "none" }],
+    ["*--", { dashed: false, tail: "filled-diamond", head: "none" }],
+    ["o--", { dashed: false, tail: "diamond", head: "none" }],
+    ["<--", { dashed: false, tail: "arrow", head: "none" }],
+    ["<|..", { dashed: true, tail: "triangle", head: "none" }],
+    ["<..", { dashed: true, tail: "arrow", head: "none" }],
+    ["--|>", { dashed: false, tail: "none", head: "triangle" }],
+    ["--*", { dashed: false, tail: "none", head: "filled-diamond" }],
+    ["--o", { dashed: false, tail: "none", head: "diamond" }],
+    ["-->", { dashed: false, tail: "none", head: "arrow" }],
+    ["..|>", { dashed: true, tail: "none", head: "triangle" }],
+    ["..>", { dashed: true, tail: "none", head: "arrow" }],
+    ["--", { dashed: false, tail: "none", head: "none" }],
+    ["..", { dashed: true, tail: "none", head: "none" }],
+];
+const ARROW_TABLE = new Map(ARROW_SPECS);
+const ARROW_PATTERN = [...ARROW_SPECS]
+    .sort((left, right) => right[0].length - left[0].length)
+    .map(([token]) => token.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"))
+    .join("|");
+const IDENT_SOURCE = "[A-Za-z_][A-Za-z0-9_]*";
+const RELATION_PATTERN = new RegExp(`^(${IDENT_SOURCE}) +(?:"([^"]*)" )?(${ARROW_PATTERN}) +(?:"([^"]*)" )?(${IDENT_SOURCE})(?: *: *(.+))?$`);
+const MEMBER_PATTERN = /^([A-Za-z_][A-Za-z0-9_]*) *:(.*)$/;
+const CLASS_PATTERN = /^class ([A-Za-z_][A-Za-z0-9_]*)(?:~([A-Za-z0-9_ ,]+)~)?( *\{)?$/;
+const DIRECTION_PATTERN = /^direction (TB|BT|LR|RL)$/;
+/** Parses the content lines of a class diagram. A line outside the grammar rejects with E_INPUT. In lenient mode the line is skipped and a warning names it. */
+export function parseClassDiagram(src) {
+    let direction = "TB";
+    let sawDirection = false;
+    const classes = [];
+    const relations = [];
+    const byName = new Map();
+    let open;
+    const ensureClass = (name, line) => {
+        const existing = byName.get(name);
+        if (existing !== undefined) {
+            return existing;
+        }
+        const created = { name, generic: undefined, members: [], line };
+        byName.set(name, created);
+        classes.push(created);
+        return created;
+    };
+    const lines = src.lines;
+    for (const line of lines) {
+        const text = line.text;
+        if (open !== undefined) {
+            if (text === "}") {
+                open = undefined;
+            }
+            else if (text.includes("{") || text.includes("}")) {
+                outside(src, line.number, text, "a brace inside a class body is outside the supported grammar");
+            }
+            else {
+                byName.get(open.name).members.push(text.trim());
+            }
+            continue;
+        }
+        const relation = RELATION_PATTERN.exec(text);
+        if (relation !== null) {
+            const from = relation[1];
+            const to = relation[5];
+            const token = relation[3];
+            const arrow = ARROW_TABLE.get(token);
+            const rawLabel = relation[6];
+            relations.push({
+                from,
+                to,
+                token,
+                arrow: { dashed: arrow.dashed, tail: arrow.tail, head: arrow.head },
+                fromCardinality: relation[2],
+                toCardinality: relation[4],
+                label: rawLabel === undefined ? undefined : rawLabel.trim(),
+                line: line.number,
+            });
+            ensureClass(from, line.number);
+            ensureClass(to, line.number);
+            continue;
+        }
+        const member = MEMBER_PATTERN.exec(text);
+        if (member !== null) {
+            const memberText = member[2].trim();
+            if (memberText !== "") {
+                ensureClass(member[1], line.number).members.push(memberText);
+                continue;
+            }
+        }
+        const declaration = CLASS_PATTERN.exec(text);
+        if (declaration !== null) {
+            const name = declaration[1];
+            const generic = declaration[2];
+            const existing = byName.get(name);
+            if (existing === undefined) {
+                const created = { name, generic, members: [], line: line.number };
+                byName.set(name, created);
+                classes.push(created);
+            }
+            else if (generic !== undefined) {
+                existing.generic = generic;
+            }
+            if (declaration[3] !== undefined) {
+                open = { name, line: line.number };
+            }
+            continue;
+        }
+        const directionLine = DIRECTION_PATTERN.exec(text);
+        if (directionLine !== null) {
+            if (sawDirection) {
+                outside(src, line.number, text, "a second direction line is outside the supported grammar");
+                continue;
+            }
+            const value = directionLine[1];
+            if (value === "TB" || value === "BT" || value === "LR" || value === "RL") {
+                direction = value;
+                sawDirection = true;
+            }
+            continue;
+        }
+        outside(src, line.number, text, "a construct is outside the supported grammar");
+    }
+    if (open !== undefined) {
+        if (src.lenient) {
+            src.warnings.push(`line ${open.line}: the body of class ${open.name} is not closed by a line with }; its members run to the end of the source`);
+        }
+        else {
+            throw inputError(open.line, `the body of class ${open.name} is not closed by a line with }`);
+        }
+    }
+    if (classes.length === 0 && relations.length === 0) {
+        throw inputError(src.headerLine, "the diagram holds no class or relation");
+    }
+    return { direction, classes, relations };
+}
+const DOT_MARKERS = {
+    none: "none",
+    arrow: "normal",
+    triangle: "empty",
+    diamond: "odiamond",
+    "filled-diamond": "diamond",
+};
+function escapeDot(text) {
+    return xmlSafe(text).replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
+}
+function escapeRecord(text) {
+    return xmlSafe(text).replace(/\\/g, "\\\\").replace(/[{}|<>"]/g, "\\$&");
+}
+function memberDisplay(text) {
+    return escapeRecord(text.replace(/~([^~]*)~/g, "<$1>"));
+}
+/** Builds the DOT source of a parsed class diagram. Each class is a record node. */
+export function classToDot(model) {
+    const out = [];
+    out.push("digraph classDiagram {");
+    out.push(`  rankdir=${model.direction};`);
+    out.push("  node [shape=record];");
+    for (const cls of model.classes) {
+        const display = cls.generic === undefined ? cls.name : `${cls.name}<${cls.generic}>`;
+        const label = cls.members.length === 0
+            ? escapeRecord(display)
+            : `${escapeRecord(display)}|${cls.members.map((member) => `${memberDisplay(member)}\\l`).join("")}`;
+        out.push(`  "${escapeDot(cls.name)}" [label="{${label}}"];`);
+    }
+    for (const rel of model.relations) {
+        const attrs = [];
+        if (rel.arrow.dashed) {
+            attrs.push("style=dashed");
+        }
+        if (rel.arrow.tail === "none" && rel.arrow.head === "none") {
+            attrs.push("dir=none");
+        }
+        else {
+            attrs.push("dir=both", `arrowtail=${DOT_MARKERS[rel.arrow.tail]}`, `arrowhead=${DOT_MARKERS[rel.arrow.head]}`);
+        }
+        if (rel.fromCardinality !== undefined) {
+            attrs.push(`taillabel="${escapeDot(rel.fromCardinality)}"`);
+        }
+        if (rel.toCardinality !== undefined) {
+            attrs.push(`headlabel="${escapeDot(rel.toCardinality)}"`);
+        }
+        if (rel.label !== undefined) {
+            attrs.push(`label="${escapeDot(rel.label)}"`);
+        }
+        out.push(`  "${escapeDot(rel.from)}" -> "${escapeDot(rel.to)}" [${attrs.join(", ")}];`);
+    }
+    out.push("}");
+    return out.join("\n") + "\n";
+}
+//# sourceMappingURL=class.js.map

package/dist/mermaid/class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"class.js","sourceRoot":"","sources":["../../src/mermaid/class.ts"],"names":[],"mappings":"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"}

package/dist/mermaid/common.d.ts

@@ -0,0 +1,43 @@
+import { RenderError } from "../errors.ts";
+/** The three Mermaid diagram kinds that the native layouts draw. */
+export type DiagramKind = "class" | "state" | "sequence";
+/** One content line of a source: its one-based number and its trimmed text. */
+export interface ContentLine {
+    readonly number: number;
+    readonly text: string;
+}
+/** The lenient flag and the warnings that a parse shares. A skipped construct adds a warning. */
+export interface Context {
+    readonly lenient: boolean;
+    readonly warnings: string[];
+}
+/** A source after the header. Comments, blank lines and skipped constructs are absent from `lines`. */
+export interface Source extends Context {
+    readonly kind: DiagramKind;
+    readonly headerLine: number;
+    readonly lines: ContentLine[];
+}
+/**
+ * Reads the option `lenient` and checks the other keys. A key outside `lenient` and `extra` rejects with E_INPUT.
+ * An undefined value counts as an absent key.
+ */
+export declare function readLenient(options: Record<string, unknown>, extra: readonly string[]): boolean;
+/** The text of a request. The source is text for every Mermaid request, and a byte source is read as UTF-8. */
+export declare function sourceText(source: string | Uint8Array): string;
+/**
+ * Replaces each code point that XML 1.0 forbids with U+FFFD.
+ * Valid text, including surrogate pairs, stays unchanged.
+ */
+export declare function xmlSafe(text: string): string;
+/** An input error that names its source line. */
+export declare function inputError(line: number, message: string): RenderError;
+/**
+ * Handles a construct that the grammar does not accept. Without lenient it rejects with E_INPUT on its line.
+ * With lenient it records a warning on its line and returns, so that the caller can skip the construct.
+ */
+export declare function outside(ctx: Context, line: number, text: string, why: string): void;
+/**
+ * Prepares a source. It reads the options, removes blank lines, comment lines, directives and front matter,
+ * and reads the header. A whole Mermaid type that the native layouts do not draw rejects with E_UNSUPPORTED.
+ */
+export declare function prepare(source: string, options: Record<string, unknown>, extra?: readonly string[]): Source;

package/dist/mermaid/common.js

@@ -0,0 +1,112 @@
+import { RenderError } from "../errors.js";
+const HEADERS = new Map([
+    ["classDiagram", "class"],
+    ["classDiagram-v2", "class"],
+    ["stateDiagram-v2", "state"],
+    ["sequenceDiagram", "sequence"],
+]);
+/** Mermaid types that the native layouts do not draw. They need the browser stage, which this release does not build. */
+const OTHER_TYPES = new Set([
+    "flowchart", "graph", "stateDiagram", "erDiagram", "gantt", "pie", "journey", "gitGraph", "mindmap",
+    "timeline", "quadrantChart", "requirementDiagram", "C4Context", "C4Container", "C4Component",
+    "C4Dynamic", "C4Deployment", "sankey-beta", "xychart-beta", "block-beta", "packet-beta", "kanban",
+    "architecture-beta", "zenuml",
+]);
+/**
+ * Reads the option `lenient` and checks the other keys. A key outside `lenient` and `extra` rejects with E_INPUT.
+ * An undefined value counts as an absent key.
+ */
+export function readLenient(options, extra) {
+    let lenient = false;
+    for (const [key, value] of Object.entries(options)) {
+        if (value === undefined)
+            continue;
+        if (key === "lenient") {
+            if (typeof value !== "boolean") {
+                throw new RenderError("E_INPUT", "option lenient must be true or false");
+            }
+            lenient = value;
+        }
+        else if (!extra.includes(key)) {
+            throw new RenderError("E_INPUT", `mermaid takes no option ${key}`);
+        }
+    }
+    return lenient;
+}
+/** The text of a request. The source is text for every Mermaid request, and a byte source is read as UTF-8. */
+export function sourceText(source) {
+    return typeof source === "string" ? source : new TextDecoder().decode(source);
+}
+/**
+ * Replaces each code point that XML 1.0 forbids with U+FFFD.
+ * Valid text, including surrogate pairs, stays unchanged.
+ */
+export function xmlSafe(text) {
+    return text.replace(/[^\u{9}\u{A}\u{D}\u{20}-\u{D7FF}\u{E000}-\u{FFFD}\u{10000}-\u{10FFFF}]/gu, "\u{FFFD}");
+}
+/** An input error that names its source line. */
+export function inputError(line, message) {
+    return new RenderError("E_INPUT", `line ${line}: ${message}`, { line });
+}
+/**
+ * Handles a construct that the grammar does not accept. Without lenient it rejects with E_INPUT on its line.
+ * With lenient it records a warning on its line and returns, so that the caller can skip the construct.
+ */
+export function outside(ctx, line, text, why) {
+    if (!ctx.lenient) {
+        throw inputError(line, `${why}: "${text}"`);
+    }
+    ctx.warnings.push(`line ${line}: skipped the unsupported construct "${text}"`);
+}
+/**
+ * Prepares a source. It reads the options, removes blank lines, comment lines, directives and front matter,
+ * and reads the header. A whole Mermaid type that the native layouts do not draw rejects with E_UNSUPPORTED.
+ */
+export function prepare(source, options, extra = []) {
+    const ctx = { lenient: readLenient(options, extra), warnings: [] };
+    const raw = source.split(/\r?\n/);
+    const content = [];
+    for (let index = 0; index < raw.length; index += 1) {
+        const number = index + 1;
+        const text = (raw[index] ?? "").trim();
+        if (text === "")
+            continue;
+        if (content.length === 0 && text === "---") {
+            const close = raw.findIndex((line, at) => at > index && line.trim() === "---");
+            if (close < 0) {
+                throw inputError(number, "the front matter is not closed by a line of three dashes");
+            }
+            outside(ctx, number, text, "the front matter is outside the supported grammar");
+            index = close;
+            continue;
+        }
+        if (text.startsWith("%%{")) {
+            outside(ctx, number, text, "a directive is outside the supported grammar");
+            continue;
+        }
+        if (text.startsWith("%%"))
+            continue;
+        if (xmlSafe(text) !== text) {
+            ctx.warnings.push(`line ${number}: each character outside the XML 1.0 range is shown as U+FFFD`);
+        }
+        content.push({ number, text });
+    }
+    const head = content[0];
+    if (head === undefined) {
+        throw new RenderError("E_INPUT", "the source names no Mermaid diagram type");
+    }
+    const word = head.text.split(/\s+/)[0] ?? "";
+    const kind = HEADERS.get(head.text);
+    if (kind !== undefined) {
+        return { kind, headerLine: head.number, lines: content.slice(1), lenient: ctx.lenient, warnings: ctx.warnings };
+    }
+    if (OTHER_TYPES.has(word)) {
+        throw new RenderError("E_UNSUPPORTED", `line ${head.number}: ${word} diagrams need the browser stage, which this release does not build; ` +
+            "the native layouts draw classDiagram, stateDiagram-v2 and sequenceDiagram", { line: head.number });
+    }
+    if (HEADERS.has(word)) {
+        throw inputError(head.number, `the header ${word} takes no other text on its line`);
+    }
+    throw inputError(head.number, `"${head.text}" does not name a Mermaid diagram type that this release draws`);
+}
+//# sourceMappingURL=common.js.map

package/dist/mermaid/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/mermaid/common.ts"],"names":[],"mappings":"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"}

package/dist/mermaid/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * The public surface of the Mermaid native layouts. It holds the header and option reader, the parsers,
+ * the DOT builders, the sequence layout and the SVG render.
+ */
+export { prepare, type Source } from "./common.ts";
+export { parseClassDiagram, classToDot, type ClassModel, type ClassDef, type ClassRelation, type ClassArrow, type Marker, } from "./class.ts";
+export { parseStateDiagram, stateToDot, type StateModel, type StateDef, type StateTransition } from "./state.ts";
+export { parseSequenceDiagram, type SequenceModel, type SeqEvent, type Participant, type MessageEvent, type NoteEvent, type ActivateEvent, type DeactivateEvent, type Branch, type BlockEvent, } from "./sequence.ts";
+export { layoutSequence } from "./sequence-layout.ts";
+export { renderMermaidSvg, type MermaidSvg } from "./render.ts";

package/dist/mermaid/index.js

@@ -0,0 +1,11 @@
+/**
+ * The public surface of the Mermaid native layouts. It holds the header and option reader, the parsers,
+ * the DOT builders, the sequence layout and the SVG render.
+ */
+export { prepare } from "./common.js";
+export { parseClassDiagram, classToDot, } from "./class.js";
+export { parseStateDiagram, stateToDot } from "./state.js";
+export { parseSequenceDiagram, } from "./sequence.js";
+export { layoutSequence } from "./sequence-layout.js";
+export { renderMermaidSvg } from "./render.js";
+//# sourceMappingURL=index.js.map

package/dist/mermaid/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mermaid/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,OAAO,EAAe,MAAM,aAAa,CAAC;AACnD,OAAO,EACL,iBAAiB,EACjB,UAAU,GAMX,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAwD,MAAM,YAAY,CAAC;AACjH,OAAO,EACL,oBAAoB,GAUrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAmB,MAAM,aAAa,CAAC"}