@particle-academy/fancy-flow 0.41.0 → 0.43.0

package/dist/index.d.cts

@@ -5,19 +5,19 @@ 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 { b as FlowNode, F as FlowGraph, e as NodeRunStatus, E as ExecutorRegistry } from './types-sOmpCitB.cjs';
 export { A as ActionNodeData, B as BaseNodeData, D as DecisionNodeData, a as FlowEdge, c as FlowNodeData, d 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-sOmpCitB.cjs';
-import { C as ConfigFieldRenderFn } from './ConfigFieldRenderer-4xK9hzvd.cjs';
-export { a as ConfigFieldRenderContext, b as ConfigFieldRenderer, c as ConfigFieldRendererProps } from './ConfigFieldRenderer-4xK9hzvd.cjs';
+import { C as ConfigFieldRenderFn } from './ConfigFieldRenderer-LotNHeG8.cjs';
+export { a as ConfigFieldRenderContext, b as ConfigFieldRenderer, c as ConfigFieldRendererProps } from './ConfigFieldRenderer-LotNHeG8.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';
 export { AutoLayoutDirection } from './layout/index.cjs';
-import { c as NodeCategory, d as NodeKindDefinition } from './types-cAdD1Og2.cjs';
-export { a as ConfigField, D as DocumentConfigField, K as KeyValueConfigField, L as LEGACY_PAUSE_PREFIXES, h as PAUSE_PREFIX, P as PauseAwaiting, i as PauseSignal, j as PortSpec, R as RenderBodyContext, t as RepeaterConfigField, u as RepeaterRowField, m as decodePause, n as encodePause, o as isPause, p as pauseForHuman } from './types-cAdD1Og2.cjs';
+import { c as NodeCategory, d as NodeKindDefinition } from './types-B78Rm69S.cjs';
+export { A as AvailableVariable, a as ConfigField, D as DocumentConfigField, z as ExpressionForm, B as ExpressionGrammarHelp, K as KeyValueConfigField, L as LEGACY_PAUSE_PREFIXES, O as OutputField, F as OutputShape, h as PAUSE_PREFIX, P as PauseAwaiting, i as PauseSignal, j as PortSpec, R as RenderBodyContext, t as RepeaterConfigField, u as RepeaterRowField, G as availableVariables, H as baseVariables, m as decodePause, I as describeExpressionGrammar, n as encodePause, o as isPause, Q as outputFieldsFor, p as pauseForHuman } from './types-B78Rm69S.cjs';
 export { F as FlowNodeStatus, a as FlowViewer, b as FlowViewerClassNames, c as FlowViewerProps } from './FlowViewer-nLqo7s2E.cjs';
 import { FlowRunFeedEntry } from './runtime/index.cjs';
 export { HistoryController, UseFlowHistoryReturn, UseFlowRunOptions, UseFlowRunReturn, UseFlowStateReturn, applyOutputsToNodes, applyStatusesToNodes, createHistory, useFlowHistory, useFlowRun, useFlowState } from './runtime/index.cjs';
 export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, R as RunOptions, d as RunResult, r as runCohort, e as runFlow } from './run-cohort-Bjv2ZU6g.cjs';
