@foresthubai/workflow-builder 0.3.0

package/dist/hooks/useFunctionDiagnosticsSync.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Keeps the `byFunctionId` diagnostics slot in sync with the function declarations —
+ * the single source for the sidebar tab badge, the function list ring, AND the config
+ * panel's per-output rings (they all read this slot). Mounted once at the
+ * workflow-builder root so it survives tab open/close.
+ *
+ * Scope-aware: each function is validated against its own body canvas's variables, so
+ * invalid/typed return expressions surface here too — not just missing ones. (Reacts
+ * to declaration/expression edits via `functions`; a body-only edit that changes the
+ * available variables without touching a declaration refreshes on the next
+ * declaration change or a full `validate`.)
+ */
+export declare function useFunctionDiagnosticsSync(): void;
+//# sourceMappingURL=useFunctionDiagnosticsSync.d.ts.map

package/dist/hooks/useFunctionDiagnosticsSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFunctionDiagnosticsSync.d.ts","sourceRoot":"","sources":["../../src/hooks/useFunctionDiagnosticsSync.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;GAWG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAoBjD"}

package/dist/hooks/useFunctionDiagnosticsSync.js

@@ -0,0 +1,38 @@
+import { useEffect } from "react";
+import { validateFunction } from "@foresthubai/workflow-core/diagnostics";
+import { computeAvailableVariables } from "@foresthubai/workflow-core/variable";
+import { useEditorStore } from "../stores/editorStore";
+import { useDiagnosticsStore } from "../stores/diagnosticsStore";
+import { getCanvasStore } from "../stores/canvasStore";
+/**
+ * Keeps the `byFunctionId` diagnostics slot in sync with the function declarations —
+ * the single source for the sidebar tab badge, the function list ring, AND the config
+ * panel's per-output rings (they all read this slot). Mounted once at the
+ * workflow-builder root so it survives tab open/close.
+ *
+ * Scope-aware: each function is validated against its own body canvas's variables, so
+ * invalid/typed return expressions surface here too — not just missing ones. (Reacts
+ * to declaration/expression edits via `functions`; a body-only edit that changes the
+ * available variables without touching a declaration refreshes on the next
+ * declaration change or a full `validate`.)
+ */
+export function useFunctionDiagnosticsSync() {
+    const functions = useEditorStore((s) => s.functions);
+    useEffect(() => {
+        const ds = useDiagnosticsStore.getState();
+        const seen = new Set();
+        for (const [id, def] of Object.entries(functions)) {
+            seen.add(id);
+            const store = getCanvasStore(id);
+            const lookup = store
+                ? computeAvailableVariables(store.getState().variables, store.getState().edges).lookup
+                : undefined;
+            ds.setFunctionDiagnostics(id, validateFunction(def, lookup));
+        }
+        for (const id of Object.keys(ds.byFunctionId)) {
+            if (!seen.has(id))
+                ds.clearFunctionDiagnostics(id);
+        }
+    }, [functions]);
+}
+//# sourceMappingURL=useFunctionDiagnosticsSync.js.map

package/dist/hooks/useFunctionDiagnosticsSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFunctionDiagnosticsSync.js","sourceRoot":"","sources":["../../src/hooks/useFunctionDiagnosticsSync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,0BAA0B;IACxC,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAErD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,GAAG,mBAAmB,CAAC,QAAQ,EAAE,CAAC;QAE1C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACb,MAAM,KAAK,GAAG,cAAc,CAAC,EAAE,CAAC,CAAC;YACjC,MAAM,MAAM,GAAG,KAAK;gBAClB,CAAC,CAAC,yBAAyB,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM;gBACtF,CAAC,CAAC,SAAS,CAAC;YACd,EAAE,CAAC,sBAAsB,CAAC,EAAE,EAAE,gBAAgB,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/D,CAAC;QAED,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,EAAE,CAAC,wBAAwB,CAAC,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/hooks/useFunctionRegistry.d.ts

@@ -0,0 +1,15 @@
+import type { FunctionDeclaration } from "@foresthubai/workflow-core/function";
+/**
+ * Access to all function declarations by id. Reactive over editorStore.functions.
+ * - functions: Record of FunctionDeclaration by id
+ * - functionsList: array of FunctionDeclaration
+ * - getFunction(id): one declaration by id
+ */
+export declare function useFunctionRegistry(): {
+    functions: Record<string, FunctionDeclaration>;
+    functionsList: FunctionDeclaration[];
+    getFunction: (id: string) => FunctionDeclaration | undefined;
+};
+/** All function declarations without React subscription (for non-component code). */
+export declare function getAllFunctions(): Record<string, FunctionDeclaration>;
+//# sourceMappingURL=useFunctionRegistry.d.ts.map

package/dist/hooks/useFunctionRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFunctionRegistry.d.ts","sourceRoot":"","sources":["../../src/hooks/useFunctionRegistry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAM/E;;;;;GAKG;AACH,wBAAgB,mBAAmB;;;sBAGI,MAAM,KAAG,mBAAmB,GAAG,SAAS;EAG9E;AAED,qFAAqF;AACrF,wBAAgB,eAAe,IAAI,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAErE"}

package/dist/hooks/useFunctionRegistry.js

