@aceshooting/lyra-ui 2.0.0 → 2.2.0

package/dist/components/toast/toast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.js","sourceRoot":"","sources":["../../../src/components/toast/toast.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,iBAAiB,CAAC;AACzB,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC"}

package/dist/components/toast/toast.styles.d.ts

@@ -1 +1,2 @@
 export declare const styles: import("lit").CSSResult;
+//# sourceMappingURL=toast.styles.d.ts.map

package/dist/components/toast/toast.styles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.styles.d.ts","sourceRoot":"","sources":["../../../src/components/toast/toast.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,yBAoDlB,CAAC"}

package/dist/components/toast/toast.styles.js

@@ -2,18 +2,21 @@ import { css } from 'lit';
 export const styles = css `
   :host {
     position: fixed;
-    z-index: 9999;
+    z-index: var(--lyra-layer-toast);
     display: block;
-    --gap: var(--lyra-space-s);
-    --width: 28rem;
+    --lyra-toast-gap: var(--lyra-space-s);
+    --lyra-toast-width: var(--lyra-size-28rem);
     pointer-events: none;
   }
   [part='stack'] {
     display: flex;
     flex-direction: column;
-    gap: var(--gap);
-    inline-size: var(--width);
-    max-inline-size: calc(100vw - (var(--lyra-space-l) * 2));
+    gap: var(--lyra-toast-gap);
+    inline-size: var(--lyra-toast-width);
+    max-inline-size: calc(
+      100vw - (var(--lyra-space-l) * 2) - var(--lyra-safe-area-inline-start) -
+        var(--lyra-safe-area-inline-end)
+    );
   }
   ::slotted(*) {
     pointer-events: auto;
@@ -23,29 +26,30 @@ export const styles = css `
     flex-direction: column-reverse;
   }
   :host([placement='top-start']) {
-    inset-block-start: var(--lyra-space-l);
-    inset-inline-start: var(--lyra-space-l);
+    inset-block-start: max(var(--lyra-space-l), var(--lyra-safe-area-top));
+    inset-inline-start: max(var(--lyra-space-l), var(--lyra-safe-area-inline-start));
   }
   :host([placement='top-end']) {
-    inset-block-start: var(--lyra-space-l);
-    inset-inline-end: var(--lyra-space-l);
+    inset-block-start: max(var(--lyra-space-l), var(--lyra-safe-area-top));
+    inset-inline-end: max(var(--lyra-space-l), var(--lyra-safe-area-inline-end));
   }
   :host([placement='top-center']) {
-    inset-block-start: var(--lyra-space-l);
+    inset-block-start: max(var(--lyra-space-l), var(--lyra-safe-area-top));
     inset-inline: 0;
     margin-inline: auto;
   }
   :host([placement='bottom-start']) {
-    inset-block-end: var(--lyra-space-l);
-    inset-inline-start: var(--lyra-space-l);
+    inset-block-end: max(var(--lyra-space-l), var(--lyra-safe-area-bottom));
+    inset-inline-start: max(var(--lyra-space-l), var(--lyra-safe-area-inline-start));
   }
   :host([placement='bottom-end']) {
-    inset-block-end: var(--lyra-space-l);
-    inset-inline-end: var(--lyra-space-l);
+    inset-block-end: max(var(--lyra-space-l), var(--lyra-safe-area-bottom));
+    inset-inline-end: max(var(--lyra-space-l), var(--lyra-safe-area-inline-end));
   }
   :host([placement='bottom-center']) {
-    inset-block-end: var(--lyra-space-l);
+    inset-block-end: max(var(--lyra-space-l), var(--lyra-safe-area-bottom));
     inset-inline: 0;
     margin-inline: auto;
   }
 `;
+//# sourceMappingURL=toast.styles.js.map

package/dist/components/toast/toast.styles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.styles.js","sourceRoot":"","sources":["../../../src/components/toast/toast.styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,MAAM,CAAC,MAAM,MAAM,GAAG,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDxB,CAAC"}

package/dist/components/toast/toaster.d.ts

@@ -24,3 +24,4 @@ export interface ToastHandle {
  * @example toast({ message: 'Deleted', variant: 'danger', action: { label: 'Undo', onClick: undo } });
  */
 export declare function toast(input: ToastOptions | string): ToastHandle;
+//# sourceMappingURL=toaster.d.ts.map

package/dist/components/toast/toaster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toaster.d.ts","sourceRoot":"","sources":["../../../src/components/toast/toaster.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,kBAAkB,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,YAAY,CAAC;AAuBpB,MAAM,WAAW,YAAa,SAAQ,kBAAkB;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,yDAAyD;IACzD,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAA;KAAE,CAAC;CACpE;AAED,MAAM,WAAW,WAAW;IAC1B,0CAA0C;IAC1C,IAAI,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7B,+BAA+B;IAC/B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,GAAG,WAAW,CA8B/D"}

package/dist/components/toast/toaster.js

@@ -27,8 +27,17 @@ function getRegion(placement = DEFAULT_PLACEMENT) {
  */
 export function toast(input) {
     const opts = typeof input === 'string' ? { message: input } : input;
+    // An action must remain available until the user can reach it. Callers can
+    // still opt into a finite duration explicitly; the convenience API makes
+    // only the omitted-duration/action combination persistent.
+    const createOptions = {
+        variant: opts.variant,
+        duration: opts.duration ?? (opts.action ? 0 : undefined),
+        size: opts.size,
+        withIcon: opts.withIcon,
+    };
     const item = getRegion(opts.placement)
-        .create(opts.message, opts)
+        .create(opts.message, createOptions)
         .then((el) => {
         if (opts.action) {
             const btn = document.createElement('button');
@@ -46,3 +55,4 @@ export function toast(input) {
         },
     };
 }
+//# sourceMappingURL=toaster.js.map

package/dist/components/toast/toaster.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toaster.js","sourceRoot":"","sources":["../../../src/components/toast/toaster.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAgD,MAAM,YAAY,CAAC;AAErF,OAAO,YAAY,CAAC;AAEpB,MAAM,iBAAiB,GAAmB,SAAS,CAAC;AAEpD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA6B,CAAC;AAErD;;;;;GAKG;AACH,SAAS,SAAS,CAAC,SAAS,GAAmB,iBAAiB;IAC9D,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QACnC,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,YAAY,CAAc,CAAC;QAC3D,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAgBD;;;;;;GAMG;AACH,MAAM,UAAU,KAAK,CAAC,KAA4B;IAChD,MAAM,IAAI,GAAiB,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;IAClF,2EAA2E;IAC3E,yEAAyE;IACzE,2DAA2D;IAC3D,MAAM,aAAa,GAAuB;QACxC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACxD,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC;IACF,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC;SACnC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC;SACnC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE;QACX,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,GAAG,GAAG,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YAC7C,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC;YACpB,GAAG,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC;YACpC,GAAG,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;YAC9D,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC,CAAC,CAAC;IAEL,OAAO;QACL,IAAI;QACJ,OAAO,EAAE,GAAG,EAAE;YACZ,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/components/tool-approval-dialog/tool-approval-dialog.class.d.ts

@@ -0,0 +1,135 @@
+import { type TemplateResult, type PropertyValues } from 'lit';
+import { LyraElement } from '../../internal/lyra-element.js';
+import '../json-viewer/json-viewer.class.js';
+/**
+ * Reason the dialog was dismissed, forwarded as the `lyra-close` event detail
+ * -- mirrors `<lyra-dialog>`'s own `DialogCloseReason` shape. `'escape'`/
+ * `'backdrop'` come from the dialog's own built-in dismiss triggers,
+ * `'approve'`/`'deny'` from the built-in action buttons (fired in addition
+ * to, and immediately after, their own dedicated `lyra-approve`/`lyra-deny`
+ * event -- see the class doc), and any other string is whatever a caller
+ * passes to `close()` directly.
+ */
+export type ToolApprovalDialogCloseReason = 'escape' | 'backdrop' | 'approve' | 'deny' | 'api' | (string & Record<never, never>);
+/**
+ * `<lyra-tool-approval-dialog>` — a human-in-the-loop gate: presents one
+ * proposed tool/function call (`toolName` + `args`) and blocks an agent from
+ * executing it until a person explicitly approves or denies it, with an
+ * optional inline "edit the arguments before approving" step.
+ *
+ * This renders its own dialog panel rather than nesting a `<lyra-dialog>` in
+ * its shadow template. Shared overlay infrastructure coordinates stacking,
+ * focus trapping, Escape/backdrop dismissal, and focus return with every
+ * other overlay in the same document.
+ *
+ * Approve/Deny/Edit are built-in chrome (not a `footer` slot a consumer must
+ * assemble) — this component's interaction shape is fixed enough (there is
+ * exactly one correct set of actions for "approve this call") that requiring
+ * every consumer to re-build it would just be boilerplate. A `footer` slot is
+ * still offered for *supplementary* content a consumer wants alongside those
+ * buttons (e.g. a "remember this choice for this tool" checkbox) — its
+ * content renders to the start of the action row, before Deny/Edit/Approve.
+ *
+ * Editing: while `editable`, an Edit button swaps the read-only
+ * `<lyra-json-viewer>` for a plain `<textarea>` pre-filled with
+ * `JSON.stringify(args, null, 2)`. Every keystroke is re-validated with
+ * `JSON.parse` — the Approve button is `disabled` for as long as the current
+ * textarea content fails to parse, so a malformed edit can never be silently
+ * approved as either the broken text or a stale copy of the original args.
+ * The same button relabels to "Cancel" while editing; clicking it discards
+ * the draft entirely and returns to the read-only view of the *original*
+ * `args` — there is no separate "save" step independent of Approve itself.
+ * Both `editing` and any in-progress draft reset back to the read-only view
+ * every time the dialog transitions from closed to open, so a reused
+ * instance never leaks one proposal's half-finished edit into the next.
+ * `editable` flipping to `false` mid-edit does the same (see `willUpdate()`)
+ * and, if the textarea it unmounts still held focus, `updated()` refocuses
+ * Deny so the focus trap keeps engaging instead of silently letting focus
+ * fall through to the document.
+ *
+ * Initial focus deliberately does *not* land on Approve:
+ * approving a tool call is a consequential, potentially irreversible action,
+ * so a user who opens this dialog and reflexively presses Enter/Space before
+ * reading anything should deny, not approve. Deny gets the initial focus
+ * instead — the same "focus the safe action" convention a native destructive-
+ * confirmation dialog (delete, discard, etc.) typically follows for its own
+ * Cancel button — rather than the inert dialog panel, which would need an
+ * extra Tab press before *any* action is reachable at all.
+ *
+ * @customElement lyra-tool-approval-dialog
+ * @slot footer - Optional supplementary content (e.g. a "remember this
+ * choice" checkbox), rendered before the built-in Deny/Edit/Approve buttons.
+ * @event lyra-approve - The call was approved. `detail: { args }` — the
+ * current, already-parsed arguments object: the original `args` prop, or (if
+ * an edit was in progress) the user's edited-and-validated version. Always
+ * followed by `lyra-close` with reason `'approve'`.
+ * @event lyra-deny - The call was denied (no detail). Always followed by
+ * `lyra-close` with reason `'deny'`.
+ * @event lyra-close - `detail: ToolApprovalDialogCloseReason`. Fired exactly
+ * once per dismissal — via Escape, a backdrop click, the Approve/Deny
+ * buttons, or a `close()` call — so there is one consistent "this dialog is
+ * now closed" signal regardless of which path triggered it.
+ * @csspart backdrop - The full-viewport scrim behind the panel.
+ * @csspart panel - The dialog panel itself (`role="dialog"` while open).
+ * @csspart header - The wrapper around the heading.
+ * @csspart tool-name - The `toolName` text within the heading.
+ * @csspart body - The wrapper around the args view/editor.
+ * @csspart args-view - The read-only `<lyra-json-viewer>` shown while not editing.
+ * @csspart args-editor - The raw-JSON `<textarea>` shown while editing.
+ * @csspart error - The inline "invalid JSON" message, shown only while editing with unparseable content.
+ * @csspart footer - The action row wrapping the `footer` slot and the built-in buttons.
+ * @csspart deny-button - The built-in Deny button.
+ * @csspart edit-button - The built-in Edit/Cancel toggle button (only rendered while `editable`).
+ * @csspart approve-button - The built-in Approve button — `disabled` while an in-progress edit is invalid JSON.
+ */
+export interface LyraToolApprovalDialogEventMap {
+    'lyra-deny': CustomEvent<undefined>;
+}
+export declare class LyraToolApprovalDialog extends LyraElement<LyraToolApprovalDialogEventMap> {
+    static styles: import("lit").CSSResultGroup[];
+    /** Whether the dialog is open. Set this (or call `close()`) — there is no separate `show()`/`hide()` pair. */
+    open: boolean;
+    /** The proposed tool/function's name, e.g. `web_search`. Drives the heading and the dialog's accessible name. */
+    toolName: string;
+    /** The proposed call's arguments — any JSON-serializable value, rendered via `<lyra-json-viewer>` (or, while editing, stringified into the textarea). */
+    args: unknown;
+    /** Whether an "Edit" affordance is offered at all. When `false`, `args` is always shown read-only and can never be changed before approval. */
+    editable: boolean;
+    private editing;
+    /** The textarea's current raw text while editing — deliberately independent of `args` until Approve is pressed, so a malformed in-progress edit never overwrites it. */
+    private draftText;
+    /** `JSON.parse` failure message for `draftText`, or `''` while it parses cleanly. Empty string (not `undefined`) so it can drive `?hidden` directly. */
+    private draftError;
+    private releaseScrollLock?;
+    private overlay?;
+    private readonly titleId;
+    private readonly errorId;
+    protected willUpdate(changed: PropertyValues): void;
+    protected updated(changed: PropertyValues): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private activateOverlay;
+    /**
+     * Close the dialog and return focus to whatever had it before the dialog
+     * opened. `reason` is forwarded as the `lyra-close` detail — built-in
+     * triggers pass `'escape'`/`'backdrop'`/`'approve'`/`'deny'`; a consumer's
+     * own close affordance (e.g. a footer-slotted button) should call this
+     * directly with its own reason string, so every dismissal path funnels
+     * through the same event instead of the consumer having to also toggle
+     * `open` itself.
+     */
+    close(reason?: ToolApprovalDialogCloseReason): void;
+    private onBackdropClick;
+    private stringifyArgs;
+    private toggleEdit;
+    private onDraftInput;
+    private onApprove;
+    private onDeny;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lyra-tool-approval-dialog': LyraToolApprovalDialog;
+    }
+}
+//# sourceMappingURL=tool-approval-dialog.class.d.ts.map

package/dist/components/tool-approval-dialog/tool-approval-dialog.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-approval-dialog.class.d.ts","sourceRoot":"","sources":["../../../src/components/tool-approval-dialog/tool-approval-dialog.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAE9E,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAK7D,OAAO,qCAAqC,CAAC;AAE7C;;;;;;;;GAQG;AACH,MAAM,MAAM,6BAA6B,GACrC,QAAQ,GACR,UAAU,GACV,SAAS,GACT,MAAM,GACN,KAAK,GACL,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsEG;AACH,MAAM,WAAW,8BAA8B;IAC7C,WAAW,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;CACrC;AACD,qBAAa,sBAAuB,SAAQ,WAAW,CAAC,8BAA8B,CAAC;IACrF,MAAM,CAAC,MAAM,iCAAgC;IAE7C,8GAA8G;IAClE,IAAI,UAAS;IAEzD,iHAAiH;IAC3E,QAAQ,SAAM;IAEpD,yJAAyJ;IACzH,IAAI,EAAE,OAAO,CAAM;IAEnD,+IAA+I;IACnG,QAAQ,UAAQ;IAEnD,OAAO,CAAC,OAAO,CAAS;IACjC,wKAAwK;IAC/J,OAAO,CAAC,SAAS,CAAM;IAChC,wJAAwJ;IAC/I,OAAO,CAAC,UAAU,CAAM;IAEjC,OAAO,CAAC,iBAAiB,CAAC,CAAa;IACvC,OAAO,CAAC,OAAO,CAAC,CAAgB;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAChE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAEhE,SAAS,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CA2BlD;IAKD,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAqB/C;IAED,iBAAiB,IAAI,IAAI,CAOxB;IAED,oBAAoB,IAAI,IAAI,CAK3B;IAED,OAAO,CAAC,eAAe;IAevB;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,GAAE,6BAAqC,GAAG,IAAI,CAIzD;IAED,OAAO,CAAC,eAAe,CAErB;IAEF,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,UAAU,CAUhB;IAEF,OAAO,CAAC,YAAY,CASlB;IAEF,OAAO,CAAC,SAAS,CAcf;IAEF,OAAO,CAAC,MAAM,CAGZ;IAEF,MAAM,IAAI,cAAc,CA6CvB;CACF;AAGD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,2BAA2B,EAAE,sBAAsB,CAAC;KACrD;CACF"}

package/dist/components/tool-approval-dialog/tool-approval-dialog.class.js

@@ -0,0 +1,257 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { html, nothing } from 'lit';
+import { property, state } from 'lit/decorators.js';
+import { LyraElement } from '../../internal/lyra-element.js';
+import { activateOverlay } from '../../internal/overlay-manager.js';
+import { lockScroll } from '../../internal/scroll-lock.js';
+import { nextId } from '../../internal/a11y.js';
+import { styles } from './tool-approval-dialog.styles.js';
+import '../json-viewer/json-viewer.class.js';
+export class LyraToolApprovalDialog extends LyraElement {
+    constructor() {
+        super(...arguments);
+        /** Whether the dialog is open. Set this (or call `close()`) — there is no separate `show()`/`hide()` pair. */
+        this.open = false;
+        /** The proposed tool/function's name, e.g. `web_search`. Drives the heading and the dialog's accessible name. */
+        this.toolName = '';
+        /** The proposed call's arguments — any JSON-serializable value, rendered via `<lyra-json-viewer>` (or, while editing, stringified into the textarea). */
+        this.args = {};
+        /** Whether an "Edit" affordance is offered at all. When `false`, `args` is always shown read-only and can never be changed before approval. */
+        this.editable = true;
+        this.editing = false;
+        /** The textarea's current raw text while editing — deliberately independent of `args` until Approve is pressed, so a malformed in-progress edit never overwrites it. */
+        this.draftText = '';
+        /** `JSON.parse` failure message for `draftText`, or `''` while it parses cleanly. Empty string (not `undefined`) so it can drive `?hidden` directly. */
+        this.draftError = '';
+        this.titleId = nextId('tool-approval-dialog-title');
+        this.errorId = nextId('tool-approval-dialog-error');
+        this.onBackdropClick = () => {
+            this.overlay?.dismissBackdrop();
+        };
+        this.toggleEdit = () => {
+            if (this.editing) {
+                this.editing = false;
+                this.draftText = '';
+                this.draftError = '';
+            }
+            else {
+                this.editing = true;
+                this.draftText = this.stringifyArgs();
+                this.draftError = '';
+            }
+        };
+        this.onDraftInput = (e) => {
+            const value = e.target.value;
+            this.draftText = value;
+            try {
+                JSON.parse(value);
+                this.draftError = '';
+            }
+            catch (err) {
+                this.draftError = err instanceof Error ? err.message : 'Invalid JSON.';
+            }
+        };
+        this.onApprove = () => {
+            let currentArgs = this.args;
+            if (this.editing) {
+                // The Approve button is disabled whenever draftError is non-empty, so
+                // this should always succeed -- the try/catch is defense-in-depth
+                // against a state desync rather than an expected path.
+                try {
+                    currentArgs = JSON.parse(this.draftText);
+                }
+                catch {
+                    return;
+                }
+            }
+            this.emit('lyra-approve', { args: currentArgs });
+            this.close('approve');
+        };
+        this.onDeny = () => {
+            this.emit('lyra-deny');
+            this.close('deny');
+        };
+    }
+    static { this.styles = [LyraElement.styles, styles]; }
+    willUpdate(changed) {
+        if (changed.has('open')) {
+            if (this.open) {
+                this.releaseScrollLock ??= lockScroll(this.ownerDocument);
+                this.activateOverlay();
+                // Every open starts fresh in the read-only view -- a reused instance
+                // must never carry a half-finished edit (or its error state) over
+                // from whatever the previous proposal was.
+                this.editing = false;
+                this.draftText = '';
+                this.draftError = '';
+            }
+            else {
+                this.releaseScrollLock?.();
+                this.releaseScrollLock = undefined;
+                this.overlay?.deactivate();
+                this.overlay = undefined;
+            }
+        }
+        // A consumer flipping editable off mid-edit (e.g. a policy change
+        // pushed while this dialog happens to be open) must not leave an
+        // unreachable edit UI on screen with no Edit/Cancel button left to
+        // dismiss it.
+        if (changed.has('editable') && !this.editable && this.editing) {
+            this.editing = false;
+            this.draftText = '';
+            this.draftError = '';
+        }
+    }
+    // Runs after render (not willUpdate) so [part="panel"]/[part="deny-button"]
+    // have already landed in the DOM before the focus calls below can rely on
+    // them -- mirrors lyra-dialog's identical ordering rationale.
+    updated(changed) {
+        if (changed.has('open') && this.open) {
+            this.overlay?.focusInitial();
+            return;
+        }
+        if (changed.has('editing')) {
+            if (this.editing) {
+                // Entering edit mode is a deliberate request to start typing --
+                // steering focus into the textarea beats leaving it on the Edit
+                // button the click already left it on.
+                this.shadowRoot?.querySelector('[part="args-editor"]')?.focus();
+            }
+            else if (this.open && !this.shadowRoot?.activeElement) {
+                // Reached when editing was turned off some way other than clicking
+                // Cancel (e.g. `editable` flipping to false while the textarea held
+                // focus, in willUpdate above) -- the textarea that held focus was
+                // just unmounted without anything else claiming it, which would
+                // otherwise drop focus to <body> and silently stop the Tab trap
+                // from engaging. Refocus a stable target inside the panel instead.
+                this.shadowRoot?.querySelector('[part="deny-button"]')?.focus();
+            }
+        }
+    }
+    connectedCallback() {
+        super.connectedCallback();
+        if (this.hasUpdated && this.open) {
+            this.releaseScrollLock ??= lockScroll(this.ownerDocument);
+            this.activateOverlay();
+            queueMicrotask(() => this.overlay?.focusInitial());
+        }
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        this.releaseScrollLock?.();
+        this.releaseScrollLock = undefined;
+        this.overlay?.suspend();
+    }
+    activateOverlay() {
+        if (this.overlay?.isActive()) {
+            this.overlay.resume();
+            return;
+        }
+        this.overlay = activateOverlay({
+            host: this,
+            panel: () => this.shadowRoot?.querySelector('[part="panel"]') ?? null,
+            onEscape: () => this.close('escape'),
+            onBackdrop: () => this.close('backdrop'),
+            preferredInitialFocus: () => this.shadowRoot?.querySelector('[part="deny-button"]') ?? null,
+        });
+    }
+    /**
+     * Close the dialog and return focus to whatever had it before the dialog
+     * opened. `reason` is forwarded as the `lyra-close` detail — built-in
+     * triggers pass `'escape'`/`'backdrop'`/`'approve'`/`'deny'`; a consumer's
+     * own close affordance (e.g. a footer-slotted button) should call this
+     * directly with its own reason string, so every dismissal path funnels
+     * through the same event instead of the consumer having to also toggle
+     * `open` itself.
+     */
+    close(reason = 'api') {
+        if (!this.open)
+            return;
+        this.open = false;
+        this.emit('lyra-close', reason);
+    }
+    stringifyArgs() {
+        try {
+            // JSON.stringify(undefined, ...) returns the *value* undefined, not a
+            // string -- the ?? covers that alongside the try/catch's circular-
+            // reference case, so the textarea always opens with real text.
+            return JSON.stringify(this.args, null, 2) ?? 'null';
+        }
+        catch {
+            return 'null';
+        }
+    }
+    render() {
+        const hasError = this.editing && this.draftError.length > 0;
+        return html `
+      <div part="backdrop" @click=${this.onBackdropClick}></div>
+      <div
+        part="panel"
+        role=${this.open ? 'dialog' : nothing}
+        aria-modal=${this.open ? 'true' : nothing}
+        aria-labelledby=${this.titleId}
+        tabindex="-1"
+      >
+        <div part="header">
+          <h2 id=${this.titleId}>Approve <span part="tool-name">${this.toolName || 'tool'}</span> call?</h2>
+        </div>
+        <div part="body">
+          ${this.editing
+            ? html `
+                <textarea
+                  part="args-editor"
+                  spellcheck="false"
+                  autocomplete="off"
+                  aria-label="Tool call arguments (JSON)"
+                  aria-invalid=${hasError ? 'true' : 'false'}
+                  aria-describedby=${hasError ? this.errorId : nothing}
+                  .value=${this.draftText}
+                  @input=${this.onDraftInput}
+                ></textarea>
+                <p part="error" id=${this.errorId} role="alert" ?hidden=${!hasError}>${this.draftError}</p>
+              `
+            : html `<lyra-json-viewer part="args-view" .data=${this.args}></lyra-json-viewer>`}
+        </div>
+        <div part="footer">
+          <slot name="footer"></slot>
+          <button part="deny-button" type="button" @click=${this.onDeny}>Deny</button>
+          ${this.editable
+            ? html `<button part="edit-button" type="button" @click=${this.toggleEdit}>
+                ${this.editing ? 'Cancel' : 'Edit'}
+              </button>`
+            : nothing}
+          <button part="approve-button" type="button" ?disabled=${hasError} @click=${this.onApprove}>
+            Approve
+          </button>
+        </div>
+      </div>
+    `;
+    }
+}
+__decorate([
+    property({ type: Boolean, reflect: true })
+], LyraToolApprovalDialog.prototype, "open", void 0);
+__decorate([
+    property({ attribute: 'tool-name' })
+], LyraToolApprovalDialog.prototype, "toolName", void 0);
+__decorate([
+    property({ attribute: false })
+], LyraToolApprovalDialog.prototype, "args", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], LyraToolApprovalDialog.prototype, "editable", void 0);
+__decorate([
+    state()
+], LyraToolApprovalDialog.prototype, "editing", void 0);
+__decorate([
+    state()
+], LyraToolApprovalDialog.prototype, "draftText", void 0);
+__decorate([
+    state()
+], LyraToolApprovalDialog.prototype, "draftError", void 0);
+//# sourceMappingURL=tool-approval-dialog.class.js.map

package/dist/components/tool-approval-dialog/tool-approval-dialog.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-approval-dialog.class.js","sourceRoot":"","sources":["../../../src/components/tool-approval-dialog/tool-approval-dialog.class.ts"],"names":[],"mappings":"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"}