@notmrabhi/flowforge 0.1.14 → 0.1.16

package/dist/canvas.cjs

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

package/dist/canvas.d.ts

@@ -45,11 +45,13 @@ export declare interface BpmnSaveOptions {
 
 declare type BranchChain = CanvasSlot_2[];
 
-declare type BranchChain_2 = CanvasSlot[];
+declare type BranchChain_2 = CanvasSlot_3[];
+
+declare type BranchChain_3 = CanvasSlot[];
 
 export declare interface BranchMap {
     [filterId: string]: {
-        [branchKey: string]: BranchChain_2;
+        [branchKey: string]: BranchChain_3;
     };
 }
 
@@ -59,11 +61,17 @@ declare interface BranchMap_2 {
     };
 }
 
+declare interface BranchMap_3 {
+    [filterId: string]: {
+        [branchKey: string]: BranchChain_2;
+    };
+}
+
 export declare const builtInNodeTypes: NodeTypes;
 
 export declare interface CanvasSlot {
     id: string;
-    kind: SlotKind_2;
+    kind: SlotKind_3;
     reactFlowType: string;
     descriptorType?: string;
     formData?: Record<string, unknown>;
@@ -87,6 +95,19 @@ declare interface CanvasSlot_2 {
     branchLabels?: Record<string, string>;
 }
 
+declare interface CanvasSlot_3 {
+    id: string;
+    kind: SlotKind_2;
+    reactFlowType: string;
+    descriptorType?: string;
+    formData?: Record<string, unknown>;
+    nodeData?: Record<string, unknown>;
+    deletable?: boolean;
+    label?: string;
+    /** Maps branch key → display label. e.g. { pass: 'Pass', fail: 'Fail' } */
+    branchLabels?: Record<string, string>;
+}
+
 /** One column in a per-field condition row */
 declare interface ConditionFieldDef {
     /** Key used to store this column's value in ConditionEntry */
@@ -309,6 +330,12 @@ declare interface FixedEdge_2 {
     target: string;
 }
 
+declare interface FixedEdge_3 {
+    id: string;
+    source: string;
+    target: string;
+}
+
 declare interface FixedNode {
     id: string;
     type: string;
@@ -323,7 +350,14 @@ declare interface FixedNode_2 {
     deletable?: false;
 }
 
-declare const FlowForgeCanvas: ({ nodeRegistry, templateRegistry, initialValue, nodeTypes: consumerNodeTypes, edgeTypes: consumerEdgeTypes, onSave, readOnly, theme, messages: messageOverrides, canvasOptions, renderTriggerSelector, renderNodePicker, renderNodeConfig, onNodeClick: onNodeClickProp, maxNodes, layoutDirection, executionRecord, onFetchWorkflow, }: FlowForgeCanvasProps) => JSX_2.Element;
+declare interface FixedNode_3 {
+    id: string;
+    type: string;
+    data?: Record<string, unknown>;
+    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, }: FlowForgeCanvasProps) => JSX_2.Element;
 export { FlowForgeCanvas }
 export { FlowForgeCanvas as WorkflowCanvas }
 
@@ -377,6 +411,20 @@ export declare interface FlowForgeCanvasProps {
     canvasOptions?: FlowForgeCanvasOptions;
     /** Replace the trigger selector UI entirely */
     renderTriggerSelector?: (templates: WorkflowTemplate[], onSelect: (t: WorkflowTemplate) => void, onClose: () => void) => default_2.ReactNode;
+    /**
+     * Optional async loader for trigger sources. When provided, the default
+     * trigger selector goes to a second stage after the user picks a trigger:
+     * the loader is called with the trigger's key, and if it returns a non-empty
+     * list, the user picks one or more sources before the canvas is seeded.
+     * Picked sources are merged into the trigger node's `nodeData.sources` so
+     * TriggerNode can render the "via [chip] [chip]" line.
+     *
+     * Return `[]` for triggers that have no sources — stage 2 is skipped.
+     */
+    loadTriggerSources?: (triggerKey: string) => Promise<Array<{
+        label: string;
+        value: string;
+    }>>;
     /** Replace the node picker UI entirely */
     renderNodePicker?: (descriptors: NodeDescriptor[], onSelect: (d: NodeDescriptor) => void, onClose: () => void) => default_2.ReactNode;
     /** Replace the node config drawer entirely */
@@ -432,6 +480,50 @@ export declare interface FlowForgeTheme {
     backgroundColor?: string;
 }
 
+/**
+ * Context passed to `NodeDescriptor.canInsert(ctx)` describing where on the
+ * canvas the user clicked "+ Add step". Used by position-aware insertion rules.
+ */
+declare interface InsertContext {
+    /** The slot the user clicked under (the one whose "+" edge was clicked). */
+    insertAfterSlot: CanvasSlot_2 | null;
+    /** Every slot before the insertion point, including the click slot.
+     *  When inside a branch: spine up to + including the branching parent, then
+     *  the branch's own slots up to the insertion point. */
+    upstreamSlots: CanvasSlot_2[];
+    /** Every slot after the insertion point in the same chain. */
+    downstreamSlots: CanvasSlot_2[];
+    /** Branch context, if the insertion is happening inside a branch. */
+    branch: {
+        filterId: string;
+        branch: string;
+    } | null;
+    /** The currently active template (the one whose trigger is in use). */
+    template: WorkflowTemplate_2 | null;
+}
+
+/**
+ * Context passed to `NodeDescriptor.canInsert(ctx)` describing where on the
+ * canvas the user clicked "+ Add step". Used by position-aware insertion rules.
+ */
+declare interface InsertContext_2 {
+    /** The slot the user clicked under (the one whose "+" edge was clicked). */
+    insertAfterSlot: CanvasSlot | null;
+    /** Every slot before the insertion point, including the click slot.
+     *  When inside a branch: spine up to + including the branching parent, then
+     *  the branch's own slots up to the insertion point. */
+    upstreamSlots: CanvasSlot[];
+    /** Every slot after the insertion point in the same chain. */
+    downstreamSlots: CanvasSlot[];
+    /** Branch context, if the insertion is happening inside a branch. */
+    branch: {
+        filterId: string;
+        branch: string;
+    } | null;
+    /** The currently active template (the one whose trigger is in use). */
+    template: WorkflowTemplate | null;
+}
+
 export declare function loadWorkflowFromBpmn(xml: string): WorkflowState;
 
 export declare interface NodeDescriptor {
@@ -465,6 +557,25 @@ export declare interface NodeDescriptor {
      * Receives the node's saved formData.
      */
     renderNode?: (nodeData: Record<string, unknown>) => ReactNode;
+    /**
+     * Position constraint — this descriptor can be inserted only if at least ONE
+     * of the listed tokens appears in the upstream chain of the click site.
+     * Tokens can be a descriptorType (e.g. 'createUserTask'), a slot id
+     * (e.g. 'event-userCreated'), or a slot kind (e.g. 'triggerFixed').
+     * Ignored when `canInsert` is set.
+     */
+    insertAfter?: string[];
+    /**
+     * Symmetric — must appear DOWNSTREAM of the click site. Same token rules
+     * as `insertAfter`. Ignored when `canInsert` is set.
+     */
+    insertBefore?: string[];
+    /**
+     * Full custom rule. Overrides `insertAfter` / `insertBefore`. Receives the
+     * click context (upstream/downstream slots, branch info, active template);
+     * returns `true` to allow the descriptor at this insertion point.
+     */
+    canInsert?: (ctx: InsertContext_2) => boolean;
     /** Maps branch key → display label. e.g. { pass: 'Pass', fail: 'Fail' }. Only applies to branching nodes (filterNode, approvalNode). */
     branchLabels?: Record<string, string>;
     formSchema: FieldDescriptor_2[] | ((nodeId: string) => Promise<FieldDescriptor_2[]>);
@@ -503,6 +614,25 @@ declare interface NodeDescriptor_2 {
      * Receives the node's saved formData.
      */
     renderNode?: (nodeData: Record<string, unknown>) => ReactNode;
+    /**
+     * Position constraint — this descriptor can be inserted only if at least ONE
+     * of the listed tokens appears in the upstream chain of the click site.
+     * Tokens can be a descriptorType (e.g. 'createUserTask'), a slot id
+     * (e.g. 'event-userCreated'), or a slot kind (e.g. 'triggerFixed').
+     * Ignored when `canInsert` is set.
+     */
+    insertAfter?: string[];
+    /**
+     * Symmetric — must appear DOWNSTREAM of the click site. Same token rules
+     * as `insertAfter`. Ignored when `canInsert` is set.
+     */
+    insertBefore?: string[];
+    /**
+     * Full custom rule. Overrides `insertAfter` / `insertBefore`. Receives the
+     * click context (upstream/downstream slots, branch info, active template);
+     * returns `true` to allow the descriptor at this insertion point.
+     */
+    canInsert?: (ctx: InsertContext) => boolean;
     /** Maps branch key → display label. e.g. { pass: 'Pass', fail: 'Fail' }. Only applies to branching nodes (filterNode, approvalNode). */
     branchLabels?: Record<string, string>;
     formSchema: FieldDescriptor[] | ((nodeId: string) => Promise<FieldDescriptor[]>);
@@ -528,6 +658,8 @@ declare type SlotKind = 'start' | 'end' | 'addTrigger' | 'triggerFixed' | 'userT
 
 declare type SlotKind_2 = 'start' | 'end' | 'addTrigger' | 'triggerFixed' | 'userTask' | 'addStep' | 'filter' | 'approval';
 
+declare type SlotKind_3 = 'start' | 'end' | 'addTrigger' | 'triggerFixed' | 'userTask' | 'addStep' | 'filter' | 'approval';
+
 export declare const StartNode: () => JSX_2.Element;
 
 export declare type StepStatus = 'pending' | 'running' | 'success' | 'failed' | 'skipped';
@@ -545,12 +677,12 @@ declare interface SubWorkflowPreviewDrawerProps {
 
 declare class TemplateRegistry {
     private templates;
-    register(template: WorkflowTemplate_2): this;
-    lookup(triggerKey: string): WorkflowTemplate_2 | undefined;
-    list(): WorkflowTemplate_2[];
-    listByCategory(category: string): WorkflowTemplate_2[];
-    listByTag(tag: string): WorkflowTemplate_2[];
-    search(query: string): WorkflowTemplate_2[];
+    register(template: WorkflowTemplate_3): this;
+    lookup(triggerKey: string): WorkflowTemplate_3 | undefined;
+    list(): WorkflowTemplate_3[];
+    listByCategory(category: string): WorkflowTemplate_3[];
+    listByTag(tag: string): WorkflowTemplate_3[];
+    search(query: string): WorkflowTemplate_3[];
     categories(): string[];
 }
 
@@ -583,6 +715,11 @@ declare interface WorkflowState_2 {
     branches: BranchMap_2;
 }
 
+declare interface WorkflowState_3 {
+    slots: CanvasSlot_3[];
+    branches: BranchMap_3;
+}
+
 export declare interface WorkflowTemplate {
     triggerKey: string;
     label: string;
@@ -592,8 +729,8 @@ export declare interface WorkflowTemplate {
     availableTasks?: string[];
     maxTasks?: number;
     taskLabels?: Record<string, string>;
-    fixedNodes?: FixedNode_2[];
-    fixedEdges?: FixedEdge_2[];
+    fixedNodes?: FixedNode_3[];
+    fixedEdges?: FixedEdge_3[];
     insertionPoints?: string[];
     source?: string;
     product?: string;
@@ -635,6 +772,32 @@ declare interface WorkflowTemplate_2 {
     popularity?: number;
 }
 
+declare interface WorkflowTemplate_3 {
+    triggerKey: string;
+    label: string;
+    description?: string;
+    icon?: ReactNode;
+    triggerCategory?: 'event' | 'scheduler' | 'webhook' | string;
+    availableTasks?: string[];
+    maxTasks?: number;
+    taskLabels?: Record<string, string>;
+    fixedNodes?: FixedNode_2[];
+    fixedEdges?: FixedEdge_2[];
+    insertionPoints?: string[];
+    source?: string;
+    product?: string;
+    /** Pre-built workflow state to clone when user selects this template */
+    skeletonState?: WorkflowState_3;
+    /** Tags for filtering in the template library */
+    tags?: string[];
+    /** Category grouping in the library */
+    category?: string;
+    /** Team or author that owns this template */
+    author?: string;
+    /** Relative popularity score (higher = shown first in library) */
+    popularity?: number;
+}
+
 export declare const WorkflowTemplateLibrary: default_2.FC<WorkflowTemplateLibraryProps>;
 
 declare interface WorkflowTemplateLibraryProps {

package/dist/canvas.js

@@ -1,7 +1,7 @@
-import { F as a, S as s, F as r, W as t, a as l, b as n, o as d, u as i, w as f } from "./templateSkeletons-CCXJ0W5L.js";
+import { F as a, S as s, F as r, W as t, a as l, b as n, o as d, u as i, w as f } from "./templateSkeletons-Bx-hGzdq.js";
 import { d as w } from "./messages-CO299wPN.js";
 import { l as p, s as b } from "./bpmn-CtfWDaOY.js";
-import { A as F, b as N, E as m, c as u, F as S, R as T, S as c, T as v, W as x, e as A } from "./GatewayBranchEdge-DH-aHDPm.js";
+import { A as F, b as N, E as m, c as u, F as S, R as T, S as c, T as v, W as x, e as A } from "./GatewayBranchEdge-CwL3jMdK.js";
 export {
   F as ActionNode,
   N as ApprovalNode,

package/dist/core.d.ts

@@ -187,6 +187,28 @@ export declare interface FlowForgeMessages {
     cancel: string;
 }
 
+/**
+ * Context passed to `NodeDescriptor.canInsert(ctx)` describing where on the
+ * canvas the user clicked "+ Add step". Used by position-aware insertion rules.
+ */
+declare interface InsertContext {
+    /** The slot the user clicked under (the one whose "+" edge was clicked). */
+    insertAfterSlot: CanvasSlot | null;
+    /** Every slot before the insertion point, including the click slot.
+     *  When inside a branch: spine up to + including the branching parent, then
+     *  the branch's own slots up to the insertion point. */
+    upstreamSlots: CanvasSlot[];
+    /** Every slot after the insertion point in the same chain. */
+    downstreamSlots: CanvasSlot[];
+    /** Branch context, if the insertion is happening inside a branch. */
+    branch: {
+        filterId: string;
+        branch: string;
+    } | null;
+    /** The currently active template (the one whose trigger is in use). */
+    template: WorkflowTemplate | null;
+}
+
 export declare function loadWorkflowFromBpmn(xml: string): WorkflowState;
 
 export declare function makeSubWorkflowDescriptor(opts?: SubWorkflowDescriptorOptions): NodeDescriptor;
@@ -222,6 +244,25 @@ export declare interface NodeDescriptor {
      * Receives the node's saved formData.
      */
     renderNode?: (nodeData: Record<string, unknown>) => ReactNode;
+    /**
+     * Position constraint — this descriptor can be inserted only if at least ONE
+     * of the listed tokens appears in the upstream chain of the click site.
+     * Tokens can be a descriptorType (e.g. 'createUserTask'), a slot id
+     * (e.g. 'event-userCreated'), or a slot kind (e.g. 'triggerFixed').
+     * Ignored when `canInsert` is set.
+     */
+    insertAfter?: string[];
+    /**
+     * Symmetric — must appear DOWNSTREAM of the click site. Same token rules
+     * as `insertAfter`. Ignored when `canInsert` is set.
+     */
+    insertBefore?: string[];
+    /**
+     * Full custom rule. Overrides `insertAfter` / `insertBefore`. Receives the
+     * click context (upstream/downstream slots, branch info, active template);
+     * returns `true` to allow the descriptor at this insertion point.
+     */
+    canInsert?: (ctx: InsertContext) => boolean;
     /** Maps branch key → display label. e.g. { pass: 'Pass', fail: 'Fail' }. Only applies to branching nodes (filterNode, approvalNode). */
     branchLabels?: Record<string, string>;
     formSchema: FieldDescriptor[] | ((nodeId: string) => Promise<FieldDescriptor[]>);

package/dist/defaultUi.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./GatewayBranchEdge-CrDMz9RP.js");exports.ActionNode=e.ActionNode;exports.AddTriggerNode=e.AddTriggerNode;exports.ApprovalNode=e.ApprovalNode;exports.DelayNode=e.DelayNode;exports.EdgeWithPlusLabel=e.EdgeWithPlusLabel;exports.EndNode=e.EndNode;exports.FilterNode=e.FilterNode;exports.GatewayBranchEdge=e.GatewayBranchEdge;exports.LabelPlusEdge=e.LabelPlusEdge;exports.NotificationNode=e.NotificationNode;exports.PlainEdge=e.PlainEdge;exports.PlusEdge=e.PlusEdge;exports.StartNode=e.StartNode;exports.TriggerNode=e.TriggerNode;exports.builtInNodeTypes=e.builtInNodeTypes;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./GatewayBranchEdge-CFre76ne.js");exports.ActionNode=e.ActionNode;exports.AddTriggerNode=e.AddTriggerNode;exports.ApprovalNode=e.ApprovalNode;exports.DelayNode=e.DelayNode;exports.EdgeWithPlusLabel=e.EdgeWithPlusLabel;exports.EndNode=e.EndNode;exports.FilterNode=e.FilterNode;exports.GatewayBranchEdge=e.GatewayBranchEdge;exports.LabelPlusEdge=e.LabelPlusEdge;exports.NotificationNode=e.NotificationNode;exports.PlainEdge=e.PlainEdge;exports.PlusEdge=e.PlusEdge;exports.StartNode=e.StartNode;exports.TriggerNode=e.TriggerNode;exports.builtInNodeTypes=e.builtInNodeTypes;

package/dist/defaultUi.js

@@ -1,4 +1,4 @@
-import { A as d, a as s, b as o, D as N, E as i, c as l, F as r, G as t, L as g, N as E, P as n, d as P, S as b, T as c, e as p } from "./GatewayBranchEdge-DH-aHDPm.js";
+import { A as d, a as s, b as o, D as N, E as i, c as l, F as r, G as t, L as g, N as E, P as n, d as P, S as b, T as c, e as p } from "./GatewayBranchEdge-CwL3jMdK.js";
 export {
   d as ActionNode,
   s as AddTriggerNode,

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-DNZlQp9z.js"),a=require("./SchemaBuilderDrawer-jbSe-O-O.js");require("react/jsx-runtime");require("react");require("@mui/material");require("react-icons/md");const r=require("./nodeRegistry.cjs"),l=require("./templateRegistry.cjs"),i=require("./templateSkeletons-DT30F9Rm.js"),d=require("./messages-O9Tw_XXR.js"),n=require("./bpmn-CcuE2X_Q.js"),o=require("./GatewayBranchEdge-CrDMz9RP.js");class u{constructor(){this.channels=new Map}register(t,s){this.channels.set(t,s)}get(t){return this.channels.get(t)}list(){return Array.from(this.channels.entries()).map(([t,s])=>({key:t,...s}))}has(t){return this.channels.has(t)}}const c=new u;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.dataSourceRegistry=e.dataSourceRegistry;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=a.FIELD_TYPE_OPTIONS;exports.SchemaBuilder=a.SchemaBuilder;exports.SchemaBuilderDrawer=a.SchemaBuilderDrawer;exports.useFlowForm=a.useFlowForm;exports.NodeTypeRegistry=r.NodeTypeRegistry;exports.baseNodeDefaults=r.baseNodeDefaults;exports.conditionBranchDescriptor=r.conditionBranchDescriptor;exports.defineNode=r.defineNode;exports.endEventDescriptor=r.endEventDescriptor;exports.makeSubWorkflowDescriptor=r.makeSubWorkflowDescriptor;exports.nodeTypeRegistry=r.nodeTypeRegistry;exports.notificationDescriptor=r.notificationDescriptor;exports.restApiDescriptor=r.restApiDescriptor;exports.startEventDescriptor=r.startEventDescriptor;exports.subWorkflowDescriptor=r.subWorkflowDescriptor;exports.webhookTriggerDescriptor=r.webhookTriggerDescriptor;exports.webhookTriggerTemplate=r.webhookTriggerTemplate;exports.TemplateRegistry=l.TemplateRegistry;exports.templateRegistry=l.templateRegistry;exports.FlowForgeCanvas=i.FlowForgeCanvas;exports.SubWorkflowPreviewDrawer=i.SubWorkflowPreviewDrawer;exports.WorkflowCanvas=i.FlowForgeCanvas;exports.WorkflowExecutionHistory=i.WorkflowExecutionHistory;exports.WorkflowTemplateLibrary=i.WorkflowTemplateLibrary;exports.accessRequestSkeleton=i.accessRequestSkeleton;exports.offboardingSkeleton=i.offboardingSkeleton;exports.userOnboardingSkeleton=i.userOnboardingSkeleton;exports.webhookIntegrationSkeleton=i.webhookIntegrationSkeleton;exports.defaultFlowForgeMessages=d.defaultFlowForgeMessages;exports.loadWorkflowFromBpmn=n.loadWorkflowFromBpmn;exports.saveWorkflowToBpmn=n.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;exports.notificationChannelRegistry=c;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-DNZlQp9z.js"),a=require("./SchemaBuilderDrawer-jbSe-O-O.js");require("react/jsx-runtime");require("react");require("@mui/material");require("react-icons/md");const r=require("./nodeRegistry.cjs"),l=require("./templateRegistry.cjs"),i=require("./templateSkeletons-BKaXZuM9.js"),d=require("./messages-O9Tw_XXR.js"),n=require("./bpmn-CcuE2X_Q.js"),o=require("./GatewayBranchEdge-CFre76ne.js");class u{constructor(){this.channels=new Map}register(t,s){this.channels.set(t,s)}get(t){return this.channels.get(t)}list(){return Array.from(this.channels.entries()).map(([t,s])=>({key:t,...s}))}has(t){return this.channels.has(t)}}const c=new u;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.dataSourceRegistry=e.dataSourceRegistry;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=a.FIELD_TYPE_OPTIONS;exports.SchemaBuilder=a.SchemaBuilder;exports.SchemaBuilderDrawer=a.SchemaBuilderDrawer;exports.useFlowForm=a.useFlowForm;exports.NodeTypeRegistry=r.NodeTypeRegistry;exports.baseNodeDefaults=r.baseNodeDefaults;exports.conditionBranchDescriptor=r.conditionBranchDescriptor;exports.defineNode=r.defineNode;exports.endEventDescriptor=r.endEventDescriptor;exports.makeSubWorkflowDescriptor=r.makeSubWorkflowDescriptor;exports.nodeTypeRegistry=r.nodeTypeRegistry;exports.notificationDescriptor=r.notificationDescriptor;exports.restApiDescriptor=r.restApiDescriptor;exports.startEventDescriptor=r.startEventDescriptor;exports.subWorkflowDescriptor=r.subWorkflowDescriptor;exports.webhookTriggerDescriptor=r.webhookTriggerDescriptor;exports.webhookTriggerTemplate=r.webhookTriggerTemplate;exports.TemplateRegistry=l.TemplateRegistry;exports.templateRegistry=l.templateRegistry;exports.FlowForgeCanvas=i.FlowForgeCanvas;exports.SubWorkflowPreviewDrawer=i.SubWorkflowPreviewDrawer;exports.WorkflowCanvas=i.FlowForgeCanvas;exports.WorkflowExecutionHistory=i.WorkflowExecutionHistory;exports.WorkflowTemplateLibrary=i.WorkflowTemplateLibrary;exports.accessRequestSkeleton=i.accessRequestSkeleton;exports.offboardingSkeleton=i.offboardingSkeleton;exports.userOnboardingSkeleton=i.userOnboardingSkeleton;exports.webhookIntegrationSkeleton=i.webhookIntegrationSkeleton;exports.defaultFlowForgeMessages=d.defaultFlowForgeMessages;exports.loadWorkflowFromBpmn=n.loadWorkflowFromBpmn;exports.saveWorkflowToBpmn=n.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;exports.notificationChannelRegistry=c;

package/dist/index.d.ts

@@ -532,7 +532,7 @@ declare interface FixedNode {
     deletable?: false;
 }
 
-declare const FlowForgeCanvas: ({ nodeRegistry, templateRegistry, initialValue, nodeTypes: consumerNodeTypes, edgeTypes: consumerEdgeTypes, onSave, readOnly, theme, messages: messageOverrides, canvasOptions, renderTriggerSelector, renderNodePicker, renderNodeConfig, onNodeClick: onNodeClickProp, maxNodes, layoutDirection, executionRecord, onFetchWorkflow, }: 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, }: FlowForgeCanvasProps) => JSX_2.Element;
 export { FlowForgeCanvas }
 export { FlowForgeCanvas as WorkflowCanvas }
 
@@ -586,6 +586,20 @@ export declare interface FlowForgeCanvasProps {
     canvasOptions?: FlowForgeCanvasOptions;
     /** Replace the trigger selector UI entirely */
     renderTriggerSelector?: (templates: WorkflowTemplate[], onSelect: (t: WorkflowTemplate) => void, onClose: () => void) => default_2.ReactNode;
+    /**
+     * Optional async loader for trigger sources. When provided, the default
+     * trigger selector goes to a second stage after the user picks a trigger:
+     * the loader is called with the trigger's key, and if it returns a non-empty
+     * list, the user picks one or more sources before the canvas is seeded.
+     * Picked sources are merged into the trigger node's `nodeData.sources` so
+     * TriggerNode can render the "via [chip] [chip]" line.
+     *
+     * Return `[]` for triggers that have no sources — stage 2 is skipped.
+     */
+    loadTriggerSources?: (triggerKey: string) => Promise<Array<{
+        label: string;
+        value: string;
+    }>>;
     /** Replace the node picker UI entirely */
     renderNodePicker?: (descriptors: NodeDescriptor[], onSelect: (d: NodeDescriptor) => void, onClose: () => void) => default_2.ReactNode;
     /** Replace the node config drawer entirely */
@@ -810,6 +824,28 @@ export declare function inputStyle(opts: {
     extraStyle?: React.CSSProperties;
 }): React.CSSProperties;
 
+/**
+ * Context passed to `NodeDescriptor.canInsert(ctx)` describing where on the
+ * canvas the user clicked "+ Add step". Used by position-aware insertion rules.
+ */
+declare interface InsertContext {
+    /** The slot the user clicked under (the one whose "+" edge was clicked). */
+    insertAfterSlot: CanvasSlot | null;
+    /** Every slot before the insertion point, including the click slot.
+     *  When inside a branch: spine up to + including the branching parent, then
+     *  the branch's own slots up to the insertion point. */
+    upstreamSlots: CanvasSlot[];
+    /** Every slot after the insertion point in the same chain. */
+    downstreamSlots: CanvasSlot[];
+    /** Branch context, if the insertion is happening inside a branch. */
+    branch: {
+        filterId: string;
+        branch: string;
+    } | null;
+    /** The currently active template (the one whose trigger is in use). */
+    template: WorkflowTemplate | null;
+}
+
 export declare function isFormula(value: unknown): value is string;
 
 export declare interface LoadPageParams {
@@ -858,6 +894,25 @@ export declare interface NodeDescriptor {
      * Receives the node's saved formData.
      */
     renderNode?: (nodeData: Record<string, unknown>) => ReactNode;
+    /**
+     * Position constraint — this descriptor can be inserted only if at least ONE
+     * of the listed tokens appears in the upstream chain of the click site.
+     * Tokens can be a descriptorType (e.g. 'createUserTask'), a slot id
+     * (e.g. 'event-userCreated'), or a slot kind (e.g. 'triggerFixed').
+     * Ignored when `canInsert` is set.
+     */
+    insertAfter?: string[];
+    /**
+     * Symmetric — must appear DOWNSTREAM of the click site. Same token rules
+     * as `insertAfter`. Ignored when `canInsert` is set.
+     */
+    insertBefore?: string[];
+    /**
+     * Full custom rule. Overrides `insertAfter` / `insertBefore`. Receives the
+     * click context (upstream/downstream slots, branch info, active template);
+     * returns `true` to allow the descriptor at this insertion point.
+     */
+    canInsert?: (ctx: InsertContext) => boolean;
     /** Maps branch key → display label. e.g. { pass: 'Pass', fail: 'Fail' }. Only applies to branching nodes (filterNode, approvalNode). */
     branchLabels?: Record<string, string>;
     formSchema: FieldDescriptor[] | ((nodeId: string) => Promise<FieldDescriptor[]>);

package/dist/index.js

@@ -6,10 +6,10 @@ import "@mui/material";
 import "react-icons/md";
 import { NodeTypeRegistry as U, baseNodeDefaults as X, conditionBranchDescriptor as Z, defineNode as $, endEventDescriptor as ee, makeSubWorkflowDescriptor as ae, nodeTypeRegistry as se, notificationDescriptor as re, restApiDescriptor as oe, startEventDescriptor as te, subWorkflowDescriptor as ie, webhookTriggerDescriptor as le, webhookTriggerTemplate as ne } from "./nodeRegistry.js";
 import { TemplateRegistry as de, templateRegistry as ce } from "./templateRegistry.js";
-import { F as me, S as fe, F as ge, W as Fe, a as he, b as be, o as ke, u as Te, w as we } from "./templateSkeletons-CCXJ0W5L.js";
+import { F as me, S as fe, F as ge, W as Fe, a as he, b as be, o as ke, u as Te, w as we } from "./templateSkeletons-Bx-hGzdq.js";
 import { d as ye } from "./messages-CO299wPN.js";
 import { l as De, s as Ne } from "./bpmn-CtfWDaOY.js";
-import { A as We, b as Ae, E as Pe, c as ve, F as Ee, R as Ce, S as Ie, T as Be, W as ze, e as Ve } from "./GatewayBranchEdge-DH-aHDPm.js";
+import { A as We, b as Ae, E as Pe, c as ve, F as Ee, R as Ce, S as Ie, T as Be, W as ze, e as Ve } from "./GatewayBranchEdge-CwL3jMdK.js";
 class s {
   constructor() {
     this.channels = /* @__PURE__ */ new Map();

package/dist/nodeRegistry.d.ts

@@ -164,6 +164,28 @@ declare interface FixedNode {
     deletable?: false;
 }
 
+/**
+ * Context passed to `NodeDescriptor.canInsert(ctx)` describing where on the
+ * canvas the user clicked "+ Add step". Used by position-aware insertion rules.
+ */
+declare interface InsertContext {
+    /** The slot the user clicked under (the one whose "+" edge was clicked). */
+    insertAfterSlot: CanvasSlot | null;
+    /** Every slot before the insertion point, including the click slot.
+     *  When inside a branch: spine up to + including the branching parent, then
+     *  the branch's own slots up to the insertion point. */
+    upstreamSlots: CanvasSlot[];
+    /** Every slot after the insertion point in the same chain. */
+    downstreamSlots: CanvasSlot[];
+    /** Branch context, if the insertion is happening inside a branch. */
+    branch: {
+        filterId: string;
+        branch: string;
+    } | null;
+    /** The currently active template (the one whose trigger is in use). */
+    template: WorkflowTemplate | null;
+}
+
 export declare function makeSubWorkflowDescriptor(opts?: SubWorkflowDescriptorOptions): NodeDescriptor;
 
 export declare interface NodeDescriptor {
@@ -197,6 +219,25 @@ export declare interface NodeDescriptor {
      * Receives the node's saved formData.
      */
     renderNode?: (nodeData: Record<string, unknown>) => ReactNode;
+    /**
+     * Position constraint — this descriptor can be inserted only if at least ONE
+     * of the listed tokens appears in the upstream chain of the click site.
+     * Tokens can be a descriptorType (e.g. 'createUserTask'), a slot id
+     * (e.g. 'event-userCreated'), or a slot kind (e.g. 'triggerFixed').
+     * Ignored when `canInsert` is set.
+     */
+    insertAfter?: string[];
+    /**
+     * Symmetric — must appear DOWNSTREAM of the click site. Same token rules
+     * as `insertAfter`. Ignored when `canInsert` is set.
+     */
+    insertBefore?: string[];
+    /**
+     * Full custom rule. Overrides `insertAfter` / `insertBefore`. Receives the
+     * click context (upstream/downstream slots, branch info, active template);
+     * returns `true` to allow the descriptor at this insertion point.
+     */
+    canInsert?: (ctx: InsertContext) => boolean;
     /** Maps branch key → display label. e.g. { pass: 'Pass', fail: 'Fail' }. Only applies to branching nodes (filterNode, approvalNode). */
     branchLabels?: Record<string, string>;
     formSchema: FieldDescriptor[] | ((nodeId: string) => Promise<FieldDescriptor[]>);