@xpressai/xircuits-viewer 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export type { XGraph, XNode, XEdge, XPort, NodeMetrics, RenderOptions, PortDirection, PortKind, NodeKind, EdgeKind, } from './types.js';
+export { parse } from './parser/parse.js';
+export { validate } from './parser/validate.js';
+export { computeNodeMetrics } from './layout/metrics.js';
+export { computeViewBox } from './layout/viewBox.js';
+export { renderToString, renderToElement } from './render/renderGraph.js';
+export { renderXircuits } from './render/renderGraph.js';
+export declare function getCanvasStyle(theme?: 'dark' | 'light'): string;
+export declare function renderFromUrl(url: string, options?: import('./types.js').RenderOptions): Promise<string>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,MAAM,EACN,KAAK,EACL,KAAK,EACL,KAAK,EACL,WAAW,EACX,aAAa,EACb,aAAa,EACb,QAAQ,EACR,QAAQ,EACR,QAAQ,GACT,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1E,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,wBAAgB,cAAc,CAAC,KAAK,GAAE,MAAM,GAAG,OAAgB,GAAG,MAAM,CAavE;AAGD,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,YAAY,EAAE,aAAa,GAC3C,OAAO,CAAC,MAAM,CAAC,CAOjB"}

package/dist/index.js

