@mindlogic-ai/logician-ui 3.1.0 → 3.2.0-alpha.1

package/dist/components/Workflow/Workflow.types.d.ts

@@ -0,0 +1,435 @@
+import type { ComponentType, ReactNode } from 'react';
+import { type CreatedIcon } from '@/components/Icon';
+import type { CategoryTokenMap } from './canvas/IconTile';
+/**
+ * Generic, domain-free types for the Workflow editor framework.
+ *
+ * Host apps register NodeTypeDef entries and pass them via props. The framework
+ * itself knows nothing about "agent" or "classify" — host registries (under
+ * adapters/) provide that.
+ */
+export type Position = {
+    x: number;
+    y: number;
+};
+/** Which side a canvas surface (inspector drawer, etc.) docks on. */
+export type DockSide = 'left' | 'right';
+/**
+ * Translator the editor uses for all of its chrome copy (palette, controls,
+ * inspector, issue messages). Injected by the host so the core stays domain-
+ * and i18n-framework-agnostic: the host passes a function bound to its own
+ * locale + translation catalog (which also resolves the node-type
+ * `descriptionKey`s the host registers). When omitted, the component falls back
+ * to its bundled defaults.
+ *
+ * Mirrors the common `(key, vars) => text` shape; returns `ReactNode` because
+ * some translators interpolate React elements. Call sites that need a string
+ * (aria labels, placeholders) cast the result.
+ */
+export type WorkflowTranslate = (key: string, vars?: Record<string, string | number>) => ReactNode;
+export type HandleDef = {
+    id: string;
+    label?: string;
+};
+export type GraphNode<TConfig = unknown> = {
+    id: string;
+    kind: string;
+    position: Position;
+    config: TConfig;
+};
+export type GraphEdge = {
+    id: string;
+    source: string;
+    target: string;
+    sourceHandle?: string;
+    targetHandle?: string;
+    label?: string;
+};
+export type Graph = {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+};
+export type IssueSeverity = 'error' | 'warning';
+export type Issue = {
+    nodeId?: string;
+    edgeId?: string;
+    handleId?: string;
+    /**
+     * Identifies the specific input the issue belongs to (e.g. `'name'`,
+     * `'model'`). Lets the drawer render the issue inline beneath the matching
+     * field instead of as a separate list. Optional — graph-wide and
+     * node-without-a-field issues leave it undefined.
+     */
+    fieldKey?: string;
+    severity: IssueSeverity;
+    code: string;
+    /**
+     * English fallback message. Used by tests, logs, and any surface that
+     * doesn't run the `useWorkflowIssueMessage` hook (which maps `code` +
+     * `messageVars` to a localized string).
+     */
+    message: string;
+    /**
+     * Interpolation values consumed by `useWorkflowIssueMessage`. Mirror the
+     * `{var}` placeholders in the matching translation key.
+     */
+    messageVars?: Record<string, string | number>;
+};
+export type RunState = 'idle' | 'running' | 'done' | 'error';
+export type MetaChipTone = 'default' | 'danger' | 'warning';
+export type MetaChipSpec = string | {
+    readonly text: string;
+    readonly tone?: MetaChipTone;
+};
+export type NodeRenderProps<TConfig = unknown> = {
+    id: string;
+    config: TConfig;
+    selected: boolean;
+    runState: RunState;
+    issues: Issue[];
+};
+export type DrawerRenderProps<TConfig = unknown> = {
+    id: string;
+    config: TConfig;
+    onChange: (next: TConfig) => void;
+    issues: Issue[];
+    /**
+     * Editor is read-only (published view / no edit permission) — inspectors
+     * should disable mutating controls.
+     */
+    readOnly: boolean;
+    /**
+     * Opaque host bridge from the editor (see `WorkflowProps.hostBridge`).
+     * FactChat node-types narrow it (e.g. to `WorkflowHostBridge`) to reach
+     * chatbot-scoped data; the core stays decoupled.
+     */
+    hostBridge?: unknown;
+};
+/**
+ * Props passed to a host-supplied edge inspector (`WorkflowProps.renderEdgeDrawer`).
+ *
+ * Mirrors `DrawerRenderProps` for nodes so the framework core stays domain-free:
+ * the host owns edge-specific UI (e.g. future edge conditions / CEL) while the
+ * core only knows how to mount it. When no host renderer is provided the editor
+ * falls back to a built-in inspector (editable label + read-only endpoints).
+ */
+export type EdgeDrawerRenderProps = {
+    edge: GraphEdge;
+    /** Persist an edited edge — dispatches `updateEdge` so changes are undoable. */
+    onChange: (next: GraphEdge) => void;
+    /** Editor is read-only — disable mutating controls. */
+    readOnly: boolean;
+    /** Issues whose `edgeId` matches this edge. */
+    issues: Issue[];
+    /** Opaque host bridge (see `WorkflowProps.hostBridge`). */
+    hostBridge?: unknown;
+};
+export type ConnectionCtx = {
+    source: GraphNode;
+    sourceHandle?: string;
+    target: GraphNode;
+    targetHandle?: string;
+    graph: Graph;
+};
+/**
+ * Minimal JSON Schema 7-ish subset. Kept local to avoid pulling a 200kB schema
+ * lib for a half-dozen field types. Host adapters can produce anything
+ * compatible with the strict subset OpenAI / Gemini / Pydantic agree on.
+ */
+export type JSONSchema = {
+    type: 'string';
+    description?: string;
+    enum?: string[];
+    nullable?: boolean;
+} | {
+    type: 'number' | 'integer';
+    description?: string;
+    minimum?: number;
+    maximum?: number;
+    nullable?: boolean;
+} | {
+    type: 'boolean';
+    description?: string;
+    nullable?: boolean;
+} | {
+    type: 'array';
+    items: JSONSchema;
+    description?: string;
+    nullable?: boolean;
+} | {
+    type: 'object';
+    properties: Record<string, JSONSchema>;
+    required?: string[];
+    additionalProperties?: boolean;
+    description?: string;
+    nullable?: boolean;
+};
+/**
+ * Optional declarative placement constraints. Validation itself is owned by
+ * the backend now; these stay on the node-type contract because the palette
+ * and canvas read them (e.g. `pinned` wires React Flow's `deletable`).
+ *
+ * - `role: 'start' | 'end'` marks entry/terminal kinds.
+ * - `mustFollowDirectly` is OR semantics: a node passes if at least one of
+ *   its direct parents matches the whitelist.
+ */
+export type PlacementRule = {
+    minCount?: number;
+    maxCount?: number;
+    mustFollowDirectly?: string[];
+    mustFollow?: string[];
+    /** Cannot be deleted by the user. React Flow's `deletable` is wired to !pinned. */
+    pinned?: boolean;
+    /** Semantic role used by the validator to infer entry/terminal kinds. */
+    role?: 'start' | 'end';
+};
+/**
+ * The six visual categories. Color attaches to category, not to kind — adding
+ * a new kind never grows the palette. Every node type picks exactly one.
+ *
+ * The framework leaves the visual mapping (token names, icon tile colors) to
+ * the host's NodeShell renderer; this enum just defines the slots.
+ */
+export type NodeCategory = 'trigger' | 'ai' | 'logic' | 'safety' | 'output' | 'note';
+/**
+ * Public contract for registering a node kind.
+ *
+ * `defaultConfig` may be a value or a factory. Prefer the factory form for
+ * configs that contain nested mutable objects, dates, or anything that should
+ * be a fresh instance per node.
+ *
+ * Use `defineNodeType<TConfig>(...)` to keep TypeScript happy when collecting
+ * heterogeneous defs into a single registry array.
+ */
+export type NodeTypeDef<TConfig = unknown> = {
+    kind: string;
+    /**
+     * Short, operational noun. Shown as the bold line on the canvas card.
+     * Intentionally not translated — these are technical primitives that
+     * stay English in localized UIs (matches n8n/Make/Dify convention) and
+     * the `node.kind` token (e.g. `start`, `agent`) used in template refs
+     * like `{{start.input}}` mirrors the English label.
+     */
+    label: string;
+    /**
+     * One-line description. Shown under the label in the palette. English
+     * fallback — prefer setting `descriptionKey` so the palette picks up
+     * the localized copy.
+     */
+    description?: string;
+    /** Translation key for `description`. Resolved by NodePalette. */
+    descriptionKey?: string;
+    /**
+     * Icon component for the node — wrap the source icon via the logician-ui
+     * `createIcon` helper (see `src/components/Icon/`) so all icons expose the
+     * same Chakra-shaped API (`boxSize`, `color`, `currentColor` tinting) and
+     * the host can't mix icon families.
+     */
+    icon: CreatedIcon;
+    /**
+     * One of six visual categories. Drives the icon-tile color and (for Note)
+     * the body color. Has no effect on validation or runtime.
+     */
+    category: NodeCategory;
+    defaultConfig: TConfig | (() => TConfig);
+    /**
+     * Optional overlay applied to `defaultConfig()` at node-creation time
+     * with the current `useTranslate` translator in scope. Use for
+     * user-facing string defaults that should land in the locale's
+     * language — e.g. the canvas display name. The framework can't run
+     * hooks inside `defaultConfig`, so localized defaults live here.
+     * Shallow-merges over the static defaults; unset fields fall through.
+     */
+    localizeDefaults?: (translate: (key: string, params?: Record<string, string>) => string) => Partial<TConfig>;
+    /**
+     * Optional overlay applied to `defaultConfig()` at node-creation time with the
+     * opaque host bridge in scope — the host-data analogue of `localizeDefaults`.
+     * Use for defaults that depend on live host data the static `defaultConfig`
+     * can't see, e.g. picking a starting LLM from the tenant's live model list so
+     * a fresh node never persists a hardcoded model that's absent from the picker.
+     * Shallow-merges over the static + localized defaults; omit a key (or return
+     * `{}`) to leave the static default in place. `hostBridge` is opaque — the
+     * node type narrows it (see `getWorkflowHostBridge`).
+     */
+    hostDefaults?: (hostBridge: unknown) => Partial<TConfig>;
+    /**
+     * The snake_case identifier line under the kind label.
+     * Defaults to the node id when omitted.
+     */
+    getInstanceTitle?: (config: TConfig) => string;
+    /**
+     * Optional meta-row chips. Short nouns/phrases ("Sonnet 4.6", "mask · halt").
+     * Return an empty array to omit the meta row.
+     *
+     * Chips can be plain strings, or `{ text, tone }` objects to surface a
+     * danger/warning tint on a specific sub-value (e.g. an unknown model).
+     */
+    getMetaChips?: (config: TConfig) => ReadonlyArray<MetaChipSpec>;
+    /**
+     * Escape hatch for nodes whose body doesn't fit the standard
+     * header + meta-chips shape (e.g. Note). Most node types should leave this
+     * undefined and use `getInstanceTitle` + `getMetaChips` instead.
+     */
+    renderNode?: ComponentType<NodeRenderProps<TConfig>>;
+    /** Optional. If absent, clicking the node is a no-op for editing. */
+    renderDrawer?: ComponentType<DrawerRenderProps<TConfig>>;
+    /** Handles can depend on config (Classify creates N outputs from categories). */
+    handles: (config: TConfig) => {
+        inputs: HandleDef[];
+        outputs: HandleDef[];
+    };
+    /**
+     * Optional FE-computed, graph-aware advisories for this node, merged into the
+     * node's canvas warning/error chrome alongside the backend `issues`. Use for
+     * guidance the backend can't give before a save — an unconnected required
+     * exit, an empty or duplicated fan-out label. Pure and synchronous; it runs
+     * on every node render, so keep it cheap.
+     */
+    getGraphIssues?: (ctx: {
+        node: GraphNode<TConfig>;
+        graph: Graph;
+    }) => Issue[];
+    /** Output shape for variable resolution; undefined = no referenceable output. */
+    outputSchema?: (config: TConfig) => JSONSchema | undefined;
+    placement?: PlacementRule;
+    /**
+     * Reject an attempted connection. Return `true` to allow, `false` or a
+     * reason string to reject. Called for either the source or target side —
+     * the framework runs both and rejects if either says no.
+     */
+    canConnect?: (ctx: ConnectionCtx) => boolean | string;
+};
+export type NodeTypeRegistry = Record<string, NodeTypeDef>;
+/**
+ * A selected canvas element, surfaced to the host via `onSelectionChange`. The
+ * `node`/`edge` snapshot is included for convenience (e.g. to drive a custom
+ * inspector that lives elsewhere in the host's layout); `id`/`type` are the
+ * stable identity.
+ */
+export type WorkflowSelection = {
+    type: 'node';
+    id: string;
+    node: GraphNode;
+} | {
+    type: 'edge';
+    id: string;
+    edge: GraphEdge;
+};
+/**
+ * Public props for the `<Workflow>` component.
+ */
+export type WorkflowProps = {
+    nodeTypes: NodeTypeDef[];
+    /**
+     * Translator for the editor's chrome copy. The host passes a function bound
+     * to its own locale + catalog so the editor localizes with the rest of the
+     * app and can resolve the `descriptionKey`s the host registers on its node
+     * types. When omitted, the component uses its bundled default copy.
+     */
+    translate?: WorkflowTranslate;
+    /** Controlled graph. If provided, `onGraphChange` should also be provided. */
+    graph?: Graph;
+    onGraphChange?: (next: Graph) => void;
+    /**
+     * Fired when the user runs the one-click auto-arrange, with the freshly
+     * laid-out graph. A pure reposition normally rides along on the next real
+     * edit's save (see the host's `differsBeyondPosition`), so a deliberate
+     * arrange would otherwise not persist on its own — hosts wire this to a
+     * forced save so the tidied layout sticks across reloads. Domain-free: the
+     * core just reports "the user arranged the graph"; the host decides what to
+     * do with it.
+     */
+    onArrange?: (graph: Graph) => void;
+    /**
+     * Fired with the resulting graph after the user undoes/redoes. Lets the host
+     * persist a revert that the autosave would otherwise drop: undoing an
+     * auto-arrange is a position-only change, which `differsBeyondPosition`
+     * ignores, so without this a reverted layout wouldn't survive a reload.
+     */
+    onHistoryNavigate?: (graph: Graph) => void;
+    /** Uncontrolled initial graph. Ignored when `graph` is provided. */
+    defaultGraph?: Graph;
+    /**
+     * Validation issues to render — sourced from the backend.
+     *
+     * Pass a stable reference (e.g. via `useMemo`) — a fresh array on every
+     * render will cause `onIssuesChange` to fire every render.
+     */
+    issues?: Issue[];
+    /** Hide palette + disable connect/drag/delete. */
+    readOnly?: boolean;
+    /**
+     * Issues are being recomputed (a save/validation is in flight) — render a
+     * loading affordance instead of treating an empty `issues` list as "no
+     * issues". Lets the host keep the prior issues visible (passed in via
+     * `issues`) while signalling that fresh validation is underway, avoiding a
+     * blank→repopulate flicker. Generic on purpose: the framework stays
+     * domain-free and the host decides what "validating" means.
+     */
+    validating?: boolean;
+    showPalette?: boolean;
+    /**
+     * Fired when the user clicks a node, with the clicked node. A click also
+     * updates the editor's selection (readable via `useWorkflow`/`onSelectionChange`
+     * and rendered by `<NodeInspector>` if mounted), so this is a convenience for
+     * hosts that drive UI *outside* the canvas off a raw click — e.g. opening a
+     * detail panel elsewhere, or flipping back from a test surface into edit mode.
+     */
+    onNodeClick?: (node: GraphNode) => void;
+    /** Fired when the user clicks an edge, with the clicked edge. See `onNodeClick`. */
+    onEdgeClick?: (edge: GraphEdge) => void;
+    /**
+     * Fired whenever the selected element changes — on node/edge click, on
+     * deselect (pane click), and when a selected element is deleted (`null`).
+     *
+     * This is the seam for "clicking a node controls a different part of the UI":
+     * the editor owns selection + canvas interaction, and the host renders its own
+     * inspector anywhere in its layout from this signal. The built-in
+     * `<NodeInspector>` is one such consumer — mount it as a child for the default
+     * floating drawer, omit it to own the inspector entirely.
+     */
+    onSelectionChange?: (selection: WorkflowSelection | null) => void;
+    /**
+     * Overlay children rendered inside the canvas frame (same pattern as React
+     * Flow's `<Controls>`/`<MiniMap>`/`<Panel>`). Mount `<NodeInspector>` here for
+     * the built-in node/edge drawer, or your own canvas-anchored surfaces.
+     * Children render inside the Workflow context, so they can call `useWorkflow`.
+     */
+    children?: ReactNode;
+    /**
+     * Notified whenever the issues array identity changes. Mostly a Storybook
+     * convenience now that validation is owned entirely by the backend — prod
+     * surfaces read `backendIssues` directly off their save response.
+     */
+    onIssuesChange?: (issues: Issue[]) => void;
+    /** Render-prop slot below the canvas (toolbar, run controls, etc.). */
+    footer?: ReactNode;
+    /**
+     * Minimum height of the editor frame. Defaults to `'500px'` for the full
+     * editor; lower it (e.g. for a read-only preview embedded in a card) so the
+     * canvas can shrink to its container.
+     */
+    minHeight?: string | number;
+    /**
+     * Optional override for the category → token map. Use to retheme the
+     * icon-tile colors and the Note body without forking NodeShell.
+     * Defaults to DEFAULT_CATEGORY_TOKENS.
+     */
+    categoryTokens?: CategoryTokenMap;
+    /**
+     * Opaque slot for host-specific data that node-type render functions need
+     * from the host app (e.g. a live LLM list, a chatbot id, API clients). The
+     * framework passes this through verbatim — node types cast it to their
+     * expected shape via a small accessor (see `adapters/factchatBridge.ts`).
+     * Kept as `unknown` so the framework itself stays domain-free.
+     */
+    hostBridge?: unknown;
+};
+/**
+ * Identity helper that preserves the TConfig generic so registry entries
+ * don't need `as NodeTypeDef` casts at the call site.
+ */
+export declare function defineNodeType<TConfig>(def: NodeTypeDef<TConfig>): NodeTypeDef;
+/** Resolve `defaultConfig` whether it's a value or a factory. */
+export declare function resolveDefaultConfig<TConfig>(def: Pick<NodeTypeDef<TConfig>, 'defaultConfig'>): TConfig;
+//# sourceMappingURL=Workflow.types.d.ts.map

