@stigmer/react 1.0.4 → 2.0.1

package/workflow/layout/elk-layout-engine.js

@@ -0,0 +1,68 @@
+/// <reference path="./elkjs.d.ts" />
+import { preprocessForElk } from "./workflow-preprocessor";
+import { postprocessElkResult } from "./layout-postprocessor";
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Creates an ELK-based layout engine with optional Web Worker support.
+ *
+ * This function dynamically imports elkjs — the import is deferred so that
+ * the ~1.5MB WASM module is only loaded when layout is first requested,
+ * not at SDK initialization time.
+ *
+ * If elkjs is not installed (optional peer dependency), the import will
+ * reject and the caller should fall back to the dagre engine.
+ *
+ * @throws If elkjs cannot be imported (not installed or bundler misconfiguration).
+ */
+export async function createElkLayoutEngine(options) {
+    const elk = await instantiateElk(options);
+    return new ElkLayoutEngineImpl(elk, options?.layoutOptions);
+}
+async function instantiateElk(options) {
+    if (options?.workerFactory) {
+        try {
+            const module = await import("elkjs/lib/elk-api.js");
+            const ELK = module.default ?? module;
+            return new ELK({ workerFactory: options.workerFactory });
+        }
+        catch {
+            // Worker path failed — fall through to bundled
+        }
+    }
+    const module = await import("elkjs/lib/elk.bundled.js");
+    const ELK = module.default ?? module;
+    return new ELK();
+}
+// ---------------------------------------------------------------------------
+// Engine Implementation
+// ---------------------------------------------------------------------------
+class ElkLayoutEngineImpl {
+    name = "elk-layered";
+    elk;
+    optionOverrides;
+    terminated = false;
+    constructor(elk, optionOverrides) {
+        this.elk = elk;
+        this.optionOverrides = optionOverrides;
+    }
+    async layout(input) {
+        if (this.terminated) {
+            throw new Error("ELK layout engine has been terminated.");
+        }
+        const start = performance.now();
+        const elkGraph = preprocessForElk(input, this.optionOverrides);
+        const rawResult = await this.elk.layout(elkGraph);
+        const elkResult = rawResult;
+        const durationMs = performance.now() - start;
+        return postprocessElkResult(elkResult, input.scope, input.graph, durationMs, this.name);
+    }
+    terminate() {
+        this.terminated = true;
+        if ("terminateWorker" in this.elk && typeof this.elk.terminateWorker === "function") {
+            this.elk.terminateWorker();
+        }
+    }
+}
+//# sourceMappingURL=elk-layout-engine.js.map

package/workflow/layout/elk-layout-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"elk-layout-engine.js","sourceRoot":"","sources":["../../../src/workflow/layout/elk-layout-engine.ts"],"names":[],"mappings":"AAAA,qCAAqC;AAGrC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AA8B9D,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAgC;IAEhC,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,OAAO,CAAC,CAAC;IAC1C,OAAO,IAAI,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;AAC9D,CAAC;AAUD,KAAK,UAAU,cAAc,CAAC,OAAgC;IAC5D,IAAI,OAAO,EAAE,aAAa,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,sBAAsB,CAAC,CAAC;YACpD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC;YACrC,OAAO,IAAI,GAAG,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,+CAA+C;QACjD,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;IACxD,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC;IACrC,OAAO,IAAI,GAAG,EAAE,CAAC;AACnB,CAAC;AAED,8EAA8E;AAC9E,wBAAwB;AACxB,8EAA8E;AAE9E,MAAM,mBAAmB;IACd,IAAI,GAAG,aAAa,CAAC;IACb,GAAG,CAAc;IACjB,eAAe,CAAqC;IAC7D,UAAU,GAAG,KAAK,CAAC;IAE3B,YAAY,GAAgB,EAAE,eAAwC;QACpE,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAkB;QAC7B,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEhC,MAAM,QAAQ,GAAa,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QACzE,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,QAAmB,CAAC,CAAC;QAC7D,MAAM,SAAS,GAAG,SAA4B,CAAC;QAE/C,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;QAE7C,OAAO,oBAAoB,CACzB,SAAS,EACT,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,KAAK,EACX,UAAU,EACV,IAAI,CAAC,IAAI,CACV,CAAC;IACJ,CAAC;IAED,SAAS;QACP,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACvB,IAAI,iBAAiB,IAAI,IAAI,CAAC,GAAG,IAAI,OAAQ,IAAI,CAAC,GAA+B,CAAC,eAAe,KAAK,UAAU,EAAE,CAAC;YAChH,IAAI,CAAC,GAAuC,CAAC,eAAe,EAAE,CAAC;QAClE,CAAC;IACH,CAAC;CACF"}

