@xyne/workflow-ui 0.1.0

package/dist/hooks/use-undo-redo.js

@@ -0,0 +1,58 @@
+import { useCallback, useRef, useState } from 'react';
+/**
+ * Generic undo/redo stack for immutable state values.
+ *
+ * Every call to `setState` pushes to the history stack.
+ * `undo()` / `redo()` navigate the stack without mutating it.
+ */
+export function useUndoRedo(initialState, maxHistory = 50) {
+    const [state, setStateInternal] = useState(initialState);
+    const pastRef = useRef([]);
+    const futureRef = useRef([]);
+    const setState = useCallback((next) => {
+        setStateInternal((prev) => {
+            const past = pastRef.current;
+            past.push(prev);
+            if (past.length > maxHistory) {
+                past.shift();
+            }
+            futureRef.current = [];
+            return typeof next === 'function' ? next(prev) : next;
+        });
+    }, [maxHistory]);
+    const undo = useCallback(() => {
+        setStateInternal((current) => {
+            const past = pastRef.current;
+            if (past.length === 0)
+                return current;
+            const previous = past.pop();
+            futureRef.current.push(current);
+            return previous;
+        });
+    }, []);
+    const redo = useCallback(() => {
+        setStateInternal((current) => {
+            const future = futureRef.current;
+            if (future.length === 0)
+                return current;
+            const next = future.pop();
+            pastRef.current.push(current);
+            return next;
+        });
+    }, []);
+    const reset = useCallback((initial) => {
+        pastRef.current = [];
+        futureRef.current = [];
+        setStateInternal(initial);
+    }, []);
+    return {
+        state,
+        setState,
+        undo,
+        redo,
+        canUndo: pastRef.current.length > 0,
+        canRedo: futureRef.current.length > 0,
+        reset,
+    };
+}
+//# sourceMappingURL=use-undo-redo.js.map

package/dist/hooks/use-undo-redo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-undo-redo.js","sourceRoot":"","sources":["../../src/hooks/use-undo-redo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAYtD;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAI,YAAe,EAAE,UAAU,GAAG,EAAE;IAC7D,MAAM,CAAC,KAAK,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAI,YAAY,CAAC,CAAC;IAC5D,MAAM,OAAO,GAAG,MAAM,CAAM,EAAE,CAAC,CAAC;IAChC,MAAM,SAAS,GAAG,MAAM,CAAM,EAAE,CAAC,CAAC;IAElC,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,IAA0B,EAAE,EAAE;QAC1D,gBAAgB,CAAC,CAAC,IAAI,EAAE,EAAE;YACxB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChB,IAAI,IAAI,CAAC,MAAM,GAAG,UAAU,EAAE,CAAC;gBAC7B,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,CAAC;YACD,SAAS,CAAC,OAAO,GAAG,EAAE,CAAC;YACvB,OAAO,OAAO,IAAI,KAAK,UAAU,CAAC,CAAC,CAAE,IAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC5E,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAEjB,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5B,gBAAgB,CAAC,CAAC,OAAO,EAAE,EAAE;YAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;YAC7B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,OAAO,CAAC;YACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAG,CAAC;YAC7B,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAChC,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5B,gBAAgB,CAAC,CAAC,OAAO,EAAE,EAAE;YAC3B,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;YACjC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,OAAO,CAAC;YACxC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,EAAG,CAAC;YAC3B,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,OAAU,EAAE,EAAE;QACvC,OAAO,CAAC,OAAO,GAAG,EAAE,CAAC;QACrB,SAAS,CAAC,OAAO,GAAG,EAAE,CAAC;QACvB,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC5B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,KAAK;QACL,QAAQ;QACR,IAAI;QACJ,IAAI;QACJ,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QACnC,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QACrC,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/hooks/use-variable-picker.d.ts

