@statelyai/graph 1.0.0 → 2.1.0

package/dist/{converter-udLITX36.mjs → converter-DB6Rg6Vd.mjs}

@@ -1,5 +1,5 @@
-import { n as toAdjacencyList, t as fromAdjacencyList } from "./adjacency-list-VsUaH9SJ.mjs";
-import { n as toEdgeList, t as fromEdgeList } from "./edge-list-DP4otyPU.mjs";
+import { n as toAdjacencyList, t as fromAdjacencyList } from "./adjacency-list-DQ32Mmhx.mjs";
+import { n as toEdgeList, t as fromEdgeList } from "./edge-list-CA9UTvn2.mjs";
 
 //#region src/formats/converter/index.ts
 /**

package/dist/format-support.mjs

@@ -34,7 +34,11 @@ const FORMAT_SUPPORT_MATRIX = [
 			weight: "full",
 			roundTrip: "full"
 		},
-		notes: ["Uses Cytoscape JSON element data with graph, node, and edge metadata stored in element data.", "Ports round-trip through element data as `ports`, `sourcePort`, and `targetPort`."]
+		notes: [
+			"Uses Cytoscape JSON element data with graph, node, and edge metadata stored in element data.",
+			"Ports round-trip through element data as `ports`, `sourcePort`, and `targetPort`.",
+			"Per-edge `mode` overrides (including bidirectional) round-trip through element data."
+		]
 	},
 	{
 		id: "d3",
@@ -49,7 +53,11 @@ const FORMAT_SUPPORT_MATRIX = [
 			weight: "full",
 			roundTrip: "full"
 		},
-		notes: ["Targets force-graph structures, but graph, node, and edge metadata can be preserved on the loose JSON shape.", "Ports round-trip through node/link objects."]
+		notes: [
+			"Targets force-graph structures, but graph, node, and edge metadata can be preserved on the loose JSON shape.",
+			"Ports round-trip through node/link objects.",
+			"Per-edge `mode` overrides (including bidirectional) round-trip through link objects."
+		]
 	},
 	{
 		id: "d2",
@@ -69,6 +77,7 @@ const FORMAT_SUPPORT_MATRIX = [
 			"sql_table/class fields map to ports; node.field connections round-trip as sourcePort/targetPort.",
 			"Per-edge connectors (->, <-, --, <->) map to edge.mode; the authored glyph is preserved in _d2.arrow.",
 			"vars/classes/imports are preserved on graph data; comments attach to the following entity (best-effort).",
+			"Only flat key/value vars round-trip; nested sub-blocks inside vars are dropped.",
 			"d2 has no native edge weight."
 		]
 	},
@@ -115,7 +124,11 @@ const FORMAT_SUPPORT_MATRIX = [
 			weight: "full",
 			roundTrip: "full"
 		},
-		notes: ["ELK-native layout fields are preserved directly; graph, node, port, and edge metadata round-trip through reserved layout options."]
+		notes: [
+			"ELK-native layout fields are preserved directly; graph, node, port, and edge metadata round-trip through reserved layout options.",
+			"Per-edge `mode` overrides (including bidirectional) round-trip through reserved layout options.",
+			"Port ids are emitted as `nodeId__portName` so they are document-unique as ELK requires; original port names round-trip through reserved layout options."
+		]
 	},
 	{
 		id: "gexf",
@@ -149,7 +162,11 @@ const FORMAT_SUPPORT_MATRIX = [
 			weight: "full",
 			roundTrip: "full"
 		},
-		notes: ["GML stores graph, node, and edge metadata directly or as JSON-stringified fields.", "Ports round-trip through JSON-stringified node metadata and edge fields."]
+		notes: [
+			"GML stores graph, node, and edge metadata directly or as JSON-stringified fields.",
+			"Ports round-trip through JSON-stringified node metadata and edge fields.",
+			"Per-edge `mode` overrides and graph-level bidirectional mode round-trip through a dialect `mode` key (GML `directed` is binary)."
+		]
 	},
 	{
 		id: "graphml",
@@ -162,11 +179,13 @@ const FORMAT_SUPPORT_MATRIX = [
 			visual: "partial",
 			style: "partial",
 			weight: "full",
-			roundTrip: "partial"
+			roundTrip: "full"
 		},
 		notes: [
-			"GraphML attribute fidelity is good, but not every extension is represented.",
-			"Ports round-trip through node and edge `<data>` fields.",
+			"Emit is own-dialect: a flat structure with hierarchy, ports, and metadata in `<data>` fields; the emitter does not write nested `<graph>` or native `<port>` elements.",
+			"Import handles both dialects: own-dialect `<data>` fields plus standard nested `<graph>` hierarchy, native `<port>` elements (imported as direction `inout`), and `sourceport`/`targetport` edge attributes. `<data>` fields take precedence.",
+			"Multi-graph documents import the first `<graph>` element only.",
+			"Vendor extensions (e.g. yEd visual attributes) are not represented.",
 			"Per-edge directedness round-trips via the `directed` edge attribute; bidirectional maps to directed."
 		]
 	},
@@ -183,7 +202,11 @@ const FORMAT_SUPPORT_MATRIX = [
 			weight: "full",
 			roundTrip: "full"
 		},
-		notes: ["JGF preserves graph, node, and edge metadata via `metadata` objects.", "Ports round-trip through node and edge metadata."]
+		notes: [
+			"JGF preserves graph, node, and edge metadata via `metadata` objects.",
+			"Ports round-trip through node and edge metadata.",
+			"Per-edge `mode` overrides and graph-level bidirectional mode round-trip through `metadata` (JGF `directed` is binary)."
+		]
 	},
 	{
 		id: "tgf",
@@ -213,7 +236,7 @@ const FORMAT_SUPPORT_MATRIX = [
 			weight: "full",
 			roundTrip: "full"
 		},
-		notes: ["xyflow-native fields are preserved directly; graph, node, edge, style, weight, and port metadata round-trip through reserved data fields."]
+		notes: ["xyflow-native fields are preserved directly; graph, node, edge, style, weight, port, and per-edge `mode` metadata round-trip through reserved data fields."]
 	},
 	{
 		id: "mermaid/block",
@@ -331,9 +354,13 @@ const FORMAT_SUPPORT_MATRIX = [
 			visual: "partial",
 			style: "partial",
 			weight: "none",
-			roundTrip: "full"
+			roundTrip: "partial"
 		},
-		notes: ["State-specific syntax such as notes, classes, descriptions, directions, hierarchy, and parallel regions round-trips through node and graph data."]
+		notes: [
+			"State-specific syntax such as notes, classes, descriptions, directions, hierarchy, and parallel regions round-trips through node and graph data.",
+			"Isolated plain states emit as bare state lines, and node labels emit via the `state \"label\" as id` description form — a distinct label is lost when a description is also present.",
+			"`graph.initialNodeId` round-trips as a top-level `[*] -->` transition."
+		]
 	}
 ];
 function getFormatSupportEntry(id) {

package/dist/formats/adjacency-list/index.d.mts

@@ -1,4 +1,4 @@
-import { u as Graph } from "../../types-3-FS9NV2.mjs";
+import { f as Graph } from "../../types-BAEQTwK_.mjs";
 
 //#region src/formats/adjacency-list/index.d.ts
 

package/dist/formats/adjacency-list/index.mjs

@@ -1,3 +1,3 @@
-import { n as toAdjacencyList, t as fromAdjacencyList } from "../../adjacency-list-VsUaH9SJ.mjs";
+import { n as toAdjacencyList, t as fromAdjacencyList } from "../../adjacency-list-DQ32Mmhx.mjs";
 
 export { fromAdjacencyList, toAdjacencyList };

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

@@ -1,2 +1,2 @@
-import { n as createFormatConverter, r as edgeListConverter, t as adjacencyListConverter } from "../../index-D9Kj6Fe3.mjs";
+import { n as createFormatConverter, r as edgeListConverter, t as adjacencyListConverter } from "../../index-BlbSWUvH.mjs";
 export { adjacencyListConverter, createFormatConverter, edgeListConverter };

package/dist/formats/converter/index.mjs

@@ -1,3 +1,3 @@
-import { n as createFormatConverter, r as edgeListConverter, t as adjacencyListConverter } from "../../converter-udLITX36.mjs";
+import { n as createFormatConverter, r as edgeListConverter, t as adjacencyListConverter } from "../../converter-DB6Rg6Vd.mjs";
 
 export { adjacencyListConverter, createFormatConverter, edgeListConverter };

package/dist/formats/cytoscape/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/cytoscape/index.d.ts
 interface CytoscapeNode {
@@ -33,7 +33,7 @@ interface CytoscapeJSON {
  * @example
  * ```ts
  * import { createGraph } from '@statelyai/graph';
- * import { toCytoscapeJSON } from '@statelyai/graph/formats/cytoscape';
+ * import { toCytoscapeJSON } from '@statelyai/graph/cytoscape';
  *
  * const graph = createGraph({
  *   nodes: [{ id: 'a' }, { id: 'b' }],
@@ -50,7 +50,7 @@ declare function toCytoscapeJSON(graph: Graph): CytoscapeJSON;
  *
  * @example
  * ```ts
- * import { fromCytoscapeJSON } from '@statelyai/graph/formats/cytoscape';
+ * import { fromCytoscapeJSON } from '@statelyai/graph/cytoscape';
  *
  * const graph = fromCytoscapeJSON({
  *   elements: {
@@ -67,7 +67,7 @@ declare function fromCytoscapeJSON(cyto: CytoscapeJSON): Graph;
  * @example
  * ```ts
  * import { createGraph } from '@statelyai/graph';
- * import { cytoscapeConverter } from '@statelyai/graph/formats/cytoscape';
+ * import { cytoscapeConverter } from '@statelyai/graph/cytoscape';
  *
  * const graph = createGraph({
  *   nodes: [{ id: 'a' }, { id: 'b' }],

package/dist/formats/cytoscape/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/cytoscape/index.ts
 /**
@@ -7,7 +7,7 @@ import { n as createFormatConverter } from "../../converter-udLITX36.mjs";
 * @example
 * ```ts
 * import { createGraph } from '@statelyai/graph';
-* import { toCytoscapeJSON } from '@statelyai/graph/formats/cytoscape';
+* import { toCytoscapeJSON } from '@statelyai/graph/cytoscape';
 *
 * const graph = createGraph({
 *   nodes: [{ id: 'a' }, { id: 'b' }],
@@ -55,8 +55,11 @@ function toCytoscapeJSON(graph) {
 					target: e.targetId
 				};
 				if (e.label) data.label = e.label;
+				if (e.mode) data.mode = e.mode;
 				if (e.data !== void 0) data.edgeData = e.data;
 				if (e.weight !== void 0) data.weight = e.weight;
+				if (e.points !== void 0) data.points = e.points;
+				if (e.routing !== void 0) data.routing = e.routing;
 				if (e.x !== void 0) data.x = e.x;
 				if (e.y !== void 0) data.y = e.y;
 				if (e.width !== void 0) data.width = e.width;
@@ -75,7 +78,7 @@ function toCytoscapeJSON(graph) {
 *
 * @example
 * ```ts
-* import { fromCytoscapeJSON } from '@statelyai/graph/formats/cytoscape';
+* import { fromCytoscapeJSON } from '@statelyai/graph/cytoscape';
 *
 * const graph = fromCytoscapeJSON({
 *   elements: {
@@ -121,8 +124,11 @@ function fromCytoscapeJSON(cyto) {
 			sourceId: e.data.source,
 			targetId: e.data.target,
 			label: e.data.label ?? "",
+			...e.data.mode && { mode: e.data.mode },
 			data: e.data.edgeData,
 			...e.data.weight !== void 0 && { weight: e.data.weight },
+			...e.data.points !== void 0 && { points: e.data.points },
+			...e.data.routing !== void 0 && { routing: e.data.routing },
 			...e.data.x !== void 0 && { x: e.data.x },
 			...e.data.y !== void 0 && { y: e.data.y },
 			...e.data.width !== void 0 && { width: e.data.width },
@@ -140,7 +146,7 @@ function fromCytoscapeJSON(cyto) {
 * @example
 * ```ts
 * import { createGraph } from '@statelyai/graph';
-* import { cytoscapeConverter } from '@statelyai/graph/formats/cytoscape';
+* import { cytoscapeConverter } from '@statelyai/graph/cytoscape';
 *
 * const graph = createGraph({
 *   nodes: [{ id: 'a' }, { id: 'b' }],

package/dist/formats/d2/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/d2/shared.d.ts
 type D2Arrow = '->' | '<-' | '--' | '<->';

package/dist/formats/d2/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/d2/shared.ts
 /** Map a d2 connector glyph to a graph edge mode. */
