@principal-ai/subsystems-react 0.20.6 → 0.21.1

package/dist/components/GraphRenderer.d.ts

@@ -1,295 +0,0 @@
-import React from 'react';
-import type { Violation, GraphEvent, ExtendedCanvas, ComponentLibrary } from '@principal-ai/subsystems-core';
-import { TooltipPortalContext } from '../contexts/TooltipPortalContext';
-export { TooltipPortalContext };
-/** Position change event for tracking node movements */
-export interface NodePositionChange {
-    nodeId: string;
-    position: {
-        x: number;
-        y: number;
-    };
-}
-/** Dimension change event for tracking node resizing */
-export interface NodeDimensionChange {
-    nodeId: string;
-    dimensions: {
-        width: number;
-        height: number;
-    };
-}
-/** Text change event for tracking inline text edits */
-export interface NodeTextChange {
-    nodeId: string;
-    text: string;
-}
-/** All pending changes that can be saved */
-export interface PendingChanges {
-    /** Node position changes */
-    positionChanges: NodePositionChange[];
-    /** Node dimension changes (from resizing) */
-    dimensionChanges: NodeDimensionChange[];
-    /** Text changes for text and group nodes */
-    textChanges: NodeTextChange[];
-    /** Node updates (type, data changes) */
-    nodeUpdates: Array<{
-        nodeId: string;
-        updates: {
-            type?: string;
-            data?: Record<string, unknown>;
-        };
-    }>;
-    /** Deleted node IDs */
-    deletedNodeIds: string[];
-    /** New edges created (with optional handle info for connection points) */
-    createdEdges: Array<{
-        from: string;
-        to: string;
-        type: string;
-        sourceHandle?: string;
-        targetHandle?: string;
-    }>;
-    /** Deleted edges (with full connection info for config removal) */
-    deletedEdges: Array<{
-        from: string;
-        to: string;
-        type: string;
-    }>;
-    /** Whether there are any changes */
-    hasChanges: boolean;
-}
-/** Ref handle for imperative actions */
-export interface GraphRendererHandle {
-    /** Get all pending changes */
-    getPendingChanges: () => PendingChanges;
-    /** Reset edit state to match current props */
-    resetEditState: () => void;
-    /** Check if there are unsaved changes */
-    hasUnsavedChanges: () => boolean;
-    /** Whether there are changes that can be undone */
-    canUndo: () => boolean;
-    /** Whether there are changes that can be redone */
-    canRedo: () => boolean;
-    /** Undo the last change */
-    undo: () => void;
-    /** Redo the last undone change */
-    redo: () => void;
-}
-/** Base props shared by all render modes */
-interface GraphRendererBaseProps {
-    /** Optional violations to highlight */
-    violations?: Violation[];
-    /**
-     * Duration of the fitView animation in milliseconds.
-     * Set to 0 for instant positioning (no animation).
-     * Defaults to 200.
-     */
-    fitViewDuration?: number;
-    /**
-     * Whether to show tooltips on hover for nodes and edges.
-     * Defaults to true.
-     */
-    showTooltips?: boolean;
-    /**
-     * Optional node ID to highlight (e.g., when playing back execution events).
-     * Highlighted nodes will have a special visual treatment.
-     */
-    highlightedNodeId?: string | null;
-    /**
-     * Optional list of active node IDs (nodes involved in current execution scenario).
-     * Nodes NOT in this list will be dimmed (reduced opacity).
-     * If undefined or empty, all nodes are shown at full opacity.
-     */
-    activeNodeIds?: string[] | null;
-    /** Optional configuration name for identification (used with multi-config setups) */
-    configName?: string;
-    /** Optional class name */
-    className?: string;
-    /** Optional width */
-    width?: number | string;
-    /** Optional height */
-    height?: number | string;
-    /** Whether to show minimap */
-    showMinimap?: boolean;
-    /** Whether to show controls */
-    showControls?: boolean;
-    /** Whether to show background */
-    showBackground?: boolean;
-    /**
-     * Background variant style.
-     * - 'dots': Small dots pattern
-     * - 'lines': Grid lines (default)
-     * - 'cross': Cross pattern
-     */
-    backgroundVariant?: 'dots' | 'lines' | 'cross';
-    /**
-     * Gap between background pattern elements in pixels.
-     * Defaults to 50 for lines/cross, 16 for dots.
-     */
-    backgroundGap?: number;
-    /**
-     * Whether to show a center indicator at the canvas origin (0,0).
-     * Useful for visualizing where the center point is when items aren't centered.
-     * Defaults to false.
-     */
-    showCenterIndicator?: boolean;
-    /** Optional event stream for triggering animations */
-    events?: GraphEvent[];
-    /** Optional callback when an event is processed */
-    onEventProcessed?: (event: GraphEvent) => void;
-    /**
-     * Whether edit mode is enabled.
-     * When true, nodes can be dragged, edited, deleted, and edges can be created/deleted.
-     * All changes are tracked internally and can be retrieved via ref.getPendingChanges()
-     */
-    editable?: boolean;
-    /**
-     * Callback when pending changes state changes.
-     * Called with true when there are unsaved changes, false when there are none.
-     * Use this to enable/disable save buttons in the parent component.
-     */
-    onPendingChangesChange?: (hasChanges: boolean) => void;
-    /**
-     * Callback when a node is clicked.
-     * Receives the node ID and the click event. If provided, overrides default node selection behavior.
-     */
-    onNodeClick?: (nodeId: string, event: React.MouseEvent) => void;
-    /**
-     * When set, fits the viewport to show these specific nodes.
-     * Useful for focusing on a subset of the graph (e.g., scenario nodes).
-     * Pass null/undefined/empty array to use default fitView behavior.
-     */
-    fitViewToNodeIds?: string[] | null;
-    /**
-     * Padding around nodes when fitting view to specific nodes.
-     * @default 0.2
-     */
-    fitViewPadding?: number;
-    /**
-     * Set of node IDs that should be draggable even when editable=false.
-     * Useful for allowing specific nodes (like group containers) to be moved
-     * while keeping other nodes locked in place.
-     */
-    draggableNodeIds?: Set<string>;
-    /**
-     * Callback fired when a node drag operation completes.
-     * Receives the node ID and its new position.
-     */
-    onNodeDragStop?: (nodeId: string, position: {
-        x: number;
-        y: number;
-    }) => void;
-    /**
-     * Callback fired when user presses Cmd+C (Mac) or Ctrl+C (Windows/Linux)
-     * with nodes selected. Receives the array of selected node IDs.
-     * Use this to implement custom copy behavior.
-     */
-    onCopy?: (selectedNodeIds: string[]) => void;
-    /**
-     * Container width in pixels. When provided along with containerHeight,
-     * enables calculating the initial viewport synchronously to avoid the
-     * "zoom in then animate out" effect on initial render.
-     */
-    containerWidth?: number;
-    /**
-     * Container height in pixels. When provided along with containerWidth,
-     * enables calculating the initial viewport synchronously to avoid the
-     * "zoom in then animate out" effect on initial render.
-     */
-    containerHeight?: number;
-    /**
-     * ELK layout configuration for circuit-board style edge routing.
-     * When enabled, edges are routed with orthogonal paths that don't overlap.
-     */
-    elkLayout?: {
-        /**
-         * Whether ELK layout is enabled
-         * @default false
-         */
-        enabled: boolean;
-        /**
-         * Edge routing style
-         * - 'orthogonal': Circuit-board style with 90-degree angles (default)
-         * - 'splines': Smooth curved edges
-         * - 'polyline': Straight line segments
-         */
-        routingStyle?: 'orthogonal' | 'splines' | 'polyline';
-        /**
-         * Minimum spacing between parallel edges in pixels
-         * @default 15
-         */
-        edgeSpacing?: number;
-        /**
-         * Spacing between edges and nodes in pixels
-         * @default 20
-         */
-        edgeNodeSpacing?: number;
-    };
-    /**
-     * Scenario-derived edges with sequence information.
-     * When provided, edges matching these transitions will show sequence numbers.
-     * Use with deriveEdgesFromSequence() from @principal-ai/core to generate these.
-     */
-    scenarioEdges?: Array<{
-        fromSpan: string;
-        toSpan: string;
-        sequenceNumber: number;
-    }>;
-    /**
-     * Whether to show sequence labels on edges when scenarioEdges is provided.
-     * @default true
-     */
-    showSequenceLabels?: boolean;
-}
-/** GraphRenderer props - canvas format only */
-export interface GraphRendererProps extends GraphRendererBaseProps {
-    /** Extended Canvas document */
-    canvas: ExtendedCanvas;
-    /**
-     * Optional component library containing reusable node and edge type definitions.
-     * Types from the library are merged with canvas-level types, with canvas types taking precedence.
-     * This allows sharing type definitions across multiple canvas files via a library.yaml file.
-     */
-    library?: ComponentLibrary;
-    /**
-     * Optional spans canvas containing span convention definitions.
-     * Span colors from this canvas are used as fill colors for event nodes.
-     * When provided with workflowSpanPattern, events will be colored based on their span.
-     */
-    spansCanvas?: ExtendedCanvas;
-    /**
-     * Optional scopes canvas containing scope definitions with colors.
-     * Required for scope-based node coloring.
-     * Replaces library.scopes (which is now deprecated).
-     */
-    scopesCanvas?: ExtendedCanvas;
-    /**
-     * Optional span pattern for the current workflow context.
-     * When provided, event nodes will use the span color from spansCanvas as their fill.
-     * This should match a spanPattern from a workflow.json file.
-     */
-    workflowSpanPattern?: string;
-}
-/**
- * Core graph visualization component using xyflow.
- *
- * Accepts an ExtendedCanvas document for rendering.
- *
- * When `editable` is true, the component manages its own edit state internally.
- * Use the ref to get pending changes when the user wants to save:
- *
- * ```tsx
- * <GraphRenderer canvas={myCanvas} />
- *
- * // With edit mode
- * const graphRef = useRef<GraphRendererHandle>(null);
- * <GraphRenderer
- *   ref={graphRef}
- *   canvas={myCanvas}
- *   editable={isEditMode}
- *   onPendingChangesChange={setHasUnsavedChanges}
- * />
- * ```
- */
-export declare const GraphRenderer: React.ForwardRefExoticComponent<GraphRendererProps & React.RefAttributes<GraphRendererHandle>>;
-//# sourceMappingURL=GraphRenderer.d.ts.map

package/dist/components/GraphRenderer.d.ts.map

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