@aceshooting/lyra-ui 6.2.0 → 7.1.0

package/dist/components/utility/poll-status/poll-status.class.js

@@ -8,29 +8,18 @@ import { html, nothing } from 'lit';
 import { property, state, query } from 'lit/decorators.js';
 import { LyraElement } from '../../../internal/lyra-element.js';
 import { pauseIcon, playIcon } from '../../../internal/icons.js';
+import { getNumberFormat } from '../../../internal/intl-cache.js';
 import { finiteDuration } from '../../../internal/numbers.js';
 import '../live-region/live-region.class.js';
 import { styles } from './poll-status.styles.js';
+import { trueDefaultBooleanConverter } from '../../../internal/converters.js';
 const TICK_MS = 1000;
-/** `true`-defaulting boolean attribute converter -- Lit's default presence-based `type: Boolean`
- *  can never be set back to `false` from a plain-HTML attribute once a property's own default is
- *  `true` (removing an attribute that was never present fires no `attributeChangedCallback`), so
- *  `fromAttribute` checks the literal string instead. Duplicated locally rather than imported,
- *  matching this exact converter's repeated per-component convention elsewhere in this library
- *  (see e.g. `<lr-agent-run>`'s own `trueDefaultBooleanConverter`). */
-const trueDefaultBooleanConverter = {
-    fromAttribute(value) {
-        return value !== 'false';
-    },
-    toAttribute(value) {
-        return value ? null : 'false';
-    },
-};
 /**
  * `<lr-poll-status>` — a "next scheduled refresh" countdown with a built-in pause control: a
  * ticking `M:SS` display counting down to the next scheduled action, a "Refreshing…" state at
- * zero, a "Paused" state while `paused` (instead of freezing on a stale value), and a
- * pause/resume toggle. First-party invention (no Web Awesome equivalent); the
+ * zero, a localized inactive state while `active` is false, a "Paused" state
+ * while `paused` (instead of freezing on a stale value), and a pause/resume
+ * toggle. First-party invention (no Web Awesome equivalent); the
  * closest existing component, `lr-stream-status`, is scoped to transport/connection-health
  * phases, a different concern from a scheduled-interval countdown -- this mirrors its internal
  * `<lr-live-region>` composition for accessible phase-transition announcements.
@@ -40,7 +29,7 @@ const trueDefaultBooleanConverter = {
  * @event lr-pause-change - Fired when `paused` changes via the built-in button. `detail: boolean`.
  * @csspart base - The root wrapper.
  * @csspart indicator - The pulsing status dot.
- * @csspart countdown - The `M:SS` text (or "Refreshing…" once due, or "Paused" while `paused`).
+ * @csspart countdown - The localized `M:SS` text, or the refreshing, paused, or inactive state.
  * @csspart pause-button - The built-in pause/resume toggle.
  * @cssprop [--lr-poll-status-due-bg=var(--lr-color-success)] - Background of `indicator` while
  *   `data-due` is set, without repainting every other component that reuses the shared success
@@ -49,7 +38,8 @@ const trueDefaultBooleanConverter = {
 export class LyraPollStatus extends LyraElement {
     constructor() {
         super(...arguments);
-        /** Whether the poll cycle is running at all. `true` (the default). */
+        /** Whether the poll cycle is running at all. While false, the component
+         *  clears due/countdown semantics and disables its pause action. */
         this.active = true;
         /** User-toggled pause -- while `true`, the countdown display freezes and `lr-poll-due` never
          *  fires. `false` (the default). */
@@ -65,6 +55,8 @@ export class LyraPollStatus extends LyraElement {
          *  construction, so `changed.has('paused')` is true on the very first `updated()` call too). */
         this.isMounting = true;
         this.togglePause = () => {
+            if (!this.active)
+                return;
             this.paused = !this.paused;
             this.emit('lr-pause-change', this.paused);
         };
@@ -105,6 +97,10 @@ export class LyraPollStatus extends LyraElement {
                 this.remainingMs = 0;
             }
         }
