@notmrabhi/flowforge 0.1.0

package/dist/index.js

@@ -0,0 +1,106 @@
+import { D as d, F as c, a as u, b as m, I as f, V as g, c as F, d as b, e as h, f as k, g as T, h as w, i as S, j as y, k as x, l as D, m as N, n as R, o as W, p as P, q as v, s as A, r as E, t as C, u as I, v as B, w as V, x as z, y as L } from "./index-CIbEqy9U.js";
+import { F as q, a as H, S as M, b as _, T as j, c as Y, d as G, u as J } from "./SchemaBuilderDrawer-DFyGUCZM.js";
+import "react";
+import "@mui/material";
+import "react-icons/md";
+import { NodeTypeRegistry as Q, baseNodeDefaults as U, conditionBranchDescriptor as X, defineNode as Z, endEventDescriptor as $, makeSubWorkflowDescriptor as ee, nodeTypeRegistry as ae, notificationDescriptor as se, restApiDescriptor as re, startEventDescriptor as oe, subWorkflowDescriptor as te, webhookTriggerDescriptor as ie, webhookTriggerTemplate as le } from "./nodeRegistry.js";
+import { TemplateRegistry as pe, templateRegistry as de } from "./templateRegistry.js";
+import { F as ue, S as me, F as fe, W as ge, a as Fe, b as be, o as he, u as ke, w as Te } from "./templateSkeletons-D60ixh5T.js";
+import { d as Se } from "./messages-CO299wPN.js";
+import { l as xe, s as De } from "./bpmn-CtfWDaOY.js";
+import { A as Re, b as We, E as Pe, c as ve, F as Ae, R as Ee, S as Ce, T as Ie, W as Be, e as Ve } from "./GatewayBranchEdge-gncIBR-0.js";
+class s {
+  constructor() {
+    this.channels = /* @__PURE__ */ new Map();
+  }
+  register(e, a) {
+    this.channels.set(e, a);
+  }
+  get(e) {
+    return this.channels.get(e);
+  }
+  list() {
+    return Array.from(this.channels.entries()).map(([e, a]) => ({ key: e, ...a }));
+  }
+  has(e) {
+    return this.channels.has(e);
+  }
+}
+const l = new s();
+export {
+  Re as ActionNode,
+  We as ApprovalNode,
+  d as DynamicFormRenderer,
+  Pe as EdgeWithPlusLabel,
+  ve as EndNode,
+  c as FF,
+  q as FIELD_TYPE_OPTIONS,
+  Ae as FilterNode,
+  ue as FlowForgeCanvas,
+  H as FlowForgeRegistry,
+  u as FlowForm,
+  m as FormulaInput,
+  f as InfiniteSelectField,
+  Q as NodeTypeRegistry,
+  Ee as RestApiNode,
+  M as SchemaBuilder,
+  _ as SchemaBuilderDrawer,
+  Ce as StartNode,
+  me as SubWorkflowPreviewDrawer,
+  j as TablePickerField,
+  pe as TemplateRegistry,
+  Ie as TriggerNode,
+  g as VariablePicker,
+  F as VariablePickerProvider,
+  Be as WebhookTriggerNode,
+  fe as WorkflowCanvas,
+  ge as WorkflowExecutionHistory,
+  Fe as WorkflowTemplateLibrary,
+  be as accessRequestSkeleton,
+  b as astHasRefs,
+  h as astToTokens,
+  U as baseNodeDefaults,
+  k as buildEvaluationPayload,
+  T as buildFieldConfig,
+  w as buildFormulaPath,
+  S as buildSelectStyles,
+  Y as buildValidationSchema,
+  Ve as builtInNodeTypes,
+  X as conditionBranchDescriptor,
+  G as dataSourceRegistry,
+  Se as defaultFlowForgeMessages,
+  Z as defineNode,
+  $ as endEventDescriptor,
+  y as errorTextStyle,
+  x as extractLabel,
+  D as fieldRegistry,
+  N as hasFormulaTokens,
+  R as helperTextStyle,
+  W as inputStyle,
+  P as isFormula,
+  xe as loadWorkflowFromBpmn,
+  ee as makeSubWorkflowDescriptor,
+  ae as nodeTypeRegistry,
+  l as notificationChannelRegistry,
+  se as notificationDescriptor,
+  he as offboardingSkeleton,
+  v as parseToAST,
+  re as restApiDescriptor,
+  De as saveWorkflowToBpmn,
+  A as serializeAST,
+  E as serializeASTAsConfig,
+  C as serializeConditionExpressions,
+  oe as startEventDescriptor,
+  I as stripFormulaTokens,
+  te as subWorkflowDescriptor,
+  de as templateRegistry,
+  B as tokenize,
+  V as unwrapFormula,
+  J as useFlowForm,
+  z as useVariablePickerContext,
+  ke as userOnboardingSkeleton,
+  Te as webhookIntegrationSkeleton,
+  ie as webhookTriggerDescriptor,
+  le as webhookTriggerTemplate,
+  L as wrapFormula
+};

