@stigmer/react 1.0.4 → 2.0.0

package/workflow/picker/usePickerData.js

@@ -0,0 +1,112 @@
+"use client";
+import { useMemo } from "react";
+import { CATEGORY_ORDER } from "../canvas-constants";
+import { buildInsertionHeader } from "./insertion-context";
+import { getSuggestedKinds } from "./suggestions";
+import { getDisabledKinds, getHiddenKinds } from "./compatibility";
+import { getRecentKinds } from "./recents";
+/**
+ * Computes the full picker data model from insertion context, task registry,
+ * and graph model.
+ *
+ * This hook is the bridge between the pure intelligence layer (suggestions,
+ * compatibility, recents) and the picker UI component. It produces a stable,
+ * memoized data structure that drives rendering.
+ *
+ * @param context - The insertion context describing where and how the user is inserting.
+ * @param categories - Category-grouped task descriptors from `useTaskKindRegistry()`.
+ * @param graph - The current workflow graph model (for constraint evaluation).
+ * @param isLoading - Whether the task kind registry is still loading.
+ * @param searchQuery - Current search query for filtering.
+ */
+export function usePickerData(context, categories, graph, isLoading, searchQuery) {
+    return useMemo(() => {
+        const effectiveContext = context ?? { mode: "add-at-position" };
+        if (isLoading) {
+            return {
+                header: buildInsertionHeader(effectiveContext),
+                sections: [],
+                selectableItems: [],
+                isLoading,
+            };
+        }
+        const header = buildInsertionHeader(effectiveContext);
+        const hiddenKinds = getHiddenKinds();
+        const disabledEntries = graph ? getDisabledKinds(effectiveContext, graph) : [];
+        const disabledMap = new Map(disabledEntries.map((d) => [d.kind, d.reason]));
+        // Build a flat lookup of all descriptors by kind
+        const allDescriptors = new Map();
+        for (const descriptors of categories.values()) {
+            for (const d of descriptors) {
+                if (!hiddenKinds.has(d.kind)) {
+                    allDescriptors.set(d.kind, d);
+                }
+            }
+        }
+        const query = searchQuery.toLowerCase().trim();
+        const matchesSearch = (d) => !query ||
+            d.displayName.toLowerCase().includes(query) ||
+            d.description.toLowerCase().includes(query) ||
+            d.kind.toLowerCase().includes(query);
+        const toPickerItem = (d) => ({
+            descriptor: d,
+            disabled: disabledMap.has(d.kind),
+            disabledReason: disabledMap.get(d.kind),
+        });
+        const sections = [];
+        // --- Suggested section ---
+        if (!query) {
+            const suggestions = getSuggestedKinds(effectiveContext);
+            const suggestedItems = suggestions
+                .map((s) => allDescriptors.get(s.kind))
+                .filter((d) => d !== undefined)
+                .map(toPickerItem);
+            if (suggestedItems.length > 0) {
+                sections.push({
+                    id: "__suggested",
+                    label: "Suggested",
+                    items: suggestedItems,
+                    isSpecial: true,
+                });
+            }
+        }
+        // --- Recent section ---
+        if (!query) {
+            const recents = getRecentKinds();
+            const recentItems = recents
+                .map((r) => allDescriptors.get(r.kind))
+                .filter((d) => d !== undefined)
+                .map(toPickerItem);
+            if (recentItems.length > 0) {
+                sections.push({
+                    id: "__recent",
+                    label: "Recent",
+                    items: recentItems,
+                    isSpecial: true,
+                });
+            }
+        }
+        // --- Category sections ---
+        for (const cat of CATEGORY_ORDER) {
+            const descriptors = categories.get(cat);
+            if (!descriptors || descriptors.length === 0)
+                continue;
+            const filtered = descriptors
+                .filter((d) => !hiddenKinds.has(d.kind) && matchesSearch(d))
+                .map(toPickerItem);
+            if (filtered.length > 0) {
+                sections.push({
+                    id: cat,
+                    label: cat, // Display name is resolved by the UI component
+                    items: filtered,
+                });
+            }
+        }
+        // Build flat selectable list (excludes disabled items)
+        const selectableItems = sections
+            .flatMap((s) => s.items)
+            .filter((item) => !item.disabled);
+        return { header, sections, selectableItems, isLoading };
+    }, [context, categories, graph, isLoading, searchQuery]);
+}
+//# sourceMappingURL=usePickerData.js.map