@@ -0,0 +1,36 @@
+// Parser
+export { parse } from './parser/parse.js';
+export { validate } from './parser/validate.js';
+// Layout
+export { computeNodeMetrics } from './layout/metrics.js';
+export { computeViewBox } from './layout/viewBox.js';
+// Renderer
+export { renderToString, renderToElement } from './render/renderGraph.js';
+// Convenience: one-shot parse + render
+export { renderXircuits } from './render/renderGraph.js';
+// Container background CSS (matching Xircuits canvas)
+export function getCanvasStyle(theme = 'dark') {
+    if (theme === 'dark') {
+        return [
+            'background-color: oklch(0.3 0.01 300)',
+            'background-image: radial-gradient(oklch(40% 0 0) 1px, transparent 0)',
+            'background-size: 15px 15px',
+        ].join(';');
+    }
+    return [
+        'background-color: #f5f5f5',
+        'background-image: radial-gradient(oklch(85% 0 0) 1px, transparent 0)',
+        'background-size: 15px 15px',
+    ].join(';');
+}
+// Browser helper: fetch a .xircuits URL and render
+export async function renderFromUrl(url, options) {
+    const res = await fetch(url);
+    if (!res.ok)
+        throw new Error(`Failed to load ${url}: ${res.status}`);
+    const json = await res.json();
+    const { parse } = await import('./parser/parse.js');
+    const { renderToString } = await import('./render/renderGraph.js');
+    return renderToString(parse(json), options);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,SAAS;AACT,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAEhD,SAAS;AACT,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,WAAW;AACX,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1E,uCAAuC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD,sDAAsD;AACtD,MAAM,UAAU,cAAc,CAAC,QAA0B,MAAM;IAC7D,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACrB,OAAO;YACL,uCAAuC;YACvC,sEAAsE;YACtE,4BAA4B;SAC7B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACd,CAAC;IACD,OAAO;QACL,2BAA2B;QAC3B,sEAAsE;QACtE,4BAA4B;KAC7B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,mDAAmD;AACnD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAW,EACX,OAA4C;IAE5C,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;IACpD,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;IACnE,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC"}

package/dist/interaction/panZoom.d.ts

@@ -0,0 +1,16 @@
+export interface PanZoomOptions {
+    minZoom?: number;
+    maxZoom?: number;
+    onViewportChange?: (viewport: {
+        x: number;
+        y: number;
+        zoom: number;
+    }) => void;
+}
+export interface PanZoomInstance {
+    destroy: () => void;
+    zoomBy: (factor: number) => void;
+    fitView: () => void;
+}
+export declare function attachPanZoom(svg: SVGSVGElement, options?: PanZoomOptions): PanZoomInstance;
+//# sourceMappingURL=panZoom.d.ts.map

package/dist/interaction/panZoom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"panZoom.d.ts","sourceRoot":"","sources":["../../src/interaction/panZoom.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC/E;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACjC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,wBAAgB,aAAa,CAC3B,GAAG,EAAE,aAAa,EAClB,OAAO,GAAE,cAAmB,GAC3B,eAAe,CA0FjB"}

package/dist/interaction/panZoom.js

@@ -0,0 +1,84 @@
+export function attachPanZoom(svg, options = {}) {
+    const { minZoom = 0.1, maxZoom = 4, onViewportChange } = options;
+    const initialViewBox = readViewBox();
+    let isPanning = false;
+    let startX = 0;
+    let startY = 0;
+    let panStartVB = { x: 0, y: 0, w: 0, h: 0 };
+    function readViewBox() {
+        const vb = svg.getAttribute('viewBox')?.split(/\s+/).map(Number) || [0, 0, 800, 600];
+        return { x: vb[0], y: vb[1], w: vb[2], h: vb[3] };
+    }
+    function writeViewBox(vb) {
+        svg.setAttribute('viewBox', `${vb.x} ${vb.y} ${vb.w} ${vb.h}`);
+        onViewportChange?.({ x: vb.x, y: vb.y, zoom: svg.clientWidth / vb.w });
+    }
+    function onWheel(e) {
+        e.preventDefault();
+        const rect = svg.getBoundingClientRect();
+        const mx = (e.clientX - rect.left) / rect.width;
+        const my = (e.clientY - rect.top) / rect.height;
+        const factor = e.deltaY > 0 ? 1.1 : 0.9;
+        applyZoom(factor, mx, my);
+    }
+    function applyZoom(factor, anchorX = 0.5, anchorY = 0.5) {
+        const vb = readViewBox();
+        const newW = vb.w * factor;
+        const newH = vb.h * factor;
+        const currentZoom = svg.clientWidth / vb.w;
+        const newZoom = svg.clientWidth / newW;
+        if (newZoom < minZoom || newZoom > maxZoom)
+            return;
+        vb.x += (vb.w - newW) * anchorX;
+        vb.y += (vb.h - newH) * anchorY;
+        vb.w = newW;
+        vb.h = newH;
+        writeViewBox(vb);
+    }
+    function onPointerDown(e) {
+        if (e.button !== 0)
+            return;
+        isPanning = true;
+        startX = e.clientX;
+        startY = e.clientY;
+        panStartVB = readViewBox();
+        svg.setPointerCapture(e.pointerId);
+        svg.style.cursor = 'grabbing';
+    }
+    function onPointerMove(e) {
+        if (!isPanning)
+            return;
+        const rect = svg.getBoundingClientRect();
+        const vb = panStartVB;
+        const dx = (e.clientX - startX) / rect.width * vb.w;
+        const dy = (e.clientY - startY) / rect.height * vb.h;
+        writeViewBox({ x: vb.x - dx, y: vb.y - dy, w: vb.w, h: vb.h });
+    }
+    function onPointerUp(e) {
+        if (!isPanning)
+            return;
+        isPanning = false;
+        svg.releasePointerCapture(e.pointerId);
+        svg.style.cursor = 'grab';
+    }
+    svg.style.cursor = 'grab';
+    svg.addEventListener('wheel', onWheel, { passive: false });
+    svg.addEventListener('pointerdown', onPointerDown);
+    svg.addEventListener('pointermove', onPointerMove);
+    svg.addEventListener('pointerup', onPointerUp);
+    return {
+        destroy() {
+            svg.removeEventListener('wheel', onWheel);
+            svg.removeEventListener('pointerdown', onPointerDown);
+            svg.removeEventListener('pointermove', onPointerMove);
+            svg.removeEventListener('pointerup', onPointerUp);
+        },
+        zoomBy(factor) {
+            applyZoom(factor);
+        },
+        fitView() {
+            writeViewBox(initialViewBox);
+        },
+    };
+}
+//# sourceMappingURL=panZoom.js.map

package/dist/interaction/panZoom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"panZoom.js","sourceRoot":"","sources":["../../src/interaction/panZoom.ts"],"names":[],"mappings":"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"}