@@ -0,0 +1,22 @@
+import { useCallback, useMemo } from "react";
+import { useEditorStore } from "../stores/editorStore";
+// Functions are a project-scoped resource: the registry IS editorStore.functions —
+// the domain FunctionDeclaration, no conversion. (Crossing to the flat api FunctionInfo
+// is done only when stamping a call-site snapshot; see useNodeDefinitions/migration.)
+/**
+ * Access to all function declarations by id. Reactive over editorStore.functions.
+ * - functions: Record of FunctionDeclaration by id
+ * - functionsList: array of FunctionDeclaration
+ * - getFunction(id): one declaration by id
+ */
+export function useFunctionRegistry() {
+    const functions = useEditorStore((s) => s.functions);
+    const functionsList = useMemo(() => Object.values(functions), [functions]);
+    const getFunction = useCallback((id) => functions[id], [functions]);
+    return { functions, functionsList, getFunction };
+}
+/** All function declarations without React subscription (for non-component code). */
+export function getAllFunctions() {
+    return useEditorStore.getState().functions;
+}
+//# sourceMappingURL=useFunctionRegistry.js.map

package/dist/hooks/useFunctionRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFunctionRegistry.js","sourceRoot":"","sources":["../../src/hooks/useFunctionRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,mFAAmF;AACnF,wFAAwF;AACxF,sFAAsF;AAEtF;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,SAAS,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACrD,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAC3E,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,EAAU,EAAmC,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAE7G,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC;AACnD,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,eAAe;IAC7B,OAAO,cAAc,CAAC,QAAQ,EAAE,CAAC,SAAS,CAAC;AAC7C,CAAC"}

package/dist/hooks/useFunctions.d.ts

@@ -0,0 +1,15 @@
+export interface UseFunctionsOptions {
+    /** Open (or focus) a tab for a function canvas. */
+    onOpenTab: (id: string, label: string) => void;
+}
+/**
+ * Coordinates the canvas-tab UI with function declarations (editorStore). The
+ * declarations themselves are CRUD'd in utils/functionOperations; this hook only
+ * handles the open/create flows that must also touch the tab strip and selection.
+ */
+export declare const useFunctions: ({ onOpenTab }: UseFunctionsOptions) => {
+    functions: import("@foresthubai/workflow-core/function").FunctionDeclaration[];
+    openFunction: (functionId: string) => void;
+    createFunction: () => string;
+};
+//# sourceMappingURL=useFunctions.d.ts.map

package/dist/hooks/useFunctions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFunctions.d.ts","sourceRoot":"","sources":["../../src/hooks/useFunctions.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,mBAAmB;IAClC,mDAAmD;IACnD,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD;AAED;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,eAAe,mBAAmB;;+BAQ9C,MAAM;;CAmBtB,CAAC"}

package/dist/hooks/useFunctions.js

@@ -0,0 +1,34 @@
+import { useCallback } from "react";
+import { useEditorStore } from "../stores/editorStore";
+import { getOrCreateCanvasStore } from "../stores/canvasStore";
+import { useFunctionRegistry } from "./useFunctionRegistry";
+import { addFunction } from "../utils/functionOperations";
+/**
+ * Coordinates the canvas-tab UI with function declarations (editorStore). The
+ * declarations themselves are CRUD'd in utils/functionOperations; this hook only
+ * handles the open/create flows that must also touch the tab strip and selection.
+ */
+export const useFunctions = ({ onOpenTab }) => {
+    const { functionsList: functions, getFunction } = useFunctionRegistry();
+    const selectFunction = useEditorStore((s) => s.selectFunction);
+    // Open an existing function: ensure its body canvas exists, open its tab, and
+    // select it so the right panel shows its definition. onOpenTab switches the active
+    // canvas first; selectFunction sets the selection last so it isn't cleared.
+    const openFunction = useCallback((functionId) => {
+        const fn = getFunction(functionId);
+        if (!fn)
+            return;
+        getOrCreateCanvasStore(functionId);
+        onOpenTab(functionId, fn.name);
+        selectFunction(functionId);
+    }, [getFunction, onOpenTab, selectFunction]);
+    // Create a new function and open it (the canvas body is created by addFunction).
+    const createFunction = useCallback(() => {
+        const fn = addFunction();
+        onOpenTab(fn.id, fn.name);
+        selectFunction(fn.id);
+        return fn.id;
+    }, [onOpenTab, selectFunction]);
+    return { functions, openFunction, createFunction };
+};
+//# sourceMappingURL=useFunctions.js.map

package/dist/hooks/useFunctions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFunctions.js","sourceRoot":"","sources":["../../src/hooks/useFunctions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAO1D;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAAE,SAAS,EAAuB,EAAE,EAAE;IACjE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,GAAG,mBAAmB,EAAE,CAAC;IACxE,MAAM,cAAc,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;IAE/D,8EAA8E;IAC9E,mFAAmF;IACnF,4EAA4E;IAC5E,MAAM,YAAY,GAAG,WAAW,CAC9B,CAAC,UAAkB,EAAE,EAAE;QACrB,MAAM,EAAE,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;QACnC,IAAI,CAAC,EAAE;YAAE,OAAO;QAChB,sBAAsB,CAAC,UAAU,CAAC,CAAC;QACnC,SAAS,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QAC/B,cAAc,CAAC,UAAU,CAAC,CAAC;IAC7B,CAAC,EACD,CAAC,WAAW,EAAE,SAAS,EAAE,cAAc,CAAC,CACzC,CAAC;IAEF,iFAAiF;IACjF,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,EAAE;QACtC,MAAM,EAAE,GAAG,WAAW,EAAE,CAAC;QACzB,SAAS,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;QAC1B,cAAc,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACtB,OAAO,EAAE,CAAC,EAAE,CAAC;IACf,CAAC,EAAE,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC;IAEhC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,CAAC;AACrD,CAAC,CAAC"}

