@statelyai/graph 1.0.0 → 2.1.0

package/dist/formats/elk/index.mjs

@@ -1,4 +1,4 @@
-import { getChildren } from "../../queries.mjs";
+import { n as getChildren } from "../../queries-BMM0XAv_.mjs";
 
 //#region src/formats/elk/index.ts
 const STATELYAI_METADATA_KEY = "statelyai.metadata";
@@ -33,16 +33,21 @@ const ELK_TO_DIRECTION = {
 function convertEdge(edge) {
 	const elkEdge = {
 		id: edge.id,
-		sources: [edge.sourcePort ?? edge.sourceId],
-		targets: [edge.targetPort ?? edge.targetId]
+		sources: [edge.sourcePort != null ? `${edge.sourceId}__${edge.sourcePort}` : edge.sourceId],
+		targets: [edge.targetPort != null ? `${edge.targetId}__${edge.targetPort}` : edge.targetId]
 	};
-	if (edge.label) elkEdge.labels = [{ text: edge.label }];
+	if (edge.label) elkEdge.labels = [{
+		text: edge.label,
+		...edge.width > 0 && { width: edge.width },
+		...edge.height > 0 && { height: edge.height }
+	}];
 	return addMetadata(elkEdge, { edge: {
 		sourceId: edge.sourceId,
 		targetId: edge.targetId,
 		sourcePort: edge.sourcePort,
 		targetPort: edge.targetPort,
 		label: edge.label,
+		mode: edge.mode,
 		data: edge.data,
 		weight: edge.weight,
 		color: edge.color,
@@ -50,12 +55,14 @@ function convertEdge(edge) {
 		x: edge.x,
 		y: edge.y,
 		width: edge.width,
-		height: edge.height
+		height: edge.height,
+		points: edge.points,
+		routing: edge.routing
 	} });
 }
-function convertPort(port) {
+function convertPort(nodeId, port) {
 	const elkPort = {
-		id: port.name,
+		id: `${nodeId}__${port.name}`,
 		x: port.x,
 		y: port.y,
 		width: port.width,
@@ -64,6 +71,7 @@ function convertPort(port) {
 	if (port.label) elkPort.labels = [{ text: port.label }];
 	if (port.direction !== "inout") elkPort.layoutOptions = { "org.eclipse.elk.port.side": port.direction === "in" ? "WEST" : "EAST" };
 	return addMetadata(elkPort, { port: {
+		name: port.name,
 		data: port.data,
 		style: port.style
 	} });
@@ -77,7 +85,7 @@ function convertNode(graph, node) {
 		height: node.height
 	};
 	if (node.label) elkNode.labels = [{ text: node.label }];
-	if (node.ports && node.ports.length > 0) elkNode.ports = node.ports.map(convertPort);
+	if (node.ports && node.ports.length > 0) elkNode.ports = node.ports.map((port) => convertPort(node.id, port));
 	addMetadata(elkNode, { node: {
 		initialNodeId: node.initialNodeId,
 		data: node.data,
@@ -146,7 +154,7 @@ function toELK(graph) {
 	if (rootEdges.length > 0) root.edges = rootEdges.map(convertEdge);
 	return root;
 }
-function flattenElkNodes(elkNode, parentId, nodes, edges, edgeIdx, portOwner) {
+function flattenElkNodes(elkNode, parentId, nodes, edges, edgeIdx, portOwner, edgeRouting) {
 	if (elkNode.children) for (const child of elkNode.children) {
 		const label = child.labels?.[0]?.text ?? "";
 		const metadata = readMetadata(child)?.node;
@@ -166,14 +174,18 @@ function flattenElkNodes(elkNode, parentId, nodes, edges, edgeIdx, portOwner) {
 			...metadata?.style !== void 0 && { style: metadata.style }
 		};
 		if (child.ports && child.ports.length > 0) node.ports = child.ports.map((elkPort) => {
-			portOwner.set(elkPort.id, child.id);
 			const metadata$1 = readMetadata(elkPort)?.port;
+			const portName = metadata$1?.name ?? elkPort.id;
+			portOwner.set(elkPort.id, {
+				nodeId: child.id,
+				portName
+			});
 			const sideOpt = elkPort.layoutOptions?.["org.eclipse.elk.port.side"];
 			let direction = "inout";
 			if (sideOpt === "WEST") direction = "in";
 			else if (sideOpt === "EAST") direction = "out";
 			return {
-				name: elkPort.id,
+				name: portName,
 				direction,
 				label: elkPort.labels?.[0]?.text,
 				data: metadata$1 && "data" in metadata$1 ? metadata$1.data : void 0,
@@ -185,31 +197,55 @@ function flattenElkNodes(elkNode, parentId, nodes, edges, edgeIdx, portOwner) {
 			};
 		});
 		nodes.push(node);
-		flattenElkNodes(child, child.id, nodes, edges, edgeIdx, portOwner);
+		flattenElkNodes(child, child.id, nodes, edges, edgeIdx, portOwner, edgeRouting);
 	}
 	if (elkNode.edges) for (const elkEdge of elkNode.edges) for (const source of elkEdge.sources) for (const target of elkEdge.targets) {
 		const metadata = readMetadata(elkEdge)?.edge;
-		const sourceNodeId = portOwner.get(source);
-		const targetNodeId = portOwner.get(target);
+		const sourceOwner = portOwner.get(source);
+		const targetOwner = portOwner.get(target);
+		const elkLabel = elkEdge.labels?.[0];
+		const hasComputedLabel = elkLabel?.x !== void 0 && elkLabel?.y !== void 0;
+		const section = elkEdge.sections?.[0];
 		const edge = {
 			type: "edge",
 			id: elkEdge.id ?? `e${edgeIdx.value++}`,
-			sourceId: metadata?.sourceId ?? sourceNodeId ?? source,
-			targetId: metadata?.targetId ?? targetNodeId ?? target,
-			label: metadata && "label" in metadata ? metadata.label : elkEdge.labels?.[0]?.text ?? "",
+			sourceId: metadata?.sourceId ?? sourceOwner?.nodeId ?? source,
+			targetId: metadata?.targetId ?? targetOwner?.nodeId ?? target,
+			label: metadata && "label" in metadata ? metadata.label : elkLabel?.text ?? "",
 			data: metadata && "data" in metadata ? metadata.data : void 0,
-			x: metadata?.x ?? 0,
-			y: metadata?.y ?? 0,
-			width: metadata?.width ?? 0,
-			height: metadata?.height ?? 0,
+			x: hasComputedLabel ? elkLabel.x : metadata?.x ?? 0,
+			y: hasComputedLabel ? elkLabel.y : metadata?.y ?? 0,
+			width: hasComputedLabel ? elkLabel.width ?? metadata?.width ?? 0 : metadata?.width ?? 0,
+			height: hasComputedLabel ? elkLabel.height ?? metadata?.height ?? 0 : metadata?.height ?? 0,
+			...metadata?.mode !== void 0 && { mode: metadata.mode },
 			...metadata?.weight !== void 0 && { weight: metadata.weight },
 			...metadata?.color !== void 0 && { color: metadata.color },
 			...metadata?.style !== void 0 && { style: metadata.style }
 		};
+		if (section?.startPoint && section.endPoint) {
+			edge.points = [
+				{
+					x: section.startPoint.x,
+					y: section.startPoint.y
+				},
+				...(section.bendPoints ?? []).map((p) => ({
+					x: p.x,
+					y: p.y
+				})),
+				{
+					x: section.endPoint.x,
+					y: section.endPoint.y
+				}
+			];
+			edge.routing = edgeRouting;
+		} else if (metadata?.points !== void 0) {
+			edge.points = metadata.points;
+			if (metadata.routing !== void 0) edge.routing = metadata.routing;
+		}
 		if (metadata && "sourcePort" in metadata) edge.sourcePort = metadata.sourcePort;
-		else if (sourceNodeId) edge.sourcePort = source;
+		else if (sourceOwner) edge.sourcePort = sourceOwner.portName;
 		if (metadata && "targetPort" in metadata) edge.targetPort = metadata.targetPort;
-		else if (targetNodeId) edge.targetPort = target;
+		else if (targetOwner) edge.targetPort = targetOwner.portName;
 		edges.push(edge);
 	}
 }
@@ -236,7 +272,10 @@ function flattenElkNodes(elkNode, parentId, nodes, edges, edgeIdx, portOwner) {
 function fromELK(elkRoot) {
 	const nodes = [];
 	const edges = [];
-	flattenElkNodes(elkRoot, null, nodes, edges, { value: 0 }, /* @__PURE__ */ new Map());
+	const edgeIdx = { value: 0 };
+	const portOwner = /* @__PURE__ */ new Map();
+	const elkEdgeRouting = String(elkRoot.layoutOptions?.["elk.edgeRouting"] ?? elkRoot.layoutOptions?.["org.eclipse.elk.edgeRouting"] ?? "").toUpperCase();
+	flattenElkNodes(elkRoot, null, nodes, edges, edgeIdx, portOwner, elkEdgeRouting === "SPLINES" ? "splines" : elkEdgeRouting === "POLYLINE" ? "polyline" : "orthogonal");
 	const seenEdges = /* @__PURE__ */ new Map();
 	for (const edge of edges) if (!seenEdges.has(edge.id)) seenEdges.set(edge.id, edge);
 	const elkDir = elkRoot.layoutOptions?.["elk.direction"];

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

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

package/dist/formats/gexf/index.mjs

@@ -1,5 +1,5 @@
-import { t as getEdgeMode } from "../../mode-D8OnHFBk.mjs";
-import { n as createFormatConverter } from "../../converter-udLITX36.mjs";
+import { t as getEdgeMode } from "../../mode-gu_mhKKs.mjs";
+import { n as createFormatConverter } from "../../converter-DB6Rg6Vd.mjs";
 import { XMLBuilder, XMLParser } from "fast-xml-parser";
 
 //#region src/formats/gexf/index.ts
@@ -82,6 +82,16 @@ function toGEXF(graph) {
 			"@_title": "style",
 			"@_type": "string"
 		},
+		{
+			"@_id": "a_edgePoints",
+			"@_title": "points",
+			"@_type": "string"
+		},
+		{
+			"@_id": "a_edgeRouting",
+			"@_title": "routing",
+			"@_type": "string"
+		},
 		{
 			"@_id": "a_sourcePort",
 			"@_title": "sourcePort",
@@ -129,7 +139,7 @@ function toGEXF(graph) {
 		});
 		const node = {
 			"@_id": n.id,
-			"@_label": n.label || n.id
+			"@_label": n.label ?? ""
 		};
 		if (n.parentId) node["@_pid"] = n.parentId;
 		if (attvalues.length > 0) node.attvalues = { attvalue: attvalues };
@@ -167,6 +177,14 @@ function toGEXF(graph) {
 			"@_for": "a_edgeWeight",
 			"@_value": e.weight
 		});
+		if (e.points !== void 0) edgeAttvalues.push({
+			"@_for": "a_edgePoints",
+			"@_value": JSON.stringify(e.points)
+		});
+		if (e.routing !== void 0) edgeAttvalues.push({
+			"@_for": "a_edgeRouting",
+			"@_value": e.routing
+		});
 		if (e.x !== void 0) edgeAttvalues.push({
 			"@_for": "a_edgeX",
 			"@_value": e.x
@@ -250,7 +268,8 @@ function fromGEXF(xml) {
 			"attribute",
 			"attvalue",
 			"attributes"
-		].includes(name)
+		].includes(name),
+		trimValues: false
 	});
 	let parsed;
 	try {
@@ -283,16 +302,16 @@ function fromGEXF(xml) {
 			if (attvals["ports"] !== void 0) node.ports = tryParseJSON(attvals["ports"]);
 			const pos = n["viz:position"];
 			if (pos) {
-				node.x = Number(pos["@_x"] ?? 0);
-				node.y = Number(pos["@_y"] ?? 0);
+				node.x = parseNumber(pos["@_x"] ?? 0, "<viz:position> x", "node", id);
+				node.y = parseNumber(pos["@_y"] ?? 0, "<viz:position> y", "node", id);
 			}
 			const size = n["viz:size"];
 			if (size) {
-				node.width = Number(size["@_value"] ?? 0);
-				node.height = Number(size["@_value"] ?? 0);
+				node.width = parseNumber(size["@_value"] ?? 0, "<viz:size>", "node", id);
+				node.height = node.width;
 			}
-			if (attvals["width"] !== void 0) node.width = Number(attvals["width"]);
-			if (attvals["height"] !== void 0) node.height = Number(attvals["height"]);
+			if (attvals["width"] !== void 0) node.width = parseNumber(attvals["width"], "width attribute", "node", id);
+			if (attvals["height"] !== void 0) node.height = parseNumber(attvals["height"], "height attribute", "node", id);
 			const color = n["viz:color"];
 			if (color) {
 				const r = Number(color["@_r"] ?? 0);
@@ -308,18 +327,21 @@ function fromGEXF(xml) {
 	parseNodes(graphEl.nodes?.node ?? graphEl.node, null);
 	const edges = asArray(graphEl.edges?.edge ?? graphEl.edge).map((e, i) => {
 		const attvals = getAttValues(e, attrMap);
+		const id = String(e["@_id"] ?? `e${i}`);
 		const edge = {
 			type: "edge",
-			id: String(e["@_id"] ?? `e${i}`),
+			id,
 			sourceId: String(e["@_source"]),
 			targetId: String(e["@_target"]),
 			label: e["@_label"] ?? "",
 			data: attvals["data"] !== void 0 ? tryParseJSON(attvals["data"]) : void 0,
-			...attvals["weight"] !== void 0 && { weight: Number(attvals["weight"]) },
-			...attvals["x"] !== void 0 && { x: Number(attvals["x"]) },
-			...attvals["y"] !== void 0 && { y: Number(attvals["y"]) },
-			...attvals["width"] !== void 0 && { width: Number(attvals["width"]) },
-			...attvals["height"] !== void 0 && { height: Number(attvals["height"]) },
+			...attvals["weight"] !== void 0 && { weight: parseNumber(attvals["weight"], "weight attribute", "edge", id) },
+			...attvals["points"] !== void 0 && { points: tryParseJSON(attvals["points"]) },
+			...attvals["routing"] !== void 0 && { routing: attvals["routing"] },
+			...attvals["x"] !== void 0 && { x: parseNumber(attvals["x"], "x attribute", "edge", id) },
+			...attvals["y"] !== void 0 && { y: parseNumber(attvals["y"], "y attribute", "edge", id) },
+			...attvals["width"] !== void 0 && { width: parseNumber(attvals["width"], "width attribute", "edge", id) },
+			...attvals["height"] !== void 0 && { height: parseNumber(attvals["height"], "height attribute", "edge", id) },
 			...attvals["style"] !== void 0 && { style: tryParseJSON(attvals["style"]) },
 			...attvals["sourcePort"] !== void 0 && { sourcePort: attvals["sourcePort"] },
 			...attvals["targetPort"] !== void 0 && { targetPort: attvals["targetPort"] }
@@ -366,6 +388,11 @@ function tryParseJSON(str) {
 		return str;
 	}
 }
+function parseNumber(value, field, kind, ownerId) {
+	const parsed = Number(value);
+	if (Number.isNaN(parsed)) throw new Error(`GEXF: ${field} value "${value}" on ${kind} "${ownerId}" is not a number. Fix the value or remove the attribute.`);
+	return parsed;
+}
 function hex(n) {
 	return n.toString(16).padStart(2, "0");
 }

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

@@ -1,4 +1,4 @@
-import { h as GraphFormatConverter, u as Graph } from "../../types-3-FS9NV2.mjs";
+import { _ as GraphFormatConverter, f as Graph } from "../../types-BAEQTwK_.mjs";
 
 //#region src/formats/gml/index.d.ts
 
@@ -8,7 +8,7 @@ import { h as GraphFormatConverter, u as Graph } from "../../types-3-FS9NV2.mjs"
  * @example
  * ```ts
  * import { createGraph } from '@statelyai/graph';
- * import { toGML } from '@statelyai/graph/formats/gml';
+ * import { toGML } from '@statelyai/graph/gml';
  *
  * const graph = createGraph({
  *   nodes: [{ id: 'a' }, { id: 'b' }],
@@ -30,7 +30,7 @@ declare function toGML(graph: Graph): string;
  *
  * @example
  * ```ts
- * import { fromGML } from '@statelyai/graph/formats/gml';
+ * import { fromGML } from '@statelyai/graph/gml';
  *
  * const graph = fromGML(`
  *   graph [
@@ -49,7 +49,7 @@ declare function fromGML(gml: string): Graph;
  * @example
  * ```ts
  * import { createGraph } from '@statelyai/graph';
- * import { gmlConverter } from '@statelyai/graph/formats/gml';
+ * import { gmlConverter } from '@statelyai/graph/gml';
  *
  * const graph = createGraph({
  *   nodes: [{ id: 'a' }, { id: 'b' }],

package/dist/formats/gml/index.mjs

@@ -1,4 +1,4 @@
-import { n as createFormatConverter } from "../../converter-udLITX36.mjs";
+import { n as createFormatConverter } from "../../converter-DB6Rg6Vd.mjs";
 
 //#region src/formats/gml/index.ts
 /**
@@ -7,7 +7,7 @@ import { n as createFormatConverter } from "../../converter-udLITX36.mjs";
 * @example
 * ```ts
 * import { createGraph } from '@statelyai/graph';
-* import { toGML } from '@statelyai/graph/formats/gml';
+* import { toGML } from '@statelyai/graph/gml';
 *
 * const graph = createGraph({
 *   nodes: [{ id: 'a' }, { id: 'b' }],
@@ -27,6 +27,7 @@ function toGML(graph) {
 	const lines = [];
 	lines.push("graph [");
 	lines.push(`  directed ${graph.mode === "undirected" ? 0 : 1}`);
+	if (graph.mode === "bidirectional") lines.push(`  mode ${gmlString(graph.mode)}`);
 	if (graph.id) lines.push(`  id ${gmlString(graph.id)}`);
 	if (graph.initialNodeId) lines.push(`  initialNodeId ${gmlString(graph.initialNodeId)}`);
 	if (graph.data !== void 0) lines.push(`  data ${gmlString(JSON.stringify(graph.data))}`);
@@ -67,9 +68,12 @@ function toGML(graph) {
 		lines.push(`    id ${gmlString(edge.id)}`);
 		lines.push(`    source ${gmlString(edge.sourceId)}`);
 		lines.push(`    target ${gmlString(edge.targetId)}`);
+		if (edge.mode) lines.push(`    mode ${gmlString(edge.mode)}`);
 		if (edge.label) lines.push(`    label ${gmlString(edge.label)}`);
 		if (edge.data !== void 0) lines.push(`    data ${gmlString(JSON.stringify(edge.data))}`);
 		if (edge.weight !== void 0) lines.push(`    weight ${edge.weight}`);
+		if (edge.points !== void 0) lines.push(`    points ${gmlString(JSON.stringify(edge.points))}`);
+		if (edge.routing !== void 0) lines.push(`    routing ${gmlString(edge.routing)}`);
 		if (edge.sourcePort !== void 0) lines.push(`    sourcePort ${gmlString(edge.sourcePort)}`);
 		if (edge.targetPort !== void 0) lines.push(`    targetPort ${gmlString(edge.targetPort)}`);
 		if (edge.color) lines.push(`    color ${gmlString(edge.color)}`);
@@ -95,7 +99,7 @@ function gmlString(s) {
 *
 * @example
 * ```ts
-* import { fromGML } from '@statelyai/graph/formats/gml';
+* import { fromGML } from '@statelyai/graph/gml';
 *
 * const graph = fromGML(`
 *   graph [
@@ -134,10 +138,10 @@ function fromGML(gml) {
 				...n["shape"] && { shape: n["shape"] },
 				...n["color"] && { color: n["color"] },
 				...n["style"] !== void 0 && { style: tryParseJSON(n["style"]) },
-				...gfx?.x !== void 0 && { x: gfx.x },
-				...gfx?.y !== void 0 && { y: gfx.y },
-				...gfx?.w !== void 0 && { width: gfx.w },
-				...gfx?.h !== void 0 && { height: gfx.h }
+				...gfx?.x !== void 0 && { x: parseNumber(gfx.x, "graphics x", "node", id) },
+				...gfx?.y !== void 0 && { y: parseNumber(gfx.y, "graphics y", "node", id) },
+				...gfx?.w !== void 0 && { width: parseNumber(gfx.w, "graphics w", "node", id) },
+				...gfx?.h !== void 0 && { height: parseNumber(gfx.h, "graphics h", "node", id) }
 			});
 			if (n["node"] !== void 0) parseNodes(n, id);
 		}
@@ -146,27 +150,31 @@ function fromGML(gml) {
 	const edgeEntries = asArray(graphBlock["edge"]);
 	for (const e of edgeEntries) {
 		const gfx = e["graphics"];
+		const id = String(e["id"] ?? `e${edges.length}`);
 		edges.push({
 			type: "edge",
-			id: String(e["id"] ?? `e${edges.length}`),
+			id,
 			sourceId: String(e["source"] ?? ""),
 			targetId: String(e["target"] ?? ""),
 			label: e["label"] ?? "",
+			...e["mode"] && { mode: String(e["mode"]) },
 			data: e["data"] !== void 0 ? tryParseJSON(e["data"]) : void 0,
-			...e["weight"] !== void 0 && { weight: Number(e["weight"]) },
+			...e["weight"] !== void 0 && { weight: parseNumber(e["weight"], "weight", "edge", id) },
+			...e["points"] !== void 0 && { points: tryParseJSON(e["points"]) },
+			...e["routing"] !== void 0 && { routing: String(e["routing"]) },
 			...e["sourcePort"] !== void 0 && { sourcePort: String(e["sourcePort"]) },
 			...e["targetPort"] !== void 0 && { targetPort: String(e["targetPort"]) },
 			...e["color"] && { color: e["color"] },
 			...e["style"] !== void 0 && { style: tryParseJSON(e["style"]) },
-			...gfx?.x !== void 0 && { x: gfx.x },
-			...gfx?.y !== void 0 && { y: gfx.y },
-			...gfx?.w !== void 0 && { width: gfx.w },
-			...gfx?.h !== void 0 && { height: gfx.h }
+			...gfx?.x !== void 0 && { x: parseNumber(gfx.x, "graphics x", "edge", id) },
+			...gfx?.y !== void 0 && { y: parseNumber(gfx.y, "graphics y", "edge", id) },
+			...gfx?.w !== void 0 && { width: parseNumber(gfx.w, "graphics w", "edge", id) },
+			...gfx?.h !== void 0 && { height: parseNumber(gfx.h, "graphics h", "edge", id) }
 		});
 	}
 	return {
 		id: graphId,
-		mode: directed ? "directed" : "undirected",
+		mode: graphBlock["mode"] ? String(graphBlock["mode"]) : directed ? "directed" : "undirected",
 		initialNodeId: graphBlock["initialNodeId"] ?? null,
 		nodes,
 		edges,
@@ -301,13 +309,18 @@ function tryParseJSON(str) {
 		return str;
 	}
 }
+function parseNumber(value, field, kind, ownerId) {
+	const parsed = Number(value);
+	if (Number.isNaN(parsed)) throw new Error(`GML: ${field} value "${value}" on ${kind} "${ownerId}" is not a number. Fix the value or remove the attribute.`);
+	return parsed;
+}
 /**
 * Bidirectional converter for GML (Graph Modelling Language) format.
 *
 * @example
 * ```ts
 * import { createGraph } from '@statelyai/graph';
-* import { gmlConverter } from '@statelyai/graph/formats/gml';
+* import { gmlConverter } from '@statelyai/graph/gml';
 *
 * const graph = createGraph({
 *   nodes: [{ id: 'a' }, { id: 'b' }],

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

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

package/dist/formats/graphml/index.mjs

@@ -1,5 +1,5 @@
-import { t as getEdgeMode } from "../../mode-D8OnHFBk.mjs";
-import { n as createFormatConverter } from "../../converter-udLITX36.mjs";
+import { t as getEdgeMode } from "../../mode-gu_mhKKs.mjs";
+import { n as createFormatConverter } from "../../converter-DB6Rg6Vd.mjs";
 import { XMLBuilder, XMLParser } from "fast-xml-parser";
 
 //#region src/formats/graphml/index.ts
@@ -102,6 +102,18 @@ function toGraphML(graph) {
 			"@_attr.name": "weight",
 			"@_attr.type": "double"
 		},
+		{
+			"@_id": "points",
+			"@_for": "edge",
+			"@_attr.name": "points",
+			"@_attr.type": "string"
+		},
+		{
+			"@_id": "routing",
+			"@_for": "edge",
+			"@_attr.name": "routing",
+			"@_attr.type": "string"
+		},
 		{
 			"@_id": "ports",
 			"@_for": "node",
@@ -216,6 +228,14 @@ function toGraphML(graph) {
 			"@_key": "weight",
 			"#text": edge.weight
 		});
+		if (edge.points !== void 0) data.push({
+			"@_key": "points",
+			"#text": JSON.stringify(edge.points)
+		});
+		if (edge.routing !== void 0) data.push({
+			"@_key": "routing",
+			"#text": edge.routing
+		});
 		if (edge.sourcePort !== void 0) data.push({
 			"@_key": "sourcePort",
 			"#text": edge.sourcePort
@@ -281,8 +301,12 @@ function fromGraphML(xml) {
 			"node",
 			"edge",
 			"data",
-			"key"
-		].includes(name)
+			"key",
+			"graph",
+			"port"
+		].includes(name),
+		parseTagValue: false,
+		trimValues: false
 	});
 	let parsed;
 	try {
@@ -292,50 +316,79 @@ function fromGraphML(xml) {
 	}
 	const graphml = parsed?.graphml;
 	if (!graphml) throw new Error("GraphML: missing <graphml> root element");
-	const graphEl = graphml.graph;
+	const graphEl = asArray(graphml.graph)[0];
 	if (!graphEl) throw new Error("GraphML: missing <graph> element");
 	const graphType = graphEl["@_edgedefault"] === "undirected" ? "undirected" : "directed";
 	const graphDataMap = parseDataElements(graphEl.data);
 	const graphData = graphDataMap.graphData !== void 0 ? tryParseJSON(graphDataMap.graphData) : void 0;
-	const nodes = asArray(graphEl.node).map((nodeEl) => {
+	const nodeEntries = [];
+	const edgeEls = [];
+	function collectGraphContents(gEl, parentId) {
+		for (const nodeEl of asArray(gEl.node)) {
+			nodeEntries.push({
+				el: nodeEl,
+				structuralParentId: parentId
+			});
+			for (const subgraphEl of asArray(nodeEl.graph)) collectGraphContents(subgraphEl, String(nodeEl["@_id"]));
+		}
+		edgeEls.push(...asArray(gEl.edge));
+	}
+	collectGraphContents(graphEl, null);
+	const nodes = nodeEntries.map(({ el: nodeEl, structuralParentId }) => {
 		const dataMap = parseDataElements(nodeEl.data);
+		const id = String(nodeEl["@_id"]);
 		const node = {
 			type: "node",
-			id: String(nodeEl["@_id"]),
-			parentId: dataMap.parentId ?? null,
+			id,
+			parentId: dataMap.parentId ?? structuralParentId,
 			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.x !== void 0) node.x = parseNumber(dataMap.x, "x", "node", id);
+		if (dataMap.y !== void 0) node.y = parseNumber(dataMap.y, "y", "node", id);
+		if (dataMap.width !== void 0) node.width = parseNumber(dataMap.width, "width", "node", id);
+		if (dataMap.height !== void 0) node.height = parseNumber(dataMap.height, "height", "node", id);
 		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);
 		if (dataMap.ports !== void 0) node.ports = tryParseJSON(dataMap.ports);
+		else if (nodeEl.port !== void 0) node.ports = collectPorts(nodeEl.port);
 		return node;
 	});
-	const edges = asArray(graphEl.edge).map((edgeEl) => {
+	const usedEdgeIds = new Set(edgeEls.filter((edgeEl) => edgeEl["@_id"] != null).map((edgeEl) => String(edgeEl["@_id"])));
+	const edges = edgeEls.map((edgeEl, i) => {
 		const dataMap = parseDataElements(edgeEl.data);
+		const source = String(edgeEl["@_source"]);
+		const target = String(edgeEl["@_target"]);
+		let id;
+		if (edgeEl["@_id"] != null) id = String(edgeEl["@_id"]);
+		else {
+			id = `${source}-${target}-${i}`;
+			for (let suffix = 0; usedEdgeIds.has(id); suffix++) id = `${source}-${target}-${i}#e${suffix}`;
+			usedEdgeIds.add(id);
+		}
 		const edge = {
 			type: "edge",
-			id: String(edgeEl["@_id"]),
-			sourceId: String(edgeEl["@_source"]),
-			targetId: String(edgeEl["@_target"]),
+			id,
+			sourceId: source,
+			targetId: 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.weight !== void 0) edge.weight = parseNumber(dataMap.weight, "weight", "edge", id);
+		if (dataMap.points !== void 0) edge.points = tryParseJSON(dataMap.points);
+		if (dataMap.routing !== void 0) edge.routing = dataMap.routing;
+		if (dataMap.x !== void 0) edge.x = parseNumber(dataMap.x, "x", "edge", id);
+		if (dataMap.y !== void 0) edge.y = parseNumber(dataMap.y, "y", "edge", id);
+		if (dataMap.width !== void 0) edge.width = parseNumber(dataMap.width, "width", "edge", id);
+		if (dataMap.height !== void 0) edge.height = parseNumber(dataMap.height, "height", "edge", id);
 		if (dataMap.color !== void 0) edge.color = dataMap.color;
 		if (dataMap.style !== void 0) edge.style = tryParseJSON(dataMap.style);
 		if (dataMap.sourcePort !== void 0) edge.sourcePort = dataMap.sourcePort;
+		else if (edgeEl["@_sourceport"] != null) edge.sourcePort = String(edgeEl["@_sourceport"]);
 		if (dataMap.targetPort !== void 0) edge.targetPort = dataMap.targetPort;
+		else if (edgeEl["@_targetport"] != null) edge.targetPort = String(edgeEl["@_targetport"]);
 		const directedAttr = edgeEl["@_directed"];
 		if (directedAttr !== void 0) edge.mode = String(directedAttr) === "false" ? "undirected" : "directed";
 		return edge;
@@ -368,8 +421,28 @@ function tryParseJSON(str) {
 		return str;
 	}
 }
-function parseNumber(value) {
-	return Number(value);
+/**
+* Flattens native GraphML <port> elements (which may nest) into our port
+* shape. Standard GraphML ports carry only a name; direction is unknowable,
+* so they import as advisory 'inout' with null data.
+*/
+function collectPorts(portEls) {
+	const ports = [];
+	for (const portEl of asArray(portEls)) {
+		if (portEl?.["@_name"] == null) continue;
+		ports.push({
+			name: String(portEl["@_name"]),
+			direction: "inout",
+			data: null
+		});
+		if (portEl.port !== void 0) ports.push(...collectPorts(portEl.port) ?? []);
+	}
+	return ports;
+}
+function parseNumber(value, key, kind, ownerId) {
+	const parsed = Number(value);
+	if (Number.isNaN(parsed)) throw new Error(`GraphML: <data key="${key}"> value "${value}" on ${kind} "${ownerId}" is not a number. Fix the value or remove the attribute.`);
+	return parsed;
 }
 function parseDirection(value) {
 	return [