package/dist/layout/metrics.d.ts

@@ -0,0 +1,18 @@
+import type { XNode, NodeMetrics } from '../types.js';
+export declare const TITLE_HEIGHT = 26;
+export declare const PORT_ROW_HEIGHT = 19;
+export declare const NODE_MIN_WIDTH = 100;
+export declare const PORT_GAP = 10;
+export declare const PORT_DOT_SIZE = 15;
+export declare const FONT_SIZE = 11;
+export declare const CHAR_WIDTH = 6.6;
+export declare const TITLE_ICON_SIZE = 15;
+export declare const TITLE_PADDING_X = 5;
+export declare const TITLE_PADDING_Y = 5;
+export declare const PORT_LABEL_PADDING = 5;
+export declare const COMMENT_FONT_SIZE = 12;
+export declare const COMMENT_CHAR_WIDTH = 7.2;
+export declare const COMMENT_PADDING = 5;
+export declare function measureTextWidth(text: string, charWidth?: number): number;
+export declare function computeNodeMetrics(node: XNode): NodeMetrics;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/layout/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/layout/metrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAGtD,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,cAAc,MAAM,CAAC;AAClC,eAAO,MAAM,QAAQ,KAAK,CAAC;AAC3B,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,SAAS,KAAK,CAAC;AAC5B,eAAO,MAAM,UAAU,MAAM,CAAC;AAC9B,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,eAAO,MAAM,kBAAkB,IAAI,CAAC;AACpC,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,kBAAkB,MAAM,CAAC;AACtC,eAAO,MAAM,eAAe,IAAI,CAAC;AAEjC,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,MAAmB,GAAG,MAAM,CAErF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,KAAK,GAAG,WAAW,CAkD3D"}

package/dist/layout/metrics.js

