@principal-ai/subsystems-react 0.17.0

package/dist/utils/animationMapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animationMapping.d.ts","sourceRoot":"","sources":["../../src/utils/animationMapping.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,eAAe,CAAC;IACrD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,QAAQ,GAAG,aAAa,CAkCtE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,CAiDpF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,aAAa,GAAG,aAAa,CAShG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,GAAE,QAAiB,GAAG,OAAO,CAMnF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,WAAW,GAAE,MAAa,GACzB,MAAM,CAIR"}

package/dist/utils/animationMapping.js

@@ -0,0 +1,126 @@
+/**
+ * Animation mapping utilities
+ *
+ * Maps log levels and component events to appropriate animations
+ * for Milestone 1 default visualization behavior
+ */
+/**
+ * Map log level to node animation
+ *
+ * Default behavior for Milestone 1:
+ * - debug: subtle pulse (low intensity)
+ * - info: standard pulse (medium intensity)
+ * - warn: amber pulse (high intensity)
+ * - error: red flash + shake
+ */
+export function logLevelToNodeAnimation(level) {
+    switch (level) {
+        case 'debug':
+            return {
+                type: 'pulse',
+                duration: 800,
+                intensity: 0.3,
+                color: '#94a3b8', // slate-400
+            };
+        case 'info':
+            return {
+                type: 'pulse',
+                duration: 1000,
+                intensity: 0.5,
+                color: '#3b82f6', // blue-500
+            };
+        case 'warn':
+            return {
+                type: 'pulse',
+                duration: 1200,
+                intensity: 1.0,
+                color: '#f59e0b', // amber-500
+            };
+        case 'error':
+            return {
+                type: 'flash',
+                duration: 1500,
+                intensity: 1.0,
+                color: '#ef4444', // red-500
+            };
+    }
+}
+/**
+ * Map component action to node animation (Milestone 2)
+ */
+export function actionToNodeAnimation(_action, state) {
+    // Default mapping - can be overridden by configuration
+    switch (state) {
+        case 'acquired':
+        case 'active':
+        case 'processing':
+            return {
+                type: 'pulse',
+                duration: 1000,
+                intensity: 0.8,
+                color: '#22c55e', // green-500
+            };
+        case 'waiting':
+        case 'pending':
+            return {
+                type: 'pulse',
+                duration: 1500,
+                intensity: 0.5,
+                color: '#eab308', // yellow-500
+            };
+        case 'error':
+        case 'failed':
+            return {
+                type: 'shake',
+                duration: 600,
+                intensity: 1.0,
+                color: '#ef4444', // red-500
+            };
+        case 'completed':
+        case 'success':
+            return {
+                type: 'flash',
+                duration: 800,
+                intensity: 0.7,
+                color: '#22c55e', // green-500
+            };
+        default:
+            // Generic action animation
+            return {
+                type: 'pulse',
+                duration: 1000,
+                intensity: 0.6,
+                color: '#3b82f6', // blue-500
+            };
+    }
+}
+/**
+ * Get animation config for edge based on action (Milestone 2)
+ */
+export function actionToEdgeAnimation(_action, edgeConfig) {
+    // Use edge config if provided, otherwise default
+    return (edgeConfig || {
+        type: 'flow',
+        duration: 2000,
+        direction: 'forward',
+    });
+}
+/**
+ * Check if log level should trigger animation
+ */
+export function shouldAnimate(level, minLevel = 'info') {
+    const levels = ['debug', 'info', 'warn', 'error'];
+    const minIndex = levels.indexOf(minLevel);
+    const currentIndex = levels.indexOf(level);
+    return currentIndex >= minIndex;
+}
+/**
+ * Calculate animation intensity based on frequency
+ * Used to adjust animation intensity when multiple logs occur rapidly
+ */
+export function calculateIntensity(baseIntensity, eventCount, _timeWindow = 1000) {
+    // Reduce intensity if too many events in time window
+    const scaleFactor = Math.min(1.0, 5.0 / eventCount);
+    return Math.max(0.2, baseIntensity * scaleFactor);
+}
+//# sourceMappingURL=animationMapping.js.map

package/dist/utils/animationMapping.js.map

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

package/dist/utils/canvasBounds.d.ts

