@coral-viz/viz 0.2.3

package/dist/layout/useAxisConstrain.js

@@ -0,0 +1,106 @@
+/**
+ * useAxisConstrain — Shift+drag axis-locked node movement
+ *
+ * Wraps React Flow's onNodesChange to constrain drag movement to a single
+ * axis (horizontal or vertical) when the Shift key is held. The dominant
+ * axis is detected after a small movement threshold.
+ */
+import { useCallback, useRef, useEffect } from 'react';
+/** Threshold in pixels before locking to an axis */
+const AXIS_LOCK_THRESHOLD = 5;
+/**
+ * Wraps onNodesChange to add Shift+drag axis constraint.
+ *
+ * @param originalOnNodesChange - The onNodesChange from useNodesState
+ * @param nodes - Current nodes array (to read start positions)
+ */
+export function useAxisConstrain(originalOnNodesChange, nodes) {
+    const shiftHeld = useRef(false);
+    const dragState = useRef(null);
+    // Track Shift key globally
+    useEffect(() => {
+        const onKeyDown = (e) => {
+            if (e.key === 'Shift')
+                shiftHeld.current = true;
+        };
+        const onKeyUp = (e) => {
+            if (e.key === 'Shift')
+                shiftHeld.current = false;
+        };
+        window.addEventListener('keydown', onKeyDown);
+        window.addEventListener('keyup', onKeyUp);
+        return () => {
+            window.removeEventListener('keydown', onKeyDown);
+            window.removeEventListener('keyup', onKeyUp);
+        };
+    }, []);
+    const onNodesChange = useCallback((changes) => {
+        if (!shiftHeld.current) {
+            // No Shift held — pass through unmodified, reset drag state
+            if (dragState.current)
+                dragState.current = null;
+            originalOnNodesChange(changes);
+            return;
+        }
+        const modified = changes.map((change) => {
+            if (change.type !== 'position')
+                return change;
+            const posChange = change;
+            // Drag ended
+            if (posChange.dragging === false) {
+                if (dragState.current?.nodeId === posChange.id) {
+                    dragState.current = null;
+                }
+                return change;
+            }
+            // No position data yet
+            if (!posChange.position)
+                return change;
+            // Drag starting — record start position from current node state
+            if (!dragState.current || dragState.current.nodeId !== posChange.id) {
+                const node = nodes.find((n) => n.id === posChange.id);
+                if (!node)
+                    return change;
+                dragState.current = {
+                    nodeId: posChange.id,
+                    startPos: { x: node.position.x, y: node.position.y },
+                    axis: null,
+                };
+            }
+            const state = dragState.current;
+            const dx = posChange.position.x - state.startPos.x;
+            const dy = posChange.position.y - state.startPos.y;
+            // Detect axis if not yet locked
+            if (!state.axis) {
+                const absDx = Math.abs(dx);
+                const absDy = Math.abs(dy);
+                if (absDx > AXIS_LOCK_THRESHOLD || absDy > AXIS_LOCK_THRESHOLD) {
+                    state.axis = absDx >= absDy ? 'x' : 'y';
+                }
+                else {
+                    // Below threshold — freeze in place
+                    return {
+                        ...posChange,
+                        position: { ...state.startPos },
+                    };
+                }
+            }
+            // Apply axis constraint
+            if (state.axis === 'x') {
+                return {
+                    ...posChange,
+                    position: { x: posChange.position.x, y: state.startPos.y },
+                };
+            }
+            else {
+                return {
+                    ...posChange,
+                    position: { x: state.startPos.x, y: posChange.position.y },
+                };
+            }
+        });
+        originalOnNodesChange(modified);
+    }, [originalOnNodesChange, nodes]);
+    return { onNodesChange };
+}
+//# sourceMappingURL=useAxisConstrain.js.map