package/dist/hooks/useGraph.d.ts

@@ -0,0 +1,40 @@
+import { NodeDefinition, NodeData } from "@foresthubai/workflow-core/node";
+import { Connection, Edge, Node } from "@xyflow/react";
+import type { EdgeData } from "@foresthubai/workflow-core/edge";
+import type { EdgeType } from "@foresthubai/workflow-core/edge";
+/**
+ * Hook that provides graph management actions for a specific canvas.
+ *
+ * All mutations are:
+ * - Gated by readOnly (no-op when true)
+ * - Automatically wrapped in a history checkpoint (undo/redo)
+ *
+ * Callers don't need to worry about either concern.
+ */
+export declare const useGraph: (canvasId?: string, readOnly?: boolean) => {
+    nodes: Node<NodeData>[];
+    edges: Edge<EdgeData>[];
+    addNode: (nodeDef: NodeDefinition, position?: {
+        x: number;
+        y: number;
+    }) => string | null;
+    updateNode: (nodeId: string, updates: {
+        arguments?: Record<string, unknown>;
+        label?: string;
+    }) => void;
+    updateEdge: (edgeId: string, updates: Record<string, unknown>) => void;
+    deleteNode: (nodeId: string) => void;
+    deleteEdges: (edgeIds: string[]) => void;
+    deleteSelected: (nodeIds: string[], edgeIds: string[]) => void;
+    onConnect: (connection: Connection) => EdgeType | false;
+    addNodeAndConnect: (nodeDef: NodeDefinition, position: {
+        x: number;
+        y: number;
+    }, connection: Connection) => string | null;
+    copySelection: (nodeIds: string[]) => void;
+    pasteSelection: (offset?: {
+        x: number;
+        y: number;
+    }) => import("../utils/graphOperations").PasteResult | undefined;
+};
+//# sourceMappingURL=useGraph.d.ts.map

package/dist/hooks/useGraph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGraph.d.ts","sourceRoot":"","sources":["../../src/hooks/useGraph.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAahE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAOhE;;;;;;;;GAQG;AACH,eAAO,MAAM,QAAQ,GAAI,WAAU,MAAuB,EAAE,WAAU,OAAe;;;uBAkBvE,cAAc,aAAa;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;yBAOpD,MAAM,WAAW;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;yBAqBxE,MAAM,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;yBAdxC,MAAM;2BAqBL,MAAM,EAAE;8BAQR,MAAM,EAAE,WAAW,MAAM,EAAE;4BAtBxB,UAAU,KAAG,QAAQ,GAAG,KAAK;iCA+DhC,cAAc,YAAY;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,cAAc,UAAU,KAAG,MAAM,GAAG,IAAI;6BA7B1F,MAAM,EAAE;8BAmBR;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;CAqCrC,CAAC"}

package/dist/hooks/useGraph.js

