@notmrabhi/flowforge 0.1.42 → 0.1.45

package/dist/canvas.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./templateSkeletons-DKBMuT6K.js"),t=require("./messages-O9Tw_XXR.js"),r=require("./bpmn-CcuE2X_Q.js"),o=require("./GatewayBranchEdge-CMY30xhz.js");exports.FlowForgeCanvas=e.FlowForgeCanvas;exports.FlowForgeHeader=e.FlowForgeHeader;exports.SubWorkflowPreviewDrawer=e.SubWorkflowPreviewDrawer;exports.WorkflowCanvas=e.FlowForgeCanvas;exports.WorkflowExecutionHistory=e.WorkflowExecutionHistory;exports.WorkflowTemplateLibrary=e.WorkflowTemplateLibrary;exports.accessRequestSkeleton=e.accessRequestSkeleton;exports.offboardingSkeleton=e.offboardingSkeleton;exports.userOnboardingSkeleton=e.userOnboardingSkeleton;exports.webhookIntegrationSkeleton=e.webhookIntegrationSkeleton;exports.defaultFlowForgeMessages=t.defaultFlowForgeMessages;exports.loadWorkflowFromBpmn=r.loadWorkflowFromBpmn;exports.saveWorkflowToBpmn=r.saveWorkflowToBpmn;exports.ActionNode=o.ActionNode;exports.ApprovalNode=o.ApprovalNode;exports.EdgeWithPlusLabel=o.EdgeWithPlusLabel;exports.EndNode=o.EndNode;exports.FilterNode=o.FilterNode;exports.RestApiNode=o.RestApiNode;exports.StartNode=o.StartNode;exports.TriggerNode=o.TriggerNode;exports.WebhookTriggerNode=o.WebhookTriggerNode;exports.builtInNodeTypes=o.builtInNodeTypes;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./templateSkeletons-Cm_MIeT0.js"),t=require("./messages-O9Tw_XXR.js"),r=require("./bpmn-CcuE2X_Q.js"),o=require("./GatewayBranchEdge-CMY30xhz.js");exports.FlowForgeCanvas=e.FlowForgeCanvas;exports.FlowForgeHeader=e.FlowForgeHeader;exports.SubWorkflowPreviewDrawer=e.SubWorkflowPreviewDrawer;exports.WorkflowCanvas=e.FlowForgeCanvas;exports.WorkflowExecutionHistory=e.WorkflowExecutionHistory;exports.WorkflowTemplateLibrary=e.WorkflowTemplateLibrary;exports.accessRequestSkeleton=e.accessRequestSkeleton;exports.offboardingSkeleton=e.offboardingSkeleton;exports.userOnboardingSkeleton=e.userOnboardingSkeleton;exports.webhookIntegrationSkeleton=e.webhookIntegrationSkeleton;exports.defaultFlowForgeMessages=t.defaultFlowForgeMessages;exports.loadWorkflowFromBpmn=r.loadWorkflowFromBpmn;exports.saveWorkflowToBpmn=r.saveWorkflowToBpmn;exports.ActionNode=o.ActionNode;exports.ApprovalNode=o.ApprovalNode;exports.EdgeWithPlusLabel=o.EdgeWithPlusLabel;exports.EndNode=o.EndNode;exports.FilterNode=o.FilterNode;exports.RestApiNode=o.RestApiNode;exports.StartNode=o.StartNode;exports.TriggerNode=o.TriggerNode;exports.WebhookTriggerNode=o.WebhookTriggerNode;exports.builtInNodeTypes=o.builtInNodeTypes;
 //# sourceMappingURL=canvas.cjs.map

package/dist/canvas.d.ts

@@ -159,6 +159,13 @@ declare interface ConditionFieldDef {
         value: string;
         label: string;
     }>;
+    /**
+     * Declarative dynamic options — same shape as `FieldDescriptor.optionsSource`.
+     * `dependsOn` resolves against the OUTER form values (not the condition entry),
+     * so a condition column can depend on another top-level field (e.g. attributes
+     * scoped by `applicationUuid`).
+     */
+    optionsSource?: OptionsSource;
     /** When true, renders a FormulaInput chip editor instead of a plain <input> */
     formula?: boolean;
 }
@@ -182,6 +189,13 @@ declare interface ConditionFieldDef_2 {
         value: string;
         label: string;
     }>;
+    /**
+     * Declarative dynamic options — same shape as `FieldDescriptor.optionsSource`.
+     * `dependsOn` resolves against the OUTER form values (not the condition entry),
+     * so a condition column can depend on another top-level field (e.g. attributes
+     * scoped by `applicationUuid`).
+     */
+    optionsSource?: OptionsSource_2;
     /** When true, renders a FormulaInput chip editor instead of a plain <input> */
     formula?: boolean;
 }