package/dist/layout/useAxisConstrain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useAxisConstrain.js","sourceRoot":"","sources":["../../src/layout/useAxisConstrain.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvD,oDAAoD;AACpD,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAa9B;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,qBAAgE,EAChE,KAAiB;IAEjB,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,SAAS,GAAG,MAAM,CAAmB,IAAI,CAAC,CAAC;IAEjD,2BAA2B;IAC3B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,SAAS,GAAG,CAAC,CAAgB,EAAE,EAAE;YACrC,IAAI,CAAC,CAAC,GAAG,KAAK,OAAO;gBAAE,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;QAClD,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,CAAC,CAAgB,EAAE,EAAE;YACnC,IAAI,CAAC,CAAC,GAAG,KAAK,OAAO;gBAAE,SAAS,CAAC,OAAO,GAAG,KAAK,CAAC;QACnD,CAAC,CAAC;QACF,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC9C,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC1C,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACjD,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC/C,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,aAAa,GAAG,WAAW,CAC/B,CAAC,OAA+B,EAAE,EAAE;QAClC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YACvB,4DAA4D;YAC5D,IAAI,SAAS,CAAC,OAAO;gBAAE,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;YAChD,qBAAqB,CAAC,OAAO,CAAC,CAAC;YAC/B,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YACtC,IAAI,MAAM,CAAC,IAAI,KAAK,UAAU;gBAAE,OAAO,MAAM,CAAC;YAE9C,MAAM,SAAS,GAAG,MAKjB,CAAC;YAEF,aAAa;YACb,IAAI,SAAS,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;gBACjC,IAAI,SAAS,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,CAAC,EAAE,EAAE,CAAC;oBAC/C,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;gBAC3B,CAAC;gBACD,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,uBAAuB;YACvB,IAAI,CAAC,SAAS,CAAC,QAAQ;gBAAE,OAAO,MAAM,CAAC;YAEvC,gEAAgE;YAChE,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,EAAE,EAAE,CAAC;gBACpE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,SAAS,CAAC,EAAE,CAAC,CAAC;gBACtD,IAAI,CAAC,IAAI;oBAAE,OAAO,MAAM,CAAC;gBACzB,SAAS,CAAC,OAAO,GAAG;oBAClB,MAAM,EAAE,SAAS,CAAC,EAAE;oBACpB,QAAQ,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE;oBACpD,IAAI,EAAE,IAAI;iBACX,CAAC;YACJ,CAAC;YAED,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC;YAChC,MAAM,EAAE,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YACnD,MAAM,EAAE,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YAEnD,gCAAgC;YAChC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;gBAChB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAC3B,IAAI,KAAK,GAAG,mBAAmB,IAAI,KAAK,GAAG,mBAAmB,EAAE,CAAC;oBAC/D,KAAK,CAAC,IAAI,GAAG,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;gBAC1C,CAAC;qBAAM,CAAC;oBACN,oCAAoC;oBACpC,OAAO;wBACL,GAAG,SAAS;wBACZ,QAAQ,EAAE,EAAE,GAAG,KAAK,CAAC,QAAQ,EAAE;qBAChC,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,wBAAwB;YACxB,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;gBACvB,OAAO;oBACL,GAAG,SAAS;oBACZ,QAAQ,EAAE,EAAE,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE;iBAC3D,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,OAAO;oBACL,GAAG,SAAS;oBACZ,QAAQ,EAAE,EAAE,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC,EAAE;iBAC3D,CAAC;YACJ,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,qBAAqB,CAAC,QAAkC,CAAC,CAAC;IAC5D,CAAC,EACD,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAC/B,CAAC;IAEF,OAAO,EAAE,aAAa,EAAE,CAAC;AAC3B,CAAC"}

package/dist/layout/useDiagramState.d.ts

@@ -0,0 +1,92 @@
+/**
+ * useDiagramState Hook (CORAL-REQ-013)
+ *
+ * Manages diagram state with separated parse, render, and layout operations.
+ * Preserves node positions across DSL changes and supports undo/redo.
+ */
+import type { Node, Edge } from '@xyflow/react';
+import type { Position, PositionSource } from '../types.js';
+/**
+ * Parsed graph from DSL - minimal structure for diffing
+ */
+export interface ParsedGraph {
+    nodes: Array<{
+        id: string;
+        type: string;
+        label: string;
+        width?: number;
+        height?: number;
+    }>;
+    edges: Array<{
+        id: string;
+        source: string;
+        target: string;
+        label?: string;
+    }>;
+}
+/**
+ * Node data for React Flow
+ */
+export interface DiagramNodeData {
+    label: string;
+    nodeType: string;
+    [key: string]: unknown;
+}
+/**
+ * React Flow node with diagram data
+ */
+export type DiagramNode = Node<DiagramNodeData>;
+/**
+ * React Flow edge
+ */
+export type DiagramEdge = Edge;
+/**
+ * useDiagramState options
+ */
+export interface UseDiagramStateOptions {
+    /** Maximum history entries to keep */
+    maxHistory?: number;
+    /** Layout direction */
+    direction?: 'DOWN' | 'UP' | 'LEFT' | 'RIGHT';
+    /** Node spacing */
+    spacing?: number;
+}
+/**
+ * useDiagramState return type
+ */
+export interface UseDiagramStateResult {
+    /** Current React Flow nodes */
+    nodes: DiagramNode[];
+    /** Current React Flow edges */
+    edges: DiagramEdge[];
+    /** Loading state during layout operations */
+    isLoading: boolean;
+    /** Update the graph from parsed DSL */
+    setGraph: (graph: ParsedGraph) => Promise<void>;
+    /** Handle node drag - updates position */
+    onNodeDrag: (nodeId: string, position: Position) => void;
+    /** Handle drag end - saves snapshot for undo */
+    onDragEnd: () => void;
+    /** Run full ELK layout */
+    reflow: () => Promise<void>;
+    /** Set node positions directly (e.g., from loaded document) */
+    setNodePositions: (positions: Map<string, Position>, source: PositionSource) => void;
+    /** Get position source for a node */
+    getPositionSource: (nodeId: string) => PositionSource | undefined;
+    /** Undo last position change */
+    undo: () => void;
+    /** Redo last undone change */
+    redo: () => void;
+    /** Can undo? */
+    canUndo: boolean;
+    /** Can redo? */
+    canRedo: boolean;
+}
+/**
+ * Hook for managing diagram state with position stability.
+ *
+ * Separates parse, render, and layout operations to prevent undo/redo
+ * positions from being overwritten by automatic layout.
+ */
+export declare function useDiagramState(options?: UseDiagramStateOptions): UseDiagramStateResult;
+//# sourceMappingURL=useDiagramState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDiagramState.d.ts","sourceRoot":"","sources":["../../src/layout/useDiagramState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAiB,MAAM,aAAa,CAAC;AAG3E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IACH,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC;AAgB/B;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;IAC7C,mBAAmB;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,+BAA+B;IAC/B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,+BAA+B;IAC/B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,6CAA6C;IAC7C,SAAS,EAAE,OAAO,CAAC;IAEnB,uCAAuC;IACvC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,0CAA0C;IAC1C,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IACzD,gDAAgD;IAChD,SAAS,EAAE,MAAM,IAAI,CAAC;IACtB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,+DAA+D;IAC/D,gBAAgB,EAAE,CAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAErF,qCAAqC;IACrC,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,cAAc,GAAG,SAAS,CAAC;IAElE,gCAAgC;IAChC,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,8BAA8B;IAC9B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,gBAAgB;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB;IAChB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,qBAAqB,CAwS3F"}

