@coral-viz/viz 0.2.3

package/dist/layout/nodeSizing.js

@@ -0,0 +1,319 @@
+/**
+ * Node Sizing Utilities (CORAL-REQ-011)
+ *
+ * Provides text measurement and adaptive node sizing based on:
+ * - Text content dimensions
+ * - Shape geometry constraints (textBoundsRatio)
+ * - Minimum size requirements
+ * - Padding specifications
+ */
+import { shapeRegistry } from '@coral-viz/render';
+/**
+ * Default sizing for shapes without explicit sizing metadata
+ */
+const DEFAULT_SIZING = {
+    textBoundsRatio: { x: 1.0, y: 1.0 },
+    minSize: { width: 60, height: 30 },
+    padding: { x: 16, y: 12 },
+};
+/**
+ * Default font settings
+ */
+const DEFAULT_FONT = {
+    fontSize: 12,
+    fontFamily: 'system-ui, -apple-system, sans-serif',
+    fontWeight: 500,
+    lineHeight: 1.4,
+};
+/**
+ * Canvas context for text measurement (cached for performance)
+ */
+let measureContext = null;
+/**
+ * Get or create a canvas context for text measurement
+ */
+function getMeasureContext() {
+    if (measureContext) {
+        return measureContext;
+    }
+    // Check if we're in a browser environment
+    if (typeof document === 'undefined') {
+        return null;
+    }
+    const canvas = document.createElement('canvas');
+    measureContext = canvas.getContext('2d');
+    return measureContext;
+}
+/**
+ * Measure text dimensions using canvas
+ *
+ * Uses the Canvas API's measureText() for accurate text width measurement,
+ * with word wrapping support when maxWidth is specified.
+ */
+export function measureText(options) {
+    const { text, fontSize = DEFAULT_FONT.fontSize, fontFamily = DEFAULT_FONT.fontFamily, fontWeight = DEFAULT_FONT.fontWeight, maxWidth, lineHeight = DEFAULT_FONT.lineHeight, } = options;
+    const ctx = getMeasureContext();
+    // Fallback for non-browser environments (SSR, tests)
+    if (!ctx) {
+        return measureTextFallback(options);
+    }
+    // Set font for measurement
+    ctx.font = `${fontWeight} ${fontSize}px ${fontFamily}`;
+    // If no max width, measure as single line
+    if (!maxWidth) {
+        const metrics = ctx.measureText(text);
+        return {
+            width: Math.ceil(metrics.width),
+            height: Math.ceil(fontSize * lineHeight),
+            lines: [text],
+        };
+    }
+    // Word wrap to fit maxWidth
+    const lines = wrapText(ctx, text, maxWidth);
+    const lineHeightPx = fontSize * lineHeight;
+    // Find the widest line
+    let maxLineWidth = 0;
+    for (const line of lines) {
+        const metrics = ctx.measureText(line);
+        maxLineWidth = Math.max(maxLineWidth, metrics.width);
+    }
+    return {
+        width: Math.ceil(maxLineWidth),
+        height: Math.ceil(lines.length * lineHeightPx),
+        lines,
+    };
+}
+/**
+ * Wrap text to fit within maxWidth
+ */
+function wrapText(ctx, text, maxWidth) {
+    // Handle empty text
+    if (!text || text.trim() === '') {
+        return [''];
+    }
+    // Split by explicit line breaks first
+    const paragraphs = text.split('\n');
+    const lines = [];
+    for (const paragraph of paragraphs) {
+        const words = paragraph.split(/\s+/).filter((w) => w.length > 0);
+        if (words.length === 0) {
+            lines.push('');
+            continue;
+        }
+        let currentLine = words[0];
+        for (let i = 1; i < words.length; i++) {
+            const word = words[i];
+            const testLine = currentLine + ' ' + word;
+            const metrics = ctx.measureText(testLine);
+            if (metrics.width <= maxWidth) {
+                currentLine = testLine;
+            }
+            else {
+                lines.push(currentLine);
+                currentLine = word;
+            }
+        }
+        lines.push(currentLine);
+    }
+    return lines;
+}
+/**
+ * Fallback text measurement for non-browser environments
+ * Uses character-based approximation
+ */
+function measureTextFallback(options) {
+    const { text, fontSize = DEFAULT_FONT.fontSize, lineHeight = DEFAULT_FONT.lineHeight, maxWidth, } = options;
+    // Approximate character width (varies by font, but 0.6 is reasonable for sans-serif)
+    const avgCharWidth = fontSize * 0.6;
+    const lineHeightPx = fontSize * lineHeight;
+    // Always split by newlines first
+    const paragraphs = text.split('\n');
+    if (!maxWidth) {
+        // No wrapping, just return paragraphs as lines
+        const maxLineWidth = Math.max(0, ...paragraphs.map((p) => p.length * avgCharWidth));
+        return {
+            width: Math.ceil(maxLineWidth),
+            height: Math.ceil(paragraphs.length * lineHeightPx),
+            lines: paragraphs,
+        };
+    }
+    // Approximate word wrapping
+    const charsPerLine = Math.floor(maxWidth / avgCharWidth);
+    const lines = [];
+    for (const paragraph of paragraphs) {
+        if (paragraph.length === 0) {
+            lines.push('');
+        }
+        else if (paragraph.length <= charsPerLine) {
+            lines.push(paragraph);
+        }
+        else {
+            // Simple word-aware wrapping
+            const words = paragraph.split(/\s+/);
+            let currentLine = '';
+            for (const word of words) {
+                if ((currentLine + ' ' + word).length <= charsPerLine) {
+                    currentLine = currentLine ? currentLine + ' ' + word : word;
+                }
+                else {
+                    if (currentLine)
+                        lines.push(currentLine);
+                    currentLine = word;
+                }
+            }
+            if (currentLine)
+                lines.push(currentLine);
+        }
+    }
+    const maxLineWidth = Math.max(0, ...lines.map((l) => l.length * avgCharWidth));
+    return {
+        width: Math.ceil(maxLineWidth),
+        height: Math.ceil(lines.length * lineHeightPx),
+        lines,
+    };
+}
+/**
+ * Compute optimal node size based on text content and shape geometry
+ *
+ * The sizing algorithm:
+ * 1. Measure text dimensions
+ * 2. Apply shape's textBoundsRatio to account for geometry (e.g., diamond needs more space)
+ * 3. Add padding for visual breathing room
+ * 4. Enforce minimum size constraints
+ * 5. Optionally apply uniform sizing across nodes of the same shape
+ */
+export function computeNodeSize(options) {
+    const { text, shapeId, sizingMode, fontSize = DEFAULT_FONT.fontSize, fontFamily = DEFAULT_FONT.fontFamily, fontWeight = DEFAULT_FONT.fontWeight, minWidth, minHeight, uniformSizes, } = options;
+    // Get shape definition and sizing metadata
+    const shape = shapeRegistry.get(shapeId);
+    const sizing = shape?.sizing || DEFAULT_SIZING;
+    const defaultSize = shape?.defaultSize || { width: 100, height: 60 };
+    // For uniform mode, use cached sizes if available
+    if (sizingMode === 'uniform' && uniformSizes?.has(shapeId)) {
+        const uniformSize = uniformSizes.get(shapeId);
+        return {
+            width: uniformSize.width,
+            height: uniformSize.height,
+            textBox: computeTextBox(uniformSize.width, uniformSize.height, sizing),
+        };
+    }
+    // Measure text with initial max width estimate
+    const initialMaxWidth = defaultSize.width - sizing.padding.x * 2;
+    const textDims = measureText({
+        text: text || '',
+        fontSize,
+        fontFamily,
+        fontWeight,
+        maxWidth: initialMaxWidth > 0 ? initialMaxWidth : undefined,
+    });
+    // Apply textBoundsRatio to account for shape geometry
+    // For a diamond, text occupies ~70% of the bounding box, so ratio is 1.45
+    const contentWidth = textDims.width * sizing.textBoundsRatio.x + sizing.padding.x * 2;
+    const contentHeight = textDims.height * sizing.textBoundsRatio.y + sizing.padding.y * 2;
+    // Determine final size based on sizing mode
+    let width;
+    let height;
+    switch (sizingMode) {
+        case 'adaptive':
+            // Size adapts to content
+            width = Math.max(contentWidth, sizing.minSize.width, minWidth || 0);
+            height = Math.max(contentHeight, sizing.minSize.height, minHeight || 0);
+            break;
+        case 'uniform':
+            // All nodes of this shape use the same size (largest needed)
+            // This will be populated on a second pass
+            width = Math.max(contentWidth, sizing.minSize.width, minWidth || 0);
+            height = Math.max(contentHeight, sizing.minSize.height, minHeight || 0);
+            break;
+        case 'hybrid':
+        default:
+            // Blend: adaptive width, uniform height per shape type
+            width = Math.max(contentWidth, sizing.minSize.width, minWidth || 0);
+            height = Math.max(sizing.minSize.height, defaultSize.height, minHeight || 0);
+            break;
+    }
+    // Round to reasonable values
+    width = Math.ceil(width);
+    height = Math.ceil(height);
+    return {
+        width,
+        height,
+        textBox: computeTextBox(width, height, sizing),
+    };
+}
+/**
+ * Compute the text bounding box within a node
+ * This is where text can be safely rendered without clipping
+ */
+function computeTextBox(width, height, sizing) {
+    // Text box is centered within the shape, reduced by the textBoundsRatio
+    const textWidth = (width - sizing.padding.x * 2) / sizing.textBoundsRatio.x;
+    const textHeight = (height - sizing.padding.y * 2) / sizing.textBoundsRatio.y;
+    return {
+        x: (width - textWidth) / 2,
+        y: (height - textHeight) / 2,
+        width: textWidth,
+        height: textHeight,
+    };
+}
+/**
+ * Compute uniform sizes for all shapes in a diagram
+ *
+ * For uniform sizing mode, we need to find the maximum required size
+ * for each shape type, then apply that to all nodes of that type.
+ */
+export function computeUniformSizes(nodes, options) {
+    const uniformSizes = new Map();
+    // First pass: compute adaptive sizes for all nodes
+    const sizesByShape = new Map();
+    for (const node of nodes) {
+        const dims = computeNodeSize({
+            text: node.text,
+            shapeId: node.shapeId,
+            sizingMode: 'adaptive',
+            ...options,
+        });
+        if (!sizesByShape.has(node.shapeId)) {
+            sizesByShape.set(node.shapeId, []);
+        }
+        sizesByShape.get(node.shapeId).push({ width: dims.width, height: dims.height });
+    }
+    // Second pass: find max size for each shape
+    for (const [shapeId, sizes] of sizesByShape) {
+        const maxWidth = Math.max(...sizes.map((s) => s.width));
+        const maxHeight = Math.max(...sizes.map((s) => s.height));
+        uniformSizes.set(shapeId, { width: maxWidth, height: maxHeight });
+    }
+    return uniformSizes;
+}
+/**
+ * Apply adaptive sizing to a set of nodes
+ *
+ * This is the main entry point for layout integration.
+ * Returns nodes with updated width/height properties.
+ */
+export function applyAdaptiveSizing(nodes, options) {
+    const { sizingMode, getShapeId, fontSize, fontFamily, fontWeight } = options;
+    // For uniform mode, pre-compute sizes
+    let uniformSizes;
+    if (sizingMode === 'uniform') {
+        uniformSizes = computeUniformSizes(nodes.map((n) => ({ text: n.data.label || '', shapeId: getShapeId(n) })), { fontSize, fontFamily, fontWeight });
+    }
+    return nodes.map((node) => {
+        const dims = computeNodeSize({
+            text: node.data.label || '',
+            shapeId: getShapeId(node),
+            sizingMode,
+            fontSize,
+            fontFamily,
+            fontWeight,
+            uniformSizes,
+        });
+        return {
+            ...node,
+            width: dims.width,
+            height: dims.height,
+        };
+    });
+}
+//# sourceMappingURL=nodeSizing.js.map

