@coral-viz/viz 0.2.3

package/dist/text-editor/TextEditor.js.map

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

package/dist/text-editor/hooks/useBidirectionalSync.d.ts

@@ -0,0 +1,106 @@
+/**
+ * useBidirectionalSync - Hook for bidirectional text ↔ Graph-IR ↔ visual sync
+ *
+ * Keeps text DSL, Graph-IR, and visual editor in sync with debounced updates.
+ */
+import type { GraphIR, CoralNode, CoralEdge } from '../../types.js';
+/**
+ * Parse function signature - converts text to Graph-IR
+ */
+export type ParseFunction = (text: string) => SyncParseResult;
+/**
+ * Print function signature - converts Graph-IR to text
+ */
+export type PrintFunction = (graph: GraphIR) => string;
+/**
+ * Result of the parse function a host injects.
+ *
+ * Deliberately more permissive than `@coral-viz/language`'s `ParseResult` — this
+ * is the contract for any injected parser, Coral, Mermaid or DOT — and named
+ * distinctly so the ecosystem does not ship two public types called
+ * `SyncParseResult` (R-011 AC-7).
+ */
+export interface SyncParseResult {
+    success: boolean;
+    graph?: GraphIR;
+    errors: SyncParseError[];
+}
+/**
+ * Parse error with location information
+ */
+export interface SyncParseError {
+    message: string;
+    line: number;
+    column: number;
+    offset?: number;
+}
+/** @deprecated Use {@link SyncParseResult}. Kept for the 0.2.x line. */
+export type ParseResult = SyncParseResult;
+/** @deprecated Use {@link SyncParseError}. Kept for the 0.2.x line. */
+export type ParseError = SyncParseError;
+/**
+ * Source of the last change
+ */
+export type ChangeSource = 'text' | 'visual' | 'external';
+/**
+ * Sync state returned by the hook
+ */
+export interface SyncState {
+    /** Current text content */
+    text: string;
+    /** Current Graph-IR (null if parse failed) */
+    graph: GraphIR | null;
+    /** Current parse errors */
+    errors: SyncParseError[];
+    /** Whether currently syncing */
+    isSyncing: boolean;
+    /** Source of the last change */
+    lastChangeSource: ChangeSource;
+}
+/**
+ * Sync actions returned by the hook
+ */
+export interface SyncActions {
+    /** Update text (from text editor) */
+    setText: (text: string) => void;
+    /** Update graph (from visual editor) */
+    setGraph: (graph: GraphIR) => void;
+    /** Update from visual editor nodes/edges changes */
+    setFromVisual: (nodes: CoralNode[], edges: CoralEdge[], originalGraph: GraphIR) => void;
+    /** Force sync from external source */
+    forceSync: (text: string) => void;
+}
+/**
+ * Options for the sync hook
+ */
+export interface SyncOptions {
+    /** Initial text content */
+    initialText?: string;
+    /** Initial Graph-IR */
+    initialGraph?: GraphIR;
+    /** Parse function (text → Graph-IR) */
+    parse: ParseFunction;
+    /** Print function (Graph-IR → text) */
+    print: PrintFunction;
+    /** Debounce delay in ms (default: 100) */
+    debounceMs?: number;
+    /** Callback when graph changes */
+    onGraphChange?: (graph: GraphIR | null) => void;
+    /** Callback when errors change */
+    onErrorsChange?: (errors: SyncParseError[]) => void;
+    /** Callback when text changes */
+    onTextChange?: (text: string) => void;
+}
+/**
+ * Hook for bidirectional synchronization between text and visual editors.
+ *
+ * Maintains consistency between:
+ * - Text DSL (Coral, Mermaid, DOT)
+ * - Graph-IR (intermediate representation)
+ * - Visual editor state (React Flow nodes/edges)
+ *
+ * Changes are debounced to avoid excessive updates during typing.
+ */
+export declare function useBidirectionalSync(options: SyncOptions): [SyncState, SyncActions];
+export default useBidirectionalSync;
+//# sourceMappingURL=useBidirectionalSync.d.ts.map