@@ -0,0 +1,78 @@
+// Constants derived from Xircuits CSS
+export const TITLE_HEIGHT = 26;
+export const PORT_ROW_HEIGHT = 19; // 15px port + 2px margin top + 2px margin bottom
+export const NODE_MIN_WIDTH = 100;
+export const PORT_GAP = 10; // gap between in-port column and out-port column (margin-right: 10px)
+export const PORT_DOT_SIZE = 15;
+export const FONT_SIZE = 11;
+export const CHAR_WIDTH = 6.6; // approx for sans-serif 11px
+export const TITLE_ICON_SIZE = 15;
+export const TITLE_PADDING_X = 5;
+export const TITLE_PADDING_Y = 5;
+export const PORT_LABEL_PADDING = 5; // padding: 0 5px on label
+export const COMMENT_FONT_SIZE = 12;
+export const COMMENT_CHAR_WIDTH = 7.2;
+export const COMMENT_PADDING = 5;
+export function measureTextWidth(text, charWidth = CHAR_WIDTH) {
+    return text.length * charWidth;
+}
+export function computeNodeMetrics(node) {
+    if (node.kind === 'comment') {
+        return computeCommentMetrics(node);
+    }
+    // Title width = icon + padding + name text + padding
+    const titleTextWidth = TITLE_PADDING_X + TITLE_ICON_SIZE + TITLE_PADDING_X + measureTextWidth(node.name) + TITLE_PADDING_X;
+    // In-ports column width: dot(15) + label padding(5) + label text + label padding(5)
+    let maxInWidth = 0;
+    for (const port of node.portsIn) {
+        const labelW = measureTextWidth(port.label) + PORT_LABEL_PADDING * 2;
+        maxInWidth = Math.max(maxInWidth, PORT_DOT_SIZE + labelW);
+    }
+    // Out-ports column width: label padding(5) + label text + label padding(5) + dot(15)
+    let maxOutWidth = 0;
+    for (const port of node.portsOut) {
+        const labelW = measureTextWidth(port.label) + PORT_LABEL_PADDING * 2;
+        maxOutWidth = Math.max(maxOutWidth, labelW + PORT_DOT_SIZE);
+    }
+    const hasIn = node.portsIn.length > 0;
+    const hasOut = node.portsOut.length > 0;
+    const portsWidth = maxInWidth + (hasIn && hasOut ? PORT_GAP : 0) + maxOutWidth;
+    const width = Math.max(NODE_MIN_WIDTH, titleTextWidth, portsWidth);
+    const maxPortCount = Math.max(node.portsIn.length, node.portsOut.length);
+    const bodyHeight = maxPortCount > 0 ? maxPortCount * PORT_ROW_HEIGHT : 0;
+    const height = TITLE_HEIGHT + bodyHeight;
+    // Compute port positions (relative to node top-left, at the connection point)
+    const portPositions = new Map();
+    node.portsIn.forEach((port, i) => {
+        portPositions.set(port.id, {
+            x: 0, // left edge of node
+            y: TITLE_HEIGHT + i * PORT_ROW_HEIGHT + PORT_ROW_HEIGHT / 2,
+        });
+    });
+    node.portsOut.forEach((port, i) => {
+        portPositions.set(port.id, {
+            x: width, // right edge of node
+            y: TITLE_HEIGHT + i * PORT_ROW_HEIGHT + PORT_ROW_HEIGHT / 2,
+        });
+    });
+    return { width, height, titleHeight: TITLE_HEIGHT, portRowHeight: PORT_ROW_HEIGHT, portPositions };
+}
+function computeCommentMetrics(node) {
+    const title = 'Comment:';
+    const text = node.extras.commentInput || '';
+    const lines = text.split('\n');
+    const titleWidth = measureTextWidth(title, COMMENT_CHAR_WIDTH) + COMMENT_PADDING * 2;
+    const maxLineWidth = Math.max(...lines.map(l => measureTextWidth(l, COMMENT_CHAR_WIDTH)));
+    const width = Math.max(NODE_MIN_WIDTH, titleWidth, maxLineWidth + COMMENT_PADDING * 2);
+    // title line + content lines + padding
+    const lineHeight = 18;
+    const height = COMMENT_PADDING + 16 + lines.length * lineHeight + COMMENT_PADDING;
+    return {
+        width,
+        height,
+        titleHeight: 0,
+        portRowHeight: 0,
+        portPositions: new Map(),
+    };
+}
+//# sourceMappingURL=metrics.js.map

package/dist/layout/metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.js","sourceRoot":"","sources":["../../src/layout/metrics.ts"],"names":[],"mappings":"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"}

package/dist/layout/viewBox.d.ts

@@ -0,0 +1,9 @@
+import type { XNode, NodeMetrics } from '../types.js';
+export interface ViewBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export declare function computeViewBox(nodes: XNode[], metricsMap: Map<string, NodeMetrics>, padding?: number): ViewBox;
+//# sourceMappingURL=viewBox.d.ts.map

package/dist/layout/viewBox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewBox.d.ts","sourceRoot":"","sources":["../../src/layout/viewBox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,OAAO;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,KAAK,EAAE,EACd,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EACpC,OAAO,GAAE,MAAW,GACnB,OAAO,CA0BT"}

package/dist/layout/viewBox.js

@@ -0,0 +1,25 @@
+export function computeViewBox(nodes, metricsMap, padding = 40) {
+    if (nodes.length === 0) {
+        return { x: 0, y: 0, width: 800, height: 600 };
+    }
+    let minX = Infinity;
+    let minY = Infinity;
+    let maxX = -Infinity;
+    let maxY = -Infinity;
+    for (const node of nodes) {
+        const metrics = metricsMap.get(node.id);
+        if (!metrics)
+            continue;
+        minX = Math.min(minX, node.x);
+        minY = Math.min(minY, node.y);
+        maxX = Math.max(maxX, node.x + metrics.width);
+        maxY = Math.max(maxY, node.y + metrics.height);
+    }
+    return {
+        x: minX - padding,
+        y: minY - padding,
+        width: maxX - minX + padding * 2,
+        height: maxY - minY + padding * 2,
+    };
+}
+//# sourceMappingURL=viewBox.js.map