package/dist/layout/nodeSizing.js.map

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

package/dist/layout/positionStability.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Position Stability Module (CORAL-REQ-013)
+ *
+ * Provides utilities for maintaining node positions across DSL changes.
+ * Separates parse, render, and layout operations to prevent undo/redo
+ * positions from being overwritten by automatic layout.
+ */
+import type { DiffableGraph, GraphDiff, Position, PositionResolution } from '../types.js';
+/**
+ * Compare two graphs and identify added, removed, modified, and unchanged nodes.
+ *
+ * A node is considered "modified" if its type or label has changed.
+ * Edge changes are not considered for node modification status.
+ *
+ * @param oldGraph - The previous graph state
+ * @param newGraph - The new graph state
+ * @returns GraphDiff with categorized node IDs
+ */
+export declare function diffGraphs(oldGraph: DiffableGraph, newGraph: DiffableGraph): GraphDiff;
+/**
+ * Resolve positions for nodes in the new graph based on the diff and current positions.
+ *
+ * - Unchanged and modified nodes keep their current positions
+ * - Added nodes are marked as needing layout (placed at 0,0 temporarily)
+ * - Removed nodes are not included in the result
+ *
+ * @param oldGraph - The previous graph state
+ * @param newGraph - The new graph state
+ * @param currentPositions - Map of node IDs to their current positions
+ * @returns PositionResolution with resolved positions and nodes needing layout
+ */
+export declare function resolvePositions(oldGraph: DiffableGraph, newGraph: DiffableGraph, currentPositions: Map<string, Position>): PositionResolution;
+/**
+ * Node info for incremental layout
+ */
+interface LayoutNodeInfo {
+    id: string;
+    type: string;
+    label: string;
+    width: number;
+    height: number;
+}
+/**
+ * Edge info for incremental layout
+ */
+interface LayoutEdgeInfo {
+    id: string;
+    source: string;
+    target: string;
+}
+/**
+ * Perform incremental layout with pinned positions for existing nodes.
+ *
+ * Strategy: Run ELK on all nodes but restore pinned positions afterwards.
+ * This ensures edge routing works correctly while preserving user positions.
+ *
+ * If all nodes need layout (no pins), this performs a full ELK layout.
+ * If no nodes need layout (all pinned), this returns the pinned positions unchanged.
+ *
+ * @param nodes - All nodes to layout (with dimensions)
+ * @param edges - All edges in the graph
+ * @param pinnedPositions - Positions to preserve (node IDs to positions)
+ * @param needsLayout - Node IDs that need ELK positioning
+ * @param options - Optional layout options (direction, algorithm, etc.)
+ * @returns Map of node IDs to computed positions
+ */
+export declare function incrementalLayout(nodes: LayoutNodeInfo[], edges: LayoutEdgeInfo[], pinnedPositions: Map<string, Position>, needsLayout: string[], options?: {
+    direction?: 'DOWN' | 'UP' | 'LEFT' | 'RIGHT';
+    algorithm?: string;
+    spacing?: number;
+}): Promise<Map<string, Position>>;
+export {};
+//# sourceMappingURL=positionStability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"positionStability.d.ts","sourceRoot":"","sources":["../../src/layout/positionStability.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAgB,SAAS,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAIxG;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,GAAG,SAAS,CAuCtF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,aAAa,EACvB,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,GACtC,kBAAkB,CA0BpB;AAED;;GAEG;AACH,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,cAAc,EAAE,EACvB,KAAK,EAAE,cAAc,EAAE,EACvB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,EACtC,WAAW,EAAE,MAAM,EAAE,EACrB,OAAO,CAAC,EAAE;IACR,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GACA,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAoGhC"}