package/workflow/layout/index.d.ts

@@ -0,0 +1,15 @@
+export type { LayoutEngine, LayoutInput, LayoutResult, LayoutScope, LayoutOptions, NodeDimensions, Position2D, NodePortAssignment, PortDefinition, PortSide, } from "./types";
+export { createDagreLayoutEngine } from "./dagre-layout-engine";
+export { createElkLayoutEngine } from "./elk-layout-engine";
+export type { ElkLayoutEngineOptions } from "./elk-layout-engine";
+export { useWorkflowLayout } from "./use-workflow-layout";
+export type { UseWorkflowLayoutOptions, UseWorkflowLayoutReturn } from "./use-workflow-layout";
+export { useElkLayoutEngine } from "./useElkLayoutEngine";
+export type { UseElkLayoutEngineOptions } from "./useElkLayoutEngine";
+export { applyDagreLayout } from "./apply-dagre-layout";
+export type { DagreLayoutConfig } from "../canvas-constants";
+export { registryNodeDimensions } from "./registry-dimensions";
+export { preprocessForElk, ELK_WORKFLOW_DEFAULTS } from "./workflow-preprocessor";
+export { computePortAssignments, computeNodePorts } from "./port-assignment";
+export { postprocessElkResult } from "./layout-postprocessor";
+//# sourceMappingURL=index.d.ts.map

package/workflow/layout/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/workflow/layout/index.ts"],"names":[],"mappings":"AAIA,YAAY,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,WAAW,EACX,aAAa,EACb,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,QAAQ,GACT,MAAM,SAAS,CAAC;AAMjB,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAMlE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAE/F,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AAMtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAM7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAM/D,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/workflow/layout/index.js

@@ -0,0 +1,28 @@
+// ---------------------------------------------------------------------------
+// Types (public API for platform builders implementing custom engines)
+// ---------------------------------------------------------------------------
+// ---------------------------------------------------------------------------
+// Engine factories
+// ---------------------------------------------------------------------------
+export { createDagreLayoutEngine } from "./dagre-layout-engine";
+export { createElkLayoutEngine } from "./elk-layout-engine";
+// ---------------------------------------------------------------------------
+// React behavior hooks
+// ---------------------------------------------------------------------------
+export { useWorkflowLayout } from "./use-workflow-layout";
+export { useElkLayoutEngine } from "./useElkLayoutEngine";
+// ---------------------------------------------------------------------------
+// Synchronous layout utility (shared by editor and execution graph)
+// ---------------------------------------------------------------------------
+export { applyDagreLayout } from "./apply-dagre-layout";
+// ---------------------------------------------------------------------------
+// Registry-aware node dimensions (canonical adapter from visual registry)
+// ---------------------------------------------------------------------------
+export { registryNodeDimensions } from "./registry-dimensions";
+// ---------------------------------------------------------------------------
+// Preprocessor (exported for advanced use cases and testing)
+// ---------------------------------------------------------------------------
+export { preprocessForElk, ELK_WORKFLOW_DEFAULTS } from "./workflow-preprocessor";
+export { computePortAssignments, computeNodePorts } from "./port-assignment";
+export { postprocessElkResult } from "./layout-postprocessor";
+//# sourceMappingURL=index.js.map

package/workflow/layout/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/workflow/layout/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,uEAAuE;AACvE,8EAA8E;AAe9E,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,8EAA8E;AAC9E,oEAAoE;AACpE,8EAA8E;AAE9E,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAGxD,8EAA8E;AAC9E,0EAA0E;AAC1E,8EAA8E;AAE9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,8EAA8E;AAC9E,6DAA6D;AAC7D,8EAA8E;AAE9E,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/workflow/layout/layout-postprocessor.d.ts

