@statelyai/graph 0.4.0 → 0.6.0

package/dist/formats/graphml/index.mjs

@@ -1,4 +1,4 @@
-import { n as createFormatConverter } from "../../converter-C5DlzzHs.mjs";
+import { n as createFormatConverter } from "../../converter-B5CUD0r9.mjs";
 import { XMLBuilder, XMLParser } from "fast-xml-parser";
 
 //#region src/formats/graphml/index.ts
@@ -17,6 +17,12 @@ function toGraphML(graph) {
 			"@_attr.name": "parentId",
 			"@_attr.type": "string"
 		},
+		{
+			"@_id": "initialNodeId",
+			"@_for": "node",
+			"@_attr.name": "initialNodeId",
+			"@_attr.type": "string"
+		},
 		{
 			"@_id": "data",
 			"@_for": "all",
@@ -29,6 +35,30 @@ function toGraphML(graph) {
 			"@_attr.name": "data",
 			"@_attr.type": "string"
 		},
+		{
+			"@_id": "graphInitialNodeId",
+			"@_for": "graph",
+			"@_attr.name": "initialNodeId",
+			"@_attr.type": "string"
+		},
+		{
+			"@_id": "direction",
+			"@_for": "graph",
+			"@_attr.name": "direction",
+			"@_attr.type": "string"
+		},
+		{
+			"@_id": "style",
+			"@_for": "all",
+			"@_attr.name": "style",
+			"@_attr.type": "string"
+		},
+		{
+			"@_id": "graphStyle",
+			"@_for": "graph",
+			"@_attr.name": "style",
+			"@_attr.type": "string"
+		},
 		{
 			"@_id": "x",
 			"@_for": "all",
@@ -64,85 +94,107 @@ function toGraphML(graph) {
 			"@_for": "all",
 			"@_attr.name": "color",
 			"@_attr.type": "string"
+		},
+		{
+			"@_id": "weight",
+			"@_for": "edge",
+			"@_attr.name": "weight",
+			"@_attr.type": "double"
 		}
 	];
-	const nodes = graph.nodes.map((n) => {
+	const nodes = graph.nodes.map((node) => {
 		const data = [];
-		if (n.label) data.push({
+		if (node.label) data.push({
 			"@_key": "label",
-			"#text": n.label
+			"#text": node.label
 		});
-		if (n.parentId) data.push({
+		if (node.parentId) data.push({
 			"@_key": "parentId",
-			"#text": n.parentId
+			"#text": node.parentId
 		});
-		if (n.data !== void 0) data.push({
+		if (node.initialNodeId) data.push({
+			"@_key": "initialNodeId",
+			"#text": node.initialNodeId
+		});
+		if (node.data !== void 0) data.push({
 			"@_key": "data",
-			"#text": JSON.stringify(n.data)
+			"#text": JSON.stringify(node.data)
+		});
+		if (node.style !== void 0) data.push({
+			"@_key": "style",
+			"#text": JSON.stringify(node.style)
 		});
-		if (n.x !== void 0) data.push({
+		if (node.x !== void 0) data.push({
 			"@_key": "x",
-			"#text": n.x
+			"#text": node.x
 		});
-		if (n.y !== void 0) data.push({
+		if (node.y !== void 0) data.push({
 			"@_key": "y",
-			"#text": n.y
+			"#text": node.y
 		});
-		if (n.width !== void 0) data.push({
+		if (node.width !== void 0) data.push({
 			"@_key": "width",
-			"#text": n.width
+			"#text": node.width
 		});
-		if (n.height !== void 0) data.push({
+		if (node.height !== void 0) data.push({
 			"@_key": "height",
-			"#text": n.height
+			"#text": node.height
 		});
-		if (n.shape) data.push({
+		if (node.shape) data.push({
 			"@_key": "shape",
-			"#text": n.shape
+			"#text": node.shape
 		});
-		if (n.color) data.push({
+		if (node.color) data.push({
 			"@_key": "color",
-			"#text": n.color
+			"#text": node.color
 		});
 		return {
-			"@_id": n.id,
+			"@_id": node.id,
 			...data.length > 0 && { data }
 		};
 	});
-	const edges = graph.edges.map((e) => {
+	const edges = graph.edges.map((edge) => {
 		const data = [];
-		if (e.label) data.push({
+		if (edge.label) data.push({
 			"@_key": "label",
-			"#text": e.label
+			"#text": edge.label
 		});
-		if (e.data !== void 0) data.push({
+		if (edge.data !== void 0) data.push({
 			"@_key": "data",
-			"#text": JSON.stringify(e.data)
+			"#text": JSON.stringify(edge.data)
 		});
-		if (e.x !== void 0) data.push({
+		if (edge.style !== void 0) data.push({
+			"@_key": "style",
+			"#text": JSON.stringify(edge.style)
+		});
+		if (edge.x !== void 0) data.push({
 			"@_key": "x",
-			"#text": e.x
+			"#text": edge.x
 		});
-		if (e.y !== void 0) data.push({
+		if (edge.y !== void 0) data.push({
 			"@_key": "y",
-			"#text": e.y
+			"#text": edge.y
 		});
-		if (e.width !== void 0) data.push({
+		if (edge.width !== void 0) data.push({
 			"@_key": "width",
-			"#text": e.width
+			"#text": edge.width
 		});
-		if (e.height !== void 0) data.push({
+		if (edge.height !== void 0) data.push({
 			"@_key": "height",
-			"#text": e.height
+			"#text": edge.height
 		});
-		if (e.color) data.push({
+		if (edge.color) data.push({
 			"@_key": "color",
-			"#text": e.color
+			"#text": edge.color
+		});
+		if (edge.weight !== void 0) data.push({
+			"@_key": "weight",
+			"#text": edge.weight
 		});
 		return {
-			"@_id": e.id,
-			"@_source": e.sourceId,
-			"@_target": e.targetId,
+			"@_id": edge.id,
+			"@_source": edge.sourceId,
+			"@_target": edge.targetId,
 			...data.length > 0 && { data }
 		};
 	});
@@ -151,6 +203,18 @@ function toGraphML(graph) {
 		"@_key": "graphData",
 		"#text": JSON.stringify(graph.data)
 	});
+	if (graph.initialNodeId) graphData.push({
+		"@_key": "graphInitialNodeId",
+		"#text": graph.initialNodeId
+	});
+	if (graph.direction !== void 0) graphData.push({
+		"@_key": "direction",
+		"#text": graph.direction
+	});
+	if (graph.style !== void 0) graphData.push({
+		"@_key": "graphStyle",
+		"#text": JSON.stringify(graph.style)
+	});
 	const obj = {
 		"?xml": {
 			"@_version": "1.0",
@@ -196,40 +260,57 @@ function fromGraphML(xml) {
 	const graphEl = graphml.graph;
 	if (!graphEl) throw new Error("GraphML: missing <graph> element");
 	const graphType = graphEl["@_edgedefault"] === "undirected" ? "undirected" : "directed";
-	let graphData = void 0;
-	if (graphEl.data) {
-		for (const d of asArray(graphEl.data)) if (d["@_key"] === "graphData") graphData = tryParseJSON(String(d["#text"]));
-	}
-	const nodes = asArray(graphEl.node).map((n) => {
-		const dataMap = parseDataElements(n.data);
-		return {
+	const graphDataMap = parseDataElements(graphEl.data);
+	const graphData = graphDataMap.graphData !== void 0 ? tryParseJSON(graphDataMap.graphData) : void 0;
+	const nodes = asArray(graphEl.node).map((nodeEl) => {
+		const dataMap = parseDataElements(nodeEl.data);
+		const node = {
 			type: "node",
-			id: String(n["@_id"]),
+			id: String(nodeEl["@_id"]),
 			parentId: dataMap.parentId ?? null,
 			initialNodeId: dataMap.initialNodeId ?? null,
 			label: dataMap.label ?? "",
 			data: dataMap.data !== void 0 ? tryParseJSON(dataMap.data) : void 0
 		};
+		if (dataMap.x !== void 0) node.x = parseNumber(dataMap.x);
+		if (dataMap.y !== void 0) node.y = parseNumber(dataMap.y);
+		if (dataMap.width !== void 0) node.width = parseNumber(dataMap.width);
+		if (dataMap.height !== void 0) node.height = parseNumber(dataMap.height);
+		if (dataMap.shape !== void 0) node.shape = dataMap.shape;
+		if (dataMap.color !== void 0) node.color = dataMap.color;
+		if (dataMap.style !== void 0) node.style = tryParseJSON(dataMap.style);
+		return node;
 	});
-	const edges = asArray(graphEl.edge).map((e) => {
-		const dataMap = parseDataElements(e.data);
-		return {
+	const edges = asArray(graphEl.edge).map((edgeEl) => {
+		const dataMap = parseDataElements(edgeEl.data);
+		const edge = {
 			type: "edge",
-			id: String(e["@_id"]),
-			sourceId: String(e["@_source"]),
-			targetId: String(e["@_target"]),
+			id: String(edgeEl["@_id"]),
+			sourceId: String(edgeEl["@_source"]),
+			targetId: String(edgeEl["@_target"]),
 			label: dataMap.label ?? "",
 			data: dataMap.data !== void 0 ? tryParseJSON(dataMap.data) : void 0
 		};
+		if (dataMap.weight !== void 0) edge.weight = parseNumber(dataMap.weight);
+		if (dataMap.x !== void 0) edge.x = parseNumber(dataMap.x);
+		if (dataMap.y !== void 0) edge.y = parseNumber(dataMap.y);
+		if (dataMap.width !== void 0) edge.width = parseNumber(dataMap.width);
+		if (dataMap.height !== void 0) edge.height = parseNumber(dataMap.height);
+		if (dataMap.color !== void 0) edge.color = dataMap.color;
+		if (dataMap.style !== void 0) edge.style = tryParseJSON(dataMap.style);
+		return edge;
 	});
-	return {
+	const graph = {
 		id: String(graphEl["@_id"] ?? ""),
 		type: graphType,
-		initialNodeId: null,
+		initialNodeId: graphDataMap.graphInitialNodeId ?? null,
 		nodes,
 		edges,
 		data: graphData
 	};
+	if (graphDataMap.direction !== void 0) graph.direction = parseDirection(graphDataMap.direction);
+	if (graphDataMap.graphStyle !== void 0) graph.style = tryParseJSON(graphDataMap.graphStyle);
+	return graph;
 }
 function asArray(val) {
 	if (val === void 0) return [];
@@ -237,7 +318,7 @@ function asArray(val) {
 }
 function parseDataElements(dataEls) {
 	const map = {};
-	for (const d of asArray(dataEls)) if (d && d["@_key"]) map[d["@_key"]] = String(d["#text"] ?? "");
+	for (const dataEl of asArray(dataEls)) if (dataEl && dataEl["@_key"]) map[dataEl["@_key"]] = String(dataEl["#text"] ?? "");
 	return map;
 }
 function tryParseJSON(str) {
@@ -247,6 +328,17 @@ function tryParseJSON(str) {
 		return str;
 	}
 }
+function parseNumber(value) {
+	return Number(value);
+}
+function parseDirection(value) {
+	return [
+		"up",
+		"down",
+		"left",
+		"right"
+	].includes(value) ? value : void 0;
+}
 /** Bidirectional converter for GraphML XML format. */
 const graphmlConverter = createFormatConverter(toGraphML, fromGraphML);
 

package/dist/formats/jgf/index.d.mts

@@ -1,4 +1,4 @@
-import { c as Graph, f as GraphFormatConverter } from "../../types-Bq_fmLwW.mjs";
+import { m as GraphFormatConverter, u as Graph } from "../../types-DF-HNw50.mjs";
 
 //#region src/formats/jgf/index.d.ts
 interface JGFNode {

package/dist/formats/jgf/index.mjs

@@ -1,4 +1,4 @@
-import { n as createFormatConverter } from "../../converter-C5DlzzHs.mjs";
+import { n as createFormatConverter } from "../../converter-B5CUD0r9.mjs";
 
 //#region src/formats/jgf/index.ts
 /**

package/dist/formats/mermaid/index.d.mts

@@ -1,11 +1,20 @@
-import { c as Graph, f as GraphFormatConverter } from "../../types-Bq_fmLwW.mjs";
+import { m as GraphFormatConverter, u as Graph } from "../../types-DF-HNw50.mjs";
 
 //#region src/formats/mermaid/sequence.d.ts
 interface SequenceNodeData {
-  actorType: 'participant' | 'actor';
+  actorType: 'participant' | 'actor' | 'boundary' | 'control' | 'entity' | 'database' | 'collections' | 'queue';
   alias?: string;
   created?: boolean;
   destroyed?: boolean;
+  notes?: Array<{
+    position: 'left' | 'right' | 'over';
+    text: string;
+    over?: string[];
+  }>;
+  box?: {
+    title?: string;
+    color?: string;
+  };
 }
 interface SequenceEdgeData {
   kind: 'message' | 'activation' | 'deactivation';
@@ -14,6 +23,11 @@ interface SequenceEdgeData {
   bidirectional?: boolean;
   sequenceNumber?: number;
 }
+/**
+ * Control-flow blocks (loop/alt/par/opt/critical/break/rect).
+ * Not graph topology — they describe ordering constraints.
+ * Stored in `graphData.blocks` for round-trip fidelity.
+ */
 type SequenceBlock = {
   type: 'loop';
   label: string;
@@ -57,7 +71,7 @@ interface SequenceGraphData {
   autonumber?: boolean;
   blocks?: SequenceBlock[];
 }
-type SequenceGraph = Graph<SequenceNodeData, SequenceEdgeData, SequenceGraphData>;
+type MermaidSequenceGraph = Graph<SequenceNodeData, SequenceEdgeData, SequenceGraphData>;
 /**
  * Parses a Mermaid sequence diagram string into a Graph.
  *
@@ -70,7 +84,7 @@ type SequenceGraph = Graph<SequenceNodeData, SequenceEdgeData, SequenceGraphData
  *     Bob-->>Alice: Hi back
  * `);
  */
-declare function fromMermaidSequence(input: string): SequenceGraph;
+declare function fromMermaidSequence(input: string): MermaidSequenceGraph;
 /**
  * Converts a sequence diagram Graph to a Mermaid sequence diagram string.
  *
@@ -78,7 +92,7 @@ declare function fromMermaidSequence(input: string): SequenceGraph;
  * const mermaid = toMermaidSequence(graph);
  * // "sequenceDiagram\n    participant Alice\n    ..."
  */
-declare function toMermaidSequence(graph: SequenceGraph): string;
+declare function toMermaidSequence(graph: MermaidSequenceGraph): string;
 /**
  * Bidirectional converter for Mermaid sequence diagram format.
  *
@@ -89,16 +103,17 @@ declare function toMermaidSequence(graph: SequenceGraph): string;
  * `);
  * const str = mermaidSequenceConverter.to(graph);
  */
-declare const mermaidSequenceConverter: GraphFormatConverter<string>;
+declare const mermaidSequenceConverter: GraphFormatConverter<string, SequenceNodeData, SequenceEdgeData, SequenceGraphData>;
 //#endregion
 //#region src/formats/mermaid/flowchart.d.ts
 interface FlowchartNodeData {
   classes?: string[];
   link?: string;
   tooltip?: string;
+  direction?: 'up' | 'down' | 'left' | 'right';
 }
 interface FlowchartEdgeData {
-  stroke: 'normal' | 'dotted' | 'thick';
+  stroke: 'normal' | 'dotted' | 'thick' | 'invisible';
   arrowType: 'arrow' | 'none';
   endMarker?: 'arrow' | 'circle' | 'cross';
   startMarker?: 'arrow' | 'circle' | 'cross';
@@ -109,7 +124,7 @@ interface FlowchartGraphData {
   diagramType: 'flowchart';
   classDefs?: Record<string, Record<string, string>>;
 }
-type FlowchartGraph = Graph<FlowchartNodeData, FlowchartEdgeData, FlowchartGraphData>;
+type MermaidFlowchartGraph = Graph<FlowchartNodeData, FlowchartEdgeData, FlowchartGraphData>;
 /**
  * Parses a Mermaid flowchart string into a Graph.
  *
@@ -120,7 +135,7 @@ type FlowchartGraph = Graph<FlowchartNodeData, FlowchartEdgeData, FlowchartGraph
  *     B -->|Yes| C[End]
  * `);
  */
-declare function fromMermaidFlowchart(input: string): FlowchartGraph;
+declare function fromMermaidFlowchart(input: string): MermaidFlowchartGraph;
 /**
  * Converts a flowchart Graph to a Mermaid flowchart string.
  *
@@ -128,7 +143,7 @@ declare function fromMermaidFlowchart(input: string): FlowchartGraph;
  * const mermaid = toMermaidFlowchart(graph);
  * // "flowchart TD\n    A[Start] --> B{Decision}\n    ..."
  */
-declare function toMermaidFlowchart(graph: FlowchartGraph): string;
+declare function toMermaidFlowchart(graph: MermaidFlowchartGraph): string;
 /**
  * Bidirectional converter for Mermaid flowchart format.
  *
@@ -139,24 +154,27 @@ declare function toMermaidFlowchart(graph: FlowchartGraph): string;
  * `);
  * const str = mermaidFlowchartConverter.to(graph);
  */
-declare const mermaidFlowchartConverter: GraphFormatConverter<string>;
+declare const mermaidFlowchartConverter: GraphFormatConverter<string, FlowchartNodeData, FlowchartEdgeData, FlowchartGraphData>;
 //#endregion
 //#region src/formats/mermaid/state.d.ts
 interface StateNodeData {
   description?: string;
-  stateType?: 'choice' | 'fork' | 'join';
+  stateType?: 'choice' | 'fork' | 'join' | 'parallel';
   notes?: Array<{
     position: 'left' | 'right';
     text: string;
   }>;
   isStart?: boolean;
   isEnd?: boolean;
+  classes?: string[];
+  direction?: 'up' | 'down' | 'left' | 'right';
 }
 interface StateEdgeData {}
 interface StateGraphData {
   diagramType: 'stateDiagram';
+  classDefs?: Record<string, Record<string, string>>;
 }
-type StateGraph = Graph<StateNodeData, StateEdgeData, StateGraphData>;
+type MermaidStateGraph = Graph<StateNodeData, StateEdgeData, StateGraphData>;
 /**
  * Parses a Mermaid state diagram string into a Graph.
  *
@@ -168,7 +186,7 @@ type StateGraph = Graph<StateNodeData, StateEdgeData, StateGraphData>;
  *     Running --> [*]
  * `);
  */
-declare function fromMermaidState(input: string): StateGraph;
+declare function fromMermaidState(input: string): MermaidStateGraph;
 /**
  * Converts a state diagram Graph to a Mermaid state diagram string.
  *
@@ -176,7 +194,7 @@ declare function fromMermaidState(input: string): StateGraph;
  * const mermaid = toMermaidState(graph);
  * // "stateDiagram-v2\n    [*] --> Idle\n    ..."
  */
-declare function toMermaidState(graph: StateGraph): string;
+declare function toMermaidState(graph: MermaidStateGraph): string;
 /**
  * Bidirectional converter for Mermaid state diagram format.
  *
@@ -187,7 +205,7 @@ declare function toMermaidState(graph: StateGraph): string;
  * `);
  * const str = mermaidStateConverter.to(graph);
  */
-declare const mermaidStateConverter: GraphFormatConverter<string>;
+declare const mermaidStateConverter: GraphFormatConverter<string, StateNodeData, StateEdgeData, StateGraphData>;
 //#endregion
 //#region src/formats/mermaid/class-diagram.d.ts
 interface ClassNodeData {
@@ -208,7 +226,7 @@ interface ClassEdgeData {
 interface ClassGraphData {
   diagramType: 'classDiagram';
 }
-type ClassGraph = Graph<ClassNodeData, ClassEdgeData, ClassGraphData>;
+type MermaidClassGraph = Graph<ClassNodeData, ClassEdgeData, ClassGraphData>;
 /**
  * Parses a Mermaid class diagram string into a Graph.
  *
@@ -222,7 +240,7 @@ type ClassGraph = Graph<ClassNodeData, ClassEdgeData, ClassGraphData>;
  *     Animal <|-- Dog
  * `);
  */
-declare function fromMermaidClass(input: string): ClassGraph;
+declare function fromMermaidClass(input: string): MermaidClassGraph;
 /**
  * Converts a class diagram Graph to a Mermaid class diagram string.
  *
@@ -230,7 +248,7 @@ declare function fromMermaidClass(input: string): ClassGraph;
  * const mermaid = toMermaidClass(graph);
  * // "classDiagram\n    class Animal {\n    ..."
  */
-declare function toMermaidClass(graph: ClassGraph): string;
+declare function toMermaidClass(graph: MermaidClassGraph): string;
 /**
  * Bidirectional converter for Mermaid class diagram format.
  *
@@ -241,7 +259,7 @@ declare function toMermaidClass(graph: ClassGraph): string;
  * `);
  * const str = mermaidClassConverter.to(graph);
  */
-declare const mermaidClassConverter: GraphFormatConverter<string>;
+declare const mermaidClassConverter: GraphFormatConverter<string, ClassNodeData, ClassEdgeData, ClassGraphData>;
 //#endregion
 //#region src/formats/mermaid/er-diagram.d.ts
 interface ERNodeData {
@@ -260,7 +278,7 @@ interface EREdgeData {
 interface ERGraphData {
   diagramType: 'erDiagram';
 }
-type ERGraph = Graph<ERNodeData, EREdgeData, ERGraphData>;
+type MermaidERGraph = Graph<ERNodeData, EREdgeData, ERGraphData>;
 /**
  * Parses a Mermaid ER diagram string into a Graph.
  *
@@ -271,7 +289,7 @@ type ERGraph = Graph<ERNodeData, EREdgeData, ERGraphData>;
  *     ORDER ||--|{ LINE_ITEM : contains
  * `);
  */
-declare function fromMermaidER(input: string): ERGraph;
+declare function fromMermaidER(input: string): MermaidERGraph;
 /**
  * Converts an ER diagram Graph to a Mermaid ER diagram string.
  *
@@ -279,7 +297,7 @@ declare function fromMermaidER(input: string): ERGraph;
  * const mermaid = toMermaidER(graph);
  * // "erDiagram\n    CUSTOMER ||--o{ ORDER : \"places\"\n    ..."
  */
-declare function toMermaidER(graph: ERGraph): string;
+declare function toMermaidER(graph: MermaidERGraph): string;
 /**
  * Bidirectional converter for Mermaid ER diagram format.
  *
@@ -290,7 +308,7 @@ declare function toMermaidER(graph: ERGraph): string;
  * `);
  * const str = mermaidERConverter.to(graph);
  */
-declare const mermaidERConverter: GraphFormatConverter<string>;
+declare const mermaidERConverter: GraphFormatConverter<string, ERNodeData, EREdgeData, ERGraphData>;
 //#endregion
 //#region src/formats/mermaid/mindmap.d.ts
 interface MindmapNodeData {
@@ -300,7 +318,7 @@ interface MindmapEdgeData {}
 interface MindmapGraphData {
   diagramType: 'mindmap';
 }
-type MindmapGraph = Graph<MindmapNodeData, MindmapEdgeData, MindmapGraphData>;
+type MermaidMindmapGraph = Graph<MindmapNodeData, MindmapEdgeData, MindmapGraphData>;
 /**
  * Parses a Mermaid mindmap string into a Graph.
  *
@@ -313,7 +331,7 @@ type MindmapGraph = Graph<MindmapNodeData, MindmapEdgeData, MindmapGraphData>;
  *     Child B
  * `);
  */
-declare function fromMermaidMindmap(input: string): MindmapGraph;
+declare function fromMermaidMindmap(input: string): MermaidMindmapGraph;
 /**
  * Converts a mindmap Graph to a Mermaid mindmap string.
  *
@@ -321,7 +339,7 @@ declare function fromMermaidMindmap(input: string): MindmapGraph;
  * const mermaid = toMermaidMindmap(graph);
  * // "mindmap\n  Root\n    Child A\n    ..."
  */
-declare function toMermaidMindmap(graph: MindmapGraph): string;
+declare function toMermaidMindmap(graph: MermaidMindmapGraph): string;
 /**
  * Bidirectional converter for Mermaid mindmap format.
  *
@@ -333,7 +351,7 @@ declare function toMermaidMindmap(graph: MindmapGraph): string;
  * `);
  * const str = mermaidMindmapConverter.to(graph);
  */
-declare const mermaidMindmapConverter: GraphFormatConverter<string>;
+declare const mermaidMindmapConverter: GraphFormatConverter<string, MindmapNodeData, MindmapEdgeData, MindmapGraphData>;
 //#endregion
 //#region src/formats/mermaid/block.d.ts
 interface BlockNodeData {
@@ -344,7 +362,7 @@ interface BlockGraphData {
   diagramType: 'block';
   columns?: number;
 }
-type BlockGraph = Graph<BlockNodeData, BlockEdgeData, BlockGraphData>;
+type MermaidBlockGraph = Graph<BlockNodeData, BlockEdgeData, BlockGraphData>;
 /**
  * Parses a Mermaid block diagram string into a Graph.
  *
@@ -356,7 +374,7 @@ type BlockGraph = Graph<BlockNodeData, BlockEdgeData, BlockGraphData>;
  *     a --> b
  * `);
  */
-declare function fromMermaidBlock(input: string): BlockGraph;
+declare function fromMermaidBlock(input: string): MermaidBlockGraph;
 /**
  * Converts a block diagram Graph to a Mermaid block diagram string.
  *
@@ -364,7 +382,7 @@ declare function fromMermaidBlock(input: string): BlockGraph;
  * const mermaid = toMermaidBlock(graph);
  * // "block-beta\n    columns 2\n    a[\"Task A\"]\n    ..."
  */
-declare function toMermaidBlock(graph: BlockGraph): string;
+declare function toMermaidBlock(graph: MermaidBlockGraph): string;
 /**
  * Bidirectional converter for Mermaid block diagram format.
  *
@@ -376,6 +394,6 @@ declare function toMermaidBlock(graph: BlockGraph): string;
  * `);
  * const str = mermaidBlockConverter.to(graph);
  */
-declare const mermaidBlockConverter: GraphFormatConverter<string>;
+declare const mermaidBlockConverter: GraphFormatConverter<string, BlockNodeData, BlockEdgeData, BlockGraphData>;
 //#endregion
-export { type BlockEdgeData, type BlockGraphData, type BlockNodeData, type ClassEdgeData, type ClassGraphData, type ClassNodeData, type EREdgeData, type ERGraphData, type ERNodeData, type FlowchartEdgeData, type FlowchartGraphData, type FlowchartNodeData, type MindmapEdgeData, type MindmapGraphData, type MindmapNodeData, type SequenceBlock, type SequenceEdgeData, type SequenceGraphData, type SequenceNodeData, type StateEdgeData, type StateGraphData, type StateNodeData, fromMermaidBlock, fromMermaidClass, fromMermaidER, fromMermaidFlowchart, fromMermaidMindmap, fromMermaidSequence, fromMermaidState, mermaidBlockConverter, mermaidClassConverter, mermaidERConverter, mermaidFlowchartConverter, mermaidMindmapConverter, mermaidSequenceConverter, mermaidStateConverter, toMermaidBlock, toMermaidClass, toMermaidER, toMermaidFlowchart, toMermaidMindmap, toMermaidSequence, toMermaidState };
+export { type BlockEdgeData, type BlockGraphData, type BlockNodeData, type ClassEdgeData, type ClassGraphData, type ClassNodeData, type EREdgeData, type ERGraphData, type ERNodeData, type FlowchartEdgeData, type FlowchartGraphData, type FlowchartNodeData, type MermaidBlockGraph, type MermaidClassGraph, type MermaidERGraph, type MermaidFlowchartGraph, type MermaidMindmapGraph, type MermaidSequenceGraph, type MermaidStateGraph, type MindmapEdgeData, type MindmapGraphData, type MindmapNodeData, type SequenceBlock, type SequenceEdgeData, type SequenceGraphData, type SequenceNodeData, type StateEdgeData, type StateGraphData, type StateNodeData, fromMermaidBlock, fromMermaidClass, fromMermaidER, fromMermaidFlowchart, fromMermaidMindmap, fromMermaidSequence, fromMermaidState, mermaidBlockConverter, mermaidClassConverter, mermaidERConverter, mermaidFlowchartConverter, mermaidMindmapConverter, mermaidSequenceConverter, mermaidStateConverter, toMermaidBlock, toMermaidClass, toMermaidER, toMermaidFlowchart, toMermaidMindmap, toMermaidSequence, toMermaidState };