import { type Edge, type Node, Position } from 'reactflow' /** * Tool entry displayed as a chip on a block (e.g. an Agent's attached tools). */ export interface PreviewTool { name: string type: string bgColor: string } /** * A single block in a preview workflow. Presentational shape — authored by hand * for docs diagrams, not the app's full serialized block state. */ export interface PreviewBlock { id: string name: string type: string bgColor: string rows: Array<{ title: string; value: string }> /** * Branch rows, each with its own right-edge source handle whose id is the * branch id. Author ids in the app's own handle scheme so edges match the * real workflow representation verbatim: `condition-` on Condition * blocks, `router-` on Routers. */ branches?: Array<{ id: string; label: string; value?: string }> /** Render an error row with a red source handle (id `error`). */ showError?: boolean tools?: PreviewTool[] position: { x: number; y: number } hideTargetHandle?: boolean hideSourceHandle?: boolean /** When set, the block renders as a Loop/Parallel container sized to hold its children. */ size?: { width: number; height: number } /** Id of the container block this block sits inside. Its position is relative to the container. */ parentId?: string } /** * A workflow rendered as a read-only, app-styled diagram in the docs. */ export interface PreviewWorkflow { id: string name: string blocks: PreviewBlock[] edges: Array<{ id: string; source: string; target: string; sourceHandle?: string }> } export const BLOCK_STAGGER = 0.12 export const EASE_OUT: [number, number, number, number] = [0.16, 1, 0.3, 1] const EDGE_STYLE = { stroke: 'var(--wp-edge)', strokeWidth: 1.5 } as const const EDGE_STYLE_HIGHLIGHT = { stroke: '#33b4ff', strokeWidth: 2.5 } as const /** Optional emphasis: light one block or one edge and dim everything else. */ export interface HighlightOptions { highlightBlock?: string highlightEdge?: string /** Ring one block (selection) without dimming the rest. */ selectedBlock?: string } /** * Converts a {@link PreviewWorkflow} to React Flow nodes and edges. * * @param workflow - The workflow definition * @param animate - When true, node/edge data carries stagger metadata * @param highlight - Optional block/edge to emphasize (dims the rest) */ export function toReactFlowElements( workflow: PreviewWorkflow, animate = false, highlight: HighlightOptions = {} ): { nodes: Node[]; edges: Edge[] } { const { highlightBlock, highlightEdge, selectedBlock } = highlight const hasHighlight = Boolean(highlightBlock || highlightEdge) const blockIndexMap = new Map(workflow.blocks.map((b, i) => [b.id, i])) const blocksById = new Map(workflow.blocks.map((b) => [b.id, b])) const nodes: Node[] = workflow.blocks.map((block, index) => { const isContainer = Boolean(block.size) // Nested blocks are authored relative to their container; render them at // absolute coordinates (not React Flow parentNode children) so the edges // between a container and its nested blocks render reliably and on top. const parent = block.parentId ? blocksById.get(block.parentId) : undefined const position = parent ? { x: parent.position.x + block.position.x, y: parent.position.y + block.position.y } : block.position return { id: block.id, type: isContainer ? 'previewContainer' : 'previewBlock', position, zIndex: isContainer ? 0 : 1, ...(block.size ? { style: { width: block.size.width, height: block.size.height } } : {}), data: { name: block.name, blockType: block.type, bgColor: block.bgColor, rows: block.rows, branches: block.branches, showError: block.showError, tools: block.tools, hideTargetHandle: block.hideTargetHandle, hideSourceHandle: block.hideSourceHandle, index, animate, isHighlighted: highlightBlock === block.id || selectedBlock === block.id, isDimmed: hasHighlight && highlightBlock !== block.id, }, draggable: true, selectable: false, connectable: false, sourcePosition: Position.Right, targetPosition: Position.Left, } }) const edges: Edge[] = workflow.edges.map((e) => { const sourceIndex = blockIndexMap.get(e.source) ?? 0 const isEdgeHighlight = highlightEdge === e.id const dimmed = hasHighlight && !isEdgeHighlight return { id: e.id, source: e.source, target: e.target, type: 'previewEdge', animated: false, style: { ...(isEdgeHighlight ? EDGE_STYLE_HIGHLIGHT : EDGE_STYLE), opacity: dimmed ? 0.35 : 1, }, sourceHandle: e.sourceHandle ?? 'source', targetHandle: 'target', data: { animate, delay: animate ? sourceIndex * BLOCK_STAGGER + BLOCK_STAGGER : 0, }, } }) return { nodes, edges } }