@01.software/sdk 0.4.0 → 0.4.2

package/dist/ui/flow.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/ui/Flow/index.tsx","../../src/ui/Flow/types.ts","../../src/ui/Flow/built-in-node-types.ts","../../src/ui/Flow/built-in-edge-types.ts","../../src/ui/Flow/useFlow.ts","../../src/core/query/query-keys.ts"],"sourcesContent":["'use client'\n\nimport React from 'react'\nimport {\n  ReactFlow,\n  ReactFlowProvider,\n  Background,\n  MarkerType,\n  type NodeTypes,\n  type NodeProps,\n  type Edge,\n} from '@xyflow/react'\nimport type {\n  CanvasData,\n  DynamicNodeData,\n  DynamicNodeSlotProps,\n  EdgeTypeDef,\n  FlowEdge,\n  FlowNode,\n  FrameNodeData,\n  NodeTypeDef,\n  NodeTypeFieldDef,\n} from './types'\n\nexport type {\n  CanvasData,\n  DynamicNodeSlotProps,\n  FlowNode,\n  FlowEdge,\n  FlowViewport,\n  FlowNodePosition,\n  FlowNodeData,\n  DynamicNodeData,\n  FrameNodeData,\n  NodeTypeDef,\n  NodeTypeFieldDef,\n  EdgeTypeDef,\n} from './types'\nexport { isDynamicNode, isFrameNode } from './types'\nexport { BUILT_IN_NODE_TYPES } from './built-in-node-types'\nexport { BUILT_IN_EDGE_TYPES } from './built-in-edge-types'\nexport { useFlow } from './useFlow'\nexport type { SDKClient, UseFlowOptions, UseFlowResult } from './useFlow'\n\n// ── Helpers ──\n\nfunction sanitizeUrl(url: string | undefined): string | undefined {\n  if (!url) return url\n  try {\n    const parsed = new URL(url)\n    if (parsed.protocol === 'http:' || parsed.protocol === 'https:') return url\n    return undefined\n  } catch {\n    return undefined\n  }\n}\n\nfunction toMarkerType(value: string): MarkerType | undefined {\n  if (value === 'arrow') return MarkerType.Arrow\n  if (value === 'arrowclosed') return MarkerType.ArrowClosed\n  return undefined\n}\n\n// ── Field renderer (type-aware, matching console style) ──\n\nfunction renderFieldValue(\n  key: string,\n  val: unknown,\n  fieldDef?: NodeTypeFieldDef,\n): React.ReactNode {\n  if (val == null || val === '') return null\n\n  const fieldType = fieldDef?.fieldType\n\n  // Image field — image only, no decoration\n  if (\n    fieldType === 'image' ||\n    (typeof val === 'object' && val !== null && 'url' in val)\n  ) {\n    const imgUrl =\n      typeof val === 'string' ? val : (val as { url?: string })?.url\n    const safeUrl = sanitizeUrl(imgUrl)\n    if (!safeUrl) return null\n    return (\n      <img\n        key={key}\n        src={safeUrl}\n        alt=\"\"\n        draggable={false}\n        style={{ flex: 1, minHeight: 0, width: '100%', objectFit: 'contain' }}\n      />\n    )\n  }\n\n  // All other fields — text only\n  return (\n    <div\n      key={key}\n      style={{\n        fontSize: 11,\n        whiteSpace: 'pre-wrap',\n        wordBreak: 'break-word',\n        overflow: 'hidden',\n        flexShrink: 0,\n      }}\n    >\n      {String(val)}\n    </div>\n  )\n}\n\n// ── Default dynamic node renderer (no typeDef) ──\n\nfunction DefaultDynamicNode({ data }: NodeProps) {\n  const d = data as unknown as DynamicNodeData\n  return (\n    <div\n      style={{\n        width: '100%',\n        height: '100%',\n        display: 'flex',\n        flexDirection: 'column',\n      }}\n    >\n      {d.fields &&\n        Object.entries(d.fields)\n          .filter(([, v]) => v != null && v !== '')\n          .map(([key, val]) => renderFieldValue(key, val))}\n    </div>\n  )\n}\n\n// ── Enhanced dynamic node renderer (with NodeTypeDef) ──\n\nfunction EnhancedDynamicNode({\n  data,\n  typeDef,\n}: {\n  data: DynamicNodeData\n  typeDef: NodeTypeDef\n}) {\n  return (\n    <div\n      style={{\n        width: '100%',\n        height: '100%',\n        display: 'flex',\n        flexDirection: 'column',\n      }}\n    >\n      {typeDef.fields.map((f) => {\n        const val = data.fields[f.name]\n        if (val == null || val === '') return null\n        return renderFieldValue(f.name, val, f)\n      })}\n    </div>\n  )\n}\n\n// ── Default frame node renderer ──\n\nfunction DefaultFrameNode({ data }: NodeProps) {\n  const d = data as unknown as FrameNodeData\n  const baseColor = d.color ?? 'rgba(128,128,128,0.15)'\n  const padding = d.padding ?? 20\n  const borderStyle = d.borderStyle ?? 'dashed'\n  const opacity = d.opacity ?? 0.15\n\n  // Apply opacity to rgba colors\n  const bgColor = (() => {\n    const m = baseColor.match(/rgba?\\((\\d+),\\s*(\\d+),\\s*(\\d+)/)\n    if (m) return `rgba(${m[1]},${m[2]},${m[3]},${opacity})`\n    return baseColor\n  })()\n\n  return (\n    <div\n      style={{\n        backgroundColor: bgColor,\n        padding,\n        width: '100%',\n        height: '100%',\n        border:\n          borderStyle === 'none'\n            ? 'none'\n            : `2px ${borderStyle} rgba(128,128,128,0.3)`,\n      }}\n    >\n      <div\n        style={{\n          fontSize: 11,\n          fontWeight: 600,\n          color: 'rgba(128,128,128,0.6)',\n          userSelect: 'none',\n        }}\n      >\n        {d.label}\n      </div>\n    </div>\n  )\n}\n\n// ── Node types builder ──\n\nfunction createNodeTypes(\n  nodeRenderers?: Record<string, React.ComponentType<DynamicNodeSlotProps>>,\n  nodeTypeDefsMap?: Map<string, NodeTypeDef>,\n): NodeTypes {\n  const types: NodeTypes = {} as NodeTypes\n\n  // Dynamic node type\n  types.dynamic = ((props: NodeProps) => {\n    const d = props.data as unknown as DynamicNodeData\n    const typeDef = nodeTypeDefsMap?.get(d.nodeTypeSlug)\n    const CustomRenderer = nodeRenderers?.[d.nodeTypeSlug]\n    if (CustomRenderer) {\n      return (\n        <CustomRenderer\n          id={props.id}\n          nodeTypeSlug={d.nodeTypeSlug}\n          label={d.label}\n          fields={d.fields}\n          nodeTypeDef={typeDef}\n        />\n      )\n    }\n    if (typeDef) {\n      return <EnhancedDynamicNode data={d} typeDef={typeDef} />\n    }\n    return <DefaultDynamicNode {...props} />\n  }) as NodeTypes[string]\n\n  // Frame node type\n  types.frame = DefaultFrameNode as NodeTypes[string]\n\n  return types\n}\n\n// ── Edge style resolver ──\n\nconst EDGE_TYPE_MAP: Record<string, string> = {\n  step: 'step',\n  smoothstep: 'smoothstep',\n  bezier: 'default',\n  default: 'default',\n}\n\nfunction applyEdgeStyles(\n  edges: FlowEdge[],\n  edgeTypeDefsMap?: Map<string, EdgeTypeDef>,\n): Edge[] {\n  if (!edgeTypeDefsMap?.size) return edges as unknown as Edge[]\n\n  return edges.map((edge) => {\n    const slug = edge.edgeTypeSlug\n    if (!slug) return edge as unknown as Edge\n\n    const def = edgeTypeDefsMap.get(slug)\n    if (!def) return edge as unknown as Edge\n\n    const styled: Edge = { ...(edge as unknown as Edge) }\n\n    // Edge type (line style) — canvas value takes precedence\n    if (!styled.type && def.lineStyle) {\n      styled.type = EDGE_TYPE_MAP[def.lineStyle] ?? 'default'\n    }\n\n    // Visual style — canvas style merged with def as fallback\n    styled.style = {\n      ...(def.color ? { stroke: def.color } : undefined),\n      ...(def.strokeWidth ? { strokeWidth: def.strokeWidth } : undefined),\n      ...edge.style,\n    }\n\n    // Animation — canvas value takes precedence\n    if (styled.animated == null && def.animated) styled.animated = true\n\n    // Markers — canvas value takes precedence over def\n    if (!styled.markerStart) {\n      const startType = toMarkerType(def.markerStart)\n      if (startType) {\n        styled.markerStart = {\n          type: startType,\n          ...(def.color ? { color: def.color } : undefined),\n        }\n      }\n    }\n    if (!styled.markerEnd) {\n      const endType = toMarkerType(def.markerEnd)\n      if (endType) {\n        styled.markerEnd = {\n          type: endType,\n          ...(def.color ? { color: def.color } : undefined),\n        }\n      }\n    }\n\n    return styled\n  })\n}\n\n// ── FlowRenderer ──\n\n/**\n * Renders a Flow canvas in read-only mode.\n *\n * Requires `@xyflow/react` peer dependency and its CSS:\n * ```ts\n * import '@xyflow/react/dist/style.css'\n * ```\n */\nexport interface FlowRendererProps {\n  /** Canvas data from Flow document's `canvas` field */\n  data: CanvasData\n  /** Container className */\n  className?: string\n  /** Container style */\n  style?: React.CSSProperties\n  /** Custom renderers by node type slug (e.g., `{ 'product-card': MyProductCard }`) */\n  nodeRenderers?: Record<string, React.ComponentType<DynamicNodeSlotProps>>\n  /** Node type definitions for enhanced rendering (field-type-aware display) */\n  nodeTypeDefs?: NodeTypeDef[]\n  /** Edge type definitions for styled edges (color, stroke, markers, animation) */\n  edgeTypeDefs?: EdgeTypeDef[]\n  /** Show background pattern (default: true) */\n  background?: boolean\n  /** Allow user interaction - pan, zoom (default: false for read-only display) */\n  interactive?: boolean\n  /** Fit view on mount (default: true) */\n  fitView?: boolean\n  /** Called when a node is clicked */\n  onNodeClick?: (event: React.MouseEvent, node: FlowNode) => void\n  /** Called when an edge is clicked */\n  onEdgeClick?: (event: React.MouseEvent, edge: FlowEdge) => void\n}\n\nexport function FlowRenderer({\n  data,\n  className,\n  style,\n  nodeRenderers,\n  nodeTypeDefs,\n  edgeTypeDefs,\n  background = true,\n  interactive = false,\n  fitView = true,\n  onNodeClick,\n  onEdgeClick,\n}: FlowRendererProps) {\n  const nodeTypeDefsMap = React.useMemo(() => {\n    if (!nodeTypeDefs?.length) return undefined\n    return new Map(nodeTypeDefs.map((d) => [d.slug, d]))\n  }, [nodeTypeDefs])\n\n  const edgeTypeDefsMap = React.useMemo(() => {\n    if (!edgeTypeDefs?.length) return undefined\n    return new Map(edgeTypeDefs.map((d) => [d.slug, d]))\n  }, [edgeTypeDefs])\n\n  const nodeTypes = React.useMemo(\n    () => createNodeTypes(nodeRenderers, nodeTypeDefsMap),\n    [nodeRenderers, nodeTypeDefsMap],\n  )\n\n  const styledEdges = React.useMemo(\n    () => applyEdgeStyles(data?.edges ?? [], edgeTypeDefsMap),\n    [data?.edges, edgeTypeDefsMap],\n  )\n\n  if (!data) return null\n\n  const defaultViewport = !fitView && data.viewport ? data.viewport : undefined\n\n  return (\n    <ReactFlowProvider>\n      <div\n        className={className}\n        style={{ width: '100%', height: '100%', ...style }}\n      >\n        <ReactFlow\n          nodes={\n            (data.nodes ?? []) as unknown as Parameters<\n              typeof ReactFlow\n            >[0]['nodes']\n          }\n          edges={styledEdges}\n          nodeTypes={nodeTypes}\n          defaultViewport={defaultViewport}\n          fitView={fitView}\n          onNodeClick={\n            onNodeClick as Parameters<typeof ReactFlow>[0]['onNodeClick']\n          }\n          onEdgeClick={\n            onEdgeClick as Parameters<typeof ReactFlow>[0]['onEdgeClick']\n          }\n          nodesDraggable={interactive ? undefined : false}\n          nodesConnectable={false}\n          elementsSelectable={interactive || !!onNodeClick || !!onEdgeClick}\n          panOnDrag={interactive}\n          zoomOnScroll={interactive}\n          zoomOnPinch={interactive}\n          zoomOnDoubleClick={false}\n        >\n          {background && <Background />}\n        </ReactFlow>\n      </div>\n    </ReactFlowProvider>\n  )\n}\n","import type React from 'react'\n\n// ── Dynamic node data ──\n\nexport interface DynamicNodeData {\n  nodeTypeSlug: string\n  label: string\n  fields: Record<string, unknown>\n}\n\nexport type FlowNodeData = DynamicNodeData & Record<string, unknown>\n\n// ── Canvas types (mirrors @xyflow/react but standalone) ──\n\nexport interface FlowNodePosition {\n  x: number\n  y: number\n}\n\nexport interface FlowNode {\n  id: string\n  type?: string\n  position: FlowNodePosition\n  data: FlowNodeData\n  style?: React.CSSProperties\n  width?: number\n  height?: number\n  measured?: { width?: number; height?: number }\n  draggable?: boolean\n  selectable?: boolean\n  [key: string]: unknown\n}\n\nexport interface FlowEdge {\n  id: string\n  source: string\n  target: string\n  sourceHandle?: string | null\n  targetHandle?: string | null\n  type?: string\n  style?: React.CSSProperties\n  animated?: boolean\n  markerStart?: unknown\n  markerEnd?: unknown\n  edgeTypeSlug?: string\n  fields?: Record<string, unknown>\n  [key: string]: unknown\n}\n\nexport interface FlowViewport {\n  x: number\n  y: number\n  zoom: number\n}\n\nexport interface CanvasData {\n  nodes: FlowNode[]\n  edges: FlowEdge[]\n  viewport: FlowViewport\n}\n\n// ── Node type definitions (mirrors console's NodeTypeDef) ──\n\nexport interface NodeTypeFieldDef {\n  name: string\n  label: string\n  fieldType:\n    | 'text'\n    | 'textarea'\n    | 'number'\n    | 'url'\n    | 'color'\n    | 'image'\n    | 'select'\n    | 'toggle'\n  options?: { label: string; value: string }[]\n  defaultValue?: string\n  required?: boolean\n}\n\nexport interface NodeTypeDef {\n  slug: string\n  name: string\n  color: string\n  defaultSize: { width: number; height: number }\n  fields: NodeTypeFieldDef[]\n  transparentBackground?: boolean\n}\n\n// ── Edge type definitions (mirrors console's EdgeTypeDef) ──\n\nexport interface EdgeTypeDef {\n  slug: string\n  name: string\n  color: string\n  strokeWidth: number\n  animated: boolean\n  lineStyle: string\n  markerStart: string\n  markerEnd: string\n  fields: NodeTypeFieldDef[]\n}\n\n// ── Type guards ──\n\nexport function isDynamicNode(\n  node: FlowNode,\n): node is FlowNode & { data: DynamicNodeData } {\n  return node.type === 'dynamic'\n}\n\nexport function isFrameNode(\n  node: FlowNode,\n): node is FlowNode & { data: FrameNodeData } {\n  return node.type === 'frame'\n}\n\n// ── Component slot props ──\n\nexport interface DynamicNodeSlotProps {\n  id: string\n  nodeTypeSlug: string\n  label: string\n  fields: Record<string, unknown>\n  nodeTypeDef?: NodeTypeDef\n}\n\n// ── Frame node data ──\n\nexport interface FrameNodeData {\n  label: string\n  color?: string\n  padding?: number\n  borderStyle?: 'dashed' | 'solid' | 'none'\n  opacity?: number\n}\n","import type { NodeTypeDef } from './types'\n\nexport const BUILT_IN_NODE_TYPES: NodeTypeDef[] = [\n  {\n    slug: 'text',\n    name: 'Text',\n    color: '#e5e7eb',\n    defaultSize: { width: 200, height: 200 },\n    fields: [{ name: 'body', label: 'Body', fieldType: 'textarea' }],\n  },\n  {\n    slug: 'image',\n    name: 'Image',\n    color: '#e5e7eb',\n    transparentBackground: true,\n    defaultSize: { width: 200, height: 200 },\n    fields: [\n      { name: 'image', label: 'Image', fieldType: 'image' },\n      { name: 'alt', label: 'Alt Text', fieldType: 'text' },\n      { name: 'caption', label: 'Caption', fieldType: 'text' },\n    ],\n  },\n]\n","import type { EdgeTypeDef } from './types'\n\nexport const BUILT_IN_EDGE_TYPES: EdgeTypeDef[] = [\n  {\n    slug: 'default',\n    name: 'Default',\n    color: '',\n    strokeWidth: 2,\n    animated: false,\n    lineStyle: 'default',\n    markerStart: 'none',\n    markerEnd: 'arrow',\n    fields: [],\n  },\n]\n","'use client'\n\nimport { useQuery, type QueryClient } from '@tanstack/react-query'\nimport { useMemo } from 'react'\nimport type { CanvasData, NodeTypeDef, EdgeTypeDef } from './types'\nimport { BUILT_IN_NODE_TYPES } from './built-in-node-types'\nimport { BUILT_IN_EDGE_TYPES } from './built-in-edge-types'\nimport { collectionKeys } from '../../core/query/query-keys'\n\n// ── Client interface ──\n// Structurally compatible with both BrowserClient and ServerClient.\n// Lists only the collections useFlow actually queries so the generic\n// `from<T extends PublicCollection>` on the real clients satisfies this.\n\ntype FlowCollection = 'flows' | 'flow-node-types' | 'flow-edge-types'\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyFn = (...args: any[]) => any\n\nexport interface SDKClient {\n  from(collection: FlowCollection): {\n    find: AnyFn\n    findById: AnyFn\n  }\n  queryClient: QueryClient\n}\n\n// ── Options & Result ──\n\nexport interface UseFlowOptions {\n  /** SDK client instance (BrowserClient or ServerClient) */\n  client: SDKClient\n  /** Flow slug (URL-friendly identifier) */\n  slug?: string\n  /** Flow document ID (UUID) */\n  id?: string\n  /** Enable/disable data fetching (default: true) */\n  enabled?: boolean\n}\n\nexport interface UseFlowResult {\n  data: CanvasData | undefined\n  nodeTypeDefs: NodeTypeDef[]\n  edgeTypeDefs: EdgeTypeDef[]\n  flow: Record<string, unknown> | undefined\n  isLoading: boolean\n  error: Error | null\n}\n\n// ── Helpers ──\n\nfunction toNodeTypeDef(doc: Record<string, unknown>): NodeTypeDef {\n  return {\n    slug: String(doc.slug ?? ''),\n    name: String(doc.title ?? ''),\n    color: String(doc.color ?? '#e5e7eb'),\n    defaultSize: (doc.defaultSize as NodeTypeDef['defaultSize']) ?? {\n      width: 200,\n      height: 200,\n    },\n    fields: Array.isArray(doc.fields)\n      ? (doc.fields as NodeTypeDef['fields'])\n      : [],\n    transparentBackground: Boolean(doc.transparentBackground),\n  }\n}\n\nfunction toEdgeTypeDef(doc: Record<string, unknown>): EdgeTypeDef {\n  return {\n    slug: String(doc.slug ?? ''),\n    name: String(doc.title ?? ''),\n    color: String(doc.color ?? ''),\n    strokeWidth: (doc.strokeWidth as number) ?? 2,\n    animated: (doc.animated as boolean) ?? false,\n    lineStyle: String(doc.lineStyle ?? 'default'),\n    markerStart: String(doc.markerStart ?? 'none'),\n    markerEnd: String(doc.markerEnd ?? 'arrow'),\n    fields: Array.isArray(doc.fields)\n      ? (doc.fields as EdgeTypeDef['fields'])\n      : [],\n  }\n}\n\n// ── Hook ──\n\nexport function useFlow(options: UseFlowOptions): UseFlowResult {\n  const { client, slug, id, enabled = true } = options\n  const hasIdentifier = !!(slug || id)\n  const identifier = id ?? slug ?? ''\n\n  // Fetch flow document\n  const flowQuery = useQuery<Record<string, unknown>>(\n    {\n      queryKey: collectionKeys('flows').detail(identifier),\n      queryFn: async () => {\n        if (id) {\n          return client.from('flows').findById(id)\n        }\n        const result = await client.from('flows').find({\n          where: { slug: { equals: slug } },\n          limit: 1,\n        })\n        const doc = result.docs[0]\n        if (!doc) throw new Error(`Flow not found: ${slug}`)\n        return doc\n      },\n      enabled: enabled && hasIdentifier,\n    },\n    client.queryClient,\n  )\n\n  // Fetch tenant's custom node types\n  const nodeTypesQuery = useQuery<Record<string, unknown>[]>(\n    {\n      queryKey: collectionKeys('flow-node-types').lists(),\n      queryFn: async () => {\n        const result = await client.from('flow-node-types').find({ limit: 100 })\n        return result.docs\n      },\n      enabled,\n    },\n    client.queryClient,\n  )\n\n  // Fetch tenant's custom edge types\n  const edgeTypesQuery = useQuery<Record<string, unknown>[]>(\n    {\n      queryKey: collectionKeys('flow-edge-types').lists(),\n      queryFn: async () => {\n        const result = await client.from('flow-edge-types').find({ limit: 100 })\n        return result.docs\n      },\n      enabled,\n    },\n    client.queryClient,\n  )\n\n  // Merge built-in + API node types\n  const nodeTypeDefs = useMemo<NodeTypeDef[]>(() => {\n    const apiDefs = (nodeTypesQuery.data ?? []).map(toNodeTypeDef)\n    const builtInSlugs = new Set(BUILT_IN_NODE_TYPES.map((t) => t.slug))\n    const customDefs = apiDefs.filter((d) => !builtInSlugs.has(d.slug))\n    return [...BUILT_IN_NODE_TYPES, ...customDefs]\n  }, [nodeTypesQuery.data])\n\n  // Merge built-in + API edge types\n  const edgeTypeDefs = useMemo<EdgeTypeDef[]>(() => {\n    const apiDefs = (edgeTypesQuery.data ?? []).map(toEdgeTypeDef)\n    const builtInSlugs = new Set(BUILT_IN_EDGE_TYPES.map((t) => t.slug))\n    const customDefs = apiDefs.filter((d) => !builtInSlugs.has(d.slug))\n    return [...BUILT_IN_EDGE_TYPES, ...customDefs]\n  }, [edgeTypesQuery.data])\n\n  const flow = flowQuery.data\n  const canvas = flow?.canvas as CanvasData | undefined\n\n  return {\n    data: canvas,\n    nodeTypeDefs,\n    edgeTypeDefs,\n    flow,\n    isLoading:\n      flowQuery.isLoading ||\n      nodeTypesQuery.isLoading ||\n      edgeTypesQuery.isLoading,\n    error:\n      (flowQuery.error as Error | null) ??\n      (nodeTypesQuery.error as Error | null) ??\n      (edgeTypesQuery.error as Error | null),\n  }\n}\n","import type { PublicCollection, ApiQueryOptions } from '../client/types'\n\nexport function collectionKeys<T extends PublicCollection>(collection: T) {\n  return {\n    all: [collection] as const,\n    lists: () => [collection, 'list'] as const,\n    list: (options?: ApiQueryOptions) => [collection, 'list', options] as const,\n    details: () => [collection, 'detail'] as const,\n    detail: (id: string, options?: ApiQueryOptions) =>\n      [collection, 'detail', id, options] as const,\n    infinites: () => [collection, 'infinite'] as const,\n    infinite: (options?: Omit<ApiQueryOptions, 'page'>) =>\n      [collection, 'infinite', options] as const,\n  }\n}\n\nexport const customerKeys = {\n  all: ['customer'] as const,\n  me: () => ['customer', 'me'] as const,\n}\n"],"mappings":"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","names":["import_react","_a","React","_a"]}
+{"version":3,"sources":["../../src/ui/Flow/index.tsx","../../src/ui/Flow/types.ts","../../src/ui/Flow/built-in-node-types.ts","../../src/ui/Flow/built-in-edge-types.ts","../../src/ui/Flow/useFlow.ts","../../src/core/query/query-keys.ts","../../src/ui/Flow/useFlowData.ts","../../src/ui/Flow/utils.ts"],"sourcesContent":["'use client'\n\nimport React from 'react'\nimport {\n  ReactFlow,\n  ReactFlowProvider,\n  Background,\n  Controls,\n  MiniMap,\n  MarkerType,\n  useReactFlow,\n  type NodeTypes,\n  type NodeProps,\n  type Edge,\n} from '@xyflow/react'\nimport type {\n  CanvasData,\n  DynamicNodeData,\n  DynamicNodeSlotProps,\n  EdgeSlotProps,\n  EdgeTypeDef,\n  FlowBounds,\n  FlowEdge,\n  FlowNode,\n  FlowViewport,\n  FrameNodeData,\n  FrameNodeSlotProps,\n  NodeTypeDef,\n  NodeTypeFieldDef,\n  NodeWrapperSlotProps,\n} from './types'\n\nexport type {\n  CanvasData,\n  DynamicNodeSlotProps,\n  FlowNode,\n  FlowEdge,\n  FlowViewport,\n  FlowNodePosition,\n  FlowNodeData,\n  DynamicNodeData,\n  FrameNodeData,\n  NodeTypeDef,\n  NodeTypeFieldDef,\n  EdgeTypeDef,\n  FrameNodeSlotProps,\n  EdgeSlotProps,\n  NodeWrapperSlotProps,\n  FlowBounds,\n} from './types'\nexport { isDynamicNode, isFrameNode } from './types'\nexport { BUILT_IN_NODE_TYPES } from './built-in-node-types'\nexport { BUILT_IN_EDGE_TYPES } from './built-in-edge-types'\nexport { useFlow } from './useFlow'\nexport type { SDKClient, UseFlowOptions, UseFlowResult } from './useFlow'\nexport { useFlowData } from './useFlowData'\nexport type { UseFlowDataOptions, UseFlowDataResult } from './useFlowData'\nexport { getNodeBounds, getFrames } from './utils'\n\n// ── Helpers ──\n\nfunction sanitizeUrl(url: string | undefined): string | undefined {\n  if (!url) return url\n  try {\n    const parsed = new URL(url)\n    if (parsed.protocol === 'http:' || parsed.protocol === 'https:') return url\n    return undefined\n  } catch {\n    return undefined\n  }\n}\n\nfunction toMarkerType(value: string): MarkerType | undefined {\n  if (value === 'arrow') return MarkerType.Arrow\n  if (value === 'arrowclosed') return MarkerType.ArrowClosed\n  return undefined\n}\n\n// ── Field renderer (type-aware, matching console style) ──\n\nfunction renderFieldValue(\n  key: string,\n  val: unknown,\n  fieldDef?: NodeTypeFieldDef,\n): React.ReactNode {\n  if (val == null || val === '') return null\n\n  const fieldType = fieldDef?.fieldType\n\n  // Image field — image only, no decoration\n  if (\n    fieldType === 'image' ||\n    (typeof val === 'object' && val !== null && 'url' in val)\n  ) {\n    const imgUrl =\n      typeof val === 'string' ? val : (val as { url?: string })?.url\n    const safeUrl = sanitizeUrl(imgUrl)\n    if (!safeUrl) return null\n    return (\n      <img\n        key={key}\n        src={safeUrl}\n        alt=\"\"\n        draggable={false}\n        style={{ flex: 1, minHeight: 0, width: '100%', objectFit: 'contain' }}\n      />\n    )\n  }\n\n  // All other fields — text only\n  return (\n    <div\n      key={key}\n      style={{\n        fontSize: 11,\n        whiteSpace: 'pre-wrap',\n        wordBreak: 'break-word',\n        overflow: 'hidden',\n        flexShrink: 0,\n      }}\n    >\n      {String(val)}\n    </div>\n  )\n}\n\n// ── Default dynamic node renderer (no typeDef) ──\n\nfunction DefaultDynamicNode({ data }: NodeProps) {\n  const d = data as unknown as DynamicNodeData\n  return (\n    <div\n      style={{\n        width: '100%',\n        height: '100%',\n        display: 'flex',\n        flexDirection: 'column',\n      }}\n    >\n      {d.fields &&\n        Object.entries(d.fields)\n          .filter(([, v]) => v != null && v !== '')\n          .map(([key, val]) => renderFieldValue(key, val))}\n    </div>\n  )\n}\n\n// ── Enhanced dynamic node renderer (with NodeTypeDef) ──\n\nfunction EnhancedDynamicNode({\n  data,\n  typeDef,\n}: {\n  data: DynamicNodeData\n  typeDef: NodeTypeDef\n}) {\n  return (\n    <div\n      style={{\n        width: '100%',\n        height: '100%',\n        display: 'flex',\n        flexDirection: 'column',\n      }}\n    >\n      {typeDef.fields.map((f) => {\n        const val = data.fields[f.name]\n        if (val == null || val === '') return null\n        return renderFieldValue(f.name, val, f)\n      })}\n    </div>\n  )\n}\n\n// ── Default frame node renderer ──\n\nfunction DefaultFrameNode({ data }: NodeProps) {\n  const d = data as unknown as FrameNodeData\n  const baseColor = d.color ?? 'rgba(128,128,128,0.15)'\n  const padding = d.padding ?? 20\n  const borderStyle = d.borderStyle ?? 'dashed'\n  const opacity = d.opacity ?? 0.15\n\n  // Apply opacity to rgba colors\n  const bgColor = (() => {\n    const m = baseColor.match(/rgba?\\((\\d+),\\s*(\\d+),\\s*(\\d+)/)\n    if (m) return `rgba(${m[1]},${m[2]},${m[3]},${opacity})`\n    return baseColor\n  })()\n\n  return (\n    <div\n      style={{\n        backgroundColor: bgColor,\n        padding,\n        width: '100%',\n        height: '100%',\n        border:\n          borderStyle === 'none'\n            ? 'none'\n            : `2px ${borderStyle} rgba(128,128,128,0.3)`,\n      }}\n    >\n      <div\n        style={{\n          fontSize: 11,\n          fontWeight: 600,\n          color: 'rgba(128,128,128,0.6)',\n          userSelect: 'none',\n        }}\n      >\n        {d.label}\n      </div>\n    </div>\n  )\n}\n\n// ── Node types builder ──\n\nfunction createNodeTypes(\n  nodeRenderers?: Record<string, React.ComponentType<DynamicNodeSlotProps>>,\n  nodeTypeDefsMap?: Map<string, NodeTypeDef>,\n  frameRenderer?: React.ComponentType<FrameNodeSlotProps>,\n  nodeWrapper?: React.ComponentType<NodeWrapperSlotProps>,\n  renderNode?: (props: DynamicNodeSlotProps, defaultRender: React.ReactElement) => React.ReactElement | null,\n): NodeTypes {\n  const types: NodeTypes = {} as NodeTypes\n\n  // Dynamic node type\n  types.dynamic = ((props: NodeProps) => {\n    const d = props.data as unknown as DynamicNodeData\n    const typeDef = nodeTypeDefsMap?.get(d.nodeTypeSlug)\n    const CustomRenderer = nodeRenderers?.[d.nodeTypeSlug]\n\n    let content: React.ReactElement\n    if (CustomRenderer) {\n      content = (\n        <CustomRenderer\n          id={props.id}\n          nodeTypeSlug={d.nodeTypeSlug}\n          label={d.label}\n          fields={d.fields}\n          nodeTypeDef={typeDef}\n        />\n      )\n    } else if (typeDef) {\n      content = <EnhancedDynamicNode data={d} typeDef={typeDef} />\n    } else {\n      content = <DefaultDynamicNode {...props} />\n    }\n\n    // S5: renderNode global callback\n    if (renderNode) {\n      const slotProps: DynamicNodeSlotProps = {\n        id: props.id,\n        nodeTypeSlug: d.nodeTypeSlug,\n        label: d.label,\n        fields: d.fields,\n        nodeTypeDef: typeDef,\n      }\n      const result = renderNode(slotProps, content)\n      if (result !== null) content = result\n    }\n\n    // S3: nodeWrapper\n    if (nodeWrapper) {\n      const Wrapper = nodeWrapper\n      content = (\n        <Wrapper\n          id={props.id}\n          nodeTypeSlug={d.nodeTypeSlug}\n          label={d.label}\n          selected={props.selected}\n          nodeTypeDef={typeDef}\n        >\n          {content}\n        </Wrapper>\n      )\n    }\n\n    return content\n  }) as NodeTypes[string]\n\n  // S1: Frame node type — custom or default\n  types.frame = frameRenderer\n    ? (((props: NodeProps) => {\n        const d = props.data as unknown as FrameNodeData\n        const Renderer = frameRenderer\n        return (\n          <Renderer\n            id={props.id}\n            label={d.label}\n            color={d.color}\n            padding={d.padding}\n            borderStyle={d.borderStyle}\n            opacity={d.opacity}\n          />\n        )\n      }) as NodeTypes[string])\n    : (DefaultFrameNode as NodeTypes[string])\n\n  return types\n}\n\n// S2: Edge types builder\n\nfunction createEdgeTypes(\n  edgeRenderers?: Record<string, React.ComponentType<EdgeSlotProps>>,\n  edgeTypeDefsMap?: Map<string, EdgeTypeDef>,\n): Record<string, React.ComponentType<EdgeSlotProps>> | undefined {\n  if (!edgeRenderers || Object.keys(edgeRenderers).length === 0) return undefined\n  const types: Record<string, React.ComponentType<EdgeSlotProps>> = {}\n  for (const [slug, Renderer] of Object.entries(edgeRenderers)) {\n    types[slug] = ((props: Record<string, unknown>) => {\n      const def = edgeTypeDefsMap?.get(slug)\n      return (\n        <Renderer\n          id={props.id as string}\n          edgeTypeSlug={slug}\n          source={props.source as string}\n          target={props.target as string}\n          label={props.label as string | undefined}\n          fields={(props.data as Record<string, unknown> | undefined)?.fields as Record<string, unknown> | undefined}\n          edgeTypeDef={def}\n          style={props.style as React.CSSProperties | undefined}\n        />\n      )\n    }) as unknown as React.ComponentType<EdgeSlotProps>\n  }\n  return types\n}\n\n// S8: FocusHandler — must be inside ReactFlowProvider\n\nfunction FocusHandler({\n  bounds,\n  padding,\n  animation,\n}: {\n  bounds: FlowBounds\n  padding: number\n  animation: boolean | number\n}) {\n  const { fitBounds } = useReactFlow()\n  const boundsKey = `${bounds.x},${bounds.y},${bounds.width},${bounds.height}`\n  const boundsRef = React.useRef(bounds)\n  boundsRef.current = bounds\n  React.useEffect(() => {\n    const duration =\n      animation === true ? 300 : typeof animation === 'number' ? animation : 0\n    fitBounds(boundsRef.current, { padding, duration })\n  }, [boundsKey, padding, animation, fitBounds])\n  return null\n}\n\n// ── Edge style resolver ──\n\nconst EDGE_TYPE_MAP: Record<string, string> = {\n  step: 'step',\n  smoothstep: 'smoothstep',\n  bezier: 'default',\n  default: 'default',\n}\n\nfunction applyEdgeStyles(\n  edges: FlowEdge[],\n  edgeTypeDefsMap?: Map<string, EdgeTypeDef>,\n): Edge[] {\n  if (!edgeTypeDefsMap?.size) return edges as unknown as Edge[]\n\n  return edges.map((edge) => {\n    const slug = edge.edgeTypeSlug\n    if (!slug) return edge as unknown as Edge\n\n    const def = edgeTypeDefsMap.get(slug)\n    if (!def) return edge as unknown as Edge\n\n    const styled: Edge = { ...(edge as unknown as Edge) }\n\n    // Edge type (line style) — canvas value takes precedence\n    if (!styled.type && def.lineStyle) {\n      styled.type = EDGE_TYPE_MAP[def.lineStyle] ?? 'default'\n    }\n\n    // Visual style — canvas style merged with def as fallback\n    styled.style = {\n      ...(def.color ? { stroke: def.color } : undefined),\n      ...(def.strokeWidth ? { strokeWidth: def.strokeWidth } : undefined),\n      ...edge.style,\n    }\n\n    // Animation — canvas value takes precedence\n    if (styled.animated == null && def.animated) styled.animated = true\n\n    // Markers — canvas value takes precedence over def\n    if (!styled.markerStart) {\n      const startType = toMarkerType(def.markerStart)\n      if (startType) {\n        styled.markerStart = {\n          type: startType,\n          ...(def.color ? { color: def.color } : undefined),\n        }\n      }\n    }\n    if (!styled.markerEnd) {\n      const endType = toMarkerType(def.markerEnd)\n      if (endType) {\n        styled.markerEnd = {\n          type: endType,\n          ...(def.color ? { color: def.color } : undefined),\n        }\n      }\n    }\n\n    return styled\n  })\n}\n\n// ── FlowRenderer ──\n\n/**\n * Renders a Flow canvas in read-only mode.\n *\n * Requires `@xyflow/react` peer dependency and its CSS:\n * ```ts\n * import '@xyflow/react/dist/style.css'\n * ```\n */\nexport interface FlowRendererProps {\n  /** Canvas data from Flow document's `canvas` field */\n  data: CanvasData\n  /** Container className */\n  className?: string\n  /** Container style */\n  style?: React.CSSProperties\n  /** Custom renderers by node type slug (e.g., `{ 'product-card': MyProductCard }`) */\n  nodeRenderers?: Record<string, React.ComponentType<DynamicNodeSlotProps>>\n  /** Node type definitions for enhanced rendering (field-type-aware display) */\n  nodeTypeDefs?: NodeTypeDef[]\n  /** Edge type definitions for styled edges (color, stroke, markers, animation) */\n  edgeTypeDefs?: EdgeTypeDef[]\n  /** Show background pattern (default: false) */\n  background?: boolean\n  /** Allow user interaction - pan, zoom (default: false for read-only display) */\n  interactive?: boolean\n  /** Fit view on mount (default: true) */\n  fitView?: boolean\n  /** Called when a node is clicked */\n  onNodeClick?: (event: React.MouseEvent, node: FlowNode) => void\n  /** Called when an edge is clicked */\n  onEdgeClick?: (event: React.MouseEvent, edge: FlowEdge) => void\n  /** S1: Custom frame node renderer. Should be a stable reference (memoize or define outside render). */\n  frameRenderer?: React.ComponentType<FrameNodeSlotProps>\n  /** S2: Custom edge renderers by edge type slug. Should be a stable reference (memoize or define outside render). */\n  edgeRenderers?: Record<string, React.ComponentType<EdgeSlotProps>>\n  /** S3: Wraps every dynamic node's rendered content. Should be a stable reference (memoize or define outside render). */\n  nodeWrapper?: React.ComponentType<NodeWrapperSlotProps>\n  /** S4: Show controls (default: false) */\n  controls?: boolean\n  /** S4: Show minimap (default: false) */\n  minimap?: boolean\n  /** S4: Custom minimap node color function */\n  minimapNodeColor?: (node: FlowNode) => string\n  /** S4: Additional children rendered inside ReactFlow */\n  children?: React.ReactNode\n  /** S5: Global override for all dynamic nodes. Should be a stable reference (memoize or define outside render). */\n  renderNode?: (props: DynamicNodeSlotProps, defaultRender: React.ReactElement) => React.ReactElement | null\n  /** S6: Called when viewport changes (pan/zoom) */\n  onViewportChange?: (viewport: FlowViewport) => void\n  /** S6: Default viewport (used when fitView is false) */\n  defaultViewport?: FlowViewport\n  /** S8: Focus on specific bounds */\n  bounds?: FlowBounds\n  /** S8: Padding for focus bounds (default: 0.1) */\n  focusPadding?: number\n  /** S8: Animate focus transition (true=300ms, number=custom ms, false=instant) */\n  focusAnimation?: boolean | number\n}\n\nexport function FlowRenderer({\n  data,\n  className,\n  style,\n  nodeRenderers,\n  nodeTypeDefs,\n  edgeTypeDefs,\n  background = false,\n  interactive = false,\n  fitView = true,\n  onNodeClick,\n  onEdgeClick,\n  frameRenderer,\n  edgeRenderers,\n  nodeWrapper,\n  controls,\n  minimap,\n  minimapNodeColor,\n  children,\n  renderNode,\n  onViewportChange,\n  defaultViewport: defaultViewportProp,\n  bounds,\n  focusPadding,\n  focusAnimation,\n}: FlowRendererProps) {\n  const nodeTypeDefsMap = React.useMemo(() => {\n    if (!nodeTypeDefs?.length) return undefined\n    return new Map(nodeTypeDefs.map((d) => [d.slug, d]))\n  }, [nodeTypeDefs])\n\n  const edgeTypeDefsMap = React.useMemo(() => {\n    if (!edgeTypeDefs?.length) return undefined\n    return new Map(edgeTypeDefs.map((d) => [d.slug, d]))\n  }, [edgeTypeDefs])\n\n  const nodeTypes = React.useMemo(\n    () => createNodeTypes(nodeRenderers, nodeTypeDefsMap, frameRenderer, nodeWrapper, renderNode),\n    [nodeRenderers, nodeTypeDefsMap, frameRenderer, nodeWrapper, renderNode],\n  )\n\n  // S2: Custom edge types\n  const customEdgeTypes = React.useMemo(\n    () => createEdgeTypes(edgeRenderers, edgeTypeDefsMap),\n    [edgeRenderers, edgeTypeDefsMap],\n  )\n\n  const styledEdges = React.useMemo(() => {\n    let edges = applyEdgeStyles(data?.edges ?? [], edgeTypeDefsMap)\n    // When custom edge renderers exist, set edge type to slug for matching\n    if (edgeRenderers) {\n      edges = edges.map((edge) => {\n        const slug = (edge as unknown as FlowEdge).edgeTypeSlug\n        if (slug && edgeRenderers[slug]) {\n          return { ...edge, type: slug }\n        }\n        return edge\n      })\n    }\n    return edges\n  }, [data?.edges, edgeTypeDefsMap, edgeRenderers])\n\n  if (!data) return null\n\n  const resolvedDefaultViewport =\n    defaultViewportProp ?? (!fitView && data.viewport ? data.viewport : undefined)\n\n  return (\n    <ReactFlowProvider>\n      <div\n        className={className}\n        style={{ width: '100%', height: '100%', ...style }}\n      >\n        <ReactFlow\n          nodes={\n            (data.nodes ?? []) as unknown as Parameters<\n              typeof ReactFlow\n            >[0]['nodes']\n          }\n          edges={styledEdges}\n          nodeTypes={nodeTypes}\n          edgeTypes={customEdgeTypes as Parameters<typeof ReactFlow>[0]['edgeTypes']}\n          defaultViewport={resolvedDefaultViewport}\n          fitView={fitView}\n          onNodeClick={\n            onNodeClick as Parameters<typeof ReactFlow>[0]['onNodeClick']\n          }\n          onEdgeClick={\n            onEdgeClick as Parameters<typeof ReactFlow>[0]['onEdgeClick']\n          }\n          onMoveEnd={\n            onViewportChange\n              ? ((_: unknown, vp: { x: number; y: number; zoom: number }) => {\n                  onViewportChange(vp)\n                }) as Parameters<typeof ReactFlow>[0]['onMoveEnd']\n              : undefined\n          }\n          nodesDraggable={interactive ? undefined : false}\n          nodesConnectable={false}\n          elementsSelectable={interactive || !!onNodeClick || !!onEdgeClick}\n          panOnDrag={interactive}\n          zoomOnScroll={interactive}\n          zoomOnPinch={interactive}\n          zoomOnDoubleClick={false}\n        >\n          {background && <Background />}\n          {controls && <Controls />}\n          {minimap && (\n            <MiniMap\n              nodeColor={\n                minimapNodeColor as Parameters<typeof MiniMap>[0]['nodeColor']\n              }\n            />\n          )}\n          {bounds && (\n            <FocusHandler\n              bounds={bounds}\n              padding={focusPadding ?? 0.1}\n              animation={focusAnimation ?? true}\n            />\n          )}\n          {children}\n        </ReactFlow>\n      </div>\n    </ReactFlowProvider>\n  )\n}\n","import type React from 'react'\n\n// ── Dynamic node data ──\n\nexport interface DynamicNodeData {\n  nodeTypeSlug: string\n  label: string\n  fields: Record<string, unknown>\n}\n\nexport type FlowNodeData = (DynamicNodeData | FrameNodeData) &\n  Record<string, unknown>\n\n// ── Canvas types (mirrors @xyflow/react but standalone) ──\n\nexport interface FlowNodePosition {\n  x: number\n  y: number\n}\n\nexport interface FlowNode {\n  id: string\n  type?: string\n  position: FlowNodePosition\n  data: FlowNodeData\n  style?: React.CSSProperties\n  width?: number\n  height?: number\n  measured?: { width?: number; height?: number }\n  draggable?: boolean\n  selectable?: boolean\n  [key: string]: unknown\n}\n\nexport interface FlowEdge {\n  id: string\n  source: string\n  target: string\n  sourceHandle?: string | null\n  targetHandle?: string | null\n  type?: string\n  style?: React.CSSProperties\n  animated?: boolean\n  markerStart?: unknown\n  markerEnd?: unknown\n  edgeTypeSlug?: string\n  fields?: Record<string, unknown>\n  [key: string]: unknown\n}\n\nexport interface FlowViewport {\n  x: number\n  y: number\n  zoom: number\n}\n\nexport interface CanvasData {\n  nodes: FlowNode[]\n  edges: FlowEdge[]\n  viewport: FlowViewport\n}\n\n// ── Node type definitions (mirrors console's NodeTypeDef) ──\n\nexport interface NodeTypeFieldDef {\n  name: string\n  label: string\n  fieldType:\n    | 'text'\n    | 'textarea'\n    | 'number'\n    | 'url'\n    | 'color'\n    | 'image'\n    | 'select'\n    | 'toggle'\n  options?: { label: string; value: string }[]\n  defaultValue?: string\n  required?: boolean\n}\n\nexport interface NodeTypeDef {\n  slug: string\n  name: string\n  color: string\n  defaultSize: { width: number; height: number }\n  fields: NodeTypeFieldDef[]\n  transparentBackground?: boolean\n}\n\n// ── Edge type definitions (mirrors console's EdgeTypeDef) ──\n\nexport interface EdgeTypeDef {\n  slug: string\n  name: string\n  color: string\n  strokeWidth: number\n  animated: boolean\n  lineStyle: string\n  markerStart: string\n  markerEnd: string\n  fields: NodeTypeFieldDef[]\n}\n\n// ── Type guards ──\n\nexport function isDynamicNode(\n  node: FlowNode,\n): node is FlowNode & { data: DynamicNodeData } {\n  return node.type === 'dynamic'\n}\n\nexport function isFrameNode(\n  node: FlowNode,\n): node is FlowNode & { data: FrameNodeData } {\n  return node.type === 'frame'\n}\n\n// ── Component slot props ──\n\nexport interface DynamicNodeSlotProps {\n  id: string\n  nodeTypeSlug: string\n  label: string\n  fields: Record<string, unknown>\n  nodeTypeDef?: NodeTypeDef\n}\n\n// ── Frame node data ──\n\nexport interface FrameNodeData {\n  label: string\n  color?: string\n  padding?: number\n  borderStyle?: 'dashed' | 'solid' | 'none'\n  opacity?: number\n}\n\n// S1: Frame renderer slot\nexport interface FrameNodeSlotProps {\n  id: string\n  label: string\n  color?: string\n  padding?: number\n  borderStyle?: 'dashed' | 'solid' | 'none'\n  opacity?: number\n  children?: React.ReactNode\n}\n\n// S2: Edge renderer slot\nexport interface EdgeSlotProps {\n  id: string\n  edgeTypeSlug?: string\n  source: string\n  target: string\n  label?: string\n  fields?: Record<string, unknown>\n  edgeTypeDef?: EdgeTypeDef\n  style?: React.CSSProperties\n}\n\n// S3: Node wrapper slot\nexport interface NodeWrapperSlotProps {\n  id: string\n  nodeTypeSlug: string\n  label: string\n  selected?: boolean\n  nodeTypeDef?: NodeTypeDef\n  children: React.ReactNode\n}\n\n// S8: Viewport focus\nexport interface FlowBounds {\n  x: number\n  y: number\n  width: number\n  height: number\n}\n","import type { NodeTypeDef } from './types'\n\nexport const BUILT_IN_NODE_TYPES: NodeTypeDef[] = [\n  {\n    slug: 'text',\n    name: 'Text',\n    color: '#e5e7eb',\n    defaultSize: { width: 200, height: 200 },\n    fields: [{ name: 'body', label: 'Body', fieldType: 'textarea' }],\n  },\n  {\n    slug: 'image',\n    name: 'Image',\n    color: '#e5e7eb',\n    transparentBackground: true,\n    defaultSize: { width: 200, height: 200 },\n    fields: [\n      { name: 'image', label: 'Image', fieldType: 'image' },\n      { name: 'alt', label: 'Alt Text', fieldType: 'text' },\n      { name: 'caption', label: 'Caption', fieldType: 'text' },\n    ],\n  },\n]\n","import type { EdgeTypeDef } from './types'\n\nexport const BUILT_IN_EDGE_TYPES: EdgeTypeDef[] = [\n  {\n    slug: 'default',\n    name: 'Default',\n    color: '',\n    strokeWidth: 2,\n    animated: false,\n    lineStyle: 'default',\n    markerStart: 'none',\n    markerEnd: 'arrow',\n    fields: [],\n  },\n]\n","'use client'\n\nimport { useQuery, type QueryClient } from '@tanstack/react-query'\nimport { useMemo } from 'react'\nimport type { CanvasData, NodeTypeDef, EdgeTypeDef } from './types'\nimport { BUILT_IN_NODE_TYPES } from './built-in-node-types'\nimport { BUILT_IN_EDGE_TYPES } from './built-in-edge-types'\nimport { collectionKeys } from '../../core/query/query-keys'\n\n// ── Client interface ──\n// Structurally compatible with both BrowserClient and ServerClient.\n// Lists only the collections useFlow actually queries so the generic\n// `from<T extends PublicCollection>` on the real clients satisfies this.\n\ntype FlowCollection = 'flows' | 'flow-node-types' | 'flow-edge-types'\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\ntype AnyFn = (...args: any[]) => any\n\nexport interface SDKClient {\n  from(collection: FlowCollection): {\n    find: AnyFn\n    findById: AnyFn\n  }\n  queryClient: QueryClient\n}\n\n// ── Options & Result ──\n\nexport interface UseFlowOptions {\n  /** SDK client instance (BrowserClient or ServerClient) */\n  client: SDKClient\n  /** Flow slug (URL-friendly identifier) */\n  slug?: string\n  /** Flow document ID (UUID) */\n  id?: string\n  /** Enable/disable data fetching (default: true) */\n  enabled?: boolean\n}\n\nexport interface UseFlowResult {\n  data: CanvasData | undefined\n  nodeTypeDefs: NodeTypeDef[]\n  edgeTypeDefs: EdgeTypeDef[]\n  flow: Record<string, unknown> | undefined\n  isLoading: boolean\n  error: Error | null\n}\n\n// ── Helpers ──\n\nfunction toNodeTypeDef(doc: Record<string, unknown>): NodeTypeDef {\n  return {\n    slug: String(doc.slug ?? ''),\n    name: String(doc.title ?? ''),\n    color: String(doc.color ?? '#e5e7eb'),\n    defaultSize: (doc.defaultSize as NodeTypeDef['defaultSize']) ?? {\n      width: 200,\n      height: 200,\n    },\n    fields: Array.isArray(doc.fields)\n      ? (doc.fields as NodeTypeDef['fields'])\n      : [],\n    transparentBackground: Boolean(doc.transparentBackground),\n  }\n}\n\nfunction toEdgeTypeDef(doc: Record<string, unknown>): EdgeTypeDef {\n  return {\n    slug: String(doc.slug ?? ''),\n    name: String(doc.title ?? ''),\n    color: String(doc.color ?? ''),\n    strokeWidth: (doc.strokeWidth as number) ?? 2,\n    animated: (doc.animated as boolean) ?? false,\n    lineStyle: String(doc.lineStyle ?? 'default'),\n    markerStart: String(doc.markerStart ?? 'none'),\n    markerEnd: String(doc.markerEnd ?? 'arrow'),\n    fields: Array.isArray(doc.fields)\n      ? (doc.fields as EdgeTypeDef['fields'])\n      : [],\n  }\n}\n\n// ── Hook ──\n\nexport function useFlow(options: UseFlowOptions): UseFlowResult {\n  const { client, slug, id, enabled = true } = options\n  const hasIdentifier = !!(slug || id)\n  const identifier = id ?? slug ?? ''\n\n  // Fetch flow document\n  const flowQuery = useQuery<Record<string, unknown>>(\n    {\n      queryKey: collectionKeys('flows').detail(identifier),\n      queryFn: async () => {\n        if (id) {\n          return client.from('flows').findById(id)\n        }\n        const result = await client.from('flows').find({\n          where: { slug: { equals: slug } },\n          limit: 1,\n        })\n        const doc = result.docs[0]\n        if (!doc) throw new Error(`Flow not found: ${slug}`)\n        return doc\n      },\n      enabled: enabled && hasIdentifier,\n    },\n    client.queryClient,\n  )\n\n  // Fetch tenant's custom node types\n  const nodeTypesQuery = useQuery<Record<string, unknown>[]>(\n    {\n      queryKey: collectionKeys('flow-node-types').lists(),\n      queryFn: async () => {\n        const result = await client.from('flow-node-types').find({ limit: 100 })\n        return result.docs\n      },\n      enabled,\n    },\n    client.queryClient,\n  )\n\n  // Fetch tenant's custom edge types\n  const edgeTypesQuery = useQuery<Record<string, unknown>[]>(\n    {\n      queryKey: collectionKeys('flow-edge-types').lists(),\n      queryFn: async () => {\n        const result = await client.from('flow-edge-types').find({ limit: 100 })\n        return result.docs\n      },\n      enabled,\n    },\n    client.queryClient,\n  )\n\n  // Merge built-in + API node types\n  const nodeTypeDefs = useMemo<NodeTypeDef[]>(() => {\n    const apiDefs = (nodeTypesQuery.data ?? []).map(toNodeTypeDef)\n    const builtInSlugs = new Set(BUILT_IN_NODE_TYPES.map((t) => t.slug))\n    const customDefs = apiDefs.filter((d) => !builtInSlugs.has(d.slug))\n    return [...BUILT_IN_NODE_TYPES, ...customDefs]\n  }, [nodeTypesQuery.data])\n\n  // Merge built-in + API edge types\n  const edgeTypeDefs = useMemo<EdgeTypeDef[]>(() => {\n    const apiDefs = (edgeTypesQuery.data ?? []).map(toEdgeTypeDef)\n    const builtInSlugs = new Set(BUILT_IN_EDGE_TYPES.map((t) => t.slug))\n    const customDefs = apiDefs.filter((d) => !builtInSlugs.has(d.slug))\n    return [...BUILT_IN_EDGE_TYPES, ...customDefs]\n  }, [edgeTypesQuery.data])\n\n  const flow = flowQuery.data\n  const canvas = flow?.canvas as CanvasData | undefined\n\n  return {\n    data: canvas,\n    nodeTypeDefs,\n    edgeTypeDefs,\n    flow,\n    isLoading:\n      flowQuery.isLoading ||\n      nodeTypesQuery.isLoading ||\n      edgeTypesQuery.isLoading,\n    error:\n      (flowQuery.error as Error | null) ??\n      (nodeTypesQuery.error as Error | null) ??\n      (edgeTypesQuery.error as Error | null),\n  }\n}\n","import type { PublicCollection, ApiQueryOptions } from '../client/types'\n\nexport function collectionKeys<T extends PublicCollection>(collection: T) {\n  return {\n    all: [collection] as const,\n    lists: () => [collection, 'list'] as const,\n    list: (options?: ApiQueryOptions) => [collection, 'list', options] as const,\n    details: () => [collection, 'detail'] as const,\n    detail: (id: string, options?: ApiQueryOptions) =>\n      [collection, 'detail', id, options] as const,\n    infinites: () => [collection, 'infinite'] as const,\n    infinite: (options?: Omit<ApiQueryOptions, 'page'>) =>\n      [collection, 'infinite', options] as const,\n  }\n}\n\nexport const customerKeys = {\n  all: ['customer'] as const,\n  me: () => ['customer', 'me'] as const,\n}\n","import { useMemo } from 'react'\nimport type { CanvasData, FlowNode, NodeTypeDef, EdgeTypeDef } from './types'\nimport type { Edge } from '@xyflow/react'\nimport { BUILT_IN_NODE_TYPES } from './built-in-node-types'\nimport { BUILT_IN_EDGE_TYPES } from './built-in-edge-types'\n\n// ── Options & Result ──\n\nexport interface UseFlowDataOptions {\n  /** Canvas data from Flow document's `canvas` field */\n  data: CanvasData | undefined\n  /** Node type definitions (defaults to built-in types) */\n  nodeTypeDefs?: NodeTypeDef[]\n  /** Edge type definitions (defaults to built-in types) */\n  edgeTypeDefs?: EdgeTypeDef[]\n}\n\nexport interface UseFlowDataResult {\n  /** Nodes from canvas data */\n  nodes: FlowNode[]\n  /** Edges from canvas data (typed for @xyflow/react) */\n  edges: Edge[]\n  /** Map of node type slug to definition */\n  nodeTypeDefsMap: Map<string, NodeTypeDef>\n  /** Map of edge type slug to definition */\n  edgeTypeDefsMap: Map<string, EdgeTypeDef>\n}\n\n/**\n * Pure data transformation hook — extracts nodes, edges, and type definition\n * maps from canvas data without any rendering. Useful for headless usage\n * (custom layouts, analytics, server-side processing).\n */\nexport function useFlowData(options: UseFlowDataOptions): UseFlowDataResult {\n  const { data, nodeTypeDefs: inputNodeDefs, edgeTypeDefs: inputEdgeDefs } =\n    options\n\n  const nodeTypeDefsMap = useMemo(() => {\n    const allDefs = inputNodeDefs ?? BUILT_IN_NODE_TYPES\n    return new Map(allDefs.map((d) => [d.slug, d]))\n  }, [inputNodeDefs])\n\n  const edgeTypeDefsMap = useMemo(() => {\n    const allDefs = inputEdgeDefs ?? BUILT_IN_EDGE_TYPES\n    return new Map(allDefs.map((d) => [d.slug, d]))\n  }, [inputEdgeDefs])\n\n  const nodes = useMemo(() => data?.nodes ?? [], [data?.nodes])\n  const edges = useMemo(() => (data?.edges ?? []) as unknown as Edge[], [data?.edges])\n\n  return {\n    nodes,\n    edges,\n    nodeTypeDefsMap,\n    edgeTypeDefsMap,\n  }\n}\n","import type { FlowNode, FlowBounds } from './types'\n\n/**\n * Calculate bounding box for given node IDs.\n * Pure function — usable in SSR, server components, or outside React.\n */\nexport function getNodeBounds(\n  nodes: FlowNode[],\n  nodeIds: string[],\n): FlowBounds | undefined {\n  const idSet = new Set(nodeIds)\n  const targetNodes = nodes.filter((n) => idSet.has(n.id))\n  if (targetNodes.length === 0) return undefined\n\n  // Build parent map for absolute position calculation\n  const nodeMap = new Map(nodes.map((n) => [n.id, n]))\n\n  function getAbsolutePosition(node: FlowNode): { x: number; y: number } {\n    let x = node.position.x\n    let y = node.position.y\n    let current = node\n    const visited = new Set<string>([node.id])\n    while (current.parentId as string | undefined) {\n      const parentId = current.parentId as string\n      if (visited.has(parentId)) break\n      const parent = nodeMap.get(parentId)\n      if (!parent) break\n      visited.add(parent.id)\n      x += parent.position.x\n      y += parent.position.y\n      current = parent\n    }\n    return { x, y }\n  }\n\n  let minX = Infinity\n  let minY = Infinity\n  let maxX = -Infinity\n  let maxY = -Infinity\n\n  for (const node of targetNodes) {\n    const abs = getAbsolutePosition(node)\n    const w =\n      (node.style?.width as number) ??\n      node.measured?.width ??\n      node.width ??\n      200\n    const h =\n      (node.style?.height as number) ??\n      node.measured?.height ??\n      node.height ??\n      200\n    minX = Math.min(minX, abs.x)\n    minY = Math.min(minY, abs.y)\n    maxX = Math.max(maxX, abs.x + w)\n    maxY = Math.max(maxY, abs.y + h)\n  }\n\n  return { x: minX, y: minY, width: maxX - minX, height: maxY - minY }\n}\n\n/**\n * Get all frame nodes with their bounds.\n * Sorted by position (top-left to bottom-right).\n * Builds a single nodeMap to compute absolute positions (O(F) instead of O(F*N)).\n */\nexport function getFrames(\n  nodes: FlowNode[],\n): Array<{ id: string; label: string; bounds: FlowBounds }> {\n  const frames = nodes.filter((n) => n.type === 'frame')\n  if (frames.length === 0) return []\n\n  const nodeMap = new Map(nodes.map((n) => [n.id, n]))\n\n  function getAbsolutePosition(node: FlowNode): { x: number; y: number } {\n    let x = node.position.x\n    let y = node.position.y\n    let current = node\n    const visited = new Set<string>([node.id])\n    while (current.parentId as string | undefined) {\n      const parentId = current.parentId as string\n      if (visited.has(parentId)) break\n      const parent = nodeMap.get(parentId)\n      if (!parent) break\n      visited.add(parent.id)\n      x += parent.position.x\n      y += parent.position.y\n      current = parent\n    }\n    return { x, y }\n  }\n\n  return frames\n    .map((f) => {\n      const data = f.data as { label?: string }\n      const abs = getAbsolutePosition(f)\n      const w = (f.style?.width as number) ?? f.measured?.width ?? f.width ?? 200\n      const h = (f.style?.height as number) ?? f.measured?.height ?? f.height ?? 200\n      return { id: f.id, label: data.label ?? '', bounds: { x: abs.x, y: abs.y, width: w, height: h } }\n    })\n    .sort((a, b) => a.bounds.y - b.bounds.y || a.bounds.x - b.bounds.x)\n}\n"],"mappings":"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","names":["import_react","_a","import_react","React","_a"]}

