@particle-academy/fancy-flow 0.53.0 → 0.55.0

package/dist/index.d.cts

@@ -5,8 +5,8 @@ import { ConnectionValidatorOptions } from './registry/index.cjs';
 export { ANY_PORT_TYPE, BUILTIN_KINDS, PortCompatibility, RegistryNode, RichInputAdapter, RichInputPreview, buildNodeTypes, createConnectionValidator, defaultPortCompatibility, getRichInputAdapter, isRichInputEnabled, onRichInputAdapterChanged, registerBuiltinKinds, registerRichInputAdapter, resolveNodePorts, resolvePortSpec } from './registry/index.cjs';
 import { a as FlowNode, F as FlowGraph, g as NodeRunStatus, E as ExecutorRegistry } from './types-JFYjPJAG.cjs';
 export { A as ActionNodeData, B as BaseNodeData, D as DecisionNodeData, d as FlowEdge, e as FlowNodeData, f as FlowNodeKind, N as NodeExecutor, h as NoteNodeData, O as OutputNodeData, P as PortDescriptor, R as RunEvent, S as SubgraphNodeData, T as TriggerNodeData } from './types-JFYjPJAG.cjs';
-import { C as ConfigFieldRenderFn } from './ConfigFieldRenderer-Bc9Txnql.cjs';
-export { a as ConfigFieldRenderContext, b as ConfigFieldRenderer, c as ConfigFieldRendererProps } from './ConfigFieldRenderer-Bc9Txnql.cjs';
+import { C as ConfigFieldRenderFn, H as HumanFieldRenderers } from './HumanPrompt-CPl-Spmp.cjs';
+export { a as ConfigFieldRenderContext, b as ConfigFieldRenderer, c as ConfigFieldRendererProps } from './HumanPrompt-CPl-Spmp.cjs';
 import { WorkflowSchema, WorkflowMetadata } from './schema/index.cjs';
 export { ImportIssue, ImportOptions, ImportResult, WORKFLOW_SCHEMA_URL, WORKFLOW_SCHEMA_VERSION, WorkflowSchemaEdge, WorkflowSchemaNode, exportWorkflow, importWorkflow, migrateSchema, workflowToBlob } from './schema/index.cjs';
 import { AutoLayoutOptions } from './layout/index.cjs';
@@ -16,8 +16,8 @@ export { A as AvailableVariable, C as ConfigField, D as DocumentConfigField, r a
 export { F as FlowNodeStatus, a as FlowViewer, b as FlowViewerClassNames, c as FlowViewerProps } from './FlowViewer-DABx-6A-.cjs';
 import { FlowRunFeedEntry } from './runtime/index.cjs';
 export { HistoryController, UseFlowHistoryReturn, UseFlowRunOptions, UseFlowRunReturn, UseFlowStateReturn, applyOutputsToNodes, applyStatusesToNodes, createHistory, useFlowHistory, useFlowRun, useFlowState } from './runtime/index.cjs';
-export { R as RunOptions, a as RunResult, r as runFlow } from './run-flow-COdAOFg2.cjs';
-export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort } from './run-cohort-r-L8dMED.cjs';
+export { R as RunOptions, a as RunResult, r as runFlow } from './run-flow-2XsHBwpd.cjs';
+export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort } from './run-cohort-CBRAUj-z.cjs';
 export { L as LEGACY_PAUSE_PREFIXES, a as PAUSE_PREFIX, P as PauseAwaiting, b as PauseSignal, d as decodePause, e as encodePause, i as isPause, p as pauseForHuman } from './pause-9iT4tCEV.cjs';
 export { N as NodeKindPresentation, c as categoryAccent, b as clearNodeKindOverrides, d as defaultConfigFor, e as ensureBuiltinKinds, g as getNodeKind, l as listNodeKinds, o as onNodeKindsChanged, f as overrideNodeKind, r as registerNodeKind, v as validateConfig } from './registry-C6TMfiD_.cjs';
 import './capabilities-BYa5p5jw.cjs';