@@ -333,6 +347,12 @@ declare interface FieldDescriptor {
     onChange?: (value: unknown, ctx: FieldContext & {
         setFieldValue: (name: string, value: unknown) => void;
     }) => void;
+    /**
+     * Declarative dynamic options. The renderer translates this into a paged,
+     * cached, abortable async loader via the host's resolver registry.
+     * Mutually compatible with static `options`: static wins if both set.
+     */
+    optionsSource?: OptionsSource;
     [key: string]: unknown;
 }
 
@@ -381,6 +401,12 @@ declare interface FieldDescriptor_2 {
     onChange?: (value: unknown, ctx: FieldContext_2 & {
         setFieldValue: (name: string, value: unknown) => void;
     }) => void;
+    /**
+     * Declarative dynamic options. The renderer translates this into a paged,
+     * cached, abortable async loader via the host's resolver registry.
+     * Mutually compatible with static `options`: static wins if both set.
+     */
+    optionsSource?: OptionsSource_2;
     [key: string]: unknown;
 }
 
@@ -439,7 +465,7 @@ declare interface FixedNode_3 {
     deletable?: false;
 }
 
-declare const FlowForgeCanvas: ({ nodeRegistry, templateRegistry, initialValue, nodeTypes: consumerNodeTypes, edgeTypes: consumerEdgeTypes, onSave, readOnly, theme, messages: messageOverrides, canvasOptions, renderTriggerSelector, loadTriggerSources, renderNodePicker, renderNodeConfig, onNodeClick: onNodeClickProp, maxNodes, layoutDirection, executionRecord, onFetchWorkflow, hideHeader, workflowName, onWorkflowNameChange, onCancel, workflowStatus, workflowStatusColor, saveLabel, }: FlowForgeCanvasProps) => JSX_2.Element;
+declare const FlowForgeCanvas: ({ nodeRegistry, templateRegistry, initialValue, nodeTypes: consumerNodeTypes, edgeTypes: consumerEdgeTypes, onSave, readOnly, theme, messages: messageOverrides, canvasOptions, renderTriggerSelector, loadTriggerSources, renderNodePicker, renderNodeConfig, onNodeClick: onNodeClickProp, maxNodes, layoutDirection, executionRecord, onFetchWorkflow, hideHeader, workflowName, onWorkflowNameChange, onCancel, workflowStatus, workflowStatusColor, saveLabel, optionsResolvers, }: FlowForgeCanvasProps) => JSX_2.Element;
 export { FlowForgeCanvas }
 export { FlowForgeCanvas as WorkflowCanvas }
 
@@ -541,6 +567,27 @@ export declare interface FlowForgeCanvasProps {
     workflowStatusColor?: 'gray' | 'green' | 'amber' | 'red' | string;
     /** Override the Save button label. */
     saveLabel?: string;
+    /**
+     * Host-registered map of named option resolvers. Fields in any node's
+     * `formSchema` may declare `optionsSource: { id, dependsOn, params }` to
+     * populate a select asynchronously. Transport-agnostic — the host's
+     * resolver can use axios, fetch, GraphQL, etc.
+     *
+     * Example:
+     *   optionsResolvers={{
+     *     'app:groups': async ({ appId }, { cursor=0 }) => {
+     *       const res = await api.get(`/groups?startIndex=${cursor}&count=50`);
+     *       return {
+     *         options: res.data.map(g => ({ value: g.uuid, label: g.name })),
+     *         nextCursor: res.data.length === 50 ? cursor + 50 : undefined,
+     *       };
+     *     }
+     *   }}
+     *
+     * Resolvers are cached for the session keyed by (resolverId, deps). Use
+     * `useOptionsResolvers().invalidate(id)` to bust a cache entry manually.
+     */
+    optionsResolvers?: OptionsResolvers;
 }
 
 export declare function FlowForgeHeader({ workflowName, onWorkflowNameChange, status, statusColor, onSave, onCancel, saveLabel, saveDisabled, }: FlowForgeHeaderProps): JSX_2.Element;