@@ -0,0 +1,23 @@
+import type { WorkflowGraphModel } from "../workflow-graph-model";
+import type { ElkLayoutResult, LayoutResult, LayoutScope } from "./types";
+/**
+ * Transforms ELK layout output into a {@link LayoutResult}, applying scope
+ * filtering to determine which nodes receive new positions.
+ *
+ * ELK produces center coordinates for nodes. This function converts them
+ * to top-left coordinates (React Flow convention: position = top-left corner).
+ *
+ * Scope filtering (AD-T03-005):
+ * - `whole-graph`: all computed positions are included
+ * - `selected`: only positions for nodes in the selection set are included
+ * - `downstream`: only positions for the target node and all reachable
+ *   downstream nodes (via BFS on edges) are included
+ *
+ * @param elkResult - The raw result from `elk.layout()`.
+ * @param scope - Which nodes should receive new positions.
+ * @param graph - The original graph (needed for downstream traversal).
+ * @param durationMs - Wall-clock layout time to include in the result.
+ * @param engine - Engine name for attribution.
+ */
+export declare function postprocessElkResult(elkResult: ElkLayoutResult, scope: LayoutScope, graph: WorkflowGraphModel, durationMs: number, engine: string): LayoutResult;
+//# sourceMappingURL=layout-postprocessor.d.ts.map

package/workflow/layout/layout-postprocessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-postprocessor.d.ts","sourceRoot":"","sources":["../../../src/workflow/layout/layout-postprocessor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAqB,MAAM,yBAAyB,CAAC;AACrF,OAAO,KAAK,EACV,eAAe,EAEf,YAAY,EACZ,WAAW,EAEZ,MAAM,SAAS,CAAC;AAMjB;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,eAAe,EAC1B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,kBAAkB,EACzB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,YAAY,CAWd"}

package/workflow/layout/layout-postprocessor.js

@@ -0,0 +1,147 @@
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Transforms ELK layout output into a {@link LayoutResult}, applying scope
+ * filtering to determine which nodes receive new positions.
+ *
+ * ELK produces center coordinates for nodes. This function converts them
+ * to top-left coordinates (React Flow convention: position = top-left corner).
+ *
+ * Scope filtering (AD-T03-005):
+ * - `whole-graph`: all computed positions are included
+ * - `selected`: only positions for nodes in the selection set are included
+ * - `downstream`: only positions for the target node and all reachable
+ *   downstream nodes (via BFS on edges) are included
+ *
+ * @param elkResult - The raw result from `elk.layout()`.
+ * @param scope - Which nodes should receive new positions.
+ * @param graph - The original graph (needed for downstream traversal).
+ * @param durationMs - Wall-clock layout time to include in the result.
+ * @param engine - Engine name for attribution.
+ */
+export function postprocessElkResult(elkResult, scope, graph, durationMs, engine) {
+    const allPositions = extractPositions(elkResult);
+    const edgePaths = extractEdgePaths(elkResult);
+    const filteredPositions = filterByScope(allPositions, scope, graph);
+    return {
+        positions: filteredPositions,
+        edgePaths: edgePaths.size > 0 ? edgePaths : undefined,
+        durationMs,
+        engine,
+    };
+}
+// ---------------------------------------------------------------------------
+// Position extraction
+// ---------------------------------------------------------------------------
+/**
+ * ELK returns node positions as (x, y) relative to the parent.
+ * Since we have a flat graph (no compound nodes), all positions are
+ * relative to the root — which maps directly to React Flow coordinates.
+ *
+ * ELK's (x, y) is the top-left corner of the node bounding box,
+ * which matches React Flow's position convention.
+ */
+function extractPositions(elkResult) {
+    const positions = new Map();
+    if (!elkResult.children)
+        return positions;
+    for (const child of elkResult.children) {
+        positions.set(child.id, { x: child.x, y: child.y });
+    }
+    return positions;
+}
+// ---------------------------------------------------------------------------
+// Edge path extraction
+// ---------------------------------------------------------------------------
+function extractEdgePaths(elkResult) {
+    const paths = new Map();
+    if (!elkResult.edges)
+        return paths;
+    for (const edge of elkResult.edges) {
+        if (!edge.sections || edge.sections.length === 0)
+            continue;
+        const points = flattenEdgeSections(edge.sections);
+        if (points.length > 0) {
+            paths.set(edge.id, points);
+        }
+    }
+    return paths;
+}
+function flattenEdgeSections(sections) {
+    const points = [];
+    for (const section of sections) {
+        points.push(section.startPoint);
+        if (section.bendPoints) {
+            points.push(...section.bendPoints);
+        }
+        points.push(section.endPoint);
+    }
+    return points;
+}
+// ---------------------------------------------------------------------------
+// Scope filtering
+// ---------------------------------------------------------------------------
+function filterByScope(positions, scope, graph) {
+    switch (scope.type) {
+        case "whole-graph":
+            return positions;
+        case "selected":
+            return filterToSet(positions, scope.nodeIds);
+        case "downstream":
+            return filterToDownstream(positions, scope.fromNodeId, graph.edges);
+    }
+}
+function filterToSet(positions, nodeIds) {
+    const filtered = new Map();
+    for (const [id, pos] of positions) {
+        if (nodeIds.has(id)) {
+            filtered.set(id, pos);
+        }
+    }
+    return filtered;
+}
+function filterToDownstream(positions, fromNodeId, edges) {
+    const reachable = computeDownstreamSet(fromNodeId, edges);
+    const filtered = new Map();
+    for (const [id, pos] of positions) {
+        if (reachable.has(id)) {
+            filtered.set(id, pos);
+        }
+    }
+    return filtered;
+}
+/**
+ * BFS from a starting node following directed edges to find all
+ * reachable downstream nodes (including the starting node itself).
+ */
+function computeDownstreamSet(fromNodeId, edges) {
+    const adjacency = new Map();
+    for (const edge of edges) {
+        const targets = adjacency.get(edge.source);
+        if (targets) {
+            targets.push(edge.target);
+        }
+        else {
+            adjacency.set(edge.source, [edge.target]);
+        }
+    }
+    const visited = new Set();
+    const queue = [fromNodeId];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        if (visited.has(current))
+            continue;
+        visited.add(current);
+        const neighbors = adjacency.get(current);
+        if (neighbors) {
+            for (const neighbor of neighbors) {
+                if (!visited.has(neighbor)) {
+                    queue.push(neighbor);
+                }
+            }
+        }
+    }
+    return visited;
+}
+//# sourceMappingURL=layout-postprocessor.js.map

