@xyne/workflow-ui 0.1.0

package/dist/hooks/use-schema-form.d.ts

@@ -0,0 +1,47 @@
+export interface SchemaFormField {
+    path: string;
+    label: string;
+    type: 'string' | 'number' | 'integer' | 'boolean' | 'array' | 'object';
+    required: boolean;
+    acceptsVariableRef: boolean;
+    enumValues?: string[];
+    defaultValue?: unknown;
+    description?: string;
+    placeholder?: string;
+    format?: string;
+    children?: SchemaFormField[];
+    itemSchema?: Record<string, unknown>;
+    /** Present when type=object has additionalProperties — indicates a Record/Map type */
+    additionalPropertiesSchema?: Record<string, unknown>;
+    /** Present for discriminated unions (anyOf/oneOf with const discriminator) */
+    discriminator?: {
+        field: string;
+        /** Map of discriminator value → fields for that variant */
+        variants: Record<string, SchemaFormField[]>;
+    };
+}
+/**
+ * Convert a JSON Schema (typically from field.itemSchema) into SchemaFormField[].
+ * Used by renderers to build structured editors for array items.
+ */
+export declare function itemSchemaToFields(schema: Record<string, unknown>, basePath?: string): SchemaFormField[];
+/**
+ * Detect a discriminated union from a JSON Schema (anyOf/oneOf with const discriminator).
+ * Returns null if the schema is not a discriminated union.
+ */
+export declare function detectItemDiscriminatedUnion(schema: Record<string, unknown>, basePath?: string): SchemaFormField['discriminator'] | null;
+export interface UseSchemaFormOptions {
+    schema: Record<string, unknown>;
+    initialValues?: Record<string, unknown>;
+    onChange?: (values: Record<string, unknown>) => void;
+}
+export interface UseSchemaFormReturn {
+    fields: SchemaFormField[];
+    values: Record<string, unknown>;
+    errors: Record<string, string>;
+    setFieldValue: (path: string, value: unknown) => void;
+    validate: () => boolean;
+    reset: (values?: Record<string, unknown>) => void;
+}
+export declare function useSchemaForm(opts: UseSchemaFormOptions): UseSchemaFormReturn;
+//# sourceMappingURL=use-schema-form.d.ts.map

package/dist/hooks/use-schema-form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-schema-form.d.ts","sourceRoot":"","sources":["../../src/hooks/use-schema-form.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,CAAC;IACvE,QAAQ,EAAE,OAAO,CAAC;IAClB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,eAAe,EAAE,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,sFAAsF;IACtF,0BAA0B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrD,8EAA8E;IAC9E,aAAa,CAAC,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,2DAA2D;QAC3D,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;KAC7C,CAAC;CACH;AA0LD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,SAAK,GAAG,eAAe,EAAE,CAGpG;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,SAAK,GACZ,eAAe,CAAC,eAAe,CAAC,GAAG,IAAI,CAEzC;AAiCD,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACtD;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACtD,QAAQ,EAAE,MAAM,OAAO,CAAC;IACxB,KAAK,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CACnD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,mBAAmB,CAoD7E"}

package/dist/hooks/use-schema-form.js