@@ -0,0 +1,26 @@
+import type { WorkflowConfig } from '@xyne/workflow-sdk/builder';
+export interface VariableNode {
+    path: string;
+    label: string;
+    schemaType: string;
+    children: VariableNode[];
+    isLeaf: boolean;
+    refString: string;
+}
+export interface UseVariablePickerOptions {
+    config: WorkflowConfig;
+    atStepId: string;
+    filterType?: string;
+    enabled?: boolean;
+    /** Map of step ID → human-readable name (e.g. "agent_analysis" → "Code"). Built from step metadata. */
+    stepLabelMap?: Map<string, string>;
+}
+export interface UseVariablePickerReturn {
+    variables: VariableNode[];
+    flatPaths: VariableNode[];
+    isLoading: boolean;
+    error: Error | null;
+    search: (query: string) => VariableNode[];
+}
+export declare function useVariablePicker(opts: UseVariablePickerOptions): UseVariablePickerReturn;
+//# sourceMappingURL=use-variable-picker.d.ts.map

package/dist/hooks/use-variable-picker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-variable-picker.d.ts","sourceRoot":"","sources":["../../src/hooks/use-variable-picker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAKjE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AA6FD,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,uGAAuG;IACvG,YAAY,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,YAAY,EAAE,CAAC;CAC3C;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,wBAAwB,GAAG,uBAAuB,CAuDzF"}

package/dist/hooks/use-variable-picker.js

@@ -0,0 +1,132 @@
+import { useCallback, useEffect, useMemo, useState } from 'react';
+import { useWorkflowClient } from './use-workflow-client.js';
+// ─── JSON Schema → tree ───
+function schemaToTree(contextMap, labelMap) {
+    const roots = [];
+    for (const [path, schema] of Object.entries(contextMap)) {
+        const displayLabel = resolveRootLabel(path, labelMap);
+        const rootNode = buildNodeFromSchema(path, displayLabel, schema);
+        roots.push(rootNode);
+    }
+    return roots;
+}
+/**
+ * Resolve a root-level context path to a human-readable label.
+ *
+ * Context paths look like:
+ *   "trigger"                         → "Trigger"
+ *   "steps.agent_analysis.output"     → "Code (agent_analysis)" if labelMap has the mapping
+ *
+ * The refString stays as the raw path; only the display label changes.
+ */
+function resolveRootLabel(path, labelMap) {
+    if (path === 'trigger')
+        return 'Trigger';
+    // Extract step ID from "steps.<stepId>.output" pattern
+    const match = path.match(/^steps\.([^.]+)/);
+    if (match) {
+        const stepId = match[1];
+        const stepName = labelMap?.get(stepId);
+        if (stepName)
+            return `${stepName} (${stepId})`;
+        return stepId;
+    }
+    return path;
+}
+function buildNodeFromSchema(path, label, schema) {
+    const type = schema['type'] ?? 'unknown';
+    const children = [];
+    if (type === 'object' && schema['properties']) {
+        const props = schema['properties'];
+        for (const [key, propSchema] of Object.entries(props)) {
+            children.push(buildNodeFromSchema(`${path}.${key}`, key, propSchema));
+        }
+    }
+    return {
+        path,
+        label,
+        schemaType: type,
+        children,
+        isLeaf: children.length === 0,
+        refString: `{{${path}}}`,
+    };
+}
+function flattenLeaves(nodes) {
+    const result = [];
+    for (const node of nodes) {
+        if (node.isLeaf) {
+            result.push(node);
+        }
+        else {
+            result.push(...flattenLeaves(node.children));
+        }
+    }
+    return result;
+}
+function searchNodes(nodes, query) {
+    const lower = query.toLowerCase();
+    return flattenLeaves(nodes).filter((n) => n.path.toLowerCase().includes(lower)
+        || n.label.toLowerCase().includes(lower)
+        || n.refString.toLowerCase().includes(lower));
+}
+export function useVariablePicker(opts) {
+    const { config, atStepId, filterType, enabled = true, stepLabelMap } = opts;
+    const client = useWorkflowClient();
+    const [contextMap, setContextMap] = useState(null);
+    const [isLoading, setIsLoading] = useState(false);
+    const [error, setError] = useState(null);
+    useEffect(() => {
+        if (!enabled || !atStepId)
+            return;
+        let cancelled = false;
+        setIsLoading(true);
+        setError(null);
+        void (async () => {
+            try {
+                const result = await client.schema.availableContext(config, atStepId);
+                if (!cancelled) {
+                    setContextMap(result);
+                }
+            }
+            catch (err) {
+                if (!cancelled) {
+                    setError(err instanceof Error ? err : new Error(String(err)));
+                }
+            }
+            finally {
+                if (!cancelled) {
+                    setIsLoading(false);
+                }
+            }
+        })();
+        return () => { cancelled = true; };
+    }, [client, config, atStepId, enabled]);
+    const variables = useMemo(() => {
+        if (!contextMap)
+            return [];
+        let tree = schemaToTree(contextMap, stepLabelMap);
+        if (filterType) {
+            tree = tree.map((node) => filterByType(node, filterType)).filter(Boolean);
+        }
+        return tree;
+    }, [contextMap, filterType, stepLabelMap]);
+    const flatPaths = useMemo(() => flattenLeaves(variables), [variables]);
+    const search = useCallback((query) => {
+        if (!query)
+            return flatPaths;
+        return searchNodes(variables, query);
+    }, [variables, flatPaths]);
+    return { variables, flatPaths, isLoading, error, search };
+}
+function filterByType(node, type) {
+    if (node.isLeaf) {
+        return node.schemaType === type ? node : null;
+    }
+    const filtered = node.children
+        .map((child) => filterByType(child, type))
+        .filter(Boolean);
+    if (filtered.length === 0)
+        return null;
+    return { ...node, children: filtered };
+}
+//# sourceMappingURL=use-variable-picker.js.map