-export { N as NodeKindPresentation, c as categoryAccent, b as clearNodeKindOverrides, d as defaultConfigFor, g as getNodeKind, l as listNodeKinds, o as onNodeKindsChanged, e as overrideNodeKind, r as registerNodeKind, v as validateConfig } from './registry-BNyT66SS.cjs';
+export { N as NodeKindPresentation, c as categoryAccent, b as clearNodeKindOverrides, d as defaultConfigFor, g as getNodeKind, l as listNodeKinds, o as onNodeKindsChanged, e as overrideNodeKind, r as registerNodeKind, v as validateConfig } from './registry-C9KMVpn7.cjs';
 import './capabilities-BtJQTbnw.cjs';
 
 type FlowCanvasProps = Omit<ReactFlowProps<FlowNode, Edge>, "nodes" | "edges" | "height"> & {
@@ -98,6 +98,13 @@ type NodeConfigPanelProps = {
      */
     /** Host renderers keyed by field `type`. See {@link ConfigFieldRenderer}. */
     fieldRenderers?: Record<string, ConfigFieldRenderFn>;
+    /**
+     * The graph the node lives in. Supplying it is what makes the `{{ }}` variable
+     * picker context-aware — it reads the UPSTREAM node's declared `outputShape`
+     * to list what is actually reachable here (issue #5). Without it the picker
+     * still opens, but can only offer the whole input.
+     */
+    graph?: FlowGraph;
     renderDocumentField?: (props: {
         documentType?: string;
         value: unknown;
@@ -110,7 +117,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, onDelete, deleteLabel, header, renderCredentialField, renderDocumentField, fieldRenderers, className, style, }: NodeConfigPanelProps): react.JSX.Element;
+declare function NodeConfigPanel({ node, onChange, onDelete, deleteLabel, header, renderCredentialField, renderDocumentField, fieldRenderers, graph, className, style, }: NodeConfigPanelProps): react.JSX.Element;
 
 /**
  * Clone a set of nodes AND the edges internal to that set, remapping every id.
@@ -620,4 +627,116 @@ declare const flowKeys: {
     readonly run: (runId: string) => readonly ["flow", "runs", string];
 };
 
-export { ActionNode, type AlignEdge, AutoLayoutOptions, ConfigFieldRenderFn, ConnectionValidatorOptions, DecisionNode, ExecutorRegistry, FlowCanvas, type FlowCanvasProps, FlowEditor, type FlowEditorAction, type FlowEditorApi, type FlowEditorBuiltins, type FlowEditorProps, type FlowEditorSlots, FlowGraph, FlowNode, type FlowNodeRenderProps, FlowRunControls, type FlowRunControlsProps, FlowRunFeed, FlowRunFeedEntry, type FlowRunFeedProps, LaneNode, NodeCategory, NodeConfigPanel, type NodeConfigPanelProps, NodeKindDefinition, NodePalette, type NodePaletteProps, NodePort, type NodePortProps, type NodePortSide, type NodePortType, NodeRunStatus, NodeShell, type NodeShellProps, NoteNode, OutputNode, SubgraphNode, TriggerNode, WorkflowMetadata, WorkflowSchema, alignNodes, cloneSubgraph, defaultNodeTypes, defineNode, distributeNodes, flowKeys, flowLive, paletteDropHandlers, reconnectEdge, useFlowEditor, useFlowEditorOptional };
+type ExpressionFieldProps = {
+    value: string;
+    onChange: (next: string) => void;
+    placeholder?: string;
+    rows?: number;
+    /** The panel's field id + agent handle. */
+    handle: {
+        id?: string;
+        "data-ff-field": string;
+    };
+    /**
+     * The graph and the node being edited. Both are needed to answer "what can I
+     * write here" — without them the picker can still offer `{{ $json }}` but
+     * nothing node-specific, which is the static list issue #5 asked us not to
+     * ship.
+     */
+    graph?: FlowGraph;
+    nodeId?: string;
+};
+/**
+ * ExpressionField — a `{{ }}` field that tells the author what it accepts.
+ *
+ * Issue #5: the panel rendered a bare textarea with a placeholder and nothing
+ * else, so writing an expression required already knowing both the grammar and
+ * the exact shape of the upstream node's output. Two affordances close that:
+ * typing `{{ ` opens a picker of the variables actually reachable at THIS node,
+ * and a reference toggle explains the grammar.
+ *
+ * The picker deliberately lists only what the resolver can reach — see
+ * `availableVariables`. A suggestion that resolves to `null` at runtime is
+ * worse than no suggestion, because the author has no reason to doubt it.
+ */
+declare function ExpressionField({ value, onChange, placeholder, rows, handle, graph, nodeId, }: ExpressionFieldProps): react.JSX.Element;
+
+/**
+ * `{{ }}` resolution — the TypeScript twin of `FancyFlow\Nodes\Support\Expr`.
+ *
+ * ## Why this is opt-in and not wired into `runFlow`
+ *
+ * The PHP runtime resolves expressions inside its batteries-included executors.
+ * The JS runtime never has: `runFlow` hands `node.data.config` to your executor
+ * verbatim, so every host that uses `{{ }}` today already resolves it itself.
+ * Turning resolution on inside `runFlow` would interpolate a second time over
+ * values those hosts had already substituted — silently, and only for graphs
+ * that happen to contain `{{` in their DATA.
+ *
+ * So this exports the semantics and changes no behaviour. Call it yourself:
+ *
+ * ```ts
+ * const url = evaluateExpression(node.data.config.url, inputs);
+ * ```
+ *
+ * ## The semantics are the PHP file's, deliberately
+ *
+ * This is not a general expression language and must not grow into one. It
+ * resolves a dot-path against a context and nothing else — no arithmetic, no
+ * comparisons, no calls. Hosts that want real expressions override the executor
+ * (the PHP docblock points at symfony/expression-language for the same reason).
+ *
+ * Divergence here is a correctness bug rather than a style difference: the same
+ * graph is authored once and may run on either runtime. `suites/shared/expr`
+ * in `@particle-academy/fancy-conformance` is the fixture table both sides run,
+ * so parity is a test result instead of a claim.
+ */
+/** Anything a context or a resolved value can be. */
+type ExprValue = unknown;
+/** The context an expression resolves against — the executor's `inputs`. */
+type ExprContext = Record<string, ExprValue>;
+/**
+ * Resolve a dot-path against the context, honouring the `$json` / `$input`
+ * alias.
+ *
+ * Both aliases point at the `in` port value when the context has one, and at
+ * the whole context otherwise — the same fallback the PHP does, which is what
+ * makes `{{ $json.x }}` work on a trigger node that has no upstream input.
+ *
+ * A path that does not resolve returns `null`, never `undefined`: PHP has one
+ * absent value and JS has two, and letting the difference leak would make the
+ * two runtimes disagree about `{{ missing }}` for no useful reason.
+ */
+declare function resolvePath(path: string, context: ExprContext): ExprValue;
+/**
+ * Evaluate a template against a context.
+ *
+ * A string that is EXACTLY one expression returns the resolved value with its
+ * type intact — `{{ $json.count }}` gives you a number, not `"3"`. Anything
+ * else interpolates each run as text. That distinction is load-bearing: it is
+ * what lets a config field carry either a value or a sentence.
+ *
+ * Non-string templates pass through untouched, so this is safe to map over a
+ * whole config object.
+ */
+declare function evaluateExpression(template: ExprValue, context: ExprContext): ExprValue;
+/**
+ * Truthiness for branch / switch decisions.
+ *
+ * Mirrors PHP's rules rather than JavaScript's, because the graph is authored
+ * once and may run on either side. The two disagree in exactly the places a
+ * workflow hits: `"0"` and `"false"` are truthy in JS and falsy here, and an
+ * empty array is truthy in JS and falsy here.
+ */
+declare function truthy(value: ExprValue): boolean;
+/** Coerce a value to text the way interpolation does. */
+declare function text(value: ExprValue): string;
+/**
+ * Resolve every string in a config object, one level of nesting at a time.
+ *
+ * The convenience most hosts actually want, and the shape their hand-rolled
+ * version usually takes. Opt-in like the rest of this module.
+ */
+declare function evaluateConfig<T extends Record<string, ExprValue>>(config: T, context: ExprContext): T;
+
+export { ActionNode, type AlignEdge, AutoLayoutOptions, ConfigFieldRenderFn, ConnectionValidatorOptions, DecisionNode, ExecutorRegistry, type ExprContext, type ExprValue, ExpressionField, type ExpressionFieldProps, FlowCanvas, type FlowCanvasProps, FlowEditor, type FlowEditorAction, type FlowEditorApi, type FlowEditorBuiltins, type FlowEditorProps, type FlowEditorSlots, FlowGraph, FlowNode, type FlowNodeRenderProps, FlowRunControls, type FlowRunControlsProps, FlowRunFeed, FlowRunFeedEntry, type FlowRunFeedProps, LaneNode, NodeCategory, NodeConfigPanel, type NodeConfigPanelProps, NodeKindDefinition, NodePalette, type NodePaletteProps, NodePort, type NodePortProps, type NodePortSide, type NodePortType, NodeRunStatus, NodeShell, type NodeShellProps, NoteNode, OutputNode, SubgraphNode, TriggerNode, WorkflowMetadata, WorkflowSchema, alignNodes, cloneSubgraph, defaultNodeTypes, defineNode, distributeNodes, evaluateConfig, evaluateExpression, flowKeys, flowLive, paletteDropHandlers, reconnectEdge, resolvePath, text, truthy, useFlowEditor, useFlowEditorOptional };

package/dist/index.d.ts

@@ -5,19 +5,19 @@ 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 { b as FlowNode, F as FlowGraph, e as NodeRunStatus, E as ExecutorRegistry } from './types-sOmpCitB.js';
 export { A as ActionNodeData, B as BaseNodeData, D as DecisionNodeData, a as FlowEdge, c as FlowNodeData, d 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-sOmpCitB.js';
-import { C as ConfigFieldRenderFn } from './ConfigFieldRenderer-D2TejNY1.js';
-export { a as ConfigFieldRenderContext, b as ConfigFieldRenderer, c as ConfigFieldRendererProps } from './ConfigFieldRenderer-D2TejNY1.js';
+import { C as ConfigFieldRenderFn } from './ConfigFieldRenderer-BHQDZer6.js';
+export { a as ConfigFieldRenderContext, b as ConfigFieldRenderer, c as ConfigFieldRendererProps } from './ConfigFieldRenderer-BHQDZer6.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';
 export { AutoLayoutDirection } from './layout/index.js';
-import { c as NodeCategory, d as NodeKindDefinition } from './types-Cf75IbxY.js';
-export { a as ConfigField, D as DocumentConfigField, K as KeyValueConfigField, L as LEGACY_PAUSE_PREFIXES, h as PAUSE_PREFIX, P as PauseAwaiting, i as PauseSignal, j as PortSpec, R as RenderBodyContext, t as RepeaterConfigField, u as RepeaterRowField, m as decodePause, n as encodePause, o as isPause, p as pauseForHuman } from './types-Cf75IbxY.js';
+import { c as NodeCategory, d as NodeKindDefinition } from './types-JViq8reb.js';
+export { A as AvailableVariable, a as ConfigField, D as DocumentConfigField, z as ExpressionForm, B as ExpressionGrammarHelp, K as KeyValueConfigField, L as LEGACY_PAUSE_PREFIXES, O as OutputField, F as OutputShape, h as PAUSE_PREFIX, P as PauseAwaiting, i as PauseSignal, j as PortSpec, R as RenderBodyContext, t as RepeaterConfigField, u as RepeaterRowField, G as availableVariables, H as baseVariables, m as decodePause, I as describeExpressionGrammar, n as encodePause, o as isPause, Q as outputFieldsFor, p as pauseForHuman } from './types-JViq8reb.js';
 export { F as FlowNodeStatus, a as FlowViewer, b as FlowViewerClassNames, c as FlowViewerProps } from './FlowViewer-C4QAVgWv.js';
 import { FlowRunFeedEntry } from './runtime/index.js';
 export { HistoryController, UseFlowHistoryReturn, UseFlowRunOptions, UseFlowRunReturn, UseFlowStateReturn, applyOutputsToNodes, applyStatusesToNodes, createHistory, useFlowHistory, useFlowRun, useFlowState } from './runtime/index.js';
 export { C as CohortGuard, a as CohortOptions, b as CohortPolicy, c as CohortResult, R as RunOptions, d as RunResult, r as runCohort, e as runFlow } from './run-cohort-BnP6ErHi.js';
-export { N as NodeKindPresentation, c as categoryAccent, b as clearNodeKindOverrides, d as defaultConfigFor, g as getNodeKind, l as listNodeKinds, o as onNodeKindsChanged, e as overrideNodeKind, r as registerNodeKind, v as validateConfig } from './registry-CS7kjMto.js';
+export { N as NodeKindPresentation, c as categoryAccent, b as clearNodeKindOverrides, d as defaultConfigFor, g as getNodeKind, l as listNodeKinds, o as onNodeKindsChanged, e as overrideNodeKind, r as registerNodeKind, v as validateConfig } from './registry-FGCBprcn.js';
 import './capabilities-CkhKj_U_.js';
 
 type FlowCanvasProps = Omit<ReactFlowProps<FlowNode, Edge>, "nodes" | "edges" | "height"> & {
@@ -98,6 +98,13 @@ type NodeConfigPanelProps = {
      */
     /** Host renderers keyed by field `type`. See {@link ConfigFieldRenderer}. */
     fieldRenderers?: Record<string, ConfigFieldRenderFn>;
+    /**
+     * The graph the node lives in. Supplying it is what makes the `{{ }}` variable
+     * picker context-aware — it reads the UPSTREAM node's declared `outputShape`
+     * to list what is actually reachable here (issue #5). Without it the picker
+     * still opens, but can only offer the whole input.
+     */
+    graph?: FlowGraph;
     renderDocumentField?: (props: {
         documentType?: string;
         value: unknown;
@@ -110,7 +117,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, onDelete, deleteLabel, header, renderCredentialField, renderDocumentField, fieldRenderers, className, style, }: NodeConfigPanelProps): react.JSX.Element;
+declare function NodeConfigPanel({ node, onChange, onDelete, deleteLabel, header, renderCredentialField, renderDocumentField, fieldRenderers, graph, className, style, }: NodeConfigPanelProps): react.JSX.Element;
 
 /**
  * Clone a set of nodes AND the edges internal to that set, remapping every id.
@@ -620,4 +627,116 @@ declare const flowKeys: {
     readonly run: (runId: string) => readonly ["flow", "runs", string];
 };
 
-export { ActionNode, type AlignEdge, AutoLayoutOptions, ConfigFieldRenderFn, ConnectionValidatorOptions, DecisionNode, ExecutorRegistry, FlowCanvas, type FlowCanvasProps, FlowEditor, type FlowEditorAction, type FlowEditorApi, type FlowEditorBuiltins, type FlowEditorProps, type FlowEditorSlots, FlowGraph, FlowNode, type FlowNodeRenderProps, FlowRunControls, type FlowRunControlsProps, FlowRunFeed, FlowRunFeedEntry, type FlowRunFeedProps, LaneNode, NodeCategory, NodeConfigPanel, type NodeConfigPanelProps, NodeKindDefinition, NodePalette, type NodePaletteProps, NodePort, type NodePortProps, type NodePortSide, type NodePortType, NodeRunStatus, NodeShell, type NodeShellProps, NoteNode, OutputNode, SubgraphNode, TriggerNode, WorkflowMetadata, WorkflowSchema, alignNodes, cloneSubgraph, defaultNodeTypes, defineNode, distributeNodes, flowKeys, flowLive, paletteDropHandlers, reconnectEdge, useFlowEditor, useFlowEditorOptional };
+type ExpressionFieldProps = {
+    value: string;
+    onChange: (next: string) => void;
+    placeholder?: string;
+    rows?: number;
+    /** The panel's field id + agent handle. */
+    handle: {
+        id?: string;
+        "data-ff-field": string;
+    };
+    /**
+     * The graph and the node being edited. Both are needed to answer "what can I
+     * write here" — without them the picker can still offer `{{ $json }}` but
+     * nothing node-specific, which is the static list issue #5 asked us not to
+     * ship.
+     */
+    graph?: FlowGraph;
+    nodeId?: string;
+};
+/**
+ * ExpressionField — a `{{ }}` field that tells the author what it accepts.
+ *
+ * Issue #5: the panel rendered a bare textarea with a placeholder and nothing
+ * else, so writing an expression required already knowing both the grammar and
+ * the exact shape of the upstream node's output. Two affordances close that:
+ * typing `{{ ` opens a picker of the variables actually reachable at THIS node,
+ * and a reference toggle explains the grammar.
+ *
+ * The picker deliberately lists only what the resolver can reach — see
+ * `availableVariables`. A suggestion that resolves to `null` at runtime is
+ * worse than no suggestion, because the author has no reason to doubt it.
+ */
+declare function ExpressionField({ value, onChange, placeholder, rows, handle, graph, nodeId, }: ExpressionFieldProps): react.JSX.Element;
+
+/**
+ * `{{ }}` resolution — the TypeScript twin of `FancyFlow\Nodes\Support\Expr`.
+ *
+ * ## Why this is opt-in and not wired into `runFlow`
+ *
+ * The PHP runtime resolves expressions inside its batteries-included executors.
+ * The JS runtime never has: `runFlow` hands `node.data.config` to your executor
+ * verbatim, so every host that uses `{{ }}` today already resolves it itself.
+ * Turning resolution on inside `runFlow` would interpolate a second time over
+ * values those hosts had already substituted — silently, and only for graphs
+ * that happen to contain `{{` in their DATA.
+ *
+ * So this exports the semantics and changes no behaviour. Call it yourself:
+ *
+ * ```ts
+ * const url = evaluateExpression(node.data.config.url, inputs);
+ * ```
+ *
+ * ## The semantics are the PHP file's, deliberately
+ *
+ * This is not a general expression language and must not grow into one. It
+ * resolves a dot-path against a context and nothing else — no arithmetic, no
+ * comparisons, no calls. Hosts that want real expressions override the executor
+ * (the PHP docblock points at symfony/expression-language for the same reason).
+ *
+ * Divergence here is a correctness bug rather than a style difference: the same
+ * graph is authored once and may run on either runtime. `suites/shared/expr`
+ * in `@particle-academy/fancy-conformance` is the fixture table both sides run,
+ * so parity is a test result instead of a claim.
+ */
+/** Anything a context or a resolved value can be. */
+type ExprValue = unknown;
+/** The context an expression resolves against — the executor's `inputs`. */
+type ExprContext = Record<string, ExprValue>;
+/**
+ * Resolve a dot-path against the context, honouring the `$json` / `$input`
+ * alias.
+ *
+ * Both aliases point at the `in` port value when the context has one, and at
+ * the whole context otherwise — the same fallback the PHP does, which is what
+ * makes `{{ $json.x }}` work on a trigger node that has no upstream input.
+ *
+ * A path that does not resolve returns `null`, never `undefined`: PHP has one
+ * absent value and JS has two, and letting the difference leak would make the
+ * two runtimes disagree about `{{ missing }}` for no useful reason.
+ */
+declare function resolvePath(path: string, context: ExprContext): ExprValue;
+/**
+ * Evaluate a template against a context.
+ *
+ * A string that is EXACTLY one expression returns the resolved value with its
+ * type intact — `{{ $json.count }}` gives you a number, not `"3"`. Anything
+ * else interpolates each run as text. That distinction is load-bearing: it is
+ * what lets a config field carry either a value or a sentence.
+ *
+ * Non-string templates pass through untouched, so this is safe to map over a
+ * whole config object.
+ */
+declare function evaluateExpression(template: ExprValue, context: ExprContext): ExprValue;
+/**
+ * Truthiness for branch / switch decisions.
+ *
+ * Mirrors PHP's rules rather than JavaScript's, because the graph is authored
+ * once and may run on either side. The two disagree in exactly the places a
+ * workflow hits: `"0"` and `"false"` are truthy in JS and falsy here, and an
+ * empty array is truthy in JS and falsy here.
+ */
+declare function truthy(value: ExprValue): boolean;
+/** Coerce a value to text the way interpolation does. */
+declare function text(value: ExprValue): string;
+/**
+ * Resolve every string in a config object, one level of nesting at a time.
+ *
+ * The convenience most hosts actually want, and the shape their hand-rolled
+ * version usually takes. Opt-in like the rest of this module.
+ */
+declare function evaluateConfig<T extends Record<string, ExprValue>>(config: T, context: ExprContext): T;
+
+export { ActionNode, type AlignEdge, AutoLayoutOptions, ConfigFieldRenderFn, ConnectionValidatorOptions, DecisionNode, ExecutorRegistry, type ExprContext, type ExprValue, ExpressionField, type ExpressionFieldProps, FlowCanvas, type FlowCanvasProps, FlowEditor, type FlowEditorAction, type FlowEditorApi, type FlowEditorBuiltins, type FlowEditorProps, type FlowEditorSlots, FlowGraph, FlowNode, type FlowNodeRenderProps, FlowRunControls, type FlowRunControlsProps, FlowRunFeed, FlowRunFeedEntry, type FlowRunFeedProps, LaneNode, NodeCategory, NodeConfigPanel, type NodeConfigPanelProps, NodeKindDefinition, NodePalette, type NodePaletteProps, NodePort, type NodePortProps, type NodePortSide, type NodePortType, NodeRunStatus, NodeShell, type NodeShellProps, NoteNode, OutputNode, SubgraphNode, TriggerNode, WorkflowMetadata, WorkflowSchema, alignNodes, cloneSubgraph, defaultNodeTypes, defineNode, distributeNodes, evaluateConfig, evaluateExpression, flowKeys, flowLive, paletteDropHandlers, reconnectEdge, resolvePath, text, truthy, useFlowEditor, useFlowEditorOptional };