@octaviaflow/core 3.0.18-beta.6 → 3.0.18-beta.8

package/dist/components/WorkflowHeader/misc/WorkflowHeaderCommand.d.ts

@@ -0,0 +1,39 @@
+/**
+ * WorkflowHeaderCommand (DRAFT — not exported from the package).
+ *
+ * Center-stage command palette trigger (a search input lookalike). Most
+ * actions are reachable from the palette, so the action cluster on the
+ * right stays minimal (Run/Stop, console, ⋮). Identity sits on the left.
+ *
+ *   ┌──────────────────────────────────────────────────────────────────────┐
+ *   │ ● HTTP Order Sync       [⌘K  Search nodes, actions, runs…]    Stop ⏏ ⋮ │
+ *   └──────────────────────────────────────────────────────────────────────┘
+ *
+ * Why it might win:
+ *   - For power users who live in keyboard shortcuts, the palette IS the
+ *     surface — the chrome around it can be very quiet.
+ *   - Center input acts as a visual anchor and a doing-things-fast affordance.
+ *
+ * Why it might lose:
+ *   - First-time users look for buttons, not search inputs.
+ *   - Hard to balance the center input against the left identity on
+ *     narrow viewports.
+ */
+import type { ReactNode } from "react";
+import { type DropdownMenuItem } from "../../DropdownMenu";
+export interface WorkflowHeaderCommandProps {
+    name: ReactNode;
+    statusTone?: "draft" | "active" | "paused" | "error" | "running";
+    /** Placeholder shown in the command palette trigger input. */
+    commandPlaceholder?: string;
+    /** Fires when the palette trigger is clicked or ⌘K pressed. */
+    onCommand?: () => void;
+    isRunning?: boolean;
+    onStop?: () => void;
+    isConsoleOpen?: boolean;
+    onToggleConsole?: () => void;
+    menuItems?: DropdownMenuItem[];
+    className?: string;
+}
+export declare function WorkflowHeaderCommand({ name, statusTone, commandPlaceholder, onCommand, isRunning, onStop, isConsoleOpen, onToggleConsole, menuItems, className, }: WorkflowHeaderCommandProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WorkflowHeaderCommand.d.ts.map

package/dist/components/WorkflowHeader/misc/WorkflowHeaderCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowHeaderCommand.d.ts","sourceRoot":"","sources":["../../../../src/components/WorkflowHeader/misc/WorkflowHeaderCommand.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAQvC,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGzE,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IACjE,8DAA8D;IAC9D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,qBAAqB,CAAC,EACpC,IAAI,EACJ,UAAoB,EACpB,kBAAmD,EACnD,SAAS,EACT,SAAS,EACT,MAAM,EACN,aAAa,EACb,eAAe,EACf,SAAS,EACT,SAAS,GACV,EAAE,0BAA0B,2CAmE5B"}

package/dist/components/WorkflowHeader/misc/WorkflowHeaderMinimal.d.ts

@@ -0,0 +1,44 @@
+/**
+ * WorkflowHeaderMinimal (DRAFT — not exported from the package).
+ *
+ * Single-row barebones variant for editors embedded inside a larger
+ * surface that already provides chrome (back navigation, breadcrumb,
+ * environment switching). The DS strip is reduced to:
+ *
+ *   ┌──────────────────────────────────────────────────┐
+ *   │ ● Name · Saved 12s ago                  Stop · ⋮ │
+ *   └──────────────────────────────────────────────────┘
+ *
+ * What's intentionally NOT here vs the main variant:
+ *   - No back / breadcrumb (parent surface owns navigation)
+ *   - No env chip (parent surface owns environment switching)
+ *   - No console toggle (assumes the host renders the console inline)
+ *   - No bottom progress shimmer (assumes the host provides ambient
+ *     "running" feedback elsewhere)
+ *
+ * Why it might win:
+ *   - When this header is embedded in a richer parent UI, duplicating
+ *     navigation and environment controls makes both feel cluttered.
+ *
+ * Why it might lose:
+ *   - Loses the "this strip is the entire chrome" pattern that the
+ *     standalone editor relies on.
+ *
+ * Imported only by `WorkflowHeader.stories.tsx` for side-by-side review.
+ */
+import type { ReactNode } from "react";
+import { type DropdownMenuItem } from "../../DropdownMenu";
+export interface WorkflowHeaderMinimalProps {
+    name: ReactNode;
+    /** "draft" | "active" | "paused" | "error" | "running" */
+    statusTone?: "draft" | "active" | "paused" | "error" | "running";
+    /** Save indicator text. Consumer formats relative time. */
+    saveLabel?: string;
+    saveError?: string | null;
+    isRunning?: boolean;
+    onStop?: () => void;
+    menuItems?: DropdownMenuItem[];
+    className?: string;
+}
+export declare function WorkflowHeaderMinimal({ name, statusTone, saveLabel, saveError, isRunning, onStop, menuItems, className, }: WorkflowHeaderMinimalProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WorkflowHeaderMinimal.d.ts.map

package/dist/components/WorkflowHeader/misc/WorkflowHeaderMinimal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowHeaderMinimal.d.ts","sourceRoot":"","sources":["../../../../src/components/WorkflowHeader/misc/WorkflowHeaderMinimal.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGzE,MAAM,WAAW,0BAA0B;IACzC,IAAI,EAAE,SAAS,CAAC;IAChB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IACjE,2DAA2D;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,qBAAqB,CAAC,EACpC,IAAI,EACJ,UAAoB,EACpB,SAAS,EACT,SAAS,EACT,SAAS,EACT,MAAM,EACN,SAAS,EACT,SAAS,GACV,EAAE,0BAA0B,2CAsD5B"}

package/dist/components/WorkflowHeader/misc/WorkflowHeaderRail.d.ts

@@ -0,0 +1,45 @@
+/**
+ * WorkflowHeaderRail (DRAFT — not exported from the package).
+ *
+ * Single row with a 3 px status-coloured stripe on the LEFT edge that
+ * runs the full header height. The rail IS the status indicator — no
+ * dot needed inline. Reads instantly from the periphery: orange = paused,
+ * red = error, blue + animated = running.
+ *
+ *   ┃ ‹ Workflows / HTTP Order Sync · Saved 12s ago      Stop · Draft ▎ ⏏ ⋮
+ *   ┃ ← rail (status-tinted, animates when running)
+ *
+ * Why it might win:
+ *   - Status is readable from the periphery without parsing — single
+ *     vertical line catches the eye like a tab indicator.
+ *   - No inline status dot frees ~12 px of horizontal space for the title.
+ *
+ * Why it might lose:
+ *   - Left-edge accents collide with sidebars/rails the host already uses.
+ *   - Less discoverable status — first-time users don't know to read it.
+ */
+import type { ReactNode } from "react";
+import { type DropdownMenuItem } from "../../DropdownMenu";
+export interface WorkflowHeaderRailProps {
+    name: ReactNode;
+    statusTone?: "draft" | "active" | "paused" | "error" | "running";
+    onBack?: () => void;
+    parentLabel?: ReactNode;
+    saveLabel?: string;
+    saveError?: string | null;
+    isRunning?: boolean;
+    onStop?: () => void;
+    runtime?: string;
+    environment?: {
+        label: ReactNode;
+        accent?: string;
+        title?: string;
+        onClick?: () => void;
+    };
+    isConsoleOpen?: boolean;
+    onToggleConsole?: () => void;
+    menuItems?: DropdownMenuItem[];
+    className?: string;
+}
+export declare function WorkflowHeaderRail({ name, statusTone, onBack, parentLabel, saveLabel, saveError, isRunning, onStop, runtime, environment, isConsoleOpen, onToggleConsole, menuItems, className, }: WorkflowHeaderRailProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WorkflowHeaderRail.d.ts.map

package/dist/components/WorkflowHeader/misc/WorkflowHeaderRail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowHeaderRail.d.ts","sourceRoot":"","sources":["../../../../src/components/WorkflowHeader/misc/WorkflowHeaderRail.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASvC,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGzE,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IACjE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE;QAAE,KAAK,EAAE,SAAS,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;IAC1F,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,kBAAkB,CAAC,EACjC,IAAI,EACJ,UAAoB,EACpB,MAAM,EACN,WAAoB,EACpB,SAAS,EACT,SAAS,EACT,SAAS,EACT,MAAM,EACN,OAAO,EACP,WAAW,EACX,aAAa,EACb,eAAe,EACf,SAAS,EACT,SAAS,GACV,EAAE,uBAAuB,2CA4FzB"}

package/dist/components/WorkflowHeader/misc/WorkflowHeaderStudio.d.ts

@@ -0,0 +1,48 @@
+/**
+ * WorkflowHeaderStudio (DRAFT — not exported from the package).
+ *
+ * Dashboard-feel single row (60 px tall). The Run / Stop CTA is the
+ * visual anchor on the right — primary variant, prominent — making
+ * "execute this workflow" the obvious next action. Generous typography.
+ *
+ *   ┌──────────────────────────────────────────────────────────────────────────┐
+ *   │ ‹ Workflows / ● HTTP Order Sync                  Draft ▎ ⏏  [▶ Run] ⋮ │
+ *   │   Saved 12s ago                                                        │
+ *   └──────────────────────────────────────────────────────────────────────────┘
+ *
+ * Why it might win:
+ *   - Run is the primary intent in most editor sessions — giving it visual
+ *     weight reduces hunt-and-click and reads as "tool ready to do work."
+ *   - 60 px height gives the title room to breathe; save indicator gets a
+ *     dedicated second line so it's never competing with the title.
+ *
+ * Why it might lose:
+ *   - 16 px taller than the default → less canvas.
+ *   - Big primary CTA at rest can feel demanding on long idle sessions.
+ */
+import type { ReactNode } from "react";
+import { type DropdownMenuItem } from "../../DropdownMenu";
+export interface WorkflowHeaderStudioProps {
+    name: ReactNode;
+    statusTone?: "draft" | "active" | "paused" | "error" | "running";
+    onBack?: () => void;
+    parentLabel?: ReactNode;
+    saveLabel?: string;
+    saveError?: string | null;
+    isRunning?: boolean;
+    onRun?: () => void;
+    onStop?: () => void;
+    runtime?: string;
+    environment?: {
+        label: ReactNode;
+        accent?: string;
+        title?: string;
+        onClick?: () => void;
+    };
+    isConsoleOpen?: boolean;
+    onToggleConsole?: () => void;
+    menuItems?: DropdownMenuItem[];
+    className?: string;
+}
+export declare function WorkflowHeaderStudio({ name, statusTone, onBack, parentLabel, saveLabel, saveError, isRunning, onRun, onStop, runtime, environment, isConsoleOpen, onToggleConsole, menuItems, className, }: WorkflowHeaderStudioProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WorkflowHeaderStudio.d.ts.map

package/dist/components/WorkflowHeader/misc/WorkflowHeaderStudio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowHeaderStudio.d.ts","sourceRoot":"","sources":["../../../../src/components/WorkflowHeader/misc/WorkflowHeaderStudio.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAUvC,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGzE,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,SAAS,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IACjE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE;QAAE,KAAK,EAAE,SAAS,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;IAC1F,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,oBAAoB,CAAC,EACnC,IAAI,EACJ,UAAoB,EACpB,MAAM,EACN,WAAoB,EACpB,SAAS,EACT,SAAS,EACT,SAAS,EACT,KAAK,EACL,MAAM,EACN,OAAO,EACP,WAAW,EACX,aAAa,EACb,eAAe,EACf,SAAS,EACT,SAAS,GACV,EAAE,yBAAyB,2CAgH3B"}

package/dist/components/WorkflowHeader/misc/WorkflowHeaderTiered.d.ts

@@ -0,0 +1,52 @@
+/**
+ * WorkflowHeaderTiered (DRAFT — not exported from the package).
+ *
+ * Two-row variant for editors that need always-visible run metadata
+ * underneath the identity row.
+ *
+ *   ┌──────────────────────────────────────────────────────────────────────┐
+ *   │ ‹ Workflows / ● Name                          Stop · 00:12 · Env ▎ ⏏ ⋮ │  ← 40 px
+ *   │ GPT-4o · 2 steps · 0 errors · last run 3m ago · Saved 12s ago        │  ← 24 px
+ *   │ ──────────────────────────────────────────────────────────────────── │  ← shimmer while running
+ *   └──────────────────────────────────────────────────────────────────────┘
+ *
+ * Why it might win:
+ *   - Always-visible execution context (model, step count, errors, etc.)
+ *   - Save indicator gets dedicated breathing room — never competes with
+ *     the title for horizontal space
+ *
+ * Why it might lose:
+ *   - 64 px total height (40 + 24) costs 20 px of canvas vs the default 44 px
+ *   - The meta strip can read as noise when the workflow is idle
+ *
+ * Imported only by `WorkflowHeader.stories.tsx` for side-by-side review.
+ */
+import type { ReactNode } from "react";
+import { type DropdownMenuItem } from "../../DropdownMenu";
+export interface WorkflowHeaderTieredProps {
+    name: ReactNode;
+    /** "draft" | "active" | "paused" | "error" | "running" */
+    statusTone?: "draft" | "active" | "paused" | "error" | "running";
+    onBack?: () => void;
+    parentLabel?: ReactNode;
+    /** Free-form meta line — model, step count, errors, etc. */
+    meta?: ReactNode;
+    /** Save indicator text. Consumer formats relative time on its side. */
+    saveLabel?: string;
+    saveError?: string | null;
+    isRunning?: boolean;
+    onStop?: () => void;
+    runtime?: string;
+    environment?: {
+        label: ReactNode;
+        accent?: string;
+        title?: string;
+        onClick?: () => void;
+    };
+    isConsoleOpen?: boolean;
+    onToggleConsole?: () => void;
+    menuItems?: DropdownMenuItem[];
+    className?: string;
+}
+export declare function WorkflowHeaderTiered({ name, statusTone, onBack, parentLabel, meta, saveLabel, saveError, isRunning, onStop, runtime, environment, isConsoleOpen, onToggleConsole, menuItems, className, }: WorkflowHeaderTieredProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WorkflowHeaderTiered.d.ts.map

package/dist/components/WorkflowHeader/misc/WorkflowHeaderTiered.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowHeaderTiered.d.ts","sourceRoot":"","sources":["../../../../src/components/WorkflowHeader/misc/WorkflowHeaderTiered.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAUvC,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGzE,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,SAAS,CAAC;IAChB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,CAAC;IACjE,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,4DAA4D;IAC5D,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE;QAAE,KAAK,EAAE,SAAS,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;IAC1F,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,oBAAoB,CAAC,EACnC,IAAI,EACJ,UAAoB,EACpB,MAAM,EACN,WAAoB,EACpB,IAAI,EACJ,SAAS,EACT,SAAS,EACT,SAAS,EACT,MAAM,EACN,OAAO,EACP,WAAW,EACX,aAAa,EACb,eAAe,EACf,SAAS,EACT,SAAS,GACV,EAAE,yBAAyB,2CAkH3B"}

package/dist/components/XmlViewer/XmlViewer.d.ts

@@ -1,7 +1,32 @@
 import { type ComponentPropsWithoutRef, type ReactNode } from "react";
-export interface XmlViewerProps extends Omit<ComponentPropsWithoutRef<"div">, "title" | "children"> {
+/** Result reported through `onValidate` after each edit-mode keystroke. */
+export interface XmlViewerValidationResult {
+    /** True when the current editor text passes `XMLValidator.validate`. */
+    valid: boolean;
+    /** Parse error details — only present when `valid` is false. */
+    error?: {
+        /** 1-indexed line number. */
+        line: number;
+        /** 1-indexed column number. */
+        col: number;
+        /** Human-readable error message. */
+        message: string;
+    };
+}
+export interface XmlViewerProps extends Omit<ComponentPropsWithoutRef<"div">, "title" | "children" | "onChange"> {
     /** Raw XML string. */
     data: string;
+    /**
+     * `view` (default) — read-only DOM-style tree with collapsible nodes.
+     * `edit` — CodeEditor primed with the XML text. `onChange` fires on
+     *  every keystroke; `onValidate` reports parse success/failure via
+     *  `fast-xml-parser`'s XMLValidator (line/col accurate across browsers).
+     */
+    mode?: "view" | "edit";
+    /** Fires on every keystroke in `mode='edit'` with the raw editor text. */
+    onChange?: (rawText: string) => void;
+    /** Fires after each parse attempt in `mode='edit'`. */
+    onValidate?: (result: XmlViewerValidationResult) => void;
     /** Initially expand to N levels deep. Default 2. Use `Infinity` to expand everything. */
     defaultExpandDepth?: number;
     /** Show attributes inline (vs. collapsed). Default true. */

package/dist/components/XmlViewer/XmlViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"XmlViewer.d.ts","sourceRoot":"","sources":["../../../src/components/XmlViewer/XmlViewer.tsx"],"names":[],"mappings":"AAMA,OAAO,EACL,KAAK,wBAAwB,EAG7B,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAOf,MAAM,WAAW,cACf,SAAQ,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IACnE,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sBAAsB;IACtB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAgGD;;;GAGG;AACH,eAAO,MAAM,SAAS,2GA4ErB,CAAC"}
+{"version":3,"file":"XmlViewer.d.ts","sourceRoot":"","sources":["../../../src/components/XmlViewer/XmlViewer.tsx"],"names":[],"mappings":"AAOA,OAAO,EACL,KAAK,wBAAwB,EAG7B,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AASf,2EAA2E;AAC3E,MAAM,WAAW,yBAAyB;IACxC,wEAAwE;IACxE,KAAK,EAAE,OAAO,CAAC;IACf,gEAAgE;IAChE,KAAK,CAAC,EAAE;QACN,6BAA6B;QAC7B,IAAI,EAAE,MAAM,CAAC;QACb,+BAA+B;QAC/B,GAAG,EAAE,MAAM,CAAC;QACZ,oCAAoC;QACpC,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,cACf,SAAQ,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;IAChF,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,uDAAuD;IACvD,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,yBAAyB,KAAK,IAAI,CAAC;IACzD,yFAAyF;IACzF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sBAAsB;IACtB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAgGD;;;GAGG;AACH,eAAO,MAAM,SAAS,2GAiFrB,CAAC"}

package/dist/components/XmlViewer/index.d.ts

@@ -1,2 +1,2 @@
-export { XmlViewer, type XmlViewerProps } from "./XmlViewer";
+export { XmlViewer, type XmlViewerProps, type XmlViewerValidationResult, } from "./XmlViewer";
 //# sourceMappingURL=index.d.ts.map

package/dist/components/XmlViewer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/XmlViewer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/XmlViewer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,yBAAyB,GAC/B,MAAM,aAAa,CAAC"}

package/dist/components/YamlViewer/YamlViewer.d.ts

@@ -1,7 +1,32 @@
 import { type ComponentPropsWithoutRef, type ReactNode } from "react";
-export interface YamlViewerProps extends Omit<ComponentPropsWithoutRef<"div">, "title" | "children"> {
+/** Result reported through `onValidate` after each edit-mode keystroke. */
+export interface YamlViewerValidationResult {
+    /** True when the current editor text parses as valid YAML. */
+    valid: boolean;
+    /** Parse error details — only present when `valid` is false. */
+    error?: {
+        /** 1-indexed line number from the YAML parser. */
+        line: number;
+        /** 1-indexed column number from the YAML parser. */
+        col: number;
+        /** Human-readable error message. */
+        message: string;
+    };
+}
+export interface YamlViewerProps extends Omit<ComponentPropsWithoutRef<"div">, "title" | "children" | "onChange"> {
     /** Raw YAML string OR a parsed object/array (auto-stringified to YAML). */
     data: string | unknown;
+    /**
+     * `view` (default) — read-only token-highlighted YAML tree.
+     * `edit` — CodeEditor primed with the YAML text. `onChange` fires on
+     *  every keystroke; `onValidate` reports parse success/failure with
+     *  line/col extracted from the `yaml` parser.
+     */
+    mode?: "view" | "edit";
+    /** Fires on every keystroke in `mode='edit'` with the raw editor text. */
+    onChange?: (rawText: string) => void;
+    /** Fires after each parse attempt in `mode='edit'`. */
+    onValidate?: (result: YamlViewerValidationResult) => void;
     /** Initially expand to N levels deep. Default 99 (fully expanded). */
     defaultExpandDepth?: number;
     /** Show line numbers at the gutter. Default true. */

package/dist/components/YamlViewer/YamlViewer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"YamlViewer.d.ts","sourceRoot":"","sources":["../../../src/components/YamlViewer/YamlViewer.tsx"],"names":[],"mappings":"AAMA,OAAO,EACL,KAAK,wBAAwB,EAG7B,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAOf,MAAM,WAAW,eACf,SAAQ,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IACnE,2EAA2E;IAC3E,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,sEAAsE;IACtE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sBAAsB;IACtB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AA4KD;;;GAGG;AACH,eAAO,MAAM,UAAU,4GA6OtB,CAAC"}
+{"version":3,"file":"YamlViewer.d.ts","sourceRoot":"","sources":["../../../src/components/YamlViewer/YamlViewer.tsx"],"names":[],"mappings":"AAMA,OAAO,EACL,KAAK,wBAAwB,EAG7B,KAAK,SAAS,EAMf,MAAM,OAAO,CAAC;AAUf,2EAA2E;AAC3E,MAAM,WAAW,0BAA0B;IACzC,8DAA8D;IAC9D,KAAK,EAAE,OAAO,CAAC;IACf,gEAAgE;IAChE,KAAK,CAAC,EAAE;QACN,kDAAkD;QAClD,IAAI,EAAE,MAAM,CAAC;QACb,oDAAoD;QACpD,GAAG,EAAE,MAAM,CAAC;QACZ,oCAAoC;QACpC,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,eACf,SAAQ,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,CAAC;IAChF,2EAA2E;IAC3E,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,uDAAuD;IACvD,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,0BAA0B,KAAK,IAAI,CAAC;IAC1D,sEAAsE;IACtE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qDAAqD;IACrD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iDAAiD;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wEAAwE;IACxE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,sBAAsB;IACtB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AA4KD;;;GAGG;AACH,eAAO,MAAM,UAAU,4GAkPtB,CAAC"}

package/dist/components/YamlViewer/index.d.ts

@@ -1,2 +1,2 @@
-export { YamlViewer, type YamlViewerProps } from "./YamlViewer";
+export { YamlViewer, type YamlViewerProps, type YamlViewerValidationResult, } from "./YamlViewer";
 //# sourceMappingURL=index.d.ts.map

package/dist/components/YamlViewer/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/YamlViewer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/YamlViewer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,UAAU,EACV,KAAK,eAAe,EACpB,KAAK,0BAA0B,GAChC,MAAM,cAAc,CAAC"}

package/dist/hooks/useRelativeTime.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Pure relative-time formatter — produces `just now / Xs ago / Xm ago /
+ * Xh ago` for the first 24 h, then falls back to a locale date string.
+ *
+ * @param when  Reference timestamp (`Date` or epoch ms). `null` → returns null.
+ * @param now   The "now" baseline (epoch ms). Defaults to `Date.now()`.
+ *              Pass the same `now` repeatedly to keep render output stable
+ *              across many indicators on the same surface.
+ */
+export declare function formatRelativeTime(when: Date | number | null | undefined, now?: number): string | null;
+export interface UseRelativeTimeOptions {
+    /**
+     * Tick cadence in milliseconds. Default 30 000 (30 s). Drop to 1 000
+     * for second-resolution indicators (e.g. a live "uploading"
+     * countdown); raise to 60 000+ for slow-changing meta lines.
+     */
+    intervalMs?: number;
+}
+/**
+ * Live relative-time string. Re-renders the host every `intervalMs`
+ * (default 30 s) so the displayed value stays current without the
+ * consumer wiring a timer.
+ *
+ * @param date     Timestamp (`Date` or epoch ms). `null` → returns null.
+ * @param options  Optional config — see {@link UseRelativeTimeOptions}.
+ */
+export declare function useRelativeTime(date: Date | number | null | undefined, options?: UseRelativeTimeOptions): string | null;
+//# sourceMappingURL=useRelativeTime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useRelativeTime.d.ts","sourceRoot":"","sources":["../../src/hooks/useRelativeTime.ts"],"names":[],"mappings":"AA0BA;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACtC,GAAG,GAAE,MAAmB,GACvB,MAAM,GAAG,IAAI,CAWf;AAED,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EACtC,OAAO,GAAE,sBAA2B,GACnC,MAAM,GAAG,IAAI,CAaf"}

package/dist/hooks/useWorkflowRuntime.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Pure runtime formatter. Use this for static durations (a finished run's
+ * total time, a CSV cell, an exported report). For live ticking strings
+ * use {@link useWorkflowRuntime}.
+ *
+ * - Sub-hour runs render as `MM:SS` (two-digit minutes + seconds).
+ * - One-hour-and-over runs render as `H:MM:SS` (hour-prefixed).
+ * - Negative inputs clamp to 0.
+ */
+export declare function formatWorkflowRuntime(ms: number): string;
+/**
+ * Live runtime counter — re-renders the host component once per second
+ * while `active` is true. Returns `null` when paused so consumers can
+ * render an idle placeholder.
+ *
+ * @param startedAt  Run start time (`Date` or epoch ms). `null` / undefined → returns null.
+ * @param active     Drives ticking. False stops the interval and returns null.
+ */
+export declare function useWorkflowRuntime(startedAt: Date | number | null | undefined, active: boolean): string | null;
+//# sourceMappingURL=useWorkflowRuntime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useWorkflowRuntime.d.ts","sourceRoot":"","sources":["../../src/hooks/useWorkflowRuntime.ts"],"names":[],"mappings":"AA2BA;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAOxD;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAC3C,MAAM,EAAE,OAAO,GACd,MAAM,GAAG,IAAI,CAef"}