package/workflow/picker/usePickerData.js.map

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

package/workflow/shortcut-registry.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Canonical shortcut definitions for the workflow canvas editor.
+ *
+ * Single source of truth for all keyboard shortcuts — consumed by
+ * {@link useCanvasKeyboardShortcuts} (matching), {@link CanvasContextMenu}
+ * (hint labels), {@link NodeActions} (toolbar tooltips), and any future
+ * help dialog or documentation generator.
+ *
+ * Pure TypeScript — no React dependency. Safe to import from any layer.
+ *
+ * @since T11 (Context Menus and Keyboard Shortcuts)
+ */
+/**
+ * Where a shortcut is applicable.
+ *
+ * - `node` — single node selected
+ * - `edge` — single edge selected
+ * - `selection` — one or more nodes selected (multi-select)
+ * - `canvas` — no selection required, fires on the canvas
+ */
+export type ShortcutScope = "node" | "edge" | "selection" | "canvas";
+/** A single keyboard shortcut definition. */
+export interface ShortcutDefinition {
+    /** Stable identifier (e.g. `"duplicate"`, `"copy"`). */
+    readonly id: string;
+    /** Human-readable action label for menus and tooltips. */
+    readonly label: string;
+    /**
+     * Key chord in platform-agnostic notation.
+     *
+     * `Mod` resolves to `Cmd` on macOS, `Ctrl` elsewhere.
+     * Bare keys use their literal name (e.g. `"N"`, `"Escape"`).
+     */
+    readonly keys: string;
+    /** Platform-specific display string (e.g. `"⌘D"` or `"Ctrl+D"`). */
+    readonly hint: string;
+    /** Where this shortcut is active. */
+    readonly scope: ShortcutScope;
+    /** Whether the shortcut is restricted to design mode. */
+    readonly requiresDesignMode: boolean;
+}
+/** All registered shortcut definitions. */
+export declare function getAllShortcuts(): readonly ShortcutDefinition[];
+/**
+ * Look up a shortcut by its stable identifier.
+ *
+ * Returns `undefined` if the id is not registered — callers should
+ * treat this as a programming error (missing registry entry).
+ */
+export declare function getShortcut(id: string): ShortcutDefinition | undefined;
+/**
+ * Get the display hint for a shortcut, or an empty string if not found.
+ *
+ * Convenience wrapper for context menu and toolbar hint labels.
+ */
+export declare function getShortcutHint(id: string): string;
+/** Whether the runtime platform is macOS / iOS. */
+export declare function isMacPlatform(): boolean;
+//# sourceMappingURL=shortcut-registry.d.ts.map

package/workflow/shortcut-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortcut-registry.d.ts","sourceRoot":"","sources":["../../src/workflow/shortcut-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAaH;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,CAAC;AAErE,6CAA6C;AAC7C,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,yDAAyD;IACzD,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;CACtC;AA2DD,2CAA2C;AAC3C,wBAAgB,eAAe,IAAI,SAAS,kBAAkB,EAAE,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEtE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,mDAAmD;AACnD,wBAAgB,aAAa,IAAI,OAAO,CAEvC"}

package/workflow/shortcut-registry.js