@@ -0,0 +1,50 @@
+import type { ExtendedCanvas } from '@principal-ai/subsystems-core';
+export interface CanvasBounds {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+    width: number;
+    height: number;
+}
+/**
+ * Calculate the bounding box of all nodes in a canvas.
+ * Returns the min/max coordinates and total dimensions.
+ */
+export declare function getCanvasBounds(canvas: ExtendedCanvas): CanvasBounds;
+export interface Viewport {
+    x: number;
+    y: number;
+    zoom: number;
+}
+/**
+ * Calculate the initial viewport to fit all nodes within a container.
+ * This allows setting defaultViewport on ReactFlow to avoid the
+ * "zoom in then animate out" effect.
+ *
+ * @param bounds - The bounding box of all nodes
+ * @param containerWidth - Width of the container in pixels
+ * @param containerHeight - Height of the container in pixels
+ * @param options - Additional options for padding and zoom limits
+ * @returns The viewport { x, y, zoom } to pass to ReactFlow's defaultViewport
+ */
+export declare function calculateInitialViewport(bounds: CanvasBounds, containerWidth: number, containerHeight: number, options?: {
+    padding?: number;
+    minZoom?: number;
+    maxZoom?: number;
+}): Viewport;
+/**
+ * Calculate a recommended display size for a canvas cell.
+ * Adds padding and enforces minimum dimensions.
+ */
+export declare function getCanvasDisplaySize(canvas: ExtendedCanvas, options?: {
+    padding?: number;
+    minWidth?: number;
+    minHeight?: number;
+    maxWidth?: number;
+    maxHeight?: number;
+}): {
+    width: number;
+    height: number;
+};
+//# sourceMappingURL=canvasBounds.d.ts.map

package/dist/utils/canvasBounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasBounds.d.ts","sourceRoot":"","sources":["../../src/utils/canvasBounds.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAKD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAqCpE;AAED,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,YAAY,EACpB,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACb,GACL,QAAQ,CA2BV;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACf,GACL;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAoBnC"}

package/dist/utils/canvasBounds.js

@@ -0,0 +1,88 @@
+const DEFAULT_NODE_WIDTH = 200;
+const DEFAULT_NODE_HEIGHT = 100;
+/**
+ * Calculate the bounding box of all nodes in a canvas.
+ * Returns the min/max coordinates and total dimensions.
+ */
+export function getCanvasBounds(canvas) {
+    if (!canvas.nodes || canvas.nodes.length === 0) {
+        return {
+            minX: 0,
+            minY: 0,
+            maxX: DEFAULT_NODE_WIDTH,
+            maxY: DEFAULT_NODE_HEIGHT,
+            width: DEFAULT_NODE_WIDTH,
+            height: DEFAULT_NODE_HEIGHT,
+        };
+    }
+    let minX = Infinity;
+    let minY = Infinity;
+    let maxX = -Infinity;
+    let maxY = -Infinity;
+    for (const node of canvas.nodes) {
+        const x = node.x ?? 0;
+        const y = node.y ?? 0;
+        const width = node.width ?? DEFAULT_NODE_WIDTH;
+        const height = node.height ?? DEFAULT_NODE_HEIGHT;
+        minX = Math.min(minX, x);
+        minY = Math.min(minY, y);
+        maxX = Math.max(maxX, x + width);
+        maxY = Math.max(maxY, y + height);
+    }
+    return {
+        minX,
+        minY,
+        maxX,
+        maxY,
+        width: maxX - minX,
+        height: maxY - minY,
+    };
+}
+/**
+ * Calculate the initial viewport to fit all nodes within a container.
+ * This allows setting defaultViewport on ReactFlow to avoid the
+ * "zoom in then animate out" effect.
+ *
+ * @param bounds - The bounding box of all nodes
+ * @param containerWidth - Width of the container in pixels
+ * @param containerHeight - Height of the container in pixels
+ * @param options - Additional options for padding and zoom limits
+ * @returns The viewport { x, y, zoom } to pass to ReactFlow's defaultViewport
+ */
+export function calculateInitialViewport(bounds, containerWidth, containerHeight, options = {}) {
+    const { padding = 0.2, minZoom = 0.1, maxZoom = 1.5 } = options;
+    // Calculate the zoom level needed to fit the bounds within the container
+    // Account for padding by reducing the effective container size
+    const effectiveWidth = containerWidth * (1 - padding);
+    const effectiveHeight = containerHeight * (1 - padding);
+    const zoomX = effectiveWidth / bounds.width;
+    const zoomY = effectiveHeight / bounds.height;
+    // Use the smaller zoom to ensure both dimensions fit
+    let zoom = Math.min(zoomX, zoomY);
+    // Clamp to min/max zoom
+    zoom = Math.max(minZoom, Math.min(maxZoom, zoom));
+    // Calculate the center of the bounds
+    const boundsCenterX = bounds.minX + bounds.width / 2;
+    const boundsCenterY = bounds.minY + bounds.height / 2;
+    // Calculate viewport position to center the bounds
+    // ReactFlow viewport x,y represent the offset of the canvas origin from the container's top-left
+    const x = containerWidth / 2 - boundsCenterX * zoom;
+    const y = containerHeight / 2 - boundsCenterY * zoom;
+    return { x, y, zoom };
+}
+/**
+ * Calculate a recommended display size for a canvas cell.
+ * Adds padding and enforces minimum dimensions.
+ */
+export function getCanvasDisplaySize(canvas, options = {}) {
+    const { padding = 100, minWidth = 300, minHeight = 200, maxWidth = 1200, maxHeight = 800, } = options;
+    const bounds = getCanvasBounds(canvas);
+    // Add padding to content dimensions
+    const contentWidth = bounds.width + padding * 2;
+    const contentHeight = bounds.height + padding * 2;
+    // Clamp to min/max
+    const width = Math.min(maxWidth, Math.max(minWidth, contentWidth));
+    const height = Math.min(maxHeight, Math.max(minHeight, contentHeight));
+    return { width, height };
+}
+//# sourceMappingURL=canvasBounds.js.map