package/dist/ui/flow.d.cts

@@ -1,12 +1,13 @@
 import React from 'react';
 import { QueryClient } from '@tanstack/react-query';
+import { Edge } from '@xyflow/react';
 
 interface DynamicNodeData {
     nodeTypeSlug: string;
     label: string;
     fields: Record<string, unknown>;
 }
-type FlowNodeData = DynamicNodeData & Record<string, unknown>;
+type FlowNodeData = (DynamicNodeData | FrameNodeData) & Record<string, unknown>;
 interface FlowNodePosition {
     x: number;
     y: number;
@@ -105,6 +106,39 @@ interface FrameNodeData {
     borderStyle?: 'dashed' | 'solid' | 'none';
     opacity?: number;
 }
+interface FrameNodeSlotProps {
+    id: string;
+    label: string;
+    color?: string;
+    padding?: number;
+    borderStyle?: 'dashed' | 'solid' | 'none';
+    opacity?: number;
+    children?: React.ReactNode;
+}
+interface EdgeSlotProps {
+    id: string;
+    edgeTypeSlug?: string;
+    source: string;
+    target: string;
+    label?: string;
+    fields?: Record<string, unknown>;
+    edgeTypeDef?: EdgeTypeDef;
+    style?: React.CSSProperties;
+}
+interface NodeWrapperSlotProps {
+    id: string;
+    nodeTypeSlug: string;
+    label: string;
+    selected?: boolean;
+    nodeTypeDef?: NodeTypeDef;
+    children: React.ReactNode;
+}
+interface FlowBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
 
 declare const BUILT_IN_NODE_TYPES: NodeTypeDef[];
 
@@ -139,6 +173,47 @@ interface UseFlowResult {
 }
 declare function useFlow(options: UseFlowOptions): UseFlowResult;
 
+interface UseFlowDataOptions {
+    /** Canvas data from Flow document's `canvas` field */
+    data: CanvasData | undefined;
+    /** Node type definitions (defaults to built-in types) */
+    nodeTypeDefs?: NodeTypeDef[];
+    /** Edge type definitions (defaults to built-in types) */
+    edgeTypeDefs?: EdgeTypeDef[];
+}
+interface UseFlowDataResult {
+    /** Nodes from canvas data */
+    nodes: FlowNode[];
+    /** Edges from canvas data (typed for @xyflow/react) */
+    edges: Edge[];
+    /** Map of node type slug to definition */
+    nodeTypeDefsMap: Map<string, NodeTypeDef>;
+    /** Map of edge type slug to definition */
+    edgeTypeDefsMap: Map<string, EdgeTypeDef>;
+}
+/**
+ * Pure data transformation hook — extracts nodes, edges, and type definition
+ * maps from canvas data without any rendering. Useful for headless usage
+ * (custom layouts, analytics, server-side processing).
+ */
+declare function useFlowData(options: UseFlowDataOptions): UseFlowDataResult;
+
+/**
+ * Calculate bounding box for given node IDs.
+ * Pure function — usable in SSR, server components, or outside React.
+ */
+declare function getNodeBounds(nodes: FlowNode[], nodeIds: string[]): FlowBounds | undefined;
+/**
+ * Get all frame nodes with their bounds.
+ * Sorted by position (top-left to bottom-right).
+ * Builds a single nodeMap to compute absolute positions (O(F) instead of O(F*N)).
+ */
+declare function getFrames(nodes: FlowNode[]): Array<{
+    id: string;
+    label: string;
+    bounds: FlowBounds;
+}>;
+
 /**
  * Renders a Flow canvas in read-only mode.
  *
@@ -160,7 +235,7 @@ interface FlowRendererProps {
     nodeTypeDefs?: NodeTypeDef[];
     /** Edge type definitions for styled edges (color, stroke, markers, animation) */
     edgeTypeDefs?: EdgeTypeDef[];
-    /** Show background pattern (default: true) */
+    /** Show background pattern (default: false) */
     background?: boolean;
     /** Allow user interaction - pan, zoom (default: false for read-only display) */
     interactive?: boolean;
@@ -170,7 +245,33 @@ interface FlowRendererProps {
     onNodeClick?: (event: React.MouseEvent, node: FlowNode) => void;
     /** Called when an edge is clicked */
     onEdgeClick?: (event: React.MouseEvent, edge: FlowEdge) => void;
+    /** S1: Custom frame node renderer. Should be a stable reference (memoize or define outside render). */
+    frameRenderer?: React.ComponentType<FrameNodeSlotProps>;
+    /** S2: Custom edge renderers by edge type slug. Should be a stable reference (memoize or define outside render). */
+    edgeRenderers?: Record<string, React.ComponentType<EdgeSlotProps>>;
+    /** S3: Wraps every dynamic node's rendered content. Should be a stable reference (memoize or define outside render). */
+    nodeWrapper?: React.ComponentType<NodeWrapperSlotProps>;
+    /** S4: Show controls (default: false) */
+    controls?: boolean;
+    /** S4: Show minimap (default: false) */
+    minimap?: boolean;
+    /** S4: Custom minimap node color function */
+    minimapNodeColor?: (node: FlowNode) => string;
+    /** S4: Additional children rendered inside ReactFlow */
+    children?: React.ReactNode;
+    /** S5: Global override for all dynamic nodes. Should be a stable reference (memoize or define outside render). */
+    renderNode?: (props: DynamicNodeSlotProps, defaultRender: React.ReactElement) => React.ReactElement | null;
+    /** S6: Called when viewport changes (pan/zoom) */
+    onViewportChange?: (viewport: FlowViewport) => void;
+    /** S6: Default viewport (used when fitView is false) */
+    defaultViewport?: FlowViewport;
+    /** S8: Focus on specific bounds */
+    bounds?: FlowBounds;
+    /** S8: Padding for focus bounds (default: 0.1) */
+    focusPadding?: number;
+    /** S8: Animate focus transition (true=300ms, number=custom ms, false=instant) */
+    focusAnimation?: boolean | number;
 }
-declare function FlowRenderer({ data, className, style, nodeRenderers, nodeTypeDefs, edgeTypeDefs, background, interactive, fitView, onNodeClick, onEdgeClick, }: FlowRendererProps): React.JSX.Element | null;
+declare function FlowRenderer({ data, className, style, nodeRenderers, nodeTypeDefs, edgeTypeDefs, background, interactive, fitView, onNodeClick, onEdgeClick, frameRenderer, edgeRenderers, nodeWrapper, controls, minimap, minimapNodeColor, children, renderNode, onViewportChange, defaultViewport: defaultViewportProp, bounds, focusPadding, focusAnimation, }: FlowRendererProps): React.JSX.Element | null;
 
-export { BUILT_IN_EDGE_TYPES, BUILT_IN_NODE_TYPES, type CanvasData, type DynamicNodeData, type DynamicNodeSlotProps, type EdgeTypeDef, type FlowEdge, type FlowNode, type FlowNodeData, type FlowNodePosition, FlowRenderer, type FlowRendererProps, type FlowViewport, type FrameNodeData, type NodeTypeDef, type NodeTypeFieldDef, type SDKClient, type UseFlowOptions, type UseFlowResult, isDynamicNode, isFrameNode, useFlow };
+export { BUILT_IN_EDGE_TYPES, BUILT_IN_NODE_TYPES, type CanvasData, type DynamicNodeData, type DynamicNodeSlotProps, type EdgeSlotProps, type EdgeTypeDef, type FlowBounds, type FlowEdge, type FlowNode, type FlowNodeData, type FlowNodePosition, FlowRenderer, type FlowRendererProps, type FlowViewport, type FrameNodeData, type FrameNodeSlotProps, type NodeTypeDef, type NodeTypeFieldDef, type NodeWrapperSlotProps, type SDKClient, type UseFlowDataOptions, type UseFlowDataResult, type UseFlowOptions, type UseFlowResult, getFrames, getNodeBounds, isDynamicNode, isFrameNode, useFlow, useFlowData };

package/dist/ui/flow.d.ts

@@ -1,12 +1,13 @@
 import React from 'react';
 import { QueryClient } from '@tanstack/react-query';
+import { Edge } from '@xyflow/react';
 
 interface DynamicNodeData {
     nodeTypeSlug: string;
     label: string;
     fields: Record<string, unknown>;
 }
-type FlowNodeData = DynamicNodeData & Record<string, unknown>;
+type FlowNodeData = (DynamicNodeData | FrameNodeData) & Record<string, unknown>;
 interface FlowNodePosition {
     x: number;
     y: number;
@@ -105,6 +106,39 @@ interface FrameNodeData {
     borderStyle?: 'dashed' | 'solid' | 'none';
     opacity?: number;
 }
+interface FrameNodeSlotProps {
+    id: string;
+    label: string;
+    color?: string;
+    padding?: number;
+    borderStyle?: 'dashed' | 'solid' | 'none';
+    opacity?: number;
+    children?: React.ReactNode;
+}
+interface EdgeSlotProps {
+    id: string;
+    edgeTypeSlug?: string;
+    source: string;
+    target: string;
+    label?: string;
+    fields?: Record<string, unknown>;
+    edgeTypeDef?: EdgeTypeDef;
+    style?: React.CSSProperties;
+}
+interface NodeWrapperSlotProps {
+    id: string;
+    nodeTypeSlug: string;
+    label: string;
+    selected?: boolean;
+    nodeTypeDef?: NodeTypeDef;
+    children: React.ReactNode;
+}
+interface FlowBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
 
 declare const BUILT_IN_NODE_TYPES: NodeTypeDef[];
 
@@ -139,6 +173,47 @@ interface UseFlowResult {
 }
 declare function useFlow(options: UseFlowOptions): UseFlowResult;
 
+interface UseFlowDataOptions {
+    /** Canvas data from Flow document's `canvas` field */
+    data: CanvasData | undefined;
+    /** Node type definitions (defaults to built-in types) */
+    nodeTypeDefs?: NodeTypeDef[];
+    /** Edge type definitions (defaults to built-in types) */
+    edgeTypeDefs?: EdgeTypeDef[];
+}
+interface UseFlowDataResult {
+    /** Nodes from canvas data */
+    nodes: FlowNode[];
+    /** Edges from canvas data (typed for @xyflow/react) */
+    edges: Edge[];
+    /** Map of node type slug to definition */
+    nodeTypeDefsMap: Map<string, NodeTypeDef>;
+    /** Map of edge type slug to definition */
+    edgeTypeDefsMap: Map<string, EdgeTypeDef>;
+}
+/**
+ * Pure data transformation hook — extracts nodes, edges, and type definition
+ * maps from canvas data without any rendering. Useful for headless usage
+ * (custom layouts, analytics, server-side processing).
+ */
+declare function useFlowData(options: UseFlowDataOptions): UseFlowDataResult;
+
+/**
+ * Calculate bounding box for given node IDs.
+ * Pure function — usable in SSR, server components, or outside React.
+ */
+declare function getNodeBounds(nodes: FlowNode[], nodeIds: string[]): FlowBounds | undefined;
+/**
+ * Get all frame nodes with their bounds.
+ * Sorted by position (top-left to bottom-right).
+ * Builds a single nodeMap to compute absolute positions (O(F) instead of O(F*N)).
+ */
+declare function getFrames(nodes: FlowNode[]): Array<{
+    id: string;
+    label: string;
+    bounds: FlowBounds;
+}>;
+
 /**
  * Renders a Flow canvas in read-only mode.
  *
@@ -160,7 +235,7 @@ interface FlowRendererProps {
     nodeTypeDefs?: NodeTypeDef[];
     /** Edge type definitions for styled edges (color, stroke, markers, animation) */
     edgeTypeDefs?: EdgeTypeDef[];
-    /** Show background pattern (default: true) */
+    /** Show background pattern (default: false) */
     background?: boolean;
     /** Allow user interaction - pan, zoom (default: false for read-only display) */
     interactive?: boolean;
@@ -170,7 +245,33 @@ interface FlowRendererProps {
     onNodeClick?: (event: React.MouseEvent, node: FlowNode) => void;
     /** Called when an edge is clicked */
     onEdgeClick?: (event: React.MouseEvent, edge: FlowEdge) => void;
+    /** S1: Custom frame node renderer. Should be a stable reference (memoize or define outside render). */
+    frameRenderer?: React.ComponentType<FrameNodeSlotProps>;
+    /** S2: Custom edge renderers by edge type slug. Should be a stable reference (memoize or define outside render). */
+    edgeRenderers?: Record<string, React.ComponentType<EdgeSlotProps>>;
+    /** S3: Wraps every dynamic node's rendered content. Should be a stable reference (memoize or define outside render). */
+    nodeWrapper?: React.ComponentType<NodeWrapperSlotProps>;
+    /** S4: Show controls (default: false) */
+    controls?: boolean;
+    /** S4: Show minimap (default: false) */
+    minimap?: boolean;
+    /** S4: Custom minimap node color function */
+    minimapNodeColor?: (node: FlowNode) => string;
+    /** S4: Additional children rendered inside ReactFlow */
+    children?: React.ReactNode;
+    /** S5: Global override for all dynamic nodes. Should be a stable reference (memoize or define outside render). */
+    renderNode?: (props: DynamicNodeSlotProps, defaultRender: React.ReactElement) => React.ReactElement | null;
+    /** S6: Called when viewport changes (pan/zoom) */
+    onViewportChange?: (viewport: FlowViewport) => void;
+    /** S6: Default viewport (used when fitView is false) */
+    defaultViewport?: FlowViewport;
+    /** S8: Focus on specific bounds */
+    bounds?: FlowBounds;
+    /** S8: Padding for focus bounds (default: 0.1) */
+    focusPadding?: number;
+    /** S8: Animate focus transition (true=300ms, number=custom ms, false=instant) */
+    focusAnimation?: boolean | number;
 }
-declare function FlowRenderer({ data, className, style, nodeRenderers, nodeTypeDefs, edgeTypeDefs, background, interactive, fitView, onNodeClick, onEdgeClick, }: FlowRendererProps): React.JSX.Element | null;
+declare function FlowRenderer({ data, className, style, nodeRenderers, nodeTypeDefs, edgeTypeDefs, background, interactive, fitView, onNodeClick, onEdgeClick, frameRenderer, edgeRenderers, nodeWrapper, controls, minimap, minimapNodeColor, children, renderNode, onViewportChange, defaultViewport: defaultViewportProp, bounds, focusPadding, focusAnimation, }: FlowRendererProps): React.JSX.Element | null;
 
-export { BUILT_IN_EDGE_TYPES, BUILT_IN_NODE_TYPES, type CanvasData, type DynamicNodeData, type DynamicNodeSlotProps, type EdgeTypeDef, type FlowEdge, type FlowNode, type FlowNodeData, type FlowNodePosition, FlowRenderer, type FlowRendererProps, type FlowViewport, type FrameNodeData, type NodeTypeDef, type NodeTypeFieldDef, type SDKClient, type UseFlowOptions, type UseFlowResult, isDynamicNode, isFrameNode, useFlow };
+export { BUILT_IN_EDGE_TYPES, BUILT_IN_NODE_TYPES, type CanvasData, type DynamicNodeData, type DynamicNodeSlotProps, type EdgeSlotProps, type EdgeTypeDef, type FlowBounds, type FlowEdge, type FlowNode, type FlowNodeData, type FlowNodePosition, FlowRenderer, type FlowRendererProps, type FlowViewport, type FrameNodeData, type FrameNodeSlotProps, type NodeTypeDef, type NodeTypeFieldDef, type NodeWrapperSlotProps, type SDKClient, type UseFlowDataOptions, type UseFlowDataResult, type UseFlowOptions, type UseFlowResult, getFrames, getNodeBounds, isDynamicNode, isFrameNode, useFlow, useFlowData };