@aceshooting/lyra-ui 1.2.0 → 2.0.0

package/dist/components/thinking-panel/thinking-panel.d.ts

@@ -0,0 +1,121 @@
+import { type TemplateResult, type PropertyValues } from 'lit';
+import { LyraElement } from '../../internal/lyra-element.js';
+export type ThinkingPanelMode = 'live' | 'post-hoc';
+export interface ThinkingPanelToggleDetail {
+    expanded: boolean;
+}
+/**
+ * `<lyra-thinking-panel>` — a collapsible panel for an AI agent's
+ * intermediate reasoning/"thinking" transcript, kept visually and
+ * semantically distinct from its final response. Same collapsible
+ * header-button-plus-region shape as `<lyra-source-list>`; the default slot
+ * is entirely free-form (a consumer-composed `<lyra-streaming-text>`,
+ * `<lyra-markdown>`, or plain text) — this component has no dependency on
+ * either and imposes no structure on what's slotted.
+ *
+ * `mode` (`'live'` while reasoning is actively streaming in, `'post-hoc'`
+ * once it's complete and being reviewed after the fact) drives two concrete
+ * behavior differences, not just a styling hook:
+ * - **Header hint.** While `duration-ms` is unset, `'live'` shows a pulsing
+ *   "Thinking…" placeholder in `[part="duration"]`; `'post-hoc'` shows
+ *   nothing there instead (a finished review with no known duration has
+ *   nothing useful to say in that slot). Once `duration-ms` is set, both
+ *   modes show the same static `"Thought for …"` text — a `'post-hoc'`
+ *   consumer that captured a duration is free to supply it too.
+ * - **Auto-scroll.** Only `'live'` mode auto-follows new content appended to
+ *   the default slot while `expanded` (see below); `'post-hoc'` never
+ *   scrolls on its own, since reviewing finished reasoning is expected to
+ *   start from the top like reading any other completed document. This
+ *   library otherwise defaults to *not* editorializing about a host's data
+ *   (see `<lyra-empty>`'s plain-`description` stance), but scroll position
+ *   is presentation, not data, so this one behavior difference earns its
+ *   keep rather than being left as a bare visual/semantic hint the host
+ *   would have to reimplement identically itself.
+ *
+ * Live-mode auto-scroll ("stick to bottom") is the classic chat-transcript
+ * convention: while `mode="live"` and `expanded`, new content keeps the
+ * panel scrolled to its latest line — *unless* the user has manually
+ * scrolled up to (re-)read earlier content, in which case their position is
+ * never yanked away from them. This is tracked continuously via a `scroll`
+ * listener on `[part="body"]` (not recomputed from the mutation itself,
+ * which necessarily observes the DOM only *after* it has already changed):
+ * every user-driven scroll records whether the body was left within
+ * `NEAR_BOTTOM_PX` of its own max scroll position, and only a mutation that
+ * arrives while that's still true triggers a follow-up scroll-to-bottom.
+ * Opening an already-`'live'` panel (or one that later becomes `'live'`)
+ * always resets this to "anchored" and jumps to the latest content, the same
+ * way a chat app's own transcript does when you re-open it.
+ *
+ * New content is detected via a `MutationObserver` on this element's own
+ * light DOM (`childList`+`subtree`+`characterData`) rather than the default
+ * slot's `slotchange` event, because `slotchange` only fires when the set of
+ * top-level assigned nodes changes — never for a text node mutating *inside*
+ * an already-slotted element, which is the more likely shape for streamed
+ * reasoning (a consumer appending chunks to an existing node's `textContent`
+ * rather than re-slotting a whole new element per token). The one thing this
+ * can't see is a mutation entirely inside a slotted custom element's own
+ * shadow root (e.g. a `<lyra-markdown>` re-rendering its shadow tree after a
+ * `content` property change) — Shadow DOM encapsulation blocks that by
+ * design, and there is no way for this component to reach across that
+ * boundary. A slotted element whose *own* internal updates should drive this
+ * panel's auto-scroll needs to append/mutate visible light-DOM text itself
+ * (as `<lyra-streaming-text>` is expected to), or the host can call this
+ * panel's own `scrollToBottom()` directly.
+ *
+ * `aria-controls` linking the header to the body region uses `nextId()`
+ * (`../../internal/a11y.js`) for a collision-safe id, the same convention
+ * `<lyra-source-list>` and `<lyra-widget>` already establish for every
+ * toggle-controls-region pairing in this library.
+ *
+ * @customElement lyra-thinking-panel
+ * @slot - The reasoning/thinking content.
+ * @event lyra-toggle - The header was activated, expanding or collapsing the
+ * panel. `detail: { expanded }` — same event name and shape as
+ * `<lyra-source-list>`'s own `lyra-toggle`.
+ * @csspart base - The outer container.
+ * @csspart header - The clickable header (`<button>`) toggling `expanded`.
+ * @csspart label - The `label` text.
+ * @csspart duration - The formatted duration / "Thinking…" placeholder, when shown.
+ * @csspart toggle - The chevron indicator inside the header.
+ * @csspart body - The wrapper around the default slot, `hidden` while collapsed.
+ */
+export declare class LyraThinkingPanel extends LyraElement {
+    static styles: import("lit").CSSResultGroup[];
+    /** Header text. */
+    label: string;
+    /** Whether the reasoning transcript is currently shown. Starts collapsed,
+     *  matching `<lyra-source-list>`'s default -- a consumer running `'live'`
+     *  reasoning sets this `true` itself to stream it in view as it arrives. */
+    expanded: boolean;
+    /** `'live'` while reasoning is actively streaming in right now; `'post-hoc'`
+     *  once it's complete and being reviewed after the fact. See the class doc
+     *  for the concrete behavior differences this drives. */
+    mode: ThinkingPanelMode;
+    /** How long the reasoning took, in milliseconds, once known. Omitted
+     *  entirely (nothing rendered in `'post-hoc'`, a pulsing placeholder in
+     *  `'live'`) while unset. */
+    durationMs?: number;
+    private readonly bodyId;
+    private contentObserver?;
+    private scrollRafId?;
+    private stickToBottom;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    protected updated(changed: PropertyValues): void;
+    /** Scrolls the body to its current bottom immediately (no smooth-scroll
+     *  animation, deliberately -- see onContentMutated()'s rAF-coalescing
+     *  comment for why an instant jump reads better than a stack of competing
+     *  smooth scrolls under a fast token stream). Safe to call directly, e.g.
+     *  from a host that wants to force a jump-to-latest action of its own. */
+    scrollToBottom(): void;
+    private onScroll;
+    private onContentMutated;
+    private toggle;
+    private get durationDisplay();
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lyra-thinking-panel': LyraThinkingPanel;
+    }
+}

