@statelyai/graph 0.12.0 → 1.0.0

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

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

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

@@ -1,61 +1,2 @@
-import { h as GraphFormatConverter, u as Graph } from "../../types-CnZ01raw.mjs";
-
-//#region src/formats/converter/index.d.ts
-
-/**
- * Create a `GraphFormatConverter` from a pair of `to`/`from` functions.
- *
- * @example
- * ```ts
- * import { createFormatConverter } from '@statelyai/graph';
- *
- * const yamlConverter = createFormatConverter(
- *   (graph) => toYAML(graph),
- *   (yaml) => fromYAML(yaml),
- * );
- *
- * const yaml = yamlConverter.to(graph);
- * const graph = yamlConverter.from(yaml);
- * ```
- */
-declare function createFormatConverter<TSerial, N = any, E = any, G = any>(to: (graph: Graph<N, E, G>) => TSerial, from: (input: TSerial) => Graph<N, E, G>): GraphFormatConverter<TSerial, N, E, G>;
-/**
- * Bidirectional converter for adjacency-list format (`Record<string, string[]>`).
- *
- * @example
- * ```ts
- * import { adjacencyListConverter, createGraph } from '@statelyai/graph';
- *
- * const graph = createGraph({
- *   nodes: { a: {}, b: {} },
- *   edges: [{ source: 'a', target: 'b' }],
- * });
- *
- * const adj = adjacencyListConverter.to(graph);
- * // { a: ['b'], b: [] }
- *
- * const roundTripped = adjacencyListConverter.from(adj);
- * ```
- */
-declare const adjacencyListConverter: GraphFormatConverter<Record<string, string[]>>;
-/**
- * Bidirectional converter for edge-list format (`[source, target][]`).
- *
- * @example
- * ```ts
- * import { edgeListConverter, createGraph } from '@statelyai/graph';
- *
- * const graph = createGraph({
- *   nodes: { a: {}, b: {} },
- *   edges: [{ source: 'a', target: 'b' }],
- * });
- *
- * const edges = edgeListConverter.to(graph);
- * // [['a', 'b']]
- *
- * const roundTripped = edgeListConverter.from(edges);
- * ```
- */
-declare const edgeListConverter: GraphFormatConverter<[string, string][]>;
-//#endregion
+import { n as createFormatConverter, r as edgeListConverter, t as adjacencyListConverter } from "../../index-D9Kj6Fe3.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-Dspillnn.mjs";
+import { n as createFormatConverter, r as edgeListConverter, t as adjacencyListConverter } from "../../converter-udLITX36.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-CnZ01raw.mjs";
+import { h as GraphFormatConverter, u as Graph } from "../../types-3-FS9NV2.mjs";
 
 //#region src/formats/cytoscape/index.d.ts
 interface CytoscapeNode {

package/dist/formats/cytoscape/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/cytoscape/index.ts
 /**
@@ -21,10 +21,11 @@ import { n as createFormatConverter } from "../../converter-Dspillnn.mjs";
 function toCytoscapeJSON(graph) {
 	const graphData = {};
 	if (graph.id) graphData.id = graph.id;
-	graphData.type = graph.type;
+	graphData.mode = graph.mode;
 	if (graph.initialNodeId) graphData.initialNodeId = graph.initialNodeId;
 	if (graph.data !== void 0) graphData.graphData = graph.data;
 	if (graph.direction) graphData.direction = graph.direction;
+	if (graph.style !== void 0) graphData.style = graph.style;
 	return {
 		...Object.keys(graphData).length > 0 && { data: graphData },
 		elements: {
@@ -38,6 +39,7 @@ function toCytoscapeJSON(graph) {
 				if (n.height !== void 0) data.height = n.height;
 				if (n.shape) data.shape = n.shape;
 				if (n.color) data.color = n.color;
+				if (n.style !== void 0) data.style = n.style;
 				if (n.ports !== void 0) data.ports = n.ports;
 				const node = { data };
 				if (n.x !== void 0 && n.y !== void 0) node.position = {
@@ -54,7 +56,13 @@ function toCytoscapeJSON(graph) {
 				};
 				if (e.label) data.label = e.label;
 				if (e.data !== void 0) data.edgeData = e.data;
+				if (e.weight !== void 0) data.weight = e.weight;
+				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;
+				if (e.height !== void 0) data.height = e.height;
 				if (e.color) data.color = e.color;
+				if (e.style !== void 0) data.style = e.style;
 				if (e.sourcePort !== void 0) data.sourcePort = e.sourcePort;
 				if (e.targetPort !== void 0) data.targetPort = e.targetPort;
 				return { data };
@@ -84,10 +92,11 @@ function fromCytoscapeJSON(cyto) {
 	if (!Array.isArray(cyto.elements.edges)) throw new Error("Cytoscape: \"elements.edges\" must be an array");
 	return {
 		id: cyto.data?.id ?? "",
-		type: cyto.data?.type === "undirected" ? "undirected" : "directed",
+		mode: cyto.data?.mode ?? "directed",
 		initialNodeId: cyto.data?.initialNodeId ?? null,
 		data: cyto.data?.graphData,
 		...cyto.data?.direction && { direction: cyto.data.direction },
+		...cyto.data?.style !== void 0 && { style: cyto.data.style },
 		nodes: cyto.elements.nodes.map((n) => ({
 			type: "node",
 			id: n.data.id,
@@ -103,6 +112,7 @@ function fromCytoscapeJSON(cyto) {
 			...n.data.height !== void 0 && { height: n.data.height },
 			...n.data.shape && { shape: n.data.shape },
 			...n.data.color && { color: n.data.color },
+			...n.data.style !== void 0 && { style: n.data.style },
 			...n.data.ports !== void 0 && { ports: n.data.ports }
 		})),
 		edges: cyto.elements.edges.map((e, i) => ({
@@ -112,7 +122,13 @@ function fromCytoscapeJSON(cyto) {
 			targetId: e.data.target,
 			label: e.data.label ?? "",
 			data: e.data.edgeData,
+			...e.data.weight !== void 0 && { weight: e.data.weight },
+			...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 },
+			...e.data.height !== void 0 && { height: e.data.height },
 			...e.data.color && { color: e.data.color },
+			...e.data.style !== void 0 && { style: e.data.style },
 			...e.data.sourcePort !== void 0 && { sourcePort: e.data.sourcePort },
 			...e.data.targetPort !== void 0 && { targetPort: e.data.targetPort }
 		}))

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

@@ -0,0 +1,109 @@
+import { h as GraphFormatConverter, u as Graph } from "../../types-3-FS9NV2.mjs";
+
+//#region src/formats/d2/shared.d.ts
+type D2Arrow = '->' | '<-' | '--' | '<->';
+/** Descriptor for a typed/block label (`|md ...|`, `|js ...|`, block strings). */
+interface D2LabelBlock {
+  kind: 'md' | 'code' | 'latex' | 'block';
+  /** Language tag for code blocks (e.g. `js`, `go`). */
+  lang?: string;
+  /** The fence delimiter used (`|`, `||`, `` |` ``, etc.), preserved for emit. */
+  fence: string;
+}
+interface D2GridSpec {
+  rows?: number;
+  columns?: number;
+  gap?: number;
+  verticalGap?: number;
+  horizontalGap?: number;
+}
+/** Source-level abstractions preserved from the original d2 text. */
+interface D2Source {
+  /** `vars: { ... }` blocks, stored as nested key/value maps. */
+  vars?: Record<string, any>;
+  /** `classes: { name: { ...style } }` definitions. */
+  classes?: Record<string, Record<string, string | number | boolean>>;
+  /** `@path` import references in declaration order. */
+  imports?: string[];
+}
+interface D2GraphData {
+  diagramType: 'd2';
+  source?: D2Source;
+  /** Comments before any statement / at file top. */
+  leadingComments?: string[];
+  /** Comments after the last statement. */
+  trailingComments?: string[];
+}
+interface D2NodeData {
+  /** Whether the author declared this node via dot-path or a `{ }` block. */
+  declarationForm?: 'dot' | 'block';
+  /** Relative positioning keyword/target (`near: top-center`, `near: a.b`). */
+  near?: string;
+  /** Icon URL. */
+  icon?: string;
+  tooltip?: string;
+  link?: string;
+  /** Names of `classes` applied to this node via `class:`. */
+  classes?: string[];
+  /** Typed/block label descriptor; absent for plain labels. */
+  labelBlock?: D2LabelBlock;
+  /** Grid layout spec for grid containers. */
+  grid?: D2GridSpec;
+  /**
+   * Source-order list of direct child node IDs and edge IDs, used by
+   * sequence diagrams (and any ordering-sensitive container) to replay
+   * statement order on emit.
+   */
+  order?: string[];
+  /** Comments immediately preceding this node's declaration. */
+  commentsBefore?: string[];
+  /** Reserved keywords with no canonical/typed home, preserved verbatim. */
+  reserved?: Record<string, string | number | boolean>;
+}
+interface D2ArrowheadSpec {
+  shape?: string;
+  label?: string;
+}
+interface D2EdgeData {
+  /** Authored connector glyph, for faithful re-emit (incl. reversed `<-`). */
+  arrow: D2Arrow;
+  sourceArrowhead?: D2ArrowheadSpec;
+  targetArrowhead?: D2ArrowheadSpec;
+  classes?: string[];
+  labelBlock?: D2LabelBlock;
+  commentsBefore?: string[];
+  reserved?: Record<string, string | number | boolean>;
+}
+interface D2PortData {
+  /** SQL column type (`int`, `varchar`, ...) or class member type. */
+  typeName?: string;
+  /** SQL constraints (`primary_key`, `foreign_key`, `unique`). */
+  constraint?: string[];
+  /** Class member visibility marker (`+`, `-`, `#`). */
+  visibility?: string;
+  /** True when this port came from a `shape: class` member rather than sql_table. */
+  classMember?: boolean;
+}
+type D2Graph = Graph<D2NodeData, D2EdgeData, D2GraphData, D2PortData>;
+//#endregion
+//#region src/formats/d2/parser.d.ts
+declare function fromD2(input: string): D2Graph;
+//#endregion
+//#region src/formats/d2/emitter.d.ts
+declare function toD2(graph: D2Graph): string;
+//#endregion
+//#region src/formats/d2/index.d.ts
+/**
+ * Bidirectional converter for [d2](https://d2lang.com/) diagram syntax.
+ *
+ * @example
+ * ```ts
+ * import { d2Converter } from '@statelyai/graph/d2';
+ *
+ * const graph = d2Converter.from('a -> b: hello');
+ * const text = d2Converter.to(graph);
+ * ```
+ */
+declare const d2Converter: GraphFormatConverter<string, D2NodeData, D2EdgeData, D2GraphData>;
+//#endregion
+export { type D2Arrow, type D2ArrowheadSpec, type D2EdgeData, type D2Graph, type D2GraphData, type D2GridSpec, type D2LabelBlock, type D2NodeData, type D2PortData, type D2Source, d2Converter, fromD2, toD2 };