@aceshooting/lyra-ui 2.1.0 → 2.2.0

package/dist/components/live-region/live-region.class.d.ts

@@ -0,0 +1,91 @@
+import { type TemplateResult, type PropertyValues } from 'lit';
+import { LyraElement } from '../../internal/lyra-element.js';
+import { type AnnounceOptions } from '../../internal/announcer.js';
+export type LiveRegionMode = 'polite' | 'assertive';
+/**
+ * `<lyra-live-region>` — a visually-hidden ARIA live region that throttles
+ * and coalesces announcements instead of relaying every call verbatim.
+ *
+ * Naive live regions plus token-by-token streaming text (a chat response, a
+ * progress readout, ...) equals screen-reader spam: every incremental chunk
+ * gets announced. This component wraps `Announcer`
+ * (`../../internal/announcer.js`) so callers can fire `announce()` as often
+ * as they like — only the latest text within each `throttle-ms` window
+ * actually reaches assistive tech, and a `{ force: true }` call (e.g. once a
+ * stream ends) always lands immediately regardless of any window in
+ * progress.
+ *
+ * A consumer typically mounts one `<lyra-live-region>` per page/surface
+ * (much like `<lyra-toast>` is one region per placement — see
+ * `../toast/toaster.ts`) and keeps a reference to call `announce()` from
+ * application code or a parent component:
+ *
+ * @example
+ * ```html
+ * <!-- once, near the root of a chat surface's shell -->
+ * <lyra-live-region id="chat-live" mode="polite"></lyra-live-region>
+ * ```
+ * ```ts
+ * const live = document.getElementById('chat-live') as LyraLiveRegion;
+ *
+ * // streaming tokens: fine to call on every chunk, only the trailing state lands
+ * live.announce(`${partialText} …`);
+ *
+ * // stream finished: always announced, even mid-throttle-window
+ * live.announce('Response complete', { force: true });
+ * ```
+ *
+ * A parent Lit component would instead hold the reference via `@query`:
+ * ```ts
+ * @query('lyra-live-region') private liveRegion!: LyraLiveRegion;
+ * ```
+ * and is exactly what later components in this family (a stream-status
+ * indicator, a tool-call chip's status transitions, a chat message's
+ * streaming state) are expected to do rather than hand-rolling their own
+ * `aria-live` element.
+ *
+ * @customElement lyra-live-region
+ * @csspart region - The visually-hidden element carrying `role`/`aria-live`.
+ */
+export declare class LyraLiveRegion extends LyraElement {
+    static styles: import("lit").CSSResultGroup[];
+    /** `polite` (role="status") waits for the user to be idle; `assertive`
+     *  (role="alert") interrupts. Mirrors native `aria-live` semantics.
+     *
+     *  `write()` also applies `role`/`aria-live` imperatively at announce time
+     *  (not only through this property's template binding) so a caller that
+     *  sets `mode` and immediately force-announces in the same synchronous
+     *  turn -- e.g. a stream-status transition -- gets the new urgency and the
+     *  new text landing together, rather than the text beating Lit's
+     *  re-render to the DOM. */
+    mode: LiveRegionMode;
+    /** Throttle window in ms — see `Announcer` in `internal/announcer.ts`. */
+    throttleMs: number;
+    private readonly announcer;
+    private lastWritten;
+    private regionEl?;
+    private reannounceHandle?;
+    private reannounceView?;
+    private pendingWrite?;
+    constructor();
+    protected updated(changed: PropertyValues): void;
+    firstUpdated(): void;
+    disconnectedCallback(): void;
+    /**
+     * Queue `text` for announcement. Calls arriving within `throttle-ms` of
+     * the first call in a burst collapse to a single announcement of the
+     * latest text; pass `{ force: true }` to bypass the window and flush
+     * immediately (e.g. for a final/terminal message that must not be
+     * dropped).
+     */
+    announce(text: string, options?: AnnounceOptions): void;
+    private write;
+    private cancelReannounce;
+    render(): TemplateResult;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'lyra-live-region': LyraLiveRegion;
+    }
+}
+//# sourceMappingURL=live-region.class.d.ts.map