package/dist/text-editor/hooks/useBidirectionalSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBidirectionalSync.d.ts","sourceRoot":"","sources":["../../../src/text-editor/hooks/useBidirectionalSync.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEpE;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,eAAe,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wEAAwE;AACxE,MAAM,MAAM,WAAW,GAAG,eAAe,CAAC;AAC1C,uEAAuE;AACvE,MAAM,MAAM,UAAU,GAAG,cAAc,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE1D;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;IACtB,2BAA2B;IAC3B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,gCAAgC;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,gCAAgC;IAChC,gBAAgB,EAAE,YAAY,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,wCAAwC;IACxC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACnC,oDAAoD;IACpD,aAAa,EAAE,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,aAAa,EAAE,OAAO,KAAK,IAAI,CAAC;IACxF,sCAAsC;IACtC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uCAAuC;IACvC,KAAK,EAAE,aAAa,CAAC;IACrB,uCAAuC;IACvC,KAAK,EAAE,aAAa,CAAC;IACrB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC;IAChD,kCAAkC;IAClC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;IACpD,iCAAiC;IACjC,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,CA0LnF;AAED,eAAe,oBAAoB,CAAC"}

package/dist/text-editor/hooks/useBidirectionalSync.js

@@ -0,0 +1,151 @@
+/**
+ * useBidirectionalSync - Hook for bidirectional text ↔ Graph-IR ↔ visual sync
+ *
+ * Keeps text DSL, Graph-IR, and visual editor in sync with debounced updates.
+ */
+import { useState, useCallback, useRef, useEffect, useMemo } from 'react';
+/**
+ * Hook for bidirectional synchronization between text and visual editors.
+ *
+ * Maintains consistency between:
+ * - Text DSL (Coral, Mermaid, DOT)
+ * - Graph-IR (intermediate representation)
+ * - Visual editor state (React Flow nodes/edges)
+ *
+ * Changes are debounced to avoid excessive updates during typing.
+ */
+export function useBidirectionalSync(options) {
+    const { initialText = '', initialGraph, parse, print, debounceMs = 100, onGraphChange, onErrorsChange, onTextChange, } = options;
+    // State
+    const [text, setTextState] = useState(initialText);
+    const [graph, setGraphState] = useState(initialGraph ?? null);
+    const [errors, setErrors] = useState([]);
+    const [isSyncing, setIsSyncing] = useState(false);
+    const [lastChangeSource, setLastChangeSource] = useState('external');
+    // Refs for debouncing and preventing feedback loops
+    const debounceTimeoutRef = useRef(null);
+    const isInternalUpdateRef = useRef(false);
+    // Parse text and update graph
+    const parseText = useCallback((newText) => {
+        const result = parse(newText);
+        setErrors(result.errors);
+        onErrorsChange?.(result.errors);
+        // A failed parse still carries everything that did parse, so one bad
+        // line must not blank the canvas (R-009 AC-8).
+        if (result.graph) {
+            setGraphState(result.graph);
+            onGraphChange?.(result.graph);
+        }
+        return result;
+    }, [parse, onErrorsChange, onGraphChange]);
+    // Print graph and update text
+    const printGraph = useCallback((newGraph) => {
+        const newText = print(newGraph);
+        isInternalUpdateRef.current = true;
+        setTextState(newText);
+        onTextChange?.(newText);
+        isInternalUpdateRef.current = false;
+        return newText;
+    }, [print, onTextChange]);
+    // Debounced text update
+    const setText = useCallback((newText) => {
+        // Skip if this is an internal update from printing
+        if (isInternalUpdateRef.current) {
+            return;
+        }
+        setTextState(newText);
+        setLastChangeSource('text');
+        setIsSyncing(true);
+        onTextChange?.(newText);
+        // Clear existing timeout
+        if (debounceTimeoutRef.current) {
+            clearTimeout(debounceTimeoutRef.current);
+        }
+        // Debounce parse
+        debounceTimeoutRef.current = setTimeout(() => {
+            parseText(newText);
+            setIsSyncing(false);
+        }, debounceMs);
+    }, [debounceMs, parseText, onTextChange]);
+    // Update from graph (visual editor changes)
+    const setGraph = useCallback((newGraph) => {
+        setGraphState(newGraph);
+        setLastChangeSource('visual');
+        setIsSyncing(true);
+        onGraphChange?.(newGraph);
+        // Clear existing timeout
+        if (debounceTimeoutRef.current) {
+            clearTimeout(debounceTimeoutRef.current);
+        }
+        // Debounce print
+        debounceTimeoutRef.current = setTimeout(() => {
+            printGraph(newGraph);
+            setErrors([]); // Clear errors when updating from visual
+            setIsSyncing(false);
+        }, debounceMs);
+    }, [debounceMs, printGraph, onGraphChange]);
+    // Update from visual editor nodes/edges
+    const setFromVisual = useCallback((nodes, edges, originalGraph) => {
+        // Convert React Flow nodes/edges back to Graph-IR
+        const newGraph = {
+            ...originalGraph,
+            nodes: nodes.map((node) => ({
+                id: node.id,
+                type: node.data.nodeType,
+                label: node.data.label,
+                description: node.data.description,
+                properties: node.data.properties,
+                position: node.position,
+                dimensions: node.measured
+                    ? { width: node.measured.width ?? 0, height: node.measured.height ?? 0 }
+                    : undefined,
+            })),
+            edges: edges.map((edge) => ({
+                id: edge.id,
+                source: edge.source,
+                target: edge.target,
+                type: edge.data?.edgeType,
+                label: edge.data?.label,
+                properties: edge.data?.properties,
+            })),
+        };
+        setGraph(newGraph);
+    }, [setGraph]);
+    // Force sync from external source
+    const forceSync = useCallback((newText) => {
+        setTextState(newText);
+        setLastChangeSource('external');
+        onTextChange?.(newText);
+        parseText(newText);
+    }, [parseText, onTextChange]);
+    // Cleanup on unmount
+    useEffect(() => {
+        return () => {
+            if (debounceTimeoutRef.current) {
+                clearTimeout(debounceTimeoutRef.current);
+            }
+        };
+    }, []);
+    // Initial parse if text provided
+    useEffect(() => {
+        if (initialText && !initialGraph) {
+            parseText(initialText);
+        }
+    }, []); // Only run once on mount
+    const state = useMemo(() => ({
+        text,
+        graph,
+        errors,
+        isSyncing,
+        lastChangeSource,
+    }), [text, graph, errors, isSyncing, lastChangeSource]);
+    const actions = useMemo(() => ({
+        setText,
+        setGraph,
+        setFromVisual,
+        forceSync,
+    }), [setText, setGraph, setFromVisual, forceSync]);
+    return [state, actions];
+}
+export default useBidirectionalSync;
+//# sourceMappingURL=useBidirectionalSync.js.map