package/dist/hooks/use-variable-picker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-variable-picker.js","sourceRoot":"","sources":["../../src/hooks/use-variable-picker.ts"],"names":[],"mappings":"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"}

package/dist/hooks/use-workflow-builder.d.ts

@@ -0,0 +1,47 @@
+import type { WorkflowConfig, WorkflowStepConfig, WorkflowSettings } from '@xyne/workflow-sdk/builder';
+import type { ValidationResult } from '@xyne/workflow-sdk';
+export interface UseWorkflowBuilderOptions {
+    initialConfig?: WorkflowConfig;
+    onChange?: (config: WorkflowConfig) => void;
+    autoValidate?: boolean;
+}
+export interface UseWorkflowBuilderReturn {
+    config: WorkflowConfig;
+    selectedStepId: string | null;
+    isTriggerSelected: boolean;
+    isTriggerConfigured: boolean;
+    isDirty: boolean;
+    validation: ValidationResult | null;
+    isValidating: boolean;
+    addStep: (type: string, afterStepId?: string, inBranch?: {
+        stepId: string;
+        branchKey: string;
+    }) => string;
+    removeStep: (stepId: string) => void;
+    updateStepConfig: (stepId: string, config: Record<string, unknown>) => void;
+    renameStep: (stepId: string, name: string) => void;
+    duplicateStep: (stepId: string) => void;
+    toggleStepDisabled: (stepId: string) => void;
+    /** Add a named branch to a step's dynamic branch container (e.g. PARALLEL's branches). */
+    addBranch: (stepId: string, containerKey: string, branchName: string) => void;
+    /** Remove a named branch from a step's dynamic branch container. */
+    removeBranch: (stepId: string, containerKey: string, branchName: string) => void;
+    /** Rename a branch in a step's dynamic branch container. */
+    renameBranch: (stepId: string, containerKey: string, oldName: string, newName: string) => void;
+    setTrigger: (type: string, config?: Record<string, unknown>) => void;
+    updateTriggerConfig: (config: Record<string, unknown>) => void;
+    updateSettings: (settings: Partial<WorkflowSettings>) => void;
+    selectStep: (stepId: string | null) => void;
+    selectTrigger: () => void;
+    clearSelection: () => void;
+    undo: () => void;
+    redo: () => void;
+    canUndo: boolean;
+    canRedo: boolean;
+    validate: () => Promise<ValidationResult>;
+    loadConfig: (config: WorkflowConfig) => void;
+    reset: () => void;
+    getStep: (stepId: string) => WorkflowStepConfig | null;
+}
+export declare function useWorkflowBuilder(opts?: UseWorkflowBuilderOptions): UseWorkflowBuilderReturn;
+//# sourceMappingURL=use-workflow-builder.d.ts.map