@@ -0,0 +1,247 @@
+import { useCallback, useMemo, useState } from 'react';
+// ─── JSON Schema → field list ───
+function schemaToFields(schema, parentPath, requiredKeys) {
+    const properties = schema['properties'];
+    if (properties) {
+        const fields = [];
+        for (const [key, prop] of Object.entries(properties)) {
+            const path = parentPath ? `${parentPath}.${key}` : key;
+            const field = propToField(prop, path, key, requiredKeys.has(key));
+            if (field)
+                fields.push(field);
+        }
+        return fields;
+    }
+    // Root-level discriminated union (e.g. Wait step: z.discriminatedUnion('mode', [...]))
+    const disc = detectDiscriminatedUnion(schema, parentPath);
+    if (disc) {
+        return [{
+                path: parentPath,
+                label: formatLabel(disc.field),
+                type: 'object',
+                required: true,
+                acceptsVariableRef: false,
+                discriminator: disc,
+            }];
+    }
+    return [];
+}
+function propToField(prop, path, key, required) {
+    // Detect variableRef: union with string that has __variableRef__ description
+    const acceptsVariableRef = detectVariableRef(prop);
+    const resolved = acceptsVariableRef ? unwrapVariableRef(prop) : prop;
+    // Detect discriminated union (anyOf with const discriminator) before resolving type
+    const discUnion = detectDiscriminatedUnion(resolved, path);
+    const type = discUnion ? 'object' : resolveType(resolved);
+    if (!type)
+        return null;
+    const field = {
+        path,
+        label: resolved['title'] ?? formatLabel(key),
+        type,
+        required,
+        acceptsVariableRef,
+    };
+    const description = resolved['description'];
+    if (description)
+        field.description = description;
+    if (resolved['default'] !== undefined)
+        field.defaultValue = resolved['default'];
+    const format = resolved['format'];
+    if (format)
+        field.format = format;
+    if (resolved['enum']) {
+        field.enumValues = resolved['enum'];
+    }
+    if (discUnion) {
+        // Discriminated union — variant fields are in the discriminator, not children
+        field.discriminator = discUnion;
+    }
+    else if (type === 'object') {
+        // Regular object — check for additionalProperties (Record/Map type)
+        const addlProps = resolved['additionalProperties'];
+        if (addlProps && typeof addlProps === 'object' && !Array.isArray(addlProps)) {
+            field.additionalPropertiesSchema = addlProps;
+        }
+        const reqSet = new Set(resolved['required'] ?? []);
+        field.children = schemaToFields(resolved, path, reqSet);
+    }
+    if (type === 'array' && resolved['items']) {
+        field.itemSchema = resolved['items'];
+    }
+    return field;
+}
+const VALID_TYPES = new Set(['string', 'number', 'integer', 'boolean', 'array', 'object']);
+function resolveType(prop) {
+    const t = prop['type'];
+    if (t && VALID_TYPES.has(t))
+        return t;
+    // For anyOf/oneOf without top-level type (non-discriminated unions like `body`):
+    // prefer 'string' if any variant is string (renders as textarea), else first variant type
+    const variants = (prop['anyOf'] ?? prop['oneOf']);
+    if (variants && variants.length > 0) {
+        if (variants.some((v) => v['type'] === 'string'))
+            return 'string';
+        const first = variants[0]['type'];
+        if (first && VALID_TYPES.has(first))
+            return first;
+        return 'string';
+    }
+    return null;
+}
+function detectVariableRef(prop) {
+    // anyOf/oneOf with a string member that has __variableRef__ description
+    const variants = (prop['anyOf'] ?? prop['oneOf']);
+    if (!variants)
+        return false;
+    return variants.some((v) => typeof v['description'] === 'string' && v['description'].startsWith('__variableRef__'));
+}
+function unwrapVariableRef(prop) {
+    const variants = (prop['anyOf'] ?? prop['oneOf']);
+    if (!variants)
+        return prop;
+    // Return the non-variableRef variant (the actual schema)
+    const real = variants.find((v) => !(typeof v['description'] === 'string' && v['description'].startsWith('__variableRef__')));
+    return real ?? prop;
+}
+/**
+ * Detect discriminated union: anyOf/oneOf where all variants are objects and
+ * share a common property with `const` values (the discriminator field).
+ */
+function detectDiscriminatedUnion(prop, path) {
+    const variants = (prop['anyOf'] ?? prop['oneOf']);
+    if (!variants || variants.length < 2)
+        return null;
+    // All variants must be objects
+    if (!variants.every((v) => v['type'] === 'object'))
+        return null;
+    // Find a common property that has a `const` value in every variant
+    const firstProps = (variants[0]['properties'] ?? {});
+    let discField = null;
+    for (const [fieldName, fieldSchema] of Object.entries(firstProps)) {
+        if (fieldSchema['const'] === undefined)
+            continue;
+        const allHaveConst = variants.every((v) => {
+            const vProps = (v['properties'] ?? {});
+            return vProps[fieldName]?.['const'] !== undefined;
+        });
+        if (allHaveConst) {
+            discField = fieldName;
+            break;
+        }
+    }
+    if (!discField)
+        return null;
+    // Build variant map: constValue → fields (excluding discriminator field itself)
+    const variantMap = {};
+    for (const variant of variants) {
+        const vProps = (variant['properties'] ?? {});
+        const constVal = String(vProps[discField]['const']);
+        const vRequired = new Set(variant['required'] ?? []);
+        const fields = [];
+        for (const [vKey, vProp] of Object.entries(vProps)) {
+            if (vKey === discField)
+                continue;
+            const vPath = path ? `${path}.${vKey}` : vKey;
+            const f = propToField(vProp, vPath, vKey, vRequired.has(vKey));
+            if (f)
+                fields.push(f);
+        }
+        variantMap[constVal] = fields;
+    }
+    return { field: discField, variants: variantMap };
+}
+function formatLabel(key) {
+    return key
+        .replace(/([a-z])([A-Z])/g, '$1 $2')
+        .replace(/[_-]/g, ' ')
+        .replace(/^\w/, (c) => c.toUpperCase());
+}
+// ─── Public helpers ───
+/**
+ * Convert a JSON Schema (typically from field.itemSchema) into SchemaFormField[].
+ * Used by renderers to build structured editors for array items.
+ */
+export function itemSchemaToFields(schema, basePath = '') {
+    const reqSet = new Set(schema['required'] ?? []);
+    return schemaToFields(schema, basePath, reqSet);
+}
+/**
+ * Detect a discriminated union from a JSON Schema (anyOf/oneOf with const discriminator).
+ * Returns null if the schema is not a discriminated union.
+ */
+export function detectItemDiscriminatedUnion(schema, basePath = '') {
+    return detectDiscriminatedUnion(schema, basePath);
+}
+// ─── Value access helpers ───
+function getNestedValue(obj, path) {
+    if (path === '')
+        return obj;
+    const parts = path.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined || typeof current !== 'object')
+            return undefined;
+        current = current[part];
+    }
+    return current;
+}
+function setNestedValue(obj, path, value) {
+    if (path === '')
+        return value ?? {};
+    const parts = path.split('.');
+    const result = { ...obj };
+    let target = result;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const part = parts[i];
+        const next = target[part];
+        const clone = (next !== null && typeof next === 'object') ? { ...next } : {};
+        target[part] = clone;
+        target = clone;
+    }
+    target[parts[parts.length - 1]] = value;
+    return result;
+}
+export function useSchemaForm(opts) {
+    const { schema, initialValues, onChange } = opts;
+    const [values, setValues] = useState(initialValues ?? {});
+    const [errors, setErrors] = useState({});
+    const fields = useMemo(() => {
+        const requiredKeys = new Set(schema['required'] ?? []);
+        return schemaToFields(schema, '', requiredKeys);
+    }, [schema]);
+    const setFieldValue = useCallback((path, value) => {
+        setValues((prev) => {
+            const next = setNestedValue(prev, path, value);
+            onChange?.(next);
+            return next;
+        });
+        // Clear error on edit
+        setErrors((prev) => {
+            if (!(path in prev))
+                return prev;
+            const next = { ...prev };
+            delete next[path];
+            return next;
+        });
+    }, [onChange]);
+    const validate = useCallback(() => {
+        const newErrors = {};
+        for (const field of fields) {
+            if (field.required) {
+                const val = getNestedValue(values, field.path);
+                if (val === undefined || val === null || val === '') {
+                    newErrors[field.path] = `${field.label} is required`;
+                }
+            }
+        }
+        setErrors(newErrors);
+        return Object.keys(newErrors).length === 0;
+    }, [fields, values]);
+    const reset = useCallback((newValues) => {
+        setValues(newValues ?? initialValues ?? {});
+        setErrors({});
+    }, [initialValues]);
+    return { fields, values, errors, setFieldValue, validate, reset };
+}
+//# sourceMappingURL=use-schema-form.js.map

