callman-core 1.28.0 → 1.29.0

package/dist/diagram/mermaid/serialize.js

@@ -0,0 +1,125 @@
+// Document → Mermaid flowchart text. Used to export/copy a canvas-authored
+// diagram and to seed the source when a user chooses "Edit as Mermaid". The
+// output is the STRUCTURE only (ids, shapes, labels, containers, direction,
+// edge meaning) plus raw colors as classDefs; positions are not part of the
+// language. Round-trips through parse.ts.
+import { semanticFromStyle } from "../edgeSemantics.js";
+import { layoutDirectionToMermaid } from "./derive.js";
+import { BRACKET_DELIMITERS, bracketForShape, mermaidShapeForType } from "./shapes.js";
+const NEEDS_QUOTES = /[[\](){}|"#;<>&]|^\s|\s$/;
+export const escapeLabel = (label) => {
+    const text = label.replace(/\r?\n/g, "<br/>").replace(/"/g, "#quot;");
+    return NEEDS_QUOTES.test(label) || /<br\/>/.test(text) ? `"${text}"` : text;
+};
+const RESERVED_IDS = new Set(["end", "subgraph", "graph", "flowchart", "style", "class", "classDef", "click", "linkStyle", "direction"]);
+// Mermaid ids: letters, digits, underscore and inner dashes. Anything else is
+// replaced; a collision or a reserved word gets a suffix.
+export const mermaidSafeId = (id, taken) => {
+    let safe = id.replace(/[^A-Za-z0-9_-]+/g, "_").replace(/^-+|-+$/g, "").replace(/-(?=[->.])/g, "_");
+    if (!safe || !/^[A-Za-z0-9_]/.test(safe))
+        safe = `n_${safe}`;
+    if (RESERVED_IDS.has(safe))
+        safe = `${safe}_`;
+    let candidate = safe;
+    let suffix = 2;
+    while (taken.has(candidate)) {
+        candidate = `${safe}_${suffix}`;
+        suffix += 1;
+    }
+    taken.add(candidate);
+    return candidate;
+};
+export const nodeDeclaration = (node, mermaidId) => {
+    const shape = mermaidShapeForType(node.type);
+    const label = node.label ?? "";
+    const bracket = bracketForShape(shape);
+    if (bracket && label) {
+        const [open, close] = BRACKET_DELIMITERS[bracket];
+        return `${mermaidId}${open}${escapeLabel(label)}${close}`;
+    }
+    if (bracket && !label && shape === "rect")
+        return mermaidId;
+    const attrs = [`shape: ${shape}`];
+    if (label)
+        attrs.push(`label: "${label.replace(/\r?\n/g, "<br/>").replace(/"/g, "#quot;")}"`);
+    return `${mermaidId}@{ ${attrs.join(", ")} }`;
+};
+// `-->` / `---` / `-.->` / `-.-` / `==>` / `===`, with `<`, `o`, `x` ends.
+export const edgeArrow = (edge) => {
+    const semantic = semanticFromStyle(edge.style);
+    const end = edge.markerEnd === "none" ? "" : edge.markerEnd === "oval" ? "o" : edge.markerEnd === "block" ? "x" : ">";
+    const start = edge.markerStart === undefined || edge.markerStart === "none" ? "" : edge.markerStart === "oval" ? "o" : edge.markerStart === "block" ? "x" : "<";
+    const dotted = semantic === "async" || semantic === "fallback";
+    const thick = semantic === "bus";
+    const body = dotted ? "-.-" : thick ? (end ? "==" : "===") : end ? "--" : "---";
+    return `${start}${body}${end}`;
+};
+const colorOf = (ref) => (ref && "raw" in ref ? ref.raw : undefined);
+export const exportMermaid = (doc, options = {}) => {
+    const indent = options.indent ?? "    ";
+    const taken = new Set();
+    const idOf = new Map();
+    for (const node of doc.nodes)
+        idOf.set(node.id, mermaidSafeId(node.id, taken));
+    const edgeIdOf = new Map();
+    if (options.edgeIds !== false)
+        for (const edge of doc.edges)
+            edgeIdOf.set(edge.id, mermaidSafeId(edge.id, taken));
+    const lines = [];
+    if (doc.meta.title)
+        lines.push("---", `title: ${doc.meta.title.includes(":") ? `"${doc.meta.title.replace(/"/g, '\\"')}"` : doc.meta.title}`, "---");
+    if (options.header !== false)
+        lines.push(`%% callman-diagram v1 id=${doc.id}`);
+    lines.push(`flowchart ${options.direction ?? layoutDirectionToMermaid(doc.canvas?.layout?.direction)}`);
+    const childrenOf = (parentId) => doc.nodes.filter((node) => (node.parentId ?? undefined) === parentId);
+    const isContainer = (node) => node.type === "frame" || node.type.startsWith("pool.") || childrenOf(node.id).length > 0;
+    const classLines = [];
+    const classByColor = new Map();
+    const emitNode = (node, depth) => {
+        const pad = indent.repeat(depth);
+        const mermaidId = idOf.get(node.id);
+        if (isContainer(node)) {
+            const title = node.label ? ` [${escapeLabel(node.label)}]` : "";
+            lines.push(`${pad}subgraph ${mermaidId}${title}`);
+            if (node.collapsed)
+                lines.push(`${pad}${indent}%% collapsed`);
+            for (const child of childrenOf(node.id))
+                emitNode(child, depth + 1);
+            lines.push(`${pad}end`);
+            return;
+        }
+        let line = `${pad}${nodeDeclaration(node, mermaidId)}`;
+        if (options.styles !== false) {
+            const fill = colorOf(node.style?.fill);
+            const stroke = colorOf(node.style?.stroke);
+            const text = colorOf(node.style?.textColor);
+            if (fill || stroke || text) {
+                const key = `${fill ?? ""}|${stroke ?? ""}|${text ?? ""}`;
+                let className = classByColor.get(key);
+                if (!className) {
+                    className = `c${classByColor.size + 1}`;
+                    classByColor.set(key, className);
+                    const parts = [fill ? `fill:${fill}` : null, stroke ? `stroke:${stroke}` : null, text ? `color:${text}` : null].filter(Boolean);
+                    classLines.push(`${indent}classDef ${className} ${parts.join(",")}`);
+                }
+                line += `:::${className}`;
+            }
+        }
+        lines.push(line);
+    };
+    for (const root of childrenOf(undefined))
+        emitNode(root, 1);
+    if (doc.edges.length > 0)
+        lines.push("");
+    for (const edge of doc.edges) {
+        if (!edge.source || !edge.target || !idOf.has(edge.source) || !idOf.has(edge.target))
+            continue;
+        const id = edgeIdOf.get(edge.id);
+        const label = edge.label ? `|${escapeLabel(edge.label)}|` : "";
+        lines.push(`${indent}${idOf.get(edge.source)} ${id ? `${id}@` : ""}${edgeArrow(edge)}${label} ${idOf.get(edge.target)}`);
+    }
+    if (classLines.length > 0)
+        lines.push("", ...classLines);
+    return `${lines.join("\n")}\n`;
+};
+//# sourceMappingURL=serialize.js.map

package/dist/diagram/mermaid/serialize.js.map

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

package/dist/diagram/mermaid/shapes.d.ts

@@ -0,0 +1,11 @@
+export type BracketKind = "[]" | "()" | "([])" | "[[]]" | "[()]" | "(())" | "((()))" | ">]" | "{}" | "{{}}" | "[//]" | "[\\\\]" | "[/\\]" | "[\\/]";
+export declare const BRACKET_SHAPE: Record<BracketKind, string>;
+export declare const BRACKET_DELIMITERS: Record<BracketKind, [string, string]>;
+export declare const canonicalMermaidShape: (name: string | undefined) => string | undefined;
+export declare const mermaidShapeForType: (type: string) => string;
+export declare const typeForMermaidShape: (shape: string | undefined) => {
+    type: string;
+    known: boolean;
+};
+export declare const bracketForShape: (shape: string) => BracketKind | undefined;
+//# sourceMappingURL=shapes.d.ts.map

package/dist/diagram/mermaid/shapes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shapes.d.ts","sourceRoot":"","sources":["../../../src/diagram/mermaid/shapes.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,WAAW,GACnB,IAAI,GACJ,IAAI,GACJ,MAAM,GACN,MAAM,GACN,MAAM,GACN,MAAM,GACN,QAAQ,GACR,IAAI,GACJ,IAAI,GACJ,MAAM,GACN,MAAM,GACN,QAAQ,GACR,OAAO,GACP,OAAO,CAAC;AAEZ,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAerD,CAAC;AAGF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAepE,CAAC;AAuHF,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,GAAG,SAAS,KAAG,MAAM,GAAG,SACb,CAAC;AA2E9D,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,KAAG,MAOlD,CAAC;AA0DF,eAAO,MAAM,mBAAmB,GAAI,OAAO,MAAM,GAAG,SAAS,KAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAK7F,CAAC;AAoBF,eAAO,MAAM,eAAe,GAAI,OAAO,MAAM,KAAG,WAAW,GAAG,SAAqC,CAAC"}

package/dist/diagram/mermaid/shapes.js

@@ -0,0 +1,320 @@
+// Callman component type ↔ Mermaid flowchart shape. Export prefers the
+// classic bracket syntax where one exists (`A[x]`, `A{x}`, `A([x])`) so the
+// text reads like every other Mermaid diagram, and `A@{ shape: … }` only for
+// shapes the brackets cannot express. Import maps the ~60 Mermaid shape names
+// (and their aliases) onto catalog types; unknown names become `rect`.
+import { getDiagramComponent } from "../componentCatalog.js";
+export const BRACKET_SHAPE = {
+    "[]": "rect",
+    "()": "rounded",
+    "([])": "stadium",
+    "[[]]": "fr-rect",
+    "[()]": "cyl",
+    "(())": "circle",
+    "((()))": "dbl-circ",
+    ">]": "odd",
+    "{}": "diam",
+    "{{}}": "hex",
+    "[//]": "lean-r",
+    "[\\\\]": "lean-l",
+    "[/\\]": "trap-t",
+    "[\\/]": "trap-b",
+};
+// Opening/closing delimiters per bracket kind.
+export const BRACKET_DELIMITERS = {
+    "[]": ["[", "]"],
+    "()": ["(", ")"],
+    "([])": ["([", "])"],
+    "[[]]": ["[[", "]]"],
+    "[()]": ["[(", ")]"],
+    "(())": ["((", "))"],
+    "((()))": ["(((", ")))"],
+    ">]": [">", "]"],
+    "{}": ["{", "}"],
+    "{{}}": ["{{", "}}"],
+    "[//]": ["[/", "/]"],
+    "[\\\\]": ["[\\", "\\]"],
+    "[/\\]": ["[/", "\\]"],
+    "[\\/]": ["[\\", "/]"],
+};
+// Mermaid shape name (canonical or alias) → canonical shape name.
+const SHAPE_ALIASES = {
+    rect: "rect",
+    rectangle: "rect",
+    proc: "rect",
+    process: "rect",
+    rounded: "rounded",
+    event: "rounded",
+    stadium: "stadium",
+    pill: "stadium",
+    terminal: "stadium",
+    "fr-rect": "fr-rect",
+    subproc: "fr-rect",
+    subprocess: "fr-rect",
+    subroutine: "fr-rect",
+    cyl: "cyl",
+    cylinder: "cyl",
+    database: "cyl",
+    db: "cyl",
+    circle: "circle",
+    circ: "circle",
+    "dbl-circ": "dbl-circ",
+    "double-circle": "dbl-circ",
+    "sm-circ": "sm-circ",
+    "small-circle": "sm-circ",
+    start: "sm-circ",
+    "f-circ": "f-circ",
+    "filled-circle": "f-circ",
+    junction: "f-circ",
+    "fr-circ": "fr-circ",
+    "framed-circle": "fr-circ",
+    stop: "fr-circ",
+    "cross-circ": "cross-circ",
+    summary: "cross-circ",
+    diam: "diam",
+    diamond: "diam",
+    decision: "diam",
+    question: "diam",
+    hex: "hex",
+    hexagon: "hex",
+    prepare: "hex",
+    "lean-r": "lean-r",
+    "lean-right": "lean-r",
+    "in-out": "lean-r",
+    "lean-l": "lean-l",
+    "lean-left": "lean-l",
+    "out-in": "lean-l",
+    "trap-t": "trap-t",
+    "trapezoid-top": "trap-t",
+    manual: "trap-t",
+    inv_trapezoid: "trap-t",
+    "trap-b": "trap-b",
+    "trapezoid-bottom": "trap-b",
+    priority: "trap-b",
+    trapezoid: "trap-b",
+    doc: "doc",
+    document: "doc",
+    docs: "docs",
+    documents: "docs",
+    "st-doc": "docs",
+    "lin-doc": "lin-doc",
+    "lined-document": "lin-doc",
+    "tag-doc": "tag-doc",
+    "sl-rect": "sl-rect",
+    "manual-input": "sl-rect",
+    "bow-rect": "bow-rect",
+    "stored-data": "bow-rect",
+    "curv-trap": "curv-trap",
+    display: "curv-trap",
+    delay: "delay",
+    "half-rounded-rectangle": "delay",
+    tri: "tri",
+    triangle: "tri",
+    extract: "tri",
+    "flip-tri": "flip-tri",
+    "manual-file": "flip-tri",
+    "notch-pent": "notch-pent",
+    "loop-limit": "notch-pent",
+    "notch-rect": "notch-rect",
+    card: "notch-rect",
+    brace: "brace",
+    comment: "brace",
+    "brace-r": "brace-r",
+    braces: "braces",
+    cloud: "cloud",
+    "h-cyl": "h-cyl",
+    das: "h-cyl",
+    "lin-cyl": "lin-cyl",
+    disk: "lin-cyl",
+    "lin-rect": "lin-rect",
+    "lined-process": "lin-rect",
+    "st-rect": "st-rect",
+    "multi-process": "st-rect",
+    "div-rect": "div-rect",
+    "divided-process": "div-rect",
+    "tag-rect": "tag-rect",
+    "win-pane": "win-pane",
+    "internal-storage": "win-pane",
+    fork: "fork",
+    join: "fork",
+    hourglass: "hourglass",
+    collate: "hourglass",
+    bolt: "bolt",
+    "com-link": "bolt",
+    bang: "bang",
+    odd: "odd",
+    flag: "odd",
+    "paper-tape": "odd",
+    text: "text",
+    datastore: "datastore",
+    bucket: "bucket",
+    browser: "browser",
+    console: "console",
+    person: "person",
+    folder: "folder",
+};
+export const canonicalMermaidShape = (name) => name ? SHAPE_ALIASES[name.trim().toLowerCase()] : undefined;
+// Explicit export table for the shape-based catalog types.
+const SHAPE_BY_TYPE = {
+    rect: "rect",
+    square: "rect",
+    ellipse: "stadium",
+    circle: "circle",
+    diamond: "diam",
+    triangle: "tri",
+    hexagon: "hex",
+    pentagon: "hex",
+    octagon: "hex",
+    parallelogram: "lean-r",
+    trapezoid: "trap-t",
+    cylinder: "cyl",
+    "cloud-shape": "cloud",
+    callout: "brace",
+    text: "text",
+    sticky: "notch-rect",
+    card: "notch-rect",
+    image: "rect",
+    "flow.process": "rect",
+    "flow.alt-process": "rounded",
+    "flow.decision": "diam",
+    "flow.terminator": "stadium",
+    "flow.data": "lean-r",
+    "flow.document": "doc",
+    "flow.multi-document": "docs",
+    "flow.predefined": "fr-rect",
+    "flow.manual-input": "sl-rect",
+    "flow.manual-op": "trap-t",
+    "flow.preparation": "hex",
+    "flow.stored-data": "bow-rect",
+    "flow.database": "cyl",
+    "flow.display": "curv-trap",
+    "flow.delay": "delay",
+    "flow.merge": "tri",
+    "flow.or": "cross-circ",
+    "flow.connector": "sm-circ",
+    "flow.off-page": "notch-pent",
+    "flow.annotation": "brace",
+    "uml.class": "rect",
+    "uml.abstract": "rect",
+    "uml.interface": "rect",
+    "uml.enum": "rect",
+    "uml.object": "rect",
+    "uml.package": "rect",
+    "uml.component": "rect",
+    "uml.node": "rect",
+    "uml.actor": "circle",
+    "uml.usecase": "stadium",
+    "uml.boundary": "rect",
+    "uml.control": "circle",
+    "uml.entity": "circle",
+    "uml.state": "rounded",
+    "uml.initial": "f-circ",
+    "uml.final": "dbl-circ",
+    "uml.decision": "diam",
+    "uml.note": "notch-rect",
+    "erd.entity": "rect",
+    "erd.weak-entity": "st-rect",
+    "erd.attribute": "stadium",
+    "erd.key-attribute": "stadium",
+    "erd.multivalued": "stadium",
+    "erd.derived": "stadium",
+    "erd.relationship": "diam",
+    "erd.identifying": "diam",
+    "net.queue": "h-cyl",
+    "net.cache": "cyl",
+    "net.internet": "cloud",
+    "net.user": "person",
+    "net.admin": "person",
+};
+export const mermaidShapeForType = (type) => {
+    const explicit = SHAPE_BY_TYPE[type];
+    if (explicit)
+        return explicit;
+    const def = getDiagramComponent(type);
+    if (def?.category === "database")
+        return "cyl";
+    if (def?.category === "messaging")
+        return "h-cyl";
+    return "rect";
+};
+// Import: canonical Mermaid shape → catalog type.
+const TYPE_BY_SHAPE = {
+    rect: "rect",
+    rounded: "flow.alt-process",
+    stadium: "flow.terminator",
+    "fr-rect": "flow.predefined",
+    cyl: "cylinder",
+    circle: "circle",
+    "dbl-circ": "uml.final",
+    "sm-circ": "flow.connector",
+    "f-circ": "uml.initial",
+    "fr-circ": "uml.final",
+    "cross-circ": "flow.or",
+    diam: "flow.decision",
+    hex: "hexagon",
+    "lean-r": "parallelogram",
+    "lean-l": "parallelogram",
+    "trap-t": "trapezoid",
+    "trap-b": "trapezoid",
+    doc: "flow.document",
+    docs: "flow.multi-document",
+    "lin-doc": "flow.document",
+    "tag-doc": "flow.document",
+    "sl-rect": "flow.manual-input",
+    "bow-rect": "flow.stored-data",
+    "curv-trap": "flow.display",
+    delay: "flow.delay",
+    tri: "triangle",
+    "flip-tri": "triangle",
+    "notch-pent": "flow.off-page",
+    "notch-rect": "card",
+    brace: "flow.annotation",
+    "brace-r": "flow.annotation",
+    braces: "flow.annotation",
+    cloud: "cloud-shape",
+    "h-cyl": "net.queue",
+    "lin-cyl": "cylinder",
+    "lin-rect": "flow.process",
+    "st-rect": "erd.weak-entity",
+    "div-rect": "flow.process",
+    "tag-rect": "flow.process",
+    "win-pane": "flow.stored-data",
+    fork: "rect",
+    hourglass: "flow.delay",
+    bolt: "flow.connector",
+    bang: "callout",
+    odd: "flow.data",
+    text: "text",
+    datastore: "cylinder",
+    bucket: "cylinder",
+    browser: "net.browser",
+    console: "net.desktop",
+    person: "net.user",
+    folder: "rect",
+};
+export const typeForMermaidShape = (shape) => {
+    const canonical = canonicalMermaidShape(shape);
+    if (!canonical)
+        return { type: "rect", known: shape === undefined };
+    const type = TYPE_BY_SHAPE[canonical];
+    return type ? { type, known: true } : { type: "rect", known: false };
+};
+// Prefer a classic bracket for the shapes that have one.
+const BRACKET_FOR_SHAPE = {
+    rect: "[]",
+    rounded: "()",
+    stadium: "([])",
+    "fr-rect": "[[]]",
+    cyl: "[()]",
+    circle: "(())",
+    "dbl-circ": "((()))",
+    odd: ">]",
+    diam: "{}",
+    hex: "{{}}",
+    "lean-r": "[//]",
+    "lean-l": "[\\\\]",
+    "trap-t": "[/\\]",
+    "trap-b": "[\\/]",
+};
+export const bracketForShape = (shape) => BRACKET_FOR_SHAPE[shape];
+//# sourceMappingURL=shapes.js.map

package/dist/diagram/mermaid/shapes.js.map

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

package/dist/diagram/migrations.d.ts

@@ -1,3 +1,4 @@
 import { type DiagramDocument } from "./schema.js";
+export declare const migrateDocumentRaw: (raw: unknown) => Record<string, unknown>;
 export declare const migrateDocument: (raw: unknown) => DiagramDocument;
 //# sourceMappingURL=migrations.d.ts.map

package/dist/diagram/migrations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/diagram/migrations.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,eAAe,EAAwC,MAAM,aAAa,CAAC;AASzF,eAAO,MAAM,eAAe,GAAI,KAAK,OAAO,KAAG,eA4B9C,CAAC"}
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/diagram/migrations.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,KAAK,eAAe,EAAwC,MAAM,aAAa,CAAC;AASzF,eAAO,MAAM,kBAAkB,GAAI,KAAK,OAAO,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CA4BvE,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,KAAK,OAAO,KAAG,eAAgE,CAAC"}

package/dist/diagram/migrations.js

@@ -2,12 +2,16 @@
 // SCHEMA_VERSION. Empty for v1; each future schema bump registers a
 // vN -> vN+1 step here. A schema bump therefore ships in core FIRST — every
 // host (desktop, MCP, backend) then migrates identically.
+//
+// `migrateDocumentRaw` runs only the version steps (for normalizeDocument,
+// which heals a document BEFORE validating it); `migrateDocument` also
+// validates the result.
 import { parseDiagramDocument, SCHEMA_VERSION } from "./schema.js";
 // Keyed by the version a step upgrades FROM (e.g. 1 transforms v1 -> v2).
 const MIGRATIONS = {
 // 1: (doc) => ({ ...doc, schemaVersion: 2, /* ...transform... */ }),
 };
-export const migrateDocument = (raw) => {
+export const migrateDocumentRaw = (raw) => {
     if (typeof raw !== "object" || raw === null) {
         throw new Error("Cannot migrate: document is not an object");
     }
@@ -28,6 +32,7 @@ export const migrateDocument = (raw) => {
     if (version > SCHEMA_VERSION) {
         throw new Error(`Document schemaVersion ${version} is newer than supported (${SCHEMA_VERSION}); update the app`);
     }
-    return parseDiagramDocument(doc);
+    return doc;
 };
+export const migrateDocument = (raw) => parseDiagramDocument(migrateDocumentRaw(raw));
 //# sourceMappingURL=migrations.js.map

package/dist/diagram/migrations.js.map

@@ -1 +1 @@
-{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/diagram/migrations.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,oEAAoE;AACpE,4EAA4E;AAC5E,0DAA0D;AAC1D,OAAO,EAAwB,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIzF,0EAA0E;AAC1E,MAAM,UAAU,GAAkC;AAChD,qEAAqE;CACtE,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAY,EAAmB,EAAE;IAC/D,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,GAAG,GAAG,GAA8B,CAAC;IACzC,IAAI,OAAO,GAAG,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5E,OAAO,OAAO,GAAG,cAAc,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,yDAAyD,OAAO,EAAE,CAAC,CAAC;QACtF,CAAC;QACD,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QAChB,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;QACrF,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,gCAAgC,OAAO,8BAA8B,CAAC,CAAC;QACzF,CAAC;QACD,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IAED,IAAI,OAAO,GAAG,cAAc,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,0BAA0B,OAAO,6BAA6B,cAAc,mBAAmB,CAChG,CAAC;IACJ,CAAC;IAED,OAAO,oBAAoB,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC,CAAC"}
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/diagram/migrations.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,oEAAoE;AACpE,4EAA4E;AAC5E,0DAA0D;AAC1D,EAAE;AACF,2EAA2E;AAC3E,uEAAuE;AACvE,wBAAwB;AACxB,OAAO,EAAwB,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIzF,0EAA0E;AAC1E,MAAM,UAAU,GAAkC;AAChD,qEAAqE;CACtE,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAY,EAA2B,EAAE;IAC1E,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,GAAG,GAAG,GAA8B,CAAC;IACzC,IAAI,OAAO,GAAG,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5E,OAAO,OAAO,GAAG,cAAc,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,yDAAyD,OAAO,EAAE,CAAC,CAAC;QACtF,CAAC;QACD,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QAChB,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC;QACrF,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,gCAAgC,OAAO,8BAA8B,CAAC,CAAC;QACzF,CAAC;QACD,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;IAED,IAAI,OAAO,GAAG,cAAc,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CACb,0BAA0B,OAAO,6BAA6B,cAAc,mBAAmB,CAChG,CAAC;IACJ,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAY,EAAmB,EAAE,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC"}

package/dist/diagram/normalize.d.ts

@@ -1,4 +1,12 @@
-import type { DiagramDocument, DiagramStyle } from "./schema.js";
+import { type DiagramDocument, type DiagramNode, type DiagramStyle } from "./schema.js";
 export declare const normalizeDiagramStyle: (style: unknown) => DiagramStyle | undefined;
 export declare const normalizeDiagramStyles: (doc: DiagramDocument) => DiagramDocument;
+export declare const sortPreOrder: (nodes: readonly DiagramNode[]) => DiagramNode[];
+export declare const isPreOrder: (nodes: readonly DiagramNode[]) => boolean;
+export interface NormalizeResult {
+    document: DiagramDocument;
+    warnings: string[];
+    changed: boolean;
+}
+export declare const normalizeDocument: (raw: unknown) => NormalizeResult;
 //# sourceMappingURL=normalize.d.ts.map

package/dist/diagram/normalize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/diagram/normalize.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAY,MAAM,aAAa,CAAC;AAY3E,eAAO,MAAM,qBAAqB,GAAI,OAAO,OAAO,KAAG,YAAY,GAAG,SAyBrE,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,KAAK,eAAe,KAAG,eAY5D,CAAC"}
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/diagram/normalize.ts"],"names":[],"mappings":"AAcA,OAAO,EAEL,KAAK,eAAe,EAEpB,KAAK,WAAW,EAChB,KAAK,YAAY,EAIlB,MAAM,aAAa,CAAC;AAYrB,eAAO,MAAM,qBAAqB,GAAI,OAAO,OAAO,KAAG,YAAY,GAAG,SAyBrE,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,KAAK,eAAe,KAAG,eAY5D,CAAC;AAOH,eAAO,MAAM,YAAY,GAAI,OAAO,SAAS,WAAW,EAAE,KAAG,WAAW,EA0BvE,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,OAAO,SAAS,WAAW,EAAE,KAAG,OAO1D,CAAC;AAIF,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAiBD,eAAO,MAAM,iBAAiB,GAAI,KAAK,OAAO,KAAG,eAsHhD,CAAC"}