@@ -0,0 +1,83 @@
+/**
+ * Canonical shortcut definitions for the workflow canvas editor.
+ *
+ * Single source of truth for all keyboard shortcuts — consumed by
+ * {@link useCanvasKeyboardShortcuts} (matching), {@link CanvasContextMenu}
+ * (hint labels), {@link NodeActions} (toolbar tooltips), and any future
+ * help dialog or documentation generator.
+ *
+ * Pure TypeScript — no React dependency. Safe to import from any layer.
+ *
+ * @since T11 (Context Menus and Keyboard Shortcuts)
+ */
+// ---------------------------------------------------------------------------
+// Platform detection
+// ---------------------------------------------------------------------------
+const IS_MAC = typeof navigator !== "undefined" && /Mac|iPhone|iPad|iPod/.test(navigator.platform);
+// ---------------------------------------------------------------------------
+// Hint formatting
+// ---------------------------------------------------------------------------
+function formatHint(keys) {
+    if (IS_MAC) {
+        return keys
+            .replace(/Mod\+/g, "\u2318")
+            .replace(/Shift\+/g, "\u21E7")
+            .replace(/Alt\+/g, "\u2325")
+            .replace(/Backspace/g, "\u232B")
+            .replace(/Delete/g, "\u232B");
+    }
+    return keys
+        .replace(/Mod\+/g, "Ctrl+")
+        .replace(/Backspace/g, "Del")
+        .replace(/Delete/g, "Del");
+}
+// ---------------------------------------------------------------------------
+// Shortcut definitions
+// ---------------------------------------------------------------------------
+function def(id, label, keys, scope, requiresDesignMode) {
+    return { id, label, keys, hint: formatHint(keys), scope, requiresDesignMode };
+}
+const DEFINITIONS = [
+    // Single-node actions
+    def("duplicate", "Duplicate", "Mod+D", "node", true),
+    def("copy", "Copy", "Mod+C", "selection", true),
+    def("cut", "Cut", "Mod+X", "selection", true),
+    def("paste", "Paste", "Mod+V", "canvas", true),
+    def("delete", "Delete", "Backspace", "selection", true),
+    def("addTaskAfter", "Add task after\u2026", "N", "node", true),
+    // Canvas-wide actions
+    def("selectAll", "Select all", "Mod+A", "canvas", true),
+    def("undo", "Undo", "Mod+Z", "canvas", true),
+    def("redo", "Redo", "Mod+Shift+Z", "canvas", true),
+    def("escape", "Deselect", "Escape", "canvas", false),
+];
+// ---------------------------------------------------------------------------
+// Registry lookup
+// ---------------------------------------------------------------------------
+const BY_ID = new Map(DEFINITIONS.map((d) => [d.id, d]));
+/** All registered shortcut definitions. */
+export function getAllShortcuts() {
+    return DEFINITIONS;
+}
+/**
+ * Look up a shortcut by its stable identifier.
+ *
+ * Returns `undefined` if the id is not registered — callers should
+ * treat this as a programming error (missing registry entry).
+ */
+export function getShortcut(id) {
+    return BY_ID.get(id);
+}
+/**
+ * Get the display hint for a shortcut, or an empty string if not found.
+ *
+ * Convenience wrapper for context menu and toolbar hint labels.
+ */
+export function getShortcutHint(id) {
+    return BY_ID.get(id)?.hint ?? "";
+}
+/** Whether the runtime platform is macOS / iOS. */
+export function isMacPlatform() {
+    return IS_MAC;
+}
+//# sourceMappingURL=shortcut-registry.js.map

package/workflow/shortcut-registry.js.map

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