package/dist/components/live-region/live-region.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-region.class.d.ts","sourceRoot":"","sources":["../../../src/components/live-region/live-region.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAErE,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAE7D,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9E,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,MAAM,CAAC,MAAM,iCAAwC;IAErD;;;;;;;;gCAQ4B;IACC,IAAI,EAAE,cAAc,CAAY;IAE7D,0EAA0E;IACpB,UAAU,SAAO;IAEvE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IAMtC,OAAO,CAAC,WAAW,CAAM;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAc;IAC/B,OAAO,CAAC,gBAAgB,CAAC,CAA2C;IACpE,OAAO,CAAC,cAAc,CAAC,CAAS;IAOhC,OAAO,CAAC,YAAY,CAAC,CAAS;IAE9B,cASC;IAED,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAI/C;IAED,YAAY,IAAI,IAAI,CAOnB;IAED,oBAAoB,IAAI,IAAI,CAK3B;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAEtD;IAED,OAAO,CAAC,KAAK;IAgDb,OAAO,CAAC,gBAAgB;IAOxB,MAAM,IAAI,cAAc,CASvB;CACF;AAGD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,kBAAkB,EAAE,cAAc,CAAC;KACpC;CACF"}

package/dist/components/live-region/live-region.class.js

@@ -0,0 +1,188 @@
+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 } from 'lit';
+import { property } from 'lit/decorators.js';
+import { LyraElement } from '../../internal/lyra-element.js';
+import { srOnly } from '../../internal/a11y.js';
+import { Announcer } from '../../internal/announcer.js';
+import { styles } from './live-region.styles.js';
+/**
+ * `<lyra-live-region>` — a visually-hidden ARIA live region that throttles
+ * and coalesces announcements instead of relaying every call verbatim.
+ *
+ * Naive live regions plus token-by-token streaming text (a chat response, a
+ * progress readout, ...) equals screen-reader spam: every incremental chunk
+ * gets announced. This component wraps `Announcer`
+ * (`../../internal/announcer.js`) so callers can fire `announce()` as often
+ * as they like — only the latest text within each `throttle-ms` window
+ * actually reaches assistive tech, and a `{ force: true }` call (e.g. once a
+ * stream ends) always lands immediately regardless of any window in
+ * progress.
+ *
+ * A consumer typically mounts one `<lyra-live-region>` per page/surface
+ * (much like `<lyra-toast>` is one region per placement — see
+ * `../toast/toaster.ts`) and keeps a reference to call `announce()` from
+ * application code or a parent component:
+ *
+ * @example
+ * ```html
+ * <!-- once, near the root of a chat surface's shell -->
+ * <lyra-live-region id="chat-live" mode="polite"></lyra-live-region>
+ * ```
+ * ```ts
+ * const live = document.getElementById('chat-live') as LyraLiveRegion;
+ *
+ * // streaming tokens: fine to call on every chunk, only the trailing state lands
+ * live.announce(`${partialText} …`);
+ *
+ * // stream finished: always announced, even mid-throttle-window
+ * live.announce('Response complete', { force: true });
+ * ```
+ *
+ * A parent Lit component would instead hold the reference via `@query`:
+ * ```ts
+ * @query('lyra-live-region') private liveRegion!: LyraLiveRegion;
+ * ```
+ * and is exactly what later components in this family (a stream-status
+ * indicator, a tool-call chip's status transitions, a chat message's
+ * streaming state) are expected to do rather than hand-rolling their own
+ * `aria-live` element.
+ *
+ * @customElement lyra-live-region
+ * @csspart region - The visually-hidden element carrying `role`/`aria-live`.
+ */
+export class LyraLiveRegion extends LyraElement {
+    static { this.styles = [LyraElement.styles, styles, srOnly]; }
+    constructor() {
+        super();
+        /** `polite` (role="status") waits for the user to be idle; `assertive`
+         *  (role="alert") interrupts. Mirrors native `aria-live` semantics.
+         *
+         *  `write()` also applies `role`/`aria-live` imperatively at announce time
+         *  (not only through this property's template binding) so a caller that
+         *  sets `mode` and immediately force-announces in the same synchronous
+         *  turn -- e.g. a stream-status transition -- gets the new urgency and the
+         *  new text landing together, rather than the text beating Lit's
+         *  re-render to the DOM. */
+        this.mode = 'polite';
+        /** Throttle window in ms — see `Announcer` in `internal/announcer.ts`. */
+        this.throttleMs = 500;
+        // The live region's own last-written text. Tracked separately from
+        // whatever Lit thinks the DOM looks like because `write()` mutates
+        // `regionEl.textContent` directly (outside Lit's template bindings) --
+        // see `write()` for why.
+        this.lastWritten = '';
+        // Built in the constructor (not a class-field initializer) so it reads
+        // `this.throttleMs` only after that property's own field initializer
+        // has already run and set the declared default.
+        this.announcer = new Announcer({
+            throttleMs: this.throttleMs,
+            onFlush: (text) => this.write(text),
+        });
+    }
+    updated(changed) {
+        if (changed.has('throttleMs')) {
+            this.announcer.throttleMs = this.throttleMs;
+        }
+    }
+    firstUpdated() {
+        this.regionEl = this.renderRoot.querySelector('[part="region"]') ?? undefined;
+        if (this.pendingWrite !== undefined) {
+            const text = this.pendingWrite;
+            this.pendingWrite = undefined;
+            this.write(text);
+        }
+    }
+    disconnectedCallback() {
+        super.disconnectedCallback();
+        this.announcer.cancel();
+        this.pendingWrite = undefined;
+        this.cancelReannounce();
+    }
+    /**
+     * Queue `text` for announcement. Calls arriving within `throttle-ms` of
+     * the first call in a burst collapse to a single announcement of the
+     * latest text; pass `{ force: true }` to bypass the window and flush
+     * immediately (e.g. for a final/terminal message that must not be
+     * dropped).
+     */
+    announce(text, options) {
+        this.announcer.announce(text, options);
+    }
+    write(text) {
+        const region = this.regionEl;
+        if (!region) {
+            this.pendingWrite = text;
+            return;
+        }
+        // A same-text reannounce frame still in flight is now stale the moment
+        // any new write() call comes in -- if it fired later it would clobber
+        // whatever text this call is about to land with the older, already-
+        // superseded string. Cancel it up front so at most one reannounce is
+        // ever pending and it can never overwrite a newer announcement.
+        this.cancelReannounce();
+        const assertive = this.mode === 'assertive';
+        if (text === this.lastWritten) {
+            // Screen readers announce a live region on text-content *change* --
+            // re-writing the identical string is otherwise a silent no-op to
+            // assistive tech. Clearing first and re-setting on the next frame
+            // (rather than in the same task) gives the DOM an actual empty ->
+            // populated transition to observe instead of a same-tick clear+set
+            // that can coalesce into nothing ever appearing to change.
+            //
+            // role/aria-live are set imperatively here (not left to Lit's
+            // template binding) so a caller that sets `mode` and immediately
+            // force-announces -- e.g. stream-status's announceTransition() --
+            // gets the new urgency in the same synchronous operation as the text,
+            // rather than racing Lit's async re-render.
+            region.setAttribute('role', assertive ? 'alert' : 'status');
+            region.setAttribute('aria-live', assertive ? 'assertive' : 'polite');
+            region.textContent = '';
+            const view = region.ownerDocument.defaultView;
+            if (!view) {
+                region.textContent = text;
+                return;
+            }
+            this.reannounceView = view;
+            this.reannounceHandle = view.requestAnimationFrame(() => {
+                this.reannounceHandle = undefined;
+                this.reannounceView = undefined;
+                region.textContent = text;
+            });
+        }
+        else {
+            region.setAttribute('role', assertive ? 'alert' : 'status');
+            region.setAttribute('aria-live', assertive ? 'assertive' : 'polite');
+            region.textContent = text;
+        }
+        this.lastWritten = text;
+    }
+    cancelReannounce() {
+        if (this.reannounceHandle === undefined)
+            return;
+        this.reannounceView?.cancelAnimationFrame(this.reannounceHandle);
+        this.reannounceHandle = undefined;
+        this.reannounceView = undefined;
+    }
+    render() {
+        const assertive = this.mode === 'assertive';
+        return html `<div
+      part="region"
+      class="sr-only"
+      role=${assertive ? 'alert' : 'status'}
+      aria-live=${assertive ? 'assertive' : 'polite'}
+      aria-atomic="true"
+    ></div>`;
+    }
+}
+__decorate([
+    property({ reflect: true })
+], LyraLiveRegion.prototype, "mode", void 0);
+__decorate([
+    property({ type: Number, attribute: 'throttle-ms' })
+], LyraLiveRegion.prototype, "throttleMs", void 0);
+//# sourceMappingURL=live-region.class.js.map