@@ -0,0 +1,102 @@
+import { useCallback } from "react";
+import { getOrCreateCanvasStore, MAIN_CANVAS_ID } from "../stores/canvasStore";
+import { addNodeToStore, connectNodesInStore, deleteEdgesFromStore, deleteNodeFromStore, pasteToStore, updateEdgeInStore, updateNodeInStore, } from "../utils/graphOperations";
+import { useNodeDefinitions } from "./useNodeDefinitions";
+// Shared across all useGraph instances (one per canvas) so copy/paste works
+// across canvas switches within a single builder session.
+const clipboardRef = { current: null };
+/**
+ * Hook that provides graph management actions for a specific canvas.
+ *
+ * All mutations are:
+ * - Gated by readOnly (no-op when true)
+ * - Automatically wrapped in a history checkpoint (undo/redo)
+ *
+ * Callers don't need to worry about either concern.
+ */
+export const useGraph = (canvasId = MAIN_CANVAS_ID, readOnly = false) => {
+    const canvasStore = getOrCreateCanvasStore(canvasId);
+    const nodes = canvasStore((s) => s.nodes);
+    const edges = canvasStore((s) => s.edges);
+    const { withCheckpoint } = canvasStore;
+    const { getNodeDefinition } = useNodeDefinitions();
+    // Guarded checkpoint: skips when readOnly, otherwise wraps in undo history entry
+    const guarded = useCallback((operation) => {
+        if (readOnly)
+            return undefined;
+        return withCheckpoint(operation);
+    }, [readOnly, withCheckpoint]);
+    const addNode = useCallback((nodeDef, position) => {
+        return guarded(() => addNodeToStore(canvasStore, nodeDef, position)) ?? null;
+    }, [canvasStore, guarded]);
+    const updateNode = useCallback((nodeId, updates) => {
+        guarded(() => updateNodeInStore(canvasStore, nodeId, updates));
+    }, [canvasStore, guarded]);
+    const deleteNode = useCallback((nodeId) => {
+        guarded(() => deleteNodeFromStore(canvasStore, nodeId, getNodeDefinition));
+    }, [canvasStore, getNodeDefinition, guarded]);
+    const onConnect = useCallback((connection) => {
+        return guarded(() => connectNodesInStore(canvasStore, connection)) ?? false;
+    }, [canvasStore, guarded]);
+    const updateEdge = useCallback((edgeId, updates) => {
+        guarded(() => updateEdgeInStore(canvasStore, edgeId, updates));
+    }, [canvasStore, guarded]);
+    const deleteEdges = useCallback((edgeIds) => {
+        guarded(() => deleteEdgesFromStore(canvasStore, edgeIds));
+    }, [canvasStore, guarded]);
+    // Batch delete nodes and edges as a single undo entry
+    const deleteSelected = useCallback((nodeIds, edgeIds) => {
+        if (nodeIds.length === 0 && edgeIds.length === 0)
+            return;
+        guarded(() => {
+            for (const nodeId of nodeIds)
+                deleteNodeFromStore(canvasStore, nodeId, getNodeDefinition);
+            if (edgeIds.length > 0)
+                deleteEdgesFromStore(canvasStore, edgeIds);
+        });
+    }, [canvasStore, getNodeDefinition, guarded]);
+    // Copy is read-only — no checkpoint, no readOnly gate
+    const copySelection = useCallback((nodeIds) => {
+        if (nodeIds.length === 0)
+            return;
+        const nodeIdSet = new Set(nodeIds);
+        const copiedNodes = nodes
+            .filter((node) => nodeIdSet.has(node.id))
+            .map((node) => JSON.parse(JSON.stringify(node)));
+        const copiedEdges = edges
+            .filter((edge) => nodeIdSet.has(edge.source) && nodeIdSet.has(edge.target))
+            .map((edge) => JSON.parse(JSON.stringify(edge)));
+        clipboardRef.current = { nodes: copiedNodes, edges: copiedEdges };
+    }, [nodes, edges]);
+    const pasteSelection = useCallback((offset) => {
+        const clipboard = clipboardRef.current;
+        if (!clipboard)
+            return undefined;
+        return guarded(() => pasteToStore(canvasStore, clipboard, offset, getNodeDefinition));
+    }, [canvasStore, getNodeDefinition, guarded]);
+    // Batch add node + connect as a single undo entry (used by contextual node picker)
+    const addNodeAndConnect = useCallback((nodeDef, position, connection) => {
+        return (guarded(() => {
+            const nodeId = addNodeToStore(canvasStore, nodeDef, position);
+            if (nodeId == null)
+                return null;
+            connectNodesInStore(canvasStore, { ...connection, target: nodeId });
+            return nodeId;
+        }) ?? null);
+    }, [canvasStore, guarded]);
+    return {
+        nodes,
+        edges,
+        addNode,
+        updateNode,
+        updateEdge,
+        deleteNode,
+        deleteEdges,
+        deleteSelected,
+        onConnect,
+        addNodeAndConnect,
+        copySelection,
+        pasteSelection,
+    };
+};
+//# sourceMappingURL=useGraph.js.map

package/dist/hooks/useGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useGraph.js","sourceRoot":"","sources":["../../src/hooks/useGraph.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,EACL,cAAc,EAEd,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,4EAA4E;AAC5E,0DAA0D;AAC1D,MAAM,YAAY,GAAkC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAEtE;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,WAAmB,cAAc,EAAE,WAAoB,KAAK,EAAE,EAAE;IACvF,MAAM,WAAW,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,EAAE,cAAc,EAAE,GAAG,WAAW,CAAC;IAEvC,MAAM,EAAE,iBAAiB,EAAE,GAAG,kBAAkB,EAAE,CAAC;IAEnD,iFAAiF;IACjF,MAAM,OAAO,GAAG,WAAW,CACzB,CAAI,SAAkB,EAAiB,EAAE;QACvC,IAAI,QAAQ;YAAE,OAAO,SAAS,CAAC;QAC/B,OAAO,cAAc,CAAC,SAAS,CAAC,CAAC;IACnC,CAAC,EACD,CAAC,QAAQ,EAAE,cAAc,CAAC,CAC3B,CAAC;IAEF,MAAM,OAAO,GAAG,WAAW,CACzB,CAAC,OAAuB,EAAE,QAAmC,EAAE,EAAE;QAC/D,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC;IAC/E,CAAC,EACD,CAAC,WAAW,EAAE,OAAO,CAAC,CACvB,CAAC;IAEF,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,MAAc,EAAE,OAAgE,EAAE,EAAE;QACnF,OAAO,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjE,CAAC,EACD,CAAC,WAAW,EAAE,OAAO,CAAC,CACvB,CAAC;IAEF,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,MAAc,EAAE,EAAE;QACjB,OAAO,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IAC7E,CAAC,EACD,CAAC,WAAW,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAC1C,CAAC;IAEF,MAAM,SAAS,GAAG,WAAW,CAC3B,CAAC,UAAsB,EAAoB,EAAE;QAC3C,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,mBAAmB,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,IAAI,KAAK,CAAC;IAC9E,CAAC,EACD,CAAC,WAAW,EAAE,OAAO,CAAC,CACvB,CAAC;IAEF,MAAM,UAAU,GAAG,WAAW,CAC5B,CAAC,MAAc,EAAE,OAAgC,EAAE,EAAE;QACnD,OAAO,CAAC,GAAG,EAAE,CAAC,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACjE,CAAC,EACD,CAAC,WAAW,EAAE,OAAO,CAAC,CACvB,CAAC;IAEF,MAAM,WAAW,GAAG,WAAW,CAC7B,CAAC,OAAiB,EAAE,EAAE;QACpB,OAAO,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC,EACD,CAAC,WAAW,EAAE,OAAO,CAAC,CACvB,CAAC;IAEF,sDAAsD;IACtD,MAAM,cAAc,GAAG,WAAW,CAChC,CAAC,OAAiB,EAAE,OAAiB,EAAE,EAAE;QACvC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACzD,OAAO,CAAC,GAAG,EAAE;YACX,KAAK,MAAM,MAAM,IAAI,OAAO;gBAAE,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC;YAC1F,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;gBAAE,oBAAoB,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;IACL,CAAC,EACD,CAAC,WAAW,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAC1C,CAAC;IAEF,sDAAsD;IACtD,MAAM,aAAa,GAAG,WAAW,CAC/B,CAAC,OAAiB,EAAE,EAAE;QACpB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEjC,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QAEnC,MAAM,WAAW,GAAG,KAAK;aACtB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;aACxC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAmB,CAAC,CAAC;QAErE,MAAM,WAAW,GAAG,KAAK;aACtB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;aAC1E,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAmB,CAAC,CAAC;QAErE,YAAY,CAAC,OAAO,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;IACpE,CAAC,EACD,CAAC,KAAK,EAAE,KAAK,CAAC,CACf,CAAC;IAEF,MAAM,cAAc,GAAG,WAAW,CAChC,CAAC,MAAiC,EAAE,EAAE;QACpC,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC;QACvC,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QACjC,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC,CAAC;IACxF,CAAC,EACD,CAAC,WAAW,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAC1C,CAAC;IAEF,mFAAmF;IACnF,MAAM,iBAAiB,GAAG,WAAW,CACnC,CAAC,OAAuB,EAAE,QAAkC,EAAE,UAAsB,EAAiB,EAAE;QACrG,OAAO,CACL,OAAO,CAAC,GAAG,EAAE;YACX,MAAM,MAAM,GAAG,cAAc,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC9D,IAAI,MAAM,IAAI,IAAI;gBAAE,OAAO,IAAI,CAAC;YAChC,mBAAmB,CAAC,WAAW,EAAE,EAAE,GAAG,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;YACpE,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,IAAI,IAAI,CACX,CAAC;IACJ,CAAC,EACD,CAAC,WAAW,EAAE,OAAO,CAAC,CACvB,CAAC;IAEF,OAAO;QACL,KAAK;QACL,KAAK;QACL,OAAO;QACP,UAAU;QACV,UAAU;QACV,UAAU;QACV,WAAW;QACX,cAAc;QACd,SAAS;QACT,iBAAiB;QACjB,aAAa;QACb,cAAc;KACf,CAAC;AACJ,CAAC,CAAC"}