package/dist/components/Workflow/Workflow.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Workflow.types.d.ts","sourceRoot":"","sources":["../../../src/components/Workflow/Workflow.types.ts"],"names":[],"mappings":"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"}

package/dist/components/Workflow/Workflow.types.js

@@ -0,0 +1,19 @@
+"use client";
+'use strict';
+
+/**
+ * Identity helper that preserves the TConfig generic so registry entries
+ * don't need `as NodeTypeDef` casts at the call site.
+ */
+function defineNodeType(def) {
+    return def;
+}
+/** Resolve `defaultConfig` whether it's a value or a factory. */
+function resolveDefaultConfig(def) {
+    const d = def.defaultConfig;
+    return typeof d === 'function' ? d() : d;
+}
+
+exports.defineNodeType = defineNodeType;
+exports.resolveDefaultConfig = resolveDefaultConfig;
+//# sourceMappingURL=Workflow.types.js.map

package/dist/components/Workflow/Workflow.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Workflow.types.js","sources":["../../../src/components/Workflow/Workflow.types.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AA+dA;;;AAGG;AACG,SAAU,cAAc,CAC5B,GAAyB,EAAA;AAEzB,IAAA,OAAO,GAAkB;AAC3B;AAEA;AACM,SAAU,oBAAoB,CAClC,GAAgD,EAAA;AAEhD,IAAA,MAAM,CAAC,GAAG,GAAG,CAAC,aAAa;AAC3B,IAAA,OAAO,OAAO,CAAC,KAAK,UAAU,GAAI,CAAmB,EAAE,GAAG,CAAC;AAC7D;;;;;"}