package/workflow/layout/layout-postprocessor.js.map

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

package/workflow/layout/port-assignment.d.ts

@@ -0,0 +1,20 @@
+import type { WorkflowGraphNode, WorkflowGraphEdge } from "../workflow-graph-model";
+import type { NodePortAssignment } from "./types";
+/**
+ * Computes port assignments for all nodes in a workflow graph.
+ *
+ * Port IDs are deterministic and align with the React Flow handle IDs
+ * used in `WorkflowNode` (`case_{name}`, `outcome_{name}`). This ensures
+ * ELK routes edges to the correct port and the postprocessor can map
+ * results back to the React Flow model without translation.
+ *
+ * @param nodes - All nodes in the workflow graph.
+ * @param edges - All edges (used to infer fork branch count).
+ */
+export declare function computePortAssignments(nodes: readonly WorkflowGraphNode[], edges: readonly WorkflowGraphEdge[]): ReadonlyMap<string, NodePortAssignment>;
+/**
+ * Computes port assignment for a single node.
+ * Exported for unit testing individual cases.
+ */
+export declare function computeNodePorts(node: WorkflowGraphNode, edges: readonly WorkflowGraphEdge[]): NodePortAssignment;
+//# sourceMappingURL=port-assignment.d.ts.map

package/workflow/layout/port-assignment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-assignment.d.ts","sourceRoot":"","sources":["../../../src/workflow/layout/port-assignment.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEpF,OAAO,KAAK,EAAE,kBAAkB,EAA4B,MAAM,SAAS,CAAC;AAM5E;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,SAAS,iBAAiB,EAAE,EACnC,KAAK,EAAE,SAAS,iBAAiB,EAAE,GAClC,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAQzC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,iBAAiB,EACvB,KAAK,EAAE,SAAS,iBAAiB,EAAE,GAClC,kBAAkB,CAuBpB"}