package/dist/hooks/useNodeDefinitions.d.ts

@@ -0,0 +1,17 @@
+import { NodeCategory, NodeDefinition, NodeData } from "@foresthubai/workflow-core/node";
+import { type FunctionInfo } from "@foresthubai/workflow-core/function";
+import { FunctionNodeDefinition } from "@foresthubai/workflow-core/node";
+/**
+ * Workflow-builder binding for {@link coreBuildFunctionNodeDef} — passes
+ * `i18n.t` so descriptions are translated. Consumers continue to call
+ * `buildFunctionNodeDef(fn)` unchanged; core's signature is the pure
+ * `(fn, t?)` form.
+ */
+export declare function buildFunctionNodeDef(fn: FunctionInfo): FunctionNodeDefinition;
+export declare const useNodeDefinitions: () => {
+    nodeDefinitions: NodeDefinition[];
+    getAllCategories: () => NodeCategory[];
+    getNodeDefinition: (node: NodeData) => NodeDefinition | undefined;
+    getNodeDefinitionsByCategory: (category: NodeCategory) => NodeDefinition[];
+};
+//# sourceMappingURL=useNodeDefinitions.d.ts.map

package/dist/hooks/useNodeDefinitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNodeDefinitions.d.ts","sourceRoot":"","sources":["../../src/hooks/useNodeDefinitions.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAgB,cAAc,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAEvG,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxF,OAAO,EAAoB,sBAAsB,EAAoD,MAAM,iCAAiC,CAAC;AAE7I;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,YAAY,GAAG,sBAAsB,CAE7E;AAGD,eAAO,MAAM,kBAAkB;;4BAqCY,YAAY,EAAE;8BArB9C,QAAQ,KAAG,cAAc,GAAG,SAAS;6CAWjC,YAAY;CAmC1B,CAAC"}

package/dist/hooks/useNodeDefinitions.js