package/dist/components/live-region/live-region.class.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-region.class.js","sourceRoot":"","sources":["../../../src/components/live-region/live-region.class.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,IAAI,EAA4C,MAAM,KAAK,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAwB,MAAM,6BAA6B,CAAC;AAC9E,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AAIjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,OAAO,cAAe,SAAQ,WAAW;aACtC,WAAM,GAAG,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,AAAvC,CAAwC;IAkCrD;QACE,KAAK,EAAE,CAAC;QAjCV;;;;;;;;oCAQ4B;QACC,SAAI,GAAmB,QAAQ,CAAC;QAE7D,0EAA0E;QACpB,eAAU,GAAG,GAAG,CAAC;QAIvE,mEAAmE;QACnE,mEAAmE;QACnE,uEAAuE;QACvE,yBAAyB;QACjB,gBAAW,GAAG,EAAE,CAAC;QAcvB,uEAAuE;QACvE,qEAAqE;QACrE,gDAAgD;QAChD,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC;YAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;SACpC,CAAC,CAAC;IACL,CAAC;IAES,OAAO,CAAC,OAAuB;QACvC,IAAI,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,YAAY;QACV,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAc,iBAAiB,CAAC,IAAI,SAAS,CAAC;QAC3F,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACpC,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC;YAC/B,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,oBAAoB;QAClB,KAAK,CAAC,oBAAoB,EAAE,CAAC;QAC7B,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QACxB,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAC9B,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED;;;;;;OAMG;IACH,QAAQ,CAAC,IAAY,EAAE,OAAyB;QAC9C,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAEO,KAAK,CAAC,IAAY;QACxB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YACzB,OAAO;QACT,CAAC;QACD,uEAAuE;QACvE,sEAAsE;QACtE,oEAAoE;QACpE,qEAAqE;QACrE,gEAAgE;QAChE,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC;QAC5C,IAAI,IAAI,KAAK,IAAI,CAAC,WAAW,EAAE,CAAC;YAC9B,oEAAoE;YACpE,iEAAiE;YACjE,kEAAkE;YAClE,kEAAkE;YAClE,mEAAmE;YACnE,2DAA2D;YAC3D,EAAE;YACF,8DAA8D;YAC9D,iEAAiE;YACjE,kEAAkE;YAClE,sEAAsE;YACtE,4CAA4C;YAC5C,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAC5D,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACrE,MAAM,CAAC,WAAW,GAAG,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC;YAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC;gBAC1B,OAAO;YACT,CAAC;YACD,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;YAC3B,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,qBAAqB,CAAC,GAAG,EAAE;gBACtD,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;gBAClC,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;gBAChC,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC;YAC5B,CAAC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAC5D,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACrE,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAEO,gBAAgB;QACtB,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS;YAAE,OAAO;QAChD,IAAI,CAAC,cAAc,EAAE,oBAAoB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACjE,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC;QAClC,IAAI,CAAC,cAAc,GAAG,SAAS,CAAC;IAClC,CAAC;IAED,MAAM;QACJ,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC;QAC5C,OAAO,IAAI,CAAA;;;aAGF,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;kBACzB,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ;;YAExC,CAAC;IACX,CAAC;CACF;AApI8B;IAA5B,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;4CAAiC;AAGP;IAArD,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;kDAAkB"}

