@octaviaflow/core 3.0.18-beta.0 → 3.0.18-beta.10

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

@@ -0,0 +1,130 @@
+/**
+ * WorkflowHeader — the strip rendered above a workflow editor canvas.
+ *
+ * Two-zone layout (left identity cluster · right action cluster). The save
+ * indicator lives at the END of the left cluster, after the title — close
+ * to the workflow it refers to, not floating in the middle.
+ *
+ *   ┌──────────────────────────────────────────────────────────────────────┐
+ *   │ ‹ Workflows / ● Name · Saved 12s ago         Stop · 00:12 · Draft ▎ ⏏ ⋮ │
+ *   │ ──────────────────────────────────────────────────────────────────── │ ← shimmer while running
+ *   └──────────────────────────────────────────────────────────────────────┘
+ *
+ * Polish layers (research-backed):
+ *   1. **Status dot** (6-7 px coloured ●) replaces the heavier Badge as
+ *      the primary identity-status signal.
+ *   2. **Breadcrumb-style back** (`‹ Workflows /`) replaces the naked
+ *      back-icon button.
+ *   3. **Bottom hairline progress stripe** — visible ONLY during execution.
+ *      Single biggest perceived-quality lift, no vertical cost.
+ *   4. **Tabular runtime counter** (`00:00:12`) inline with Stop.
+ *
+ * Size variants:
+ *   - `md` (default) — 44 px, TopBar parity. Standard editor height.
+ *   - `sm` — 36 px compact. For embedded editors / dense workspaces.
+ *
+ * Env chip is consumer-driven: the consumer supplies the `accent` colour
+ * (any CSS colour or token) to drive the left-border accent. The DS does
+ * NOT bake in environment names (production/staging/dev) — those live in
+ * the consumer's backend.
+ */
+import type { ReactNode } from "react";
+import { type DropdownMenuItem, type DropdownMenuProps } from "../DropdownMenu";
+export type WorkflowHeaderSize = "sm" | "md";
+export type WorkflowHeaderSaveState = "idle" | "saving" | "success" | "error";
+/** Semantic tone for the status dot. Use `running` while an execution is
+ *  in flight (paired with `isRunning`). */
+export type WorkflowHeaderStatusTone = "draft" | "active" | "running" | "paused" | "error";
+export interface WorkflowHeaderEnvironment {
+    /** Label inside the chip (consumer-supplied — usually from backend). */
+    label: ReactNode;
+    /** Left-border accent. Accepts any CSS colour or token reference (e.g.
+     *  `"var(--ods-status-failed)"`, `"#0F62FE"`). Omit for no accent. */
+    accent?: string;
+    /** Tooltip — useful for "Coming soon" placeholders. */
+    title?: string;
+    /** Click handler. Omit to render a non-interactive placeholder chip. */
+    onClick?: () => void;
+}
+export interface WorkflowHeaderProps {
+    /** Workflow name shown after the status dot. */
+    name: ReactNode;
+    /** Status tone — drives the colour of the dot. Defaults to "draft". */
+    statusTone?: WorkflowHeaderStatusTone;
+    /** Click handler for the back affordance. Omit to hide it. */
+    onBack?: () => void;
+    /** Parent label rendered in the breadcrumb when `onBack` is set
+     *  (e.g. "Workflows"). Defaults to "Back". */
+    parentLabel?: ReactNode;
+    saveState?: WorkflowHeaderSaveState;
+    /** Timestamp of the last successful save — used to format "Saved Xs ago". */
+    lastSavedAt?: Date | number | null;
+    /** Optional error message — surfaced as `title` on the failed indicator. */
+    saveError?: string | null;
+    /** When true, the Stop button is mounted and the bottom progress stripe
+     *  animates. The status dot auto-tints to `running` if `statusTone` is
+     *  left at its default. */
+    isRunning?: boolean;
+    /** Click handler for the primary Run button (rendered while !isRunning).
+     *  Run / Stop form a complementary pair — Run shows while idle, Stop
+     *  shows while running. Pass both for the standard editor pattern. */
+    onRun?: () => void;
+    /** Click handler for the Stop button (rendered while isRunning). */
+    onStop?: () => void;
+    /** Optional run-start timestamp. When supplied while `isRunning`, a
+     *  tabular runtime counter appears next to Stop (`00:00:12`). */
+    runStartedAt?: Date | number | null;
+    /** Environment chip — consumer-driven (backend supplies). Omit to hide. */
+    environment?: WorkflowHeaderEnvironment;
+    /** Console toggle handler. Pressed state syncs to `isConsoleOpen`. */
+    isConsoleOpen?: boolean;
+    onToggleConsole?: () => void;
+    /** When true, the console toggle renders even outside an active run —
+     *  meaning the consumer has logs from a previous run that the user can
+     *  re-open. Visibility rule: `onToggleConsole && (isRunning || consoleHasLogs)`.
+     *  Default false → the console button stays hidden on a fresh / idle
+     *  editor with no logs to show. */
+    consoleHasLogs?: boolean;
+    /**
+     * Simple API — items shown inside the default ⋮ DropdownMenu. Pass
+     * `[]` or omit to hide the menu entirely. Most consumers should use
+     * just this; the props below are for advanced configuration.
+     */
+    menuItems?: DropdownMenuItem[];
+    /** Aria-label for the trigger. Defaults to "More actions". */
+    menuLabel?: string;
+    /**
+     * Override the default trigger element (`⋮` icon button). Useful for
+     * "Actions ▾" text triggers, custom icons, or anchoring the menu off a
+     * different glyph. Must render an element that DropdownMenu can use as
+     * a trigger (button or div with onClick handler).
+     */
+    menuTrigger?: ReactNode;
+    /**
+     * Pass-through to the underlying DropdownMenu for advanced config —
+     * align, side, matchTriggerWidth, closeOnOutsideClick, closeOnEscape,
+     * triggerClassName, className. Everything DropdownMenu accepts except
+     * `items`, `trigger`, and `aria-label` (which the header owns).
+     */
+    menuProps?: Omit<DropdownMenuProps, "items" | "trigger" | "aria-label">;
+    /**
+     * Total slot replacement. When provided, this node is rendered in the
+     * overflow-menu position instead of the default DropdownMenu — even if
+     * `menuItems` is also set. Use this when you need a fundamentally
+     * different overflow surface (e.g. a custom Popover, a chained menu,
+     * or a Sheet trigger).
+     */
+    menu?: ReactNode;
+    /** Rendered at the END of the left zone (after the save indicator). */
+    leftSlot?: ReactNode;
+    /** Rendered BEFORE the right-zone action cluster. */
+    rightSlot?: ReactNode;
+    /** Size variant. `md` = 44 px (TopBar parity, default). `sm` = 36 px
+     *  (compact, for embedded editors). */
+    size?: WorkflowHeaderSize;
+    /** Render the loading skeleton — useful while workflow metadata loads. */
+    loading?: boolean;
+    className?: string;
+}
+export declare function WorkflowHeader({ name, statusTone, onBack, parentLabel, saveState, lastSavedAt, saveError, isRunning, onRun, onStop, runStartedAt, environment, isConsoleOpen, onToggleConsole, consoleHasLogs, menuItems, menuLabel, menuTrigger, menuProps, menu, leftSlot, rightSlot, size, loading, className, }: WorkflowHeaderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WorkflowHeader.d.ts.map

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

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

package/dist/components/WorkflowHeader/WorkflowHeaderExpanded.d.ts

@@ -0,0 +1,69 @@
+/**
+ * WorkflowHeaderExpanded — two-row variant of WorkflowHeader for editors
+ * that need always-visible run metadata under the identity row.
+ *
+ * Same visual rhythm as `WorkflowHeader` (status dot, breadcrumb back,
+ * bottom progress shimmer, tabular runtime counter, Run/Stop pair). The
+ * meta line carries free-form text supplied by the consumer — typically
+ * "GPT-4o · 2 steps · 0 errors · last run 3m ago".
+ *
+ *   ┌──────────────────────────────────────────────────────────────────────┐
+ *   │ ‹ Workflows / ● Name                  [▶ Run] · Env ▎ Console ⋮ │  ← 40 px
+ *   │ GPT-4o · 2 steps · 0 errors · last run 3m ago · Saved 12s ago        │  ← 24 px
+ *   │ ──────────────────────────────────────────────────────────────────── │  ← shimmer while running
+ *   └──────────────────────────────────────────────────────────────────────┘
+ *
+ * Use this variant when:
+ *   - Run metadata (model, step count, errors, last-run time) is part of
+ *     the workflow's identity for the user — not a hidden detail.
+ *   - The editor surface can spare 20 px of canvas height for the meta
+ *     row.
+ *
+ * Otherwise prefer the default `WorkflowHeader` (44 px, info inline).
+ */
+import type { ReactNode } from "react";
+import { type DropdownMenuItem, type DropdownMenuProps } from "../DropdownMenu";
+export interface WorkflowHeaderExpandedProps {
+    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;
+    onRun?: () => void;
+    onStop?: () => void;
+    /** Run-start timestamp. When supplied while `isRunning`, the header
+     *  ticks a live tabular-figure runtime counter (`00:12`) next to Stop.
+     *  Internally uses the public `useWorkflowRuntime` hook so consumers
+     *  can render the same string in other surfaces. */
+    runStartedAt?: Date | number | null;
+    /** Override the auto-computed runtime string. Use this only when you
+     *  need a non-default format (e.g. server-provided cumulative duration).
+     *  When omitted, the value derived from `runStartedAt` wins. */
+    runtime?: string;
+    environment?: {
+        label: ReactNode;
+        accent?: string;
+        title?: string;
+        onClick?: () => void;
+    };
+    isConsoleOpen?: boolean;
+    onToggleConsole?: () => void;
+    /** Visibility gate for the console toggle — same semantics as
+     *  WorkflowHeader. The toggle renders when running OR when this is
+     *  true (consumer reports past logs exist). Defaults to false. */
+    consoleHasLogs?: boolean;
+    menuItems?: DropdownMenuItem[];
+    menuLabel?: string;
+    menuTrigger?: ReactNode;
+    menuProps?: Omit<DropdownMenuProps, "items" | "trigger" | "aria-label">;
+    menu?: ReactNode;
+    className?: string;
+}
+export declare function WorkflowHeaderExpanded({ name, statusTone, onBack, parentLabel, meta, saveLabel, saveError, isRunning, onRun, onStop, runStartedAt, runtime: runtimeOverride, environment, isConsoleOpen, onToggleConsole, consoleHasLogs, menuItems, menuLabel, menuTrigger, menuProps, menu, className, }: WorkflowHeaderExpandedProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WorkflowHeaderExpanded.d.ts.map

package/dist/components/WorkflowHeader/WorkflowHeaderExpanded.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowHeaderExpanded.d.ts","sourceRoot":"","sources":["../../../src/components/WorkflowHeader/WorkflowHeaderExpanded.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAWvC,OAAO,EAAgB,KAAK,gBAAgB,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAG9F,MAAM,WAAW,2BAA2B;IAC1C,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;IAI1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB;;;wDAGoD;IACpD,YAAY,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAAC;IACpC;;oEAEgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,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;;sEAEkE;IAClE,cAAc,CAAC,EAAE,OAAO,CAAC;IAGzB,SAAS,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,SAAS,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,OAAO,GAAG,SAAS,GAAG,YAAY,CAAC,CAAC;IACxE,IAAI,CAAC,EAAE,SAAS,CAAC;IAEjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,sBAAsB,CAAC,EACrC,IAAI,EACJ,UAAoB,EACpB,MAAM,EACN,WAAoB,EACpB,IAAI,EACJ,SAAS,EACT,SAAS,EACT,SAAS,EACT,KAAK,EACL,MAAM,EACN,YAAY,EACZ,OAAO,EAAE,eAAe,EACxB,WAAW,EACX,aAAa,EACb,eAAe,EACf,cAAc,EACd,SAAS,EACT,SAA0B,EAC1B,WAAW,EACX,SAAS,EACT,IAAI,EACJ,SAAS,GACV,EAAE,2BAA2B,2CAqJ7B"}

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

@@ -0,0 +1,3 @@
+export { WorkflowHeader, type WorkflowHeaderEnvironment, type WorkflowHeaderProps, type WorkflowHeaderSaveState, type WorkflowHeaderStatusTone, } from "./WorkflowHeader";
+export { WorkflowHeaderExpanded, type WorkflowHeaderExpandedProps, } from "./WorkflowHeaderExpanded";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/WorkflowHeader/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,KAAK,yBAAyB,EAC9B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,GAC9B,MAAM,kBAAkB,CAAC;AAI1B,OAAO,EACL,sBAAsB,EACtB,KAAK,2BAA2B,GACjC,MAAM,0BAA0B,CAAC"}

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

@@ -0,0 +1,40 @@
+/**
+ * WorkflowHeaderCentered (DRAFT — not exported from the package).
+ *
+ * Symmetric three-zone layout with the workflow identity centered. Left
+ * holds navigation, right holds actions, center holds the title + status
+ * + tiny save indicator. Reads like a document tab strip — works well
+ * when the workflow IS the surface, with no other competing chrome.
+ *
+ *   ┌──────────────────────────────────────────────────────────────────────┐
+ *   │ ‹ Workflows         ● HTTP Order Sync · Saved 12s ago        Stop ⏏ ⋮ │
+ *   │ ──────────────────────────────────────────────────────────────────── │
+ *   └──────────────────────────────────────────────────────────────────────┘
+ *
+ * Why it might win:
+ *   - The workflow name is the most important content — centering it
+ *     gives it visual weight without making it physically larger.
+ *   - Symmetry reads as polished and document-focused.
+ *
+ * Why it might lose:
+ *   - Centered layouts feel "modal-ish" — less editor, more document.
+ *   - On narrow viewports the center can collide with the side zones.
+ */
+import type { ReactNode } from "react";
+import { type DropdownMenuItem } from "../../DropdownMenu";
+export interface WorkflowHeaderCenteredProps {
+    name: ReactNode;
+    statusTone?: "draft" | "active" | "paused" | "error" | "running";
+    onBack?: () => void;
+    parentLabel?: ReactNode;
+    saveLabel?: string;
+    saveError?: string | null;
+    isRunning?: boolean;
+    onStop?: () => void;
+    isConsoleOpen?: boolean;
+    onToggleConsole?: () => void;
+    menuItems?: DropdownMenuItem[];
+    className?: string;
+}
+export declare function WorkflowHeaderCentered({ name, statusTone, onBack, parentLabel, saveLabel, saveError, isRunning, onStop, isConsoleOpen, onToggleConsole, menuItems, className, }: WorkflowHeaderCenteredProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WorkflowHeaderCentered.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowHeaderCentered.d.ts","sourceRoot":"","sources":["../../../../src/components/WorkflowHeader/misc/WorkflowHeaderCentered.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAQvC,OAAO,EAAgB,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGzE,MAAM,WAAW,2BAA2B;IAC1C,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,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,sBAAsB,CAAC,EACrC,IAAI,EACJ,UAAoB,EACpB,MAAM,EACN,WAAyB,EACzB,SAAS,EACT,SAAS,EACT,SAAS,EACT,MAAM,EACN,aAAa,EACb,eAAe,EACf,SAAS,EACT,SAAS,GACV,EAAE,2BAA2B,2CAoF7B"}

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,22 +1,52 @@
-import { type ReactNode } from "react";
-export interface XmlViewerProps {
+import { type ComponentPropsWithoutRef, type ReactNode } from "react";
+/** 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;
-    /** Initially expand to N levels deep. Default 2. */
+    /**
+     * `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. */
     showAttributes?: boolean;
+    /** Show a copy button on hover for each element (copies the serialized subtree). */
+    copyable?: boolean;
     /** Optional title. */
     title?: ReactNode;
     /** Optional status pill next to title. */
     status?: ReactNode;
     /** Maximum length for text node display. */
     truncateAt?: number;
-    className?: string;
+    /** Fixed body height — number → pixels, string → any CSS length. */
+    height?: number | string;
+    /** Upper bound on body height; ignored when `height` is set. */
+    maxHeight?: number | string;
 }
 /**
  * Read-only XML viewer with collapsible elements, attribute chips, and
- * type-tinted text/CDATA/comment nodes.
+ * type-tinted text / CDATA / comment / processing-instruction nodes.
  */
-export declare function XmlViewer({ data, defaultExpandDepth, showAttributes, title, status, truncateAt, className, }: XmlViewerProps): import("react/jsx-runtime").JSX.Element;
+export declare const XmlViewer: import("react").ForwardRefExoticComponent<XmlViewerProps & import("react").RefAttributes<HTMLDivElement>>;
 //# sourceMappingURL=XmlViewer.d.ts.map

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":"AACA,OAAO,EAAE,KAAK,SAAS,EAAqB,MAAM,OAAO,CAAC;AAG1D,MAAM,WAAW,cAAc;IAC7B,sBAAsB;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4DAA4D;IAC5D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sBAAsB;IACtB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,0CAA0C;IAC1C,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,4CAA4C;IAC5C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA2DD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,EACxB,IAAI,EACJ,kBAAsB,EACtB,cAAqB,EACrB,KAAK,EACL,MAAM,EACN,UAAgB,EAChB,SAAS,GACV,EAAE,cAAc,2CA+BhB"}
+{"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"}