@particle-academy/fancy-flow 0.7.0 → 0.9.0

package/dist/index.d.cts

@@ -5,11 +5,11 @@ import { F as FlowNode, a as FlowGraph, b as NodeRunStatus, E as ExecutorRegistr
 export { A as ActionNodeData, B as BaseNodeData, D as DecisionNodeData, c as FlowEdge, d as FlowNodeData, e as FlowNodeKind, N as NodeExecutor, f as NoteNodeData, O as OutputNodeData, P as PortDescriptor, R as RunEvent, S as SubgraphNodeData, T as TriggerNodeData } from './types-BS3Gwnkq.cjs';
 import { WorkflowSchema, WorkflowMetadata } from './schema/index.cjs';
 export { ImportIssue, ImportOptions, ImportResult, WORKFLOW_SCHEMA_URL, WORKFLOW_SCHEMA_VERSION, WorkflowSchemaEdge, WorkflowSchemaNode, exportWorkflow, importWorkflow, workflowToBlob } from './schema/index.cjs';
-import { N as NodeCategory, a as NodeKindDefinition, C as ConfigField } from './types-C0wdN6QX.cjs';
-export { R as RenderBodyContext } from './types-C0wdN6QX.cjs';
+import { N as NodeCategory, a as NodeKindDefinition, C as ConfigField } from './types-DKqaUjF_.cjs';
+export { D as DocumentConfigField, K as KeyValueConfigField, P as PortSpec, R as RenderBodyContext, d as RepeaterConfigField, e as RepeaterRowField } from './types-DKqaUjF_.cjs';
 import { FlowRunFeedEntry } from './runtime/index.cjs';
 export { UseFlowRunOptions, UseFlowRunReturn, UseFlowStateReturn, applyStatusesToNodes, useFlowRun, useFlowState } from './runtime/index.cjs';
-export { BUILTIN_KINDS, RegistryNode, buildNodeTypes, categoryAccent, defaultConfigFor, getNodeKind, listNodeKinds, onNodeKindsChanged, registerBuiltinKinds, registerNodeKind, validateConfig } from './registry/index.cjs';
+export { BUILTIN_KINDS, RegistryNode, RichInputAdapter, RichInputPreview, buildNodeTypes, categoryAccent, defaultConfigFor, getNodeKind, getRichInputAdapter, isRichInputEnabled, listNodeKinds, onNodeKindsChanged, onRichInputAdapterChanged, registerBuiltinKinds, registerNodeKind, registerRichInputAdapter, resolveNodePorts, resolvePortSpec, validateConfig } from './registry/index.cjs';
 export { RunOptions, RunResult, runFlow } from './engine.cjs';
 
 type FlowCanvasProps = Omit<ReactFlowProps<FlowNode, Edge>, "nodes" | "edges" | "height"> & {
@@ -56,11 +56,17 @@ type FlowEditorApi = {
     selectedId: string | null;
     /** Currently selected node, or null. */
     selected: FlowNode | null;
+    /** Currently selected edge id, or null. Independent of node selection. */
+    selectedEdgeId: string | null;
+    /** Currently selected edge, or null. */
+    selectedEdge: Edge | null;
     /** True while a run is in flight. */
     running: boolean;
     /** Per-node run status, keyed by node id. */
     statuses: Record<string, NodeRunStatus>;
     select: (id: string | null) => void;
+    /** Select an edge (the connection between two nodes), or clear with null. */
+    selectEdge: (id: string | null) => void;
     /** Add a node of `kind` at an optional flow position. Returns the new id. */
     addNode: (kind: string, position?: {
         x: number;
@@ -72,8 +78,12 @@ type FlowEditorApi = {
     deleteNodes: (ids: string[]) => void;
     /** Delete the current selection (no-op when nothing is selected). */
     deleteSelected: () => void;
-    /** Delete edges by id. */
+    /** Delete edges by id — i.e. break the connections between nodes. */
     deleteEdges: (ids: string[]) => void;
+    /** Delete the selected edge (no-op when no edge is selected). */
+    deleteSelectedEdge: () => void;
+    /** Label a connection, or clear the label by passing undefined/"". */
+    setEdgeLabel: (id: string, label: string | undefined) => void;
     /** Copy a node (offset slightly) and select the copy. Returns the new id. */
     duplicateNode: (id: string) => string | null;
     /** Replace the whole graph. */
@@ -115,6 +125,8 @@ type FlowEditorBuiltins = {
     delete?: boolean;
     /** Right-click a node for Delete / Duplicate. Default true. */
     contextMenu?: boolean;
+    /** Right-click a connection for Label / Delete. Default true. */
+    edgeContextMenu?: boolean;
     export?: boolean;
     import?: boolean;
     count?: boolean;
@@ -136,6 +148,9 @@ type FlowEditorSlots = {
     /** Replace the node right-click menu. Receives the right-clicked node id;
      *  call `close` when an item is chosen. */
     contextMenu?: (api: FlowEditorApi, nodeId: string, close: () => void) => ReactNode;
+    /** Replace the connection right-click menu. Receives the right-clicked edge
+     *  id; call `close` when an item is chosen. */
+    edgeContextMenu?: (api: FlowEditorApi, edgeId: string, close: () => void) => ReactNode;
 };
 /**
  * Read the editor API from any child of `<FlowEditor>`. Throws outside one, so
@@ -180,6 +195,8 @@ type FlowEditorProps = {
     onSelectionChange?: (node: FlowNode | null) => void;
     /** Called after nodes are deleted, with the deleted ids. */
     onDelete?: (ids: string[]) => void;
+    /** Called after connections are broken, with the deleted edge ids. */
+    onEdgeDelete?: (ids: string[]) => void;
     className?: string;
     style?: CSSProperties;
 };
@@ -232,6 +249,16 @@ type NodeConfigPanelProps = {
         value: unknown;
         onChange: (next: unknown) => void;
     }) => ReactNode;
+    /**
+     * Optional document editor hook — host renders the editor for `document`
+     * fields. Lets rich authored content live in node config without fancy-flow
+     * taking on a document model.
+     */
+    renderDocumentField?: (props: {
+        documentType?: string;
+        value: unknown;
+        onChange: (next: unknown) => void;
+    }) => ReactNode;
     className?: string;
     style?: React.CSSProperties;
 };
@@ -239,7 +266,7 @@ type NodeConfigPanelProps = {
  * NodeConfigPanel — schema-driven form for the selected node. Defers to
  * `kind.renderPanel` if the kind opts out of the auto-form.
  */
-declare function NodeConfigPanel({ node, onChange, header, renderCredentialField, className, style, }: NodeConfigPanelProps): react.JSX.Element;
+declare function NodeConfigPanel({ node, onChange, header, renderCredentialField, renderDocumentField, className, style, }: NodeConfigPanelProps): react.JSX.Element;
 
 type ConfigFieldRendererProps = {
     field: ConfigField;
@@ -250,6 +277,18 @@ type ConfigFieldRendererProps = {
         value: unknown;
         onChange: (next: unknown) => void;
     }) => ReactNode;
+    /**
+     * Editor for `document` fields. fancy-flow stores the document but never
+     * interprets it — the host owns the editing surface, exactly as it does for
+     * `credential`. This is the seam for rich human-input steps (authored pages,
+     * required reading, multi-section forms) without the package depending on
+     * any particular document model.
+     */
+    renderDocumentField?: (props: {
+        documentType?: string;
+        value: unknown;
+        onChange: (next: unknown) => void;
+    }) => ReactNode;
 };
 /**
  * ConfigFieldRenderer — dispatches to the right input element per field
@@ -259,7 +298,7 @@ type ConfigFieldRendererProps = {
  * Hosts that want to use react-fancy form components can supply their
  * own field renderers via the kind's `renderPanel`.
  */
-declare function ConfigFieldRenderer({ field, value, onChange, renderCredentialField }: ConfigFieldRendererProps): react.JSX.Element | null;
+declare function ConfigFieldRenderer({ field, value, onChange, renderCredentialField, renderDocumentField, }: ConfigFieldRendererProps): react.JSX.Element | null;
 
 /** Entry-point node — outputs only, no inputs. */
 declare function TriggerNodeInner(props: NodeProps<FlowNode>): react.JSX.Element;

package/dist/index.d.ts

@@ -5,11 +5,11 @@ import { F as FlowNode, a as FlowGraph, b as NodeRunStatus, E as ExecutorRegistr
 export { A as ActionNodeData, B as BaseNodeData, D as DecisionNodeData, c as FlowEdge, d as FlowNodeData, e as FlowNodeKind, N as NodeExecutor, f as NoteNodeData, O as OutputNodeData, P as PortDescriptor, R as RunEvent, S as SubgraphNodeData, T as TriggerNodeData } from './types-BS3Gwnkq.js';
 import { WorkflowSchema, WorkflowMetadata } from './schema/index.js';
 export { ImportIssue, ImportOptions, ImportResult, WORKFLOW_SCHEMA_URL, WORKFLOW_SCHEMA_VERSION, WorkflowSchemaEdge, WorkflowSchemaNode, exportWorkflow, importWorkflow, workflowToBlob } from './schema/index.js';
-import { N as NodeCategory, a as NodeKindDefinition, C as ConfigField } from './types-DnMe9Vsf.js';
-export { R as RenderBodyContext } from './types-DnMe9Vsf.js';
+import { N as NodeCategory, a as NodeKindDefinition, C as ConfigField } from './types-BocBFh6l.js';
+export { D as DocumentConfigField, K as KeyValueConfigField, P as PortSpec, R as RenderBodyContext, d as RepeaterConfigField, e as RepeaterRowField } from './types-BocBFh6l.js';
 import { FlowRunFeedEntry } from './runtime/index.js';
 export { UseFlowRunOptions, UseFlowRunReturn, UseFlowStateReturn, applyStatusesToNodes, useFlowRun, useFlowState } from './runtime/index.js';
-export { BUILTIN_KINDS, RegistryNode, buildNodeTypes, categoryAccent, defaultConfigFor, getNodeKind, listNodeKinds, onNodeKindsChanged, registerBuiltinKinds, registerNodeKind, validateConfig } from './registry/index.js';
+export { BUILTIN_KINDS, RegistryNode, RichInputAdapter, RichInputPreview, buildNodeTypes, categoryAccent, defaultConfigFor, getNodeKind, getRichInputAdapter, isRichInputEnabled, listNodeKinds, onNodeKindsChanged, onRichInputAdapterChanged, registerBuiltinKinds, registerNodeKind, registerRichInputAdapter, resolveNodePorts, resolvePortSpec, validateConfig } from './registry/index.js';
 export { RunOptions, RunResult, runFlow } from './engine.js';
 
 type FlowCanvasProps = Omit<ReactFlowProps<FlowNode, Edge>, "nodes" | "edges" | "height"> & {
@@ -56,11 +56,17 @@ type FlowEditorApi = {
     selectedId: string | null;
     /** Currently selected node, or null. */
     selected: FlowNode | null;
+    /** Currently selected edge id, or null. Independent of node selection. */
+    selectedEdgeId: string | null;
+    /** Currently selected edge, or null. */
+    selectedEdge: Edge | null;
     /** True while a run is in flight. */
     running: boolean;
     /** Per-node run status, keyed by node id. */
     statuses: Record<string, NodeRunStatus>;
     select: (id: string | null) => void;
+    /** Select an edge (the connection between two nodes), or clear with null. */
+    selectEdge: (id: string | null) => void;
     /** Add a node of `kind` at an optional flow position. Returns the new id. */
     addNode: (kind: string, position?: {
         x: number;
@@ -72,8 +78,12 @@ type FlowEditorApi = {
     deleteNodes: (ids: string[]) => void;
     /** Delete the current selection (no-op when nothing is selected). */
     deleteSelected: () => void;
-    /** Delete edges by id. */
+    /** Delete edges by id — i.e. break the connections between nodes. */
     deleteEdges: (ids: string[]) => void;
+    /** Delete the selected edge (no-op when no edge is selected). */
+    deleteSelectedEdge: () => void;
+    /** Label a connection, or clear the label by passing undefined/"". */
+    setEdgeLabel: (id: string, label: string | undefined) => void;
     /** Copy a node (offset slightly) and select the copy. Returns the new id. */
     duplicateNode: (id: string) => string | null;
     /** Replace the whole graph. */
@@ -115,6 +125,8 @@ type FlowEditorBuiltins = {
     delete?: boolean;
     /** Right-click a node for Delete / Duplicate. Default true. */
     contextMenu?: boolean;
+    /** Right-click a connection for Label / Delete. Default true. */
+    edgeContextMenu?: boolean;
     export?: boolean;
     import?: boolean;
     count?: boolean;
@@ -136,6 +148,9 @@ type FlowEditorSlots = {
     /** Replace the node right-click menu. Receives the right-clicked node id;
      *  call `close` when an item is chosen. */
     contextMenu?: (api: FlowEditorApi, nodeId: string, close: () => void) => ReactNode;
+    /** Replace the connection right-click menu. Receives the right-clicked edge
+     *  id; call `close` when an item is chosen. */
+    edgeContextMenu?: (api: FlowEditorApi, edgeId: string, close: () => void) => ReactNode;
 };
 /**
  * Read the editor API from any child of `<FlowEditor>`. Throws outside one, so
@@ -180,6 +195,8 @@ type FlowEditorProps = {
     onSelectionChange?: (node: FlowNode | null) => void;
     /** Called after nodes are deleted, with the deleted ids. */
     onDelete?: (ids: string[]) => void;
+    /** Called after connections are broken, with the deleted edge ids. */
+    onEdgeDelete?: (ids: string[]) => void;
     className?: string;
     style?: CSSProperties;
 };
@@ -232,6 +249,16 @@ type NodeConfigPanelProps = {
         value: unknown;
         onChange: (next: unknown) => void;
     }) => ReactNode;
+    /**
+     * Optional document editor hook — host renders the editor for `document`
+     * fields. Lets rich authored content live in node config without fancy-flow
+     * taking on a document model.
+     */
+    renderDocumentField?: (props: {
+        documentType?: string;
+        value: unknown;
+        onChange: (next: unknown) => void;
+    }) => ReactNode;
     className?: string;
     style?: React.CSSProperties;
 };
@@ -239,7 +266,7 @@ type NodeConfigPanelProps = {
  * NodeConfigPanel — schema-driven form for the selected node. Defers to
  * `kind.renderPanel` if the kind opts out of the auto-form.
  */
-declare function NodeConfigPanel({ node, onChange, header, renderCredentialField, className, style, }: NodeConfigPanelProps): react.JSX.Element;
+declare function NodeConfigPanel({ node, onChange, header, renderCredentialField, renderDocumentField, className, style, }: NodeConfigPanelProps): react.JSX.Element;
 
 type ConfigFieldRendererProps = {
     field: ConfigField;
@@ -250,6 +277,18 @@ type ConfigFieldRendererProps = {
         value: unknown;
         onChange: (next: unknown) => void;
     }) => ReactNode;
+    /**
+     * Editor for `document` fields. fancy-flow stores the document but never
+     * interprets it — the host owns the editing surface, exactly as it does for
+     * `credential`. This is the seam for rich human-input steps (authored pages,
+     * required reading, multi-section forms) without the package depending on
+     * any particular document model.
+     */
+    renderDocumentField?: (props: {
+        documentType?: string;
+        value: unknown;
+        onChange: (next: unknown) => void;
+    }) => ReactNode;
 };
 /**
  * ConfigFieldRenderer — dispatches to the right input element per field
@@ -259,7 +298,7 @@ type ConfigFieldRendererProps = {
  * Hosts that want to use react-fancy form components can supply their
  * own field renderers via the kind's `renderPanel`.
  */
-declare function ConfigFieldRenderer({ field, value, onChange, renderCredentialField }: ConfigFieldRendererProps): react.JSX.Element | null;
+declare function ConfigFieldRenderer({ field, value, onChange, renderCredentialField, renderDocumentField, }: ConfigFieldRendererProps): react.JSX.Element | null;
 
 /** Entry-point node — outputs only, no inputs. */
 declare function TriggerNodeInner(props: NodeProps<FlowNode>): react.JSX.Element;