@@ -321,6 +321,17 @@ type FlowEditorProps = {
     value?: FlowGraph;
     /** Executor registry passed to runFlow. Each kind name maps to an executor. */
     executors?: ExecutorRegistry;
+    /**
+     * Host controls for the `user_input` / `human_approval` pause form, keyed by
+     * canonical field type. A renderer returning `null` declines that field and
+     * falls through to the built-in, so a PARTIAL map is safe to spread.
+     *
+     * The built-ins are native `--ff-*`-themed elements because react-fancy is an
+     * OPTIONAL peer and this component ships in the main entry. A host that has
+     * react-fancy opts into its primitives with
+     * `humanFieldRenderers` from `@particle-academy/fancy-flow/fields/react-fancy`.
+     */
+    humanFieldRenderers?: HumanFieldRenderers;
     /** Saved metadata for export. */
     metadata?: WorkflowMetadata;
     /** Show the palette sidebar. Default true. */

package/dist/index.d.ts

@@ -5,8 +5,8 @@ import { ConnectionValidatorOptions } from './registry/index.js';
 export { ANY_PORT_TYPE, BUILTIN_KINDS, PortCompatibility, RegistryNode, RichInputAdapter, RichInputPreview, buildNodeTypes, createConnectionValidator, defaultPortCompatibility, getRichInputAdapter, isRichInputEnabled, onRichInputAdapterChanged, registerBuiltinKinds, registerRichInputAdapter, resolveNodePorts, resolvePortSpec } from './registry/index.js';
 import { a as FlowNode, F as FlowGraph, g as NodeRunStatus, E as ExecutorRegistry } from './types-JFYjPJAG.js';
 export { A as ActionNodeData, B as BaseNodeData, D as DecisionNodeData, d as FlowEdge, e as FlowNodeData, f as FlowNodeKind, N as NodeExecutor, h as NoteNodeData, O as OutputNodeData, P as PortDescriptor, R as RunEvent, S as SubgraphNodeData, T as TriggerNodeData } from './types-JFYjPJAG.js';
-import { C as ConfigFieldRenderFn } from './ConfigFieldRenderer-Bt3RGT7Z.js';
-export { a as ConfigFieldRenderContext, b as ConfigFieldRenderer, c as ConfigFieldRendererProps } from './ConfigFieldRenderer-Bt3RGT7Z.js';
+import { C as ConfigFieldRenderFn, H as HumanFieldRenderers } from './HumanPrompt-DlJSFi3F.js';
+export { a as ConfigFieldRenderContext, b as ConfigFieldRenderer, c as ConfigFieldRendererProps } from './HumanPrompt-DlJSFi3F.js';
 import { WorkflowSchema, WorkflowMetadata } from './schema/index.js';
 export { ImportIssue, ImportOptions, ImportResult, WORKFLOW_SCHEMA_URL, WORKFLOW_SCHEMA_VERSION, WorkflowSchemaEdge, WorkflowSchemaNode, exportWorkflow, importWorkflow, migrateSchema, workflowToBlob } from './schema/index.js';
 import { AutoLayoutOptions } from './layout/index.js';
@@ -16,8 +16,8 @@ export { A as AvailableVariable, C as ConfigField, D as DocumentConfigField, r a
 export { F as FlowNodeStatus, a as FlowViewer, b as FlowViewerClassNames, c as FlowViewerProps } from './FlowViewer-BI_AyyvU.js';
 import { FlowRunFeedEntry } from './runtime/index.js';
 export { HistoryController, UseFlowHistoryReturn, UseFlowRunOptions, UseFlowRunReturn, UseFlowStateReturn, applyOutputsToNodes, applyStatusesToNodes, createHistory, useFlowHistory, useFlowRun, useFlowState } from './runtime/index.js';
-export { R as RunOptions, a as RunResult, r as runFlow } from './run-flow-DJ7KYT6E.js';
-export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort } from './run-cohort-BPIOpE8A.js';
+export { R as RunOptions, a as RunResult, r as runFlow } from './run-flow-D7AOCcfE.js';
+export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, r as runCohort } from './run-cohort-C1nRh_mi.js';
 export { L as LEGACY_PAUSE_PREFIXES, a as PAUSE_PREFIX, P as PauseAwaiting, b as PauseSignal, d as decodePause, e as encodePause, i as isPause, p as pauseForHuman } from './pause-9iT4tCEV.js';
 export { N as NodeKindPresentation, c as categoryAccent, b as clearNodeKindOverrides, d as defaultConfigFor, e as ensureBuiltinKinds, g as getNodeKind, l as listNodeKinds, o as onNodeKindsChanged, f as overrideNodeKind, r as registerNodeKind, v as validateConfig } from './registry-3RkSYrMi.js';
 import './capabilities-COOXRiNL.js';