package/workflow/task-type-visual-registry.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Semantic shape identifier for workflow nodes.
+ *
+ * Each visual class maps to a distinct SVG shape that communicates the
+ * task's structural role at a glance:
+ *
+ * - `task-card` — rounded rectangle for general work tasks
+ * - `decision-diamond` — rotated square for conditional branching
+ * - `parallel-bar` — wide horizontal bar for parallel splits
+ * - `event-circle` — circle for events, signals, and timing
+ * - `gate-octagon` — octagon for human review gates (stop sign metaphor)
+ * - `subworkflow-card` — double-border card for sub-workflow invocations
+ * - `container` — rounded container for tasks with nested children
+ * - `terminal-pill` — pill/capsule for start and end sentinels
+ */
+export type VisualClass = "task-card" | "decision-diamond" | "parallel-bar" | "event-circle" | "gate-octagon" | "subworkflow-card" | "container" | "terminal-pill";
+/**
+ * Describes how a task kind's connection handles are structured.
+ *
+ * T02 (NodeShell) reads this to render the appropriate React Flow Handles.
+ * T01 defines the patterns; T02 implements the rendering.
+ */
+export type PortPattern = "standard" | "branch-per-case" | "branch-per-outcome" | "branch-per-branch" | "container" | "source-only" | "sink-only";
+/**
+ * Visual specification for a single workflow task kind.
+ *
+ * Combines shape, dimension, port, and accessibility metadata.
+ * The layout engine (dagre today, ELK in T03) uses `defaultWidth`
+ * and `defaultHeight + captionHeight` for node sizing. The renderer
+ * (T02 NodeShell) uses `visualClass` to select the SVG shape component.
+ *
+ * For non-rectangular shapes (diamond, octagon, circle), the task name
+ * renders as an external caption BELOW the shape. `captionHeight` reserves
+ * space for this caption in the layout bounding box. The SVG shape itself
+ * renders at `defaultHeight`, and the full layout allocation is
+ * `defaultHeight + captionHeight`.
+ */
+export interface TaskTypeVisualSpec {
+    readonly visualClass: VisualClass;
+    readonly defaultWidth: number;
+    readonly defaultHeight: number;
+    /**
+     * Height reserved for the task name caption below the shape.
+     * 0 for shapes with internal text (cards, bars, pills).
+     * >0 for non-rectangular shapes where text is placed externally.
+     */
+    readonly captionHeight: number;
+    readonly portPattern: PortPattern;
+    readonly isContainer: boolean;
+    readonly ariaShapeLabel: string;
+}
+/**
+ * Static registry mapping every workflow task kind string to its
+ * visual specification.
+ *
+ * Includes all 20 `WorkflowTaskKind` enum values plus the two
+ * sentinel pseudo-kinds (`__start__`, `__end__`).
+ *
+ * Frozen to prevent accidental mutation — this is static metadata
+ * that must not change at runtime.
+ */
+export declare const VISUAL_REGISTRY: ReadonlyMap<string, TaskTypeVisualSpec>;
+/**
+ * Returns the visual specification for a task kind string.
+ *
+ * Falls back to `task-card` for unknown kinds, ensuring a valid spec
+ * is always returned even for future task kinds not yet in the registry.
+ */
+export declare function getVisualSpec(kind: string): TaskTypeVisualSpec;
+//# sourceMappingURL=task-type-visual-registry.d.ts.map

package/workflow/task-type-visual-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-type-visual-registry.d.ts","sourceRoot":"","sources":["../../src/workflow/task-type-visual-registry.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,WAAW,GACnB,WAAW,GACX,kBAAkB,GAClB,cAAc,GACd,cAAc,GACd,cAAc,GACd,kBAAkB,GAClB,WAAW,GACX,eAAe,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,MAAM,WAAW,GACnB,UAAU,GACV,iBAAiB,GACjB,oBAAoB,GACpB,mBAAmB,GACnB,WAAW,GACX,aAAa,GACb,WAAW,CAAC;AAEhB;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAuFD;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAsCnE,CAAC;AAIF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAE9D"}

package/workflow/task-type-visual-registry.js