@@ -777,6 +824,89 @@ declare class NodeTypeRegistry {
 
 export declare const offboardingSkeleton: WorkflowState;
 
+/** A resolver function — transport-agnostic. */
+declare type OptionsResolver = (deps: Record<string, unknown>, ctx: OptionsResolverContext) => Promise<OptionsResolverResult>;
+
+/** Args passed to a resolver per call — cursor for pagination, input for typeahead. */
+declare interface OptionsResolverContext {
+    cursor?: unknown;
+    input?: string;
+    /** Full top-level form values, in case a resolver needs read-only access. */
+    values?: Record<string, unknown>;
+    /** AbortSignal — resolvers SHOULD honor this when their transport supports it. */
+    signal?: AbortSignal;
+}
+
+/** Resolver return shape — matches Pipedream's `options` contract. */
+declare interface OptionsResolverResult {
+    options: Array<{
+        value: unknown;
+        label: string;
+        isDisabled?: boolean;
+        [key: string]: unknown;
+    }>;
+    /** Opaque cursor returned to the next call. Omit to signal "no more pages". */
+    nextCursor?: unknown;
+}
+
+/**
+ * Map of named resolvers — the host registers these once on the canvas / form.
+ * Keys are the `optionsSource.id` strings referenced by field descriptors.
+ */
+declare type OptionsResolvers = Record<string, OptionsResolver>;
+
+declare interface OptionsSource {
+    /** Resolver id — must match a key in the host's `optionsResolvers` map. */
+    id: string;
+    /**
+     * Other field values this resolver depends on. Two shapes accepted:
+     *  - `string[]`     — pass through verbatim ({ fieldA: values.fieldA, ... })
+     *  - `Record<arg, fieldName>` — rename parent values for the resolver
+     *
+     * When any dep value changes, the cache key for this field invalidates
+     * and the resolver re-fires.
+     */
+    dependsOn?: string[] | Record<string, string>;
+    /**
+     * Static params merged into the deps object for every call. Use for
+     * "URL template via the generic resolver" style:
+     *   { id: 'default', params: { url: '/groups', valueKey: 'uuid' } }
+     */
+    params?: Record<string, unknown>;
+    /**
+     * Lookup individual options by value (edit-mode hydration). When set,
+     * the field calls this resolver with `{ ids: [...] }` to render labels
+     * for already-selected values that aren't in the current page.
+     */
+    resolveValueId?: string;
+}
+
+declare interface OptionsSource_2 {
+    /** Resolver id — must match a key in the host's `optionsResolvers` map. */
+    id: string;
+    /**
+     * Other field values this resolver depends on. Two shapes accepted:
+     *  - `string[]`     — pass through verbatim ({ fieldA: values.fieldA, ... })
+     *  - `Record<arg, fieldName>` — rename parent values for the resolver
+     *
+     * When any dep value changes, the cache key for this field invalidates
+     * and the resolver re-fires.
+     */
+    dependsOn?: string[] | Record<string, string>;
+    /**
+     * Static params merged into the deps object for every call. Use for
+     * "URL template via the generic resolver" style:
+     *   { id: 'default', params: { url: '/groups', valueKey: 'uuid' } }
+     */
+    params?: Record<string, unknown>;
+    /**
+     * Lookup individual options by value (edit-mode hydration). When set,
+     * the field calls this resolver with `{ ids: [...] }` to render labels
+     * for already-selected values that aren't in the current page.
+     */
+    resolveValueId?: string;
+}
+
 export declare const RestApiNode: ({ id, data }: NodeProps) => JSX_2.Element;
 
 export declare function saveWorkflowToBpmn(workflow: WorkflowState, options?: BpmnSaveOptions): string;

package/dist/canvas.js

@@ -1,4 +1,4 @@
-import { F as a, a as s, S as r, F as l, W as t, b as d, c as n, o as i, u as f, w } from "./templateSkeletons-CFMb6KIK.js";
+import { F as a, a as s, S as r, F as l, W as t, b as d, c as n, o as i, u as f, w } from "./templateSkeletons-_F-r1-ef.js";
 import { d as k } from "./messages-CO299wPN.js";
 import { l as F, s as b } from "./bpmn-CtfWDaOY.js";
 import { A as N, b as m, E as u, c as S, F as c, R as T, S as v, T as x, W as A, e as E } from "./GatewayBranchEdge-CrgczPYJ.js";

package/dist/core.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./index-BrJBVztu.js"),o=require("./index-CXmgrKoe.js"),s=require("./messages-O9Tw_XXR.js"),t=require("./bpmn-CcuE2X_Q.js"),e=require("./subWorkflowDescriptor-JDKi2INh.js");exports.NodeTypeRegistry=r.NodeTypeRegistry;exports.nodeTypeRegistry=r.nodeTypeRegistry;exports.TemplateRegistry=o.TemplateRegistry;exports.templateRegistry=o.templateRegistry;exports.defaultFlowForgeMessages=s.defaultFlowForgeMessages;exports.loadWorkflowFromBpmn=t.loadWorkflowFromBpmn;exports.saveWorkflowToBpmn=t.saveWorkflowToBpmn;exports.baseNodeDefaults=e.baseNodeDefaults;exports.conditionBranchDescriptor=e.conditionBranchDescriptor;exports.defineNode=e.defineNode;exports.endEventDescriptor=e.endEventDescriptor;exports.makeSubWorkflowDescriptor=e.makeSubWorkflowDescriptor;exports.notificationDescriptor=e.notificationDescriptor;exports.restApiDescriptor=e.restApiDescriptor;exports.startEventDescriptor=e.startEventDescriptor;exports.subWorkflowDescriptor=e.subWorkflowDescriptor;exports.webhookTriggerDescriptor=e.webhookTriggerDescriptor;exports.webhookTriggerTemplate=e.webhookTriggerTemplate;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./nodeRegistry.cjs"),r=require("./templateRegistry.cjs"),t=require("./messages-O9Tw_XXR.js"),o=require("./bpmn-CcuE2X_Q.js");exports.NodeTypeRegistry=e.NodeTypeRegistry;exports.baseNodeDefaults=e.baseNodeDefaults;exports.conditionBranchDescriptor=e.conditionBranchDescriptor;exports.defineNode=e.defineNode;exports.endEventDescriptor=e.endEventDescriptor;exports.makeSubWorkflowDescriptor=e.makeSubWorkflowDescriptor;exports.nodeTypeRegistry=e.nodeTypeRegistry;exports.notificationDescriptor=e.notificationDescriptor;exports.restApiDescriptor=e.restApiDescriptor;exports.startEventDescriptor=e.startEventDescriptor;exports.subWorkflowDescriptor=e.subWorkflowDescriptor;exports.webhookTriggerDescriptor=e.webhookTriggerDescriptor;exports.webhookTriggerTemplate=e.webhookTriggerTemplate;exports.TemplateRegistry=r.TemplateRegistry;exports.templateRegistry=r.templateRegistry;exports.defaultFlowForgeMessages=t.defaultFlowForgeMessages;exports.loadWorkflowFromBpmn=o.loadWorkflowFromBpmn;exports.saveWorkflowToBpmn=o.saveWorkflowToBpmn;
 //# sourceMappingURL=core.cjs.map