package/dist/components/Workflow/Workflow.types.mjs

@@ -0,0 +1,16 @@
+"use client";
+/**
+ * Identity helper that preserves the TConfig generic so registry entries
+ * don't need `as NodeTypeDef` casts at the call site.
+ */
+function defineNodeType(def) {
+    return def;
+}
+/** Resolve `defaultConfig` whether it's a value or a factory. */
+function resolveDefaultConfig(def) {
+    const d = def.defaultConfig;
+    return typeof d === 'function' ? d() : d;
+}
+
+export { defineNodeType, resolveDefaultConfig };
+//# sourceMappingURL=Workflow.types.mjs.map

package/dist/components/Workflow/Workflow.types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Workflow.types.mjs","sources":["../../../src/components/Workflow/Workflow.types.ts"],"sourcesContent":[null],"names":[],"mappings":";AA+dA;;;AAGG;AACG,SAAU,cAAc,CAC5B,GAAyB,EAAA;AAEzB,IAAA,OAAO,GAAkB;AAC3B;AAEA;AACM,SAAU,oBAAoB,CAClC,GAAgD,EAAA;AAEhD,IAAA,MAAM,CAAC,GAAG,GAAG,CAAC,aAAa;AAC3B,IAAA,OAAO,OAAO,CAAC,KAAK,UAAU,GAAI,CAAmB,EAAE,GAAG,CAAC;AAC7D;;;;"}