package/dist/messages-CO299wPN.js

@@ -0,0 +1,22 @@
+const e = {
+  addTriggerTitle: "Add Trigger",
+  addTriggerTooltip: "Click to add a trigger for your workflow",
+  addTriggerButton: "Add Trigger",
+  chooseTrigger: "Choose a trigger to start the workflow.",
+  noTriggers: "No triggers registered.",
+  addStepTitle: "Add Step",
+  chooseAction: "Choose an action to add to the workflow.",
+  noActions: "No actions available for this trigger.",
+  configureStep: "Configure Step",
+  loadingConfiguration: "Loading configuration...",
+  noConfigurationNeeded: "No configuration needed for this step.",
+  save: "Save",
+  cancel: "Cancel"
+}, r = (o) => ({
+  ...e,
+  ...o ?? {}
+});
+export {
+  e as d,
+  r as m
+};

package/dist/messages-O9Tw_XXR.js

@@ -0,0 +1 @@
+"use strict";const e={addTriggerTitle:"Add Trigger",addTriggerTooltip:"Click to add a trigger for your workflow",addTriggerButton:"Add Trigger",chooseTrigger:"Choose a trigger to start the workflow.",noTriggers:"No triggers registered.",addStepTitle:"Add Step",chooseAction:"Choose an action to add to the workflow.",noActions:"No actions available for this trigger.",configureStep:"Configure Step",loadingConfiguration:"Loading configuration...",noConfigurationNeeded:"No configuration needed for this step.",save:"Save",cancel:"Cancel"},r=o=>({...e,...o??{}});exports.defaultFlowForgeMessages=e;exports.mergeMessages=r;