package/dist/components/live-region/live-region.d.ts

@@ -1,90 +1,2 @@
-import { type TemplateResult, type PropertyValues } from 'lit';
-import { LyraElement } from '../../internal/lyra-element.js';
-import { type AnnounceOptions } from '../../internal/announcer.js';
-export type LiveRegionMode = 'polite' | 'assertive';
-/**
- * `<lyra-live-region>` — a visually-hidden ARIA live region that throttles
- * and coalesces announcements instead of relaying every call verbatim.
- *
- * Naive live regions plus token-by-token streaming text (a chat response, a
- * progress readout, ...) equals screen-reader spam: every incremental chunk
- * gets announced. This component wraps `Announcer`
- * (`../../internal/announcer.js`) so callers can fire `announce()` as often
- * as they like — only the latest text within each `throttle-ms` window
- * actually reaches assistive tech, and a `{ force: true }` call (e.g. once a
- * stream ends) always lands immediately regardless of any window in
- * progress.
- *
- * A consumer typically mounts one `<lyra-live-region>` per page/surface
- * (much like `<lyra-toast>` is one region per placement — see
- * `../toast/toaster.ts`) and keeps a reference to call `announce()` from
- * application code or a parent component:
- *
- * @example
- * ```html
- * <!-- once, near the root of a chat surface's shell -->
- * <lyra-live-region id="chat-live" mode="polite"></lyra-live-region>
- * ```
- * ```ts
- * const live = document.getElementById('chat-live') as LyraLiveRegion;
- *
- * // streaming tokens: fine to call on every chunk, only the trailing state lands
- * live.announce(`${partialText} …`);
- *
- * // stream finished: always announced, even mid-throttle-window
- * live.announce('Response complete', { force: true });
- * ```
- *
- * A parent Lit component would instead hold the reference via `@query`:
- * ```ts
- * @query('lyra-live-region') private liveRegion!: LyraLiveRegion;
- * ```
- * and is exactly what later components in this family (a stream-status
- * indicator, a tool-call chip's status transitions, a chat message's
- * streaming state) are expected to do rather than hand-rolling their own
- * `aria-live` element.
- *
- * @customElement lyra-live-region
- * @csspart region - The visually-hidden element carrying `role`/`aria-live`.
- */
-export declare class LyraLiveRegion extends LyraElement {
-    static styles: import("lit").CSSResultGroup[];
-    /** `polite` (role="status") waits for the user to be idle; `assertive`
-     *  (role="alert") interrupts. Mirrors native `aria-live` semantics.
-     *
-     *  `write()` also applies `role`/`aria-live` imperatively at announce time
-     *  (not only through this property's template binding) so a caller that
-     *  sets `mode` and immediately force-announces in the same synchronous
-     *  turn -- e.g. a stream-status transition -- gets the new urgency and the
-     *  new text landing together, rather than the text beating Lit's
-     *  re-render to the DOM. */
-    mode: LiveRegionMode;
-    /** Throttle window in ms — see `Announcer` in `internal/announcer.ts`. */
-    throttleMs: number;
-    private readonly announcer;
-    private lastWritten;
-    private regionEl?;
-    private reannounceHandle?;
-    private reannounceView?;
-    private pendingWrite?;
-    constructor();
-    protected updated(changed: PropertyValues): void;
-    firstUpdated(): void;
-    disconnectedCallback(): void;
-    /**
-     * Queue `text` for announcement. Calls arriving within `throttle-ms` of
-     * the first call in a burst collapse to a single announcement of the
-     * latest text; pass `{ force: true }` to bypass the window and flush
-     * immediately (e.g. for a final/terminal message that must not be
-     * dropped).
-     */
-    announce(text: string, options?: AnnounceOptions): void;
-    private write;
-    private cancelReannounce;
-    render(): TemplateResult;
-}
-declare global {
-    interface HTMLElementTagNameMap {
-        'lyra-live-region': LyraLiveRegion;
-    }
-}
+export * from './live-region.class.js';
+//# sourceMappingURL=live-region.d.ts.map