package/dist/components/thinking-panel/thinking-panel.js

@@ -0,0 +1,235 @@
+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 } from 'lit/decorators.js';
+import { LyraElement } from '../../internal/lyra-element.js';
+import { defineElement } from '../../internal/prefix.js';
+import { nextId } from '../../internal/a11y.js';
+import { chevronIcon } from '../../internal/icons.js';
+import { styles } from './thinking-panel.styles.js';
+/** "Close enough to the body's own max scroll position to count as anchored
+ *  there" -- comfortably larger than one line of streamed text, so a user
+ *  who has barely nudged the scrollbar while reading the latest line isn't
+ *  mistaken for having deliberately scrolled away to read earlier content. */
+const NEAR_BOTTOM_PX = 48;
+/** `820` -> `"820ms"`; `1500` -> `"1.5s"`; `2000` -> `"2s"`. Identical
+ *  algorithm to lyra-tool-call-chip's and lyra-tool-result-dialog's own
+ *  `formatDuration` -- duplicated rather than imported (three independent,
+ *  separately-consumable components) but kept in lockstep so the same
+ *  elapsed time reads identically everywhere it's shown in this library. */
+function formatDuration(ms) {
+    if (!Number.isFinite(ms) || ms < 1000) {
+        return `${Math.round(Math.max(0, ms))}ms`;
+    }
+    const seconds = ms / 1000;
+    const rounded = Math.round(seconds * 10) / 10;
+    return `${Number.isInteger(rounded) ? rounded.toFixed(0) : rounded.toFixed(1)}s`;
+}
+/**
+ * `<lyra-thinking-panel>` — a collapsible panel for an AI agent's
+ * intermediate reasoning/"thinking" transcript, kept visually and
+ * semantically distinct from its final response. Same collapsible
+ * header-button-plus-region shape as `<lyra-source-list>`; the default slot
+ * is entirely free-form (a consumer-composed `<lyra-streaming-text>`,
+ * `<lyra-markdown>`, or plain text) — this component has no dependency on
+ * either and imposes no structure on what's slotted.
+ *
+ * `mode` (`'live'` while reasoning is actively streaming in, `'post-hoc'`
+ * once it's complete and being reviewed after the fact) drives two concrete
+ * behavior differences, not just a styling hook:
+ * - **Header hint.** While `duration-ms` is unset, `'live'` shows a pulsing
+ *   "Thinking…" placeholder in `[part="duration"]`; `'post-hoc'` shows
+ *   nothing there instead (a finished review with no known duration has
+ *   nothing useful to say in that slot). Once `duration-ms` is set, both
+ *   modes show the same static `"Thought for …"` text — a `'post-hoc'`
+ *   consumer that captured a duration is free to supply it too.
+ * - **Auto-scroll.** Only `'live'` mode auto-follows new content appended to
+ *   the default slot while `expanded` (see below); `'post-hoc'` never
+ *   scrolls on its own, since reviewing finished reasoning is expected to
+ *   start from the top like reading any other completed document. This
+ *   library otherwise defaults to *not* editorializing about a host's data
+ *   (see `<lyra-empty>`'s plain-`description` stance), but scroll position
+ *   is presentation, not data, so this one behavior difference earns its
+ *   keep rather than being left as a bare visual/semantic hint the host
+ *   would have to reimplement identically itself.
+ *
+ * Live-mode auto-scroll ("stick to bottom") is the classic chat-transcript
+ * convention: while `mode="live"` and `expanded`, new content keeps the
+ * panel scrolled to its latest line — *unless* the user has manually
+ * scrolled up to (re-)read earlier content, in which case their position is
+ * never yanked away from them. This is tracked continuously via a `scroll`
+ * listener on `[part="body"]` (not recomputed from the mutation itself,
+ * which necessarily observes the DOM only *after* it has already changed):
+ * every user-driven scroll records whether the body was left within
+ * `NEAR_BOTTOM_PX` of its own max scroll position, and only a mutation that
+ * arrives while that's still true triggers a follow-up scroll-to-bottom.
+ * Opening an already-`'live'` panel (or one that later becomes `'live'`)
+ * always resets this to "anchored" and jumps to the latest content, the same
+ * way a chat app's own transcript does when you re-open it.
+ *
+ * New content is detected via a `MutationObserver` on this element's own
+ * light DOM (`childList`+`subtree`+`characterData`) rather than the default
+ * slot's `slotchange` event, because `slotchange` only fires when the set of
+ * top-level assigned nodes changes — never for a text node mutating *inside*
+ * an already-slotted element, which is the more likely shape for streamed
+ * reasoning (a consumer appending chunks to an existing node's `textContent`
+ * rather than re-slotting a whole new element per token). The one thing this
+ * can't see is a mutation entirely inside a slotted custom element's own
+ * shadow root (e.g. a `<lyra-markdown>` re-rendering its shadow tree after a
+ * `content` property change) — Shadow DOM encapsulation blocks that by
+ * design, and there is no way for this component to reach across that
+ * boundary. A slotted element whose *own* internal updates should drive this
+ * panel's auto-scroll needs to append/mutate visible light-DOM text itself
+ * (as `<lyra-streaming-text>` is expected to), or the host can call this
+ * panel's own `scrollToBottom()` directly.
+ *
+ * `aria-controls` linking the header to the body region uses `nextId()`
+ * (`../../internal/a11y.js`) for a collision-safe id, the same convention
+ * `<lyra-source-list>` and `<lyra-widget>` already establish for every
+ * toggle-controls-region pairing in this library.
+ *
+ * @customElement lyra-thinking-panel
+ * @slot - The reasoning/thinking content.
+ * @event lyra-toggle - The header was activated, expanding or collapsing the
+ * panel. `detail: { expanded }` — same event name and shape as
+ * `<lyra-source-list>`'s own `lyra-toggle`.
+ * @csspart base - The outer container.
+ * @csspart header - The clickable header (`<button>`) toggling `expanded`.
+ * @csspart label - The `label` text.
+ * @csspart duration - The formatted duration / "Thinking…" placeholder, when shown.
+ * @csspart toggle - The chevron indicator inside the header.
+ * @csspart body - The wrapper around the default slot, `hidden` while collapsed.
+ */
+export class LyraThinkingPanel extends LyraElement {
+    constructor() {
+        super(...arguments);
+        /** Header text. */
+        this.label = 'Thinking';
+        /** Whether the reasoning transcript is currently shown. Starts collapsed,
+         *  matching `<lyra-source-list>`'s default -- a consumer running `'live'`
+         *  reasoning sets this `true` itself to stream it in view as it arrives. */
+        this.expanded = false;
+        /** `'live'` while reasoning is actively streaming in right now; `'post-hoc'`
+         *  once it's complete and being reviewed after the fact. See the class doc
+         *  for the concrete behavior differences this drives. */
+        this.mode = 'live';
+        this.bodyId = nextId('thinking-panel-body');
+        // Whether the body was left within NEAR_BOTTOM_PX of its own max scroll
+        // position the last time a real (user-driven) scroll was recorded -- see
+        // onScroll(). Starts `true` so a panel that mounts already `expanded` and
+        // `mode="live"` follows its very first streamed content by default,
+        // before any scroll event has ever fired.
+        this.stickToBottom = true;
+        this.onScroll = (e) => {
+            const body = e.currentTarget;
+            this.stickToBottom = body.scrollHeight - body.scrollTop - body.clientHeight <= NEAR_BOTTOM_PX;
+        };
+        this.onContentMutated = () => {
+            if (this.mode !== 'live' || !this.expanded || !this.stickToBottom)
+                return;
+            // Coalesce to at most one scroll-to-bottom per animation frame -- a fast
+            // token stream can otherwise fire many mutation records in quick
+            // succession, each individually cheap to react to but wasteful (and
+            // visually janky) to lay out for separately.
+            if (this.scrollRafId !== undefined)
+                return;
+            this.scrollRafId = requestAnimationFrame(() => {
+                this.scrollRafId = undefined;
+                this.scrollToBottom();
+            });
+        };
+        this.toggle = () => {
+            this.expanded = !this.expanded;
+            this.emit('lyra-toggle', { expanded: this.expanded });
+        };
+    }
+    static { this.styles = [LyraElement.styles, styles]; }
+    connectedCallback() {
+        super.connectedCallback();
+        // Watches this element's own light-DOM subtree, not the shadow-DOM
+        // [part="body"] wrapper -- the slotted reasoning content actually lives
+        // here, as this element's children. See the class doc for why this
+        // (rather than `slotchange`) is what detects streamed-in content.
+        this.contentObserver = new MutationObserver(this.onContentMutated);
+        this.contentObserver.observe(this, { childList: true, subtree: true, characterData: true });
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        this.contentObserver?.disconnect();
+        this.contentObserver = undefined;
+        if (this.scrollRafId !== undefined) {
+            cancelAnimationFrame(this.scrollRafId);
+            this.scrollRafId = undefined;
+        }
+    }
+    updated(changed) {
+        if (changed.has('expanded') && this.expanded && this.mode === 'live') {
+            // Opening a live panel always jumps straight to the newest content and
+            // resets the sticky-bottom flag, so it starts following again
+            // regardless of wherever the body happened to be scrolled the last
+            // time it was collapsed. `'post-hoc'` deliberately skips this -- see
+            // the class doc's Auto-scroll section.
+            this.stickToBottom = true;
+            this.scrollToBottom();
+        }
+    }
+    /** Scrolls the body to its current bottom immediately (no smooth-scroll
+     *  animation, deliberately -- see onContentMutated()'s rAF-coalescing
+     *  comment for why an instant jump reads better than a stack of competing
+     *  smooth scrolls under a fast token stream). Safe to call directly, e.g.
+     *  from a host that wants to force a jump-to-latest action of its own. */
+    scrollToBottom() {
+        const body = this.renderRoot.querySelector('[part="body"]');
+        if (!body)
+            return;
+        body.scrollTop = body.scrollHeight;
+    }
+    get durationDisplay() {
+        if (this.durationMs != null && Number.isFinite(this.durationMs)) {
+            return { text: `Thought for ${formatDuration(this.durationMs)}`, pending: false };
+        }
+        return this.mode === 'live' ? { text: 'Thinking…', pending: true } : null;
+    }
+    render() {
+        const duration = this.durationDisplay;
+        return html `
+      <div part="base">
+        <button
+          part="header"
+          type="button"
+          aria-expanded=${this.expanded ? 'true' : 'false'}
+          aria-controls=${this.bodyId}
+          @click=${this.toggle}
+        >
+          <span part="toggle" aria-hidden="true">${chevronIcon()}</span>
+          <span part="label">${this.label}</span>
+          ${duration
+            ? html `<span part="duration" ?data-pending=${duration.pending}
+                >${duration.pending ? html `<span class="pending-dot" aria-hidden="true"></span>` : nothing}${duration.text}</span
+              >`
+            : nothing}
+        </button>
+        <div part="body" id=${this.bodyId} ?hidden=${!this.expanded} @scroll=${this.onScroll}>
+          <slot></slot>
+        </div>
+      </div>
+    `;
+    }
+}
+__decorate([
+    property()
+], LyraThinkingPanel.prototype, "label", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], LyraThinkingPanel.prototype, "expanded", void 0);
+__decorate([
+    property({ reflect: true })
+], LyraThinkingPanel.prototype, "mode", void 0);
+__decorate([
+    property({ type: Number, attribute: 'duration-ms' })
+], LyraThinkingPanel.prototype, "durationMs", void 0);
+defineElement('thinking-panel', LyraThinkingPanel);