package/dist/layout/useDiagramState.js

@@ -0,0 +1,256 @@
+/**
+ * useDiagramState Hook (CORAL-REQ-013)
+ *
+ * Manages diagram state with separated parse, render, and layout operations.
+ * Preserves node positions across DSL changes and supports undo/redo.
+ */
+import { useState, useCallback, useRef } from 'react';
+import { resolvePositions, incrementalLayout } from './positionStability.js';
+/**
+ * Default node dimensions
+ */
+const DEFAULT_NODE_WIDTH = 150;
+const DEFAULT_NODE_HEIGHT = 50;
+/**
+ * Hook for managing diagram state with position stability.
+ *
+ * Separates parse, render, and layout operations to prevent undo/redo
+ * positions from being overwritten by automatic layout.
+ */
+export function useDiagramState(options = {}) {
+    const { maxHistory = 50, direction = 'DOWN', spacing = 50 } = options;
+    // React Flow state
+    const [nodes, setNodes] = useState([]);
+    const [edges, setEdges] = useState([]);
+    const [isLoading, setIsLoading] = useState(false);
+    // Position source tracking
+    const positionSourcesRef = useRef(new Map());
+    // Previous graph for diffing
+    const previousGraphRef = useRef({ nodes: [], edges: [] });
+    // Current positions (for diffing and incremental layout)
+    const currentPositionsRef = useRef(new Map());
+    // Undo/redo history
+    const undoStackRef = useRef([]);
+    const redoStackRef = useRef([]);
+    // Track if we're in the middle of a drag
+    const isDraggingRef = useRef(false);
+    const dragStartPositionsRef = useRef(new Map());
+    // Get current positions from nodes
+    const getCurrentPositions = useCallback(() => {
+        const positions = new Map();
+        for (const node of nodes) {
+            positions.set(node.id, { ...node.position });
+        }
+        return positions;
+    }, [nodes]);
+    // Save snapshot to undo stack
+    const saveSnapshot = useCallback((positions) => {
+        undoStackRef.current.push({
+            positions: new Map(positions),
+            timestamp: Date.now(),
+        });
+        // Trim history if too long
+        if (undoStackRef.current.length > maxHistory) {
+            undoStackRef.current.shift();
+        }
+        // Clear redo stack on new action
+        redoStackRef.current = [];
+    }, [maxHistory]);
+    // Update nodes with new positions (without triggering layout)
+    const applyPositions = useCallback((positions) => {
+        setNodes((currentNodes) => currentNodes.map((node) => {
+            const pos = positions.get(node.id);
+            return pos ? { ...node, position: pos } : node;
+        }));
+        // Update current positions ref
+        for (const [id, pos] of positions) {
+            currentPositionsRef.current.set(id, pos);
+        }
+    }, []);
+    // Set graph from parsed DSL
+    const setGraph = useCallback(async (graph) => {
+        setIsLoading(true);
+        try {
+            const newDiffableGraph = {
+                nodes: graph.nodes.map((n) => ({
+                    id: n.id,
+                    type: n.type,
+                    label: n.label,
+                })),
+                edges: graph.edges.map((e) => ({
+                    id: e.id,
+                    source: e.source,
+                    target: e.target,
+                })),
+            };
+            // Resolve positions based on diff
+            const resolution = resolvePositions(previousGraphRef.current, newDiffableGraph, currentPositionsRef.current);
+            // If there are nodes that need layout, run incremental layout
+            let finalPositions;
+            if (resolution.needsLayout.length > 0) {
+                const nodeInfos = graph.nodes.map((n) => ({
+                    id: n.id,
+                    type: n.type,
+                    label: n.label,
+                    width: n.width || DEFAULT_NODE_WIDTH,
+                    height: n.height || DEFAULT_NODE_HEIGHT,
+                }));
+                finalPositions = await incrementalLayout(nodeInfos, graph.edges, resolution.positions, resolution.needsLayout, { direction, spacing });
+                // Mark new nodes as elk-computed
+                for (const id of resolution.needsLayout) {
+                    positionSourcesRef.current.set(id, 'elk-computed');
+                }
+            }
+            else {
+                finalPositions = resolution.positions;
+            }
+            // Build React Flow nodes
+            const newNodes = graph.nodes.map((n) => {
+                const pos = finalPositions.get(n.id) || { x: 0, y: 0 };
+                return {
+                    id: n.id,
+                    type: 'default',
+                    position: pos,
+                    data: {
+                        label: n.label,
+                        nodeType: n.type,
+                    },
+                };
+            });
+            // Build React Flow edges
+            const newEdges = graph.edges.map((e) => ({
+                id: e.id,
+                source: e.source,
+                target: e.target,
+                label: e.label,
+            }));
+            // Update state
+            setNodes(newNodes);
+            setEdges(newEdges);
+            // Update refs
+            previousGraphRef.current = newDiffableGraph;
+            currentPositionsRef.current = finalPositions;
+            // Clean up position sources for removed nodes
+            const currentNodeIds = new Set(graph.nodes.map((n) => n.id));
+            for (const id of positionSourcesRef.current.keys()) {
+                if (!currentNodeIds.has(id)) {
+                    positionSourcesRef.current.delete(id);
+                }
+            }
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [direction, spacing]);
+    // Handle node drag
+    const onNodeDrag = useCallback((nodeId, position) => {
+        // Save start positions on first drag event
+        if (!isDraggingRef.current) {
+            isDraggingRef.current = true;
+            dragStartPositionsRef.current = getCurrentPositions();
+        }
+        // Update position in state
+        setNodes((currentNodes) => currentNodes.map((node) => node.id === nodeId ? { ...node, position } : node));
+        // Update position source
+        positionSourcesRef.current.set(nodeId, 'user-dragged');
+        currentPositionsRef.current.set(nodeId, position);
+    }, [getCurrentPositions]);
+    // Handle drag end
+    const onDragEnd = useCallback(() => {
+        if (isDraggingRef.current) {
+            // Save snapshot of positions before drag for undo
+            saveSnapshot(dragStartPositionsRef.current);
+            isDraggingRef.current = false;
+            dragStartPositionsRef.current = new Map();
+        }
+    }, [saveSnapshot]);
+    // Run full ELK layout
+    const reflow = useCallback(async () => {
+        if (nodes.length === 0)
+            return;
+        setIsLoading(true);
+        try {
+            // Save current positions for undo
+            saveSnapshot(getCurrentPositions());
+            // Run full layout (all nodes need layout)
+            const nodeInfos = nodes.map((n) => ({
+                id: n.id,
+                type: n.data.nodeType,
+                label: n.data.label,
+                width: (n.measured?.width || n.width || DEFAULT_NODE_WIDTH),
+                height: (n.measured?.height || n.height || DEFAULT_NODE_HEIGHT),
+            }));
+            const edgeInfos = edges.map((e) => ({
+                id: e.id,
+                source: e.source,
+                target: e.target,
+            }));
+            const allNodeIds = nodes.map((n) => n.id);
+            const newPositions = await incrementalLayout(nodeInfos, edgeInfos, new Map(), // No pinned positions - full layout
+            allNodeIds, // All nodes need layout
+            { direction, spacing });
+            // Update nodes with new positions
+            applyPositions(newPositions);
+            // Mark all as elk-computed
+            for (const id of allNodeIds) {
+                positionSourcesRef.current.set(id, 'elk-computed');
+            }
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [nodes, edges, direction, spacing, saveSnapshot, getCurrentPositions, applyPositions]);
+    // Set node positions directly (e.g., from loaded document)
+    const setNodePositions = useCallback((positions, source) => {
+        applyPositions(positions);
+        for (const id of positions.keys()) {
+            positionSourcesRef.current.set(id, source);
+        }
+    }, [applyPositions]);
+    // Get position source
+    const getPositionSource = useCallback((nodeId) => {
+        return positionSourcesRef.current.get(nodeId);
+    }, []);
+    // Undo
+    const undo = useCallback(() => {
+        const entry = undoStackRef.current.pop();
+        if (!entry)
+            return;
+        // Save current positions to redo stack
+        redoStackRef.current.push({
+            positions: getCurrentPositions(),
+            timestamp: Date.now(),
+        });
+        // Apply undo positions (without triggering layout)
+        applyPositions(entry.positions);
+    }, [getCurrentPositions, applyPositions]);
+    // Redo
+    const redo = useCallback(() => {
+        const entry = redoStackRef.current.pop();
+        if (!entry)
+            return;
+        // Save current positions to undo stack
+        undoStackRef.current.push({
+            positions: getCurrentPositions(),
+            timestamp: Date.now(),
+        });
+        // Apply redo positions (without triggering layout)
+        applyPositions(entry.positions);
+    }, [getCurrentPositions, applyPositions]);
+    return {
+        nodes,
+        edges,
+        isLoading,
+        setGraph,
+        onNodeDrag,
+        onDragEnd,
+        reflow,
+        setNodePositions,
+        getPositionSource,
+        undo,
+        redo,
+        canUndo: undoStackRef.current.length > 0,
+        canRedo: redoStackRef.current.length > 0,
+    };
+}
+//# sourceMappingURL=useDiagramState.js.map

package/dist/layout/useDiagramState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDiagramState.js","sourceRoot":"","sources":["../../src/layout/useDiagramState.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAGtD,OAAO,EAAc,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAgDzF;;GAEG;AACH,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAC/B,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAiD/B;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkC,EAAE;IAClE,MAAM,EAAE,UAAU,GAAG,EAAE,EAAE,SAAS,GAAG,MAAM,EAAE,OAAO,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAEtE,mBAAmB;IACnB,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,EAAE,CAAC,CAAC;IACtD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAgB,EAAE,CAAC,CAAC;IACtD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAElD,2BAA2B;IAC3B,MAAM,kBAAkB,GAAG,MAAM,CAA8B,IAAI,GAAG,EAAE,CAAC,CAAC;IAE1E,6BAA6B;IAC7B,MAAM,gBAAgB,GAAG,MAAM,CAAgB,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;IAEzE,yDAAyD;IACzD,MAAM,mBAAmB,GAAG,MAAM,CAAwB,IAAI,GAAG,EAAE,CAAC,CAAC;IAErE,oBAAoB;IACpB,MAAM,YAAY,GAAG,MAAM,CAAyB,EAAE,CAAC,CAAC;IACxD,MAAM,YAAY,GAAG,MAAM,CAAyB,EAAE,CAAC,CAAC;IAExD,yCAAyC;IACzC,MAAM,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,qBAAqB,GAAG,MAAM,CAAwB,IAAI,GAAG,EAAE,CAAC,CAAC;IAEvE,mCAAmC;IACnC,MAAM,mBAAmB,GAAG,WAAW,CAAC,GAA0B,EAAE;QAClE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;QAC9C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;IAEZ,8BAA8B;IAC9B,MAAM,YAAY,GAAG,WAAW,CAAC,CAAC,SAAgC,EAAE,EAAE;QACpE,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC;YACxB,SAAS,EAAE,IAAI,GAAG,CAAC,SAAS,CAAC;YAC7B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;QAEH,2BAA2B;QAC3B,IAAI,YAAY,CAAC,OAAO,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;YAC7C,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC/B,CAAC;QAED,iCAAiC;QACjC,YAAY,CAAC,OAAO,GAAG,EAAE,CAAC;IAC5B,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAEjB,8DAA8D;IAC9D,MAAM,cAAc,GAAG,WAAW,CAAC,CAAC,SAAgC,EAAE,EAAE;QACtE,QAAQ,CAAC,CAAC,YAAY,EAAE,EAAE,CACxB,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACxB,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACnC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACjD,CAAC,CAAC,CACH,CAAC;QAEF,+BAA+B;QAC/B,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,SAAS,EAAE,CAAC;YAClC,mBAAmB,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,WAAW,CAAC,KAAK,EAAE,KAAkB,EAAE,EAAE;QACxD,YAAY,CAAC,IAAI,CAAC,CAAC;QAEnB,IAAI,CAAC;YACH,MAAM,gBAAgB,GAAkB;gBACtC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC7B,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,KAAK,EAAE,CAAC,CAAC,KAAK;iBACf,CAAC,CAAC;gBACH,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC7B,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,MAAM,EAAE,CAAC,CAAC,MAAM;oBAChB,MAAM,EAAE,CAAC,CAAC,MAAM;iBACjB,CAAC,CAAC;aACJ,CAAC;YAEF,kCAAkC;YAClC,MAAM,UAAU,GAAG,gBAAgB,CACjC,gBAAgB,CAAC,OAAO,EACxB,gBAAgB,EAChB,mBAAmB,CAAC,OAAO,CAC5B,CAAC;YAEF,8DAA8D;YAC9D,IAAI,cAAqC,CAAC;YAE1C,IAAI,UAAU,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtC,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBACxC,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,kBAAkB;oBACpC,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,mBAAmB;iBACxC,CAAC,CAAC,CAAC;gBAEJ,cAAc,GAAG,MAAM,iBAAiB,CACtC,SAAS,EACT,KAAK,CAAC,KAAK,EACX,UAAU,CAAC,SAAS,EACpB,UAAU,CAAC,WAAW,EACtB,EAAE,SAAS,EAAE,OAAO,EAAE,CACvB,CAAC;gBAEF,iCAAiC;gBACjC,KAAK,MAAM,EAAE,IAAI,UAAU,CAAC,WAAW,EAAE,CAAC;oBACxC,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;gBACrD,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,cAAc,GAAG,UAAU,CAAC,SAAS,CAAC;YACxC,CAAC;YAED,yBAAyB;YACzB,MAAM,QAAQ,GAAkB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACpD,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;gBACvD,OAAO;oBACL,EAAE,EAAE,CAAC,CAAC,EAAE;oBACR,IAAI,EAAE,SAAS;oBACf,QAAQ,EAAE,GAAG;oBACb,IAAI,EAAE;wBACJ,KAAK,EAAE,CAAC,CAAC,KAAK;wBACd,QAAQ,EAAE,CAAC,CAAC,IAAI;qBACjB;iBACF,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,yBAAyB;YACzB,MAAM,QAAQ,GAAkB,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACtD,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,KAAK,EAAE,CAAC,CAAC,KAAK;aACf,CAAC,CAAC,CAAC;YAEJ,eAAe;YACf,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACnB,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAEnB,cAAc;YACd,gBAAgB,CAAC,OAAO,GAAG,gBAAgB,CAAC;YAC5C,mBAAmB,CAAC,OAAO,GAAG,cAAc,CAAC;YAE7C,8CAA8C;YAC9C,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC7D,KAAK,MAAM,EAAE,IAAI,kBAAkB,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;gBACnD,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;oBAC5B,kBAAkB,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;IAEzB,mBAAmB;IACnB,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,MAAc,EAAE,QAAkB,EAAE,EAAE;QACpE,2CAA2C;QAC3C,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;YAC3B,aAAa,CAAC,OAAO,GAAG,IAAI,CAAC;YAC7B,qBAAqB,CAAC,OAAO,GAAG,mBAAmB,EAAE,CAAC;QACxD,CAAC;QAED,2BAA2B;QAC3B,QAAQ,CAAC,CAAC,YAAY,EAAE,EAAE,CACxB,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACxB,IAAI,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAClD,CACF,CAAC;QAEF,yBAAyB;QACzB,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QACvD,mBAAmB,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACpD,CAAC,EAAE,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAE1B,kBAAkB;IAClB,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE;QACjC,IAAI,aAAa,CAAC,OAAO,EAAE,CAAC;YAC1B,kDAAkD;YAClD,YAAY,CAAC,qBAAqB,CAAC,OAAO,CAAC,CAAC;YAC5C,aAAa,CAAC,OAAO,GAAG,KAAK,CAAC;YAC9B,qBAAqB,CAAC,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;QAC5C,CAAC;IACH,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IAEnB,sBAAsB;IACtB,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACpC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAE/B,YAAY,CAAC,IAAI,CAAC,CAAC;QAEnB,IAAI,CAAC;YACH,kCAAkC;YAClC,YAAY,CAAC,mBAAmB,EAAE,CAAC,CAAC;YAEpC,0CAA0C;YAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAClC,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ;gBACrB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK;gBACnB,KAAK,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,IAAI,CAAC,CAAC,KAAK,IAAI,kBAAkB,CAAW;gBACrE,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC,MAAM,IAAI,mBAAmB,CAAW;aAC1E,CAAC,CAAC,CAAC;YAEJ,MAAM,SAAS,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAClC,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,MAAM,EAAE,CAAC,CAAC,MAAM;aACjB,CAAC,CAAC,CAAC;YAEJ,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAE1C,MAAM,YAAY,GAAG,MAAM,iBAAiB,CAC1C,SAAS,EACT,SAAS,EACT,IAAI,GAAG,EAAE,EAAE,oCAAoC;YAC/C,UAAU,EAAE,wBAAwB;YACpC,EAAE,SAAS,EAAE,OAAO,EAAE,CACvB,CAAC;YAEF,kCAAkC;YAClC,cAAc,CAAC,YAAY,CAAC,CAAC;YAE7B,2BAA2B;YAC3B,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;gBAC5B,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;YACrD,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,cAAc,CAAC,CAAC,CAAC;IAE1F,2DAA2D;IAC3D,MAAM,gBAAgB,GAAG,WAAW,CAAC,CAAC,SAAgC,EAAE,MAAsB,EAAE,EAAE;QAChG,cAAc,CAAC,SAAS,CAAC,CAAC;QAE1B,KAAK,MAAM,EAAE,IAAI,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC;YAClC,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC;IAErB,sBAAsB;IACtB,MAAM,iBAAiB,GAAG,WAAW,CAAC,CAAC,MAAc,EAA8B,EAAE;QACnF,OAAO,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;IACP,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QACzC,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,uCAAuC;QACvC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC;YACxB,SAAS,EAAE,mBAAmB,EAAE;YAChC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;QAEH,mDAAmD;QACnD,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC,EAAE,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAC,CAAC;IAE1C,OAAO;IACP,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5B,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QACzC,IAAI,CAAC,KAAK;YAAE,OAAO;QAEnB,uCAAuC;QACvC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC;YACxB,SAAS,EAAE,mBAAmB,EAAE;YAChC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;QAEH,mDAAmD;QACnD,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC,EAAE,CAAC,mBAAmB,EAAE,cAAc,CAAC,CAAC,CAAC;IAE1C,OAAO;QACL,KAAK;QACL,KAAK;QACL,SAAS;QACT,QAAQ;QACR,UAAU;QACV,SAAS;QACT,MAAM;QACN,gBAAgB;QAChB,iBAAiB;QACjB,IAAI;QACJ,IAAI;QACJ,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QACxC,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;KACzC,CAAC;AACJ,CAAC"}

package/dist/layout/useLayoutHistory.d.ts

@@ -0,0 +1,53 @@
+/**
+ * useLayoutHistory - Hook for managing undo/redo stack for node positions
+ *
+ * This hook tracks node position changes and allows users to undo/redo
+ * layout operations, particularly useful after automatic reflow.
+ */
+import type { Node, XYPosition } from '@xyflow/react';
+import type { EdgeWaypoint } from '../waypoints/types.js';
+/** Snapshot of node positions (and optional waypoints) at a point in time */
+export interface PositionSnapshot {
+    /** Map of node ID to position */
+    positions: Map<string, XYPosition>;
+    /** Timestamp when snapshot was taken */
+    timestamp: number;
+    /** Description of what caused this snapshot (e.g., 'reflow', 'manual') */
+    source: string;
+    /** Optional waypoint state (CORAL-REQ-015) */
+    waypoints?: Map<string, EdgeWaypoint[]>;
+}
+/** Result returned from undo/redo operations */
+export interface UndoRedoResult {
+    positions: Map<string, XYPosition>;
+    waypoints?: Map<string, EdgeWaypoint[]>;
+}
+/** Options for the useLayoutHistory hook */
+export interface UseLayoutHistoryOptions {
+    /** Maximum number of history entries to keep (default: 50) */
+    maxHistory?: number;
+}
+/** Return type of the useLayoutHistory hook */
+export interface UseLayoutHistoryResult {
+    /** Save current node positions (and optional waypoints) to history */
+    saveSnapshot: (nodes: Node[], source?: string, waypoints?: Map<string, EdgeWaypoint[]>) => void;
+    /** Undo to previous position state, returns positions + waypoints or null if can't undo */
+    undo: () => UndoRedoResult | null;
+    /** Redo to next position state, returns positions + waypoints or null if can't redo */
+    redo: () => UndoRedoResult | null;
+    /** Whether undo is available */
+    canUndo: boolean;
+    /** Whether redo is available */
+    canRedo: boolean;
+    /** Number of available undo steps */
+    undoCount: number;
+    /** Number of available redo steps */
+    redoCount: number;
+    /** Clear all history */
+    clearHistory: () => void;
+}
+/**
+ * Hook for managing layout history with undo/redo capability
+ */
+export declare function useLayoutHistory(options?: UseLayoutHistoryOptions): UseLayoutHistoryResult;
+//# sourceMappingURL=useLayoutHistory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useLayoutHistory.d.ts","sourceRoot":"","sources":["../../src/layout/useLayoutHistory.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,6EAA6E;AAC7E,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;CACzC;AAED,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;CACzC;AAED,4CAA4C;AAC5C,MAAM,WAAW,uBAAuB;IACtC,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,+CAA+C;AAC/C,MAAM,WAAW,sBAAsB;IACrC,sEAAsE;IACtE,YAAY,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,KAAK,IAAI,CAAC;IAChG,2FAA2F;IAC3F,IAAI,EAAE,MAAM,cAAc,GAAG,IAAI,CAAC;IAClC,uFAAuF;IACvF,IAAI,EAAE,MAAM,cAAc,GAAG,IAAI,CAAC;IAClC,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,GAAE,uBAA4B,GACpC,sBAAsB,CA4IxB"}

package/dist/layout/useLayoutHistory.js

@@ -0,0 +1,124 @@
+/**
+ * useLayoutHistory - Hook for managing undo/redo stack for node positions
+ *
+ * This hook tracks node position changes and allows users to undo/redo
+ * layout operations, particularly useful after automatic reflow.
+ */
+import { useState, useCallback, useRef } from 'react';
+/**
+ * Hook for managing layout history with undo/redo capability
+ */
+export function useLayoutHistory(options = {}) {
+    const { maxHistory = 50 } = options;
+    // History stack - array of position snapshots
+    const [history, setHistory] = useState([]);
+    // Current position in history (-1 means at most recent)
+    const [historyIndex, setHistoryIndex] = useState(-1);
+    // Track if we're in the middle of an undo/redo to avoid saving
+    const isUndoingRef = useRef(false);
+    /**
+     * Save current node positions to history
+     */
+    const saveSnapshot = useCallback((nodes, source = 'manual', waypoints) => {
+        // Don't save during undo/redo operations
+        if (isUndoingRef.current)
+            return;
+        const positions = new Map();
+        for (const node of nodes) {
+            positions.set(node.id, { ...node.position });
+        }
+        const snapshot = {
+            positions,
+            timestamp: Date.now(),
+            source,
+            waypoints: waypoints ? new Map(waypoints) : undefined,
+        };
+        setHistory((prev) => {
+            // If we're not at the end of history, truncate future entries
+            let newHistory = historyIndex >= 0 ? prev.slice(0, historyIndex + 1) : prev;
+            // Add new snapshot
+            newHistory = [...newHistory, snapshot];
+            // Trim to max history
+            if (newHistory.length > maxHistory) {
+                newHistory = newHistory.slice(newHistory.length - maxHistory);
+            }
+            return newHistory;
+        });
+        // Reset history index to point to end
+        setHistoryIndex(-1);
+    }, [historyIndex, maxHistory]);
+    /**
+     * Undo to previous position state
+     */
+    const undo = useCallback(() => {
+        // Calculate actual index (handle -1 as end of array)
+        const currentIndex = historyIndex === -1 ? history.length - 1 : historyIndex;
+        // Need at least 2 entries to undo (current + previous)
+        if (currentIndex <= 0) {
+            return null;
+        }
+        const targetIndex = currentIndex - 1;
+        const snapshot = history[targetIndex];
+        if (!snapshot) {
+            return null;
+        }
+        isUndoingRef.current = true;
+        setHistoryIndex(targetIndex);
+        // Allow next saveSnapshot to work
+        setTimeout(() => {
+            isUndoingRef.current = false;
+        }, 0);
+        return {
+            positions: snapshot.positions,
+            waypoints: snapshot.waypoints,
+        };
+    }, [history, historyIndex]);
+    /**
+     * Redo to next position state
+     */
+    const redo = useCallback(() => {
+        // Can only redo if we've undone something
+        if (historyIndex === -1 || historyIndex >= history.length - 1) {
+            return null;
+        }
+        const targetIndex = historyIndex + 1;
+        const snapshot = history[targetIndex];
+        if (!snapshot) {
+            return null;
+        }
+        isUndoingRef.current = true;
+        setHistoryIndex(targetIndex);
+        // Allow next saveSnapshot to work
+        setTimeout(() => {
+            isUndoingRef.current = false;
+        }, 0);
+        return {
+            positions: snapshot.positions,
+            waypoints: snapshot.waypoints,
+        };
+    }, [history, historyIndex]);
+    /**
+     * Clear all history
+     */
+    const clearHistory = useCallback(() => {
+        setHistory([]);
+        setHistoryIndex(-1);
+    }, []);
+    // Calculate derived state
+    const currentIndex = historyIndex === -1 ? history.length - 1 : historyIndex;
+    const canUndo = currentIndex > 0;
+    const canRedo = historyIndex !== -1 && historyIndex < history.length - 1;
+    const undoCount = currentIndex;
+    const redoCount = historyIndex === -1 ? 0 : history.length - 1 - historyIndex;
+    return {
+        saveSnapshot,
+        undo,
+        canUndo,
+        redo,
+        canRedo,
+        undoCount,
+        redoCount,
+        clearHistory,
+    };
+}
+//# sourceMappingURL=useLayoutHistory.js.map