package/workflow/layout/port-assignment.js

@@ -0,0 +1,124 @@
+import { WorkflowTaskKind } from "@stigmer/protos/ai/stigmer/agentic/workflow/v1/enum_pb";
+import { START_NODE_ID, END_NODE_ID } from "../workflow-graph-model";
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Computes port assignments for all nodes in a workflow graph.
+ *
+ * Port IDs are deterministic and align with the React Flow handle IDs
+ * used in `WorkflowNode` (`case_{name}`, `outcome_{name}`). This ensures
+ * ELK routes edges to the correct port and the postprocessor can map
+ * results back to the React Flow model without translation.
+ *
+ * @param nodes - All nodes in the workflow graph.
+ * @param edges - All edges (used to infer fork branch count).
+ */
+export function computePortAssignments(nodes, edges) {
+    const result = new Map();
+    for (const node of nodes) {
+        result.set(node.id, computeNodePorts(node, edges));
+    }
+    return result;
+}
+/**
+ * Computes port assignment for a single node.
+ * Exported for unit testing individual cases.
+ */
+export function computeNodePorts(node, edges) {
+    const nodeId = node.id;
+    if (nodeId === START_NODE_ID) {
+        return {
+            nodeId,
+            inputPorts: [],
+            outputPorts: [makePort(`${nodeId}__out`, "SOUTH", 0)],
+        };
+    }
+    if (nodeId === END_NODE_ID) {
+        return {
+            nodeId,
+            inputPorts: [makePort(`${nodeId}__in`, "NORTH", 0)],
+            outputPorts: [],
+        };
+    }
+    const inputPorts = [makePort(`${nodeId}__in`, "NORTH", 0)];
+    const outputPorts = computeOutputPorts(node, edges);
+    return { nodeId, inputPorts, outputPorts };
+}
+// ---------------------------------------------------------------------------
+// Output port computation per task kind
+// ---------------------------------------------------------------------------
+function computeOutputPorts(node, edges) {
+    const config = node.config;
+    if (node.kind === WorkflowTaskKind.switch_case && config) {
+        return computeSwitchCasePorts(node.id, config);
+    }
+    if (node.kind === WorkflowTaskKind.human_input && config) {
+        return computeHumanInputPorts(node.id, config);
+    }
+    if (node.kind === WorkflowTaskKind.fork) {
+        return computeForkPorts(node.id, edges);
+    }
+    return [makePort(`${node.id}__out`, "SOUTH", 0)];
+}
+/**
+ * switch_case: one output port per case entry.
+ * Handle ID format matches CanvasTaskNode: `case_{caseName}`.
+ */
+function computeSwitchCasePorts(nodeId, config) {
+    const cases = config.cases;
+    if (!Array.isArray(cases) || cases.length === 0) {
+        return [makePort(`${nodeId}__out`, "SOUTH", 0)];
+    }
+    const ports = [];
+    let index = 0;
+    for (const c of cases) {
+        if (c != null && typeof c === "object" && typeof c.name === "string") {
+            const caseName = c.name;
+            ports.push(makePort(`${nodeId}__case_${caseName}`, "SOUTH", index, caseName));
+            index++;
+        }
+    }
+    return ports.length > 0 ? ports : [makePort(`${nodeId}__out`, "SOUTH", 0)];
+}
+/**
+ * human_input: one output port per outcome entry.
+ * Handle ID format matches CanvasTaskNode: `outcome_{outcomeName}`.
+ */
+function computeHumanInputPorts(nodeId, config) {
+    const outcomes = config.outcomes;
+    if (!Array.isArray(outcomes) || outcomes.length === 0) {
+        return [makePort(`${nodeId}__out`, "SOUTH", 0)];
+    }
+    const ports = [];
+    let index = 0;
+    for (const o of outcomes) {
+        if (o != null && typeof o === "object" && typeof o.name === "string") {
+            const outcomeName = o.name;
+            ports.push(makePort(`${nodeId}__outcome_${outcomeName}`, "SOUTH", index, outcomeName));
+            index++;
+        }
+    }
+    return ports.length > 0 ? ports : [makePort(`${nodeId}__out`, "SOUTH", 0)];
+}
+/**
+ * fork: one output port per outgoing edge from this node.
+ * Handle IDs use a stable index: `branch_{index}`.
+ */
+function computeForkPorts(nodeId, edges) {
+    const outgoing = edges.filter((e) => e.source === nodeId);
+    if (outgoing.length <= 1) {
+        return [makePort(`${nodeId}__out`, "SOUTH", 0)];
+    }
+    return outgoing.map((edge, index) => {
+        const handleId = edge.sourceHandle ?? `branch_${index}`;
+        return makePort(`${nodeId}__${handleId}`, "SOUTH", index);
+    });
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function makePort(id, side, index, label) {
+    return { id, side, index, ...(label !== undefined && { label }) };
+}
+//# sourceMappingURL=port-assignment.js.map

package/workflow/layout/port-assignment.js.map

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

package/workflow/layout/registry-dimensions.d.ts

@@ -0,0 +1,22 @@
+import type { WorkflowGraphNode } from "../workflow-graph-model";
+import type { NodeDimensions } from "./types";
+/**
+ * Resolves per-node dimensions from the visual registry (T01).
+ *
+ * This is the canonical adapter that bridges `WorkflowGraphNode` to the
+ * `NodeDimensions` contract expected by layout engines. It handles both
+ * sentinel nodes (`__start__`, `__end__`) and task nodes by delegating
+ * to `getVisualSpec`, which returns shape-appropriate dimensions
+ * (diamonds, bars, circles, octagons, containers, and cards).
+ *
+ * The returned height includes `captionHeight` — the space reserved for
+ * the task name caption below non-rectangular shapes. This ensures the
+ * layout engine allocates sufficient vertical spacing to prevent overlap
+ * between caption text and subsequent nodes/edges.
+ *
+ * Defined at module scope — referentially stable with no closure over
+ * React state. Safe to pass directly as `getNodeDimensions` without
+ * wrapping in `useCallback` (DD-010).
+ */
+export declare function registryNodeDimensions(node: WorkflowGraphNode): NodeDimensions;
+//# sourceMappingURL=registry-dimensions.d.ts.map

package/workflow/layout/registry-dimensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-dimensions.d.ts","sourceRoot":"","sources":["../../../src/workflow/layout/registry-dimensions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,iBAAiB,GAAG,cAAc,CAK9E"}

package/workflow/layout/registry-dimensions.js

@@ -0,0 +1,28 @@
+import { getVisualSpec } from "../task-type-visual-registry";
+import { taskKindToString } from "../workflow-graph-conversions";
+import { START_NODE_ID, END_NODE_ID } from "../workflow-graph-model";
+/**
+ * Resolves per-node dimensions from the visual registry (T01).
+ *
+ * This is the canonical adapter that bridges `WorkflowGraphNode` to the
+ * `NodeDimensions` contract expected by layout engines. It handles both
+ * sentinel nodes (`__start__`, `__end__`) and task nodes by delegating
+ * to `getVisualSpec`, which returns shape-appropriate dimensions
+ * (diamonds, bars, circles, octagons, containers, and cards).
+ *
+ * The returned height includes `captionHeight` — the space reserved for
+ * the task name caption below non-rectangular shapes. This ensures the
+ * layout engine allocates sufficient vertical spacing to prevent overlap
+ * between caption text and subsequent nodes/edges.
+ *
+ * Defined at module scope — referentially stable with no closure over
+ * React state. Safe to pass directly as `getNodeDimensions` without
+ * wrapping in `useCallback` (DD-010).
+ */
+export function registryNodeDimensions(node) {
+    const isSentinel = node.id === START_NODE_ID || node.id === END_NODE_ID;
+    const kindKey = isSentinel ? node.id : taskKindToString(node.kind);
+    const spec = getVisualSpec(kindKey);
+    return { width: spec.defaultWidth, height: spec.defaultHeight + spec.captionHeight };
+}
+//# sourceMappingURL=registry-dimensions.js.map

package/workflow/layout/registry-dimensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-dimensions.js","sourceRoot":"","sources":["../../../src/workflow/layout/registry-dimensions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAIrE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAuB;IAC5D,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE,KAAK,aAAa,IAAI,IAAI,CAAC,EAAE,KAAK,WAAW,CAAC;IACxE,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnE,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;AACvF,CAAC"}