@@ -0,0 +1,129 @@
+import { CANVAS_NODE_WIDTH, CANVAS_NODE_HEIGHT, SENTINEL_NODE_WIDTH, SENTINEL_NODE_HEIGHT, } from "./canvas-constants";
+const TASK_CARD = {
+    visualClass: "task-card",
+    defaultWidth: CANVAS_NODE_WIDTH,
+    defaultHeight: CANVAS_NODE_HEIGHT,
+    captionHeight: 0,
+    portPattern: "standard",
+    isContainer: false,
+    ariaShapeLabel: "card",
+};
+const DECISION_DIAMOND = {
+    visualClass: "decision-diamond",
+    defaultWidth: 140,
+    defaultHeight: 120,
+    captionHeight: 24,
+    portPattern: "branch-per-case",
+    isContainer: false,
+    ariaShapeLabel: "diamond",
+};
+const PARALLEL_BAR = {
+    visualClass: "parallel-bar",
+    defaultWidth: 260,
+    defaultHeight: 32,
+    captionHeight: 0,
+    portPattern: "branch-per-branch",
+    isContainer: false,
+    ariaShapeLabel: "horizontal bar",
+};
+const EVENT_CIRCLE = {
+    visualClass: "event-circle",
+    defaultWidth: 80,
+    defaultHeight: 70,
+    captionHeight: 20,
+    portPattern: "standard",
+    isContainer: false,
+    ariaShapeLabel: "circle",
+};
+const GATE_OCTAGON = {
+    visualClass: "gate-octagon",
+    defaultWidth: 160,
+    defaultHeight: 140,
+    captionHeight: 24,
+    portPattern: "branch-per-outcome",
+    isContainer: false,
+    ariaShapeLabel: "octagon",
+};
+const SUBWORKFLOW_CARD = {
+    visualClass: "subworkflow-card",
+    defaultWidth: CANVAS_NODE_WIDTH,
+    defaultHeight: CANVAS_NODE_HEIGHT,
+    captionHeight: 0,
+    portPattern: "standard",
+    isContainer: false,
+    ariaShapeLabel: "sub-workflow card",
+};
+const CONTAINER = {
+    visualClass: "container",
+    defaultWidth: 280,
+    defaultHeight: 120,
+    captionHeight: 0,
+    portPattern: "container",
+    isContainer: true,
+    ariaShapeLabel: "container",
+};
+const TERMINAL_PILL = {
+    visualClass: "terminal-pill",
+    defaultWidth: SENTINEL_NODE_WIDTH,
+    defaultHeight: SENTINEL_NODE_HEIGHT,
+    captionHeight: 0,
+    portPattern: "source-only",
+    isContainer: false,
+    ariaShapeLabel: "pill",
+};
+const TERMINAL_PILL_END = {
+    ...TERMINAL_PILL,
+    portPattern: "sink-only",
+};
+/**
+ * Static registry mapping every workflow task kind string to its
+ * visual specification.
+ *
+ * Includes all 20 `WorkflowTaskKind` enum values plus the two
+ * sentinel pseudo-kinds (`__start__`, `__end__`).
+ *
+ * Frozen to prevent accidental mutation — this is static metadata
+ * that must not change at runtime.
+ */
+export const VISUAL_REGISTRY = Object.freeze(new Map([
+    // ai
+    ["agent_call", TASK_CARD],
+    ["llm_call", TASK_CARD],
+    ["eval", TASK_CARD],
+    // control_flow
+    ["switch_case", DECISION_DIAMOND],
+    ["for_each", CONTAINER],
+    ["fork", PARALLEL_BAR],
+    ["try_catch", CONTAINER],
+    ["wait", EVENT_CIRCLE],
+    // invocation
+    ["http_call", TASK_CARD],
+    ["grpc_call", TASK_CARD],
+    ["activity_call", TASK_CARD],
+    ["run_workflow", SUBWORKFLOW_CARD],
+    // data
+    ["set_vars", TASK_CARD],
+    ["transform", TASK_CARD],
+    ["validate", TASK_CARD],
+    // governance
+    ["human_input", GATE_OCTAGON],
+    // event
+    ["listen", EVENT_CIRCLE],
+    ["emit_event", EVENT_CIRCLE],
+    ["notification", EVENT_CIRCLE],
+    ["raise_error", EVENT_CIRCLE],
+    // sentinels
+    ["__start__", TERMINAL_PILL],
+    ["__end__", TERMINAL_PILL_END],
+]));
+const DEFAULT_SPEC = TASK_CARD;
+/**
+ * Returns the visual specification for a task kind string.
+ *
+ * Falls back to `task-card` for unknown kinds, ensuring a valid spec
+ * is always returned even for future task kinds not yet in the registry.
+ */
+export function getVisualSpec(kind) {
+    return VISUAL_REGISTRY.get(kind) ?? DEFAULT_SPEC;
+}
+//# sourceMappingURL=task-type-visual-registry.js.map