package/dist/components/Workflow/WorkflowContext/WorkflowContext.d.ts

@@ -0,0 +1,10 @@
+import type { WorkflowContextValue, WorkflowProviderProps } from './WorkflowContext.types';
+export declare function useWorkflow(): WorkflowContextValue;
+/**
+ * Convenience accessor for the host-injected translator. Canvas chrome calls
+ * this exactly where it would otherwise reach for an app-level `useTranslate`,
+ * keeping the core free of any direct i18n dependency.
+ */
+export declare function useWorkflowTranslate(): import("..").WorkflowTranslate;
+export declare function WorkflowProvider({ graph, dispatch, undo, redo, canUndo, canRedo, nodeTypes, translate, issues, onArrange, readOnly, onSelectionChange, validating, categoryTokens, hostBridge, children, }: WorkflowProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WorkflowContext.d.ts.map

package/dist/components/Workflow/WorkflowContext/WorkflowContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowContext.d.ts","sourceRoot":"","sources":["../../../../src/components/Workflow/WorkflowContext/WorkflowContext.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAEV,oBAAoB,EACpB,qBAAqB,EACtB,MAAM,yBAAyB,CAAC;AAIjC,wBAAgB,WAAW,IAAI,oBAAoB,CAMlD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,mCAEnC;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,OAAO,EACP,OAAO,EACP,SAAS,EACT,SAAS,EACT,MAAM,EACN,SAAS,EACT,QAAgB,EAChB,iBAAiB,EACjB,UAAkB,EAClB,cAAc,EACd,UAAU,EACV,QAAQ,GACT,EAAE,qBAAqB,2CA+JvB"}

package/dist/components/Workflow/WorkflowContext/WorkflowContext.js

@@ -0,0 +1,163 @@
+"use client";
+'use strict';
+
+var jsxRuntime = require('react/jsx-runtime');
+var React = require('react');
+
+const WorkflowContext = React.createContext(null);
+function useWorkflow() {
+    const ctx = React.useContext(WorkflowContext);
+    if (!ctx) {
+        throw new Error('useWorkflow must be used inside a <Workflow> component');
+    }
+    return ctx;
+}
+/**
+ * Convenience accessor for the host-injected translator. Canvas chrome calls
+ * this exactly where it would otherwise reach for an app-level `useTranslate`,
+ * keeping the core free of any direct i18n dependency.
+ */
+function useWorkflowTranslate() {
+    return useWorkflow().translate;
+}
+function WorkflowProvider({ graph, dispatch, undo, redo, canUndo, canRedo, nodeTypes, translate, issues, onArrange, readOnly = false, onSelectionChange, validating = false, categoryTokens, hostBridge, children, }) {
+    const [selectedNodeId, setSelectedNodeId] = React.useState(null);
+    const [selectedEdgeId, setSelectedEdgeId] = React.useState(null);
+    const [drawerTarget, setDrawerTarget] = React.useState(null);
+    const [runStates, setRunStates] = React.useState({});
+    const [fieldFocusRequest, setFieldFocusRequest] = React.useState(null);
+    const requestFieldFocus = React.useCallback((nodeId, fieldKey) => {
+        setFieldFocusRequest({ nodeId, fieldKey });
+    }, []);
+    const consumeFieldFocusRequest = React.useCallback(() => setFieldFocusRequest(null), []);
+    const setRunState = React.useCallback((id, state) => {
+        setRunStates((prev) => ({ ...prev, [id]: state }));
+    }, []);
+    const resetRunStates = React.useCallback(() => setRunStates({}), []);
+    // Single entry point for "select this element": every open-intent caller
+    // (canvas node/edge click, edge label, error-banner jump) routes through here
+    // so selection lives in one place. The host is notified via the
+    // `onSelectionChange` effect below.
+    const revealInspector = React.useCallback((target) => setDrawerTarget(target), []);
+    // Notify the host whenever the selected element changes — so it can drive its
+    // own inspector / side panel anywhere in its layout. Keyed on the target
+    // identity (set fresh per click), so graph edits don't re-fire it; the
+    // node/edge snapshot is read at fire time via a ref to avoid stale closures.
+    const graphRef = React.useRef(graph);
+    graphRef.current = graph;
+    React.useEffect(() => {
+        if (!onSelectionChange)
+            return;
+        if (!drawerTarget) {
+            onSelectionChange(null);
+            return;
+        }
+        const g = graphRef.current;
+        if (drawerTarget.type === 'node') {
+            const node = g.nodes.find((n) => n.id === drawerTarget.id);
+            onSelectionChange(node ? { type: 'node', id: node.id, node } : null);
+        }
+        else {
+            const edge = g.edges.find((e) => e.id === drawerTarget.id);
+            onSelectionChange(edge ? { type: 'edge', id: edge.id, edge } : null);
+        }
+        // Depends on `drawerTarget` only — fire on selection-identity change, not on
+        // every graph edit (the node/edge snapshot is read via `graphRef`).
+    }, [drawerTarget]);
+    const getNodeType = React.useCallback((kind) => nodeTypes[kind], [nodeTypes]);
+    const issuesByNode = React.useMemo(() => {
+        var _a;
+        const map = {};
+        for (const issue of issues) {
+            if (!issue.nodeId)
+                continue;
+            (map[_a = issue.nodeId] || (map[_a] = [])).push(issue);
+        }
+        return map;
+    }, [issues]);
+    const issuesByEdge = React.useMemo(() => {
+        var _a;
+        const map = {};
+        for (const issue of issues) {
+            if (!issue.edgeId)
+                continue;
+            (map[_a = issue.edgeId] || (map[_a] = [])).push(issue);
+        }
+        return map;
+    }, [issues]);
+    const issuesByField = React.useMemo(() => {
+        const map = {};
+        for (const issue of issues) {
+            if (!issue.nodeId || !issue.fieldKey)
+                continue;
+            const key = `${issue.nodeId}.${issue.fieldKey}`;
+            (map[key] || (map[key] = [])).push(issue);
+        }
+        return map;
+    }, [issues]);
+    const value = React.useMemo(() => ({
+        graph,
+        dispatch,
+        undo,
+        redo,
+        canUndo,
+        canRedo,
+        nodeTypes,
+        getNodeType,
+        translate,
+        issues,
+        issuesByNode,
+        issuesByEdge,
+        issuesByField,
+        editor: { selectedNodeId, selectedEdgeId, drawerTarget, runStates },
+        onArrange,
+        setSelectedNodeId,
+        setSelectedEdgeId,
+        setDrawerTarget,
+        revealInspector,
+        setRunState,
+        resetRunStates,
+        fieldFocusRequest,
+        requestFieldFocus,
+        consumeFieldFocusRequest,
+        readOnly,
+        validating,
+        categoryTokens,
+        hostBridge,
+    }), [
+        graph,
+        dispatch,
+        undo,
+        redo,
+        canUndo,
+        canRedo,
+        nodeTypes,
+        getNodeType,
+        translate,
+        issues,
+        issuesByNode,
+        issuesByEdge,
+        issuesByField,
+        onArrange,
+        selectedNodeId,
+        selectedEdgeId,
+        drawerTarget,
+        revealInspector,
+        runStates,
+        setRunState,
+        resetRunStates,
+        fieldFocusRequest,
+        requestFieldFocus,
+        consumeFieldFocusRequest,
+        readOnly,
+        validating,
+        categoryTokens,
+        hostBridge,
+    ]);
+    return (jsxRuntime.jsx(WorkflowContext.Provider, { value: value, children: children }));
+}
+
+exports.WorkflowProvider = WorkflowProvider;
+exports.useWorkflow = useWorkflow;
+exports.useWorkflowTranslate = useWorkflowTranslate;
+//# sourceMappingURL=WorkflowContext.js.map