package/dist/hooks/use-schema-form.js.map

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

package/dist/hooks/use-step-config.d.ts

@@ -0,0 +1,13 @@
+import type { StepDescriptor } from '@xyne/workflow-sdk';
+import { type UseSchemaFormReturn } from './use-schema-form.js';
+export interface UseStepConfigOptions {
+    stepType: string;
+    initialValues: Record<string, unknown>;
+    onValuesChange: (values: Record<string, unknown>) => void;
+}
+export interface UseStepConfigReturn extends UseSchemaFormReturn {
+    descriptor: StepDescriptor | undefined;
+    isLoading: boolean;
+}
+export declare function useStepConfig(opts: UseStepConfigOptions): UseStepConfigReturn;
+//# sourceMappingURL=use-step-config.d.ts.map

package/dist/hooks/use-step-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-step-config.d.ts","sourceRoot":"","sources":["../../src/hooks/use-step-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAC3D;AAED,MAAM,WAAW,mBAAoB,SAAQ,mBAAmB;IAC9D,UAAU,EAAE,cAAc,GAAG,SAAS,CAAC;IACvC,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,mBAAmB,CAsC7E"}

package/dist/hooks/use-step-config.js

@@ -0,0 +1,40 @@
+import { useEffect, useState } from 'react';
+import { useWorkflowClient } from './use-workflow-client.js';
+import { useSchemaForm } from './use-schema-form.js';
+export function useStepConfig(opts) {
+    const { stepType, initialValues, onValuesChange } = opts;
+    const client = useWorkflowClient();
+    const [descriptor, setDescriptor] = useState(undefined);
+    const [isLoading, setIsLoading] = useState(true);
+    useEffect(() => {
+        let cancelled = false;
+        setIsLoading(true);
+        void (async () => {
+            try {
+                const desc = await client.schema.step(stepType);
+                if (!cancelled)
+                    setDescriptor(desc);
+            }
+            catch {
+                // Step type might not exist — descriptor stays undefined
+            }
+            finally {
+                if (!cancelled)
+                    setIsLoading(false);
+            }
+        })();
+        return () => { cancelled = true; };
+    }, [client, stepType]);
+    const schema = descriptor?.['configSchema'];
+    const form = useSchemaForm({
+        schema: schema ?? { type: 'object', properties: {} },
+        initialValues,
+        onChange: onValuesChange,
+    });
+    return {
+        ...form,
+        descriptor,
+        isLoading,
+    };
+}
+//# sourceMappingURL=use-step-config.js.map