@@ -800,6 +800,17 @@ function fromD2(input) {
 //#endregion
 //#region src/formats/d2/emitter.ts
 const STRUCTURED_SHAPES = new Set(["sql_table", "class"]);
+/**
+* Parser-shaped node data, tolerating graphs not produced by `fromD2` whose
+* `data` may be `undefined`, `null`, or an arbitrary user object.
+*/
+function nodeData(node) {
+	return node.data ?? {};
+}
+/** Parser-shaped edge data; see {@link nodeData}. */
+function edgeData(edge) {
+	return edge.data ?? {};
+}
 function splitId(id) {
 	const out = [];
 	let buf = "";
@@ -835,7 +846,7 @@ function emitComments(comments, ind, lines) {
 }
 function nodeAttrLines(node, ind) {
 	const lines = [];
-	const d = node.data;
+	const d = nodeData(node);
 	if (node.shape) lines.push(`${indent(ind)}shape: ${escapeD2Label(node.shape)}`);
 	if (d.near) lines.push(`${indent(ind)}near: ${escapeD2Label(d.near)}`);
 	if (d.icon) lines.push(`${indent(ind)}icon: ${d.icon}`);
@@ -869,7 +880,8 @@ function portLines(node, ind) {
 }
 function labelHeader(node) {
 	if (node.label == null || node.label === "") return "";
-	if (node.data.labelBlock) return emitLabelBlock(node.label, node.data.labelBlock);
+	const labelBlock = nodeData(node).labelBlock;
+	if (labelBlock) return emitLabelBlock(node.label, labelBlock);
 	return escapeD2Label(node.label);
 }
 /** Whether a node carries its own attributes/ports/label (needs a line of its own). */
@@ -883,7 +895,7 @@ function hasOwnContent(node) {
 */
 function isPurePrefix(ctx, node) {
 	const children = ctx.childrenOf.get(node.id) ?? [];
-	return node.data.declarationForm !== "block" && children.length > 0 && !hasOwnContent(node);
+	return nodeData(node).declarationForm !== "block" && children.length > 0 && !hasOwnContent(node);
 }
 /**
 * Emit the items (child nodes + owned edges) of a scope, in `data.order` when
@@ -893,7 +905,7 @@ function isPurePrefix(ctx, node) {
 function emitScope(ctx, container, containerId, scopeSegs, ind, lines) {
 	const children = ctx.childrenOf.get(containerId) ?? [];
 	const ownedEdges = container ? ctx.edgesByOwner.get(container.id) ?? [] : [];
-	const order = container?.data.order;
+	const order = container ? nodeData(container).order : void 0;
 	if (order) {
 		const childById = new Map(children.map((c) => [c.id, c]));
 		const edgeById = new Map(ownedEdges.map((e) => [e.id, e]));
@@ -918,7 +930,7 @@ function emitItem(ctx, node, scopeSegs, ind, lines) {
 		emitScope(ctx, node, node.id, scopeSegs, ind, lines);
 		return;
 	}
-	emitComments(node.data.commentsBefore, ind, lines);
+	emitComments(nodeData(node).commentsBefore, ind, lines);
 	const label = labelHeader(node);
 	const structured = node.shape && STRUCTURED_SHAPES.has(node.shape);
 	const attrLines = nodeAttrLines(node, ind + 1);
@@ -946,8 +958,9 @@ function endpointRef(nodeId$1, port, scopeSegs) {
 }
 function emitEdge(ctx, edge, ind, lines, scoped) {
 	ctx.emittedEdges.add(edge.id);
-	emitComments(edge.data.commentsBefore, ind, lines);
-	const arrow = edge.data.arrow ?? modeToArrow(edge);
+	const d = edgeData(edge);
+	emitComments(d.commentsBefore, ind, lines);
+	const arrow = d.arrow ?? modeToArrow(edge);
 	const owner = scoped ? ctx.ownerOfEdge.get(edge.id) : void 0;
 	const scopeSegs = owner ? splitId(owner) : [];
 	let sId = edge.sourceId;
@@ -962,7 +975,7 @@ function emitEdge(ctx, edge, ind, lines, scoped) {
 	const right = endpointRef(tId, tPort, scopeSegs);
 	let line = `${indent(ind)}${left} ${arrow} ${right}`;
 	if (edge.label != null && edge.label !== "") {
-		const lbl = edge.data.labelBlock ? emitLabelBlock(edge.label, edge.data.labelBlock) : escapeD2Label(edge.label);
+		const lbl = d.labelBlock ? emitLabelBlock(edge.label, d.labelBlock) : escapeD2Label(edge.label);
 		line += `: ${lbl}`;
 	}
 	const blockLines = edgeBlockLines(edge);
@@ -975,10 +988,11 @@ function emitEdge(ctx, edge, ind, lines, scoped) {
 function edgeBlockLines(edge) {
 	const out = [];
 	if (edge.style) for (const [k, v] of Object.entries(edge.style)) out.push(`style.${k}: ${styleValueToD2(v)}`);
-	const { sourceArrowhead, targetArrowhead } = edge.data;
+	const d = edgeData(edge);
+	const { sourceArrowhead, targetArrowhead } = d;
 	if (sourceArrowhead?.shape) out.push(`source-arrowhead.shape: ${sourceArrowhead.shape}`);
 	if (targetArrowhead?.shape) out.push(`target-arrowhead.shape: ${targetArrowhead.shape}`);
-	if (edge.data.reserved) for (const [k, v] of Object.entries(edge.data.reserved)) out.push(`${k}: ${styleValueToD2(v)}`);
+	if (d.reserved) for (const [k, v] of Object.entries(d.reserved)) out.push(`${k}: ${styleValueToD2(v)}`);
 	return out;
 }
 function modeToArrow(edge) {
@@ -999,7 +1013,7 @@ function buildEdgeOwnership(graph) {
 	const ownerOfEdge = /* @__PURE__ */ new Map();
 	const edgeById = new Map(graph.edges.map((e) => [e.id, e]));
 	for (const node of graph.nodes) {
-		const order = node.data.order;
+		const order = nodeData(node).order;
 		if (!order) continue;
 		for (const refId of order) {
 			const edge = edgeById.get(refId);

package/dist/formats/d3/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/d3/index.d.ts
 interface D3Node {
@@ -27,7 +27,7 @@ interface D3Graph {
  * @example
  * ```ts
  * import { createGraph } from '@statelyai/graph';
- * import { toD3Graph } from '@statelyai/graph/formats/d3';
+ * import { toD3Graph } from '@statelyai/graph/d3';
  *
  * const graph = createGraph({
  *   nodes: [{ id: 'a' }, { id: 'b' }],
@@ -44,7 +44,7 @@ declare function toD3Graph(graph: Graph): D3Graph;
  *
  * @example
  * ```ts
- * import { fromD3Graph } from '@statelyai/graph/formats/d3';
+ * import { fromD3Graph } from '@statelyai/graph/d3';
  *
  * const graph = fromD3Graph({
  *   nodes: [{ id: 'a' }, { id: 'b' }],
@@ -59,7 +59,7 @@ declare function fromD3Graph(d3: D3Graph): Graph;
  * @example
  * ```ts
  * import { createGraph } from '@statelyai/graph';
- * import { d3Converter } from '@statelyai/graph/formats/d3';
+ * import { d3Converter } from '@statelyai/graph/d3';
  *
  * const graph = createGraph({
  *   nodes: [{ id: 'a' }, { id: 'b' }],

package/dist/formats/d3/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/d3/index.ts
 /**
@@ -7,7 +7,7 @@ import { n as createFormatConverter } from "../../converter-udLITX36.mjs";
 * @example
 * ```ts
 * import { createGraph } from '@statelyai/graph';
-* import { toD3Graph } from '@statelyai/graph/formats/d3';
+* import { toD3Graph } from '@statelyai/graph/d3';
 *
 * const graph = createGraph({
 *   nodes: [{ id: 'a' }, { id: 'b' }],
@@ -49,8 +49,11 @@ function toD3Graph(graph) {
 			};
 			if (e.id) link.id = e.id;
 			if (e.label) link.label = e.label;
+			if (e.mode) link.mode = e.mode;
 			if (e.data !== void 0) link.data = e.data;
 			if (e.weight !== void 0) link.weight = e.weight;
+			if (e.points !== void 0) link.points = e.points;
+			if (e.routing !== void 0) link.routing = e.routing;
 			if (e.x !== void 0) link.x = e.x;
 			if (e.y !== void 0) link.y = e.y;
 			if (e.width !== void 0) link.width = e.width;
@@ -68,7 +71,7 @@ function toD3Graph(graph) {
 *
 * @example
 * ```ts
-* import { fromD3Graph } from '@statelyai/graph/formats/d3';
+* import { fromD3Graph } from '@statelyai/graph/d3';
 *
 * const graph = fromD3Graph({
 *   nodes: [{ id: 'a' }, { id: 'b' }],
@@ -109,8 +112,11 @@ function fromD3Graph(d3) {
 			sourceId: typeof l.source === "string" ? l.source : l.source.id,
 			targetId: typeof l.target === "string" ? l.target : l.target.id,
 			label: l.label ?? "",
+			...l.mode && { mode: l.mode },
 			data: l.data,
 			...l.weight !== void 0 && { weight: l.weight },
+			...l.points !== void 0 && { points: l.points },
+			...l.routing !== void 0 && { routing: l.routing },
 			...l.x !== void 0 && { x: l.x },
 			...l.y !== void 0 && { y: l.y },
 			...l.width !== void 0 && { width: l.width },
@@ -128,7 +134,7 @@ function fromD3Graph(d3) {
 * @example
 * ```ts
 * import { createGraph } from '@statelyai/graph';
-* import { d3Converter } from '@statelyai/graph/formats/d3';
+* import { d3Converter } from '@statelyai/graph/d3';
 *
 * const graph = createGraph({
 *   nodes: [{ id: 'a' }, { id: 'b' }],

package/dist/formats/dot/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/dot/index.d.ts
 

package/dist/formats/dot/index.mjs

@@ -1,15 +1,31 @@
-import { n as createFormatConverter } from "../../converter-udLITX36.mjs";
+import { n as createFormatConverter } from "../../converter-DB6Rg6Vd.mjs";
 import parse from "dotparser";
 
 //#region src/formats/dot/index.ts
+/** DOT reserved keywords — must be quoted when used as identifiers. */
+const DOT_KEYWORDS = new Set([
+	"node",
+	"edge",
+	"graph",
+	"digraph",
+	"subgraph",
+	"strict"
+]);
 /** Escape a DOT identifier */
 function escapeId(id) {
-	if (/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(id)) return id;
+	if (/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(id) && !DOT_KEYWORDS.has(id.toLowerCase())) return id;
 	return `"${id.replace(/\\/g, "\\\\").replace(/"/g, "\\\"")}"`;
 }
 /** Escape a DOT label string */
 function escapeLabel(label) {
-	return label.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
+	return label.replace(/\\/g, "\\\\").replace(/"/g, "\\\"").replace(/\n/g, "\\n");
+}
+/**
+* Invert {@link escapeLabel}. dotparser unescapes `\"` itself but passes
+* `\\` and `\n` through verbatim.
+*/
+function unescapeLabel(label) {
+	return label.replace(/\\(\\|n)/g, (_, ch) => ch === "n" ? "\n" : "\\");
 }
 function formatEndpoint(id, port) {
 	return `${escapeId(id)}${port ? `:${escapeId(port)}` : ""}`;
@@ -112,7 +128,7 @@ function nodeFromAttrs(id, attrs, defaults, parentId) {
 		...defaults,
 		...attrs
 	};
-	const label = merged["label"] ?? "";
+	const label = unescapeLabel(merged["label"] ?? "");
 	const rawShape = merged["shape"];
 	const shape = rawShape ? DOT_TO_SHAPE[rawShape] ?? rawShape : void 0;
 	const color = merged["fillcolor"] ?? merged["color"] ?? void 0;
@@ -235,7 +251,7 @@ function fromDOT(dot) {
 							id: `e${edgeIdx++}`,
 							sourceId: source.id,
 							targetId: target.id,
-							label: mergedEdgeAttrs["label"] ?? "",
+							label: unescapeLabel(mergedEdgeAttrs["label"] ?? ""),
 							data: void 0,
 							...source.port && { sourcePort: source.port },
 							...target.port && { targetPort: target.port },
@@ -251,7 +267,7 @@ function fromDOT(dot) {
 				let subLabel = "";
 				for (const child of stmt.children) if (child.type === "attr_stmt" && child.target === "graph") {
 					const ga = attrsToMap(child.attr_list);
-					if (ga["label"]) subLabel = ga["label"];
+					if (ga["label"]) subLabel = unescapeLabel(ga["label"]);
 				}
 				const subNode = {
 					type: "node",

package/dist/formats/edge-list/index.d.mts

@@ -1,4 +1,4 @@
-import { u as Graph } from "../../types-3-FS9NV2.mjs";
+import { f as Graph } from "../../types-BAEQTwK_.mjs";
 
 //#region src/formats/edge-list/index.d.ts
 

package/dist/formats/edge-list/index.mjs

@@ -1,3 +1,3 @@
-import { n as toEdgeList, t as fromEdgeList } from "../../edge-list-DP4otyPU.mjs";
+import { n as toEdgeList, t as fromEdgeList } from "../../edge-list-CA9UTvn2.mjs";
 
 export { fromEdgeList, toEdgeList };

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

@@ -1,4 +1,4 @@
-import { F as VisualGraphFormatConverter, M as VisualGraph } from "../../types-3-FS9NV2.mjs";
+import { I as VisualGraph, z as VisualGraphFormatConverter } from "../../types-BAEQTwK_.mjs";
 import { ElkEdge, ElkEdgeSection, ElkExtendedEdge, ElkGraphElement, ElkLabel, ElkNode, ElkNode as ElkNode$1, ElkPoint, ElkPort, ElkPrimitiveEdge, ElkShape, LayoutOptions } from "elkjs/lib/elk-api";
 
 //#region src/formats/elk/index.d.ts