@@ -0,0 +1,65 @@
+import { useMemo, useCallback } from "react";
+import i18n from "../i18n";
+import { NodeCategory, NodeRegistry } from "@foresthubai/workflow-core/node";
+import { useFunctionRegistry } from "./useFunctionRegistry";
+import { toFunctionInfo } from "@foresthubai/workflow-core/function";
+import { buildFunctionNodeDef as coreBuildFunctionNodeDef } from "@foresthubai/workflow-core/node";
+/**
+ * Workflow-builder binding for {@link coreBuildFunctionNodeDef} — passes
+ * `i18n.t` so descriptions are translated. Consumers continue to call
+ * `buildFunctionNodeDef(fn)` unchanged; core's signature is the pure
+ * `(fn, t?)` form.
+ */
+export function buildFunctionNodeDef(fn) {
+    return coreBuildFunctionNodeDef(fn, i18n.t.bind(i18n));
+}
+// Use function registry to provide dynamic node definitions based on available functions
+export const useNodeDefinitions = () => {
+    // Get static node definitions from registry (these never change)
+    const staticNodeDefs = NodeRegistry.getAll();
+    // Subscribe to function registry (derived from all canvas stores)
+    const { functions } = useFunctionRegistry();
+    // Dynamically create node definitions for each function. The call-site node def is
+    // built from the flat signature snapshot, so project the domain declaration here.
+    const functionNodeDefs = useMemo(() => Object.values(functions).map((fn) => buildFunctionNodeDef(toFunctionInfo(fn))), [functions]);
+    // Get node definition for a node instance (still depending on all functions)
+    const getNodeDefinition = useCallback((node) => {
+        if (node.type === "FunctionCall") {
+            const fnNode = node;
+            return functionNodeDefs.find((def) => def.type === "FunctionCall" && def.functionInfo.id === fnNode.functionInfo.id);
+        }
+        return NodeRegistry.getByType(node.type);
+    }, [functionNodeDefs]);
+    const getNodeDefinitionsByCategory = useCallback((category) => {
+        const staticNodes = NodeRegistry.getByCategory(category);
+        if (category === NodeCategory.Function) {
+            return [...staticNodes, ...functionNodeDefs];
+        }
+        return staticNodes;
+    }, [functionNodeDefs]);
+    const getAllCategories = useCallback(() => {
+        const staticCategories = NodeRegistry.getAllCategories();
+        const allCategories = new Set([...staticCategories]);
+        if (functionNodeDefs.length > 0) {
+            allCategories.add(NodeCategory.Function);
+        }
+        const categoryOrder = [
+            NodeCategory.Trigger,
+            NodeCategory.Input,
+            NodeCategory.Logic,
+            NodeCategory.Data,
+            NodeCategory.Function,
+            NodeCategory.AI,
+            NodeCategory.Tool,
+            NodeCategory.Output,
+        ];
+        return categoryOrder.filter((cat) => allCategories.has(cat));
+    }, [functionNodeDefs]);
+    return {
+        nodeDefinitions: [...staticNodeDefs, ...functionNodeDefs],
+        getAllCategories,
+        getNodeDefinition,
+        getNodeDefinitionsByCategory,
+    };
+};
+//# sourceMappingURL=useNodeDefinitions.js.map

package/dist/hooks/useNodeDefinitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNodeDefinitions.js","sourceRoot":"","sources":["../../src/hooks/useNodeDefinitions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAC7C,OAAO,IAAI,MAAM,SAAS,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,YAAY,EAA4B,MAAM,iCAAiC,CAAC;AACvG,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAqB,MAAM,qCAAqC,CAAC;AACxF,OAAO,EAA4C,oBAAoB,IAAI,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAE7I;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,EAAgB;IACnD,OAAO,wBAAwB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,EAAE;IACrC,iEAAiE;IACjE,MAAM,cAAc,GAAqB,YAAY,CAAC,MAAM,EAAE,CAAC;IAE/D,kEAAkE;IAClE,MAAM,EAAE,SAAS,EAAE,GAAG,mBAAmB,EAAE,CAAC;IAE5C,mFAAmF;IACnF,kFAAkF;IAClF,MAAM,gBAAgB,GAA6B,OAAO,CACxD,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,oBAAoB,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,EACpF,CAAC,SAAS,CAAC,CACZ,CAAC;IAEF,6EAA6E;IAC7E,MAAM,iBAAiB,GAAG,WAAW,CACnC,CAAC,IAAc,EAA8B,EAAE;QAC7C,IAAI,IAAI,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;YACjC,MAAM,MAAM,GAAG,IAAwB,CAAC;YACxC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,cAAc,IAAI,GAAG,CAAC,YAAY,CAAC,EAAE,KAAK,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;QACvH,CAAC;QACD,OAAO,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC,EACD,CAAC,gBAAgB,CAAC,CACnB,CAAC;IAEF,MAAM,4BAA4B,GAAG,WAAW,CAC9C,CAAC,QAAsB,EAAE,EAAE;QACzB,MAAM,WAAW,GAAG,YAAY,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACzD,IAAI,QAAQ,KAAK,YAAY,CAAC,QAAQ,EAAE,CAAC;YACvC,OAAO,CAAC,GAAG,WAAW,EAAE,GAAG,gBAAgB,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,WAAW,CAAC;IACrB,CAAC,EACD,CAAC,gBAAgB,CAAC,CACnB,CAAC;IAEF,MAAM,gBAAgB,GAAG,WAAW,CAAC,GAAmB,EAAE;QACxD,MAAM,gBAAgB,GAAG,YAAY,CAAC,gBAAgB,EAAE,CAAC;QACzD,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC;QACrD,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,aAAa,CAAC,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC3C,CAAC;QACD,MAAM,aAAa,GAAG;YACpB,YAAY,CAAC,OAAO;YACpB,YAAY,CAAC,KAAK;YAClB,YAAY,CAAC,KAAK;YAClB,YAAY,CAAC,IAAI;YACjB,YAAY,CAAC,QAAQ;YACrB,YAAY,CAAC,EAAE;YACf,YAAY,CAAC,IAAI;YACjB,YAAY,CAAC,MAAM;SACpB,CAAC;QACF,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC;IAEvB,OAAO;QACL,eAAe,EAAE,CAAC,GAAG,cAAc,EAAE,GAAG,gBAAgB,CAAC;QACzD,gBAAgB;QAChB,iBAAiB;QACjB,4BAA4B;KAC7B,CAAC;AACJ,CAAC,CAAC"}

package/dist/hooks/useParamErrors.d.ts