package/dist/core.d.ts

@@ -80,6 +80,13 @@ declare interface ConditionFieldDef {
         value: string;
         label: string;
     }>;
+    /**
+     * Declarative dynamic options — same shape as `FieldDescriptor.optionsSource`.
+     * `dependsOn` resolves against the OUTER form values (not the condition entry),
+     * so a condition column can depend on another top-level field (e.g. attributes
+     * scoped by `applicationUuid`).
+     */
+    optionsSource?: OptionsSource;
     /** When true, renders a FormulaInput chip editor instead of a plain <input> */
     formula?: boolean;
 }
@@ -189,6 +196,12 @@ declare interface FieldDescriptor {
     onChange?: (value: unknown, ctx: FieldContext & {
         setFieldValue: (name: string, value: unknown) => void;
     }) => void;
+    /**
+     * Declarative dynamic options. The renderer translates this into a paged,
+     * cached, abortable async loader via the host's resolver registry.
+     * Mutually compatible with static `options`: static wins if both set.
+     */
+    optionsSource?: OptionsSource;
     [key: string]: unknown;
 }
 
@@ -323,6 +336,32 @@ export declare const nodeTypeRegistry: NodeTypeRegistry;
 
 export declare const notificationDescriptor: NodeDescriptor;
 
+declare interface OptionsSource {
+    /** Resolver id — must match a key in the host's `optionsResolvers` map. */
+    id: string;
+    /**
+     * Other field values this resolver depends on. Two shapes accepted:
+     *  - `string[]`     — pass through verbatim ({ fieldA: values.fieldA, ... })
+     *  - `Record<arg, fieldName>` — rename parent values for the resolver
+     *
+     * When any dep value changes, the cache key for this field invalidates
+     * and the resolver re-fires.
+     */
+    dependsOn?: string[] | Record<string, string>;
+    /**
+     * Static params merged into the deps object for every call. Use for
+     * "URL template via the generic resolver" style:
+     *   { id: 'default', params: { url: '/groups', valueKey: 'uuid' } }
+     */
+    params?: Record<string, unknown>;
+    /**
+     * Lookup individual options by value (edit-mode hydration). When set,
+     * the field calls this resolver with `{ ids: [...] }` to render labels
+     * for already-selected values that aren't in the current page.
+     */
+    resolveValueId?: string;
+}
+
 /** The fields every node MUST provide — there is no sensible default for these. */
 declare type RequiredNodeFields = Pick<NodeDescriptor, 'type' | 'label' | 'matches' | 'reactFlowType'>;
 