package/dist/layout/viewBox.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewBox.js","sourceRoot":"","sources":["../../src/layout/viewBox.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,cAAc,CAC5B,KAAc,EACd,UAAoC,EACpC,UAAkB,EAAE;IAEpB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IACjD,CAAC;IAED,IAAI,IAAI,GAAG,QAAQ,CAAC;IACpB,IAAI,IAAI,GAAG,QAAQ,CAAC;IACpB,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC;IACrB,IAAI,IAAI,GAAG,CAAC,QAAQ,CAAC;IAErB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9C,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;IAED,OAAO;QACL,CAAC,EAAE,IAAI,GAAG,OAAO;QACjB,CAAC,EAAE,IAAI,GAAG,OAAO;QACjB,KAAK,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,GAAG,CAAC;QAChC,MAAM,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,GAAG,CAAC;KAClC,CAAC;AACJ,CAAC"}

package/dist/parser/classify.d.ts

@@ -0,0 +1,10 @@
+import type { NodeKind, PortKind, PortDirection, EdgeKind } from '../types.js';
+export declare function classifyNode(name: string, extras: Record<string, unknown>): NodeKind;
+export declare function classifyPort(portName: string, label: string, isIn: boolean, nodeName: string): {
+    kind: PortKind;
+    direction: PortDirection;
+    dataType: string | null;
+    varName: string;
+};
+export declare function classifyEdge(type: string): EdgeKind;
+//# sourceMappingURL=classify.d.ts.map

package/dist/parser/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../src/parser/classify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE/E,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,QAAQ,CAiBpF;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,MAAM,GACf;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,SAAS,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CA2BxF;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAEnD"}

package/dist/parser/classify.js

@@ -0,0 +1,52 @@
+export function classifyNode(name, extras) {
+    const type = extras.type;
+    if (type === 'comment')
+        return 'comment';
+    if (name.startsWith('Literal') || name.startsWith('Argument'))
+        return 'literal';
+    if (type === 'xircuits_workflow')
+        return 'workflow';
+    if (name === 'Start')
+        return 'start';
+    if (name === 'Finish')
+        return 'finish';
+    // Sub-kinds from extras.type
+    if (type === 'branch')
+        return 'branch';
+    if (type === 'function')
+        return 'function';
+    if (type === 'context_set')
+        return 'context_set';
+    if (type === 'context_get')
+        return 'context_get';
+    if (type === 'variable')
+        return 'variable';
+    return 'component';
+}
+export function classifyPort(portName, label, isIn, nodeName) {
+    const direction = isIn ? 'in' : 'out';
+    // Flow ports: name starts with "in-" or "out-" (flow connectors with ▶ label)
+    const isFlowPort = label === '▶' && !nodeName.startsWith('Argument');
+    if (isFlowPort || portName.startsWith('out-') && label === '▶' || portName.startsWith('in-') && label === '▶') {
+        return { kind: 'flow', direction, dataType: null, varName: label };
+    }
+    // Parameter ports: "parameter-TYPE-NAME" or "parameter-out-TYPE-NAME"
+    let dataType = null;
+    let varName = label;
+    if (portName.startsWith('parameter-')) {
+        const parts = portName.split('-');
+        if (parts[1] === 'out') {
+            // parameter-out-TYPE-NAME
+            dataType = parts[2] || null;
+        }
+        else {
+            // parameter-TYPE-NAME
+            dataType = parts[1] || null;
+        }
+    }
+    return { kind: 'parameter', direction, dataType, varName };
+}
+export function classifyEdge(type) {
+    return type === 'triangle-link' ? 'flow' : 'data';
+}
+//# sourceMappingURL=classify.js.map