package/dist/nodeRegistry.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("react"),r=require("react-icons/md"),d=require("./canvasTokens-gKNYrPl4.js"),s={formSchema:[],bpmnEntry:e=>e,bpmnExit:e=>e,emitBpmnElements:e=>[{id:e,$type:"bpmn:Task"}]};function o(e){return{...s,...e}}const u=o({type:"startEvent",label:"Start",icon:a.createElement(r.MdPlayCircleOutline,{size:18,color:"#616161"}),matches:e=>e==="start",reactFlowType:"startNode",emitBpmnElements:e=>[{id:e,$type:"bpmn:StartEvent"}],maxPerWorkflow:1}),b=o({type:"endEvent",label:"End",icon:a.createElement(r.MdStopCircle,{size:18,color:"#616161"}),matches:e=>e==="end"||e.startsWith("end-"),reactFlowType:"endNode",emitBpmnElements:e=>[{id:e,$type:"bpmn:EndEvent"}]}),h=o({type:"restApi",label:"REST API Call",icon:a.createElement(r.MdHttp,{size:18,color:"#546e7a"}),matches:e=>e.startsWith("restApi-"),reactFlowType:"restApiNode",formSchema:[{id:"method",type:"select",label:"HTTP Method",required:!0,options:[{label:"GET",value:"GET"},{label:"POST",value:"POST"},{label:"PUT",value:"PUT"},{label:"PATCH",value:"PATCH"},{label:"DELETE",value:"DELETE"}]},{id:"url",type:"text",label:"URL",required:!0,placeholder:"https://api.example.com/endpoint",formulaEnabled:!0},{id:"headers",type:"key-value",label:"Request Headers",placeholder:"Add headers..."},{id:"queryParams",type:"key-value",label:"Query Parameters",shouldHide:({values:e})=>e.method!=="GET"&&e.method!=="DELETE"},{id:"body",type:"json-editor",label:"Request Body (JSON)",shouldHide:({values:e})=>e.method==="GET"||e.method==="DELETE"},{id:"responseMapping",type:"array",label:"Map Response Fields to Variables",children:[{id:"jsonPath",type:"text",label:"JSON Path",placeholder:"$.data.userId",required:!0},{id:"variableName",type:"text",label:"Variable Name",placeholder:"userId",required:!0}]},{id:"timeoutMs",type:"number",label:"Timeout (ms)",placeholder:"5000"},{id:"continueOnError",type:"toggle",label:"Continue workflow on error"}],bpmnEntry:e=>`REST API Call: ${e}`,bpmnExit:e=>`End REST API Call: ${e}`,emitBpmnElements:(e,t)=>{const l=t;return[{id:e,$type:"bpmn:ServiceTask",name:`${l.method??"HTTP"} ${l.url??""}`.trim()}]}}),m=o({type:"notification",label:"Send Notification",icon:a.createElement(r.MdNotifications,{size:18,color:"#7b1fa2"}),matches:e=>e.startsWith("notification-"),reactFlowType:"notificationNode",formSchema:[{id:"channel",type:"descriptive-select",label:"Notification Channel",required:!0,options:[{value:"email",label:"Email",description:"Send via SMTP or email provider"},{value:"slack",label:"Slack",description:"Post to a Slack channel or DM"},{value:"teams",label:"Microsoft Teams",description:"Post to a Teams channel or chat"},{value:"sms",label:"SMS",description:"Send a text message"},{value:"in-app",label:"In-App",description:"miniOrange notification center"},{value:"webhook",label:"Webhook",description:"POST to an external URL"}]},{id:"emailTo",type:"tags",label:"To",placeholder:"Add email address...",required:!0,shouldHide:({values:e})=>e.channel!=="email",formulaEnabled:!0},{id:"emailCc",type:"tags",label:"CC",placeholder:"Add email address...",shouldHide:({values:e})=>e.channel!=="email"},{id:"emailSubject",type:"text",label:"Subject",required:!0,formulaEnabled:!0,shouldHide:({values:e})=>e.channel!=="email"},{id:"emailBody",type:"rich-text",label:"Body",required:!0,shouldHide:({values:e})=>e.channel!=="email"},{id:"slackChannel",type:"text",label:"Channel / DM",required:!0,placeholder:"#general or @username",formulaEnabled:!0,shouldHide:({values:e})=>e.channel!=="slack"},{id:"slackMessage",type:"textarea",label:"Message",required:!0,formulaEnabled:!0,shouldHide:({values:e})=>e.channel!=="slack"},{id:"teamsWebhookUrl",type:"text",label:"Incoming Webhook URL",required:!0,placeholder:"https://...",shouldHide:({values:e})=>e.channel!=="teams"},{id:"teamsMessage",type:"textarea",label:"Message",required:!0,formulaEnabled:!0,shouldHide:({values:e})=>e.channel!=="teams"},{id:"smsTo",type:"text",label:"Phone Number",required:!0,placeholder:"+1234567890",formulaEnabled:!0,shouldHide:({values:e})=>e.channel!=="sms"},{id:"smsBody",type:"textarea",label:"Message",required:!0,formulaEnabled:!0,shouldHide:({values:e})=>e.channel!=="sms"},{id:"inAppRecipient",type:"text",label:"Recipient (User ID or Username)",required:!0,formulaEnabled:!0,shouldHide:({values:e})=>e.channel!=="in-app"},{id:"inAppTitle",type:"text",label:"Title",required:!0,formulaEnabled:!0,shouldHide:({values:e})=>e.channel!=="in-app"},{id:"inAppBody",type:"textarea",label:"Message",required:!0,formulaEnabled:!0,shouldHide:({values:e})=>e.channel!=="in-app"},{id:"webhookUrl",type:"text",label:"Webhook URL",required:!0,placeholder:"https://...",formulaEnabled:!0,shouldHide:({values:e})=>e.channel!=="webhook"},{id:"webhookPayload",type:"json-editor",label:"Payload (JSON)",shouldHide:({values:e})=>e.channel!=="webhook"},{id:"sendOnFailure",type:"toggle",label:"Also send notification on workflow failure"},{id:"deduplicationKey",type:"text",label:"Deduplication Key",placeholder:"Optional — prevents duplicate sends",formulaEnabled:!0}],bpmnEntry:e=>`Send Notification: ${e}`,bpmnExit:e=>`End Notification: ${e}`,emitBpmnElements:(e,t)=>[{id:e,$type:"bpmn:SendTask",name:`Notify via ${t.channel??"channel"}`}]}),y=[{label:"equals (=)",value:"eq"},{label:"not equals (≠)",value:"neq"},{label:"greater than (>)",value:"gt"},{label:"greater or equal (≥)",value:"gte"},{label:"less than (<)",value:"lt"},{label:"less or equal (≤)",value:"lte"},{label:"contains",value:"contains"},{label:"starts with",value:"startsWith"},{label:"ends with",value:"endsWith"},{label:"is empty",value:"isEmpty"},{label:"is not empty",value:"isNotEmpty"}],f=o({type:"conditionBranch",label:"Condition Branch",icon:a.createElement(r.MdCallSplit,{size:18,color:"#512da8"}),matches:e=>e.startsWith("conditionBranch-"),reactFlowType:"conditionBranchNode",branchLabels:{branch1:"Branch 1",branch2:"Branch 2",default:"Default"},formSchema:[{id:"title",type:"text",label:"Node Label",placeholder:"e.g. Route by User Role"},{id:"branchConfigs",type:"array",label:"Branches",required:!0,children:[{id:"key",type:"text",label:"Branch Key",required:!0,placeholder:"e.g. admin (no spaces)"},{id:"label",type:"text",label:"Branch Label",required:!0,placeholder:"e.g. Admin Users"},{id:"conditions",type:"array",label:"Conditions",children:[{id:"field",type:"text",label:"Field / Variable",required:!0,placeholder:"e.g. user.role",formulaEnabled:!0},{id:"operator",type:"select",label:"Operator",required:!0,options:y},{id:"value",type:"text",label:"Value",placeholder:"e.g. admin",formulaEnabled:!0,shouldHide:({values:e})=>e.operator==="isEmpty"||e.operator==="isNotEmpty"},{id:"logicalOperator",type:"select",label:"Combine with next",options:[{label:"AND",value:"AND"},{label:"OR",value:"OR"}]}]}]},{id:"defaultBranch",type:"text",label:"Default Branch Key (fallback if no condition matches)",placeholder:"e.g. default"}],bpmnEntry:e=>`Condition Branch: ${e}`,bpmnExit:e=>`End Condition Branch: ${e}`,emitBpmnElements:(e,t)=>{const l=t,i=l.branchConfigs??[];return[{id:e,$type:"bpmn:ExclusiveGateway",name:l.title??"Condition Branch"},...i.map(n=>({id:`${e}-${n.key}`,$type:"bpmn:SequenceFlow",name:n.label}))]}}),E=o({type:"webhookTrigger",label:"Webhook Trigger",icon:a.createElement(r.MdWebhook,{size:d.NODE_DESCRIPTOR_ICON_SIZE,color:"#1565c0"}),matches:e=>e.startsWith("webhookTrigger-"),reactFlowType:"webhookTriggerNode",formSchema:[{id:"endpointUrl",type:"text",label:"Endpoint URL",disabled:!0,placeholder:"Generated after saving"},{id:"authMethod",type:"select",label:"Authentication",required:!0,options:[{label:"None",value:"none"},{label:"API Key",value:"api-key"},{label:"HMAC Signature",value:"hmac"}]},{id:"apiKeyHeader",type:"text",label:"API Key Header Name",placeholder:"e.g. X-API-Key",shouldHide:({values:e})=>e.authMethod!=="api-key"},{id:"hmacSecret",type:"text",label:"HMAC Secret",placeholder:"Shared secret for signature verification",shouldHide:({values:e})=>e.authMethod!=="hmac"},{id:"payloadDescription",type:"textarea",label:"Expected Payload Description",placeholder:"Describe the expected JSON payload fields..."}],bpmnEntry:e=>`Webhook Trigger: ${e}`,bpmnExit:e=>`End Webhook Trigger: ${e}`,emitBpmnElements:e=>[{id:e,$type:"bpmn:StartEvent",name:"Webhook Trigger"}]}),g={triggerKey:"WEBHOOK_TRIGGER",label:"Incoming Webhook",description:"Start this workflow when an HTTP POST is received at a generated endpoint.",triggerCategory:"webhook",icon:a.createElement(r.MdWebhook,{size:d.NODE_DESCRIPTOR_ICON_SIZE,color:"#1565c0"})};function p(e={}){return o({type:"subWorkflow",label:"Sub-Workflow",icon:a.createElement(r.MdAccountTree,{size:18,color:"#00695c"}),matches:t=>t.startsWith("subWorkflow-"),reactFlowType:"subWorkflowNode",formSchema:[{id:"workflowId",type:"select",label:"Workflow to Call",required:!0,placeholder:"Select a workflow...",...e.fetchWorkflowOptions?{fetchOptions:e.fetchWorkflowOptions}:{options:[]}},{id:"workflowLabel",type:"text",label:"Display Name (optional)",placeholder:"Override display name shown on canvas"},{id:"inputMapping",type:"key-value",label:"Input Mapping",placeholder:"Map parent variables → sub-workflow inputs",formulaEnabled:!0},{id:"outputMapping",type:"key-value",label:"Output Mapping",placeholder:"Map sub-workflow outputs → parent variables"},{id:"waitForCompletion",type:"toggle",label:"Wait for sub-workflow to complete before continuing"},{id:"continueOnError",type:"toggle",label:"Continue parent workflow if sub-workflow fails"}],bpmnEntry:t=>`Sub-Workflow Call: ${t}`,bpmnExit:t=>`End Sub-Workflow Call: ${t}`,emitBpmnElements:(t,l)=>{const i=l;return[{id:t,$type:"bpmn:CallActivity",name:i.workflowLabel||i.workflowId||"Sub-Workflow",calledElement:i.workflowId}]}})}const k=p();class c{constructor(){this.descriptors=new Map}register(t){return this.descriptors.set(t.type,t),this}forType(t){return this.descriptors.get(t)}forId(t){for(const l of this.descriptors.values())if(l.matches(t))return l}list(){return[...this.descriptors.values()]}}const w=new c;exports.NodeTypeRegistry=c;exports.baseNodeDefaults=s;exports.conditionBranchDescriptor=f;exports.defineNode=o;exports.endEventDescriptor=b;exports.makeSubWorkflowDescriptor=p;exports.nodeTypeRegistry=w;exports.notificationDescriptor=m;exports.restApiDescriptor=h;exports.startEventDescriptor=u;exports.subWorkflowDescriptor=k;exports.webhookTriggerDescriptor=E;exports.webhookTriggerTemplate=g;

