stimeo-ui 0.17.0 → 0.18.0

package/dist/controllers/announcer_controller.d.ts

@@ -51,10 +51,12 @@ import { Controller } from '@hotwired/stimulus';
  * region beside the new stand-in or an authored target.
  *
  * **A restored page does not read out an earlier message.** A region holding a
- * message this controller wrote carries `data-<identifier>-announced` until the message
+ * message this controller wrote carries `["text", original, written]` in
+ * `data-<identifier>-announced` until the message
  * is cleared after `clearAfter`. The teardown drops the clearing timers, so a connection
- * that is not the other half of a move empties every marked authored region it finds;
- * an authored region's own initial text carries no mark and stays. Nothing is dropped or emptied on `turbo:before-cache`, which Turbo
+ * that is not the other half of a move empties only a region still holding that
+ * recorded text alone. Authored replacements, element children, and invalid records
+ * stay. Nothing is dropped or emptied on `turbo:before-cache`, which Turbo
  * also dispatches on pages that stay (a promoted frame navigation, a state-less
  * `popstate`, a refresh of a cached URL): the messages queued there are still read.
  *

package/dist/controllers/announcer_controller.js

@@ -97,6 +97,17 @@ var KeyedTimers = class {
   }
 };
 
+var ListenerSet = class {
+  #abort = new AbortController();
+  add(target, type, handler, options) {
+    target.addEventListener(type, handler, { ...options, signal: this.#abort.signal });
+  }
+  dispose() {
+    this.#abort.abort();
+    this.#abort = new AbortController();
+  }
+};
+
 var MicrotaskCoalescer = class {
   #run;
   #queued = false;
@@ -113,6 +124,9 @@ var MicrotaskCoalescer = class {
     this.#queued = false;
     this.#generation += 1;
   }
+  get pending() {
+    return this.#queued;
+  }
   schedule() {
     if (!this.#active || this.#queued) return;
     this.#queued = true;
@@ -169,6 +183,94 @@ var NumberValueReader = class {
   }
 };
 
+function setAttributeIfChanged(element, name, value, beforeWrite) {
+  if (element.getAttribute(name) === value) return false;
+  if (value === null) element.removeAttribute(name);
+  else element.setAttribute(name, value);
+  return true;
+}
+
+var OwnedText = class {
+  #attribute;
+  #channel;
+  #guard;
+  #writes = /* @__PURE__ */ new WeakMap();
+  constructor(attribute, channel = "text", guard = () => true) {
+    this.#attribute = attribute;
+    this.#channel = channel;
+    this.#guard = guard;
+  }
+  hasRecord(element) {
+    return element.hasAttribute(this.#attribute);
+  }
+  read(element, evidence = {}) {
+    if (evidence.source === "live") return this.#writes.get(element) ?? null;
+    const raw = element.getAttribute(this.#attribute);
+    if (raw === null) return null;
+    try {
+      const record = JSON.parse(raw);
+      if (!Array.isArray(record) || record.length !== 3 || record[0] !== this.#channel || typeof record[1] !== "string" || typeof record[2] !== "string")
+        return null;
+      return { original: record[1], written: record[2] };
+    } catch {
+      return null;
+    }
+  }
+  owns(element, evidence = {}) {
+    return this.#ownedRecord(element, evidence) !== null;
+  }
+  #ownedRecord(element, evidence) {
+    const record = this.read(element, evidence);
+    if (record === null || !this.#guard(element)) return null;
+    if (this.#channel === "text" && element.firstElementChild !== null) return null;
+    const current = this.#current(element);
+    return current === record.written || evidence.source === "live" && evidence.allowOriginal === true && current === record.original ? record : null;
+  }
+  write(element, written, original, force = false) {
+    const current = this.#current(element);
+    if (current === null) return;
+    const before = original ?? this.#writes.get(element)?.original ?? this.read(element)?.original ?? current;
+    if (force || current !== written) this.#put(element, written);
+    this.remember(element, written, before);
+  }
+  remember(element, written, original) {
+    const current = this.#current(element);
+    if (current === null) return;
+    const before = original ?? this.#writes.get(element)?.original ?? this.read(element)?.original ?? current;
+    this.#writes.set(element, { original: before, written });
+    setAttributeIfChanged(
+      element,
+      this.#attribute,
+      JSON.stringify([this.#channel, before, written])
+    );
+  }
+  clear(element, evidence = {}) {
+    if (!this.owns(element, evidence)) return false;
+    if (this.#current(element) !== "") this.#put(element, "");
+    this.forget(element);
+    return true;
+  }
+  restore(element, evidence = {}) {
+    const record = this.#ownedRecord(element, evidence);
+    if (record === null) return false;
+    if (this.#current(element) !== record.original) this.#put(element, record.original);
+    this.forget(element);
+    return true;
+  }
+  forget(element) {
+    setAttributeIfChanged(element, this.#attribute, null);
+    this.#writes.delete(element);
+  }
+  #current(element) {
+    if (this.#channel === "text") return element.textContent ?? "";
+    return element instanceof HTMLInputElement ? element.value : null;
+  }
+  #put(element, text) {
+    if (this.#channel === "text") element.textContent = text;
+    else if (element instanceof HTMLInputElement) element.value = text;
+  }
+};
+
 var LEVELS = ["polite", "assertive"];
 var STAND_IN = "stand-in";
 var ANNOUNCED = "announced";
@@ -185,14 +287,13 @@ var AnnouncerController = class _AnnouncerController extends Controller {
   static actions = ["announce"];
   #timers = new SafeTimeout();
   #gate = new DetachGate();
+  #listeners = new ListenerSet();
   #regionTimers = new KeyedTimers();
   #generated = /* @__PURE__ */ new Map();
   get #standIn() {
     return `data-${this.identifier}-${STAND_IN}`;
   }
-  get #announced() {
-    return `data-${this.identifier}-${ANNOUNCED}`;
-  }
+  #messageText = new OwnedText(`data-${this.identifier}-${ANNOUNCED}`);
   #queues = /* @__PURE__ */ new Map();
   #draining = /* @__PURE__ */ new Set();
   #reconcile = new MicrotaskCoalescer(() => this.#reconcileRegions());
@@ -217,8 +318,8 @@ var AnnouncerController = class _AnnouncerController extends Controller {
     this.#emptyInheritedMessages();
     this.#reconcileRegions();
     this.#hostWatch.observe(this.element, { childList: true });
-    this.element.addEventListener("stimeo--announcer:announce", this.#onAnnounceEvent);
-    window.addEventListener("stimeo--announcer:announce", this.#onAnnounceEvent);
+    this.#listeners.add(this.element, "stimeo--announcer:announce", this.#onAnnounceEvent);
+    this.#listeners.add(window, "stimeo--announcer:announce", this.#onAnnounceEvent);
   }
   disconnect() {
     this.#gate.disconnected(this, () => this.#teardown());
@@ -226,8 +327,7 @@ var AnnouncerController = class _AnnouncerController extends Controller {
   #teardown() {
     this.#reconcile.cancel();
     this.#hostWatch.disconnect();
-    this.element.removeEventListener("stimeo--announcer:announce", this.#onAnnounceEvent);
-    window.removeEventListener("stimeo--announcer:announce", this.#onAnnounceEvent);
+    this.#listeners.dispose();
     this.#timers.clearAll();
     this.#regionTimers.clearAll();
     this.#queues.clear();
@@ -279,9 +379,7 @@ var AnnouncerController = class _AnnouncerController extends Controller {
   }
   #emptyInheritedMessages() {
     for (const region of [...this.politeTargets, ...this.assertiveTargets]) {
-      if (!region.hasAttribute(this.#announced)) continue;
-      region.replaceChildren();
-      region.removeAttribute(this.#announced);
+      this.#messageText.clear(region);
     }
   }
   #removeGenerated() {
@@ -325,24 +423,22 @@ var AnnouncerController = class _AnnouncerController extends Controller {
     }
     if (this.dedupeReannounceValue && region.textContent === message) {
       region.textContent = "";
+      this.#messageText.forget(region);
       this.#scheduleDrain(level);
       return;
     }
     queue.shift();
     this.#regionTimers.clear(region);
-    region.textContent = message;
-    region.setAttribute(this.#announced, "");
-    this.#scheduleClear(region, message);
+    this.#messageText.write(region, message, void 0, true);
+    this.#scheduleClear(region);
     if (queue.length > 0) this.#scheduleDrain(level);
   }
-  #scheduleClear(region, message) {
+  #scheduleClear(region) {
     if (this.#safeClearAfter <= 0) return;
     this.#regionTimers.set(
       region,
       () => {
-        if (region.textContent !== message) return;
-        region.textContent = "";
-        region.removeAttribute(this.#announced);
+        this.#messageText.clear(region);
       },
       this.#safeClearAfter
     );

package/dist/controllers/announcer_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/detach_gate.ts","../../src/utils/timer_bounds.ts","../../src/utils/safe_timeout.ts","../../src/utils/keyed_timers.ts","../../src/utils/microtask_coalescer.ts","../../src/utils/number_bounds.ts","../../src/utils/coerce.ts","../../src/utils/number_value.ts","../../src/controllers/announcer_controller.ts"],"names":[],"mappings":"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","file":"announcer_controller.js","sourcesContent":["/**\n * Shared \"in-page move vs real detach\" discriminator for `disconnect()`.\n *\n * A mid-session `disconnect()` whose element is still in the document is\n * ambiguous. It can be:\n *\n * - an **in-page move** — a consumer (sortable, a teleport) re-inserted the\n *   element; Stimulus reconnects the SAME instance in the same mutation batch\n *   and the controller's runtime state must survive;\n * - a **detach that keeps the element** — `data-controller` no longer lists the\n *   identifier (a Turbo 8 morph), or the element moved outside the observed\n *   root (a scoped `Application.start(root)`, a shadow root); no reconnect will\n *   ever come and the controller must tear down or it leaks its sessions,\n *   document listeners, and moved nodes.\n *\n * Neither available signal decides this alone. A synchronous `data-controller`\n * token check catches the morph case but misses an observed-root exit (the\n * token stays, the reconnect never comes). Deferring teardown one microtask and\n * letting `connect()` cancel it catches the root exit, but leans on Stimulus\n * reconnecting moved elements within the same mutation batch — internal\n * behavior, not a public contract. {@link DetachGate} composes both: the token\n * check is the synchronous fast path (no probe, no reliance on batching), the\n * microtask probe is the fallback for the genuinely ambiguous remainder.\n *\n * An element out of the document is a real detach, with one exception: a\n * `data-turbo-permanent` element, or one inside it, that Turbo carries to the\n * next page. Turbo takes it out of the old `<body>`, which Stimulus answers with\n * a `disconnect()` while it is out of the document, and puts it into the new one\n * a few microtasks later in the same task, where the same instance connects\n * again. Such a disconnect is probed until the next task instead.\n *\n * Policy stays with the consumer; this util owns the discrimination only:\n *\n * - **Probe** ({@link disconnected}) when the teardown must eventually happen —\n *   live drag sessions, document listeners, teleported *content*. Call\n *   {@link cancel} from `connect()` (a reconnect means in-page move) and from\n *   the head of any direct teardown path (see below).\n * - **Keep** (bare {@link DetachGate.isDetached}) when undoing the ambiguous\n *   case would fight the controller's own effect: a controller that moves its\n *   OWN element (portal's no-`content` form) exits a scoped observed root as\n *   its normal job — a probe-driven teardown would restore the element into\n *   the root, reconnect, re-teleport, and disconnect again, forever. Such\n *   controllers keep their state on an ambiguous disconnect and tear down only\n *   on {@link DetachGate.isDetached}.\n *\n * Event convention for probe consumers: teardown into a dead (detached) tree is\n * silent — consumers restore from their own `connect()`; a detach that keeps the\n * tree alive must end an in-flight session with a `cancel` event, or composing\n * consumers strand their session bookkeeping.\n */\n\n/** The slice of a Stimulus controller the gate inspects. */\nexport interface DetachGateHost {\n  readonly element: Element;\n  readonly identifier: string;\n}\n\n/**\n * Per-controller-instance gate deciding whether a `disconnect()` is a real\n * detach. Hold one per controller (`#gate = new DetachGate()`) — Stimulus\n * reuses the instance across reconnects, so the pending probe state carries\n * over exactly as the protocol needs.\n *\n * @example\n * ```ts\n * #gate = new DetachGate();\n *\n * connect(): void {\n *   this.#gate.cancel(); // a reconnect: the element moved in-page\n *   // …\n * }\n *\n * disconnect(): void {\n *   this.#gate.disconnected(this, () => this.#teardown());\n * }\n *\n * dismiss(): void {\n *   this.#gate.cancel(); // a direct path: disarm a probe a disconnect queued\n *   this.#teardown();\n * }\n *\n * #teardown(): void {\n *   // … (`disconnected` has already disarmed the probe on its own path)\n * }\n * ```\n */\nexport class DetachGate {\n  /** Set while a probe is queued, waiting for a reconnect to cancel it. */\n  #pending = false;\n\n  /**\n   * True while a probe is queued — the last disconnect was ambiguous and no\n   * reconnect has cancelled it yet. Read it from `connect()` to tell the\n   * reconnect half of an in-page move from a first connect: a controller whose\n   * initialisation restarts a measurement (a min-duration floor, an elapsed\n   * counter) must skip it for the move, where nothing actually restarted.\n   */\n  get pending(): boolean {\n    return this.#pending;\n  }\n\n  /**\n   * True when the disconnect is definitely a real detach — the element left\n   * the document, or `data-controller` no longer lists the identifier. False\n   * means ambiguous (in-page move or observed-root exit), NOT \"alive\".\n   */\n  static isDetached(host: DetachGateHost): boolean {\n    return !host.element.isConnected || !DetachGate.#listed(host);\n  }\n\n  /**\n   * Call from `disconnect()`: runs `teardown` synchronously on a definite\n   * detach (fast path), otherwise defers it one microtask — a reconnect\n   * ({@link cancel} from `connect()`) keeps the state, no reconnect runs it.\n   * One microtask is the whole probe window: Stimulus reconnects a moved\n   * element within the same mutation batch, before the checkpoint drains. An\n   * element Turbo carries to the next page is probed until the next task, by\n   * which time Turbo has put it back.\n   */\n  disconnected(host: DetachGateHost, teardown: () => void): void {\n    const carried = DetachGate.#carried(host);\n    if (!carried && DetachGate.isDetached(host)) {\n      // Also disarms a probe a previous ambiguous disconnect left queued\n      // (defer, element removed, disconnect again) — exactly one teardown.\n      this.#pending = false;\n      teardown();\n      return;\n    }\n    this.#pending = true;\n    const probe = (): void => {\n      if (!this.#pending) return;\n      this.#pending = false;\n      teardown();\n    };\n    if (carried) setTimeout(probe, 0);\n    else queueMicrotask(probe);\n  }\n\n  /**\n   * Whether `host` is out of the document inside a `data-turbo-permanent` element, its\n   * identifier still listed: where Turbo holds an element it carries to the next page.\n   */\n  static #carried(host: DetachGateHost): boolean {\n    const element = host.element;\n    return (\n      !element.isConnected &&\n      element.closest(\"[data-turbo-permanent]\") !== null &&\n      DetachGate.#listed(host)\n    );\n  }\n\n  /** Whether the element's `data-controller` still lists the identifier. */\n  static #listed(host: DetachGateHost): boolean {\n    const tokens = (host.element.getAttribute(\"data-controller\") ?? \"\").split(/\\s+/);\n    return tokens.includes(host.identifier);\n  }\n\n  /**\n   * Disarms a pending probe. Call from `connect()` (the reconnect that proves\n   * an in-page move) and from the head of any teardown path not routed through\n   * {@link disconnected} (disabled-toggle, Escape), so an orphaned probe can\n   * never run the teardown a second time.\n   */\n  cancel(): void {\n    this.#pending = false;\n  }\n}\n","/**\n * Largest delay a timer can hold: the platform stores it in a 32-bit signed\n * integer, and anything larger overflows to `1`, so a delay meant to be far in\n * the future fires almost immediately. A declared delay above this bound names\n * no delay at all, and a controller reading one falls back to its default.\n */\nexport const MAX_TIMER_DELAY_MS = 2_147_483_647;\n","/**\n * Self-cleaning timer registries shared by Stimeo controllers.\n *\n * Stimulus controllers frequently schedule `setTimeout` / `setInterval` work\n * (auto-dismiss, debouncing, polling). When the element leaves the DOM — a\n * Turbo Drive navigation, a Turbo Stream replacement, or any `disconnect()` —\n * orphaned timers keep firing against a detached controller, leaking memory and\n * mutating stale state. {@link SafeTimeout} and {@link SafeInterval} track every\n * timer they create so a single {@link TimerRegistry.clearAll | clearAll()} call\n * in `disconnect()` tears them all down.\n *\n * These are intentionally low-level primitives: they own *registration and\n * cleanup only*. Higher-level policy (pause/resume, remaining-time accounting)\n * stays in the individual controllers so per-widget semantics are not flattened\n * into a lowest-common-denominator helper.\n */\n\nexport { MAX_TIMER_DELAY_MS } from \"./timer_bounds\";\n\n/**\n * Shared registry bookkeeping for the timeout/interval variants.\n *\n * Subclasses provide the scheduling primitive ({@link schedule}) and its matching\n * canceller ({@link cancel}); this base owns the set of live ids plus the\n * per-id and bulk teardown shared by both.\n */\nabstract class TimerRegistry {\n  /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */\n  protected readonly ids = new Set<number>();\n\n  /** Schedules the underlying platform timer and returns its id. */\n  protected abstract schedule(callback: () => void, delay: number): number;\n\n  /** Cancels the underlying platform timer for `id`. */\n  protected abstract cancel(id: number): void;\n\n  /**\n   * Cancels a single tracked timer.\n   *\n   * No-ops if the id is unknown (already cleared, fired, or never owned by this\n   * registry), so callers can clear defensively without guarding.\n   */\n  clear(id: number): void {\n    if (this.ids.delete(id)) {\n      this.cancel(id);\n    }\n  }\n\n  /**\n   * Cancels every tracked timer. Call this from a controller's `disconnect()`\n   * to guarantee no timer outlives the element.\n   */\n  clearAll(): void {\n    for (const id of this.ids) {\n      this.cancel(id);\n    }\n    this.ids.clear();\n  }\n\n  /** Number of timers currently tracked (pending). */\n  get size(): number {\n    return this.ids.size;\n  }\n}\n\n/**\n * `setTimeout` wrapper that auto-forgets each timer once it fires and supports\n * bulk teardown on disconnect.\n *\n * @example\n * ```ts\n * #timers = new SafeTimeout();\n *\n * connect() {\n *   this.#timers.set(() => this.dismiss(), 5000);\n * }\n *\n * disconnect() {\n *   this.#timers.clearAll();\n * }\n * ```\n */\nexport class SafeTimeout extends TimerRegistry {\n  /**\n   * Schedules `callback` after `delay` ms and returns the timer id.\n   *\n   * The id is removed from the registry automatically when the timeout fires,\n   * so {@link TimerRegistry.size | size} reflects only still-pending timers.\n   */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(() => {\n      this.ids.delete(id);\n      callback();\n    }, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setTimeout(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearTimeout(id);\n  }\n}\n\n/**\n * `setInterval` wrapper that tracks every interval for bulk teardown on\n * disconnect. Unlike {@link SafeTimeout}, intervals are retained until they are\n * explicitly cleared because they fire repeatedly.\n *\n * @example\n * ```ts\n * #intervals = new SafeInterval();\n *\n * connect() {\n *   this.#intervals.set(() => this.tick(), 1000);\n * }\n *\n * disconnect() {\n *   this.#intervals.clearAll();\n * }\n * ```\n */\nexport class SafeInterval extends TimerRegistry {\n  /** Schedules a repeating `callback` every `delay` ms and returns the timer id. */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(callback, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setInterval(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearInterval(id);\n  }\n}\n","import { SafeTimeout } from \"./safe_timeout\";\n\n/**\n * Keeps at most one pending timer per key, and releases them all together.\n *\n * A region, a row, a message or a speaker that is armed again while its earlier\n * timer is still pending must end up with exactly one timer deciding when its\n * state ends. Two timers on one key means the earlier deadline wins: it cuts the\n * new emphasis short, clears text written after it, or drops a speaker who is\n * still typing — and then reports an ending for a state that is already gone.\n * Arming through this registry cancels the key's earlier timer in the same step,\n * and no timer id ever reaches the caller.\n *\n * An entry lives exactly as long as its timer: it goes as the timer fires, and\n * the whole ledger goes on `clearAll()`. That is a correctness rule, not\n * tidiness — a platform may hand an id released by `clearTimeout` to the next\n * timer it creates, so an entry that outlived its timer would let a later\n * `clear()` on that key cancel whatever timer now holds the id, on some other\n * key entirely.\n *\n * The ledger is a plain `Map`, and the key may be anything. Weak keys would\n * retain nothing less: while a timer is pending the platform already holds the\n * key through the callback, and the entry is gone the moment the timer is.\n *\n * Scope is the one-per-key timer only. What the timer means, and the roster of\n * keys it is armed for, stay with the consumer, so a second kind of timer on the\n * same keys (a transition wait, an animation frame) is a second registry, and a\n * timer that belongs to no key stays on a plain `SafeTimeout`.\n *\n * @example\n * ```ts\n * readonly #expiry = new KeyedTimers<string>();\n *\n * #onSignal(name: string): void {\n *   this.#expiry.set(name, () => this.#drop(name), this.#timeout);\n * }\n *\n * disconnect(): void {\n *   this.#expiry.clearAll();\n * }\n * ```\n */\nexport class KeyedTimers<K> {\n  readonly #timers = new SafeTimeout();\n\n  /** The pending timer of each key; an entry lives exactly as long as its timer. */\n  readonly #pending = new Map<K, number>();\n\n  /**\n   * Arms `callback` after `delay` ms for `key`, cancelling the timer `key` had\n   * pending. The entry is dropped before the callback runs, so the callback sees\n   * the key unarmed and may arm it again for the next round.\n   */\n  set(key: K, callback: () => void, delay: number): void {\n    this.clear(key);\n    const id = this.#timers.set(() => {\n      this.#pending.delete(key);\n      callback();\n    }, delay);\n    this.#pending.set(key, id);\n  }\n\n  /**\n   * Cancels `key`'s pending timer, if it has one.\n   *\n   * A timer id is a positive integer, so `-1` stands for \"nothing pending\" and\n   * the registry ignores an id it does not own — the unarmed case needs no\n   * branch of its own, and no other key's timer can be reached from here.\n   */\n  clear(key: K): void {\n    this.#timers.clear(this.#pending.get(key) ?? -1);\n    this.#pending.delete(key);\n  }\n\n  /**\n   * Cancels every pending timer and forgets every key. Call this from a\n   * controller's `disconnect()` so no timer, and no entry, outlives the element.\n   */\n  clearAll(): void {\n    this.#timers.clearAll();\n    this.#pending.clear();\n  }\n\n  /** Whether `key` has a timer pending. */\n  has(key: K): boolean {\n    return this.#pending.has(key);\n  }\n}\n","/**\n * Collapses many Stimulus lifecycle callbacks from one DOM mutation into a\n * single pass.\n *\n * Stimulus fires `<name>TargetConnected` / `Disconnected` once per element and\n * `<name>ValueChanged` once per changed attribute. Replacing a list of N options\n * or morphing several render Values therefore delivers N callbacks — but the\n * useful unit of work is \"reconcile against the resulting declarative input\",\n * once, after the batch has settled. Every controller with reconcilable targets\n * or render Values needs the same shape: a `queued` flag plus `queueMicrotask`.\n *\n * **A microtask is the right horizon, and the reason is specific.** Stimulus\n * drives these callbacks from a `MutationObserver`, whose own callback already\n * runs as a microtask with the whole batch in hand; scheduling one more lands\n * after the last sibling callback of that batch and still before paint or any\n * event handler. A timer would be later than it needs to be, and reconciling\n * synchronously would run once per element against a half-applied DOM.\n *\n * **The two guards are not the same guard.** Scheduling is refused before the\n * controller connects, and running is refused after it disconnects:\n *\n * - **Before `connect()`** — Stimulus delivers initial target and Value callbacks\n *   ahead of `connect()`. Reconciling there would compute output against a\n *   controller whose own state has not been initialised, and `connect()` is\n *   about to do a full pass anyway.\n * - **After `disconnect()`** — Stimulus fires a callback for **every** target\n *   during teardown, and a microtask queued just before it would otherwise run\n *   against a detached tree. {@link MicrotaskCoalescer.cancel} exists for the\n *   teardown path to drop the pending pass outright.\n *\n * Both guards are part of one contract here rather than something each consumer\n * has to remember separately.\n *\n * Scope is the scheduling only. *What* to reconcile — keep the surviving active\n * option, fall back to the next / previous / first visible one, rebuild derived\n * chips or hidden fields — stays in the controller, because no two consumers\n * answer it the same way.\n *\n * @example\n * ```ts\n * readonly #reconcile = new MicrotaskCoalescer(() => this.#reconcileOptions());\n *\n * connect()    { this.#reconcile.activate(); }\n * disconnect() { this.#reconcile.cancel(); }\n *\n * optionTargetConnected()    { this.#reconcile.schedule(); }\n * optionTargetDisconnected() { this.#reconcile.schedule(); }\n * ```\n */\nexport class MicrotaskCoalescer {\n  readonly #run: () => void;\n  #queued = false;\n  #active = false;\n  #generation = 0;\n\n  /** @param run - the single reconciliation pass, invoked at most once per batch. */\n  constructor(run: () => void) {\n    this.#run = run;\n  }\n\n  /** Opens the window in which {@link schedule} is honoured; call from `connect()`. */\n  activate(): void {\n    this.#active = true;\n  }\n\n  /** Closes the window and drops any pending pass; call from `disconnect()`. */\n  cancel(): void {\n    this.#active = false;\n    this.#queued = false;\n    this.#generation += 1;\n  }\n\n  /** Requests one pass after the batch settles. Idempotent; inert outside the window. */\n  schedule(): void {\n    if (!this.#active || this.#queued) return;\n    this.#queued = true;\n    const generation = this.#generation;\n    queueMicrotask(() => {\n      // A cancelled callback must not consume a pass queued after reconnect.\n      if (generation !== this.#generation || !this.#queued || !this.#active) return;\n      this.#queued = false;\n      this.#run();\n    });\n  }\n}\n","import { MAX_TIMER_DELAY_MS } from \"./timer_bounds\";\n\n/** Semantic constraints on an already decoded number, independent of the DOM. */\nexport interface NumberBounds {\n  /** Finite numbers are required, including when this field is omitted. */\n  readonly finite?: true;\n  /** Inclusive lower endpoint. */\n  readonly min?: number;\n  /** Inclusive upper endpoint. */\n  readonly max?: number;\n  /** Exclusive lower endpoint. */\n  readonly exclusiveMin?: number;\n  /** Require a number without a fractional part. */\n  readonly integer?: boolean;\n  /** Exact decoded numbers accepted by a discrete contract. */\n  readonly allowedValues?: readonly number[];\n  /** JSON-safe exceptions to finite-number checking for unbounded endpoints. */\n  readonly allowInfinity?: \"negative\" | \"positive\" | \"both\";\n}\n\n/** One constraint for each Number Value, including shorthand declarations. */\nexport type NumberValueConstraints<Values> = {\n  readonly [Key in keyof Values as Values[Key] extends\n    | NumberConstructor\n    | { type: NumberConstructor }\n    ? Key\n    : never]: NumberBounds;\n};\n\n/** Reusable semantic domains; fractional inputs remain fractional unless excluded. */\nexport const NUMBER_BOUNDS = {\n  finite: { finite: true },\n  nonNegative: { finite: true, min: 0 },\n  positive: { finite: true, exclusiveMin: 0 },\n  nonNegativeInteger: { finite: true, min: 0, integer: true },\n  positiveInteger: { finite: true, exclusiveMin: 0, integer: true },\n  lowerBound: { finite: true, allowInfinity: \"negative\" },\n  upperBound: { finite: true, allowInfinity: \"positive\" },\n  timer: { finite: true, min: 0, max: MAX_TIMER_DELAY_MS },\n  positiveTimer: { finite: true, exclusiveMin: 0, max: MAX_TIMER_DELAY_MS },\n} as const satisfies Record<string, NumberBounds>;\n\n/**\n * Checks all declared bounds without rounding, clamping, or coercing the input.\n * Infinity exceptions relax only finite checking; every other bound still applies.\n */\nexport function matchesNumberBounds(value: number, bounds: NumberBounds): boolean {\n  if (!Number.isFinite(value)) {\n    const direction = value === Infinity ? \"positive\" : value === -Infinity ? \"negative\" : null;\n    if (direction === null) return false;\n    if (bounds.allowInfinity !== \"both\" && bounds.allowInfinity !== direction) return false;\n  }\n  if (bounds.min !== undefined && value < bounds.min) return false;\n  if (bounds.max !== undefined && value > bounds.max) return false;\n  if (bounds.exclusiveMin !== undefined && value <= bounds.exclusiveMin) return false;\n  if (bounds.integer && !Number.isInteger(value)) return false;\n  if (bounds.allowedValues !== undefined && !bounds.allowedValues.includes(value)) return false;\n  return true;\n}\n\n/** Decodes a Number Value literal; action params use their own JSON decoder. */\nexport function decodeNumberValue(raw: string): number {\n  return Number(raw.replace(/_/g, \"\"));\n}\n","/**\n * Numeric coercion for controllers that accept a number through a Value, an action\n * param, or an event detail.\n *\n * Stimulus decodes action params as JSON when possible and leaves other text\n * untouched. CustomEvent detail can also supply a number or numeric string.\n * The reader accepts those two types while rejecting blank and non-finite input.\n */\n\nimport { matchesNumberBounds, type NumberBounds } from \"./number_bounds\";\n\n/**\n * Reads a finite number or nonblank numeric string; other input returns `null`.\n * Blank strings cannot silently reset a value to zero.\n */\nexport function toFiniteNumber(raw: unknown): number | null {\n  if (typeof raw !== \"number\" && typeof raw !== \"string\") return null;\n  if (typeof raw === \"string\" && raw.trim().length === 0) return null;\n  const value = Number(raw);\n  return Number.isFinite(value) ? value : null;\n}\n\n/**\n * Returns an accepted decoded Number Value or the caller's fallback unchanged.\n * The caller owns the fallback contract; this reader does not parse or write a Value.\n */\nexport function readNumber(raw: number, fallback: number, bounds: NumberBounds): number {\n  return matchesNumberBounds(raw, bounds) ? raw : fallback;\n}\n","import { readNumber } from \"./coerce\";\nimport { matchesNumberBounds, type NumberBounds } from \"./number_bounds\";\n\n/** The instance identity carried by a Number Value read. */\nexport interface NumberValueOwner {\n  readonly identifier: string;\n  readonly element: Element;\n}\n\n/** Reads current declarations at the point of use without rewriting their attributes. */\nexport class NumberValueReader {\n  /** The last rejected literal per Value; no history grows for an unchanged instance. */\n  readonly #lastRejected = new Map<string, string>();\n\n  /** Resolves the declared number using its own fallback and shared class contract. */\n  read(\n    owner: NumberValueOwner,\n    name: string,\n    raw: number,\n    fallback: number,\n    bounds: NumberBounds,\n  ): number {\n    const resolved = readNumber(raw, fallback, bounds);\n    if (matchesNumberBounds(raw, bounds)) {\n      this.#lastRejected.delete(name);\n      return resolved;\n    }\n    const attribute = `data-${owner.identifier}-${name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}-value`;\n    const literal = owner.element.getAttribute(attribute);\n    if (literal === null) {\n      this.#lastRejected.delete(name);\n      return resolved;\n    }\n    if (this.#lastRejected.get(name) !== literal) {\n      this.#lastRejected.set(name, literal);\n      console.warn(\n        `Stimeo UI: \"${owner.identifier}\" has an invalid number Value \"${name}\" declaration ${JSON.stringify(literal)}; using ${fallback}.`,\n      );\n    }\n    return resolved;\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { DetachGate } from \"../utils/detach_gate\";\nimport { KeyedTimers } from \"../utils/keyed_timers\";\nimport { MicrotaskCoalescer } from \"../utils/microtask_coalescer\";\nimport { NUMBER_BOUNDS, type NumberValueConstraints } from \"../utils/number_bounds\";\nimport { NumberValueReader } from \"../utils/number_value\";\nimport { SafeTimeout } from \"../utils/safe_timeout\";\n\n/** The two politeness levels this controller keeps a region for. */\nconst LEVELS = [\"polite\", \"assertive\"] as const;\n\n/** One of the politeness levels in {@link LEVELS}. */\ntype Level = (typeof LEVELS)[number];\n\n/** Suffix of the marker on a live region this controller generated; see the class remarks. */\nconst STAND_IN = \"stand-in\";\n\n/** Suffix of the marker on a region holding a message this controller wrote. */\nconst ANNOUNCED = \"announced\";\n\n/**\n * Headless, shared **live-region announcer** — a polite/assertive screen-reader\n * announcement base (no dedicated APG pattern; follows the WAI-ARIA \"Alert\" /\n * \"Status\" live-region guidance and WCAG 2.2 **4.1.3 Status Messages**).\n *\n * Markup contract (identifier: `stimeo--announcer`):\n *   <!-- Place once per page; the consumer visually hides the regions in CSS. -->\n *   <div data-controller=\"stimeo--announcer\">\n *     <div data-stimeo--announcer-target=\"polite\" aria-live=\"polite\" aria-atomic=\"true\"></div>\n *     <div data-stimeo--announcer-target=\"assertive\" aria-live=\"assertive\" aria-atomic=\"true\"></div>\n *   </div>\n *\n *   <!-- Attribute-only trigger: declare the activation event explicitly. -->\n *   <button data-action=\"click->stimeo--announcer#announce\"\n *           data-stimeo--announcer-message-param=\"Saved\"\n *           data-stimeo--announcer-assertive-param=\"false\">Save</button>\n *\n *   <!-- Programmatic trigger (e.g. from another controller / Turbo Stream). -->\n *   window.dispatchEvent(new CustomEvent(\"stimeo--announcer:announce\", {\n *     detail: { message: \"12 results\", assertive: false },\n *   }))\n *\n * The announcer is the shared live region other controllers hand their messages\n * to (`stimeo--auto-submit`, `stimeo--flash` and `stimeo--bulk-select` among\n * them) instead of each carrying their own.\n *\n * @remarks\n * Behavior only, with **one deliberate exception**: when a `polite`/`assertive`\n * target is absent the controller *generates* the missing region **on connect**\n * and applies the canonical visually-hidden inline style (see {@link visuallyHide}).\n * A live region must exist and be visually hidden to do its job, and a generated\n * node has no consumer CSS hook to hide it; consumers who want to own styling\n * supply their own targets. Generation happens up front rather than on the first\n * announcement because assistive tech reports changes to a region it already\n * knows about — a region created and written within one task loses that first\n * message. The controller never moves focus — announcements must not steal it\n * (WCAG 2.2 4.1.3). Listeners, the queues and the clear timers are torn down, and any\n * generated regions removed, once the element is really detached. An in-page move,\n * and a `data-turbo-permanent` announcer Turbo carries to the next page, reconnect\n * the same instance with all of them in place, so what was queued is still read and a\n * message on display is still cleared on time.\n *\n * **Generated regions are marked, so a restore never doubles them.** Each\n * stand-in carries `data-<identifier>-stand-in`. The region set is kept whole until\n * the controller is detached, so a stand-in can reach a copy of the page — a page Turbo\n * restores from its cache is one. The teardown removes the stand-ins a connection\n * generated, so a marked child a host arrives with came from an earlier one:\n * `connect()` drops it before generating its own, and it never sits as a second\n * region beside the new stand-in or an authored target.\n *\n * **A restored page does not read out an earlier message.** A region holding a\n * message this controller wrote carries `data-<identifier>-announced` until the message\n * is cleared after `clearAfter`. The teardown drops the clearing timers, so a connection\n * that is not the other half of a move empties every marked authored region it finds;\n * an authored region's own initial text carries no mark and stays. Nothing is dropped or emptied on `turbo:before-cache`, which Turbo\n * also dispatches on pages that stay (a promoted frame navigation, a state-less\n * `popstate`, a refresh of a cached URL): the messages queued there are still read.\n *\n * **Messages are queued, one write per task.** Assistive tech announces what it\n * observes changing, so two messages written into one region within a single task\n * are one observed change and the earlier message is never read. Each politeness\n * has its own FIFO — an assertive message never waits behind polite ones — and a\n * message is written only in a task where its region already existed.\n *\n * **The region set is kept whole while connected.** Exactly one region per\n * politeness is present: an authored target retires the stand-in generated for it,\n * losing one materialises a stand-in again, and a generated region removed by a\n * morph (it is absent from the server's HTML, so a morph drops it) is put back\n * without waiting for the next message.\n */\nexport class AnnouncerController extends Controller<HTMLElement> {\n  /** Numeric read boundaries share one reader for this controller instance. */\n  readonly #numbers = new NumberValueReader();\n\n  static override targets = [\"polite\", \"assertive\"];\n  static override values = {\n    clearAfter: { type: Number, default: 1000 },\n    dedupeReannounce: { type: Boolean, default: true },\n  };\n\n  static valueConstraints = {\n    clearAfter: NUMBER_BOUNDS.timer,\n  } satisfies NumberValueConstraints<typeof AnnouncerController.values>;\n  static actions = [\"announce\"] as const;\n\n  declare readonly politeTarget: HTMLElement;\n  declare readonly assertiveTarget: HTMLElement;\n  declare readonly politeTargets: HTMLElement[];\n  declare readonly assertiveTargets: HTMLElement[];\n  declare readonly hasPoliteTarget: boolean;\n  declare readonly hasAssertiveTarget: boolean;\n\n  declare clearAfterValue: number;\n  declare dedupeReannounceValue: boolean;\n\n  /** Drain timers, which belong to a politeness level rather than to a region. */\n  readonly #timers = new SafeTimeout();\n\n  /** Tells an in-page move or a permanent carry from a real detach. */\n  readonly #gate = new DetachGate();\n\n  /** The auto-clear each region may have outstanding; a newer message releases it. */\n  readonly #regionTimers = new KeyedTimers<HTMLElement>();\n\n  /** The stand-in last generated per absent target, which may have left the document since. */\n  readonly #generated = new Map<Level, HTMLElement>();\n\n  /** The stand-in marker, in the namespace this controller is registered under. */\n  get #standIn(): string {\n    return `data-${this.identifier}-${STAND_IN}`;\n  }\n\n  /** The written-message marker, in the namespace this controller is registered under. */\n  get #announced(): string {\n    return `data-${this.identifier}-${ANNOUNCED}`;\n  }\n\n  /** Messages waiting to be written, oldest first, one queue per politeness. */\n  readonly #queues = new Map<Level, string[]>();\n\n  /** Politeness levels whose next drain is already armed. */\n  readonly #draining = new Set<Level>();\n\n  /** Collapses a batch of target callbacks (and morph removals) into one pass. */\n  readonly #reconcile = new MicrotaskCoalescer(() => this.#reconcileRegions());\n\n  /**\n   * Watches the host's own children for a generated region disappearing. A morph\n   * drops it — the server's HTML never had it — and no target callback reports\n   * that, because a generated region carries no target attribute. `subtree` stays\n   * off so writing a message inside a region does not re-enter this pass.\n   */\n  readonly #hostWatch = new MutationObserver(() => {\n    this.#reconcile.schedule();\n  });\n\n  /**\n   * Guards against handling the same CustomEvent twice. An event dispatched on\n   * the controller element with `bubbles: true` reaches both the element and the\n   * `window` listener; this WeakSet ensures it announces only once.\n   */\n  readonly #handled = new WeakSet<Event>();\n\n  /** Receives programmatic announcements at the element or bubbled to `window`. */\n  readonly #onAnnounceEvent = (event: Event): void => {\n    if (this.#handled.has(event)) return;\n    this.#handled.add(event);\n    const detail = (event as CustomEvent<unknown>).detail;\n    const message = this.#messageFromDetail(detail);\n    if (!message) return;\n    this.#announce(message, this.#assertiveFromDetail(detail));\n  };\n\n  /**\n   * Seats the regions and starts listening. The reconnection that completes an in-page\n   * move or a permanent carry finds all of it in place, the queues and timers included.\n   */\n  override connect(): void {\n    const moved = this.#gate.pending;\n    this.#gate.cancel();\n    if (moved) return;\n    this.#reconcile.activate();\n    this.#dropInheritedStandIns();\n    this.#emptyInheritedMessages();\n    // Materialise any missing region now, so it is in the accessibility tree\n    // before the first message rather than appearing with it.\n    this.#reconcileRegions();\n    this.#hostWatch.observe(this.element, { childList: true });\n    this.element.addEventListener(\"stimeo--announcer:announce\", this.#onAnnounceEvent);\n    window.addEventListener(\"stimeo--announcer:announce\", this.#onAnnounceEvent);\n  }\n\n  /** Tears everything down once the element is really detached. */\n  override disconnect(): void {\n    this.#gate.disconnected(this, () => this.#teardown());\n  }\n\n  /** Releases the listeners, the queues, the timers and the stand-ins. */\n  #teardown(): void {\n    this.#reconcile.cancel();\n    this.#hostWatch.disconnect();\n    this.element.removeEventListener(\"stimeo--announcer:announce\", this.#onAnnounceEvent);\n    window.removeEventListener(\"stimeo--announcer:announce\", this.#onAnnounceEvent);\n    this.#timers.clearAll();\n    this.#regionTimers.clearAll();\n    this.#queues.clear();\n    this.#draining.clear();\n    this.#removeGenerated();\n  }\n\n  /** Retires the stand-in once the consumer supplies a polite region. */\n  politeTargetConnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Materialises a stand-in once the consumer's polite region goes away. */\n  politeTargetDisconnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Retires the stand-in once the consumer supplies an assertive region. */\n  assertiveTargetConnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Materialises a stand-in once the consumer's assertive region goes away. */\n  assertiveTargetDisconnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /**\n   * Brings the region set back to exactly one region per politeness and reports\n   * whether anything had to be created.\n   *\n   * A region created here is not written to in the same task: assistive tech\n   * reports changes to regions it already knows about, so {@link drain} waits a\n   * task whenever this says a region is new.\n   */\n  #reconcileRegions(): boolean {\n    let created = false;\n    for (const level of LEVELS) {\n      if (this.#hasTargetFor(level)) {\n        // The consumer owns this politeness now; a stand-in would be a second\n        // region for it, and an empty one nothing ever writes to.\n        this.#generated.get(level)?.remove();\n        continue;\n      }\n      const existing = this.#generated.get(level);\n      if (existing?.isConnected) continue;\n      this.#generated.set(level, this.#createRegion(level));\n      created = true;\n    }\n    return created;\n  }\n\n  /** Whether the consumer supplied a target for `level`. */\n  #hasTargetFor(level: Level): boolean {\n    return level === \"assertive\" ? this.hasAssertiveTarget : this.hasPoliteTarget;\n  }\n\n  /** Builds a visually hidden, marked live region for `level` and attaches it. */\n  #createRegion(level: Level): HTMLElement {\n    const region = document.createElement(\"div\");\n    region.setAttribute(\"aria-live\", level);\n    region.setAttribute(\"aria-atomic\", \"true\");\n    region.setAttribute(this.#standIn, \"\");\n    visuallyHide(region);\n    this.element.appendChild(region);\n    return region;\n  }\n\n  /** Removes the stand-ins the host arrived with; see the class remarks. */\n  #dropInheritedStandIns(): void {\n    for (const child of Array.from(this.element.children)) {\n      if (child.hasAttribute(this.#standIn)) child.remove();\n    }\n  }\n\n  /**\n   * Empties the authored regions that hold a message this controller wrote, which no\n   * clearing timer of this connection is left to clear; see the class remarks.\n   */\n  #emptyInheritedMessages(): void {\n    for (const region of [...this.politeTargets, ...this.assertiveTargets]) {\n      if (!region.hasAttribute(this.#announced)) continue;\n      region.replaceChildren();\n      region.removeAttribute(this.#announced);\n    }\n  }\n\n  /** Removes the stand-ins this connection generated; authored targets stay. */\n  #removeGenerated(): void {\n    for (const region of this.#generated.values()) region.remove();\n  }\n\n  /**\n   * Announces a message. Reads the text from a Stimulus action param\n   * (`message`, plus optional `assertive`) for attribute-only triggers, falling\n   * back to a CustomEvent `detail` when the same handler is wired to an event.\n   * An empty/non-string message is ignored so untrusted payloads cannot blank\n   * the region.\n   */\n  announce(event: Event): void {\n    const params = (event as { params?: Record<string, unknown> }).params;\n    const fromParam = params?.message;\n    const message =\n      typeof fromParam === \"string\" && fromParam.length > 0\n        ? fromParam\n        : this.#messageFromDetail((event as CustomEvent<unknown>).detail);\n    if (!message) return;\n\n    const assertive =\n      params?.assertive === true ||\n      this.#assertiveFromDetail((event as CustomEvent<unknown>).detail);\n    this.#announce(message, assertive);\n  }\n\n  /**\n   * Queues `message` for its politeness and arms the drain.\n   *\n   * Queuing is what makes a burst audible: assistive tech announces the changes it\n   * observes, so several messages written into one region within a single task are\n   * one change and only the last is read.\n   */\n  #announce(message: string, assertive: boolean): void {\n    const level: Level = assertive ? \"assertive\" : \"polite\";\n    const queue = this.#queues.get(level);\n    if (queue) {\n      queue.push(message);\n    } else {\n      this.#queues.set(level, [message]);\n    }\n    this.#scheduleDrain(level);\n  }\n\n  /** Arms one drain pass for `level`; further messages ride the pass already armed. */\n  #scheduleDrain(level: Level): void {\n    if (this.#draining.has(level)) return;\n    this.#draining.add(level);\n    this.#timers.set(() => {\n      this.#draining.delete(level);\n      this.#drain(level);\n    }, 0);\n  }\n\n  /**\n   * Writes one queued message, then arms the next pass while the queue holds more.\n   *\n   * Two steps take a whole pass without consuming the message: materialising a\n   * region (it has to be in the accessibility tree before the text arrives) and\n   * emptying a region that already holds this exact text (an unchanged node is not\n   * re-read, so `dedupeReannounce` clears first and writes on the following pass).\n   *\n   * @stimeoRuntimeOnly `dedupeReannounce` decides whether one queued message is spoken again; the\n   *   region's text is the message itself.\n   */\n  #drain(level: Level): void {\n    const queue = this.#queues.get(level);\n    const message = queue?.[0];\n    if (queue === undefined || message === undefined) return;\n\n    const created = this.#reconcileRegions();\n    const region = this.#regionFor(level);\n    // With nothing created every politeness has a seated region; the second check\n    // narrows the type.\n    if (created || region === undefined) {\n      this.#scheduleDrain(level);\n      return;\n    }\n\n    if (this.dedupeReannounceValue && region.textContent === message) {\n      region.textContent = \"\";\n      this.#scheduleDrain(level);\n      return;\n    }\n\n    queue.shift();\n    // A non-positive `clearAfter` arms nothing below, so the region's pending\n    // timer is released here rather than by the arming that replaces it.\n    this.#regionTimers.clear(region);\n    region.textContent = message;\n    region.setAttribute(this.#announced, \"\");\n    this.#scheduleClear(region, message);\n    if (queue.length > 0) this.#scheduleDrain(level);\n  }\n\n  /**\n   * Clears the region after `clearAfter` ms, unless a newer message replaced it.\n   *\n   * @stimeoRuntimeOnly `clearAfter` is the delay of the one clearing timer this call arms.\n   */\n  #scheduleClear(region: HTMLElement, message: string): void {\n    if (this.#safeClearAfter <= 0) return;\n    this.#regionTimers.set(\n      region,\n      () => {\n        if (region.textContent !== message) return;\n        region.textContent = \"\";\n        region.removeAttribute(this.#announced);\n      },\n      this.#safeClearAfter,\n    );\n  }\n\n  /**\n   * The region a politeness writes into: its target, else its last stand-in. A\n   * morph can drop the stand-in, and only a reconcile pass that created nothing\n   * guarantees it is seated; a detached node announces nothing.\n   */\n  #regionFor(level: Level): HTMLElement | undefined {\n    if (level === \"assertive\" && this.hasAssertiveTarget) return this.assertiveTarget;\n    if (level === \"polite\" && this.hasPoliteTarget) return this.politeTarget;\n    return this.#generated.get(level);\n  }\n\n  /** Extracts a non-empty string `message` from a CustomEvent detail, else null. */\n  #messageFromDetail(detail: unknown): string | null {\n    if (detail && typeof detail === \"object\" && \"message\" in detail) {\n      const value = (detail as Record<string, unknown>).message;\n      if (typeof value === \"string\" && value.length > 0) return value;\n    }\n    return null;\n  }\n\n  /** Reads an `assertive === true` flag from a CustomEvent detail (default polite). */\n  #assertiveFromDetail(detail: unknown): boolean {\n    return (\n      !!detail &&\n      typeof detail === \"object\" &&\n      (detail as Record<string, unknown>).assertive === true\n    );\n  }\n  /** Current `clearAfter` declaration resolved against its numeric contract. */\n  get #safeClearAfter(): number {\n    return this.#numbers.read(\n      this,\n      \"clearAfter\",\n      this.clearAfterValue,\n      AnnouncerController.values.clearAfter.default,\n      AnnouncerController.valueConstraints.clearAfter,\n    );\n  }\n}\n\n/**\n * Applies the canonical visually-hidden (\"sr-only\") inline style to a generated\n * live region so its text is announced without being seen. Inline so the library\n * stays self-contained when the consumer provides no target/CSS of its own.\n *\n * Pure (no `this`); exported for direct unit testing.\n */\nexport function visuallyHide(node: HTMLElement): void {\n  const { style } = node;\n  style.position = \"absolute\";\n  style.width = \"1px\";\n  style.height = \"1px\";\n  style.margin = \"-1px\";\n  style.padding = \"0\";\n  style.border = \"0\";\n  style.overflow = \"hidden\";\n  style.clip = \"rect(0 0 0 0)\";\n  style.clipPath = \"inset(50%)\";\n  style.whiteSpace = \"nowrap\";\n}\n"]}
+{"version":3,"sources":["../../src/utils/detach_gate.ts","../../src/utils/timer_bounds.ts","../../src/utils/safe_timeout.ts","../../src/utils/keyed_timers.ts","../../src/utils/listener_set.ts","../../src/utils/microtask_coalescer.ts","../../src/utils/number_bounds.ts","../../src/utils/coerce.ts","../../src/utils/number_value.ts","../../src/utils/attribute_write.ts","../../src/utils/owned_text.ts","../../src/controllers/announcer_controller.ts"],"names":[],"mappings":"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","file":"announcer_controller.js","sourcesContent":["/**\n * Shared \"in-page move vs real detach\" discriminator for `disconnect()`.\n *\n * A mid-session `disconnect()` whose element is still in the document is\n * ambiguous. It can be:\n *\n * - an **in-page move** — a consumer (sortable, a teleport) re-inserted the\n *   element; Stimulus reconnects the SAME instance in the same mutation batch\n *   and the controller's runtime state must survive;\n * - a **detach that keeps the element** — `data-controller` no longer lists the\n *   identifier (a Turbo 8 morph), or the element moved outside the observed\n *   root (a scoped `Application.start(root)`, a shadow root); no reconnect will\n *   ever come and the controller must tear down or it leaks its sessions,\n *   document listeners, and moved nodes.\n *\n * Neither available signal decides this alone. A synchronous `data-controller`\n * token check catches the morph case but misses an observed-root exit (the\n * token stays, the reconnect never comes). Deferring teardown one microtask and\n * letting `connect()` cancel it catches the root exit, but leans on Stimulus\n * reconnecting moved elements within the same mutation batch — internal\n * behavior, not a public contract. {@link DetachGate} composes both: the token\n * check is the synchronous fast path (no probe, no reliance on batching), the\n * microtask probe is the fallback for the genuinely ambiguous remainder.\n *\n * An element out of the document is a real detach, with one exception: a\n * `data-turbo-permanent` element, or one inside it, that Turbo carries to the\n * next page. Turbo takes it out of the old `<body>`, which Stimulus answers with\n * a `disconnect()` while it is out of the document, and puts it into the new one\n * a few microtasks later in the same task, where the same instance connects\n * again. Such a disconnect is probed until the next task instead.\n *\n * Policy stays with the consumer; this util owns the discrimination only:\n *\n * - **Probe** ({@link disconnected}) when the teardown must eventually happen —\n *   live drag sessions, document listeners, teleported *content*. Call\n *   {@link cancel} from `connect()` (a reconnect means in-page move) and from\n *   the head of any direct teardown path (see below).\n * - **Keep** (bare {@link DetachGate.isDetached}) when undoing the ambiguous\n *   case would fight the controller's own effect: a controller that moves its\n *   OWN element (portal's no-`content` form) exits a scoped observed root as\n *   its normal job — a probe-driven teardown would restore the element into\n *   the root, reconnect, re-teleport, and disconnect again, forever. Such\n *   controllers keep their state on an ambiguous disconnect and tear down only\n *   on {@link DetachGate.isDetached}.\n *\n * Event convention for probe consumers: teardown into a dead (detached) tree is\n * silent — consumers restore from their own `connect()`; a detach that keeps the\n * tree alive must end an in-flight session with a `cancel` event, or composing\n * consumers strand their session bookkeeping.\n */\n\n/** The slice of a Stimulus controller the gate inspects. */\nexport interface DetachGateHost {\n  readonly element: Element;\n  readonly identifier: string;\n}\n\n/**\n * Per-controller-instance gate deciding whether a `disconnect()` is a real\n * detach. Hold one per controller (`#gate = new DetachGate()`) — Stimulus\n * reuses the instance across reconnects, so the pending probe state carries\n * over exactly as the protocol needs.\n *\n * @example\n * ```ts\n * #gate = new DetachGate();\n *\n * connect(): void {\n *   this.#gate.cancel(); // a reconnect: the element moved in-page\n *   // …\n * }\n *\n * disconnect(): void {\n *   this.#gate.disconnected(this, () => this.#teardown());\n * }\n *\n * dismiss(): void {\n *   this.#gate.cancel(); // a direct path: disarm a probe a disconnect queued\n *   this.#teardown();\n * }\n *\n * #teardown(): void {\n *   // … (`disconnected` has already disarmed the probe on its own path)\n * }\n * ```\n */\nexport class DetachGate {\n  /** Set while a probe is queued, waiting for a reconnect to cancel it. */\n  #pending = false;\n\n  /**\n   * True while a probe is queued — the last disconnect was ambiguous and no\n   * reconnect has cancelled it yet. Read it from `connect()` to tell the\n   * reconnect half of an in-page move from a first connect: a controller whose\n   * initialisation restarts a measurement (a min-duration floor, an elapsed\n   * counter) must skip it for the move, where nothing actually restarted.\n   */\n  get pending(): boolean {\n    return this.#pending;\n  }\n\n  /**\n   * True when the disconnect is definitely a real detach — the element left\n   * the document, or `data-controller` no longer lists the identifier. False\n   * means ambiguous (in-page move or observed-root exit), NOT \"alive\".\n   */\n  static isDetached(host: DetachGateHost): boolean {\n    return !host.element.isConnected || !DetachGate.#listed(host);\n  }\n\n  /**\n   * Call from `disconnect()`: runs `teardown` synchronously on a definite\n   * detach (fast path), otherwise defers it one microtask — a reconnect\n   * ({@link cancel} from `connect()`) keeps the state, no reconnect runs it.\n   * One microtask is the whole probe window: Stimulus reconnects a moved\n   * element within the same mutation batch, before the checkpoint drains. An\n   * element Turbo carries to the next page is probed until the next task, by\n   * which time Turbo has put it back.\n   */\n  disconnected(host: DetachGateHost, teardown: () => void): void {\n    const carried = DetachGate.#carried(host);\n    if (!carried && DetachGate.isDetached(host)) {\n      // Also disarms a probe a previous ambiguous disconnect left queued\n      // (defer, element removed, disconnect again) — exactly one teardown.\n      this.#pending = false;\n      teardown();\n      return;\n    }\n    this.#pending = true;\n    const probe = (): void => {\n      if (!this.#pending) return;\n      this.#pending = false;\n      teardown();\n    };\n    if (carried) setTimeout(probe, 0);\n    else queueMicrotask(probe);\n  }\n\n  /**\n   * Whether `host` is out of the document inside a `data-turbo-permanent` element, its\n   * identifier still listed: where Turbo holds an element it carries to the next page.\n   */\n  static #carried(host: DetachGateHost): boolean {\n    const element = host.element;\n    return (\n      !element.isConnected &&\n      element.closest(\"[data-turbo-permanent]\") !== null &&\n      DetachGate.#listed(host)\n    );\n  }\n\n  /** Whether the element's `data-controller` still lists the identifier. */\n  static #listed(host: DetachGateHost): boolean {\n    const tokens = (host.element.getAttribute(\"data-controller\") ?? \"\").split(/\\s+/);\n    return tokens.includes(host.identifier);\n  }\n\n  /**\n   * Disarms a pending probe. Call from `connect()` (the reconnect that proves\n   * an in-page move) and from the head of any teardown path not routed through\n   * {@link disconnected} (disabled-toggle, Escape), so an orphaned probe can\n   * never run the teardown a second time.\n   */\n  cancel(): void {\n    this.#pending = false;\n  }\n}\n","/**\n * Largest delay a timer can hold: the platform stores it in a 32-bit signed\n * integer, and anything larger wraps around, so a delay meant to be far in the\n * future can fire almost immediately. A declared delay above this bound names\n * no delay at all, and a controller reading one falls back to its default.\n */\nexport const MAX_TIMER_DELAY_MS = 2_147_483_647;\n","/**\n * Self-cleaning timer registries shared by Stimeo controllers.\n *\n * Stimulus controllers frequently schedule `setTimeout` / `setInterval` work\n * (auto-dismiss, debouncing, polling). When the element leaves the DOM — a\n * Turbo Drive navigation, a Turbo Stream replacement, or any `disconnect()` —\n * orphaned timers keep firing against a detached controller, leaking memory and\n * mutating stale state. {@link SafeTimeout} and {@link SafeInterval} track every\n * timer they create so a single {@link TimerRegistry.clearAll | clearAll()} call\n * in `disconnect()` tears them all down.\n *\n * These are intentionally low-level primitives: they own *registration and\n * cleanup only*. One pending timer per key is `KeyedTimers`\n * (`keyed_timers.ts`), and a timer a person can hold open, with its remaining-time\n * accounting, is `PausableTimers` (`pausable_timers.ts`).\n */\n\nexport { MAX_TIMER_DELAY_MS } from \"./timer_bounds\";\n\n/**\n * Shared registry bookkeeping for the timeout/interval variants.\n *\n * Subclasses provide the scheduling primitive ({@link schedule}) and its matching\n * canceller ({@link cancel}); this base owns the set of live ids plus the\n * per-id and bulk teardown shared by both.\n */\nabstract class TimerRegistry {\n  /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */\n  protected readonly ids = new Set<number>();\n\n  /** Schedules the underlying platform timer and returns its id. */\n  protected abstract schedule(callback: () => void, delay: number): number;\n\n  /** Cancels the underlying platform timer for `id`. */\n  protected abstract cancel(id: number): void;\n\n  /**\n   * Cancels a single tracked timer.\n   *\n   * No-ops if the id is unknown (already cleared, fired, or never owned by this\n   * registry), so callers can clear defensively without guarding.\n   */\n  clear(id: number): void {\n    if (this.ids.delete(id)) {\n      this.cancel(id);\n    }\n  }\n\n  /**\n   * Cancels every tracked timer. Call this from a controller's `disconnect()`\n   * to guarantee no timer outlives the element.\n   */\n  clearAll(): void {\n    for (const id of this.ids) {\n      this.cancel(id);\n    }\n    this.ids.clear();\n  }\n\n  /** Number of timers currently tracked (pending). */\n  get size(): number {\n    return this.ids.size;\n  }\n}\n\n/**\n * `setTimeout` wrapper that auto-forgets each timer once it fires and supports\n * bulk teardown on disconnect.\n *\n * @example\n * ```ts\n * #timers = new SafeTimeout();\n *\n * connect() {\n *   this.#timers.set(() => this.dismiss(), 5000);\n * }\n *\n * disconnect() {\n *   this.#timers.clearAll();\n * }\n * ```\n */\nexport class SafeTimeout extends TimerRegistry {\n  /**\n   * Schedules `callback` after `delay` ms and returns the timer id.\n   *\n   * The id is removed from the registry automatically when the timeout fires,\n   * so {@link TimerRegistry.size | size} reflects only still-pending timers.\n   */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(() => {\n      this.ids.delete(id);\n      callback();\n    }, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setTimeout(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearTimeout(id);\n  }\n}\n\n/**\n * `setInterval` wrapper that tracks every interval for bulk teardown on\n * disconnect. Unlike {@link SafeTimeout}, intervals are retained until they are\n * explicitly cleared because they fire repeatedly.\n *\n * @example\n * ```ts\n * #intervals = new SafeInterval();\n *\n * connect() {\n *   this.#intervals.set(() => this.tick(), 1000);\n * }\n *\n * disconnect() {\n *   this.#intervals.clearAll();\n * }\n * ```\n */\nexport class SafeInterval extends TimerRegistry {\n  /** Schedules a repeating `callback` every `delay` ms and returns the timer id. */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(callback, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setInterval(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearInterval(id);\n  }\n}\n","import { SafeTimeout } from \"./safe_timeout\";\n\n/**\n * Keeps at most one pending timer per key, and releases them all together.\n *\n * A region, a row, a message or a speaker that is armed again while its earlier\n * timer is still pending must end up with exactly one timer deciding when its\n * state ends. Two timers on one key means the earlier deadline wins: it cuts the\n * new emphasis short, clears text written after it, or drops a speaker who is\n * still typing — and then reports an ending for a state that is already gone.\n * Arming through this registry cancels the key's earlier timer in the same step,\n * and no timer id ever reaches the caller.\n *\n * An entry lives exactly as long as its timer: it goes as the timer fires, and\n * the whole ledger goes on `clearAll()`. That is a correctness rule, not\n * tidiness — a platform may hand an id released by `clearTimeout` to the next\n * timer it creates, so an entry that outlived its timer would let a later\n * `clear()` on that key cancel whatever timer now holds the id, on some other\n * key entirely.\n *\n * The ledger is a plain `Map`, and the key may be anything. Weak keys would\n * retain nothing less: while a timer is pending the platform already holds the\n * key through the callback, and the entry is gone the moment the timer is.\n *\n * Scope is the one-per-key timer only. What the timer means, and the roster of\n * keys it is armed for, stay with the consumer, so a second kind of timer on the\n * same keys (a transition wait, an animation frame) is a second registry, and a\n * timer that belongs to no key stays on a plain `SafeTimeout`.\n *\n * @example\n * ```ts\n * readonly #expiry = new KeyedTimers<string>();\n *\n * #onSignal(name: string): void {\n *   this.#expiry.set(name, () => this.#drop(name), this.#timeout);\n * }\n *\n * disconnect(): void {\n *   this.#expiry.clearAll();\n * }\n * ```\n */\nexport class KeyedTimers<K> {\n  readonly #timers = new SafeTimeout();\n\n  /** The pending timer of each key; an entry lives exactly as long as its timer. */\n  readonly #pending = new Map<K, number>();\n\n  /**\n   * Arms `callback` after `delay` ms for `key`, cancelling the timer `key` had\n   * pending. The entry is dropped before the callback runs, so the callback sees\n   * the key unarmed and may arm it again for the next round.\n   */\n  set(key: K, callback: () => void, delay: number): void {\n    this.clear(key);\n    const id = this.#timers.set(() => {\n      this.#pending.delete(key);\n      callback();\n    }, delay);\n    this.#pending.set(key, id);\n  }\n\n  /**\n   * Cancels `key`'s pending timer, if it has one.\n   *\n   * A timer id is a positive integer, so `-1` stands for \"nothing pending\" and\n   * the registry ignores an id it does not own — the unarmed case needs no\n   * branch of its own, and no other key's timer can be reached from here.\n   */\n  clear(key: K): void {\n    this.#timers.clear(this.#pending.get(key) ?? -1);\n    this.#pending.delete(key);\n  }\n\n  /**\n   * Cancels every pending timer and forgets every key. Call this from a\n   * controller's `disconnect()` so no timer, and no entry, outlives the element.\n   */\n  clearAll(): void {\n    this.#timers.clearAll();\n    this.#pending.clear();\n  }\n\n  /** Whether `key` has a timer pending. */\n  has(key: K): boolean {\n    return this.#pending.has(key);\n  }\n}\n","/** What {@link ListenerSet.add} passes on besides the signal it supplies itself. */\nexport type ListenerOptions = Omit<AddEventListenerOptions, \"signal\">;\n\n/**\n * The event map a target's own `addEventListener` types its handlers with: the\n * window's, a document's, an HTML or SVG element's, any other element's, or a\n * media query list's. Other targets name none.\n */\ntype EventMapOf<T extends EventTarget> = T extends Window\n  ? WindowEventMap\n  : T extends Document\n    ? DocumentEventMap\n    : T extends HTMLElement\n      ? HTMLElementEventMap\n      : T extends SVGElement\n        ? SVGElementEventMap\n        : T extends Element\n          ? ElementEventMap\n          : T extends MediaQueryList\n            ? MediaQueryListEventMap\n            : Record<never, never>;\n\n/**\n * Owns every listener a controller attaches for one connected lifetime and\n * releases them together, so an event name is spelled once and the release\n * cannot drift from the registration.\n *\n * Detaching by hand repeats three things at the release site — the type, the\n * handler reference and the capture flag — and any one of them drifting leaves\n * a listener alive on an element the controller no longer drives. Aborting the\n * signal a registration was created with releases it whatever it was made of,\n * so the release site names nothing.\n *\n * One set per lifetime, held as a field and never rebuilt.\n * {@link ListenerSet.dispose} is the only thing that closes a generation, and it opens\n * the next one in the same step, so the lifecycle hooks can call `add` and\n * `dispose` in any order any number of times, and no `add` ever meets an\n * already aborted signal — a DOM that registers a listener on such a signal\n * would keep it forever. Rebuilding the set instead would leak:\n * `addEventListener` matches an existing registration on target, type, callback\n * and capture alone, so re-adding the same handler while the first registration\n * is live is discarded, and that live registration keeps the signal it was\n * attached with — a set built by a second `connect()` can never release what it\n * appears to own.\n *\n * Scope is the registration only. Timers, observers, leases and the order they\n * are unwound in stay with the controller, which places `dispose()` in its\n * cleanup sequence. A receiver that changes at runtime (a\n * swapped target) is rebound by calling `dispose()` and then `add()` again from\n * the rebind, not by a second set.\n *\n * A lifetime shorter than the connection — while a Value holds, until a first\n * load, while a subscription is open — gets a set of its own, which the end of\n * that lifetime disposes. A controller therefore holds one set per lifetime: the\n * connection's, and one for each swapped receiver or shorter span.\n *\n * The set must own every registration of a tuple it holds: a listener the same\n * target already carries for the same type, callback and capture flag keeps the\n * right to remove it, and this set's `add` for that tuple is discarded. A\n * subscription shared between instances behind a participant count, listeners of\n * several elements that come and go one at a time, and those one gesture holds\n * keep their own pair of calls or a signal of their own.\n *\n * @example\n * ```ts\n * readonly #listeners = new ListenerSet();\n *\n * connect(): void {\n *   this.#listeners.add(this.element, \"submit\", this.#onNativeSubmit, { capture: true });\n *   this.#listeners.add(this.element, \"turbo:submit-start\", this.#onSubmitStart);\n *   this.#listeners.add(this.element, \"turbo:submit-end\", this.#onSubmitEnd);\n * }\n *\n * disconnect(): void {\n *   this.#listeners.dispose();\n * }\n * ```\n */\nexport class ListenerSet {\n  /** The generation every `add` joins until the next `dispose()`. */\n  #abort = new AbortController();\n\n  /**\n   * Attaches `handler` to the open generation, exactly as the caller spelled it.\n   *\n   * The set supplies the signal, so `options` carries everything else the DOM\n   * accepts — `capture` included. A removal by hand would have to repeat that\n   * flag; aborting the signal releases the listener without it.\n   *\n   * A `type` the target's own event map names types `handler` with that event,\n   * as the target's `addEventListener` does, so a handler written for a\n   * `KeyboardEvent` is passed as it is; any other `type` takes an\n   * `EventListener`.\n   */\n  add<T extends EventTarget, K extends keyof EventMapOf<T> & string>(\n    target: T,\n    type: K,\n    handler: (event: EventMapOf<T>[K]) => void,\n    options?: ListenerOptions,\n  ): void;\n  add(target: EventTarget, type: string, handler: EventListener, options?: ListenerOptions): void;\n  add(target: EventTarget, type: string, handler: EventListener, options?: ListenerOptions): void {\n    target.addEventListener(type, handler, { ...options, signal: this.#abort.signal });\n  }\n\n  /**\n   * Releases every listener of the open generation, synchronously, and opens the\n   * next one. Idempotent, and safe before anything has been added.\n   */\n  dispose(): void {\n    this.#abort.abort();\n    this.#abort = new AbortController();\n  }\n}\n","/**\n * Collapses many Stimulus lifecycle callbacks from one DOM mutation into a\n * single pass.\n *\n * Stimulus fires `<name>TargetConnected` / `Disconnected` once per element and\n * `<name>ValueChanged` once per changed attribute. Replacing a list of N options\n * or morphing several render Values therefore delivers N callbacks — but the\n * useful unit of work is \"reconcile against the resulting declarative input\",\n * once, after the batch has settled. Every controller with reconcilable targets\n * or render Values needs the same shape: a `queued` flag plus `queueMicrotask`.\n *\n * **A microtask is the right horizon, and the reason is specific.** Stimulus\n * drives these callbacks from a `MutationObserver`, whose own callback already\n * runs as a microtask with the whole batch in hand; scheduling one more lands\n * after the last sibling callback of that batch and still before paint or any\n * event handler. A timer would be later than it needs to be, and reconciling\n * synchronously would run once per element against a half-applied DOM.\n *\n * **The two guards are not the same guard.** Scheduling is refused before the\n * controller connects, and running is refused after it disconnects:\n *\n * - **Before `connect()`** — Stimulus delivers initial target and Value callbacks\n *   ahead of `connect()`. Reconciling there would compute output against a\n *   controller whose own state has not been initialised, and `connect()` is\n *   about to do a full pass anyway.\n * - **After `disconnect()`** — Stimulus fires a callback for **every** target\n *   during teardown, and a microtask queued just before it would otherwise run\n *   against a detached tree. {@link MicrotaskCoalescer.cancel} exists for the\n *   teardown path to drop the pending pass outright.\n *\n * Both guards are part of one contract here rather than something each consumer\n * has to remember separately.\n *\n * Scope is the scheduling only. *What* to reconcile — keep the surviving active\n * option, fall back to the next / previous / first visible one, rebuild derived\n * chips or hidden fields — stays in the controller, because no two consumers\n * answer it the same way.\n *\n * @example\n * ```ts\n * readonly #reconcile = new MicrotaskCoalescer(() => this.#reconcileOptions());\n *\n * connect()    { this.#reconcile.activate(); }\n * disconnect() { this.#reconcile.cancel(); }\n *\n * optionTargetConnected()    { this.#reconcile.schedule(); }\n * optionTargetDisconnected() { this.#reconcile.schedule(); }\n * ```\n */\nexport class MicrotaskCoalescer {\n  readonly #run: () => void;\n  #queued = false;\n  #active = false;\n  #generation = 0;\n\n  /** @param run - the single reconciliation pass, invoked at most once per batch. */\n  constructor(run: () => void) {\n    this.#run = run;\n  }\n\n  /** Opens the window in which {@link schedule} is honoured; call from `connect()`. */\n  activate(): void {\n    this.#active = true;\n  }\n\n  /** Closes the window and drops any pending pass; call from `disconnect()`. */\n  cancel(): void {\n    this.#active = false;\n    this.#queued = false;\n    this.#generation += 1;\n  }\n\n  /** Whether a requested pass has yet to run. */\n  get pending(): boolean {\n    return this.#queued;\n  }\n\n  /** Requests one pass after the batch settles. Idempotent; inert outside the window. */\n  schedule(): void {\n    if (!this.#active || this.#queued) return;\n    this.#queued = true;\n    const generation = this.#generation;\n    queueMicrotask(() => {\n      // A cancelled callback must not consume a pass queued after reconnect.\n      if (generation !== this.#generation || !this.#queued || !this.#active) return;\n      this.#queued = false;\n      this.#run();\n    });\n  }\n}\n","import { MAX_TIMER_DELAY_MS } from \"./timer_bounds\";\n\n/** Semantic constraints on an already decoded number, independent of the DOM. */\nexport interface NumberBounds {\n  /** Finite numbers are required, including when this field is omitted. */\n  readonly finite?: true;\n  /** Inclusive lower endpoint. */\n  readonly min?: number;\n  /** Inclusive upper endpoint. */\n  readonly max?: number;\n  /** Exclusive lower endpoint. */\n  readonly exclusiveMin?: number;\n  /** Require a number without a fractional part. */\n  readonly integer?: boolean;\n  /** Exact decoded numbers accepted by a discrete contract. */\n  readonly allowedValues?: readonly number[];\n  /** JSON-safe exceptions to finite-number checking for unbounded endpoints. */\n  readonly allowInfinity?: \"negative\" | \"positive\" | \"both\";\n}\n\n/** One constraint for each Number Value, including shorthand declarations. */\nexport type NumberValueConstraints<Values> = {\n  readonly [Key in keyof Values as Values[Key] extends\n    | NumberConstructor\n    | { type: NumberConstructor }\n    ? Key\n    : never]: NumberBounds;\n};\n\n/** Reusable semantic domains; fractional inputs remain fractional unless excluded. */\nexport const NUMBER_BOUNDS = {\n  finite: { finite: true },\n  nonNegative: { finite: true, min: 0 },\n  positive: { finite: true, exclusiveMin: 0 },\n  nonNegativeInteger: { finite: true, min: 0, integer: true },\n  positiveInteger: { finite: true, exclusiveMin: 0, integer: true },\n  lowerBound: { finite: true, allowInfinity: \"negative\" },\n  upperBound: { finite: true, allowInfinity: \"positive\" },\n  timer: { finite: true, min: 0, max: MAX_TIMER_DELAY_MS },\n  positiveTimer: { finite: true, exclusiveMin: 0, max: MAX_TIMER_DELAY_MS },\n} as const satisfies Record<string, NumberBounds>;\n\n/**\n * Checks all declared bounds without rounding, clamping, or coercing the input.\n * Infinity exceptions relax only finite checking; every other bound still applies.\n */\nexport function matchesNumberBounds(value: number, bounds: NumberBounds): boolean {\n  if (!Number.isFinite(value)) {\n    const direction = value === Infinity ? \"positive\" : value === -Infinity ? \"negative\" : null;\n    if (direction === null) return false;\n    if (bounds.allowInfinity !== \"both\" && bounds.allowInfinity !== direction) return false;\n  }\n  if (bounds.min !== undefined && value < bounds.min) return false;\n  if (bounds.max !== undefined && value > bounds.max) return false;\n  if (bounds.exclusiveMin !== undefined && value <= bounds.exclusiveMin) return false;\n  if (bounds.integer && !Number.isInteger(value)) return false;\n  if (bounds.allowedValues !== undefined && !bounds.allowedValues.includes(value)) return false;\n  return true;\n}\n\n/** Decodes a Number Value literal; action params use their own JSON decoder. */\nexport function decodeNumberValue(raw: string): number {\n  return Number(raw.replace(/_/g, \"\"));\n}\n","/**\n * Numeric coercion for controllers that accept a number through a Value, an action\n * param, or an event detail.\n *\n * Stimulus decodes action params as JSON when possible and leaves other text\n * untouched. CustomEvent detail can also supply a number or numeric string.\n * The reader accepts those two types while rejecting blank and non-finite input.\n */\n\nimport { matchesNumberBounds, type NumberBounds } from \"./number_bounds\";\n\n/** Numeric update input, accepting decoded action params before CustomEvent detail. */\nexport type NumericValueEvent = Event & {\n  params?: { amount?: unknown };\n  detail?: { value?: unknown };\n};\n\n/** Reads the nullish action-param/detail precedence without falling back from invalid input. */\nexport function eventNumber(event: NumericValueEvent): number | null {\n  return toFiniteNumber(event.params?.amount ?? event.detail?.value);\n}\n\n/**\n * Reads a finite number or nonblank numeric string; other input returns `null`.\n * Blank strings cannot silently reset a value to zero.\n */\nexport function toFiniteNumber(raw: unknown): number | null {\n  if (typeof raw !== \"number\" && typeof raw !== \"string\") return null;\n  if (typeof raw === \"string\" && raw.trim().length === 0) return null;\n  const value = Number(raw);\n  return Number.isFinite(value) ? value : null;\n}\n\n/**\n * Returns an accepted decoded Number Value or the caller's fallback unchanged.\n * The caller owns the fallback contract; this reader does not parse or write a Value.\n */\nexport function readNumber(raw: number, fallback: number, bounds: NumberBounds): number {\n  return matchesNumberBounds(raw, bounds) ? raw : fallback;\n}\n","import { readNumber } from \"./coerce\";\nimport { matchesNumberBounds, type NumberBounds } from \"./number_bounds\";\n\n/** The instance identity carried by a Number Value read. */\nexport interface NumberValueOwner {\n  readonly identifier: string;\n  readonly element: Element;\n}\n\n/** Reads current declarations at the point of use without rewriting their attributes. */\nexport class NumberValueReader {\n  /** The last rejected literal per Value; no history grows for an unchanged instance. */\n  readonly #lastRejected = new Map<string, string>();\n\n  /** Resolves the declared number using its own fallback and shared class contract. */\n  read(\n    owner: NumberValueOwner,\n    name: string,\n    raw: number,\n    fallback: number,\n    bounds: NumberBounds,\n  ): number {\n    const resolved = readNumber(raw, fallback, bounds);\n    if (matchesNumberBounds(raw, bounds)) {\n      this.#lastRejected.delete(name);\n      return resolved;\n    }\n    const attribute = `data-${owner.identifier}-${name.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`)}-value`;\n    const literal = owner.element.getAttribute(attribute);\n    if (literal === null) {\n      this.#lastRejected.delete(name);\n      return resolved;\n    }\n    if (this.#lastRejected.get(name) !== literal) {\n      this.#lastRejected.set(name, literal);\n      console.warn(\n        `Stimeo UI: \"${owner.identifier}\" has an invalid number Value \"${name}\" declaration ${JSON.stringify(literal)}; using ${fallback}.`,\n      );\n    }\n    return resolved;\n  }\n}\n","/**\n * Reflects a serialized attribute value only when the current value differs.\n *\n * A same-value `setAttribute` still queues a mutation record for every observer, so an\n * unchanged value writes nothing.\n *\n * @param element - The element whose attribute is reflected.\n * @param name - The attribute name, using the non-namespaced DOM API.\n * @param value - The serialized value, or null to remove the attribute.\n * @param beforeWrite - Called only for a change, before the DOM mutation, so the\n * caller can record ownership or identify its own observer records.\n * @returns Whether an attribute was written or removed.\n */\nexport function setAttributeIfChanged(\n  element: Element,\n  name: string,\n  value: string | null,\n  beforeWrite?: () => void,\n): boolean {\n  if (element.getAttribute(name) === value) return false;\n  beforeWrite?.();\n  if (value === null) element.removeAttribute(name);\n  else element.setAttribute(name, value);\n  return true;\n}\n","import { setAttributeIfChanged } from \"./attribute_write\";\n\n/** The original string and the last string written through one channel. */\nexport interface TextWrite {\n  readonly original: string;\n  readonly written: string;\n}\n\n/** Live evidence is tied to this instance and this exact element. */\nexport type TextEvidence =\n  | { readonly source?: \"dom\" }\n  | { readonly source: \"live\"; readonly allowOriginal?: boolean };\n\n/**\n * Records plain text or an input's value as `[channel, original, written]` in\n * an identifier-derived attribute supplied by the caller. Ownership requires a\n * valid record and the same current string; text containing an element is never\n * owned. The caller decides when to acquire, clear, restore, or forget a slot.\n *\n * DOM evidence survives a clone. Live evidence only describes writes made by\n * this instance to that element, so it can preserve a caller's held semantic\n * state or repair a morph that omitted the record. Neither proves who last\n * wrote an identical string. An optional guard protects other authored state.\n */\nexport class OwnedText<T extends HTMLElement = HTMLElement> {\n  readonly #attribute: string;\n  readonly #channel: \"text\" | \"value\";\n  readonly #guard: (element: T) => boolean;\n  readonly #writes = new WeakMap<T, TextWrite>();\n\n  constructor(\n    attribute: string,\n    channel: \"text\" | \"value\" = \"text\",\n    guard: (element: T) => boolean = () => true,\n  ) {\n    this.#attribute = attribute;\n    this.#channel = channel;\n    this.#guard = guard;\n  }\n\n  /** Whether the slot carries a record, including an invalid one. */\n  hasRecord(element: T): boolean {\n    return element.hasAttribute(this.#attribute);\n  }\n\n  /** Reads validated DOM evidence, or explicitly requested instance evidence. */\n  read(element: T, evidence: TextEvidence = {}): TextWrite | null {\n    if (evidence.source === \"live\") return this.#writes.get(element) ?? null;\n    const raw = element.getAttribute(this.#attribute);\n    if (raw === null) return null;\n    try {\n      const record: unknown = JSON.parse(raw);\n      if (\n        !Array.isArray(record) ||\n        record.length !== 3 ||\n        record[0] !== this.#channel ||\n        typeof record[1] !== \"string\" ||\n        typeof record[2] !== \"string\"\n      )\n        return null;\n      return { original: record[1], written: record[2] };\n    } catch {\n      return null;\n    }\n  }\n\n  /** Checks the current string, the text structure, and the caller's guard. */\n  owns(element: T, evidence: TextEvidence = {}): boolean {\n    return this.#ownedRecord(element, evidence) !== null;\n  }\n\n  /** Returns the matching evidence after checking structure and the caller's guard. */\n  #ownedRecord(element: T, evidence: TextEvidence): TextWrite | null {\n    const record = this.read(element, evidence);\n    if (record === null || !this.#guard(element)) return null;\n    if (this.#channel === \"text\" && element.firstElementChild !== null) return null;\n    const current = this.#current(element);\n    return current === record.written ||\n      (evidence.source === \"live\" && evidence.allowOriginal === true && current === record.original)\n      ? record\n      : null;\n  }\n\n  /** Acquires the slot, preserving the first original unless the caller supplies one. */\n  write(element: T, written: string, original?: string, force = false): void {\n    const current = this.#current(element);\n    if (current === null) return;\n    const before =\n      original ?? this.#writes.get(element)?.original ?? this.read(element)?.original ?? current;\n    if (force || current !== written) this.#put(element, written);\n    this.remember(element, written, before);\n  }\n\n  /** Records a write whose property assignment, such as caret handling, the caller owns. */\n  remember(element: T, written: string, original?: string): void {\n    const current = this.#current(element);\n    if (current === null) return;\n    const before =\n      original ?? this.#writes.get(element)?.original ?? this.read(element)?.original ?? current;\n    this.#writes.set(element, { original: before, written });\n    setAttributeIfChanged(\n      element,\n      this.#attribute,\n      JSON.stringify([this.#channel, before, written]),\n    );\n  }\n\n  /** Empties an owned slot and releases its evidence. */\n  clear(element: T, evidence: TextEvidence = {}): boolean {\n    if (!this.owns(element, evidence)) return false;\n    if (this.#current(element) !== \"\") this.#put(element, \"\");\n    this.forget(element);\n    return true;\n  }\n\n  /** Restores an owned slot's original string and releases its evidence. */\n  restore(element: T, evidence: TextEvidence = {}): boolean {\n    const record = this.#ownedRecord(element, evidence);\n    if (record === null) return false;\n    if (this.#current(element) !== record.original) this.#put(element, record.original);\n    this.forget(element);\n    return true;\n  }\n\n  /** Drops evidence without changing the slot, including an invalid DOM record. */\n  forget(element: T): void {\n    setAttributeIfChanged(element, this.#attribute, null);\n    this.#writes.delete(element);\n  }\n\n  /** Reads the property belonging to this channel. */\n  #current(element: T): string | null {\n    if (this.#channel === \"text\") return element.textContent ?? \"\";\n    return element instanceof HTMLInputElement ? element.value : null;\n  }\n\n  /** Writes the property belonging to this channel. */\n  #put(element: T, text: string): void {\n    if (this.#channel === \"text\") element.textContent = text;\n    else if (element instanceof HTMLInputElement) element.value = text;\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { DetachGate } from \"../utils/detach_gate\";\nimport { KeyedTimers } from \"../utils/keyed_timers\";\nimport { ListenerSet } from \"../utils/listener_set\";\nimport { MicrotaskCoalescer } from \"../utils/microtask_coalescer\";\nimport { NUMBER_BOUNDS, type NumberValueConstraints } from \"../utils/number_bounds\";\nimport { NumberValueReader } from \"../utils/number_value\";\nimport { OwnedText } from \"../utils/owned_text\";\nimport { SafeTimeout } from \"../utils/safe_timeout\";\n\n/** The two politeness levels this controller keeps a region for. */\nconst LEVELS = [\"polite\", \"assertive\"] as const;\n\n/** One of the politeness levels in {@link LEVELS}. */\ntype Level = (typeof LEVELS)[number];\n\n/** Suffix of the marker on a live region this controller generated; see the class remarks. */\nconst STAND_IN = \"stand-in\";\n\n/** Suffix of the marker on a region holding a message this controller wrote. */\nconst ANNOUNCED = \"announced\";\n\n/**\n * Headless, shared **live-region announcer** — a polite/assertive screen-reader\n * announcement base (no dedicated APG pattern; follows the WAI-ARIA \"Alert\" /\n * \"Status\" live-region guidance and WCAG 2.2 **4.1.3 Status Messages**).\n *\n * Markup contract (identifier: `stimeo--announcer`):\n *   <!-- Place once per page; the consumer visually hides the regions in CSS. -->\n *   <div data-controller=\"stimeo--announcer\">\n *     <div data-stimeo--announcer-target=\"polite\" aria-live=\"polite\" aria-atomic=\"true\"></div>\n *     <div data-stimeo--announcer-target=\"assertive\" aria-live=\"assertive\" aria-atomic=\"true\"></div>\n *   </div>\n *\n *   <!-- Attribute-only trigger: declare the activation event explicitly. -->\n *   <button data-action=\"click->stimeo--announcer#announce\"\n *           data-stimeo--announcer-message-param=\"Saved\"\n *           data-stimeo--announcer-assertive-param=\"false\">Save</button>\n *\n *   <!-- Programmatic trigger (e.g. from another controller / Turbo Stream). -->\n *   window.dispatchEvent(new CustomEvent(\"stimeo--announcer:announce\", {\n *     detail: { message: \"12 results\", assertive: false },\n *   }))\n *\n * The announcer is the shared live region other controllers hand their messages\n * to (`stimeo--auto-submit`, `stimeo--flash` and `stimeo--bulk-select` among\n * them) instead of each carrying their own.\n *\n * @remarks\n * Behavior only, with **one deliberate exception**: when a `polite`/`assertive`\n * target is absent the controller *generates* the missing region **on connect**\n * and applies the canonical visually-hidden inline style (see {@link visuallyHide}).\n * A live region must exist and be visually hidden to do its job, and a generated\n * node has no consumer CSS hook to hide it; consumers who want to own styling\n * supply their own targets. Generation happens up front rather than on the first\n * announcement because assistive tech reports changes to a region it already\n * knows about — a region created and written within one task loses that first\n * message. The controller never moves focus — announcements must not steal it\n * (WCAG 2.2 4.1.3). Listeners, the queues and the clear timers are torn down, and any\n * generated regions removed, once the element is really detached. An in-page move,\n * and a `data-turbo-permanent` announcer Turbo carries to the next page, reconnect\n * the same instance with all of them in place, so what was queued is still read and a\n * message on display is still cleared on time.\n *\n * **Generated regions are marked, so a restore never doubles them.** Each\n * stand-in carries `data-<identifier>-stand-in`. The region set is kept whole until\n * the controller is detached, so a stand-in can reach a copy of the page — a page Turbo\n * restores from its cache is one. The teardown removes the stand-ins a connection\n * generated, so a marked child a host arrives with came from an earlier one:\n * `connect()` drops it before generating its own, and it never sits as a second\n * region beside the new stand-in or an authored target.\n *\n * **A restored page does not read out an earlier message.** A region holding a\n * message this controller wrote carries `[\"text\", original, written]` in\n * `data-<identifier>-announced` until the message\n * is cleared after `clearAfter`. The teardown drops the clearing timers, so a connection\n * that is not the other half of a move empties only a region still holding that\n * recorded text alone. Authored replacements, element children, and invalid records\n * stay. Nothing is dropped or emptied on `turbo:before-cache`, which Turbo\n * also dispatches on pages that stay (a promoted frame navigation, a state-less\n * `popstate`, a refresh of a cached URL): the messages queued there are still read.\n *\n * **Messages are queued, one write per task.** Assistive tech announces what it\n * observes changing, so two messages written into one region within a single task\n * are one observed change and the earlier message is never read. Each politeness\n * has its own FIFO — an assertive message never waits behind polite ones — and a\n * message is written only in a task where its region already existed.\n *\n * **The region set is kept whole while connected.** Exactly one region per\n * politeness is present: an authored target retires the stand-in generated for it,\n * losing one materialises a stand-in again, and a generated region removed by a\n * morph (it is absent from the server's HTML, so a morph drops it) is put back\n * without waiting for the next message.\n */\nexport class AnnouncerController extends Controller<HTMLElement> {\n  /** Numeric read boundaries share one reader for this controller instance. */\n  readonly #numbers = new NumberValueReader();\n\n  static override targets = [\"polite\", \"assertive\"];\n  static override values = {\n    clearAfter: { type: Number, default: 1000 },\n    dedupeReannounce: { type: Boolean, default: true },\n  };\n\n  static valueConstraints = {\n    clearAfter: NUMBER_BOUNDS.timer,\n  } satisfies NumberValueConstraints<typeof AnnouncerController.values>;\n  static actions = [\"announce\"] as const;\n\n  declare readonly politeTarget: HTMLElement;\n  declare readonly assertiveTarget: HTMLElement;\n  declare readonly politeTargets: HTMLElement[];\n  declare readonly assertiveTargets: HTMLElement[];\n  declare readonly hasPoliteTarget: boolean;\n  declare readonly hasAssertiveTarget: boolean;\n\n  declare clearAfterValue: number;\n  declare dedupeReannounceValue: boolean;\n\n  /** Drain timers, which belong to a politeness level rather than to a region. */\n  readonly #timers = new SafeTimeout();\n\n  /** Tells an in-page move or a permanent carry from a real detach. */\n  readonly #gate = new DetachGate();\n\n  /** The announce listeners, released by the teardown a real detach runs. */\n  readonly #listeners = new ListenerSet();\n\n  /** The auto-clear each region may have outstanding; a newer message releases it. */\n  readonly #regionTimers = new KeyedTimers<HTMLElement>();\n\n  /** The stand-in last generated per absent target, which may have left the document since. */\n  readonly #generated = new Map<Level, HTMLElement>();\n\n  /** The stand-in marker, in the namespace this controller is registered under. */\n  get #standIn(): string {\n    return `data-${this.identifier}-${STAND_IN}`;\n  }\n\n  /** The written-message marker, in the namespace this controller is registered under. */\n  readonly #messageText = new OwnedText(`data-${this.identifier}-${ANNOUNCED}`);\n\n  /** Messages waiting to be written, oldest first, one queue per politeness. */\n  readonly #queues = new Map<Level, string[]>();\n\n  /** Politeness levels whose next drain is already armed. */\n  readonly #draining = new Set<Level>();\n\n  /** Collapses a batch of target callbacks (and morph removals) into one pass. */\n  readonly #reconcile = new MicrotaskCoalescer(() => this.#reconcileRegions());\n\n  /**\n   * Watches the host's own children for a generated region disappearing. A morph\n   * drops it — the server's HTML never had it — and no target callback reports\n   * that, because a generated region carries no target attribute. `subtree` stays\n   * off so writing a message inside a region does not re-enter this pass.\n   */\n  readonly #hostWatch = new MutationObserver(() => {\n    this.#reconcile.schedule();\n  });\n\n  /**\n   * Guards against handling the same CustomEvent twice. An event dispatched on\n   * the controller element with `bubbles: true` reaches both the element and the\n   * `window` listener; this WeakSet ensures it announces only once.\n   */\n  readonly #handled = new WeakSet<Event>();\n\n  /** Receives programmatic announcements at the element or bubbled to `window`. */\n  readonly #onAnnounceEvent = (event: Event): void => {\n    if (this.#handled.has(event)) return;\n    this.#handled.add(event);\n    const detail = (event as CustomEvent<unknown>).detail;\n    const message = this.#messageFromDetail(detail);\n    if (!message) return;\n    this.#announce(message, this.#assertiveFromDetail(detail));\n  };\n\n  /**\n   * Seats the regions and starts listening. The reconnection that completes an in-page\n   * move or a permanent carry finds all of it in place, the queues and timers included.\n   */\n  override connect(): void {\n    const moved = this.#gate.pending;\n    this.#gate.cancel();\n    if (moved) return;\n    this.#reconcile.activate();\n    this.#dropInheritedStandIns();\n    this.#emptyInheritedMessages();\n    // Materialise any missing region now, so it is in the accessibility tree\n    // before the first message rather than appearing with it.\n    this.#reconcileRegions();\n    this.#hostWatch.observe(this.element, { childList: true });\n    this.#listeners.add(this.element, \"stimeo--announcer:announce\", this.#onAnnounceEvent);\n    this.#listeners.add(window, \"stimeo--announcer:announce\", this.#onAnnounceEvent);\n  }\n\n  /** Tears everything down once the element is really detached. */\n  override disconnect(): void {\n    this.#gate.disconnected(this, () => this.#teardown());\n  }\n\n  /** Releases the listeners, the queues, the timers and the stand-ins. */\n  #teardown(): void {\n    this.#reconcile.cancel();\n    this.#hostWatch.disconnect();\n    this.#listeners.dispose();\n    this.#timers.clearAll();\n    this.#regionTimers.clearAll();\n    this.#queues.clear();\n    this.#draining.clear();\n    this.#removeGenerated();\n  }\n\n  /** Retires the stand-in once the consumer supplies a polite region. */\n  politeTargetConnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Materialises a stand-in once the consumer's polite region goes away. */\n  politeTargetDisconnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Retires the stand-in once the consumer supplies an assertive region. */\n  assertiveTargetConnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Materialises a stand-in once the consumer's assertive region goes away. */\n  assertiveTargetDisconnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /**\n   * Brings the region set back to exactly one region per politeness and reports\n   * whether anything had to be created.\n   *\n   * A region created here is not written to in the same task: assistive tech\n   * reports changes to regions it already knows about, so {@link #drain} waits a\n   * task whenever this says a region is new.\n   */\n  #reconcileRegions(): boolean {\n    let created = false;\n    for (const level of LEVELS) {\n      if (this.#hasTargetFor(level)) {\n        // The consumer owns this politeness now; a stand-in would be a second\n        // region for it, and an empty one nothing ever writes to.\n        this.#generated.get(level)?.remove();\n        continue;\n      }\n      const existing = this.#generated.get(level);\n      if (existing?.isConnected) continue;\n      this.#generated.set(level, this.#createRegion(level));\n      created = true;\n    }\n    return created;\n  }\n\n  /** Whether the consumer supplied a target for `level`. */\n  #hasTargetFor(level: Level): boolean {\n    return level === \"assertive\" ? this.hasAssertiveTarget : this.hasPoliteTarget;\n  }\n\n  /** Builds a visually hidden, marked live region for `level` and attaches it. */\n  #createRegion(level: Level): HTMLElement {\n    const region = document.createElement(\"div\");\n    region.setAttribute(\"aria-live\", level);\n    region.setAttribute(\"aria-atomic\", \"true\");\n    region.setAttribute(this.#standIn, \"\");\n    visuallyHide(region);\n    this.element.appendChild(region);\n    return region;\n  }\n\n  /** Removes the stand-ins the host arrived with; see the class remarks. */\n  #dropInheritedStandIns(): void {\n    for (const child of Array.from(this.element.children)) {\n      if (child.hasAttribute(this.#standIn)) child.remove();\n    }\n  }\n\n  /**\n   * Empties the authored regions that hold a message this controller wrote, which no\n   * clearing timer of this connection is left to clear; see the class remarks.\n   */\n  #emptyInheritedMessages(): void {\n    for (const region of [...this.politeTargets, ...this.assertiveTargets]) {\n      this.#messageText.clear(region);\n    }\n  }\n\n  /** Removes the stand-ins this connection generated; authored targets stay. */\n  #removeGenerated(): void {\n    for (const region of this.#generated.values()) region.remove();\n  }\n\n  /**\n   * Announces a message. Reads the text from a Stimulus action param\n   * (`message`, plus optional `assertive`) for attribute-only triggers, falling\n   * back to a CustomEvent `detail` when the same handler is wired to an event.\n   * An empty/non-string message is ignored so untrusted payloads cannot blank\n   * the region.\n   */\n  announce(event: Event): void {\n    const params = (event as { params?: Record<string, unknown> }).params;\n    const fromParam = params?.message;\n    const message =\n      typeof fromParam === \"string\" && fromParam.length > 0\n        ? fromParam\n        : this.#messageFromDetail((event as CustomEvent<unknown>).detail);\n    if (!message) return;\n\n    const assertive =\n      params?.assertive === true ||\n      this.#assertiveFromDetail((event as CustomEvent<unknown>).detail);\n    this.#announce(message, assertive);\n  }\n\n  /**\n   * Queues `message` for its politeness and arms the drain.\n   *\n   * Queuing is what makes a burst audible: assistive tech announces the changes it\n   * observes, so several messages written into one region within a single task are\n   * one change and only the last is read.\n   */\n  #announce(message: string, assertive: boolean): void {\n    const level: Level = assertive ? \"assertive\" : \"polite\";\n    const queue = this.#queues.get(level);\n    if (queue) {\n      queue.push(message);\n    } else {\n      this.#queues.set(level, [message]);\n    }\n    this.#scheduleDrain(level);\n  }\n\n  /** Arms one drain pass for `level`; further messages ride the pass already armed. */\n  #scheduleDrain(level: Level): void {\n    if (this.#draining.has(level)) return;\n    this.#draining.add(level);\n    this.#timers.set(() => {\n      this.#draining.delete(level);\n      this.#drain(level);\n    }, 0);\n  }\n\n  /**\n   * Writes one queued message, then arms the next pass while the queue holds more.\n   *\n   * Two steps take a whole pass without consuming the message: materialising a\n   * region (it has to be in the accessibility tree before the text arrives) and\n   * emptying a region that already holds this exact text (an unchanged node is not\n   * re-read, so `dedupeReannounce` clears first and writes on the following pass).\n   *\n   * @stimeoRuntimeOnly `dedupeReannounce` decides whether one queued message is spoken again; the\n   *   region's text is the message itself.\n   */\n  #drain(level: Level): void {\n    const queue = this.#queues.get(level);\n    const message = queue?.[0];\n    if (queue === undefined || message === undefined) return;\n\n    const created = this.#reconcileRegions();\n    const region = this.#regionFor(level);\n    // With nothing created every politeness has a seated region; the second check\n    // narrows the type.\n    if (created || region === undefined) {\n      this.#scheduleDrain(level);\n      return;\n    }\n\n    if (this.dedupeReannounceValue && region.textContent === message) {\n      region.textContent = \"\";\n      this.#messageText.forget(region);\n      this.#scheduleDrain(level);\n      return;\n    }\n\n    queue.shift();\n    // A non-positive `clearAfter` arms nothing below, so the region's pending\n    // timer is released here rather than by the arming that replaces it.\n    this.#regionTimers.clear(region);\n    this.#messageText.write(region, message, undefined, true);\n    this.#scheduleClear(region);\n    if (queue.length > 0) this.#scheduleDrain(level);\n  }\n\n  /**\n   * Clears the region after `clearAfter` ms if it still shows only the message this\n   * controller recorded there. A newer message re-arms the region's one timer.\n   *\n   * @stimeoRuntimeOnly `clearAfter` is the delay of the one clearing timer this call arms.\n   */\n  #scheduleClear(region: HTMLElement): void {\n    if (this.#safeClearAfter <= 0) return;\n    this.#regionTimers.set(\n      region,\n      () => {\n        this.#messageText.clear(region);\n      },\n      this.#safeClearAfter,\n    );\n  }\n\n  /**\n   * The region a politeness writes into: its target, else its last stand-in. A\n   * morph can drop the stand-in, and only a reconcile pass that created nothing\n   * guarantees it is seated; a detached node announces nothing.\n   */\n  #regionFor(level: Level): HTMLElement | undefined {\n    if (level === \"assertive\" && this.hasAssertiveTarget) return this.assertiveTarget;\n    if (level === \"polite\" && this.hasPoliteTarget) return this.politeTarget;\n    return this.#generated.get(level);\n  }\n\n  /** Extracts a non-empty string `message` from a CustomEvent detail, else null. */\n  #messageFromDetail(detail: unknown): string | null {\n    if (detail && typeof detail === \"object\" && \"message\" in detail) {\n      const value = (detail as Record<string, unknown>).message;\n      if (typeof value === \"string\" && value.length > 0) return value;\n    }\n    return null;\n  }\n\n  /** Reads an `assertive === true` flag from a CustomEvent detail (default polite). */\n  #assertiveFromDetail(detail: unknown): boolean {\n    return (\n      !!detail &&\n      typeof detail === \"object\" &&\n      (detail as Record<string, unknown>).assertive === true\n    );\n  }\n  /** Current `clearAfter` declaration resolved against its numeric contract. */\n  get #safeClearAfter(): number {\n    return this.#numbers.read(\n      this,\n      \"clearAfter\",\n      this.clearAfterValue,\n      AnnouncerController.values.clearAfter.default,\n      AnnouncerController.valueConstraints.clearAfter,\n    );\n  }\n}\n\n/**\n * Applies the canonical visually-hidden (\"sr-only\") inline style to a generated\n * live region so its text is announced without being seen. Inline so the library\n * stays self-contained when the consumer provides no target/CSS of its own.\n *\n * Pure (no `this`); exported for direct unit testing.\n */\nexport function visuallyHide(node: HTMLElement): void {\n  const { style } = node;\n  style.position = \"absolute\";\n  style.width = \"1px\";\n  style.height = \"1px\";\n  style.margin = \"-1px\";\n  style.padding = \"0\";\n  style.border = \"0\";\n  style.overflow = \"hidden\";\n  style.clip = \"rect(0 0 0 0)\";\n  style.clipPath = \"inset(50%)\";\n  style.whiteSpace = \"nowrap\";\n}\n"]}