package/workflow/task-type-visual-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-type-visual-registry.js","sourceRoot":"","sources":["../../src/workflow/task-type-visual-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAuE5B,MAAM,SAAS,GAAuB;IACpC,WAAW,EAAE,WAAW;IACxB,YAAY,EAAE,iBAAiB;IAC/B,aAAa,EAAE,kBAAkB;IACjC,aAAa,EAAE,CAAC;IAChB,WAAW,EAAE,UAAU;IACvB,WAAW,EAAE,KAAK;IAClB,cAAc,EAAE,MAAM;CACd,CAAC;AAEX,MAAM,gBAAgB,GAAuB;IAC3C,WAAW,EAAE,kBAAkB;IAC/B,YAAY,EAAE,GAAG;IACjB,aAAa,EAAE,GAAG;IAClB,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE,iBAAiB;IAC9B,WAAW,EAAE,KAAK;IAClB,cAAc,EAAE,SAAS;CACjB,CAAC;AAEX,MAAM,YAAY,GAAuB;IACvC,WAAW,EAAE,cAAc;IAC3B,YAAY,EAAE,GAAG;IACjB,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,CAAC;IAChB,WAAW,EAAE,mBAAmB;IAChC,WAAW,EAAE,KAAK;IAClB,cAAc,EAAE,gBAAgB;CACxB,CAAC;AAEX,MAAM,YAAY,GAAuB;IACvC,WAAW,EAAE,cAAc;IAC3B,YAAY,EAAE,EAAE;IAChB,aAAa,EAAE,EAAE;IACjB,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE,UAAU;IACvB,WAAW,EAAE,KAAK;IAClB,cAAc,EAAE,QAAQ;CAChB,CAAC;AAEX,MAAM,YAAY,GAAuB;IACvC,WAAW,EAAE,cAAc;IAC3B,YAAY,EAAE,GAAG;IACjB,aAAa,EAAE,GAAG;IAClB,aAAa,EAAE,EAAE;IACjB,WAAW,EAAE,oBAAoB;IACjC,WAAW,EAAE,KAAK;IAClB,cAAc,EAAE,SAAS;CACjB,CAAC;AAEX,MAAM,gBAAgB,GAAuB;IAC3C,WAAW,EAAE,kBAAkB;IAC/B,YAAY,EAAE,iBAAiB;IAC/B,aAAa,EAAE,kBAAkB;IACjC,aAAa,EAAE,CAAC;IAChB,WAAW,EAAE,UAAU;IACvB,WAAW,EAAE,KAAK;IAClB,cAAc,EAAE,mBAAmB;CAC3B,CAAC;AAEX,MAAM,SAAS,GAAuB;IACpC,WAAW,EAAE,WAAW;IACxB,YAAY,EAAE,GAAG;IACjB,aAAa,EAAE,GAAG;IAClB,aAAa,EAAE,CAAC;IAChB,WAAW,EAAE,WAAW;IACxB,WAAW,EAAE,IAAI;IACjB,cAAc,EAAE,WAAW;CACnB,CAAC;AAEX,MAAM,aAAa,GAAuB;IACxC,WAAW,EAAE,eAAe;IAC5B,YAAY,EAAE,mBAAmB;IACjC,aAAa,EAAE,oBAAoB;IACnC,aAAa,EAAE,CAAC;IAChB,WAAW,EAAE,aAAa;IAC1B,WAAW,EAAE,KAAK;IAClB,cAAc,EAAE,MAAM;CACd,CAAC;AAEX,MAAM,iBAAiB,GAAuB;IAC5C,GAAG,aAAa;IAChB,WAAW,EAAE,WAAW;CAChB,CAAC;AAEX;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAA4C,MAAM,CAAC,MAAM,CACnF,IAAI,GAAG,CAA6B;IAClC,KAAK;IACL,CAAC,YAAY,EAAE,SAAS,CAAC;IACzB,CAAC,UAAU,EAAE,SAAS,CAAC;IACvB,CAAC,MAAM,EAAE,SAAS,CAAC;IAEnB,eAAe;IACf,CAAC,aAAa,EAAE,gBAAgB,CAAC;IACjC,CAAC,UAAU,EAAE,SAAS,CAAC;IACvB,CAAC,MAAM,EAAE,YAAY,CAAC;IACtB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,MAAM,EAAE,YAAY,CAAC;IAEtB,aAAa;IACb,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,eAAe,EAAE,SAAS,CAAC;IAC5B,CAAC,cAAc,EAAE,gBAAgB,CAAC;IAElC,OAAO;IACP,CAAC,UAAU,EAAE,SAAS,CAAC;IACvB,CAAC,WAAW,EAAE,SAAS,CAAC;IACxB,CAAC,UAAU,EAAE,SAAS,CAAC;IAEvB,aAAa;IACb,CAAC,aAAa,EAAE,YAAY,CAAC;IAE7B,QAAQ;IACR,CAAC,QAAQ,EAAE,YAAY,CAAC;IACxB,CAAC,YAAY,EAAE,YAAY,CAAC;IAC5B,CAAC,cAAc,EAAE,YAAY,CAAC;IAC9B,CAAC,aAAa,EAAE,YAAY,CAAC;IAE7B,YAAY;IACZ,CAAC,WAAW,EAAE,aAAa,CAAC;IAC5B,CAAC,SAAS,EAAE,iBAAiB,CAAC;CAC/B,CAAC,CACH,CAAC;AAEF,MAAM,YAAY,GAAuB,SAAS,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC;AACnD,CAAC"}