package/dist/parser/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../src/parser/classify.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,MAA+B;IACxE,MAAM,IAAI,GAAG,MAAM,CAAC,IAA0B,CAAC;IAE/C,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,IAAI,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,SAAS,CAAC;IAChF,IAAI,IAAI,KAAK,mBAAmB;QAAE,OAAO,UAAU,CAAC;IACpD,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IACrC,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAEvC,6BAA6B;IAC7B,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACvC,IAAI,IAAI,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAC3C,IAAI,IAAI,KAAK,aAAa;QAAE,OAAO,aAAa,CAAC;IACjD,IAAI,IAAI,KAAK,aAAa;QAAE,OAAO,aAAa,CAAC;IACjD,IAAI,IAAI,KAAK,UAAU;QAAE,OAAO,UAAU,CAAC;IAE3C,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,QAAgB,EAChB,KAAa,EACb,IAAa,EACb,QAAgB;IAEhB,MAAM,SAAS,GAAkB,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;IAErD,8EAA8E;IAC9E,MAAM,UAAU,GACd,KAAK,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAEpD,IAAI,UAAU,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,GAAG,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,GAAG,EAAE,CAAC;QAC9G,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACrE,CAAC;IAED,sEAAsE;IACtE,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,IAAI,QAAQ,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;YACvB,0BAA0B;YAC1B,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,sBAAsB;YACtB,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,KAAK,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;AACpD,CAAC"}

package/dist/parser/parse.d.ts

@@ -0,0 +1,3 @@
+import type { XGraph } from '../types.js';
+export declare function parse(json: unknown): XGraph;
+//# sourceMappingURL=parse.d.ts.map

package/dist/parser/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/parser/parse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAuB,MAAM,aAAa,CAAC;AAmD/D,wBAAgB,KAAK,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CA4F3C"}

package/dist/parser/parse.js

@@ -0,0 +1,92 @@
+import { classifyNode, classifyPort, classifyEdge } from './classify.js';
+import { validate } from './validate.js';
+export function parse(json) {
+    const { valid, errors } = validate(json);
+    if (!valid) {
+        throw new Error(`Invalid .xircuits file: ${errors.join(', ')}`);
+    }
+    const obj = json;
+    const layers = obj.layers;
+    const linkLayer = layers.find(l => l.type === 'diagram-links');
+    const nodeLayer = layers.find(l => l.type === 'diagram-nodes');
+    const rawNodes = Object.values(nodeLayer.models);
+    const rawLinks = linkLayer
+        ? Object.values(linkLayer.models)
+        : [];
+    // Build a port ID set for quick lookup
+    const portMap = new Map();
+    for (const rawNode of rawNodes) {
+        for (const port of rawNode.ports) {
+            portMap.set(port.id, port);
+        }
+    }
+    const nodes = rawNodes.map(raw => {
+        const kind = classifyNode(raw.name, raw.extras);
+        // Order ports according to portsInOrder/portsOutOrder
+        const portsInOrdered = orderPorts(raw.ports, raw.portsInOrder, true);
+        const portsOutOrdered = orderPorts(raw.ports, raw.portsOutOrder, false);
+        const portsIn = portsInOrdered.map(p => {
+            const cls = classifyPort(p.name, p.label, true, raw.name);
+            return {
+                id: p.id,
+                direction: cls.direction,
+                kind: cls.kind,
+                label: p.label,
+                varName: cls.varName,
+                dataType: p.dataType || cls.dataType,
+                linkIds: p.links || [],
+            };
+        });
+        const portsOut = portsOutOrdered.map(p => {
+            const cls = classifyPort(p.name, p.label, false, raw.name);
+            return {
+                id: p.id,
+                direction: cls.direction,
+                kind: cls.kind,
+                label: p.label,
+                varName: cls.varName,
+                dataType: p.dataType || cls.dataType,
+                linkIds: p.links || [],
+            };
+        });
+        return {
+            id: raw.id,
+            kind,
+            name: raw.name,
+            color: raw.color || 'red',
+            x: raw.x,
+            y: raw.y,
+            portsIn,
+            portsOut,
+            extras: raw.extras || {},
+        };
+    });
+    const edges = rawLinks.map(raw => ({
+        id: raw.id,
+        kind: classifyEdge(raw.type),
+        sourceNodeId: raw.source,
+        sourcePortId: raw.sourcePort,
+        targetNodeId: raw.target,
+        targetPortId: raw.targetPort,
+        points: raw.points || [],
+        color: raw.color || 'gray',
+    }));
+    return {
+        id: obj.id,
+        viewport: {
+            x: obj.offsetX || 0,
+            y: obj.offsetY || 0,
+            zoom: obj.zoom || 100,
+        },
+        nodes,
+        edges,
+    };
+}
+function orderPorts(ports, order, isIn) {
+    if (!order || order.length === 0) {
+        return ports.filter(p => p.in === isIn);
+    }
+    const portById = new Map(ports.map(p => [p.id, p]));
+    return order.map(id => portById.get(id)).filter((p) => p != null);
+}
+//# sourceMappingURL=parse.js.map