package/dist/components/thinking-panel/thinking-panel.styles.d.ts

@@ -0,0 +1 @@
+export declare const styles: import("lit").CSSResult;

package/dist/components/thinking-panel/thinking-panel.styles.js

@@ -0,0 +1,117 @@
+import { css } from 'lit';
+// Shares its collapsible-header shape (border/radius/hover/focus-ring, the
+// rotating chevron) with lyra-source-list's styles almost verbatim -- the two
+// are siblings in the same "collapsible region behind a header button"
+// family and are meant to sit comfortably next to each other in a message.
+export const styles = css `
+  :host {
+    display: block;
+    /* Consumer-overridable cap on how tall the reasoning transcript grows
+       before it scrolls internally, e.g. via ::part(body) or by overriding
+       this custom property directly -- not exposed as a component prop
+       since it's a pure layout knob, not something a template branches on. */
+    --lyra-thinking-panel-max-block-size: 16rem;
+  }
+  [part='base'] {
+    border: 1px solid var(--lyra-color-border);
+    border-radius: var(--lyra-radius);
+    background: var(--lyra-color-surface);
+    overflow: hidden;
+  }
+  [part='header'] {
+    display: flex;
+    align-items: center;
+    gap: var(--lyra-space-xs);
+    inline-size: 100%;
+    padding: var(--lyra-space-s) var(--lyra-space-m);
+    border: none;
+    background: none;
+    color: var(--lyra-color-text);
+    font: inherit;
+    font-weight: 600;
+    font-size: 0.875rem;
+    text-align: start;
+    cursor: pointer;
+  }
+  [part='header']:hover {
+    background: var(--lyra-color-brand-quiet);
+    color: var(--lyra-color-brand);
+  }
+  [part='header']:focus-visible {
+    outline: var(--lyra-focus-ring-width) solid var(--lyra-focus-ring-color);
+    outline-offset: calc(-1 * var(--lyra-focus-ring-offset));
+  }
+  [part='toggle'] {
+    display: inline-flex;
+    flex: 0 0 auto;
+    transition: transform var(--lyra-transition-fast);
+  }
+  :host([expanded]) [part='toggle'] {
+    transform: rotate(90deg);
+  }
+  [part='label'] {
+    flex: 1 1 auto;
+    min-inline-size: 0;
+    overflow: hidden;
+    text-overflow: ellipsis;
+    white-space: nowrap;
+  }
+  [part='duration'] {
+    display: inline-flex;
+    align-items: center;
+    gap: 0.35em;
+    flex: 0 0 auto;
+    font-weight: 400;
+    font-size: 0.8125rem;
+    color: var(--lyra-color-text-quiet);
+  }
+  /* Actively streaming with no duration yet -- a full-opacity brand-colored
+     label plus a separate decorative pulse dot, deliberately *not* animating
+     the text's own opacity the way lyra-typing-indicator's pulse variant
+     does: that dims it well below AA contrast for part of every cycle, fine
+     for a purely decorative shape but not for text carrying real content
+     ("Thinking…"). */
+  [part='duration'][data-pending] {
+    color: var(--lyra-color-brand);
+  }
+  .pending-dot {
+    inline-size: 0.375rem;
+    block-size: 0.375rem;
+    border-radius: 50%;
+    background: currentColor;
+    animation: lyra-thinking-panel-pulse var(--lyra-transition-base) infinite;
+  }
+  @keyframes lyra-thinking-panel-pulse {
+    0%,
+    100% {
+      opacity: 0.4;
+      transform: scale(0.85);
+    }
+    50% {
+      opacity: 1;
+      transform: scale(1);
+    }
+  }
+  [part='body'] {
+    max-block-size: var(--lyra-thinking-panel-max-block-size);
+    overflow-y: auto;
+    padding: var(--lyra-space-m);
+    border-block-start: 1px solid var(--lyra-color-border);
+    color: var(--lyra-color-text-quiet);
+    font-size: 0.875rem;
+    line-height: 1.5;
+  }
+  [part='body'][hidden] {
+    display: none;
+  }
+  @media (prefers-reduced-motion: reduce) {
+    [part='toggle'] {
+      transition: none !important;
+    }
+    .pending-dot {
+      animation: none !important;
+      opacity: 1;
+      transform: none;
+    }
+  }
+`;