package/dist/core.js

@@ -1,26 +1,25 @@
-import { NodeTypeRegistry as o, nodeTypeRegistry as s } from "./index-Dcur-XJ9.js";
-import { TemplateRegistry as a, templateRegistry as i } from "./index-B6xrei80.js";
-import { d as f } from "./messages-CO299wPN.js";
-import { l as n, s as c } from "./bpmn-CtfWDaOY.js";
-import { b as d, c as g, d as D, e as w, m as k, n as T, r as b, s as y, a as x, w as u, f as R } from "./subWorkflowDescriptor-DYOYgBzX.js";
+import { NodeTypeRegistry as r, baseNodeDefaults as t, conditionBranchDescriptor as s, defineNode as i, endEventDescriptor as p, makeSubWorkflowDescriptor as a, nodeTypeRegistry as f, notificationDescriptor as l, restApiDescriptor as n, startEventDescriptor as c, subWorkflowDescriptor as m, webhookTriggerDescriptor as d, webhookTriggerTemplate as g } from "./nodeRegistry.js";
+import { TemplateRegistry as k, templateRegistry as w } from "./templateRegistry.js";
+import { d as y } from "./messages-CO299wPN.js";
+import { l as u, s as x } from "./bpmn-CtfWDaOY.js";
 export {
-  o as NodeTypeRegistry,
-  a as TemplateRegistry,
-  d as baseNodeDefaults,
-  g as conditionBranchDescriptor,
-  f as defaultFlowForgeMessages,
-  D as defineNode,
-  w as endEventDescriptor,
-  n as loadWorkflowFromBpmn,
-  k as makeSubWorkflowDescriptor,
-  s as nodeTypeRegistry,
-  T as notificationDescriptor,
-  b as restApiDescriptor,
-  c as saveWorkflowToBpmn,
-  y as startEventDescriptor,
-  x as subWorkflowDescriptor,
-  i as templateRegistry,
-  u as webhookTriggerDescriptor,
-  R as webhookTriggerTemplate
+  r as NodeTypeRegistry,
+  k as TemplateRegistry,
+  t as baseNodeDefaults,
+  s as conditionBranchDescriptor,
+  y as defaultFlowForgeMessages,
+  i as defineNode,
+  p as endEventDescriptor,
+  u as loadWorkflowFromBpmn,
+  a as makeSubWorkflowDescriptor,
+  f as nodeTypeRegistry,
+  l as notificationDescriptor,
+  n as restApiDescriptor,
+  x as saveWorkflowToBpmn,
+  c as startEventDescriptor,
+  m as subWorkflowDescriptor,
+  w as templateRegistry,
+  d as webhookTriggerDescriptor,
+  g as webhookTriggerTemplate
 };
 //# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;"}
+{"version":3,"file":"core.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;"}