package/dist/hooks/use-workflow-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-workflow-builder.d.ts","sourceRoot":"","sources":["../../src/hooks/use-workflow-builder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAmJ3D,MAAM,WAAW,yBAAyB;IACxC,aAAa,CAAC,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,wBAAwB;IAEvC,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACpC,YAAY,EAAE,OAAO,CAAC;IAGtB,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;IAC1G,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,gBAAgB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC5E,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAG7C,0FAA0F;IAC1F,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9E,oEAAoE;IACpE,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACjF,4DAA4D;IAC5D,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAG/F,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACrE,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAG/D,cAAc,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC;IAG9D,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;IAC5C,aAAa,EAAE,MAAM,IAAI,CAAC;IAC1B,cAAc,EAAE,MAAM,IAAI,CAAC;IAG3B,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IAGjB,QAAQ,EAAE,MAAM,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC1C,UAAU,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAC7C,KAAK,EAAE,MAAM,IAAI,CAAC;IAGlB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,kBAAkB,GAAG,IAAI,CAAC;CACxD;AAED,wBAAgB,kBAAkB,CAChC,IAAI,GAAE,yBAA8B,GACnC,wBAAwB,CA0X1B"}

package/dist/hooks/use-workflow-builder.js

@@ -0,0 +1,374 @@
+import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { useWorkflowClient } from './use-workflow-client.js';
+import { useUndoRedo } from './use-undo-redo.js';
+import { detectBranchesFromConfig, setAtPath, getAtPath, generateConfigDefaults, walkStepConfigs, } from '../utils/branch-detection.js';
+// ─── Branch helpers (generic, config-driven) ───
+function getBranches(step, cache) {
+    if (!step.config || typeof step.config !== 'object')
+        return {};
+    return detectBranchesFromConfig(step.config, cache.get(step.type));
+}
+/**
+ * Apply `mapper` to every detected branch inside `step`. Uses immutable
+ * `setAtPath` writes so arbitrary-depth paths (e.g. `cases.0.steps`) work.
+ */
+function mapBranches(step, mapper, cache) {
+    const branches = getBranches(step, cache);
+    if (Object.keys(branches).length === 0)
+        return step;
+    let config = (step.config ?? {});
+    for (const [path, branch] of Object.entries(branches)) {
+        config = setAtPath(config, path, mapper(branch.steps));
+    }
+    return { ...step, config };
+}
+// ─── Step tree helpers ───
+function generateStepId(type) {
+    const suffix = Math.random().toString(36).slice(2, 8);
+    return `${type.toLowerCase()}_${suffix}`;
+}
+function insertStepAfter(steps, afterId, newStep) {
+    if (!afterId)
+        return [newStep, ...steps];
+    const idx = steps.findIndex((s) => s.id === afterId);
+    if (idx === -1)
+        return [...steps, newStep];
+    const result = [...steps];
+    result.splice(idx + 1, 0, newStep);
+    return result;
+}
+function removeStepById(steps, targetId, cache) {
+    return steps
+        .filter((s) => s.id !== targetId)
+        .map((s) => mapBranches(s, (branch) => removeStepById(branch, targetId, cache), cache));
+}
+function updateStepInTree(steps, targetId, updater, cache) {
+    return steps.map((s) => {
+        if (s.id === targetId)
+            return updater(s);
+        return mapBranches(s, (branch) => updateStepInTree(branch, targetId, updater, cache), cache);
+    });
+}
+function findStepInTree(steps, targetId, cache) {
+    for (const step of steps) {
+        if (step.id === targetId)
+            return step;
+        const branches = getBranches(step, cache);
+        for (const branch of Object.values(branches)) {
+            const found = findStepInTree(branch.steps, targetId, cache);
+            if (found)
+                return found;
+        }
+    }
+    return null;
+}
+/**
+ * Insert a step into a specific branch of a control-flow step.
+ * Handles dotted keys: "body" for LOOP, "branches.A" for PARALLEL.
+ */
+function insertIntoBranch(steps, branchStepId, branchKey, newStep, cache, afterStepId) {
+    return steps.map((s) => {
+        if (s.id === branchStepId && s.config && typeof s.config === 'object') {
+            const existing = getAtPath(s.config, branchKey);
+            const branch = (Array.isArray(existing) ? existing : []);
+            const config = setAtPath(s.config, branchKey, insertStepAfter(branch, afterStepId, newStep));
+            return { ...s, config };
+        }
+        return mapBranches(s, (branch) => insertIntoBranch(branch, branchStepId, branchKey, newStep, cache, afterStepId), cache);
+    });
+}
+// ─── Default config ───
+function defaultConfig() {
+    return {
+        trigger: { type: 'MANUAL', config: {} },
+        steps: [],
+    };
+}
+export function useWorkflowBuilder(opts = {}) {
+    const { initialConfig, onChange, autoValidate = false } = opts;
+    const client = useWorkflowClient();
+    const initial = useMemo(() => initialConfig ?? defaultConfig(), 
+    // Only use on first render
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    []);
+    const { state: config, setState: setConfig, undo, redo, canUndo, canRedo, reset: resetHistory, } = useUndoRedo(initial);
+    const [selectedStepId, setSelectedStepId] = useState(null);
+    const [isTriggerSelected, setIsTriggerSelected] = useState(false);
+    const [isTriggerConfigured, setIsTriggerConfigured] = useState(!!initialConfig?.trigger?.type);
+    const [validation, setValidation] = useState(null);
+    const [isValidating, setIsValidating] = useState(false);
+    const savedConfigRef = useRef(initial);
+    const isDirty = config !== savedConfigRef.current;
+    // Schema cache: maps step type → configSchema (JSON Schema) for branch detection
+    const schemaCacheRef = useRef(new Map());
+    // Fetch configSchema for all step types in the current config
+    useEffect(() => {
+        const types = new Set();
+        // Schema-free walk — works even when SWITCH's own schema isn't cached
+        // yet, so we discover steps nested inside cases[i].steps on the first pass.
+        walkStepConfigs(config.steps, (s) => { types.add(s.type); });
+        for (const type of types) {
+            if (!schemaCacheRef.current.has(type)) {
+                void (async () => {
+                    try {
+                        const desc = await client.schema.step(type);
+                        schemaCacheRef.current.set(type, desc.configSchema);
+                    }
+                    catch {
+                        // Step descriptor unavailable
+                    }
+                })();
+            }
+        }
+    }, [config.steps, client]);
+    // Notify parent on change
+    useEffect(() => {
+        onChange?.(config);
+    }, [config, onChange]);
+    // Auto-validate (debounced)
+    useEffect(() => {
+        if (!autoValidate)
+            return;
+        const timer = setTimeout(() => {
+            void (async () => {
+                try {
+                    const result = await client.workflows.validate(config);
+                    setValidation(result);
+                }
+                catch {
+                    // Validation failure is non-critical
+                }
+            })();
+        }, 500);
+        return () => clearTimeout(timer);
+    }, [config, autoValidate, client]);
+    // ─── Step mutations ───
+    const addStep = useCallback((type, afterStepId, inBranch) => {
+        const id = generateStepId(type);
+        const cache = schemaCacheRef.current;
+        const newStep = {
+            id,
+            type,
+            config: {},
+        };
+        const updatedSteps = inBranch
+            ? insertIntoBranch(config.steps, inBranch.stepId, inBranch.branchKey, newStep, cache, afterStepId)
+            : insertStepAfter(config.steps, afterStepId, newStep);
+        setConfig({ ...config, steps: updatedSteps });
+        // Fetch configSchema and backfill defaults (branch containers + default values)
+        void (async () => {
+            try {
+                const desc = await client.schema.step(type);
+                cache.set(type, desc.configSchema);
+                const defaults = generateConfigDefaults(desc.configSchema);
+                if (Object.keys(defaults).length > 0) {
+                    // Use functional updater to avoid overwriting concurrent changes
+                    setConfig((prev) => ({
+                        ...prev,
+                        steps: updateStepInTree(prev.steps, id, (s) => ({
+                            ...s,
+                            config: { ...defaults, ...s.config },
+                        }), cache),
+                    }));
+                }
+            }
+            catch {
+                // Descriptor fetch failed — keep empty config
+            }
+        })();
+        setSelectedStepId(id);
+        setIsTriggerSelected(false);
+        return id;
+    }, [config, setConfig, client]);
+    const removeStep = useCallback((stepId) => {
+        setConfig({
+            ...config,
+            steps: removeStepById(config.steps, stepId, schemaCacheRef.current),
+        });
+        if (selectedStepId === stepId) {
+            setSelectedStepId(null);
+        }
+    }, [config, setConfig, selectedStepId]);
+    const updateStepConfig = useCallback((stepId, stepConfig) => {
+        setConfig({
+            ...config,
+            steps: updateStepInTree(config.steps, stepId, (s) => ({
+                ...s,
+                config: { ...s.config, ...stepConfig },
+            }), schemaCacheRef.current),
+        });
+    }, [config, setConfig]);
+    const renameStep = useCallback((stepId, name) => {
+        setConfig({
+            ...config,
+            steps: updateStepInTree(config.steps, stepId, (s) => ({
+                ...s,
+                id: name,
+            }), schemaCacheRef.current),
+        });
+        if (selectedStepId === stepId) {
+            setSelectedStepId(name);
+        }
+    }, [config, setConfig, selectedStepId]);
+    const duplicateStep = useCallback((stepId) => {
+        const step = findStepInTree(config.steps, stepId, schemaCacheRef.current);
+        if (!step)
+            return;
+        const newId = generateStepId(step.type);
+        const duplicate = { ...structuredClone(step), id: newId };
+        setConfig({
+            ...config,
+            steps: insertStepAfter(config.steps, stepId, duplicate),
+        });
+    }, [config, setConfig]);
+    const toggleStepDisabled = useCallback((stepId) => {
+        setConfig({
+            ...config,
+            steps: updateStepInTree(config.steps, stepId, (s) => {
+                const cfg = (s.config ?? {});
+                return {
+                    ...s,
+                    config: { ...cfg, disabled: !cfg['disabled'] },
+                };
+            }, schemaCacheRef.current),
+        });
+    }, [config, setConfig]);
+    // ─── Branch mutations (for dynamic branches like PARALLEL) ───
+    const addBranch = useCallback((stepId, containerKey, branchName) => {
+        setConfig({
+            ...config,
+            steps: updateStepInTree(config.steps, stepId, (s) => {
+                const cfg = { ...s.config };
+                const container = { ...(cfg[containerKey] ?? {}) };
+                container[branchName] = [];
+                cfg[containerKey] = container;
+                return { ...s, config: cfg };
+            }, schemaCacheRef.current),
+        });
+    }, [config, setConfig]);
+    const removeBranch = useCallback((stepId, containerKey, branchName) => {
+        setConfig({
+            ...config,
+            steps: updateStepInTree(config.steps, stepId, (s) => {
+                const cfg = { ...s.config };
+                const container = { ...(cfg[containerKey] ?? {}) };
+                delete container[branchName];
+                cfg[containerKey] = container;
+                return { ...s, config: cfg };
+            }, schemaCacheRef.current),
+        });
+    }, [config, setConfig]);
+    const renameBranch = useCallback((stepId, containerKey, oldName, newName) => {
+        if (!newName.trim() || oldName === newName)
+            return;
+        setConfig({
+            ...config,
+            steps: updateStepInTree(config.steps, stepId, (s) => {
+                const cfg = { ...s.config };
+                const container = { ...(cfg[containerKey] ?? {}) };
+                if (!(oldName in container) || newName in container)
+                    return s;
+                // Preserve insertion order: rebuild with new name in same position
+                const rebuilt = {};
+                for (const [k, v] of Object.entries(container)) {
+                    rebuilt[k === oldName ? newName : k] = v;
+                }
+                cfg[containerKey] = rebuilt;
+                return { ...s, config: cfg };
+            }, schemaCacheRef.current),
+        });
+    }, [config, setConfig]);
+    // ─── Trigger ───
+    const setTrigger = useCallback((type, triggerConfig) => {
+        setConfig({
+            ...config,
+            trigger: { type, config: triggerConfig ?? {} },
+        });
+        setIsTriggerConfigured(true);
+    }, [config, setConfig]);
+    const updateTriggerConfig = useCallback((triggerConfig) => {
+        setConfig({
+            ...config,
+            trigger: {
+                ...config.trigger,
+                config: { ...config.trigger.config, ...triggerConfig },
+            },
+        });
+    }, [config, setConfig]);
+    // ─── Settings ───
+    const updateSettings = useCallback((settings) => {
+        setConfig({
+            ...config,
+            settings: { ...config.settings, ...settings },
+        });
+    }, [config, setConfig]);
+    // ─── Selection ───
+    const selectStep = useCallback((stepId) => {
+        setSelectedStepId(stepId);
+        setIsTriggerSelected(false);
+    }, []);
+    const selectTrigger = useCallback(() => {
+        setSelectedStepId(null);
+        setIsTriggerSelected(true);
+    }, []);
+    const clearSelection = useCallback(() => {
+        setSelectedStepId(null);
+        setIsTriggerSelected(false);
+    }, []);
+    // ─── Lifecycle ───
+    const validate = useCallback(async () => {
+        setIsValidating(true);
+        try {
+            const result = await client.workflows.validate(config);
+            setValidation(result);
+            return result;
+        }
+        finally {
+            setIsValidating(false);
+        }
+    }, [client, config]);
+    const loadConfig = useCallback((newConfig) => {
+        resetHistory(newConfig);
+        savedConfigRef.current = newConfig;
+        setSelectedStepId(null);
+        setIsTriggerSelected(false);
+        setValidation(null);
+    }, [resetHistory]);
+    const resetFn = useCallback(() => {
+        loadConfig(initialConfig ?? defaultConfig());
+    }, [loadConfig, initialConfig]);
+    const getStep = useCallback((stepId) => findStepInTree(config.steps, stepId, schemaCacheRef.current), [config.steps]);
+    return {
+        config,
+        selectedStepId,
+        isTriggerSelected,
+        isTriggerConfigured,
+        isDirty,
+        validation,
+        isValidating,
+        addStep,
+        removeStep,
+        updateStepConfig,
+        renameStep,
+        duplicateStep,
+        toggleStepDisabled,
+        addBranch,
+        removeBranch,
+        renameBranch,
+        setTrigger,
+        updateTriggerConfig,
+        updateSettings,
+        selectStep,
+        selectTrigger,
+        clearSelection,
+        undo,
+        redo,
+        canUndo,
+        canRedo,
+        validate,
+        loadConfig,
+        reset: resetFn,
+        getStep,
+    };
+}
+//# sourceMappingURL=use-workflow-builder.js.map