package/dist/nodeRegistry.d.ts

@@ -0,0 +1,293 @@
+import { AnySchema } from 'yup';
+import { ReactNode } from 'react';
+
+/**
+ * Base defaults shared by every node descriptor. A new node only has to specify
+ * what makes it different — these fill in the rest.
+ *
+ * - `formSchema: []`            → no config form unless the node defines one
+ * - `bpmnEntry` / `bpmnExit`    → incoming/outgoing flow connects to the node id itself
+ * - `emitBpmnElements`          → a single generic bpmn:Task; override for real output
+ */
+export declare const baseNodeDefaults: Pick<NodeDescriptor, 'formSchema' | 'bpmnEntry' | 'bpmnExit' | 'emitBpmnElements'>;
+
+declare interface BpmnElement {
+    id: string;
+    $type: string;
+    [key: string]: unknown;
+}
+
+declare type BranchChain = CanvasSlot[];
+
+declare interface BranchMap {
+    [filterId: string]: {
+        [branchKey: string]: BranchChain;
+    };
+}
+
+declare interface CanvasSlot {
+    id: string;
+    kind: SlotKind;
+    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>;
+}
+
+export declare const conditionBranchDescriptor: NodeDescriptor;
+
+/** One column in a per-field condition row */
+declare interface ConditionFieldDef {
+    /** Key used to store this column's value in ConditionEntry */
+    id: string;
+    /**
+     * 'select'   — native <select> with user-supplied options
+     * 'operator' — native <select> pre-filled with the standard operator list (no options needed)
+     * 'text'     — plain <input>
+     * any other string — falls back to <input>
+     */
+    type: 'select' | 'operator' | 'text' | string;
+    colSpan?: number;
+    label?: string;
+    placeholder?: string;
+    /** Options for select columns — user defines these, renderer just renders them */
+    options?: Array<{
+        value: string;
+        label: string;
+    }>;
+    /** When true, renders a FormulaInput chip editor instead of a plain <input> */
+    formula?: boolean;
+}
+
+/**
+ * Build a node descriptor on top of {@link baseNodeDefaults}.
+ *
+ * Supply the four required identity fields plus only the behaviour you want to
+ * override. Everything else inherits the base.
+ *
+ *   export const startEventDescriptor = defineNode({
+ *     type: 'startEvent',
+ *     label: 'Start',
+ *     matches: (id) => id === 'start',
+ *     reactFlowType: 'startNode',
+ *     emitBpmnElements: (id) => [{ id, $type: 'bpmn:StartEvent' }], // override
+ *   });
+ */
+export declare function defineNode(overrides: RequiredNodeFields & Partial<NodeDescriptor>): NodeDescriptor;
+
+declare interface DmnDefinition {
+    id: string;
+    [key: string]: unknown;
+}
+
+/**
+ * End event — a fixed skeleton node with no user-editable form.
+ * The canvas seeds the main-spine end as the literal slot id `'end'`, and one
+ * end per branch as `'end-${filterId}-${branch}'` (see WorkflowCanvas.tsx).
+ * `matches` must cover both shapes so every terminal node resolves via `forId`
+ * during descriptor-driven BPMN load — otherwise branch ends get skipped.
+ *
+ * Inherits formSchema (none) and bpmnEntry/bpmnExit from the base node.
+ */
+export declare const endEventDescriptor: NodeDescriptor;
+
+/** Condition definition attached to a FieldDescriptor */
+declare interface FieldConditionDef {
+    fields: ConditionFieldDef[];
+    /** Enables nested condition groups. Defaults to false. */
+    allowGroups?: boolean;
+    /** Optional depth limit for nested groups when allowGroups is true. */
+    maxGroupDepth?: number;
+}
+
+declare interface FieldContext {
+    values: Record<string, unknown>;
+}
+
+declare interface FieldDescriptor {
+    /**
+     * The formik key for this field.
+     * Use `id` (preferred) or `name` — both are accepted.
+     * `id` takes precedence if both are provided.
+     */
+    id?: string;
+    name?: string;
+    type: FieldType | string;
+    /** Child field descriptors — used by type: 'object' to render a nested group. */
+    children?: FieldDescriptor[];
+    /** Optional per-field condition guard — renders a condition row below this field. */
+    condition?: FieldConditionDef;
+    label?: string;
+    placeholder?: string;
+    required?: boolean;
+    showOptional?: boolean;
+    disabled?: boolean | ((ctx: FieldContext) => boolean);
+    hidden?: boolean;
+    colSpan?: number;
+    dividerAfter?: boolean;
+    info?: string;
+    helperText?: string;
+    dataTestId?: string;
+    validation?: AnySchema;
+    shouldHide?: (ctx: FieldContext) => boolean;
+    shouldDisable?: (ctx: FieldContext) => boolean;
+    shouldRequire?: (ctx: FieldContext) => boolean;
+    compute?: (ctx: FieldContext) => unknown;
+    transform?: FieldTransform;
+    onChange?: (value: unknown, ctx: FieldContext & {
+        setFieldValue: (name: string, value: unknown) => void;
+    }) => void;
+    [key: string]: unknown;
+}
+
+declare interface FieldTransform {
+    in?: (value: unknown) => unknown;
+    out?: (value: unknown) => unknown;
+}
+
+declare type FieldType = 'text' | 'textarea' | 'number' | 'toggle' | 'radio-group' | 'select' | 'descriptive-select' | 'key-value' | 'array' | 'object' | 'reference' | 'cron' | 'schema';
+
+declare interface FixedEdge {
+    id: string;
+    source: string;
+    target: string;
+}
+
+declare interface FixedNode {
+    id: string;
+    type: string;
+    data?: Record<string, unknown>;
+    deletable?: false;
+}
+
+export declare function makeSubWorkflowDescriptor(opts?: SubWorkflowDescriptorOptions): NodeDescriptor;
+
+export declare interface NodeDescriptor {
+    type: string;
+    label: string;
+    icon?: ReactNode;
+    /**
+     * Optional "app" this action belongs to (Slack, Salesforce, …). When present,
+     * the node picker drills down: stage 1 lists unique apps, stage 2 lists this
+     * app's actions, stage 3 is the action's config form. Descriptors without an
+     * `app` field appear ungrouped at stage 1, alongside the app cards.
+     */
+    app?: {
+        key: string;
+        label: string;
+        icon?: ReactNode;
+        description?: string;
+    };
+    matches: (id: string) => boolean;
+    bpmnEntry: (nodeId: string) => string;
+    bpmnExit: (nodeId: string) => string;
+    emitBpmnElements: (nodeId: string, nodeData: unknown) => BpmnElement[];
+    emitDmnDefinition?: (nodeId: string, nodeData: unknown) => DmnDefinition;
+    outgoingCondition?: (nodeId: string, targetId: string, nodeData: unknown) => string;
+    reactFlowType: string;
+    previewNodeType?: string;
+    /**
+     * Optional custom node-card body. When provided, the node renderer shows this
+     * instead of the default value badges — lets a node author fully design the
+     * card body while keeping the shared frame (title, edit/delete, handles).
+     * Receives the node's saved formData.
+     */
+    renderNode?: (nodeData: Record<string, unknown>) => ReactNode;
+    /** 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[]>);
+    maxPerWorkflow?: number;
+    relatedNodePrefixes?: string[];
+}
+
+export declare class NodeTypeRegistry {
+    private descriptors;
+    register(descriptor: NodeDescriptor): this;
+    forType(type: string): NodeDescriptor | undefined;
+    forId(id: string): NodeDescriptor | undefined;
+    list(): NodeDescriptor[];
+}
+
+export declare const nodeTypeRegistry: NodeTypeRegistry;
+
+export declare const notificationDescriptor: NodeDescriptor;
+
+/** The fields every node MUST provide — there is no sensible default for these. */
+declare type RequiredNodeFields = Pick<NodeDescriptor, 'type' | 'label' | 'matches' | 'reactFlowType'>;
+
+export declare const restApiDescriptor: NodeDescriptor;
+
+declare type SlotKind = 'start' | 'end' | 'addTrigger' | 'triggerFixed' | 'userTask' | 'addStep' | 'filter' | 'approval';
+
+/**
+ * Start event — a fixed skeleton node with no user-editable form.
+ * The canvas seeds it as the literal slot id `'start'` (see buildInitialSlots
+ * in WorkflowCanvas.tsx). This descriptor exists so the registry can resolve
+ * that id via `forId('start')` and emit it during descriptor-driven BPMN save.
+ *
+ * Inherits formSchema (none) and bpmnEntry/bpmnExit from the base node.
+ */
+export declare const startEventDescriptor: NodeDescriptor;
+
+/** Pre-built static descriptor (no dynamic workflow list). Swap for makeSubWorkflowDescriptor when you have an API. */
+export declare const subWorkflowDescriptor: NodeDescriptor;
+
+/**
+ * Sub-Workflow node — calls another saved workflow by ID.
+ *
+ * The host app must provide `fetchWorkflowOptions` at registration time so the
+ * `workflowId` select field can populate. Inject it via the descriptor factory:
+ *
+ *   import { makeSubWorkflowDescriptor } from '@miniorange/flowforge';
+ *   nodeTypeRegistry.register(makeSubWorkflowDescriptor({
+ *     fetchWorkflowOptions: async () => myApi.listWorkflows(),
+ *   }));
+ */
+export declare interface SubWorkflowDescriptorOptions {
+    /** Return a list of available workflows for the workflowId select field */
+    fetchWorkflowOptions?: () => Promise<Array<{
+        label: string;
+        value: string;
+    }>>;
+}
+
+export declare const webhookTriggerDescriptor: NodeDescriptor;
+
+export declare const webhookTriggerTemplate: WorkflowTemplate;
+
+declare interface WorkflowState {
+    slots: CanvasSlot[];
+    branches: BranchMap;
+}
+
+declare interface WorkflowTemplate {
+    triggerKey: string;
+    label: string;
+    description?: string;
+    icon?: ReactNode;
+    triggerCategory?: 'event' | 'scheduler' | 'webhook' | string;
+    availableTasks?: string[];
+    maxTasks?: number;
+    taskLabels?: Record<string, string>;
+    fixedNodes?: FixedNode[];
+    fixedEdges?: FixedEdge[];
+    insertionPoints?: string[];
+    source?: string;
+    product?: string;
+    /** Pre-built workflow state to clone when user selects this template */
+    skeletonState?: WorkflowState;
+    /** 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 { }