package/dist/form.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-CqMPyOkL.js"),r=require("./SchemaBuilderDrawer-CiSdfXzJ.js");require("react/jsx-runtime");require("react");require("@mui/material");require("react-icons/md");exports.DynamicFormRenderer=e.DynamicFormRenderer;exports.FF=e.FF;exports.FlowForgeRegistry=e.FlowForgeRegistry;exports.FlowForm=e.FlowForm;exports.FormulaInput=e.FormulaInput;exports.InfiniteSelectField=e.InfiniteSelectField;exports.TablePickerField=e.TablePickerField;exports.VariablePicker=e.VariablePicker;exports.VariablePickerProvider=e.VariablePickerProvider;exports.astHasRefs=e.astHasRefs;exports.astToTokens=e.astToTokens;exports.buildEvaluationPayload=e.buildEvaluationPayload;exports.buildFieldConfig=e.buildFieldConfig;exports.buildFormulaPath=e.buildFormulaPath;exports.buildSelectStyles=e.buildSelectStyles;exports.buildValidationSchema=e.buildValidationSchema;exports.errorTextStyle=e.errorTextStyle;exports.extractLabel=e.extractLabel;exports.fieldRegistry=e.fieldRegistry;exports.hasFormulaTokens=e.hasFormulaTokens;exports.helperTextStyle=e.helperTextStyle;exports.inputStyle=e.inputStyle;exports.isFormula=e.isFormula;exports.parseToAST=e.parseToAST;exports.serializeAST=e.serializeAST;exports.serializeASTAsConfig=e.serializeASTAsConfig;exports.serializeConditionExpressions=e.serializeConditionExpressions;exports.stripFormulaTokens=e.stripFormulaTokens;exports.tokenize=e.tokenize;exports.unwrapFormula=e.unwrapFormula;exports.useVariablePickerContext=e.useVariablePickerContext;exports.wrapFormula=e.wrapFormula;exports.FIELD_TYPE_OPTIONS=r.FIELD_TYPE_OPTIONS;exports.SchemaBuilder=r.SchemaBuilder;exports.SchemaBuilderDrawer=r.SchemaBuilderDrawer;exports.useFlowForm=r.useFlowForm;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-CY05DpP5.js"),r=require("./SchemaBuilderDrawer-CwnowdK9.js");require("react/jsx-runtime");require("react");require("@mui/material");require("react-icons/md");exports.DynamicFormRenderer=e.DynamicFormRenderer;exports.FF=e.FF;exports.FlowForgeRegistry=e.FlowForgeRegistry;exports.FlowForm=e.FlowForm;exports.FormulaInput=e.FormulaInput;exports.InfiniteSelectField=e.InfiniteSelectField;exports.OptionsResolversProvider=e.OptionsResolversProvider;exports.TablePickerField=e.TablePickerField;exports.VariablePicker=e.VariablePicker;exports.VariablePickerProvider=e.VariablePickerProvider;exports.astHasRefs=e.astHasRefs;exports.astToTokens=e.astToTokens;exports.buildEvaluationPayload=e.buildEvaluationPayload;exports.buildFieldConfig=e.buildFieldConfig;exports.buildFormulaPath=e.buildFormulaPath;exports.buildSelectStyles=e.buildSelectStyles;exports.buildValidationSchema=e.buildValidationSchema;exports.errorTextStyle=e.errorTextStyle;exports.extractLabel=e.extractLabel;exports.fieldRegistry=e.fieldRegistry;exports.hasFormulaTokens=e.hasFormulaTokens;exports.helperTextStyle=e.helperTextStyle;exports.inputStyle=e.inputStyle;exports.isFormula=e.isFormula;exports.parseToAST=e.parseToAST;exports.serializeAST=e.serializeAST;exports.serializeASTAsConfig=e.serializeASTAsConfig;exports.serializeConditionExpressions=e.serializeConditionExpressions;exports.stripFormulaTokens=e.stripFormulaTokens;exports.tokenize=e.tokenize;exports.unwrapFormula=e.unwrapFormula;exports.useDynamicOptions=e.useDynamicOptions;exports.useOptionsResolvers=e.useOptionsResolvers;exports.useVariablePickerContext=e.useVariablePickerContext;exports.wrapFormula=e.wrapFormula;exports.FIELD_TYPE_OPTIONS=r.FIELD_TYPE_OPTIONS;exports.SchemaBuilder=r.SchemaBuilder;exports.SchemaBuilderDrawer=r.SchemaBuilderDrawer;exports.useFlowForm=r.useFlowForm;
 //# sourceMappingURL=form.cjs.map

package/dist/form.d.ts

@@ -161,6 +161,13 @@ export declare interface ConditionFieldDef {
         value: string;
         label: string;
     }>;
+    /**
+     * Declarative dynamic options — same shape as `FieldDescriptor.optionsSource`.
+     * `dependsOn` resolves against the OUTER form values (not the condition entry),
+     * so a condition column can depend on another top-level field (e.g. attributes
+     * scoped by `applicationUuid`).
+     */
+    optionsSource?: OptionsSource;
     /** When true, renders a FormulaInput chip editor instead of a plain <input> */
     formula?: boolean;
 }
@@ -356,6 +363,12 @@ export declare interface FieldDescriptor {
     onChange?: (value: unknown, ctx: FieldContext & {
         setFieldValue: (name: string, value: unknown) => void;
     }) => void;
+    /**
+     * Declarative dynamic options. The renderer translates this into a paged,
+     * cached, abortable async loader via the host's resolver registry.
+     * Mutually compatible with static `options`: static wins if both set.
+     */
+    optionsSource?: OptionsSource;
     [key: string]: unknown;
 }
 
@@ -554,6 +567,13 @@ declare interface FormulaProps {
         isValid: boolean;
         errors: Record<string, unknown>;
     }) => void;
+    /**
+     * Host-registered resolver map for declarative dynamic options.
+     * Fields with `optionsSource: { id: '...', dependsOn: ... }` look up
+     * their loader in this map. Transport-agnostic — use axios, fetch,
+     * GraphQL, anything that returns a Promise.
+     */
+    optionsResolvers?: OptionsResolvers;
 }
 
 export declare type FormulaToken = TextToken | ChipToken;
@@ -630,6 +650,74 @@ export declare interface ObjectFieldRendererProps {
     item?: Record<string, unknown>;
 }
 