@@ -0,0 +1,12 @@
+import type { Diagnostic } from "@foresthubai/workflow-core/diagnostics";
+/**
+ * Build a per-parameter error map (`paramId → messages`) from a resource's
+ * diagnostics, keeping only `error`-severity entries. Shared by every config
+ * panel that renders a parameter list (node / edge / channel / memory / model)
+ * so the inline Map-building loop lives in exactly one place.
+ *
+ * Memoized on `diags`, so callers can read it from the diagnostics store with a
+ * plain selector and pass the result straight through to `<ParameterEditor>`.
+ */
+export declare function useParamErrors(diags: Diagnostic[] | undefined): Map<string, string[]>;
+//# sourceMappingURL=useParamErrors.d.ts.map

package/dist/hooks/useParamErrors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useParamErrors.d.ts","sourceRoot":"","sources":["../../src/hooks/useParamErrors.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAEzE;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAarF"}

package/dist/hooks/useParamErrors.js

@@ -0,0 +1,28 @@
+import { useMemo } from "react";
+/**
+ * Build a per-parameter error map (`paramId → messages`) from a resource's
+ * diagnostics, keeping only `error`-severity entries. Shared by every config
+ * panel that renders a parameter list (node / edge / channel / memory / model)
+ * so the inline Map-building loop lives in exactly one place.
+ *
+ * Memoized on `diags`, so callers can read it from the diagnostics store with a
+ * plain selector and pass the result straight through to `<ParameterEditor>`.
+ */
+export function useParamErrors(diags) {
+    return useMemo(() => {
+        const map = new Map();
+        if (!diags)
+            return map;
+        for (const d of diags) {
+            if (d.paramId && d.severity === "error") {
+                const arr = map.get(d.paramId);
+                if (arr)
+                    arr.push(d.message);
+                else
+                    map.set(d.paramId, [d.message]);
+            }
+        }
+        return map;
+    }, [diags]);
+}
+//# sourceMappingURL=useParamErrors.js.map

package/dist/hooks/useParamErrors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useParamErrors.js","sourceRoot":"","sources":["../../src/hooks/useParamErrors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAGhC;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,KAA+B;IAC5D,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAoB,CAAC;QACxC,IAAI,CAAC,KAAK;YAAE,OAAO,GAAG,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACxC,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;gBAC/B,IAAI,GAAG;oBAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;;oBACxB,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;YACvC,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;AACd,CAAC"}

package/dist/hooks/useResolvedTheme.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Returns "light" if `<html>` has the `light` class, else "dark". Subscribes to
+ * MutationObserver so toggles by the embedder propagate immediately.
+ *
+ * Dark is the default — the builder's CSS puts dark tokens on `:root` and
+ * overrides them under `.light`. This hook exists so things that need an
+ * explicit value — notably ReactFlow's `colorMode` prop — stay in sync.
+ */
+export declare function useResolvedTheme(): "dark" | "light";
+//# sourceMappingURL=useResolvedTheme.d.ts.map

package/dist/hooks/useResolvedTheme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResolvedTheme.d.ts","sourceRoot":"","sources":["../../src/hooks/useResolvedTheme.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG,OAAO,CAcnD"}

package/dist/hooks/useResolvedTheme.js

@@ -0,0 +1,29 @@
+import { useEffect, useState } from "react";
+/**
+ * Returns "light" if `<html>` has the `light` class, else "dark". Subscribes to
+ * MutationObserver so toggles by the embedder propagate immediately.
+ *
+ * Dark is the default — the builder's CSS puts dark tokens on `:root` and
+ * overrides them under `.light`. This hook exists so things that need an
+ * explicit value — notably ReactFlow's `colorMode` prop — stay in sync.
+ */
+export function useResolvedTheme() {
+    const [theme, setTheme] = useState(() => detect());
+    useEffect(() => {
+        if (typeof document === "undefined")
+            return;
+        const root = document.documentElement;
+        const observer = new MutationObserver(() => setTheme(detect()));
+        observer.observe(root, { attributes: true, attributeFilter: ["class"] });
+        // Initial sync in case it changed between mount and effect.
+        setTheme(detect());
+        return () => observer.disconnect();
+    }, []);
+    return theme;
+}
+function detect() {
+    if (typeof document === "undefined")
+        return "dark";
+    return document.documentElement.classList.contains("light") ? "light" : "dark";
+}
+//# sourceMappingURL=useResolvedTheme.js.map

package/dist/hooks/useResolvedTheme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResolvedTheme.js","sourceRoot":"","sources":["../../src/hooks/useResolvedTheme.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAmB,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;IAErE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,QAAQ,KAAK,WAAW;YAAE,OAAO;QAC5C,MAAM,IAAI,GAAG,QAAQ,CAAC,eAAe,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QAChE,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACzE,4DAA4D;QAC5D,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACnB,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,MAAM;IACb,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO,MAAM,CAAC;IACnD,OAAO,QAAQ,CAAC,eAAe,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;AACjF,CAAC"}

package/dist/hooks/useResourceDiagnosticsSync.d.ts

