import type { Node, Edge, XYPosition, ColorMode } from '@xyflow/svelte'; import type { DirectionalDisplacementOptions, ExplosionDisplacementStrategy, ReflowDisplacementOptions } from '@pixerate/editor/canvas'; /** * Generic node interface representing an element on the canvas. */ export type CanvasNode = Record, TType extends string | undefined = string | undefined> = Node; /** * Generic edge interface representing a connection on the canvas. */ export type CanvasEdge = Record, TType extends string | undefined = string | undefined> = Edge; /** * Differences computed between two graph states. */ export interface GraphDifferences { changedNodes: TNode[]; changedEdges: TEdge[]; removedNodes: TNode[]; removedEdges: TEdge[]; } /** * Standard serialized clipboard payload for nodes and optional edges. */ export interface CanvasClipboardPayload { version?: number; nodes: TNode[]; edges?: TEdge[]; } /** * Options for Dagre graph layout. */ export interface CanvasLayoutOptions { direction?: 'LR' | 'TB' | 'RL' | 'BT'; ranksep?: number; nodesep?: number; defaultNodeWidth?: number; defaultNodeHeight?: number; } /** * Options for keyboard shortcuts. */ export interface CanvasShortcutsOptions { targetElement?: HTMLElement | Window; onCopy?: () => void; onCut?: () => void; onPaste?: (event: ClipboardEvent) => void; onDelete?: (selectedNodes: TNode[]) => void; onDuplicate?: (selectedNodes: TNode[]) => void; onSelectAll?: () => void; onGroup?: (selectedNodes: TNode[]) => void; onUngroup?: (selectedNodes: TNode[]) => void; onZoomIn?: () => void; onZoomOut?: () => void; onFitView?: () => void; onSearch?: () => void; getSelectedNodes?: () => TNode[]; } /** * Strategy used to resolve the primary dock target when multiple targets intersect a dragged node. * - 'center-point': Chooses the target enclosing or closest to the center coordinate of the dragged node. * - 'max-overlap': Chooses the target with the largest bounding box intersection area. * - 'pointer': Chooses the target enclosing or closest to the mouse/touch cursor coordinates (falls back to 'center-point'). * - 'first': Chooses the first intersecting target (legacy behavior). */ export type DockStrategy = 'center-point' | 'max-overlap' | 'pointer' | 'first'; /** * Docking and intersection callbacks. */ export interface CanvasDockingCallbacks { onDockHover?: (dockTarget: TNode, draggedNode: TNode) => void; onDockLeave?: (dockTarget: TNode, draggedNode: TNode) => void; onDockDrop?: (dockTarget: TNode, draggedNode: TNode) => void; } /** * Configuration options for SvelteFlow presets. */ export interface CanvasInteractionPresetConfig { snapGrid?: [number, number]; panOnDrag?: number[] | boolean; panOnScroll?: boolean; selectionOnDrag?: boolean; colorMode?: ColorMode; multiSelectionKey?: string[]; minZoom?: number; maxZoom?: number; selectionMode?: 'partial' | 'full'; } /** * Parametric point returned by a trajectory evaluation. */ export interface TrajectoryPoint { position: XYPosition; scale?: number; opacity?: number; } /** * Trajectory evaluation function determining path, scale, and opacity over time t in [0, 1]. */ export type TrajectoryFunction = (origin: XYPosition, target: XYPosition, progress: number, index: number, total: number) => TrajectoryPoint; /** * Options for fan-out trajectory generator. */ export interface FanOutTrajectoryOptions { curvature?: number; spreadAngle?: number; startScale?: number; endScale?: number; startOpacity?: number; endOpacity?: number; } /** * Single node animation transition definition. */ export interface NodeTransition { node: TNode; from: XYPosition; to: XYPosition; trajectory?: TrajectoryFunction; delay?: number; duration?: number; easing?: (t: number) => number; index?: number; total?: number; } export type { DisplacementDirection, DirectionalDisplacementOptions, ReflowDisplacementOptions, ExplosionDisplacementStrategy } from '@pixerate/editor/canvas'; /** * Snapshot of canvas graph state prior to node explosion, enabling exact reversibility. */ export interface ExplosionSnapshot { parentId: string; childNodeIds: string[]; childEdgeIds: string[]; displacedNodes: { id: string; originalPosition: XYPosition; }[]; timestamp: number; } /** * Options for exploding a node. */ export interface ExplodeNodeOptions { childNodes: TNode[]; childEdges?: TEdge[]; connectParentToChildren?: boolean | 'first' | 'all'; displacementStrategy?: ExplosionDisplacementStrategy; directionalOptions?: DirectionalDisplacementOptions; reflowOptions?: Partial; trajectory?: TrajectoryFunction; duration?: number; staggerDelay?: number; easing?: (t: number) => number; onComplete?: () => void; } /** * Options for collapsing an exploded node. */ export interface CollapseNodeOptions { duration?: number; staggerDelay?: number; easing?: (t: number) => number; trajectory?: TrajectoryFunction; onComplete?: () => void; }