package/dist/layout/positionStability.js

@@ -0,0 +1,199 @@
+/**
+ * Position Stability Module (CORAL-REQ-013)
+ *
+ * Provides utilities for maintaining node positions across DSL changes.
+ * Separates parse, render, and layout operations to prevent undo/redo
+ * positions from being overwritten by automatic layout.
+ */
+import ELK from 'elkjs/lib/elk.bundled.js';
+const elk = new ELK();
+/**
+ * Compare two graphs and identify added, removed, modified, and unchanged nodes.
+ *
+ * A node is considered "modified" if its type or label has changed.
+ * Edge changes are not considered for node modification status.
+ *
+ * @param oldGraph - The previous graph state
+ * @param newGraph - The new graph state
+ * @returns GraphDiff with categorized node IDs
+ */
+export function diffGraphs(oldGraph, newGraph) {
+    const oldNodeMap = new Map();
+    for (const node of oldGraph.nodes) {
+        oldNodeMap.set(node.id, node);
+    }
+    const newNodeMap = new Map();
+    for (const node of newGraph.nodes) {
+        newNodeMap.set(node.id, node);
+    }
+    const added = [];
+    const removed = [];
+    const modified = [];
+    const unchanged = [];
+    // Check nodes in new graph
+    for (const node of newGraph.nodes) {
+        const oldNode = oldNodeMap.get(node.id);
+        if (!oldNode) {
+            // Node doesn't exist in old graph - it's new
+            added.push(node.id);
+        }
+        else if (oldNode.type !== node.type || oldNode.label !== node.label) {
+            // Node exists but has changed type or label
+            modified.push(node.id);
+        }
+        else {
+            // Node is unchanged
+            unchanged.push(node.id);
+        }
+    }
+    // Check for nodes removed from old graph
+    for (const node of oldGraph.nodes) {
+        if (!newNodeMap.has(node.id)) {
+            removed.push(node.id);
+        }
+    }
+    return { added, removed, modified, unchanged };
+}
+/**
+ * Resolve positions for nodes in the new graph based on the diff and current positions.
+ *
+ * - Unchanged and modified nodes keep their current positions
+ * - Added nodes are marked as needing layout (placed at 0,0 temporarily)
+ * - Removed nodes are not included in the result
+ *
+ * @param oldGraph - The previous graph state
+ * @param newGraph - The new graph state
+ * @param currentPositions - Map of node IDs to their current positions
+ * @returns PositionResolution with resolved positions and nodes needing layout
+ */
+export function resolvePositions(oldGraph, newGraph, currentPositions) {
+    const diff = diffGraphs(oldGraph, newGraph);
+    const positions = new Map();
+    const needsLayout = [];
+    // Process unchanged and modified nodes - keep their positions
+    for (const id of [...diff.unchanged, ...diff.modified]) {
+        const pos = currentPositions.get(id);
+        if (pos) {
+            positions.set(id, pos);
+        }
+        else {
+            // Node exists in both graphs but has no position - needs layout
+            needsLayout.push(id);
+            positions.set(id, { x: 0, y: 0 });
+        }
+    }
+    // Process added nodes - need layout
+    for (const id of diff.added) {
+        needsLayout.push(id);
+        positions.set(id, { x: 0, y: 0 }); // Placeholder position
+    }
+    // Removed nodes are not included in the result
+    return { positions, needsLayout };
+}
+/**
+ * Perform incremental layout with pinned positions for existing nodes.
+ *
+ * Strategy: Run ELK on all nodes but restore pinned positions afterwards.
+ * This ensures edge routing works correctly while preserving user positions.
+ *
+ * If all nodes need layout (no pins), this performs a full ELK layout.
+ * If no nodes need layout (all pinned), this returns the pinned positions unchanged.
+ *
+ * @param nodes - All nodes to layout (with dimensions)
+ * @param edges - All edges in the graph
+ * @param pinnedPositions - Positions to preserve (node IDs to positions)
+ * @param needsLayout - Node IDs that need ELK positioning
+ * @param options - Optional layout options (direction, algorithm, etc.)
+ * @returns Map of node IDs to computed positions
+ */
+export async function incrementalLayout(nodes, edges, pinnedPositions, needsLayout, options) {
+    // Handle empty case
+    if (nodes.length === 0) {
+        return new Map();
+    }
+    // If no nodes need layout, return pinned positions directly
+    if (needsLayout.length === 0) {
+        const result = new Map();
+        for (const node of nodes) {
+            const pos = pinnedPositions.get(node.id);
+            if (pos) {
+                result.set(node.id, pos);
+            }
+        }
+        return result;
+    }
+    const needsLayoutSet = new Set(needsLayout);
+    // Strategy: Run ELK on only the nodes that need layout, plus any nodes
+    // they connect to. Then merge results with pinned positions.
+    // For simplicity, we'll run ELK on all nodes but restore pinned positions after
+    const elkChildren = nodes.map((node) => {
+        const elkNode = {
+            id: node.id,
+            width: node.width,
+            height: node.height,
+        };
+        // Set initial position for ELK (helps with layout stability)
+        const pinnedPos = pinnedPositions.get(node.id);
+        if (pinnedPos) {
+            elkNode.x = pinnedPos.x;
+            elkNode.y = pinnedPos.y;
+        }
+        return elkNode;
+    });
+    const elkEdges = edges.map((edge) => ({
+        id: edge.id,
+        sources: [edge.source],
+        targets: [edge.target],
+    }));
+    const elkGraph = {
+        id: 'root',
+        layoutOptions: {
+            'elk.algorithm': options?.algorithm || 'layered',
+            'elk.direction': options?.direction || 'DOWN',
+            'elk.spacing.nodeNode': String(options?.spacing || 50),
+            'elk.layered.spacing.nodeNodeBetweenLayers': '70',
+        },
+        children: elkChildren,
+        edges: elkEdges,
+    };
+    try {
+        const layoutedGraph = await elk.layout(elkGraph);
+        // Collect positions from layout result, but restore pinned positions
+        const result = new Map();
+        for (const elkNode of layoutedGraph.children || []) {
+            // For pinned nodes, use the original position
+            const pinnedPos = pinnedPositions.get(elkNode.id);
+            if (pinnedPos && !needsLayoutSet.has(elkNode.id)) {
+                result.set(elkNode.id, pinnedPos);
+            }
+            else {
+                // Use ELK-computed position for new nodes
+                result.set(elkNode.id, { x: elkNode.x || 0, y: elkNode.y || 0 });
+            }
+        }
+        return result;
+    }
+    catch (error) {
+        console.error('Incremental layout failed:', error);
+        // Fallback: return pinned positions and place new nodes nearby
+        const result = new Map();
+        let fallbackY = 0;
+        // Find the max Y of pinned positions to place new nodes below
+        for (const pos of pinnedPositions.values()) {
+            fallbackY = Math.max(fallbackY, pos.y + 100);
+        }
+        for (const node of nodes) {
+            const pinnedPos = pinnedPositions.get(node.id);
+            if (pinnedPos && !needsLayoutSet.has(node.id)) {
+                result.set(node.id, pinnedPos);
+            }
+            else {
+                // Place new nodes below existing ones
+                result.set(node.id, { x: 100, y: fallbackY });
+                fallbackY += node.height + 50;
+            }
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=positionStability.js.map

package/dist/layout/positionStability.js.map

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

package/dist/layout/useAxisConstrain.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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 type { NodeChange, NodeBase } from '@xyflow/system';
+export interface UseAxisConstrainResult<NodeType extends NodeBase = NodeBase> {
+    /** Wrapped onNodesChange that applies axis constraints when Shift is held */
+    onNodesChange: (changes: NodeChange<NodeType>[]) => void;
+}
+/**
+ * Wraps onNodesChange to add Shift+drag axis constraint.
+ *
+ * @param originalOnNodesChange - The onNodesChange from useNodesState
+ * @param nodes - Current nodes array (to read start positions)
+ */
+export declare function useAxisConstrain<NodeType extends NodeBase = NodeBase>(originalOnNodesChange: (changes: NodeChange<NodeType>[]) => void, nodes: NodeType[]): UseAxisConstrainResult<NodeType>;
+//# sourceMappingURL=useAxisConstrain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAxisConstrain.d.ts","sourceRoot":"","sources":["../../src/layout/useAxisConstrain.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAc,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAWvE,MAAM,WAAW,sBAAsB,CAAC,QAAQ,SAAS,QAAQ,GAAG,QAAQ;IAC1E,6EAA6E;IAC7E,aAAa,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,KAAK,IAAI,CAAC;CAC1D;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,SAAS,QAAQ,GAAG,QAAQ,EACnE,qBAAqB,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,KAAK,IAAI,EAChE,KAAK,EAAE,QAAQ,EAAE,GAChB,sBAAsB,CAAC,QAAQ,CAAC,CAoGlC"}