package/dist/components/live-region/live-region.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-region.d.ts","sourceRoot":"","sources":["../../../src/components/live-region/live-region.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC"}

package/dist/components/live-region/live-region.js

@@ -1,189 +1,5 @@
-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 } from 'lit';
-import { property } from 'lit/decorators.js';
-import { LyraElement } from '../../internal/lyra-element.js';
+export * from './live-region.class.js';
+import { LyraLiveRegion } from './live-region.class.js';
 import { defineElement } from '../../internal/prefix.js';
-import { srOnly } from '../../internal/a11y.js';
-import { Announcer } from '../../internal/announcer.js';
-import { styles } from './live-region.styles.js';
-/**
- * `<lyra-live-region>` — a visually-hidden ARIA live region that throttles
- * and coalesces announcements instead of relaying every call verbatim.
- *
- * Naive live regions plus token-by-token streaming text (a chat response, a
- * progress readout, ...) equals screen-reader spam: every incremental chunk
- * gets announced. This component wraps `Announcer`
- * (`../../internal/announcer.js`) so callers can fire `announce()` as often
- * as they like — only the latest text within each `throttle-ms` window
- * actually reaches assistive tech, and a `{ force: true }` call (e.g. once a
- * stream ends) always lands immediately regardless of any window in
- * progress.
- *
- * A consumer typically mounts one `<lyra-live-region>` per page/surface
- * (much like `<lyra-toast>` is one region per placement — see
- * `../toast/toaster.ts`) and keeps a reference to call `announce()` from
- * application code or a parent component:
- *
- * @example
- * ```html
- * <!-- once, near the root of a chat surface's shell -->
- * <lyra-live-region id="chat-live" mode="polite"></lyra-live-region>
- * ```
- * ```ts
- * const live = document.getElementById('chat-live') as LyraLiveRegion;
- *
- * // streaming tokens: fine to call on every chunk, only the trailing state lands
- * live.announce(`${partialText} …`);
- *
- * // stream finished: always announced, even mid-throttle-window
- * live.announce('Response complete', { force: true });
- * ```
- *
- * A parent Lit component would instead hold the reference via `@query`:
- * ```ts
- * @query('lyra-live-region') private liveRegion!: LyraLiveRegion;
- * ```
- * and is exactly what later components in this family (a stream-status
- * indicator, a tool-call chip's status transitions, a chat message's
- * streaming state) are expected to do rather than hand-rolling their own
- * `aria-live` element.
- *
- * @customElement lyra-live-region
- * @csspart region - The visually-hidden element carrying `role`/`aria-live`.
- */
-export class LyraLiveRegion extends LyraElement {
-    static { this.styles = [LyraElement.styles, styles, srOnly]; }
-    constructor() {
-        super();
-        /** `polite` (role="status") waits for the user to be idle; `assertive`
-         *  (role="alert") interrupts. Mirrors native `aria-live` semantics.
-         *
-         *  `write()` also applies `role`/`aria-live` imperatively at announce time
-         *  (not only through this property's template binding) so a caller that
-         *  sets `mode` and immediately force-announces in the same synchronous
-         *  turn -- e.g. a stream-status transition -- gets the new urgency and the
-         *  new text landing together, rather than the text beating Lit's
-         *  re-render to the DOM. */
-        this.mode = 'polite';
-        /** Throttle window in ms — see `Announcer` in `internal/announcer.ts`. */
-        this.throttleMs = 500;
-        // The live region's own last-written text. Tracked separately from
-        // whatever Lit thinks the DOM looks like because `write()` mutates
-        // `regionEl.textContent` directly (outside Lit's template bindings) --
-        // see `write()` for why.
-        this.lastWritten = '';
-        // Built in the constructor (not a class-field initializer) so it reads
-        // `this.throttleMs` only after that property's own field initializer
-        // has already run and set the declared default.
-        this.announcer = new Announcer({
-            throttleMs: this.throttleMs,
-            onFlush: (text) => this.write(text),
-        });
-    }
-    updated(changed) {
-        if (changed.has('throttleMs')) {
-            this.announcer.throttleMs = this.throttleMs;
-        }
-    }
-    firstUpdated() {
-        this.regionEl = this.renderRoot.querySelector('[part="region"]') ?? undefined;
-        if (this.pendingWrite !== undefined) {
-            const text = this.pendingWrite;
-            this.pendingWrite = undefined;
-            this.write(text);
-        }
-    }
-    disconnectedCallback() {
-        super.disconnectedCallback();
-        this.announcer.cancel();
-        this.pendingWrite = undefined;
-        this.cancelReannounce();
-    }
-    /**
-     * Queue `text` for announcement. Calls arriving within `throttle-ms` of
-     * the first call in a burst collapse to a single announcement of the
-     * latest text; pass `{ force: true }` to bypass the window and flush
-     * immediately (e.g. for a final/terminal message that must not be
-     * dropped).
-     */
-    announce(text, options) {
-        this.announcer.announce(text, options);
-    }
-    write(text) {
-        const region = this.regionEl;
-        if (!region) {
-            this.pendingWrite = text;
-            return;
-        }
-        // A same-text reannounce frame still in flight is now stale the moment
-        // any new write() call comes in -- if it fired later it would clobber
-        // whatever text this call is about to land with the older, already-
-        // superseded string. Cancel it up front so at most one reannounce is
-        // ever pending and it can never overwrite a newer announcement.
-        this.cancelReannounce();
-        const assertive = this.mode === 'assertive';
-        if (text === this.lastWritten) {
-            // Screen readers announce a live region on text-content *change* --
-            // re-writing the identical string is otherwise a silent no-op to
-            // assistive tech. Clearing first and re-setting on the next frame
-            // (rather than in the same task) gives the DOM an actual empty ->
-            // populated transition to observe instead of a same-tick clear+set
-            // that can coalesce into nothing ever appearing to change.
-            //
-            // role/aria-live are set imperatively here (not left to Lit's
-            // template binding) so a caller that sets `mode` and immediately
-            // force-announces -- e.g. stream-status's announceTransition() --
-            // gets the new urgency in the same synchronous operation as the text,
-            // rather than racing Lit's async re-render.
-            region.setAttribute('role', assertive ? 'alert' : 'status');
-            region.setAttribute('aria-live', assertive ? 'assertive' : 'polite');
-            region.textContent = '';
-            const view = region.ownerDocument.defaultView;
-            if (!view) {
-                region.textContent = text;
-                return;
-            }
-            this.reannounceView = view;
-            this.reannounceHandle = view.requestAnimationFrame(() => {
-                this.reannounceHandle = undefined;
-                this.reannounceView = undefined;
-                region.textContent = text;
-            });
-        }
-        else {
-            region.setAttribute('role', assertive ? 'alert' : 'status');
-            region.setAttribute('aria-live', assertive ? 'assertive' : 'polite');
-            region.textContent = text;
-        }
-        this.lastWritten = text;
-    }
-    cancelReannounce() {
-        if (this.reannounceHandle === undefined)
-            return;
-        this.reannounceView?.cancelAnimationFrame(this.reannounceHandle);
-        this.reannounceHandle = undefined;
-        this.reannounceView = undefined;
-    }
-    render() {
-        const assertive = this.mode === 'assertive';
-        return html `<div
-      part="region"
-      class="sr-only"
-      role=${assertive ? 'alert' : 'status'}
-      aria-live=${assertive ? 'assertive' : 'polite'}
-      aria-atomic="true"
-    ></div>`;
-    }
-}
-__decorate([
-    property({ reflect: true })
-], LyraLiveRegion.prototype, "mode", void 0);
-__decorate([
-    property({ type: Number, attribute: 'throttle-ms' })
-], LyraLiveRegion.prototype, "throttleMs", void 0);
 defineElement('live-region', LyraLiveRegion);