+/** A resolver function — transport-agnostic. */
+export declare type OptionsResolver = (deps: Record<string, unknown>, ctx: OptionsResolverContext) => Promise<OptionsResolverResult>;
+
+/** Args passed to a resolver per call — cursor for pagination, input for typeahead. */
+export declare interface OptionsResolverContext {
+    cursor?: unknown;
+    input?: string;
+    /** Full top-level form values, in case a resolver needs read-only access. */
+    values?: Record<string, unknown>;
+    /** AbortSignal — resolvers SHOULD honor this when their transport supports it. */
+    signal?: AbortSignal;
+}
+
+/** Resolver return shape — matches Pipedream's `options` contract. */
+export declare interface OptionsResolverResult {
+    options: Array<{
+        value: unknown;
+        label: string;
+        isDisabled?: boolean;
+        [key: string]: unknown;
+    }>;
+    /** Opaque cursor returned to the next call. Omit to signal "no more pages". */
+    nextCursor?: unknown;
+}
+
+/**
+ * Map of named resolvers — the host registers these once on the canvas / form.
+ * Keys are the `optionsSource.id` strings referenced by field descriptors.
+ */
+export declare type OptionsResolvers = Record<string, OptionsResolver>;
+
+declare interface OptionsResolversContextValue {
+    resolvers: OptionsResolvers;
+    /**
+     * Bust a single resolver's cache. Useful for an explicit "Refresh" button.
+     * Pass undefined to clear ALL cached pages for that resolver.
+     */
+    invalidate: (resolverId: string, depsKey?: string) => void;
+}
+
+export declare function OptionsResolversProvider({ resolvers, children }: ProviderProps): JSX_2.Element;
+
+export declare interface OptionsSource {
+    /** Resolver id — must match a key in the host's `optionsResolvers` map. */
+    id: string;
+    /**
+     * Other field values this resolver depends on. Two shapes accepted:
+     *  - `string[]`     — pass through verbatim ({ fieldA: values.fieldA, ... })
+     *  - `Record<arg, fieldName>` — rename parent values for the resolver
+     *
+     * When any dep value changes, the cache key for this field invalidates
+     * and the resolver re-fires.
+     */
+    dependsOn?: string[] | Record<string, string>;
+    /**
+     * Static params merged into the deps object for every call. Use for
+     * "URL template via the generic resolver" style:
+     *   { id: 'default', params: { url: '/groups', valueKey: 'uuid' } }
+     */
+    params?: Record<string, unknown>;
+    /**
+     * Lookup individual options by value (edit-mode hydration). When set,
+     * the field calls this resolver with `{ ids: [...] }` to render labels
+     * for already-selected values that aren't in the current page.
+     */
+    resolveValueId?: string;
+}
+
 /**
  * Parse a raw backend string into an AST node array.
  *
@@ -664,6 +752,11 @@ export declare interface PathRefNode {
     label: string;
 }
 
+declare interface ProviderProps {
+    resolvers?: OptionsResolvers;
+    children: default_2.ReactNode;
+}
+
 declare class Registry {
     private fields;
     constructor();
@@ -864,6 +957,32 @@ declare interface UncontrolledProps extends FormulaProps {
 
 export declare function unwrapFormula(value: string): string;
 
+/**
+ * Returns a drop-in `loadOptions` for react-select when a field's
+ * `optionsSource` is set and the host has registered a matching resolver.
+ * Otherwise returns `enabled: false` and the host falls back to the
+ * descriptor's static `options` (or no options).
+ */
+export declare function useDynamicOptions({ source, values }: UseDynamicOptionsArgs): UseDynamicOptionsResult;
+
+declare interface UseDynamicOptionsArgs {
+    source: OptionsSource | undefined;
+    values: Record<string, unknown>;
+}
+
+declare interface UseDynamicOptionsResult {
+    /** True when the host configured a usable resolver for this field. */
+    enabled: boolean;
+    /** Drop-in `loadOptions(inputValue) => Promise<Option[]>` for react-select. */
+    loadOptions: ((input: string) => Promise<OptionsResolverResult['options']>) | undefined;
+    /** Drop-in `loadValue(ids) => Promise<Option[]>` for edit-mode hydration. */
+    loadValue: ((ids: unknown[]) => Promise<OptionsResolverResult['options']>) | undefined;
+    /** Stable key derived from deps — feed to react-select's `key` to refresh on change. */
+    depsKey: string;
+    /** Manually invalidate this field's cache (e.g. for a Refresh button). */
+    refresh: () => void;
+}
+
 export declare function useFlowForm({ schema, initialValues, onSubmit, showErrorsImmediately, }: UseFlowFormOptions): FlowFormInstance;
 
 export declare interface UseFlowFormOptions {
@@ -879,6 +998,8 @@ export declare interface UseFlowFormOptions {
     showErrorsImmediately?: boolean;
 }
 
+export declare function useOptionsResolvers(): OptionsResolversContextValue;
+
 export declare function useVariablePickerContext(): VariablePickerContextValue | null;
 
 export declare interface VariableGroup {

package/dist/form.js

@@ -1,45 +1,48 @@
-import { D as o, F as t, a as u, b as F, c as m, I as n, T as d, V as p, d as S, e as T, f as c, g as b, h as k, i as y, j as P, k as f, l as x, m as h, n as w, o as g, p as z, q as A, r as I, s as V, t as C, u as D, v as E, w as R, x as v, y as B, z as L, A as O } from "./index-B74jTc2b.js";
-import { F as j, S as q, a as H, u as N } from "./SchemaBuilderDrawer-CUzYWGCN.js";
+import { D as l, F as t, a as n, b as u, c as m, I as F, O as d, T as p, V as S, d as T, e as c, f as b, g as y, h as P, i as k, j as f, k as x, l as h, m as w, n as g, o as v, p as O, q as R, r as z, s as A, t as C, u as D, v as I, w as V, x as E, y as B, z as L, A as _, B as j, C as q } from "./index-VUTKHpvC.js";
+import { F as N, S as Y, a as G, u as J } from "./SchemaBuilderDrawer-Dx6Nd6uF.js";
 import "react/jsx-runtime";
 import "react";
 import "@mui/material";
 import "react-icons/md";
 export {
-  o as DynamicFormRenderer,
+  l as DynamicFormRenderer,
   t as FF,
-  j as FIELD_TYPE_OPTIONS,
-  u as FlowForgeRegistry,
-  F as FlowForm,
+  N as FIELD_TYPE_OPTIONS,
+  n as FlowForgeRegistry,
+  u as FlowForm,
   m as FormulaInput,
-  n as InfiniteSelectField,
-  q as SchemaBuilder,
-  H as SchemaBuilderDrawer,
-  d as TablePickerField,
-  p as VariablePicker,
-  S as VariablePickerProvider,
-  T as astHasRefs,
-  c as astToTokens,
-  b as buildEvaluationPayload,
-  k as buildFieldConfig,
-  y as buildFormulaPath,
-  P as buildSelectStyles,
-  f as buildValidationSchema,
-  x as errorTextStyle,
-  h as extractLabel,
-  w as fieldRegistry,
-  g as hasFormulaTokens,
-  z as helperTextStyle,
-  A as inputStyle,
-  I as isFormula,
-  V as parseToAST,
+  F as InfiniteSelectField,
+  d as OptionsResolversProvider,
+  Y as SchemaBuilder,
+  G as SchemaBuilderDrawer,
+  p as TablePickerField,
+  S as VariablePicker,
+  T as VariablePickerProvider,
+  c as astHasRefs,
+  b as astToTokens,
+  y as buildEvaluationPayload,
+  P as buildFieldConfig,
+  k as buildFormulaPath,
+  f as buildSelectStyles,
+  x as buildValidationSchema,
+  h as errorTextStyle,
+  w as extractLabel,
+  g as fieldRegistry,
+  v as hasFormulaTokens,
+  O as helperTextStyle,
+  R as inputStyle,
+  z as isFormula,
+  A as parseToAST,
   C as serializeAST,
   D as serializeASTAsConfig,
-  E as serializeConditionExpressions,
-  R as stripFormulaTokens,
-  v as tokenize,
+  I as serializeConditionExpressions,
+  V as stripFormulaTokens,
+  E as tokenize,
   B as unwrapFormula,
-  N as useFlowForm,
-  L as useVariablePickerContext,
-  O as wrapFormula
+  L as useDynamicOptions,
+  J as useFlowForm,
+  _ as useOptionsResolvers,
+  j as useVariablePickerContext,
+  q as wrapFormula
 };
 //# sourceMappingURL=form.js.map

package/dist/{index-B8-KKaH_.js → index-C9s5LB8m.js}

@@ -1,4 +1,4 @@
-import { H as ct, J as Fe } from "./index-B74jTc2b.js";
+import { K as ct, L as Fe } from "./index-VUTKHpvC.js";
 import Ue from "react";
 import He from "react-dom";
 function $e(S, R) {
@@ -8130,4 +8130,4 @@ const wu = /* @__PURE__ */ Fe(Be), Su = /* @__PURE__ */ $e({
 export {
   Su as i
 };
-//# sourceMappingURL=index-B8-KKaH_.js.map
+//# sourceMappingURL=index-C9s5LB8m.js.map