+        if (changed.has('active') && !this.active) {
+            this.due = false;
+            this.remainingMs = 0;
+        }
     }
     updated(changed) {
         const wasMounting = this.isMounting;
@@ -171,6 +167,8 @@ export class LyraPollStatus extends LyraElement {
         region.announce(text, { force: true });
     }
     formatCountdown() {
+        if (!this.active)
+            return this.localize('pollInactive');
         if (this.paused)
             return this.localize('pollPaused');
         if (this.due)
@@ -178,18 +176,22 @@ export class LyraPollStatus extends LyraElement {
         const totalSeconds = Math.ceil(this.remainingMs / 1000);
         const minutes = Math.floor(totalSeconds / 60);
         const seconds = totalSeconds % 60;
-        return `${minutes}:${String(seconds).padStart(2, '0')}`;
+        const locale = this.effectiveLocale;
+        const minuteText = getNumberFormat(locale, { useGrouping: false }).format(minutes);
+        const secondText = getNumberFormat(locale, { minimumIntegerDigits: 2, useGrouping: false }).format(seconds);
+        return `${minuteText}:${secondText}`;
     }
     render() {
         return html `
       <div part="base">
-        <span part="indicator" aria-hidden="true" ?data-due=${this.due}></span>
-        <span part="countdown">${this.nextInMs != null ? this.formatCountdown() : nothing}</span>
+        <span part="indicator" aria-hidden="true" ?data-due=${this.due} ?data-inactive=${!this.active}></span>
+        <span part="countdown">${!this.active || this.nextInMs != null ? this.formatCountdown() : nothing}</span>
         <button
           part="pause-button"
           type="button"
           aria-pressed=${this.paused ? 'true' : 'false'}
           aria-label=${this.localize(this.paused ? 'pollResume' : 'pollPause')}
+          ?disabled=${!this.active}
           @click=${this.togglePause}
         >${this.paused ? playIcon() : pauseIcon()}</button>
         <lr-live-region></lr-live-region>

package/dist/components/utility/poll-status/poll-status.class.js.map

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

package/dist/components/utility/poll-status/poll-status.styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"poll-status.styles.d.ts","sourceRoot":"","sources":["../../../../src/components/utility/poll-status/poll-status.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,yBA4DlB,CAAC"}
+{"version":3,"file":"poll-status.styles.d.ts","sourceRoot":"","sources":["../../../../src/components/utility/poll-status/poll-status.styles.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,yBAoElB,CAAC"}

package/dist/components/utility/poll-status/poll-status.styles.js

@@ -25,6 +25,10 @@ export const styles = css `
   [part='indicator'][data-due] {
     background: var(--lr-poll-status-due-bg, var(--lr-color-success));
   }
+  [part='indicator'][data-inactive] {
+    animation: none;
+    opacity: var(--lr-opacity-disabled);
+  }
   @keyframes lr-poll-status-pulse {
     0%, 100% {
       opacity: 1;
@@ -51,10 +55,14 @@ export const styles = css `
     padding: var(--lr-size-0-125rem);
     border-radius: var(--lr-radius);
   }
-  [part='pause-button']:hover {
+  [part='pause-button']:hover:not(:disabled) {
     background: var(--lr-color-brand-quiet);
     color: var(--lr-color-brand);
   }
+  [part='pause-button']:disabled {
+    cursor: default;
+    opacity: var(--lr-opacity-disabled);
+  }
   [part='pause-button']:focus-visible {
     outline: var(--lr-focus-ring-width) solid var(--lr-focus-ring-color);
     outline-offset: var(--lr-focus-ring-offset);

package/dist/components/utility/poll-status/poll-status.styles.js.map

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

package/dist/components/utility/random-content/random-content.class.d.ts

@@ -13,9 +13,9 @@ export interface LyraRandomContentEventMap {
  * testimonial/quote rotation, or varying marketing copy on each render or
  * interval without any custom JS beyond slotting the candidates.
  *
- * Not a form-associated control and has no textual chrome of its own — a
- * pure content-rotation primitive over caller-supplied children, so the
- * label/hint/error frame doesn't apply.
+ * Not a form-associated control: it is a content-rotation primitive over
+ * caller-supplied children, so the label/hint/error frame doesn't apply.
+ * Its only built-in action is the autoplay pause/resume control.
  *
  * The host renders `display: block` by default, like the rest of this
  * family. A consumer needing an inline text-fragment swap inside a sentence
@@ -23,12 +23,11 @@ export interface LyraRandomContentEventMap {
  * that isn't baked in here, since `display: contents` on the host risks
  * accessibility-tree inconsistencies across engines.
  *
- * There is no built-in trigger UI (no next/previous/shuffle button):
- * selection is driven only by `autoplay`/`autoplayInterval` and the public
- * `randomize()` method. Consequently there is no keyboard interaction and no
- * RTL-aware arrow-key handling to implement here — that guarantee only
- * applies to components with roving/arrow-key navigation, which this one
- * structurally lacks.
+ * Selection is driven by `autoplay`/`autoplayInterval` and the public
+ * `randomize()` method. When autoplay is enabled, a built-in localized
+ * pause/resume action exposes the reflected `paused` state. Rotation also
+ * suspends while focus is anywhere inside the component and never hides a
+ * subtree that currently owns focus.
  *
  * `fade-left`/`fade-right` are physical-direction transforms (matching the
  * upstream naming this component mirrors), not "previous/next" navigational
@@ -41,6 +40,7 @@ export interface LyraRandomContentEventMap {
  * a slot-change-triggered reselection, or an autoplay tick). `detail: { items }` is the exact
  * array of elements now shown, in display order. Not emitted when the eligible pool is empty.
  * @csspart base - The wrapping element around the default slot.
+ * @csspart pause-button - The autoplay pause/resume action.
  * @cssprop [--lr-random-content-animation-duration=300ms] - Duration of the entrance animation.
  * @cssprop [--lr-random-content-animation-easing=ease] - Easing function for the entrance animation.
  * @cssprop [--lr-random-content-animation-translate=var(--lr-size-0-5em)] - Translation distance for directional animations.
@@ -51,6 +51,8 @@ export declare class LyraRandomContent extends LyraElement<LyraRandomContentEven
     animation: LyraRandomContentAnimation;
     /** Whether the displayed selection automatically re-rolls on an interval. */
     autoplay: boolean;
+    /** Whether autoplay is user-paused. Reflected for external state styling. */
+    paused: boolean;
     /** Milliseconds between autoplay ticks. Clamped to a 1000ms floor. */
     autoplayInterval: number;
     /** How many children are shown simultaneously -- a count, not the pool itself. NaN/negative/
@@ -66,6 +68,12 @@ export declare class LyraRandomContent extends LyraElement<LyraRandomContentEven
     private sequenceCursor;
     private previousSelection?;
     private lastPool;
+    private managedPool;
+    private readonly authorState;
+    private authorStateObserver?;
+    private authorStateObserverPauseDepth;
+    private focusWithin;
+    private announcementsEnabled;
     private hasUpdatedOnce;
     connectedCallback(): void;
     disconnectedCallback(): void;
@@ -80,7 +88,17 @@ export declare class LyraRandomContent extends LyraElement<LyraRandomContentEven
     private selectUnique;
     private selectSequence;
     private computeSelectionForMode;
+    private preserveFocusedSubtree;
+    private reconcileManagedPool;
+    private restoreAuthorState;
+    private restoreManagedPool;
+    private applyManagedSelection;
     private applySelection;
+    private captureAuthorStateMutations;
+    private observeAuthorState;
+    private startAuthorStateObserver;
+    private stopAuthorStateObserver;
+    private withAuthorStateObserverPaused;
     private reselect;
     private onSlotChange;
     /**
@@ -91,6 +109,9 @@ export declare class LyraRandomContent extends LyraElement<LyraRandomContentEven
     randomize: () => HTMLElement[];
     private stopAutoplay;
     private restartAutoplay;
+    private onFocusIn;
+    private onFocusOut;
+    private togglePaused;
     render(): TemplateResult;
 }
 declare global {

package/dist/components/utility/random-content/random-content.class.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"random-content.class.d.ts","sourceRoot":"","sources":["../../../../src/components/utility/random-content/random-content.class.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,KAAK,CAAC;AAE9E,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAIhE,MAAM,MAAM,0BAA0B,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,YAAY,CAAC;AAChH,MAAM,MAAM,qBAAqB,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAErE,MAAM,WAAW,yBAAyB;IACxC,mBAAmB,EAAE,WAAW,CAAC;QAAE,KAAK,EAAE,WAAW,EAAE,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,qBAAa,iBAAkB,SAAQ,WAAW,CAAC,yBAAyB,CAAC;IAC3E,OAAgB,MAAM,iCAAgC;IAEtD,uEAAuE;IAC1C,SAAS,EAAE,0BAA0B,CAAU;IAE5E,6EAA6E;IACjC,QAAQ,UAAS;IAE7D,sEAAsE;IACV,gBAAgB,SAAQ;IAEpF;;sDAEkD;IACtB,KAAK,SAAK;IAEtC,+CAA+C;IACnC,IAAI,EAAE,qBAAqB,CAAY;IAEpC,OAAO,CAAC,MAAM,CAAC,CAAkB;IAEhD,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAC,CAAiB;IACpC,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,iBAAiB,CAAC,CAAgB;IAC1C,OAAO,CAAC,QAAQ,CAAqB;IAOrC,OAAO,CAAC,cAAc,CAAS;IAEtB,iBAAiB,IAAI,IAAI,CAYjC;IAEQ,oBAAoB,IAAI,IAAI,CAKpC;IAED,UAAmB,YAAY,IAAI,IAAI,CAUtC;IAED,UAAmB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAMxD;IAED,OAAO,CAAC,wBAAwB,CAG9B;IAEF,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,QAAQ;IAgBhB,OAAO,CAAC,YAAY,CAWlB;IAEF;;;;OAIG;IACH,SAAS,QAAO,WAAW,EAAE,CAAoB;IAEjD,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,eAAe;IASd,MAAM,IAAI,cAAc,CAWhC;CACF;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,mBAAmB,EAAE,iBAAiB,CAAC;KACxC;CACF"}
+{"version":3,"file":"random-content.class.d.ts","sourceRoot":"","sources":["../../../../src/components/utility/random-content/random-content.class.ts"],"names":[],"mappings":"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"}

package/dist/components/utility/random-content/random-content.class.js

@@ -5,9 +5,11 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 import { html, nothing } from 'lit';
-import { property, query } from 'lit/decorators.js';
+import { property, query, state } from 'lit/decorators.js';
+import { pauseIcon, playIcon } from '../../../internal/icons.js';
 import { LyraElement } from '../../../internal/lyra-element.js';
 import { finiteDuration, finiteInteger } from '../../../internal/numbers.js';
+import { composedContains, deepActiveElement } from '../../../internal/overlay-manager.js';
 import { styles } from './random-content.styles.js';
 /**
  * `<lr-random-content>` — displays a randomly (or sequentially) chosen
@@ -15,9 +17,9 @@ import { styles } from './random-content.styles.js';
  * testimonial/quote rotation, or varying marketing copy on each render or
  * interval without any custom JS beyond slotting the candidates.
  *
- * Not a form-associated control and has no textual chrome of its own — a
- * pure content-rotation primitive over caller-supplied children, so the
- * label/hint/error frame doesn't apply.
+ * Not a form-associated control: it is a content-rotation primitive over
+ * caller-supplied children, so the label/hint/error frame doesn't apply.
+ * Its only built-in action is the autoplay pause/resume control.
  *
  * The host renders `display: block` by default, like the rest of this
  * family. A consumer needing an inline text-fragment swap inside a sentence
@@ -25,12 +27,11 @@ import { styles } from './random-content.styles.js';
  * that isn't baked in here, since `display: contents` on the host risks
  * accessibility-tree inconsistencies across engines.
  *
- * There is no built-in trigger UI (no next/previous/shuffle button):
- * selection is driven only by `autoplay`/`autoplayInterval` and the public
- * `randomize()` method. Consequently there is no keyboard interaction and no
- * RTL-aware arrow-key handling to implement here — that guarantee only
- * applies to components with roving/arrow-key navigation, which this one
- * structurally lacks.
+ * Selection is driven by `autoplay`/`autoplayInterval` and the public
+ * `randomize()` method. When autoplay is enabled, a built-in localized
+ * pause/resume action exposes the reflected `paused` state. Rotation also
+ * suspends while focus is anywhere inside the component and never hides a
+ * subtree that currently owns focus.
  *
  * `fade-left`/`fade-right` are physical-direction transforms (matching the
  * upstream naming this component mirrors), not "previous/next" navigational
@@ -43,6 +44,7 @@ import { styles } from './random-content.styles.js';
  * a slot-change-triggered reselection, or an autoplay tick). `detail: { items }` is the exact
  * array of elements now shown, in display order. Not emitted when the eligible pool is empty.
  * @csspart base - The wrapping element around the default slot.
+ * @csspart pause-button - The autoplay pause/resume action.
  * @cssprop [--lr-random-content-animation-duration=300ms] - Duration of the entrance animation.
  * @cssprop [--lr-random-content-animation-easing=ease] - Easing function for the entrance animation.
  * @cssprop [--lr-random-content-animation-translate=var(--lr-size-0-5em)] - Translation distance for directional animations.
@@ -54,6 +56,8 @@ export class LyraRandomContent extends LyraElement {
         this.animation = 'none';
         /** Whether the displayed selection automatically re-rolls on an interval. */
         this.autoplay = false;
+        /** Whether autoplay is user-paused. Reflected for external state styling. */
+        this.paused = false;
         /** Milliseconds between autoplay ticks. Clamped to a 1000ms floor. */
         this.autoplayInterval = 3000;
         /** How many children are shown simultaneously -- a count, not the pool itself. NaN/negative/
@@ -65,6 +69,11 @@ export class LyraRandomContent extends LyraElement {
         this.reduceMotion = false;
         this.sequenceCursor = 0;
         this.lastPool = [];
+        this.managedPool = new Set();
+        this.authorState = new WeakMap();
+        this.authorStateObserverPauseDepth = 0;
+        this.focusWithin = false;
+        this.announcementsEnabled = false;
         // Distinguishes a genuine later `updated()` pass from the very first one.
         // Lit reports every declared reactive property as "changed" on the first
         // update (including `items`, which otherwise would make `updated()` run a
@@ -95,10 +104,25 @@ export class LyraRandomContent extends LyraElement {
          * elements now shown. Does not reset or restart the autoplay timer.
          */
         this.randomize = () => this.reselect();
+        this.onFocusIn = () => {
+            this.focusWithin = true;
+            this.stopAutoplay();
+        };
+        this.onFocusOut = () => {
+            queueMicrotask(() => {
+                this.focusWithin = composedContains(this, deepActiveElement(this.ownerDocument));
+                if (!this.focusWithin)
+                    this.restartAutoplay();
+            });
+        };
+        this.togglePaused = () => {
+            this.paused = !this.paused;
+        };
     }
     static { this.styles = [LyraElement.styles, styles]; }
     connectedCallback() {
         super.connectedCallback();
+        this.startAuthorStateObserver();
         this.mediaQuery = typeof matchMedia === 'function' ? matchMedia('(prefers-reduced-motion: reduce)') : undefined;
         this.reduceMotion = this.mediaQuery?.matches ?? false;
         this.mediaQuery?.addEventListener('change', this.onMotionPreferenceChange);
@@ -108,10 +132,17 @@ export class LyraRandomContent extends LyraElement {
         // cycle (e.g. a virtualized list reordering this element) would leave
         // autoplay permanently stopped. Harmless no-op before the shadow tree's
         // slot exists yet (`eligible()` returns `[]`, gated off below).
+        if (this.hasUpdated) {
+            this.announcementsEnabled = false;
+            this.reselect({ announce: false });
+        }
         this.restartAutoplay();
     }
     disconnectedCallback() {
         this.stopAutoplay();
+        this.stopAuthorStateObserver();
+        this.focusWithin = false;
+        this.restoreManagedPool();
         this.mediaQuery?.removeEventListener('change', this.onMotionPreferenceChange);
         this.mediaQuery = undefined;
         super.disconnectedCallback();
@@ -124,15 +155,16 @@ export class LyraRandomContent extends LyraElement {
         // initial pool. `onSlotChange` below still exists for genuinely later
         // pool changes and as a fallback if `slotchange` is the only signal a
         // given engine ever fires for this content.
-        this.reselect();
+        this.reselect({ announce: false });
         this.restartAutoplay();
     }
     updated(changed) {
         if (this.hasUpdatedOnce) {
             if (changed.has('items'))
                 this.reselect();
-            if (changed.has('autoplay') || changed.has('autoplayInterval'))
+            if (changed.has('autoplay') || changed.has('autoplayInterval') || changed.has('paused')) {
                 this.restartAutoplay();
+            }
         }
         this.hasUpdatedOnce = true;
     }
@@ -200,7 +232,51 @@ export class LyraRandomContent extends LyraElement {
                 return this.shuffledPick(pool, count);
         }
     }
-    applySelection(pool, selected) {
+    preserveFocusedSubtree(pool, selected) {
+        const active = deepActiveElement(this.ownerDocument);
+        const focusedItem = pool.find((item) => composedContains(item, active));
+        if (!focusedItem || selected.includes(focusedItem))
+            return selected;
+        return [...selected.slice(0, -1), focusedItem];
+    }
+    reconcileManagedPool(pool) {
+        const nextPool = new Set(pool);
+        for (const item of this.managedPool) {
+            if (!nextPool.has(item))
+                this.restoreAuthorState(item);
+        }
+        for (const item of pool) {
+            if (!this.authorState.has(item)) {
+                this.authorState.set(item, {
+                    hiddenAttribute: item.getAttribute('hidden'),
+                    ariaHidden: item.getAttribute('aria-hidden'),
+                });
+            }
+        }
+        this.managedPool = nextPool;
+    }
+    restoreAuthorState(item) {
+        const original = this.authorState.get(item);
+        if (!original)
+            return;
+        if (original.hiddenAttribute === null)
+            item.removeAttribute('hidden');
+        else
+            item.setAttribute('hidden', original.hiddenAttribute);
+        if (original.ariaHidden === null)
+            item.removeAttribute('aria-hidden');
+        else
+            item.setAttribute('aria-hidden', original.ariaHidden);
+        this.authorState.delete(item);
+    }
+    restoreManagedPool() {
+        for (const item of this.managedPool)
+            this.restoreAuthorState(item);
+        this.managedPool.clear();
+        this.lastPool = [];
+        this.previousSelection = undefined;
+    }
+    applyManagedSelection(pool, selected) {
         const selectedSet = new Set(selected);
         for (const el of pool) {
             const shown = selectedSet.has(el);
@@ -208,19 +284,92 @@ export class LyraRandomContent extends LyraElement {
             el.setAttribute('aria-hidden', shown ? 'false' : 'true');
         }
     }
+    applySelection(pool, selected) {
+        this.withAuthorStateObserverPaused(() => {
+            this.reconcileManagedPool(pool);
+            this.applyManagedSelection(pool, selected);
+        });
+    }
+    captureAuthorStateMutations(records) {
+        for (const record of records) {
+            if (record.type !== 'attributes' || !(record.target instanceof HTMLElement))
+                continue;
+            const item = record.target;
+            if (!this.managedPool.has(item))
+                continue;
+            const state = this.authorState.get(item);
+            if (!state)
+                continue;
+            if (record.attributeName === 'hidden')
+                state.hiddenAttribute = item.getAttribute('hidden');
+            if (record.attributeName === 'aria-hidden')
+                state.ariaHidden = item.getAttribute('aria-hidden');
+        }
+    }
+    observeAuthorState() {
+        this.authorStateObserver?.observe(this, {
+            attributes: true,
+            attributeFilter: ['hidden', 'aria-hidden'],
+            subtree: true,
+        });
+    }
+    startAuthorStateObserver() {
+        if (this.authorStateObserver)
+            return;
+        this.authorStateObserver = new MutationObserver((records) => {
+            this.captureAuthorStateMutations(records);
+            // Keep the current component-owned selection applied while retaining the author's latest
+            // values for exact restoration when an item leaves the pool or the host disconnects.
+            this.withAuthorStateObserverPaused(() => {
+                const selected = this.preserveFocusedSubtree(this.lastPool, this.previousSelection ?? []);
+                this.applyManagedSelection(this.lastPool, selected);
+                this.previousSelection = selected;
+            });
+        });
+        this.observeAuthorState();
+    }
+    stopAuthorStateObserver() {
+        const observer = this.authorStateObserver;
+        if (!observer)
+            return;
+        this.captureAuthorStateMutations(observer.takeRecords());
+        observer.disconnect();
+        this.authorStateObserver = undefined;
+        this.authorStateObserverPauseDepth = 0;
+    }
+    withAuthorStateObserverPaused(operation) {
+        const observer = this.authorStateObserver;
+        const outermost = this.authorStateObserverPauseDepth === 0;
+        if (outermost && observer) {
+            this.captureAuthorStateMutations(observer.takeRecords());
+            observer.disconnect();
+        }
+        this.authorStateObserverPauseDepth += 1;
+        try {
+            return operation();
+        }
+        finally {
+            this.authorStateObserverPauseDepth -= 1;
+            if (outermost && observer && this.isConnected)
+                this.observeAuthorState();
+        }
+    }
     reselect(options = {}) {
         const pool = this.eligible();
         this.lastPool = pool;
         if (pool.length === 0) {
+            this.withAuthorStateObserverPaused(() => this.reconcileManagedPool(pool));
             this.previousSelection = undefined;
             return [];
         }
         if (options.resetPrevious)
             this.previousSelection = undefined;
         const count = this.clampedCount(pool.length);
-        const selected = this.computeSelectionForMode(pool, count);
+        const selected = this.preserveFocusedSubtree(pool, this.computeSelectionForMode(pool, count));
         this.applySelection(pool, selected);
         this.previousSelection = selected;
+        if (options.announce !== false)
+            this.announcementsEnabled = true;
         this.emit('lr-content-change', { items: selected });
         return selected;
     }
@@ -231,7 +380,7 @@ export class LyraRandomContent extends LyraElement {
     }
     restartAutoplay() {
         this.stopAutoplay();
-        if (!this.autoplay || this.reduceMotion || this.eligible().length < 2)
+        if (!this.autoplay || this.paused || this.focusWithin || this.reduceMotion || this.eligible().length < 2)
             return;
         const interval = finiteDuration(this.autoplayInterval, 3000, 1000);
         this.timer = window.setInterval(() => {
@@ -240,15 +389,32 @@ export class LyraRandomContent extends LyraElement {
     }
     render() {
         const hostLabel = this.getAttribute('aria-label');
-        return html `<div
-      part="base"
-      role="status"
-      aria-live=${this.autoplay ? 'off' : 'polite'}
-      aria-atomic="true"
-      aria-label=${hostLabel === null ? nothing : hostLabel}
-    >
-      <slot @slotchange=${this.onSlotChange}></slot>
-    </div>`;
+        return html `
+      <div
+        part="base"
+        role="status"
+        aria-live=${this.autoplay || !this.announcementsEnabled ? 'off' : 'polite'}
+        aria-atomic="true"
+        aria-label=${hostLabel === null ? nothing : hostLabel}
+        @focusin=${this.onFocusIn}
+        @focusout=${this.onFocusOut}
+      >
+        <slot @slotchange=${this.onSlotChange}></slot>
+      </div>
+      ${this.autoplay
+            ? html `<button
+            part="pause-button"
+            type="button"
+            aria-pressed=${this.paused ? 'true' : 'false'}
+            aria-label=${this.localize(this.paused ? 'randomContentResume' : 'randomContentPause')}
+            @focusin=${this.onFocusIn}
+            @focusout=${this.onFocusOut}
+            @click=${this.togglePaused}
+          >
+            ${this.paused ? playIcon() : pauseIcon()}
+          </button>`
+            : nothing}
+    `;
     }
 }
 __decorate([
@@ -257,6 +423,9 @@ __decorate([
 __decorate([
     property({ type: Boolean, reflect: true })
 ], LyraRandomContent.prototype, "autoplay", void 0);
+__decorate([
+    property({ type: Boolean, reflect: true })
+], LyraRandomContent.prototype, "paused", void 0);
 __decorate([
     property({ type: Number, attribute: 'autoplay-interval' })
 ], LyraRandomContent.prototype, "autoplayInterval", void 0);
@@ -269,4 +438,7 @@ __decorate([
 __decorate([
     query('slot')
 ], LyraRandomContent.prototype, "slotEl", void 0);
+__decorate([
+    state()
+], LyraRandomContent.prototype, "announcementsEnabled", void 0);
 //# sourceMappingURL=random-content.class.js.map