+//# sourceMappingURL=live-region.js.map

package/dist/components/live-region/live-region.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"live-region.js","sourceRoot":"","sources":["../../../src/components/live-region/live-region.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,aAAa,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC"}

package/dist/components/live-region/live-region.styles.d.ts

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

package/dist/components/live-region/live-region.styles.d.ts.map

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

package/dist/components/live-region/live-region.styles.js

@@ -8,3 +8,4 @@ export const styles = css `
     display: contents;
   }
 `;
+//# sourceMappingURL=live-region.styles.js.map

package/dist/components/live-region/live-region.styles.js.map

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

package/dist/components/map/map-loader.d.ts

@@ -1,8 +1,11 @@
-import type * as MaplibreModule from 'maplibre-gl';
+import type { OptionalPeerApi } from '../../internal/optional-peer-types.js';
+type MaplibreModule = OptionalPeerApi;
 /**
  * Lazily loads the optional peer dependency `maplibre-gl` once per page.
  * Resolves to `null` (with a one-time warning) if it isn't installed —
  * mirrors `<lyra-flag>`'s peer-dependency pattern. Consumers must separately
  * import `maplibre-gl/dist/maplibre-gl.css` once they install the peer.
  */
-export declare function loadMaplibre(): Promise<typeof MaplibreModule | null>;
+export declare function loadMaplibre(): Promise<MaplibreModule | null>;
+export {};
+//# sourceMappingURL=map-loader.d.ts.map

package/dist/components/map/map-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-loader.d.ts","sourceRoot":"","sources":["../../../src/components/map/map-loader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAE7E,KAAK,cAAc,GAAG,eAAe,CAAC;AAGtC;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAW7D"}

package/dist/components/map/map-loader.js

@@ -15,3 +15,4 @@ export function loadMaplibre() {
     }
     return maplibre;
 }
+//# sourceMappingURL=map-loader.js.map

package/dist/components/map/map-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-loader.js","sourceRoot":"","sources":["../../../src/components/map/map-loader.ts"],"names":[],"mappings":"AAGA,IAAI,QAAoD,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,UAAU,YAAY;IAC1B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,QAAQ,GAAI,MAAM,CAAC,aAAa,CAA6B,CAAC,KAAK,CAAC,GAAG,EAAE;YACvE,OAAO,CAAC,IAAI,CACV,gFAAgF;gBAC9E,wFAAwF,CAC3F,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}