package/dist/hooks/use-step-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-step-config.js","sourceRoot":"","sources":["../../src/hooks/use-step-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAA4B,MAAM,sBAAsB,CAAC;AAa/E,MAAM,UAAU,aAAa,CAAC,IAA0B;IACtD,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IACzD,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IAEnC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAA6B,SAAS,CAAC,CAAC;IACpF,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEjD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,YAAY,CAAC,IAAI,CAAC,CAAC;QAEnB,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAChD,IAAI,CAAC,SAAS;oBAAE,aAAa,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC;YAAC,MAAM,CAAC;gBACP,yDAAyD;YAC3D,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,SAAS;oBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YACtC,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,GAAG,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEvB,MAAM,MAAM,GAAI,UAAkD,EAAE,CAAC,cAAc,CAAwC,CAAC;IAE5H,MAAM,IAAI,GAAG,aAAa,CAAC;QACzB,MAAM,EAAE,MAAM,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QACpD,aAAa;QACb,QAAQ,EAAE,cAAc;KACzB,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,IAAI;QACP,UAAU;QACV,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/hooks/use-step-metadata.d.ts

@@ -0,0 +1,37 @@
+import type { WorkflowConfig } from '@xyne/workflow-sdk/builder';
+import type { BranchModel } from '@xyne/workflow-sdk';
+export interface StepMeta {
+    name: string;
+    category: string;
+    kind: string;
+    icon?: string | undefined;
+    /** Control-flow steps only: drives canvas rendering (loop ring vs multi-lane fork). */
+    branchModel?: BranchModel | undefined;
+    /** JSON Schema from StepDescriptor.configSchema — used for branch detection + form rendering. */
+    configSchema?: Record<string, unknown> | undefined;
+    /** JSON Schema from StepDescriptor.outputSchema — used for schema-aware output rendering. */
+    outputSchema?: Record<string, unknown> | undefined;
+}
+export interface TriggerMeta {
+    type: string;
+    name: string;
+    description: string;
+    category: string;
+    icon?: string | undefined;
+}
+export interface UseStepMetadataReturn {
+    /** Map of step type → metadata (name, category, icon, configSchema). */
+    stepMeta: Map<string, StepMeta>;
+    /** All available trigger summaries from backend. */
+    triggerMeta: TriggerMeta[];
+    /** True while initial metadata is loading. */
+    isLoading: boolean;
+}
+/**
+ * Fetches and caches StepDescriptor metadata for every step type in the config.
+ * Also fetches TriggerSummary[] once for trigger metadata.
+ *
+ * Returns a map of step type → { name, category, icon, configSchema }.
+ */
+export declare function useStepMetadata(config: WorkflowConfig): UseStepMetadataReturn;
+//# sourceMappingURL=use-step-metadata.d.ts.map