@@ -321,6 +321,17 @@ type FlowEditorProps = {
     value?: FlowGraph;
     /** Executor registry passed to runFlow. Each kind name maps to an executor. */
     executors?: ExecutorRegistry;
+    /**
+     * Host controls for the `user_input` / `human_approval` pause form, keyed by
+     * canonical field type. A renderer returning `null` declines that field and
+     * falls through to the built-in, so a PARTIAL map is safe to spread.
+     *
+     * The built-ins are native `--ff-*`-themed elements because react-fancy is an
+     * OPTIONAL peer and this component ships in the main entry. A host that has
+     * react-fancy opts into its primitives with
+     * `humanFieldRenderers` from `@particle-academy/fancy-flow/fields/react-fancy`.
+     */
+    humanFieldRenderers?: HumanFieldRenderers;
     /** Saved metadata for export. */
     metadata?: WorkflowMetadata;
     /** Show the palette sidebar. Default true. */

package/dist/index.js

@@ -1,16 +1,16 @@
-import { removeNodes, removeEdges, cloneSubgraph, alignNodes, distributeNodes, reconnectEdge, assignToLane, removeFromLane, duplicateNode, setEdgeLabel, FlowCanvas } from './chunk-FTGVVKWX.js';
-export { ActionNode, DecisionNode, FlowCanvas, FlowViewer, NodeShell, OutputNode, SubgraphNode, TriggerNode, alignNodes, cloneSubgraph, defaultNodeTypes, distributeNodes, reconnectEdge } from './chunk-FTGVVKWX.js';
-import { useFlowState, useFlowRun, useFlowHistory, applyOutputsToNodes, applyStatusesToNodes } from './chunk-FG3C7LIG.js';
-export { applyOutputsToNodes, applyStatusesToNodes, createHistory, useFlowHistory, useFlowRun, useFlowState } from './chunk-FG3C7LIG.js';
-export { runCohort } from './chunk-WCFRKXH5.js';
+import { removeNodes, removeEdges, cloneSubgraph, alignNodes, distributeNodes, reconnectEdge, assignToLane, removeFromLane, duplicateNode, setEdgeLabel, FlowCanvas } from './chunk-HMEI2LFU.js';
+export { ActionNode, DecisionNode, FlowCanvas, FlowViewer, NodeShell, OutputNode, SubgraphNode, TriggerNode, alignNodes, cloneSubgraph, defaultNodeTypes, distributeNodes, reconnectEdge } from './chunk-HMEI2LFU.js';
+import { useFlowState, useFlowRun, useFlowHistory, applyOutputsToNodes, applyStatusesToNodes } from './chunk-L4QAAGLV.js';
+export { applyOutputsToNodes, applyStatusesToNodes, createHistory, useFlowHistory, useFlowRun, useFlowState } from './chunk-L4QAAGLV.js';
+export { runCohort } from './chunk-KP4TBF3A.js';
 export { evaluateConfig, evaluateExpression, resolvePath, text, truthy } from './chunk-BHM5HGXH.js';
-import { buildNodeTypes } from './chunk-VWANLNL5.js';
-export { ANY_PORT_TYPE, RegistryNode, buildNodeTypes, createConnectionValidator, defaultPortCompatibility } from './chunk-VWANLNL5.js';
+import { buildNodeTypes } from './chunk-E3AGYTHP.js';
+export { ANY_PORT_TYPE, RegistryNode, buildNodeTypes, createConnectionValidator, defaultPortCompatibility } from './chunk-E3AGYTHP.js';
 export { LEGACY_PAUSE_PREFIXES, PAUSE_PREFIX, decodePause, encodePause, isPause, pauseForHuman } from './chunk-UEOE6B52.js';
-import { workflowToBlob, importWorkflow, exportWorkflow } from './chunk-FH6MWLKD.js';
-export { WORKFLOW_SCHEMA_URL, WORKFLOW_SCHEMA_VERSION, exportWorkflow, importWorkflow, migrateSchema, workflowToBlob } from './chunk-FH6MWLKD.js';
-import { ReactFlowProvider, useReactFlow, humanInputFields, onNodeKindsChanged, listNodeKinds, getNodeKind, defaultConfigFor, FlowEditorProvider, addEdge, applyEdgeChanges, applyNodeChanges, Position, ensureBuiltinKinds, validateConfig, categoryAccent, Handle } from './chunk-CIBW5ATA.js';
-export { BUILTIN_KINDS, LaneNode, NoteNode, categoryAccent, clearNodeKindOverrides, defaultConfigFor, ensureBuiltinKinds, getNodeKind, listNodeKinds, onNodeKindsChanged, overrideNodeKind, registerBuiltinKinds, registerNodeKind, resolveNodePorts, resolvePortSpec, runFlow, useFlowEditor, useFlowEditorOptional, validateConfig } from './chunk-CIBW5ATA.js';
+import { workflowToBlob, importWorkflow, exportWorkflow } from './chunk-YVLOLS25.js';
+export { WORKFLOW_SCHEMA_URL, WORKFLOW_SCHEMA_VERSION, exportWorkflow, importWorkflow, migrateSchema, workflowToBlob } from './chunk-YVLOLS25.js';
+import { ReactFlowProvider, useReactFlow, humanInputFields, onNodeKindsChanged, listNodeKinds, getNodeKind, defaultConfigFor, FlowEditorProvider, addEdge, applyEdgeChanges, applyNodeChanges, Position, ensureBuiltinKinds, validateConfig, categoryAccent, Handle } from './chunk-22OJOD4X.js';
+export { BUILTIN_KINDS, LaneNode, NoteNode, categoryAccent, clearNodeKindOverrides, defaultConfigFor, ensureBuiltinKinds, getNodeKind, listNodeKinds, onNodeKindsChanged, overrideNodeKind, registerBuiltinKinds, registerNodeKind, resolveNodePorts, resolvePortSpec, runFlow, useFlowEditor, useFlowEditorOptional, validateConfig } from './chunk-22OJOD4X.js';
 import { getRichInputAdapter } from './chunk-F5RPRB7A.js';
 export { RichInputPreview, getRichInputAdapter, isRichInputEnabled, onRichInputAdapterChanged, registerRichInputAdapter } from './chunk-F5RPRB7A.js';
 import './chunk-USL4FMFU.js';
@@ -998,7 +998,11 @@ function initialValues(fields) {
   }
   return v;
 }