package/workflow/templates/WorkflowTemplateCard.d.ts

@@ -0,0 +1,16 @@
+import type { WorkflowTemplate } from "./types";
+export interface WorkflowTemplateCardProps {
+    readonly template: WorkflowTemplate;
+    readonly onSelect: (template: WorkflowTemplate) => void;
+    readonly onPreview?: (template: WorkflowTemplate) => void;
+    readonly className?: string;
+}
+/**
+ * Enhanced template card for workflow templates.
+ *
+ * Shows the template name, description, category badge, pattern badges,
+ * task count, and env var count. Click selects the template; an optional
+ * preview button opens the graph preview dialog.
+ */
+export declare function WorkflowTemplateCard({ template, onSelect, onPreview, className, }: WorkflowTemplateCardProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WorkflowTemplateCard.d.ts.map

package/workflow/templates/WorkflowTemplateCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowTemplateCard.d.ts","sourceRoot":"","sources":["../../../src/workflow/templates/WorkflowTemplateCard.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAwB,MAAM,SAAS,CAAC;AAKtE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACxD,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAuBD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,SAAS,GACV,EAAE,yBAAyB,2CA2G3B"}

package/workflow/templates/WorkflowTemplateCard.js

@@ -0,0 +1,55 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useCallback, useMemo } from "react";
+import { cn } from "@stigmer/theme";
+import { PATTERN_LABELS } from "./types";
+import { deriveTemplateMeta } from "./derive-template-metadata";
+import { TEMPLATE_CATEGORY_LABELS } from "../../resource-creation/templates/types";
+const CATEGORY_COLORS = {
+    "customer-support": "bg-blue-500/10 text-blue-700 dark:text-blue-400",
+    "code-review": "bg-violet-500/10 text-violet-700 dark:text-violet-400",
+    "data-analysis": "bg-amber-500/10 text-amber-700 dark:text-amber-400",
+    devops: "bg-emerald-500/10 text-emerald-700 dark:text-emerald-400",
+    content: "bg-pink-500/10 text-pink-700 dark:text-pink-400",
+    integration: "bg-cyan-500/10 text-cyan-700 dark:text-cyan-400",
+    general: "bg-muted text-muted-foreground",
+};
+const PATTERN_COLORS = {
+    parallel: "bg-violet-500/10 text-violet-700 dark:text-violet-400",
+    branching: "bg-amber-500/10 text-amber-700 dark:text-amber-400",
+    hitl: "bg-emerald-500/10 text-emerald-700 dark:text-emerald-400",
+    loop: "bg-pink-500/10 text-pink-700 dark:text-pink-400",
+    "error-handling": "bg-red-500/10 text-red-700 dark:text-red-400",
+    batch: "bg-cyan-500/10 text-cyan-700 dark:text-cyan-400",
+    "ai-pipeline": "bg-blue-500/10 text-blue-700 dark:text-blue-400",
+    "http-integration": "bg-orange-500/10 text-orange-700 dark:text-orange-400",
+};
+/**
+ * Enhanced template card for workflow templates.
+ *
+ * Shows the template name, description, category badge, pattern badges,
+ * task count, and env var count. Click selects the template; an optional
+ * preview button opens the graph preview dialog.
+ */
+export function WorkflowTemplateCard({ template, onSelect, onPreview, className, }) {
+    const meta = useMemo(() => deriveTemplateMeta(template.data.yaml ?? ""), [template.data.yaml]);
+    const handleClick = useCallback(() => {
+        onSelect(template);
+    }, [onSelect, template]);
+    const handlePreview = useCallback((e) => {
+        e.stopPropagation();
+        onPreview?.(template);
+    }, [onPreview, template]);
+    const handleKeyDown = useCallback((e) => {
+        if (e.key === "Enter" || e.key === " ") {
+            e.preventDefault();
+            onSelect(template);
+        }
+    }, [onSelect, template]);
+    const categoryLabel = TEMPLATE_CATEGORY_LABELS[template.category] ?? template.category;
+    return (_jsxs("div", { role: "button", tabIndex: 0, onClick: handleClick, onKeyDown: handleKeyDown, "aria-label": `Use ${template.name} template`, className: cn("group flex cursor-pointer flex-col gap-3 rounded-lg border border-border bg-card p-4", "transition-colors hover:border-primary hover:bg-accent", "focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", className), children: [_jsxs("div", { className: "flex items-start justify-between gap-2", children: [_jsxs("div", { className: "min-w-0 flex-1", children: [_jsx("p", { className: "text-sm font-medium text-foreground", children: template.name }), _jsx("span", { className: cn("mt-1 inline-block rounded-full px-2 py-0.5 text-[10px] font-medium", CATEGORY_COLORS[template.category] ?? CATEGORY_COLORS.general), children: categoryLabel })] }), onPreview && (_jsx("button", { type: "button", onClick: handlePreview, "aria-label": `Preview ${template.name}`, className: cn("rounded-md p-1 text-muted-foreground opacity-0 transition-opacity", "hover:bg-accent hover:text-accent-foreground", "focus-visible:opacity-100 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring", "group-hover:opacity-100"), children: _jsx(PreviewIcon, {}) }))] }), _jsx("p", { className: "line-clamp-2 text-xs leading-relaxed text-muted-foreground", children: template.description }), meta.patterns.length > 0 && (_jsx("div", { className: "flex flex-wrap gap-1", children: meta.patterns.slice(0, 3).map((pattern) => (_jsx("span", { className: cn("rounded px-1.5 py-0.5 text-[10px] font-medium", PATTERN_COLORS[pattern] ?? "bg-muted text-muted-foreground"), children: PATTERN_LABELS[pattern] }, pattern))) })), _jsxs("div", { className: "flex items-center gap-3 text-[10px] text-muted-foreground", children: [_jsxs("span", { children: [meta.taskCount, " tasks"] }), meta.envVarCount > 0 && _jsxs("span", { children: [meta.envVarCount, " env vars"] }), meta.hasBudget && _jsx("span", { children: "Budget" })] })] }));
+}
+function PreviewIcon() {
+    return (_jsxs("svg", { className: "size-4", xmlns: "http://www.w3.org/2000/svg", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: 2, strokeLinecap: "round", strokeLinejoin: "round", "aria-hidden": "true", children: [_jsx("path", { d: "M2 12s3-7 10-7 10 7 10 7-3 7-10 7-10-7-10-7Z" }), _jsx("circle", { cx: 12, cy: 12, r: 3 })] }));
+}
+//# sourceMappingURL=WorkflowTemplateCard.js.map

