@statelyai/graph 0.12.0 → 1.0.0

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

@@ -1,4 +1,4 @@
-import { h as GraphFormatConverter, u as Graph } from "../../types-CnZ01raw.mjs";
+import { h as GraphFormatConverter, u as Graph } from "../../types-3-FS9NV2.mjs";
 
 //#region src/formats/graphml/index.d.ts
 declare function toGraphML(graph: Graph): string;

package/dist/formats/graphml/index.mjs

@@ -1,4 +1,5 @@
-import { n as createFormatConverter } from "../../converter-Dspillnn.mjs";
+import { t as getEdgeMode } from "../../mode-D8OnHFBk.mjs";
+import { n as createFormatConverter } from "../../converter-udLITX36.mjs";
 import { XMLBuilder, XMLParser } from "fast-xml-parser";
 
 //#region src/formats/graphml/index.ts
@@ -175,7 +176,9 @@ function toGraphML(graph) {
 			...data.length > 0 && { data }
 		};
 	});
+	const graphDirected = graph.mode !== "undirected";
 	const edges = graph.edges.map((edge) => {
+		const edgeDirected = getEdgeMode(graph, edge) !== "undirected";
 		const data = [];
 		if (edge.label) data.push({
 			"@_key": "label",
@@ -225,6 +228,7 @@ function toGraphML(graph) {
 			"@_id": edge.id,
 			"@_source": edge.sourceId,
 			"@_target": edge.targetId,
+			...edgeDirected !== graphDirected && { "@_directed": edgeDirected ? "true" : "false" },
 			...data.length > 0 && { data }
 		};
 	});
@@ -255,7 +259,7 @@ function toGraphML(graph) {
 			key: keys,
 			graph: {
 				"@_id": graph.id,
-				"@_edgedefault": graph.type === "directed" ? "directed" : "undirected",
+				"@_edgedefault": graph.mode === "undirected" ? "undirected" : "directed",
 				...graphData.length > 0 && { data: graphData },
 				node: nodes,
 				edge: edges
@@ -265,7 +269,8 @@ function toGraphML(graph) {
 	return new XMLBuilder({
 		ignoreAttributes: false,
 		format: true,
-		suppressEmptyNode: true
+		suppressEmptyNode: true,
+		suppressBooleanAttributes: false
 	}).build(obj);
 }
 function fromGraphML(xml) {
@@ -331,11 +336,13 @@ function fromGraphML(xml) {
 		if (dataMap.style !== void 0) edge.style = tryParseJSON(dataMap.style);
 		if (dataMap.sourcePort !== void 0) edge.sourcePort = dataMap.sourcePort;
 		if (dataMap.targetPort !== void 0) edge.targetPort = dataMap.targetPort;
+		const directedAttr = edgeEl["@_directed"];
+		if (directedAttr !== void 0) edge.mode = String(directedAttr) === "false" ? "undirected" : "directed";
 		return edge;
 	});
 	const graph = {
 		id: String(graphEl["@_id"] ?? ""),
-		type: graphType,
+		mode: graphType,
 		initialNodeId: graphDataMap.graphInitialNodeId ?? null,
 		nodes,
 		edges,

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

@@ -1,4 +1,4 @@
-import { h as GraphFormatConverter, u as Graph } from "../../types-CnZ01raw.mjs";
+import { h as GraphFormatConverter, u as Graph } from "../../types-3-FS9NV2.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-Dspillnn.mjs";
+import { n as createFormatConverter } from "../../converter-udLITX36.mjs";
 
 //#region src/formats/jgf/index.ts
 /**
@@ -23,9 +23,10 @@ function toJGF(graph) {
 	if (graph.initialNodeId) metadata.initialNodeId = graph.initialNodeId;
 	if (graph.data !== void 0) metadata.data = graph.data;
 	if (graph.direction) metadata.direction = graph.direction;
+	if (graph.style !== void 0) metadata.style = graph.style;
 	return { graph: {
 		id: graph.id || void 0,
-		directed: graph.type === "directed",
+		directed: graph.mode !== "undirected",
 		...Object.keys(metadata).length > 0 && { metadata },
 		nodes: graph.nodes.map((n) => {
 			const meta = {};
@@ -38,6 +39,7 @@ function toJGF(graph) {
 			if (n.height !== void 0) meta.height = n.height;
 			if (n.shape) meta.shape = n.shape;
 			if (n.color) meta.color = n.color;
+			if (n.style !== void 0) meta.style = n.style;
 			if (n.ports !== void 0) meta.ports = n.ports;
 			return {
 				id: n.id,
@@ -48,7 +50,13 @@ function toJGF(graph) {
 		edges: graph.edges.map((e) => {
 			const meta = {};
 			if (e.data !== void 0) meta.data = e.data;
+			if (e.weight !== void 0) meta.weight = e.weight;
+			if (e.x !== void 0) meta.x = e.x;
+			if (e.y !== void 0) meta.y = e.y;
+			if (e.width !== void 0) meta.width = e.width;
+			if (e.height !== void 0) meta.height = e.height;
 			if (e.color) meta.color = e.color;
+			if (e.style !== void 0) meta.style = e.style;
 			if (e.sourcePort !== void 0) meta.sourcePort = e.sourcePort;
 			if (e.targetPort !== void 0) meta.targetPort = e.targetPort;
 			return {
@@ -85,10 +93,11 @@ function fromJGF(jgf) {
 	if (!Array.isArray(g.edges)) throw new Error("JGF: \"graph.edges\" must be an array");
 	return {
 		id: g.id ?? "",
-		type: g.directed === false ? "undirected" : "directed",
+		mode: g.directed === false ? "undirected" : "directed",
 		initialNodeId: g.metadata?.initialNodeId ?? null,
 		data: g.metadata?.data,
 		...g.metadata?.direction && { direction: g.metadata.direction },
+		...g.metadata?.style !== void 0 && { style: g.metadata.style },
 		nodes: g.nodes.map((n) => ({
 			type: "node",
 			id: n.id,
@@ -102,6 +111,7 @@ function fromJGF(jgf) {
 			...n.metadata?.height !== void 0 && { height: n.metadata.height },
 			...n.metadata?.shape && { shape: n.metadata.shape },
 			...n.metadata?.color && { color: n.metadata.color },
+			...n.metadata?.style !== void 0 && { style: n.metadata.style },
 			...n.metadata?.ports !== void 0 && { ports: n.metadata.ports }
 		})),
 		edges: g.edges.map((e, i) => ({
@@ -111,7 +121,13 @@ function fromJGF(jgf) {
 			targetId: e.target,
 			label: e.label ?? "",
 			data: e.metadata?.data,
+			...e.metadata?.weight !== void 0 && { weight: e.metadata.weight },
+			...e.metadata?.x !== void 0 && { x: e.metadata.x },
+			...e.metadata?.y !== void 0 && { y: e.metadata.y },
+			...e.metadata?.width !== void 0 && { width: e.metadata.width },
+			...e.metadata?.height !== void 0 && { height: e.metadata.height },
 			...e.metadata?.color && { color: e.metadata.color },
+			...e.metadata?.style !== void 0 && { style: e.metadata.style },
 			...e.metadata?.sourcePort !== void 0 && { sourcePort: e.metadata.sourcePort },
 			...e.metadata?.targetPort !== void 0 && { targetPort: e.metadata.targetPort }
 		}))

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

@@ -1,4 +1,4 @@
-import { h as GraphFormatConverter, u as Graph } from "../../types-CnZ01raw.mjs";
+import { h as GraphFormatConverter, u as Graph } from "../../types-3-FS9NV2.mjs";
 
 //#region src/formats/mermaid/sequence.d.ts
 interface SequenceNodeData {
@@ -165,6 +165,7 @@ interface StateNodeData {
   notes?: Array<{
     position: 'left' | 'right';
     text: string;
+    format?: 'inline' | 'block';
   }>;
   isStart?: boolean;
   isEnd?: boolean;

package/dist/formats/mermaid/index.mjs

@@ -1,4 +1,4 @@
-import { n as createFormatConverter } from "../../converter-Dspillnn.mjs";
+import { n as createFormatConverter } from "../../converter-udLITX36.mjs";
 
 //#region src/formats/mermaid/shared.ts
 const MERMAID_TO_DIRECTION = {
@@ -497,7 +497,7 @@ function fromMermaidSequence(input) {
 	}
 	return {
 		id: "",
-		type: "directed",
+		mode: "directed",
 		initialNodeId: null,
 		nodes: Array.from(nodeMap.values()),
 		edges,
@@ -1292,7 +1292,7 @@ function fromMermaidFlowchart(input) {
 	}
 	return {
 		id: "",
-		type: "directed",
+		mode: "directed",
 		initialNodeId: null,
 		nodes: Array.from(nodeMap.values()),
 		edges,
@@ -1415,10 +1415,16 @@ function fromMermaidState(input) {
 	const parentStack = [null];
 	const regionCounters = /* @__PURE__ */ new Map();
 	function ensureNode(id) {
-		if (!nodeMap.has(id)) nodeMap.set(id, {
+		const parentId = parentStack[parentStack.length - 1];
+		const existing = nodeMap.get(id);
+		if (existing) {
+			if (parentId && existing.parentId === null && existing.id !== parentId) existing.parentId = parentId;
+			return existing;
+		}
+		nodeMap.set(id, {
 			type: "node",
 			id,
-			parentId: parentStack[parentStack.length - 1],
+			parentId,
 			initialNodeId: null,
 			label: id,
 			data: {}
@@ -1462,6 +1468,15 @@ function fromMermaidState(input) {
 			parentStack.push(stateId);
 			continue;
 		}
+		const compositeStateAsMatch = line.match(/^state\s+"([^"]+)"\s+as\s+(\S+)\s*\{\s*$/);
+		if (compositeStateAsMatch) {
+			const description = compositeStateAsMatch[1];
+			const stateId = compositeStateAsMatch[2];
+			const node = ensureNode(stateId);
+			node.data.description = description;
+			parentStack.push(stateId);
+			continue;
+		}
 		const stereotypeMatch = line.match(/^state\s+(\S+)\s+<<(choice|fork|join)>>\s*$/);
 		if (stereotypeMatch) {
 			const stateId = stereotypeMatch[1];
@@ -1542,16 +1557,27 @@ function fromMermaidState(input) {
 			}
 			continue;
 		}
-		const noteMatch = line.match(/^note\s+(left|right)\s+of\s+(\S+)\s*:\s*(.+)$/i);
+		const noteMatch = line.match(/^note\s+(left|right)\s+of\s+(\S+)\s*(?::\s*(.*))?$/i);
 		if (noteMatch) {
 			const position = noteMatch[1].toLowerCase();
 			const stateId = noteMatch[2];
-			const text = noteMatch[3].trim();
+			const inlineText = noteMatch[3]?.trim();
+			const text = inlineText && inlineText.length > 0 ? inlineText : (() => {
+				const content = [];
+				while (i + 1 < lines.length) {
+					i++;
+					const noteLine = lines[i].trim();
+					if (/^end\s+note$/i.test(noteLine)) break;
+					content.push(noteLine);
+				}
+				return content.join("\n").trim();
+			})();
 			const node = ensureNode(stateId);
 			if (!node.data.notes) node.data.notes = [];
 			node.data.notes.push({
 				position,
-				text
+				text,
+				format: inlineText && inlineText.length > 0 ? "inline" : "block"
 			});
 			continue;
 		}
@@ -1649,7 +1675,7 @@ function fromMermaidState(input) {
 	}
 	return {
 		id: "",
-		type: "directed",
+		mode: "directed",
 		initialNodeId: null,
 		nodes: Array.from(nodeMap.values()),
 		edges,
@@ -1687,9 +1713,9 @@ function toMermaidState(graph) {
 			if (node.data?.isStart || node.data?.isEnd) continue;
 			if (node.id.includes("_region_")) continue;
 			if (node.data?.stateType && node.data.stateType !== "parallel") lines.push(`${indent}state ${node.id} <<${node.data.stateType}>>`);
-			if (node.data?.description) lines.push(`${indent}state "${escapeMermaidLabel(node.data.description)}" as ${node.id}`);
 			if (isParent.has(node.id)) {
-				lines.push(`${indent}state ${node.id} {`);
+				const stateDecl = node.data?.description ? `state "${escapeMermaidLabel(node.data.description)}" as ${node.id} {` : `state ${node.id} {`;
+				lines.push(`${indent}${stateDecl}`);
 				if (node.data?.direction) {
 					const mDir = DIRECTION_TO_MERMAID[node.data.direction];
 					if (mDir) lines.push(`${indent}    direction ${mDir}`);
@@ -1702,8 +1728,12 @@ function toMermaidState(graph) {
 					}
 				} else writeNodes(node.id, indent + "    ");
 				lines.push(`${indent}}`);
-			}
-			if (node.data?.notes) for (const note of node.data.notes) lines.push(`${indent}note ${note.position} of ${node.id} : ${escapeMermaidLabel(note.text)}`);
+			} else if (node.data?.description) lines.push(`${indent}state "${escapeMermaidLabel(node.data.description)}" as ${node.id}`);
+			if (node.data?.notes) for (const note of node.data.notes) if (note.format === "block" || note.text.includes("\n")) {
+				lines.push(`${indent}note ${note.position} of ${node.id}`);
+				for (const noteLine of note.text.split("\n")) lines.push(`${indent}    ${escapeMermaidLabel(noteLine)}`);
+				lines.push(`${indent}end note`);
+			} else lines.push(`${indent}note ${note.position} of ${node.id} : ${escapeMermaidLabel(note.text)}`);
 		}
 	}
 	writeNodes(null, "    ");
@@ -2023,7 +2053,7 @@ function fromMermaidClass(input) {
 	}
 	return {
 		id: "",
-		type: "directed",
+		mode: "directed",
 		initialNodeId: null,
 		nodes: Array.from(nodeMap.values()),
 		edges,
@@ -2221,7 +2251,7 @@ function fromMermaidER(input) {
 	}
 	return {
 		id: "",
-		type: "directed",
+		mode: "directed",
 		initialNodeId: null,
 		nodes: Array.from(nodeMap.values()),
 		edges,
@@ -2379,7 +2409,7 @@ function fromMermaidMindmap(input) {
 	}
 	return {
 		id: "",
-		type: "directed",
+		mode: "directed",
 		initialNodeId: null,
 		nodes: Array.from(nodeMap.values()),
 		edges,
@@ -2578,7 +2608,7 @@ function fromMermaidBlock(input) {
 	}
 	return {
 		id: "",
-		type: "directed",
+		mode: "directed",
 		initialNodeId: null,
 		nodes: Array.from(nodeMap.values()),
 		edges,
@@ -2690,7 +2720,7 @@ function fromMermaidIshikawa(input) {
 	}
 	return {
 		id: "",
-		type: "directed",
+		mode: "directed",
 		initialNodeId: null,
 		nodes,
 		edges,

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

@@ -1,4 +1,4 @@
-import { h as GraphFormatConverter, u as Graph } from "../../types-CnZ01raw.mjs";
+import { h as GraphFormatConverter, u as Graph } from "../../types-3-FS9NV2.mjs";
 
 //#region src/formats/tgf/index.d.ts
 

package/dist/formats/tgf/index.mjs

@@ -1,4 +1,4 @@
-import { n as createFormatConverter } from "../../converter-Dspillnn.mjs";
+import { n as createFormatConverter } from "../../converter-udLITX36.mjs";
 
 //#region src/formats/tgf/index.ts
 /**
@@ -81,7 +81,7 @@ function fromTGF(tgf) {
 	}
 	return {
 		id: "",
-		type: "directed",
+		mode: "directed",
 		initialNodeId: null,
 		nodes,
 		edges,

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

@@ -1,4 +1,4 @@
-import { P as VisualGraphFormatConverter, j as VisualGraph } from "../../types-CnZ01raw.mjs";
+import { F as VisualGraphFormatConverter, M as VisualGraph } from "../../types-3-FS9NV2.mjs";
 import { EdgeBase, NodeBase } from "@xyflow/system";
 
 //#region src/formats/xyflow/index.d.ts
@@ -9,6 +9,7 @@ type XYFlowEdge<TEdgeData extends Record<string, unknown> = Record<string, unkno
 interface XYFlow<TNodeData extends Record<string, unknown> = Record<string, unknown>, TEdgeData extends Record<string, unknown> = Record<string, unknown>> {
   nodes: XYFlowNode<TNodeData>[];
   edges: XYFlowEdge<TEdgeData>[];
+  data?: Record<string, unknown>;
 }
 /**
  * Converts a visual graph to xyflow (React Flow / Svelte Flow) format.

package/dist/formats/xyflow/index.mjs

@@ -1,4 +1,27 @@
 //#region src/formats/xyflow/index.ts
+const STATELYAI_METADATA_KEY = "__statelyai";
+function toDataObject(value) {
+	return value && typeof value === "object" && !Array.isArray(value) ? { ...value } : {};
+}
+function withMetadata(value, metadata) {
+	return {
+		...toDataObject(value),
+		[STATELYAI_METADATA_KEY]: {
+			...value !== void 0 && { data: value },
+			...metadata
+		}
+	};
+}
+function readMetadata(value) {
+	if (!value || typeof value !== "object") return void 0;
+	const metadata = value[STATELYAI_METADATA_KEY];
+	return metadata && typeof metadata === "object" ? metadata : void 0;
+}
+function readUserData(value) {
+	const metadata = readMetadata(value);
+	if (metadata && "data" in metadata) return metadata.data;
+	return value;
+}
 /**
 * Converts a visual graph to xyflow (React Flow / Svelte Flow) format.
 *
@@ -21,6 +44,14 @@
 */
 function toXYFlow(graph) {
 	return {
+		data: { [STATELYAI_METADATA_KEY]: { graph: {
+			id: graph.id,
+			mode: graph.mode,
+			initialNodeId: graph.initialNodeId,
+			data: graph.data,
+			direction: graph.direction,
+			style: graph.style
+		} } },
 		nodes: graph.nodes.map((n) => {
 			const node = {
 				id: n.id,
@@ -28,12 +59,18 @@ function toXYFlow(graph) {
 					x: n.x,
 					y: n.y
 				},
-				data: n.data ?? {}
+				data: withMetadata(n.data, { node: {
+					initialNodeId: n.initialNodeId,
+					label: n.label,
+					color: n.color,
+					style: n.style,
+					ports: n.ports
+				} })
 			};
 			if (n.parentId) node.parentId = n.parentId;
 			if (n.shape) node.type = n.shape;
-			if (n.width) node.width = n.width;
-			if (n.height) node.height = n.height;
+			if (n.width !== void 0) node.width = n.width;
+			if (n.height !== void 0) node.height = n.height;
 			return node;
 		}),
 		edges: graph.edges.map((e) => {
@@ -44,11 +81,17 @@ function toXYFlow(graph) {
 			};
 			if (e.sourcePort) edge.sourceHandle = e.sourcePort;
 			if (e.targetPort) edge.targetHandle = e.targetPort;
-			if (e.data !== void 0) edge.data = e.data;
-			if (e.label) edge.data = {
-				...edge.data,
-				label: e.label
-			};
+			edge.data = withMetadata(e.data, { edge: {
+				label: e.label,
+				weight: e.weight,
+				color: e.color,
+				style: e.style,
+				x: e.x,
+				y: e.y,
+				width: e.width,
+				height: e.height
+			} });
+			if (e.label) edge.data.label = e.label;
 			return edge;
 		})
 	};
@@ -73,39 +116,53 @@ function fromXYFlow(flow) {
 	if (!flow || typeof flow !== "object") throw new Error("XYFlow: expected an object");
 	if (!Array.isArray(flow.nodes)) throw new Error("XYFlow: \"nodes\" must be an array");
 	if (!Array.isArray(flow.edges)) throw new Error("XYFlow: \"edges\" must be an array");
+	const graphMetadata = readMetadata(flow.data)?.graph;
 	return {
-		id: "",
-		type: "directed",
-		initialNodeId: null,
-		data: void 0,
-		direction: "down",
-		nodes: flow.nodes.map((n) => ({
-			type: "node",
-			id: n.id,
-			parentId: n.parentId ?? null,
-			initialNodeId: null,
-			label: "",
-			data: n.data,
-			x: n.position.x,
-			y: n.position.y,
-			width: n.measured?.width ?? n.width ?? n.initialWidth ?? 0,
-			height: n.measured?.height ?? n.height ?? n.initialHeight ?? 0,
-			...n.type && { shape: n.type }
-		})),
-		edges: flow.edges.map((e, i) => ({
-			type: "edge",
-			id: e.id ?? `e${i}`,
-			sourceId: e.source,
-			targetId: e.target,
-			label: e.data?.label?.toString() ?? "",
-			...e.sourceHandle && { sourcePort: e.sourceHandle },
-			...e.targetHandle && { targetPort: e.targetHandle },
-			data: e.data,
-			x: 0,
-			y: 0,
-			width: 0,
-			height: 0
-		}))
+		id: graphMetadata?.id?.toString() ?? "",
+		mode: graphMetadata?.mode ?? "directed",
+		initialNodeId: graphMetadata && "initialNodeId" in graphMetadata ? graphMetadata.initialNodeId : null,
+		data: graphMetadata && "data" in graphMetadata ? graphMetadata.data : void 0,
+		direction: graphMetadata?.direction ?? "down",
+		...graphMetadata?.style !== void 0 && { style: graphMetadata.style },
+		nodes: flow.nodes.map((n) => {
+			const metadata = readMetadata(n.data)?.node;
+			return {
+				type: "node",
+				id: n.id,
+				parentId: n.parentId ?? null,
+				initialNodeId: metadata && "initialNodeId" in metadata ? metadata.initialNodeId : null,
+				label: metadata && "label" in metadata ? metadata.label : "",
+				data: readUserData(n.data),
+				x: n.position.x,
+				y: n.position.y,
+				width: n.measured?.width ?? n.width ?? n.initialWidth ?? 0,
+				height: n.measured?.height ?? n.height ?? n.initialHeight ?? 0,
+				...n.type && { shape: n.type },
+				...metadata?.color !== void 0 && { color: metadata.color },
+				...metadata?.style !== void 0 && { style: metadata.style },
+				...metadata?.ports !== void 0 && { ports: metadata.ports }
+			};
+		}),
+		edges: flow.edges.map((e, i) => {
+			const metadata = readMetadata(e.data)?.edge;
+			return {
+				type: "edge",
+				id: e.id ?? `e${i}`,
+				sourceId: e.source,
+				targetId: e.target,
+				label: metadata && "label" in metadata ? metadata.label : e.data?.label?.toString() ?? "",
+				...e.sourceHandle && { sourcePort: e.sourceHandle },
+				...e.targetHandle && { targetPort: e.targetHandle },
+				data: readUserData(e.data),
+				x: metadata?.x ?? 0,
+				y: metadata?.y ?? 0,
+				width: metadata?.width ?? 0,
+				height: metadata?.height ?? 0,
+				...metadata?.weight !== void 0 && { weight: metadata.weight },
+				...metadata?.color !== void 0 && { color: metadata.color },
+				...metadata?.style !== void 0 && { style: metadata.style }
+			};
+		})
 	};
 }
 /**