package/dist/utils/canvasBounds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvasBounds.js","sourceRoot":"","sources":["../../src/utils/canvasBounds.ts"],"names":[],"mappings":"AAWA,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAC/B,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAEhC;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,MAAsB;IACpD,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;QAC9C,OAAO;YACL,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,CAAC;YACP,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,mBAAmB;YACzB,KAAK,EAAE,kBAAkB;YACzB,MAAM,EAAE,mBAAmB;SAC5B,CAAC;KACH;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,MAAM,CAAC,KAAK,EAAE;QAC/B,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QACtB,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,kBAAkB,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,mBAAmB,CAAC;QAElD,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACzB,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACzB,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC;QACjC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC;KACnC;IAED,OAAO;QACL,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,KAAK,EAAE,IAAI,GAAG,IAAI;QAClB,MAAM,EAAE,IAAI,GAAG,IAAI;KACpB,CAAC;AACJ,CAAC;AAQD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAoB,EACpB,cAAsB,EACtB,eAAuB,EACvB,UAII,EAAE;IAEN,MAAM,EAAE,OAAO,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC;IAEhE,yEAAyE;IACzE,+DAA+D;IAC/D,MAAM,cAAc,GAAG,cAAc,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;IACtD,MAAM,eAAe,GAAG,eAAe,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;IAExD,MAAM,KAAK,GAAG,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC;IAC5C,MAAM,KAAK,GAAG,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAE9C,qDAAqD;IACrD,IAAI,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAElC,wBAAwB;IACxB,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;IAElD,qCAAqC;IACrC,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;IACrD,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAEtD,mDAAmD;IACnD,iGAAiG;IACjG,MAAM,CAAC,GAAG,cAAc,GAAG,CAAC,GAAG,aAAa,GAAG,IAAI,CAAC;IACpD,MAAM,CAAC,GAAG,eAAe,GAAG,CAAC,GAAG,aAAa,GAAG,IAAI,CAAC;IAErD,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAsB,EACtB,UAMI,EAAE;IAEN,MAAM,EACJ,OAAO,GAAG,GAAG,EACb,QAAQ,GAAG,GAAG,EACd,SAAS,GAAG,GAAG,EACf,QAAQ,GAAG,IAAI,EACf,SAAS,GAAG,GAAG,GAChB,GAAG,OAAO,CAAC;IAEZ,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IAEvC,oCAAoC;IACpC,MAAM,YAAY,GAAG,MAAM,CAAC,KAAK,GAAG,OAAO,GAAG,CAAC,CAAC;IAChD,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,GAAG,OAAO,GAAG,CAAC,CAAC;IAElD,mBAAmB;IACnB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;IAEvE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC"}

package/dist/utils/elkLayout.d.ts