package/dist/text-editor/hooks/useBidirectionalSync.js.map

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

package/dist/text-editor/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Text Editor components for Coral
+ *
+ * Provides text editing with bidirectional sync to the visual editor.
+ */
+export { TextEditor, type TextEditorProps, type SyntaxLanguage } from './TextEditor.js';
+export { SplitEditor, type SplitEditorProps, type SplitLayout, type PrimaryPane, } from './SplitEditor.js';
+export { useBidirectionalSync, type SyncState, type SyncActions, type SyncOptions, type ParseFunction, type PrintFunction, type SyncParseResult, type SyncParseError, type ParseResult, type ParseError, type ChangeSource, } from './hooks/useBidirectionalSync.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/text-editor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/text-editor/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACxF,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,oBAAoB,EACpB,KAAK,SAAS,EACd,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,EAEnB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,iCAAiC,CAAC"}

package/dist/text-editor/index.js

@@ -0,0 +1,11 @@
+/**
+ * Text Editor components for Coral
+ *
+ * Provides text editing with bidirectional sync to the visual editor.
+ */
+// Components
+export { TextEditor } from './TextEditor.js';
+export { SplitEditor, } from './SplitEditor.js';
+// Hooks
+export { useBidirectionalSync, } from './hooks/useBidirectionalSync.js';
+//# sourceMappingURL=index.js.map

