@notmrabhi/flowforge 0.1.34 → 0.1.36

package/dist/canvas.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("./templateSkeletons-CY4tkEp2.js"),t=require("./messages-O9Tw_XXR.js"),r=require("./bpmn-CcuE2X_Q.js"),e=require("./GatewayBranchEdge-9YF32wwN.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-BTC2fk5u.js"),t=require("./messages-O9Tw_XXR.js"),r=require("./bpmn-CcuE2X_Q.js"),e=require("./GatewayBranchEdge-9YF32wwN.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;
 //# sourceMappingURL=canvas.cjs.map

package/dist/canvas.d.ts

@@ -24,6 +24,38 @@ export declare interface AddStepContext {
     branch?: string;
 }
 
+/**
+ * Wire shape the backend `/api/v1/workflow-template` endpoint is expected
+ * to return. Top-level fields mirror the persistence model; everything
+ * UI-related lives under `templateUI`. Use with `templateRegistry.registerFromApi(list)`.
+ */
+export declare interface ApiWorkflowTemplate {
+    key: string;
+    name: string;
+    state?: string;
+    description?: string;
+    allowedTasks?: string[];
+    allowedSources?: string[];
+    configuration?: Record<string, unknown>;
+    templateUI?: Partial<Omit<WorkflowTemplate, 'triggerKey' | 'label' | 'description' | 'availableTasks'>>;
+}
+
+/**
+ * Wire shape the backend `/api/v1/workflow-template` endpoint is expected
+ * to return. Top-level fields mirror the persistence model; everything
+ * UI-related lives under `templateUI`. Use with `templateRegistry.registerFromApi(list)`.
+ */
+declare interface ApiWorkflowTemplate_2 {
+    key: string;
+    name: string;
+    state?: string;
+    description?: string;
+    allowedTasks?: string[];
+    allowedSources?: string[];
+    configuration?: Record<string, unknown>;
+    templateUI?: Partial<Omit<WorkflowTemplate_3, 'triggerKey' | 'label' | 'description' | 'availableTasks'>>;
+}
+
 export declare const ApprovalNode: ({ id, data }: NodeProps) => JSX_2.Element;
 
 export declare interface BpmnElement {
@@ -284,6 +316,18 @@ declare interface FieldDescriptor {
     shouldHide?: (ctx: FieldContext) => boolean;
     shouldDisable?: (ctx: FieldContext) => boolean;
     shouldRequire?: (ctx: FieldContext) => boolean;
+    /**
+     * When true, the field's value is auto-cleared (reset to `defaultValue`,
+     * or removed if no default) any time `shouldHide` evaluates to true —
+     * including on mount when the saved data has orphan values from a prior
+     * configuration. Default: false (values persist while hidden, preserving
+     * legacy behavior).
+     *
+     * Use this on conditional fields where stale data would corrupt the
+     * payload (e.g. `template` should be empty when `valueSource !== 'template'`).
+     */
+    clearOnHide?: boolean;
+    defaultValue?: unknown;
     compute?: (ctx: FieldContext) => unknown;
     transform?: FieldTransform;
     onChange?: (value: unknown, ctx: FieldContext & {
@@ -320,6 +364,18 @@ declare interface FieldDescriptor_2 {
     shouldHide?: (ctx: FieldContext_2) => boolean;
     shouldDisable?: (ctx: FieldContext_2) => boolean;
     shouldRequire?: (ctx: FieldContext_2) => boolean;
+    /**
+     * When true, the field's value is auto-cleared (reset to `defaultValue`,
+     * or removed if no default) any time `shouldHide` evaluates to true —
+     * including on mount when the saved data has orphan values from a prior
+     * configuration. Default: false (values persist while hidden, preserving
+     * legacy behavior).
+     *
+     * Use this on conditional fields where stale data would corrupt the
+     * payload (e.g. `template` should be empty when `valueSource !== 'template'`).
+     */
+    clearOnHide?: boolean;
+    defaultValue?: unknown;
     compute?: (ctx: FieldContext_2) => unknown;
     transform?: FieldTransform_2;
     onChange?: (value: unknown, ctx: FieldContext_2 & {
@@ -703,13 +759,40 @@ declare interface SubWorkflowPreviewDrawerProps {
 
 declare class TemplateRegistry {
     private templates;
+    /**
+     * Register a template. Normalises `allowedTasks` (the backend's name) →
+     * `availableTasks` (FlowForge's canonical name) so consumers can pass
+     * either without rewriting.
+     */
     register(template: WorkflowTemplate_3): this;
+    /**
+     * Register a list of templates fetched from `GET /api/v1/workflow-template`.
+     *
+     * The API shape is:
+     *   {
+     *     key, name, description, allowedTasks, allowedSources,
+     *     configuration,            // runtime BPMN — ignored by the canvas
+     *     templateUI: {             // ← UI bag, spread onto the template
+     *       triggerCategory, icon, tags, category, author, popularity,
+     *       source, product, taskLabels, maxTasks, skeletonState, …
+     *     }
+     *   }
+     *
+     * Anything in `templateUI` overrides the top-level shorthand where there's
+     * an overlap. Bad rows (missing `key`) are skipped with a DEV warning
+     * rather than throwing, so one broken template doesn't blank the picker.
+     *
+     * Returns `this` for chaining and the count of templates registered.
+     */
+    registerFromApi(list: ApiWorkflowTemplate_2[]): 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[];
+    /** Remove every template — useful before re-loading from backend. */
+    clear(): this;
 }
 
 export declare const TriggerNode: ({ data }: NodeProps) => JSX_2.Element;
@@ -752,7 +835,13 @@ export declare interface WorkflowTemplate {
     description?: string;
     icon?: ReactNode;
     triggerCategory?: 'event' | 'scheduler' | 'webhook' | string;
+    /**
+     * Task IDs (descriptor types) that can be inserted into this workflow.
+     * `allowedTasks` is accepted as an alias for backend payloads that use
+     * that name — TemplateRegistry.register() normalises them.
+     */
     availableTasks?: string[];
+    allowedTasks?: string[];
     maxTasks?: number;
     taskLabels?: Record<string, string>;
     fixedNodes?: FixedNode_3[];
@@ -778,7 +867,13 @@ declare interface WorkflowTemplate_2 {
     description?: string;
     icon?: ReactNode;
     triggerCategory?: 'event' | 'scheduler' | 'webhook' | string;
+    /**
+     * Task IDs (descriptor types) that can be inserted into this workflow.
+     * `allowedTasks` is accepted as an alias for backend payloads that use
+     * that name — TemplateRegistry.register() normalises them.
+     */
     availableTasks?: string[];
+    allowedTasks?: string[];
     maxTasks?: number;
     taskLabels?: Record<string, string>;
     fixedNodes?: FixedNode[];
@@ -804,7 +899,13 @@ declare interface WorkflowTemplate_3 {
     description?: string;
     icon?: ReactNode;
     triggerCategory?: 'event' | 'scheduler' | 'webhook' | string;
+    /**
+     * Task IDs (descriptor types) that can be inserted into this workflow.
+     * `allowedTasks` is accepted as an alias for backend payloads that use
+     * that name — TemplateRegistry.register() normalises them.
+     */
     availableTasks?: string[];
+    allowedTasks?: string[];
     maxTasks?: number;
     taskLabels?: Record<string, string>;
     fixedNodes?: FixedNode_2[];

package/dist/canvas.js

@@ -1,4 +1,4 @@
-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-BPIZ_EHv.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-DCvfog6-.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-Dxoy5B1A.js";

package/dist/core.d.ts

@@ -1,6 +1,22 @@
 import { AnySchema } from 'yup';
 import { ReactNode } from 'react';
 
+/**
+ * Wire shape the backend `/api/v1/workflow-template` endpoint is expected
+ * to return. Top-level fields mirror the persistence model; everything
+ * UI-related lives under `templateUI`. Use with `templateRegistry.registerFromApi(list)`.
+ */
+export declare interface ApiWorkflowTemplate {
+    key: string;
+    name: string;
+    state?: string;
+    description?: string;
+    allowedTasks?: string[];
+    allowedSources?: string[];
+    configuration?: Record<string, unknown>;
+    templateUI?: Partial<Omit<WorkflowTemplate, 'triggerKey' | 'label' | 'description' | 'availableTasks'>>;
+}
+
 /**
  * Base defaults shared by every node descriptor. A new node only has to specify
  * what makes it different — these fill in the rest.
@@ -156,6 +172,18 @@ declare interface FieldDescriptor {
     shouldHide?: (ctx: FieldContext) => boolean;
     shouldDisable?: (ctx: FieldContext) => boolean;
     shouldRequire?: (ctx: FieldContext) => boolean;
+    /**
+     * When true, the field's value is auto-cleared (reset to `defaultValue`,
+     * or removed if no default) any time `shouldHide` evaluates to true —
+     * including on mount when the saved data has orphan values from a prior
+     * configuration. Default: false (values persist while hidden, preserving
+     * legacy behavior).
+     *
+     * Use this on conditional fields where stale data would corrupt the
+     * payload (e.g. `template` should be empty when `valueSource !== 'template'`).
+     */
+    clearOnHide?: boolean;
+    defaultValue?: unknown;
     compute?: (ctx: FieldContext) => unknown;
     transform?: FieldTransform;
     onChange?: (value: unknown, ctx: FieldContext & {
@@ -338,13 +366,40 @@ export declare interface SubWorkflowDescriptorOptions {
 
 export declare class TemplateRegistry {
     private templates;
+    /**
+     * Register a template. Normalises `allowedTasks` (the backend's name) →
+     * `availableTasks` (FlowForge's canonical name) so consumers can pass
+     * either without rewriting.
+     */
     register(template: WorkflowTemplate): this;
+    /**
+     * Register a list of templates fetched from `GET /api/v1/workflow-template`.
+     *
+     * The API shape is:
+     *   {
+     *     key, name, description, allowedTasks, allowedSources,
+     *     configuration,            // runtime BPMN — ignored by the canvas
+     *     templateUI: {             // ← UI bag, spread onto the template
+     *       triggerCategory, icon, tags, category, author, popularity,
+     *       source, product, taskLabels, maxTasks, skeletonState, …
+     *     }
+     *   }
+     *
+     * Anything in `templateUI` overrides the top-level shorthand where there's
+     * an overlap. Bad rows (missing `key`) are skipped with a DEV warning
+     * rather than throwing, so one broken template doesn't blank the picker.
+     *
+     * Returns `this` for chaining and the count of templates registered.
+     */
+    registerFromApi(list: ApiWorkflowTemplate[]): this;
     lookup(triggerKey: string): WorkflowTemplate | undefined;
     list(): WorkflowTemplate[];
     listByCategory(category: string): WorkflowTemplate[];
     listByTag(tag: string): WorkflowTemplate[];
     search(query: string): WorkflowTemplate[];
     categories(): string[];
+    /** Remove every template — useful before re-loading from backend. */
+    clear(): this;
 }
 
 export declare const templateRegistry: TemplateRegistry;
@@ -364,7 +419,13 @@ export declare interface WorkflowTemplate {
     description?: string;
     icon?: ReactNode;
     triggerCategory?: 'event' | 'scheduler' | 'webhook' | string;
+    /**
+     * Task IDs (descriptor types) that can be inserted into this workflow.
+     * `allowedTasks` is accepted as an alias for backend payloads that use
+     * that name — TemplateRegistry.register() normalises them.
+     */
     availableTasks?: string[];
+    allowedTasks?: string[];
     maxTasks?: number;
     taskLabels?: Record<string, string>;
     fixedNodes?: FixedNode[];

package/dist/form.cjs

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-x1DrmceO.js"),r=require("./SchemaBuilderDrawer-BcaULxqB.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-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;
 //# sourceMappingURL=form.cjs.map

package/dist/form.d.ts

@@ -339,6 +339,18 @@ export declare interface FieldDescriptor {
     shouldHide?: (ctx: FieldContext) => boolean;
     shouldDisable?: (ctx: FieldContext) => boolean;
     shouldRequire?: (ctx: FieldContext) => boolean;
+    /**
+     * When true, the field's value is auto-cleared (reset to `defaultValue`,
+     * or removed if no default) any time `shouldHide` evaluates to true —
+     * including on mount when the saved data has orphan values from a prior
+     * configuration. Default: false (values persist while hidden, preserving
+     * legacy behavior).
+     *
+     * Use this on conditional fields where stale data would corrupt the
+     * payload (e.g. `template` should be empty when `valueSource !== 'template'`).
+     */
+    clearOnHide?: boolean;
+    defaultValue?: unknown;
     compute?: (ctx: FieldContext) => unknown;
     transform?: FieldTransform;
     onChange?: (value: unknown, ctx: FieldContext & {

package/dist/form.js

@@ -1,5 +1,5 @@
-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-CEg1wTCw.js";
-import { F as j, S as q, a as H, u as N } from "./SchemaBuilderDrawer-BbkOK4Xc.js";
+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 "react/jsx-runtime";
 import "react";
 import "@mui/material";