package/workflow/templates/WorkflowTemplateCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowTemplateCard.js","sourceRoot":"","sources":["../../../src/workflow/templates/WorkflowTemplateCard.tsx"],"names":[],"mappings":"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"}

package/workflow/templates/WorkflowTemplateGallery.d.ts

@@ -0,0 +1,22 @@
+import { type ReactNode } from "react";
+import type { WorkflowTemplate } from "./types";
+export interface WorkflowTemplateGalleryProps {
+    readonly templates: readonly WorkflowTemplate[];
+    readonly onSelect: (template: WorkflowTemplate) => void;
+    readonly emptyContent?: ReactNode;
+    readonly className?: string;
+}
+/**
+ * Searchable, filterable gallery of workflow templates.
+ *
+ * Composes the headless `useTemplateFilter` hook with workflow-specific
+ * `WorkflowTemplateCard` components. Includes an integrated preview
+ * dialog — clicking the eye icon on a card opens a graph preview
+ * before committing to the template.
+ *
+ * Keyboard navigation follows the same pattern as the generic
+ * `TemplateGallery`: Tab between search/tabs/cards, Arrow keys
+ * navigate tabs, Enter/Space activates.
+ */
+export declare function WorkflowTemplateGallery({ templates, onSelect, emptyContent, className, }: WorkflowTemplateGalleryProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WorkflowTemplateGallery.d.ts.map

package/workflow/templates/WorkflowTemplateGallery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowTemplateGallery.d.ts","sourceRoot":"","sources":["../../../src/workflow/templates/WorkflowTemplateGallery.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAyB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAE9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAOhD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,SAAS,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACxD,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,SAAS,GACV,EAAE,4BAA4B,2CAyI9B"}