package/dist/text-editor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/text-editor/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,aAAa;AACb,OAAO,EAAE,UAAU,EAA6C,MAAM,iBAAiB,CAAC;AACxF,OAAO,EACL,WAAW,GAIZ,MAAM,kBAAkB,CAAC;AAE1B,QAAQ;AACR,OAAO,EACL,oBAAoB,GAYrB,MAAM,iCAAiC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,242 @@
+/**
+ * Types for Coral Visual Editor
+ */
+import type { Node, Edge } from '@xyflow/react';
+import type { ConnectionValidation } from '@coral-viz/render';
+export type { PortAnchor, SizingMode, ShapeSizing, TextMeasureOptions, TextDimensions, NodeSizingOptions, NodeDimensions, ShapeDefinition, ShapeParameter, SymbolPort, SymbolVariant, SymbolDefinition, SymbolLibrary, ConnectionConstraints, ConnectionRule, NotationDefinition, NotationValidation, ValidationRule, IncompatibilityReason, HandleDragState, ShapeRegistry, SymbolRegistry, NotationRegistry, ValidationResult, ConnectionValidation, } from '@coral-viz/render';
+import type { GraphNode, GraphEdge, Position, EdgeStyle } from '@graph-ir/core';
+export type { GraphIR, GraphNode, GraphEdge, Position, Dimensions, EdgeStyle, LayoutOptions, } from '@graph-ir/core';
+/**
+ * Graph-IR types (subset needed for visualization)
+ */
+/**
+ * Coral node data passed to React Flow nodes
+ * Includes index signature for React Flow v12 compatibility
+ */
+export interface CoralNodeData {
+    label: string;
+    nodeType: string;
+    description?: string;
+    properties?: Record<string, unknown>;
+    /** Whether automatic layout and dragging must preserve this node's position. */
+    pinned?: boolean;
+    isGroup?: boolean;
+    childCount?: number;
+    /** Canonical fields carried through the React Flow projection unchanged. */
+    canonical?: Omit<GraphNode, 'children' | 'id' | 'type' | 'label' | 'description' | 'properties' | 'position' | 'pinned'>;
+    [key: string]: unknown;
+}
+/**
+ * React Flow node with Coral data
+ */
+export type CoralNode = Node<CoralNodeData>;
+/**
+ * Coral edge data passed to React Flow edges
+ * Includes index signature for React Flow v12 compatibility
+ */
+export interface CoralEdgeData {
+    label?: string;
+    edgeType?: string;
+    properties?: Record<string, unknown>;
+    lineStyle?: EdgeStyle['lineStyle'];
+    routingPoints?: Position[];
+    /** Canonical fields carried through the React Flow projection unchanged. */
+    canonical?: Omit<GraphEdge, 'id' | 'source' | 'target' | 'sourcePort' | 'targetPort' | 'type' | 'label' | 'properties' | 'routingPoints'>;
+    /** ELK-compatible routed path (bend points from edge router) */
+    routedPath?: {
+        startPoint: Position;
+        endPoint: Position;
+        bendPoints: Position[];
+    };
+    [key: string]: unknown;
+}
+/**
+ * React Flow edge with Coral data
+ */
+export type CoralEdge = Edge<CoralEdgeData>;
+/**
+ * Props for custom Coral node components
+ * React Flow v12 passes these props to custom node components
+ */
+export interface CoralNodeProps {
+    id: string;
+    data: CoralNodeData;
+    selected?: boolean;
+    type?: string;
+    xPos?: number;
+    yPos?: number;
+    zIndex?: number;
+    isConnectable?: boolean;
+    positionAbsoluteX?: number;
+    positionAbsoluteY?: number;
+    dragging?: boolean;
+    sourcePosition?: string;
+    targetPosition?: string;
+}
+/**
+ * Editor state
+ */
+export interface EditorState {
+    nodes: CoralNode[];
+    edges: CoralEdge[];
+    selectedNodes: string[];
+    selectedEdges: string[];
+}
+/**
+ * Editor callbacks
+ */
+export interface EditorCallbacks {
+    onNodesChange?: (nodes: CoralNode[]) => void;
+    onEdgesChange?: (edges: CoralEdge[]) => void;
+    onNodeSelect?: (nodeIds: string[]) => void;
+    onEdgeSelect?: (edgeIds: string[]) => void;
+    onNodeDoubleClick?: (nodeId: string) => void;
+    /** Called when a node label is edited inline */
+    onLabelEdit?: (nodeId: string, newLabel: string) => void;
+}
+/**
+ * Editor configuration
+ */
+export interface EditorConfig {
+    /** Enable node dragging */
+    draggable?: boolean;
+    /** Enable edge connections */
+    connectable?: boolean;
+    /** Enable selection */
+    selectable?: boolean;
+    /** Enable zooming */
+    zoomable?: boolean;
+    /** Enable panning */
+    pannable?: boolean;
+    /** Show minimap */
+    showMinimap?: boolean;
+    /** Show controls */
+    showControls?: boolean;
+    /** Fit view on load */
+    fitViewOnLoad?: boolean;
+}
+/**
+ * Edge style definition
+ */
+export interface NotationEdgeStyle {
+    name: string;
+    targetArrow: 'arrow' | 'triangle' | 'diamond' | 'circle' | 'none';
+    sourceArrow?: 'arrow' | 'triangle' | 'diamond' | 'circle' | 'none';
+    lineStyle: 'solid' | 'dashed' | 'dotted';
+    stroke: string;
+    strokeWidth: number;
+}
+/**
+ * Entry/exit point definition
+ */
+export interface FlowPoint {
+    symbol: string;
+    variant?: string;
+    min?: number;
+    max?: number;
+}
+/**
+ * Position source tracking - where did this position come from?
+ */
+export type PositionSource = 'elk-computed' | 'user-dragged' | 'loaded' | 'incremental';
+/**
+ * Node with position metadata for tracking position origin
+ */
+export interface PositionedNode {
+    id: string;
+    position: Position;
+    positionSource: PositionSource;
+    /** When position was last updated */
+    positionTimestamp: number;
+}
+/**
+ * Graph diff result - identifies changes between two graph states
+ */
+export interface GraphDiff {
+    /** Node IDs that exist in new graph but not in old */
+    added: string[];
+    /** Node IDs that exist in old graph but not in new */
+    removed: string[];
+    /** Node IDs where label or type changed */
+    modified: string[];
+    /** Node IDs with no changes */
+    unchanged: string[];
+}
+/**
+ * Position resolution result - maps node IDs to positions
+ */
+export interface PositionResolution {
+    /** Resolved positions for nodes */
+    positions: Map<string, Position>;
+    /** Node IDs that need ELK positioning (new nodes without positions) */
+    needsLayout: string[];
+}
+/**
+ * Simplified graph node for diffing (minimal fields needed for comparison)
+ */
+export interface DiffableNode {
+    id: string;
+    type: string;
+    label?: string;
+}
+/**
+ * Simplified graph for diffing
+ */
+export interface DiffableGraph {
+    nodes: DiffableNode[];
+    edges: Array<{
+        id: string;
+        source: string;
+        target: string;
+    }>;
+}
+/**
+ * Information about a connection being validated
+ */
+export interface ConnectionInfo {
+    /** Source node ID */
+    sourceNodeId: string;
+    /** Target node ID */
+    targetNodeId: string;
+    /** Source port ID (optional) */
+    sourcePortId?: string;
+    /** Target port ID (optional) */
+    targetPortId?: string;
+}
+/**
+ * Node info needed for connection validation
+ */
+export interface NodeConnectionInfo {
+    id: string;
+    symbolId: string;
+    variant?: string;
+}
+/**
+ * Edge compatibility status for rendering
+ */
+export type EdgeCompatibilityStatus = 'compatible' | 'warning' | 'incompatible';
+/**
+ * Edge with compatibility information for rendering
+ */
+export interface EdgeCompatibility {
+    edgeId: string;
+    status: EdgeCompatibilityStatus;
+    validation: ConnectionValidation;
+}
+/**
+ * Props for connection validation context
+ */
+export interface ConnectionValidationContext {
+    /** Current notation ID */
+    notationId: string;
+    /** Map of node ID to node info for validation */
+    nodeInfo: Map<string, NodeConnectionInfo>;
+    /** Existing edges for constraint checking */
+    existingEdges: Array<{
+        source: string;
+        target: string;
+        sourcePort?: string;
+        targetPort?: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for Coral Visual Editor
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/waypoints/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Waypoint module (CORAL-REQ-015)
+ */
+export type { EdgeWaypoint } from './types.js';
+export { createWaypoint, addWaypointToEdge, removeWaypointFromEdge, moveWaypoint, insertWaypointAtPosition, } from './operations.js';
+export { routeWithWaypoints, type RoutedPath } from './router.js';
+export { useWaypointManager, type UseWaypointManagerOptions, type UseWaypointManagerResult, } from './useWaypointManager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/waypoints/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/waypoints/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,YAAY,EACZ,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EACL,kBAAkB,EAClB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,GAC9B,MAAM,yBAAyB,CAAC"}

package/dist/waypoints/index.js

@@ -0,0 +1,7 @@
+/**
+ * Waypoint module (CORAL-REQ-015)
+ */
+export { createWaypoint, addWaypointToEdge, removeWaypointFromEdge, moveWaypoint, insertWaypointAtPosition, } from './operations.js';
+export { routeWithWaypoints } from './router.js';
+export { useWaypointManager, } from './useWaypointManager.js';
+//# sourceMappingURL=index.js.map

package/dist/waypoints/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/waypoints/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,YAAY,EACZ,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAmB,MAAM,aAAa,CAAC;AAClE,OAAO,EACL,kBAAkB,GAGnB,MAAM,yBAAyB,CAAC"}

package/dist/waypoints/operations.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Pure waypoint operations (CORAL-REQ-015)
+ *
+ * All functions are immutable — they return new arrays.
+ */
+import type { EdgeWaypoint } from './types.js';
+/** Create a new waypoint with a unique ID */
+export declare function createWaypoint(x: number, y: number, type?: 'corner' | 'smooth'): EdgeWaypoint;
+/** Add a waypoint to the end of an edge's waypoint list */
+export declare function addWaypointToEdge(waypoints: EdgeWaypoint[], waypoint: EdgeWaypoint): EdgeWaypoint[];
+/** Remove a waypoint by ID */
+export declare function removeWaypointFromEdge(waypoints: EdgeWaypoint[], waypointId: string): EdgeWaypoint[];
+/** Move a waypoint to a new position */
+export declare function moveWaypoint(waypoints: EdgeWaypoint[], waypointId: string, x: number, y: number): EdgeWaypoint[];
+/**
+ * Insert a waypoint at the closest segment of a polyline path.
+ *
+ * The path is an array of points representing the full edge path
+ * (startPoint + bendPoints + endPoint). The new waypoint is inserted
+ * at the position along the path where it is closest.
+ */
+export declare function insertWaypointAtPosition(existing: EdgeWaypoint[], path: Array<{
+    x: number;
+    y: number;
+}>, position: {
+    x: number;
+    y: number;
+}): EdgeWaypoint[];
+//# sourceMappingURL=operations.d.ts.map

package/dist/waypoints/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../src/waypoints/operations.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,6CAA6C;AAC7C,wBAAgB,cAAc,CAC5B,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,IAAI,GAAE,QAAQ,GAAG,QAAmB,GACnC,YAAY,CAEd;AAED,2DAA2D;AAC3D,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,YAAY,EAAE,EACzB,QAAQ,EAAE,YAAY,GACrB,YAAY,EAAE,CAEhB;AAED,8BAA8B;AAC9B,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,YAAY,EAAE,EACzB,UAAU,EAAE,MAAM,GACjB,YAAY,EAAE,CAEhB;AAED,wCAAwC;AACxC,wBAAgB,YAAY,CAC1B,SAAS,EAAE,YAAY,EAAE,EACzB,UAAU,EAAE,MAAM,EAClB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,YAAY,EAAE,CAIhB;AAuBD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,YAAY,EAAE,EACxB,IAAI,EAAE,KAAK,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EACrC,QAAQ,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACjC,YAAY,EAAE,CAmDhB"}