package/dist/hooks/use-step-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-step-metadata.d.ts","sourceRoot":"","sources":["../../src/hooks/use-step-metadata.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAA+B,MAAM,oBAAoB,CAAC;AAMnF,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,uFAAuF;IACvF,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACtC,iGAAiG;IACjG,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IACnD,6FAA6F;IAC7F,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CACpD;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAChC,oDAAoD;IACpD,WAAW,EAAE,WAAW,EAAE,CAAC;IAC3B,8CAA8C;IAC9C,SAAS,EAAE,OAAO,CAAC;CACpB;AAID;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,GAAG,qBAAqB,CA8G7E"}

package/dist/hooks/use-step-metadata.js

@@ -0,0 +1,113 @@
+import { useEffect, useRef, useState } from 'react';
+import { useWorkflowClient } from './use-workflow-client.js';
+import { walkStepConfigs } from '../utils/branch-detection.js';
+// ─── Hook ───
+/**
+ * Fetches and caches StepDescriptor metadata for every step type in the config.
+ * Also fetches TriggerSummary[] once for trigger metadata.
+ *
+ * Returns a map of step type → { name, category, icon, configSchema }.
+ */
+export function useStepMetadata(config) {
+    const client = useWorkflowClient();
+    const [stepMeta, setStepMeta] = useState(new Map());
+    const [triggerMeta, setTriggerMeta] = useState([]);
+    const [isLoading, setIsLoading] = useState(true);
+    // Track which types we've already fetched to avoid refetching
+    const fetchedTypesRef = useRef(new Set());
+    const triggersFetchedRef = useRef(false);
+    // Fetch trigger summaries once
+    useEffect(() => {
+        if (triggersFetchedRef.current)
+            return;
+        triggersFetchedRef.current = true;
+        void (async () => {
+            try {
+                const triggers = await client.schema.triggers();
+                setTriggerMeta(triggers.map((t) => ({
+                    type: t.type,
+                    name: t.name,
+                    description: t.description,
+                    category: t.category,
+                    icon: t.icon,
+                })));
+            }
+            catch {
+                // Trigger schema unavailable
+            }
+        })();
+    }, [client]);
+    // Fetch step metadata for all types in config (including nested branches)
+    useEffect(() => {
+        const types = new Set();
+        // Schema-free walk — discovers steps no matter how they're nested
+        // (LOOP body, PARALLEL branches, CONDITIONAL slots, SWITCH cases[i].steps).
+        walkStepConfigs(config.steps, (s) => { types.add(s.type); });
+        // Find types not yet fetched
+        const newTypes = [];
+        for (const type of types) {
+            if (!fetchedTypesRef.current.has(type)) {
+                newTypes.push(type);
+                fetchedTypesRef.current.add(type);
+            }
+        }
+        if (newTypes.length === 0) {
+            setIsLoading(false);
+            return;
+        }
+        void (async () => {
+            const results = await Promise.allSettled(newTypes.map(async (type) => {
+                const desc = await client.schema.step(type);
+                return { type, desc };
+            }));
+            setStepMeta((prev) => {
+                const next = new Map(prev);
+                for (const result of results) {
+                    if (result.status === 'fulfilled') {
+                        const { type, desc } = result.value;
+                        next.set(type, {
+                            name: desc.name,
+                            category: desc.category,
+                            kind: desc.kind,
+                            icon: desc.icon,
+                            branchModel: desc.branchModel,
+                            configSchema: desc.configSchema,
+                            outputSchema: desc.outputSchema,
+                        });
+                    }
+                }
+                return next;
+            });
+            setIsLoading(false);
+        })();
+    }, [config.steps, client]);
+    // Also fetch metadata for step summaries (to get metadata for types not yet in config)
+    useEffect(() => {
+        void (async () => {
+            try {
+                const summaries = await client.schema.steps();
+                setStepMeta((prev) => {
+                    const next = new Map(prev);
+                    for (const s of summaries) {
+                        if (!next.has(s.type)) {
+                            next.set(s.type, {
+                                name: s.name,
+                                category: s.category,
+                                kind: s.kind,
+                                icon: s.icon,
+                                branchModel: s.branchModel,
+                                // configSchema filled when step is actually used and descriptor fetched
+                            });
+                        }
+                    }
+                    return next;
+                });
+            }
+            catch {
+                // Schema unavailable
+            }
+        })();
+    }, [client]);
+    return { stepMeta, triggerMeta, isLoading };
+}
+//# sourceMappingURL=use-step-metadata.js.map

package/dist/hooks/use-step-metadata.js.map

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

package/dist/hooks/use-trigger-config.d.ts