package/dist/components/toast/toast-item.d.ts

@@ -36,6 +36,7 @@ export declare class LyraToastItem extends LyraElement {
     private showRafId?;
     private showAnimTimer?;
     private hideAnimTimer?;
+    private resolvePendingHide?;
     private hovering;
     private focused;
     private hiding;

package/dist/components/toast/toast-item.js

@@ -76,8 +76,12 @@ export class LyraToastItem extends LyraElement {
             if (!isFinite(this.duration) || this.duration <= 0)
                 return;
             const remaining = this.duration - this.elapsedMs;
-            if (remaining <= 0)
+            // A duration shortened below the already-elapsed time must hide promptly,
+            // not silently never schedule anything.
+            if (remaining <= 0) {
+                void this.hide();
                 return;
+            }
             this.startedAt = performance.now();
             this.timer = window.setTimeout(() => this.hide(), remaining);
         };
@@ -124,11 +128,12 @@ export class LyraToastItem extends LyraElement {
         // `elapsedMs`/`duration` are re-read fresh every time the timer is
         // (re)scheduled, so a `duration` change while paused (hovering/focused)
         // or before the timer has ever started needs no action here -- the next
-        // resumeTimer()/startTimer() call already picks up the new value. Only a
-        // timer that's actively counting down right now is running against a
-        // setTimeout scheduled for the *old* duration, so that's the one case
-        // that needs an explicit reschedule.
-        if (changed.has('duration') && this.timerStarted && this.timer !== undefined) {
+        // resumeTimer()/startTimer() call already picks up the new value.
+        // Re-evaluate on any duration change once the show sequence has started,
+        // not only while a timer is already actively counting down -- this also
+        // covers duration flipping from disabled (0/Infinity) back to a positive
+        // value, which previously never had `this.timer !== undefined` to gate on.
+        if (changed.has('duration') && this.timerStarted && !this.hovering && !this.focused) {
             this.pauseTimer();
             this.resumeTimer();
         }
@@ -136,6 +141,11 @@ export class LyraToastItem extends LyraElement {
     firstUpdated() {
         this.showRafId = requestAnimationFrame(() => {
             this.showRafId = undefined;
+            // hide() may have already run synchronously before this frame fired
+            // (e.g. a caller creates the toast and immediately dismisses it) --
+            // don't resurrect the show sequence on top of an already-hiding item.
+            if (this.hiding)
+                return;
             this.setAttribute('data-visible', '');
             this.emit('lyra-show');
             this.showAnimTimer = window.setTimeout(() => {
@@ -158,6 +168,12 @@ export class LyraToastItem extends LyraElement {
         if (this.hideAnimTimer !== undefined) {
             clearTimeout(this.hideAnimTimer);
             this.hideAnimTimer = undefined;
+            // hide()'s own promise is awaiting this timer firing to resolve() --
+            // a disconnect (e.g. the toast's ancestor is removed from the DOM,
+            // bypassing this.remove()) must still let that promise settle instead
+            // of leaving it pending forever.
+            this.resolvePendingHide?.();
+            this.resolvePendingHide = undefined;
         }
         this.clearTimer();
     }
@@ -203,11 +219,20 @@ export class LyraToastItem extends LyraElement {
         this.emit('lyra-hide');
         this.removeAttribute('data-visible');
         await new Promise((resolve) => {
+            this.resolvePendingHide = resolve;
             this.hideAnimTimer = window.setTimeout(() => {
                 this.hideAnimTimer = undefined;
+                this.resolvePendingHide = undefined;
                 resolve();
             }, animMs());
         });
+        // An out-of-band disconnect (see disconnectedCallback) resolves this same
+        // promise so callers awaiting hide() never hang, but it does so *without*
+        // this having reached its normal completion -- guard against then still
+        // emitting a "finished hiding" event (and redundantly calling remove())
+        // for a node that's already been torn down some other way.
+        if (!this.isConnected)
+            return;
         this.emit('lyra-after-hide');
         this.remove();
     }