-function HumanPrompt({ request, onCancel }) {
+function HumanPrompt({
+  request,
+  onCancel,
+  fieldRenderers
+}) {
   const firstRef = useRef(null);
   useEffect(() => {
     firstRef.current?.focus();
@@ -1010,7 +1014,7 @@ function HumanPrompt({ request, onCancel }) {
   }, [onCancel]);
   return /* @__PURE__ */ jsx("div", { className: "ff-prompt-overlay", role: "dialog", "aria-modal": "true", "aria-label": request.title, children: /* @__PURE__ */ jsxs("div", { className: "ff-prompt", onClick: (e) => e.stopPropagation(), children: [
     /* @__PURE__ */ jsx("div", { className: "ff-prompt__title", children: request.title }),
-    request.kind === "approval" ? /* @__PURE__ */ jsx(ApprovalBody, { request, onCancel }) : /* @__PURE__ */ jsx(InputBody, { request, onCancel, firstRef })
+    request.kind === "approval" ? /* @__PURE__ */ jsx(ApprovalBody, { request, onCancel }) : /* @__PURE__ */ jsx(InputBody, { request, onCancel, firstRef, fieldRenderers })
   ] }) });
 }
 function ApprovalBody({ request, onCancel }) {
@@ -1026,7 +1030,8 @@ function ApprovalBody({ request, onCancel }) {
 function InputBody({
   request,
   onCancel,
-  firstRef
+  firstRef,
+  fieldRenderers
 }) {
   const [values, setValues] = useState(() => initialValues(request.fields));
   const set = (k, v) => setValues((prev) => ({ ...prev, [k]: v }));
@@ -1062,7 +1067,8 @@ function InputBody({
               id: fieldId(f.key),
               value: values[f.key],
               onChange: (v) => set(f.key, v),
-              autoFocusRef: i === 0 ? firstRef : void 0
+              autoFocusRef: i === 0 ? firstRef : void 0,
+              renderers: fieldRenderers
             }
           )
         ] }, f.key)) }),
@@ -1079,8 +1085,14 @@ function FieldControl({
   id,
   value,
   onChange,
-  autoFocusRef
+  autoFocusRef,
+  renderers
 }) {
+  const override = renderers?.[field.type ?? "text"];
+  if (override) {
+    const rendered = override({ field, id, value, onChange, autoFocusRef });
+    if (rendered !== null && rendered !== void 0) return /* @__PURE__ */ jsx(Fragment, { children: rendered });
+  }
   const handle = { id, "data-ff-field": field.key };
   if (field.type === "textarea") {
     return /* @__PURE__ */ jsx(
@@ -1168,6 +1180,7 @@ function FlowEditorInner({
   onDelete,
   onEdgeDelete,
   confirmDelete,
+  humanFieldRenderers,
   apiRef
 }) {
   const internal = useFlowState(initial);
@@ -1704,10 +1717,17 @@ function FlowEditorInner({
         }
       ),
       showFeed && (slots.feed ? slots.feed(api) : /* @__PURE__ */ jsx(FlowRunFeed, { entries: runner.feed, running: api.running, className: "ff-editor__feed" })),
-      prompt && /* @__PURE__ */ jsx(HumanPrompt, { request: prompt, onCancel: () => {
-        setPrompt(null);
-        runner.cancel();
-      } })
+      prompt && /* @__PURE__ */ jsx(
+        HumanPrompt,
+        {
+          request: prompt,
+          onCancel: () => {
+            setPrompt(null);
+            runner.cancel();
+          },
+          fieldRenderers: humanFieldRenderers
+        }
+      )
     ] }),
     showPanel && (slots.panel ? slots.panel(api) : /* @__PURE__ */ jsxs("div", { className: "ff-editor__panel-wrap", children: [
       /* @__PURE__ */ jsx(