@@ -0,0 +1,137 @@
+/**
+ * ELK (Eclipse Layout Kernel) Layout Utility
+ *
+ * Provides sophisticated edge routing with orthogonal (circuit-board style) paths
+ * that don't overlap and run parallel to each other.
+ */
+import type { Node, Edge } from '@xyflow/react';
+/** ELK layout options for different routing styles */
+export type ElkRoutingStyle = 'orthogonal' | 'splines' | 'polyline';
+/** Options for ELK layout */
+export interface ElkLayoutOptions {
+    /**
+     * Edge routing style
+     * - 'orthogonal': Circuit-board style with 90-degree angles (default)
+     * - 'splines': Smooth curved edges
+     * - 'polyline': Straight line segments
+     */
+    routingStyle?: ElkRoutingStyle;
+    /**
+     * Whether to preserve manual node positions
+     * If true, only edge routing is computed
+     * If false, ELK will also position nodes
+     * @default true
+     */
+    preserveNodePositions?: boolean;
+    /**
+     * Minimum spacing between nodes
+     * @default 50
+     */
+    nodeSpacing?: number;
+    /**
+     * Minimum spacing between edges
+     * @default 8
+     */
+    edgeSpacing?: number;
+    /**
+     * Spacing between edge and node
+     * @default 10
+     */
+    edgeNodeSpacing?: number;
+    /**
+     * Minimum horizontal distance between layers (node-to-node across layers).
+     * Controls the gap that prevents nodes in adjacent layers from overlapping.
+     * @default 0
+     */
+    interLayerSpacing?: number;
+    /**
+     * Reserve space along edges for inline labels so they don't overlap nodes
+     * or other edges. When enabled ELK places labels inline on the edge with the
+     * given margin model.
+     */
+    edgeLabels?: {
+        /** Whether to reserve label space in the layout. @default true */
+        enabled?: boolean;
+        /** Placement of inline labels. @default 'CENTER' */
+        placement?: 'CENTER' | 'TAIL' | 'HEAD';
+    };
+    /**
+     * Layout direction
+     * @default 'RIGHT'
+     */
+    direction?: 'RIGHT' | 'LEFT' | 'DOWN' | 'UP';
+    /**
+     * Compound groups — each becomes a nested ELK parent whose `memberIds`
+     * are laid out inside it. Members reference the group via React Flow
+     * `parentId`; ELK returns parent-relative child positions which this
+     * module flattens back to absolute flow coordinates.
+     */
+    groups?: Array<{
+        id: string;
+        memberIds: string[];
+    }>;
+}
+/** Result of ELK layout computation */
+export interface ElkLayoutResult {
+    /** Nodes with updated positions (if preserveNodePositions is false) */
+    nodes: Node[];
+    /** Edge paths as SVG path strings, keyed by edge ID */
+    edgePaths: Map<string, string>;
+    /** Edge label positions, keyed by edge ID */
+    edgeLabelPositions: Map<string, {
+        x: number;
+        y: number;
+    }>;
+    /** Raw ELK path points per edge (for debugging). */
+    edgePathPoints: Map<string, Point[]>;
+    /** Compound parent bounds from ELK (absolute flow coords), keyed by group id. */
+    groupBounds: Map<string, {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>;
+}
+/** Point in 2D space */
+export interface Point {
+    x: number;
+    y: number;
+}
+/**
+ * Convert bend points to SVG path string
+ * @public Exported for testing
+ */
+export declare function pointsToPath(points: Point[]): string;
+/**
+ * Convert bend points to smooth orthogonal path with rounded corners
+ * @public Exported for testing
+ */
+export declare function pointsToSmoothPath(points: Point[], cornerRadius?: number): string;
+/**
+ * Calculate the midpoint of a path for label positioning
+ * @public Exported for testing
+ */
+export declare function calculatePathMidpoint(points: Point[]): Point;
+/**
+ * Closest point on a polyline to a target (for snapping labels onto the stroke).
+ */
+export declare function closestPointOnPath(points: Point[], target: Point): Point;
+/**
+ * Polyline length in flow-space units (sum of segment lengths).
+ * @public Exported for testing
+ */
+export declare function calculatePathLength(points: Point[]): number;
+/**
+ * Compute ELK layout for nodes and edges
+ *
+ * @param nodes - xyflow nodes
+ * @param edges - xyflow edges
+ * @param options - Layout options
+ * @returns Layout result with edge paths
+ */
+export declare function computeElkLayout(nodes: Node[], edges: Edge[], options?: ElkLayoutOptions): Promise<ElkLayoutResult>;
+/**
+ * Hook-friendly version that returns a layout function
+ */
+export declare function createElkLayouter(options?: ElkLayoutOptions): (nodes: Node[], edges: Edge[]) => Promise<ElkLayoutResult>;
+//# sourceMappingURL=elkLayout.d.ts.map

package/dist/utils/elkLayout.d.ts.map

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