@@ -0,0 +1,40 @@
+import { useEditorStore } from "../stores/editorStore";
+import { useDiagnosticsStore } from "../stores/diagnosticsStore";
+import type { Diagnostic } from "@foresthubai/workflow-core/diagnostics";
+type EditorState = ReturnType<typeof useEditorStore.getState>;
+type DiagnosticsState = ReturnType<typeof useDiagnosticsStore.getState>;
+interface ResourceDiagnosticsSyncConfig<I extends {
+    id: string;
+}> {
+    /** Pick the resource map (e.g. `s.channels`) off the editor store. */
+    selectItems: (s: EditorState) => Record<string, I>;
+    /** Validate one instance into its diagnostics. */
+    validate: (item: I) => Diagnostic[];
+    /** Read the matching diagnostics slot (e.g. `d.byChannelId`). */
+    getStored: (d: DiagnosticsState) => Record<string, Diagnostic[]>;
+    /** Write one instance's diagnostics. */
+    set: (d: DiagnosticsState, id: string, diags: Diagnostic[]) => void;
+    /** Drop one instance's diagnostics. */
+    clear: (d: DiagnosticsState, id: string) => void;
+}
+/**
+ * Keeps a project-scoped diagnostics slot (`byChannelId` / `byMemoryId` /
+ * `byModelId`) in sync with the editor's resource map.
+ *
+ * These resources are project-scoped, not canvas-scoped, and are only rendered
+ * visually when their sidebar tab is open. Tying diagnostic writes to card
+ * lifecycles would mean errors vanish the moment that tab closes, so this hook
+ * is mounted once at the workflow-builder root and reactively rewrites the store
+ * whenever the resource map changes.
+ *
+ * Lifecycle handled implicitly by the effect:
+ *  - Load   → setItems fires → effect re-runs → diagnostics written
+ *  - Edit   → store mutates  → effect re-runs → entry replaced
+ *  - Delete → item leaves    → orphan branch  → entry cleared
+ *  - Unmount → store goes down with the app (no cleanup needed)
+ */
+export declare function useResourceDiagnosticsSync<I extends {
+    id: string;
+}>(config: ResourceDiagnosticsSyncConfig<I>): void;
+export {};
+//# sourceMappingURL=useResourceDiagnosticsSync.d.ts.map

package/dist/hooks/useResourceDiagnosticsSync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResourceDiagnosticsSync.d.ts","sourceRoot":"","sources":["../../src/hooks/useResourceDiagnosticsSync.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wCAAwC,CAAC;AAEzE,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,QAAQ,CAAC,CAAC;AAC9D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AAExE,UAAU,6BAA6B,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE;IAC9D,sEAAsE;IACtE,WAAW,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACnD,kDAAkD;IAClD,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,UAAU,EAAE,CAAC;IACpC,iEAAiE;IACjE,SAAS,EAAE,CAAC,CAAC,EAAE,gBAAgB,KAAK,MAAM,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACjE,wCAAwC;IACxC,GAAG,EAAE,CAAC,CAAC,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,IAAI,CAAC;IACpE,uCAAuC;IACvC,KAAK,EAAE,CAAC,CAAC,EAAE,gBAAgB,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,0BAA0B,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,6BAA6B,CAAC,CAAC,CAAC,GAAG,IAAI,CAoBnH"}

package/dist/hooks/useResourceDiagnosticsSync.js

@@ -0,0 +1,39 @@
+import { useEffect } from "react";
+import { useEditorStore } from "../stores/editorStore";
+import { useDiagnosticsStore } from "../stores/diagnosticsStore";
+/**
+ * Keeps a project-scoped diagnostics slot (`byChannelId` / `byMemoryId` /
+ * `byModelId`) in sync with the editor's resource map.
+ *
+ * These resources are project-scoped, not canvas-scoped, and are only rendered
+ * visually when their sidebar tab is open. Tying diagnostic writes to card
+ * lifecycles would mean errors vanish the moment that tab closes, so this hook
+ * is mounted once at the workflow-builder root and reactively rewrites the store
+ * whenever the resource map changes.
+ *
+ * Lifecycle handled implicitly by the effect:
+ *  - Load   → setItems fires → effect re-runs → diagnostics written
+ *  - Edit   → store mutates  → effect re-runs → entry replaced
+ *  - Delete → item leaves    → orphan branch  → entry cleared
+ *  - Unmount → store goes down with the app (no cleanup needed)
+ */
+export function useResourceDiagnosticsSync(config) {
+    const items = useEditorStore(config.selectItems);
+    useEffect(() => {
+        const ds = useDiagnosticsStore.getState();
+        const seen = new Set();
+        for (const item of Object.values(items)) {
+            seen.add(item.id);
+            config.set(ds, item.id, config.validate(item));
+        }
+        // Drop entries for items that have been deleted.
+        for (const id of Object.keys(config.getStored(ds))) {
+            if (!seen.has(id))
+                config.clear(ds, id);
+        }
+        // `config` is recreated each render but only `items` drives a resync; the
+        // effect reads the latest closure on every run.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [items]);
+}
+//# sourceMappingURL=useResourceDiagnosticsSync.js.map

package/dist/hooks/useResourceDiagnosticsSync.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResourceDiagnosticsSync.js","sourceRoot":"","sources":["../../src/hooks/useResourceDiagnosticsSync.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAmBjE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,0BAA0B,CAA2B,MAAwC;IAC3G,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAEjD,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,EAAE,GAAG,mBAAmB,CAAC,QAAQ,EAAE,CAAC;QAE1C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YACxC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAClB,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACjD,CAAC;QAED,iDAAiD;QACjD,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YACnD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC1C,CAAC;QACD,0EAA0E;QAC1E,gDAAgD;QAChD,uDAAuD;IACzD,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;AACd,CAAC"}