package/dist/parser/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/parser/parse.ts"],"names":[],"mappings":"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"}

package/dist/parser/validate.d.ts

@@ -0,0 +1,5 @@
+export declare function validate(json: unknown): {
+    valid: boolean;
+    errors: string[];
+};
+//# sourceMappingURL=validate.d.ts.map

package/dist/parser/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/parser/validate.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAuC5E"}

package/dist/parser/validate.js

@@ -0,0 +1,31 @@
+export function validate(json) {
+    const errors = [];
+    if (!json || typeof json !== 'object') {
+        return { valid: false, errors: ['Input must be an object'] };
+    }
+    const obj = json;
+    if (typeof obj.id !== 'string') {
+        errors.push('Missing or invalid "id" field');
+    }
+    if (!Array.isArray(obj.layers)) {
+        errors.push('Missing or invalid "layers" array');
+        return { valid: false, errors };
+    }
+    const layers = obj.layers;
+    const linkLayer = layers.find(l => l.type === 'diagram-links');
+    const nodeLayer = layers.find(l => l.type === 'diagram-nodes');
+    if (!nodeLayer) {
+        errors.push('Missing diagram-nodes layer');
+    }
+    if (!linkLayer) {
+        // Links layer is optional (a graph with no connections)
+    }
+    if (nodeLayer) {
+        const models = nodeLayer.models;
+        if (!models || typeof models !== 'object') {
+            errors.push('diagram-nodes layer missing "models" object');
+        }
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=validate.js.map

package/dist/parser/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/parser/validate.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,IAAa;IACpC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,yBAAyB,CAAC,EAAE,CAAC;IAC/D,CAAC;IAED,MAAM,GAAG,GAAG,IAA+B,CAAC;IAE5C,IAAI,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QACjD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,MAAwC,CAAC;IAE5D,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,eAAe,CAAC,CAAC;IAE/D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,wDAAwD;IAC1D,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;QAChC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC"}

package/dist/render/colors.d.ts

@@ -0,0 +1,14 @@
+export interface GradientColors {
+    color1: string;
+    color2: string;
+}
+/**
+ * Replicate the Xircuits title gradient from CustomNodeWidget.tsx:
+ *   const color = new Color(p.background);
+ *   color.alpha = 0.75; color.oklch.c *= 1.2;
+ *   const color1 = color.to('oklch').toString()
+ *   color.oklch.c *= 1.2; color.oklch.l /= 2;
+ *   const color2 = color.to('oklch').toString()
+ */
+export declare function titleGradient(baseColor: string): GradientColors;
+//# sourceMappingURL=colors.d.ts.map

package/dist/render/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../src/render/colors.ts"],"names":[],"mappings":"AAkEA,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,CAW/D"}