@@ -0,0 +1,13 @@
+import type { TriggerDescriptor } from '@xyne/workflow-sdk';
+import { type UseSchemaFormReturn } from './use-schema-form.js';
+export interface UseTriggerConfigOptions {
+    triggerType: string;
+    initialValues: Record<string, unknown>;
+    onValuesChange: (values: Record<string, unknown>) => void;
+}
+export interface UseTriggerConfigReturn extends UseSchemaFormReturn {
+    descriptor: TriggerDescriptor | undefined;
+    isLoading: boolean;
+}
+export declare function useTriggerConfig(opts: UseTriggerConfigOptions): UseTriggerConfigReturn;
+//# sourceMappingURL=use-trigger-config.d.ts.map

package/dist/hooks/use-trigger-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-trigger-config.d.ts","sourceRoot":"","sources":["../../src/hooks/use-trigger-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,EAAiB,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE/E,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;CAC3D;AAED,MAAM,WAAW,sBAAuB,SAAQ,mBAAmB;IACjE,UAAU,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC1C,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,uBAAuB,GAAG,sBAAsB,CAsCtF"}

package/dist/hooks/use-trigger-config.js

@@ -0,0 +1,40 @@
+import { useEffect, useState } from 'react';
+import { useWorkflowClient } from './use-workflow-client.js';
+import { useSchemaForm } from './use-schema-form.js';
+export function useTriggerConfig(opts) {
+    const { triggerType, initialValues, onValuesChange } = opts;
+    const client = useWorkflowClient();
+    const [descriptor, setDescriptor] = useState(undefined);
+    const [isLoading, setIsLoading] = useState(true);
+    useEffect(() => {
+        let cancelled = false;
+        setIsLoading(true);
+        void (async () => {
+            try {
+                const desc = await client.schema.trigger(triggerType);
+                if (!cancelled)
+                    setDescriptor(desc);
+            }
+            catch {
+                // Trigger type might not exist
+            }
+            finally {
+                if (!cancelled)
+                    setIsLoading(false);
+            }
+        })();
+        return () => { cancelled = true; };
+    }, [client, triggerType]);
+    const schema = descriptor?.['configSchema'];
+    const form = useSchemaForm({
+        schema: schema ?? { type: 'object', properties: {} },
+        initialValues,
+        onChange: onValuesChange,
+    });
+    return {
+        ...form,
+        descriptor,
+        isLoading,
+    };
+}
+//# sourceMappingURL=use-trigger-config.js.map

package/dist/hooks/use-trigger-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-trigger-config.js","sourceRoot":"","sources":["../../src/hooks/use-trigger-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAA4B,MAAM,sBAAsB,CAAC;AAa/E,MAAM,UAAU,gBAAgB,CAAC,IAA6B;IAC5D,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAC5D,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IAEnC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAgC,SAAS,CAAC,CAAC;IACvF,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEjD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,YAAY,CAAC,IAAI,CAAC,CAAC;QAEnB,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;gBACtD,IAAI,CAAC,SAAS;oBAAE,aAAa,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC;YAAC,MAAM,CAAC;gBACP,+BAA+B;YACjC,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC,SAAS;oBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YACtC,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,GAAG,EAAE,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAE1B,MAAM,MAAM,GAAI,UAAkD,EAAE,CAAC,cAAc,CAAwC,CAAC;IAE5H,MAAM,IAAI,GAAG,aAAa,CAAC;QACzB,MAAM,EAAE,MAAM,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE;QACpD,aAAa;QACb,QAAQ,EAAE,cAAc;KACzB,CAAC,CAAC;IAEH,OAAO;QACL,GAAG,IAAI;QACP,UAAU;QACV,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/hooks/use-undo-redo.d.ts

@@ -0,0 +1,17 @@
+export interface UseUndoRedoReturn<T> {
+    state: T;
+    setState: (next: T | ((prev: T) => T)) => void;
+    undo: () => void;
+    redo: () => void;
+    canUndo: boolean;
+    canRedo: boolean;
+    reset: (initial: T) => void;
+}
+/**
+ * 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 declare function useUndoRedo<T>(initialState: T, maxHistory?: number): UseUndoRedoReturn<T>;
+//# sourceMappingURL=use-undo-redo.d.ts.map

package/dist/hooks/use-undo-redo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-undo-redo.d.ts","sourceRoot":"","sources":["../../src/hooks/use-undo-redo.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,KAAK,EAAE,CAAC,CAAC;IACT,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,IAAI,CAAC;IAC/C,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,UAAU,SAAK,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAoDrF"}