stimeo-ui 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -7,6 +7,73 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 While the version is `0.x`, the public API (the `stimeo--*` data attributes) may
 change between releases.
 
+## [0.5.0] - 2026-08-13
+
+### Changed
+
+- **Breaking** — every CSS custom property the library writes now carries the
+  `--stimeo--` namespace (two hyphens). Rename them in your stylesheets: a name
+  you miss raises no error, it just falls back to `var()`'s default and the bar
+  or thumb stops moving.
+  - `--stimeo-range-start` / `--stimeo-range-end` →
+    `--stimeo--range-slider-start` / `--stimeo--range-slider-end`
+  - `--stimeo-<name>` → `--stimeo--<name>` for `aspect-ratio`,
+    `collapsible-content-height`, `color`, `context-menu-x`, `context-menu-y`,
+    `masonry-columns`, `meter-ratio`, `password-strength`, `progress-ratio`,
+    `scroll-progress`, `step-indicator-ratio`, `textarea-rows`,
+    `upload-progress`
+- **Breaking** — spinner's `indicator`, the network-status banners, and
+  countdown's `status` slot are no longer live regions. Drop `role="status"` /
+  `role="alert"` / `aria-live` from them and set `announceText` (and its
+  siblings) with a `stimeo--announcer` on the page; keeping the role reads the
+  change twice.
+- time-picker: committing a field change dispatches a native `change` from the
+  `field` target, and `stimeo--time-picker:change` reports the composed value
+  even when no `field` target is present.
+- tree-view: more native elements count as nested-interactive (`label`,
+  `summary`, `details`, `area[href]`, media with `controls`, `iframe`, `object`,
+  `embed`), so a click or key inside one is left alone instead of moving the
+  tree selection.
+
+### Added
+
+- Inspector: the manifest advances from schema v8 to **v11** — tools that read it
+  raw must accept the new `valueConstraints`, `hosts`, and `valueRelations`
+  fields. Two diagnostics are new, so **re-run `stimeo check` before deploying;
+  it can report errors on views that passed under 0.4.0**:
+  - `invalid-value` — slider, range-slider, and number-input need a finite,
+    positive `step`; range-slider needs finite `min`, `max`, `start`, and `end`
+    with `min` at or below `max`.
+  - `invalid-host` — switch, time-picker, and tree-view report an unsupported
+    host element before it reaches the browser.
+
+### Fixed
+
+- range-slider: two thumbs resting on the same value can be pulled apart with
+  the pointer again, and invalid or reversed bounds fall back to a finite
+  ordered range.
+- slider, range-slider, number-input: an endpoint that does not sit on the step
+  grid is reachable, and an invalid `step` falls back to `1`.
+- slider, range-slider: a Turbo morph that swaps a value repaints instead of
+  freezing, a replaced thumb or track picks up the current state, and a drag
+  stays with the pointer that started it.
+- switch: holding Space no longer scrolls a non-`<button>` host, and an ancestor
+  `fieldset[disabled]` or `aria-disabled` blocks activation.
+- flash: hover and focus pause the auto-dismiss independently, a flash paused
+  after its deadline dismisses instead of staying forever, a second dismiss on a
+  leaving flash is ignored, and a replaced `region` target is picked up.
+- frame-loading: `aria-busy`, the skeleton, and `inert` are rolled back when the
+  controller is detached, instead of burning in with nothing left to finish the
+  load.
+- empty-state: a replaced `list` or `empty` element and a runtime `itemSelector`
+  change are followed, so the placeholder no longer sticks beside a filled list.
+- highlight: a highlight that outlives a Turbo navigation is cleaned up on the
+  way back instead of staying marked.
+- idle: `data-idle` is cleared when a new measurement cycle connects, and
+  `disconnect()` removes the listeners it actually registered even when `events`
+  changed while connected.
+- skeleton: a skeleton moved within the page keeps its ready intent.
+
 ## [0.4.0] - 2026-08-11
 
 The feedback and status components announce through the shared
@@ -391,6 +458,7 @@ Initial public alpha: 101 behavior-only, accessible Stimulus controllers driven
 by `data-*` attributes, shipping no CSS. Published to npm (with provenance) and
 RubyGems.
 
+[0.5.0]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.5.0
 [0.4.0]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.4.0
 [0.3.0]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.3.0
 [0.2.1]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.2.1

package/dist/controllers/announcer_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/before_cache_reset.ts","../../src/utils/microtask_coalescer.ts","../../src/utils/safe_timeout.ts","../../src/controllers/announcer_controller.ts"],"names":[],"mappings":"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","file":"announcer_controller.js","sourcesContent":["/**\n * Runs a controller's \"return to the initial state\" pass just before Turbo\n * caches the page.\n *\n * **`disconnect()` cannot do this job, for two independent reasons.** Turbo\n * queues the clone from this event rather than taking it here, and the body swap\n * that runs the controller's `disconnect()` is queued separately — so which of\n * the two lands first is not something a controller can rely on, and a rewind\n * written in `disconnect()` may reach only the DOM being thrown away. In the\n * other direction, `disconnect()` also fires on an in-page move (Stimulus tears\n * down and reconnects the same element), where rewinding would wipe a\n * legitimately in-progress interaction — a spinner mid-load would vanish. One\n * timing is unreliable, the other is too eager; `turbo:before-cache` is the only\n * point that is exactly \"the page is about to be frozen\".\n *\n * Scope is the subscription only: registering on `activate()`, unregistering on\n * `deactivate()`, and one shared document listener no matter how many instances\n * are live. *What* to return to its initial state — which `data-state`, which\n * `hidden`, which `aria-busy` — stays in the controller, because no two\n * consumers answer it the same way (the `MicrotaskCoalescer` split).\n *\n * **Rewind state, not appearance.** The pass writes attributes the controller\n * itself owns; the visual result of those attributes is the consumer's CSS, and\n * a library that reached for style or class names would be guessing at markup\n * it does not own.\n *\n * Both entry points are idempotent, so the lifecycle hooks can call them\n * unconditionally: a second `activate()` does not double-subscribe and does not\n * make the callback run twice, and `deactivate()` on an instance that never\n * subscribed is a no-op.\n *\n * This file's own doc block is dropped from `dist`, but every member comment is\n * inlined into each consumer entry (`tsup` builds with `splitting: false`), so\n * rationale belongs here and only the contract belongs on the members.\n *\n * @example\n * ```ts\n * readonly #beforeCache = new BeforeCacheReset(() => this.#rewind());\n *\n * connect()    { this.#beforeCache.activate(); }\n * disconnect() { this.#beforeCache.deactivate(); }\n * ```\n */\nexport class BeforeCacheReset {\n  /** Every subscribed instance, iterated by the one shared document listener. */\n  static readonly #subscribers = new Set<BeforeCacheReset>();\n\n  /** The shared listener; installed while at least one instance is subscribed. */\n  static readonly #onBeforeCache = (): void => {\n    for (const subscriber of BeforeCacheReset.#subscribers) subscriber.#rewind();\n  };\n\n  readonly #rewind: () => void;\n\n  /** @param rewind - the pass that returns this controller's state to its initial form. */\n  constructor(rewind: () => void) {\n    this.#rewind = rewind;\n  }\n\n  /** Subscribes to `turbo:before-cache`; call from `connect()`. Idempotent. */\n  activate(): void {\n    const first = BeforeCacheReset.#subscribers.size === 0;\n    BeforeCacheReset.#subscribers.add(this);\n    if (first) {\n      document.addEventListener(\"turbo:before-cache\", BeforeCacheReset.#onBeforeCache);\n    }\n  }\n\n  /** Unsubscribes; call from `disconnect()`. Safe when never subscribed. */\n  deactivate(): void {\n    BeforeCacheReset.#subscribers.delete(this);\n    if (BeforeCacheReset.#subscribers.size > 0) return;\n    document.removeEventListener(\"turbo:before-cache\", BeforeCacheReset.#onBeforeCache);\n  }\n}\n","/**\n * Collapses many target callbacks from one DOM mutation into a single pass.\n *\n * Stimulus fires `<name>TargetConnected` / `Disconnected` once per element, so\n * replacing a list of N options delivers N callbacks — but the useful unit of\n * work is \"reconcile against the DOM that resulted\", once, after the batch has\n * settled. Every controller that owns a reconcilable target set needs the same\n * 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 the *initial* target callbacks\n *   ahead of `connect()`. Reconciling there would compute a fallback 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 * This file's own doc block is dropped from `dist`, but every member comment is\n * inlined into each consumer entry (`tsup` builds with `splitting: false`), so\n * rationale belongs here and only the contract belongs on the members.\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","/**\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\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 { Controller } from \"@hotwired/stimulus\";\nimport { BeforeCacheReset } from \"../utils/before_cache_reset\";\nimport { MicrotaskCoalescer } from \"../utils/microtask_coalescer\";\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/**\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 substrate other controllers (Auto-Submit, Flash,\n * Bulk Select, …) lean on instead of each carrying their own live region.\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 and clear timers are torn down on `disconnect()`\n * (Turbo included), and any generated regions are removed — from the cached\n * snapshot too, via {@link BeforeCacheReset}, because `connect()` cannot reuse a\n * restored region (it carries no target attribute) and would pair another one\n * with it on every visit.\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  static override targets = [\"polite\", \"assertive\"];\n  static override values = {\n    clearAfter: { type: Number, default: 1000 },\n    dedupeReannounce: { type: Boolean, default: true },\n  };\n  static actions = [\"announce\"] as const;\n\n  declare readonly politeTarget: HTMLElement;\n  declare readonly assertiveTarget: HTMLElement;\n  declare readonly hasPoliteTarget: boolean;\n  declare readonly hasAssertiveTarget: boolean;\n\n  declare clearAfterValue: number;\n  declare dedupeReannounceValue: boolean;\n\n  /** Clear/re-announce timers; one `clearAll()` in disconnect tears them all down. */\n  readonly #timers = new SafeTimeout();\n\n  /** Live regions generated to stand in for absent targets, for teardown. */\n  readonly #generated = new Map<Level, HTMLElement>();\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  /** Rewinds to an announceable initial state for the snapshot; see the remarks. */\n  readonly #beforeCache = new BeforeCacheReset(() => this.#rewindForCache());\n\n  /**\n   * The one timer a region may have outstanding — its dedupe re-set, then its\n   * auto-clear. Held weakly so a swapped-out target is not retained; a leftover\n   * id is harmless because {@link SafeTimeout.clear} no-ops on an id it does not\n   * own.\n   */\n  readonly #pending = new WeakMap<HTMLElement, number>();\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  override connect(): void {\n    this.#reconcile.activate();\n    this.#beforeCache.activate();\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  override disconnect(): void {\n    this.#reconcile.cancel();\n    this.#hostWatch.disconnect();\n    this.#beforeCache.deactivate();\n    this.element.removeEventListener(\"stimeo--announcer:announce\", this.#onAnnounceEvent);\n    window.removeEventListener(\"stimeo--announcer:announce\", this.#onAnnounceEvent);\n    this.#timers.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        const generated = this.#generated.get(level);\n        if (generated) {\n          generated.remove();\n          this.#generated.delete(level);\n        }\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 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    visuallyHide(region);\n    this.element.appendChild(region);\n    return region;\n  }\n\n  /**\n   * Removes and forgets every region this controller generated. Authored targets\n   * belong to the consumer and are left untouched. Forgetting them is what keeps\n   * the live page working after a snapshot rewind: the next announcement finds an\n   * empty map and materialises a fresh region.\n   */\n  #removeGenerated(): void {\n    for (const region of this.#generated.values()) {\n      region.remove();\n    }\n    this.#generated.clear();\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  #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    if (this.#reconcileRegions()) {\n      this.#scheduleDrain(level);\n      return;\n    }\n\n    const region = this.#regionFor(level);\n    if (this.dedupeReannounceValue && region.textContent === message) {\n      this.#cancelPending(region);\n      region.textContent = \"\";\n      this.#scheduleDrain(level);\n      return;\n    }\n\n    queue.shift();\n    this.#cancelPending(region);\n    region.textContent = message;\n    this.#scheduleClear(region, message);\n    if (queue.length > 0) this.#scheduleDrain(level);\n  }\n\n  /** Clears the region after `clearAfter` ms, unless a newer message replaced it. */\n  #scheduleClear(region: HTMLElement, message: string): void {\n    if (this.clearAfterValue <= 0) return;\n    this.#schedule(\n      region,\n      () => {\n        if (region.textContent === message) region.textContent = \"\";\n      },\n      this.clearAfterValue,\n    );\n  }\n\n  /**\n   * Arms `region`'s single pending timer. Callers reach here with the slot\n   * already free — `#announce` releases it, and a fired timer clears its own\n   * entry below — so this does not cancel again.\n   */\n  #schedule(region: HTMLElement, callback: () => void, delay: number): void {\n    const id = this.#timers.set(() => {\n      // Drop the id as it fires: platform timer ids are recycled, and a stale\n      // one left here could later cancel the *other* region's live timer.\n      this.#pending.delete(region);\n      callback();\n    }, delay);\n    this.#pending.set(region, id);\n  }\n\n  /** Releases `region`'s pending timer, if it has one. */\n  #cancelPending(region: HTMLElement): void {\n    // `SafeTimeout.clear` ignores an id it does not own, so the \"no pending\n    // timer\" case needs no branch of its own.\n    this.#timers.clear(this.#pending.get(region) ?? -1);\n    this.#pending.delete(region);\n  }\n\n  /**\n   * Resolves the live region for a politeness level.\n   *\n   * The remembered stand-in is used only while it is still in the document: a morph\n   * can drop it, and writing into the detached node would announce nothing at all.\n   */\n  #regionFor(level: Level): HTMLElement {\n    if (level === \"assertive\" && this.hasAssertiveTarget) return this.assertiveTarget;\n    if (level === \"polite\" && this.hasPoliteTarget) return this.politeTarget;\n\n    const existing = this.#generated.get(level);\n    if (existing?.isConnected) return existing;\n\n    const region = this.#createRegion(level);\n    this.#generated.set(level, region);\n    return region;\n  }\n\n  /**\n   * Restores the announceable initial state for the snapshot Turbo is about to\n   * take: queued and displayed messages go, generated regions go, and the live\n   * page — which keeps running when a visit is aborted — gets its regions back on\n   * the next task, after the clone.\n   */\n  #rewindForCache(): void {\n    this.#queues.clear();\n    this.#draining.clear();\n    this.#timers.clearAll();\n    for (const level of LEVELS) {\n      if (this.#hasTargetFor(level)) {\n        const target = level === \"assertive\" ? this.assertiveTarget : this.politeTarget;\n        target.textContent = \"\";\n      }\n    }\n    this.#removeGenerated();\n    this.#timers.set(() => this.#reconcileRegions(), 0);\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}\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/before_cache_reset.ts","../../src/utils/microtask_coalescer.ts","../../src/utils/safe_timeout.ts","../../src/controllers/announcer_controller.ts"],"names":[],"mappings":"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","file":"announcer_controller.js","sourcesContent":["/**\n * Runs a controller's \"return to the initial state\" pass just before Turbo\n * caches the page.\n *\n * **`disconnect()` cannot do this job, for two independent reasons.** Turbo\n * queues the clone from this event rather than taking it here, and the body swap\n * that runs the controller's `disconnect()` is queued separately — so which of\n * the two lands first is not something a controller can rely on, and a rewind\n * written in `disconnect()` may reach only the DOM being thrown away. In the\n * other direction, `disconnect()` also fires on an in-page move (Stimulus tears\n * down and reconnects the same element), where rewinding would wipe a\n * legitimately in-progress interaction — a spinner mid-load would vanish. One\n * timing is unreliable, the other is too eager; `turbo:before-cache` is the only\n * point that is exactly \"the page is about to be frozen\".\n *\n * Scope is the subscription only: registering on `activate()`, unregistering on\n * `deactivate()`, and one shared document listener no matter how many instances\n * are live. *What* to return to its initial state — which `data-state`, which\n * `hidden`, which `aria-busy` — stays in the controller, because no two\n * consumers answer it the same way (the `MicrotaskCoalescer` split).\n *\n * **Rewind state, not appearance.** The pass writes attributes the controller\n * itself owns; the visual result of those attributes is the consumer's CSS, and\n * a library that reached for style or class names would be guessing at markup\n * it does not own.\n *\n * Both entry points are idempotent, so the lifecycle hooks can call them\n * unconditionally: a second `activate()` does not double-subscribe and does not\n * make the callback run twice, and `deactivate()` on an instance that never\n * subscribed is a no-op.\n *\n * This file's own doc block is dropped from `dist`, but every member comment is\n * inlined into each consumer entry (`tsup` builds with `splitting: false`), so\n * rationale belongs here and only the contract belongs on the members.\n *\n * @example\n * ```ts\n * readonly #beforeCache = new BeforeCacheReset(() => this.#rewind());\n *\n * connect()    { this.#beforeCache.activate(); }\n * disconnect() { this.#beforeCache.deactivate(); }\n * ```\n */\nexport class BeforeCacheReset {\n  /** Every subscribed instance, iterated by the one shared document listener. */\n  static readonly #subscribers = new Set<BeforeCacheReset>();\n\n  /** The shared listener; installed while at least one instance is subscribed. */\n  static readonly #onBeforeCache = (): void => {\n    for (const subscriber of BeforeCacheReset.#subscribers) subscriber.#rewind();\n  };\n\n  readonly #rewind: () => void;\n\n  /** @param rewind - the pass that returns this controller's state to its initial form. */\n  constructor(rewind: () => void) {\n    this.#rewind = rewind;\n  }\n\n  /** Subscribes to `turbo:before-cache`; call from `connect()`. Idempotent. */\n  activate(): void {\n    const first = BeforeCacheReset.#subscribers.size === 0;\n    BeforeCacheReset.#subscribers.add(this);\n    if (first) {\n      document.addEventListener(\"turbo:before-cache\", BeforeCacheReset.#onBeforeCache);\n    }\n  }\n\n  /** Unsubscribes; call from `disconnect()`. Safe when never subscribed. */\n  deactivate(): void {\n    BeforeCacheReset.#subscribers.delete(this);\n    if (BeforeCacheReset.#subscribers.size > 0) return;\n    document.removeEventListener(\"turbo:before-cache\", BeforeCacheReset.#onBeforeCache);\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 * This file's own doc block is dropped from `dist`, but every member comment is\n * inlined into each consumer entry (`tsup` builds with `splitting: false`), so\n * rationale belongs here and only the contract belongs on the members.\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","/**\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\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 { Controller } from \"@hotwired/stimulus\";\nimport { BeforeCacheReset } from \"../utils/before_cache_reset\";\nimport { MicrotaskCoalescer } from \"../utils/microtask_coalescer\";\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/**\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 substrate other controllers (Auto-Submit, Flash,\n * Bulk Select, …) lean on instead of each carrying their own live region.\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 and clear timers are torn down on `disconnect()`\n * (Turbo included), and any generated regions are removed — from the cached\n * snapshot too, via {@link BeforeCacheReset}, because `connect()` cannot reuse a\n * restored region (it carries no target attribute) and would pair another one\n * with it on every visit.\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  static override targets = [\"polite\", \"assertive\"];\n  static override values = {\n    clearAfter: { type: Number, default: 1000 },\n    dedupeReannounce: { type: Boolean, default: true },\n  };\n  static actions = [\"announce\"] as const;\n\n  declare readonly politeTarget: HTMLElement;\n  declare readonly assertiveTarget: HTMLElement;\n  declare readonly hasPoliteTarget: boolean;\n  declare readonly hasAssertiveTarget: boolean;\n\n  declare clearAfterValue: number;\n  declare dedupeReannounceValue: boolean;\n\n  /** Clear/re-announce timers; one `clearAll()` in disconnect tears them all down. */\n  readonly #timers = new SafeTimeout();\n\n  /** Live regions generated to stand in for absent targets, for teardown. */\n  readonly #generated = new Map<Level, HTMLElement>();\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  /** Rewinds to an announceable initial state for the snapshot; see the remarks. */\n  readonly #beforeCache = new BeforeCacheReset(() => this.#rewindForCache());\n\n  /**\n   * The one timer a region may have outstanding — its dedupe re-set, then its\n   * auto-clear. Held weakly so a swapped-out target is not retained; a leftover\n   * id is harmless because {@link SafeTimeout.clear} no-ops on an id it does not\n   * own.\n   */\n  readonly #pending = new WeakMap<HTMLElement, number>();\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  override connect(): void {\n    this.#reconcile.activate();\n    this.#beforeCache.activate();\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  override disconnect(): void {\n    this.#reconcile.cancel();\n    this.#hostWatch.disconnect();\n    this.#beforeCache.deactivate();\n    this.element.removeEventListener(\"stimeo--announcer:announce\", this.#onAnnounceEvent);\n    window.removeEventListener(\"stimeo--announcer:announce\", this.#onAnnounceEvent);\n    this.#timers.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        const generated = this.#generated.get(level);\n        if (generated) {\n          generated.remove();\n          this.#generated.delete(level);\n        }\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 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    visuallyHide(region);\n    this.element.appendChild(region);\n    return region;\n  }\n\n  /**\n   * Removes and forgets every region this controller generated. Authored targets\n   * belong to the consumer and are left untouched. Forgetting them is what keeps\n   * the live page working after a snapshot rewind: the next announcement finds an\n   * empty map and materialises a fresh region.\n   */\n  #removeGenerated(): void {\n    for (const region of this.#generated.values()) {\n      region.remove();\n    }\n    this.#generated.clear();\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  #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    if (this.#reconcileRegions()) {\n      this.#scheduleDrain(level);\n      return;\n    }\n\n    const region = this.#regionFor(level);\n    if (this.dedupeReannounceValue && region.textContent === message) {\n      this.#cancelPending(region);\n      region.textContent = \"\";\n      this.#scheduleDrain(level);\n      return;\n    }\n\n    queue.shift();\n    this.#cancelPending(region);\n    region.textContent = message;\n    this.#scheduleClear(region, message);\n    if (queue.length > 0) this.#scheduleDrain(level);\n  }\n\n  /** Clears the region after `clearAfter` ms, unless a newer message replaced it. */\n  #scheduleClear(region: HTMLElement, message: string): void {\n    if (this.clearAfterValue <= 0) return;\n    this.#schedule(\n      region,\n      () => {\n        if (region.textContent === message) region.textContent = \"\";\n      },\n      this.clearAfterValue,\n    );\n  }\n\n  /**\n   * Arms `region`'s single pending timer. Callers reach here with the slot\n   * already free — `#announce` releases it, and a fired timer clears its own\n   * entry below — so this does not cancel again.\n   */\n  #schedule(region: HTMLElement, callback: () => void, delay: number): void {\n    const id = this.#timers.set(() => {\n      // Drop the id as it fires: platform timer ids are recycled, and a stale\n      // one left here could later cancel the *other* region's live timer.\n      this.#pending.delete(region);\n      callback();\n    }, delay);\n    this.#pending.set(region, id);\n  }\n\n  /** Releases `region`'s pending timer, if it has one. */\n  #cancelPending(region: HTMLElement): void {\n    // `SafeTimeout.clear` ignores an id it does not own, so the \"no pending\n    // timer\" case needs no branch of its own.\n    this.#timers.clear(this.#pending.get(region) ?? -1);\n    this.#pending.delete(region);\n  }\n\n  /**\n   * Resolves the live region for a politeness level.\n   *\n   * The remembered stand-in is used only while it is still in the document: a morph\n   * can drop it, and writing into the detached node would announce nothing at all.\n   */\n  #regionFor(level: Level): HTMLElement {\n    if (level === \"assertive\" && this.hasAssertiveTarget) return this.assertiveTarget;\n    if (level === \"polite\" && this.hasPoliteTarget) return this.politeTarget;\n\n    const existing = this.#generated.get(level);\n    if (existing?.isConnected) return existing;\n\n    const region = this.#createRegion(level);\n    this.#generated.set(level, region);\n    return region;\n  }\n\n  /**\n   * Restores the announceable initial state for the snapshot Turbo is about to\n   * take: queued and displayed messages go, generated regions go, and the live\n   * page — which keeps running when a visit is aborted — gets its regions back on\n   * the next task, after the clone.\n   */\n  #rewindForCache(): void {\n    this.#queues.clear();\n    this.#draining.clear();\n    this.#timers.clearAll();\n    for (const level of LEVELS) {\n      if (this.#hasTargetFor(level)) {\n        const target = level === \"assertive\" ? this.assertiveTarget : this.politeTarget;\n        target.textContent = \"\";\n      }\n    }\n    this.#removeGenerated();\n    this.#timers.set(() => this.#reconcileRegions(), 0);\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}\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"]}

package/dist/controllers/aspect_ratio_controller.d.ts

@@ -11,8 +11,8 @@ import { Controller } from '@hotwired/stimulus';
  *          data-stimeo--aspect-ratio-target="content" />
  *   </div>
  *
- * Supplies the requested ratio as the `--stimeo-aspect-ratio` custom property on
- * the host so consumer CSS can drive the box (`aspect-ratio: var(--stimeo-aspect-ratio)`)
+ * Supplies the requested ratio as the `--stimeo--aspect-ratio` custom property on
+ * the host so consumer CSS can drive the box (`aspect-ratio: var(--stimeo--aspect-ratio)`)
  * or a padding-hack fallback. The drawing itself — `aspect-ratio`, `object-fit`,
  * cropping — stays in the consumer's stylesheet.
  *

package/dist/controllers/aspect_ratio_controller.js

@@ -8,7 +8,7 @@ var AspectRatioController = class extends Controller {
   };
   /** Applies the ratio on connect and whenever the value changes. */
   ratioValueChanged() {
-    this.element.style.setProperty("--stimeo-aspect-ratio", this.#normalizeRatio(this.ratioValue));
+    this.element.style.setProperty("--stimeo--aspect-ratio", this.#normalizeRatio(this.ratioValue));
   }
   /**
    * Normalizes a ratio string to a valid CSS `<ratio>`:

package/dist/controllers/aspect_ratio_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controllers/aspect_ratio_controller.ts"],"names":[],"mappings":";;;AAwBO,IAAM,qBAAA,GAAN,cAAoC,UAAA,CAAwB;AAAA,EACjE,OAAgB,OAAA,GAAU,CAAC,SAAS,CAAA;AAAA,EACpC,OAAgB,MAAA,GAAS;AAAA,IACvB,KAAA,EAAO,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAS,KAAA;AAAM,GACxC;AAAA;AAAA,EAKA,iBAAA,GAA0B;AACxB,IAAA,IAAA,CAAK,OAAA,CAAQ,MAAM,WAAA,CAAY,uBAAA,EAAyB,KAAK,eAAA,CAAgB,IAAA,CAAK,UAAU,CAAC,CAAA;AAAA,EAC/F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,gBAAgB,GAAA,EAAqB;AACnC,IAAA,MAAM,KAAA,GAAQ,IAAI,IAAA,EAAK;AACvB,IAAA,IAAI,KAAA,CAAM,QAAA,CAAS,GAAG,CAAA,EAAG;AACvB,MAAA,MAAM,CAAC,CAAA,EAAG,CAAC,CAAA,GAAI,KAAA,CAAM,MAAM,GAAG,CAAA,CAAE,GAAA,CAAI,CAAC,SAAS,MAAA,CAAO,UAAA,CAAW,IAAA,CAAK,IAAA,EAAM,CAAC,CAAA;AAC5E,MAAA,IAAI,IAAA,CAAK,WAAA,CAAY,CAAC,CAAA,IAAK,IAAA,CAAK,WAAA,CAAY,CAAC,CAAA,EAAG,OAAO,CAAA,EAAG,CAAC,CAAA,GAAA,EAAM,CAAC,CAAA,CAAA;AAClE,MAAA,OAAO,OAAA;AAAA,IACT;AACA,IAAA,MAAM,MAAA,GAAS,MAAA,CAAO,UAAA,CAAW,KAAK,CAAA;AACtC,IAAA,OAAO,KAAK,WAAA,CAAY,MAAM,CAAA,GAAI,MAAA,CAAO,MAAM,CAAA,GAAI,OAAA;AAAA,EACrD;AAAA,EAEA,YAAY,KAAA,EAA4C;AACtD,IAAA,OAAO,UAAU,MAAA,IAAa,MAAA,CAAO,QAAA,CAAS,KAAK,KAAK,KAAA,GAAQ,CAAA;AAAA,EAClE;AACF","file":"aspect_ratio_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\n\n/**\n * Headless **Aspect Ratio** helper. No APG pattern — a pure layout utility with\n * no role or state.\n *\n * Markup contract (identifier: `stimeo--aspect-ratio`):\n *   <div data-controller=\"stimeo--aspect-ratio\"\n *        data-stimeo--aspect-ratio-ratio-value=\"16/9\">\n *     <img src=\"/cover.jpg\" alt=\"Cover\"\n *          data-stimeo--aspect-ratio-target=\"content\" />\n *   </div>\n *\n * Supplies the requested ratio as the `--stimeo-aspect-ratio` custom property on\n * the host so consumer CSS can drive the box (`aspect-ratio: var(--stimeo-aspect-ratio)`)\n * or a padding-hack fallback. The drawing itself — `aspect-ratio`, `object-fit`,\n * cropping — stays in the consumer's stylesheet.\n *\n * @remarks\n * Behavior only. The value accepts the CSS `<ratio>` forms `\"16/9\"` and a bare\n * number string (`\"1.5\"`); it is normalized to `\"w / h\"` (or the number) and an\n * unparseable value falls back to the default `1 / 1` rather than writing garbage\n * into the custom property. The reflection re-runs when the value changes.\n */\nexport class AspectRatioController extends Controller<HTMLElement> {\n  static override targets = [\"content\"];\n  static override values = {\n    ratio: { type: String, default: \"1/1\" },\n  };\n\n  declare ratioValue: string;\n\n  /** Applies the ratio on connect and whenever the value changes. */\n  ratioValueChanged(): void {\n    this.element.style.setProperty(\"--stimeo-aspect-ratio\", this.#normalizeRatio(this.ratioValue));\n  }\n\n  /**\n   * Normalizes a ratio string to a valid CSS `<ratio>`:\n   * - `\"16/9\"` / `\"16 / 9\"` → `\"16 / 9\"` (both parts must be positive numbers)\n   * - `\"1.5\"` → `\"1.5\"` (a bare positive number)\n   * - anything else → `\"1 / 1\"` (the default), so the custom property is always valid.\n   */\n  #normalizeRatio(raw: string): string {\n    const value = raw.trim();\n    if (value.includes(\"/\")) {\n      const [w, h] = value.split(\"/\").map((part) => Number.parseFloat(part.trim()));\n      if (this.#isPositive(w) && this.#isPositive(h)) return `${w} / ${h}`;\n      return \"1 / 1\";\n    }\n    const single = Number.parseFloat(value);\n    return this.#isPositive(single) ? String(single) : \"1 / 1\";\n  }\n\n  #isPositive(value: number | undefined): value is number {\n    return value !== undefined && Number.isFinite(value) && value > 0;\n  }\n}\n"]}
+{"version":3,"sources":["../../src/controllers/aspect_ratio_controller.ts"],"names":[],"mappings":";;;AAwBO,IAAM,qBAAA,GAAN,cAAoC,UAAA,CAAwB;AAAA,EACjE,OAAgB,OAAA,GAAU,CAAC,SAAS,CAAA;AAAA,EACpC,OAAgB,MAAA,GAAS;AAAA,IACvB,KAAA,EAAO,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAS,KAAA;AAAM,GACxC;AAAA;AAAA,EAKA,iBAAA,GAA0B;AACxB,IAAA,IAAA,CAAK,OAAA,CAAQ,MAAM,WAAA,CAAY,wBAAA,EAA0B,KAAK,eAAA,CAAgB,IAAA,CAAK,UAAU,CAAC,CAAA;AAAA,EAChG;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,gBAAgB,GAAA,EAAqB;AACnC,IAAA,MAAM,KAAA,GAAQ,IAAI,IAAA,EAAK;AACvB,IAAA,IAAI,KAAA,CAAM,QAAA,CAAS,GAAG,CAAA,EAAG;AACvB,MAAA,MAAM,CAAC,CAAA,EAAG,CAAC,CAAA,GAAI,KAAA,CAAM,MAAM,GAAG,CAAA,CAAE,GAAA,CAAI,CAAC,SAAS,MAAA,CAAO,UAAA,CAAW,IAAA,CAAK,IAAA,EAAM,CAAC,CAAA;AAC5E,MAAA,IAAI,IAAA,CAAK,WAAA,CAAY,CAAC,CAAA,IAAK,IAAA,CAAK,WAAA,CAAY,CAAC,CAAA,EAAG,OAAO,CAAA,EAAG,CAAC,CAAA,GAAA,EAAM,CAAC,CAAA,CAAA;AAClE,MAAA,OAAO,OAAA;AAAA,IACT;AACA,IAAA,MAAM,MAAA,GAAS,MAAA,CAAO,UAAA,CAAW,KAAK,CAAA;AACtC,IAAA,OAAO,KAAK,WAAA,CAAY,MAAM,CAAA,GAAI,MAAA,CAAO,MAAM,CAAA,GAAI,OAAA;AAAA,EACrD;AAAA,EAEA,YAAY,KAAA,EAA4C;AACtD,IAAA,OAAO,UAAU,MAAA,IAAa,MAAA,CAAO,QAAA,CAAS,KAAK,KAAK,KAAA,GAAQ,CAAA;AAAA,EAClE;AACF","file":"aspect_ratio_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\n\n/**\n * Headless **Aspect Ratio** helper. No APG pattern — a pure layout utility with\n * no role or state.\n *\n * Markup contract (identifier: `stimeo--aspect-ratio`):\n *   <div data-controller=\"stimeo--aspect-ratio\"\n *        data-stimeo--aspect-ratio-ratio-value=\"16/9\">\n *     <img src=\"/cover.jpg\" alt=\"Cover\"\n *          data-stimeo--aspect-ratio-target=\"content\" />\n *   </div>\n *\n * Supplies the requested ratio as the `--stimeo--aspect-ratio` custom property on\n * the host so consumer CSS can drive the box (`aspect-ratio: var(--stimeo--aspect-ratio)`)\n * or a padding-hack fallback. The drawing itself — `aspect-ratio`, `object-fit`,\n * cropping — stays in the consumer's stylesheet.\n *\n * @remarks\n * Behavior only. The value accepts the CSS `<ratio>` forms `\"16/9\"` and a bare\n * number string (`\"1.5\"`); it is normalized to `\"w / h\"` (or the number) and an\n * unparseable value falls back to the default `1 / 1` rather than writing garbage\n * into the custom property. The reflection re-runs when the value changes.\n */\nexport class AspectRatioController extends Controller<HTMLElement> {\n  static override targets = [\"content\"];\n  static override values = {\n    ratio: { type: String, default: \"1/1\" },\n  };\n\n  declare ratioValue: string;\n\n  /** Applies the ratio on connect and whenever the value changes. */\n  ratioValueChanged(): void {\n    this.element.style.setProperty(\"--stimeo--aspect-ratio\", this.#normalizeRatio(this.ratioValue));\n  }\n\n  /**\n   * Normalizes a ratio string to a valid CSS `<ratio>`:\n   * - `\"16/9\"` / `\"16 / 9\"` → `\"16 / 9\"` (both parts must be positive numbers)\n   * - `\"1.5\"` → `\"1.5\"` (a bare positive number)\n   * - anything else → `\"1 / 1\"` (the default), so the custom property is always valid.\n   */\n  #normalizeRatio(raw: string): string {\n    const value = raw.trim();\n    if (value.includes(\"/\")) {\n      const [w, h] = value.split(\"/\").map((part) => Number.parseFloat(part.trim()));\n      if (this.#isPositive(w) && this.#isPositive(h)) return `${w} / ${h}`;\n      return \"1 / 1\";\n    }\n    const single = Number.parseFloat(value);\n    return this.#isPositive(single) ? String(single) : \"1 / 1\";\n  }\n\n  #isPositive(value: number | undefined): value is number {\n    return value !== undefined && Number.isFinite(value) && value > 0;\n  }\n}\n"]}

package/dist/controllers/breadcrumb_controller.js

@@ -287,7 +287,11 @@ var BreadcrumbController = class extends Controller {
     this.ellipsisTarget.hidden = true;
     return this.listTarget.scrollWidth > this.listTarget.clientWidth + OVERFLOW_EPSILON;
   }
-  /** Applies the collapsed/expanded state to the items, ellipsis, and trigger. */
+  /**
+   * Applies the collapsed/expanded state to the items, ellipsis, and trigger.
+   *
+   * @stimeoRenderRoot
+   */
   #render() {
     const collapsed = this.#overflowing && !this.#expanded;
     const showEllipsis = this.#overflowing && this.collapsibleTargets.length > 0;

package/dist/controllers/breadcrumb_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/blur_deferral.ts","../../src/utils/layout_observer.ts","../../src/controllers/breadcrumb_controller.ts"],"names":[],"mappings":"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","file":"breadcrumb_controller.js","sourcesContent":["/**\n * Shared bookkeeping for updates that must wait until an element loses focus.\n *\n * A control that becomes redundant while the user is standing on it cannot be\n * removed from the page immediately: hiding a focused element (or turning it\n * into a native `disabled` one) drops focus to `<body>`, stranding a keyboard\n * user mid-widget. The fix every affected controller reached for is the same —\n * keep the element reachable, hold the destructive update, listen for `blur`,\n * and apply it then.\n *\n * {@link BlurDeferral} owns *only* the registry part of that: which elements are\n * currently holding an update back, attaching and detaching the `blur` listener,\n * and guaranteeing teardown. It is deliberately **policy-free** — what the\n * interim state looks like (`aria-disabled`, an ownership marker, nothing at\n * all), and what the deferred update actually is, stay in the controller, which\n * receives the element back through its release callback.\n *\n * Three contracts are worth stating up front, because each one is a hazard the\n * consumers would otherwise hit:\n *\n * - **The release callback fires only on a real `blur`.** `release()` /\n *   `releaseAll()` *cancel* a deferral; they do not complete it. Conflating the\n *   two makes `overflow-indicator` disable a button that just left the boundary.\n * - **`elements` is a snapshot.** Iterating the live key set while releasing\n *   inside the loop is the failure this registry exists to prevent.\n * - **The entry is detached before the callback runs**, so a controller that\n *   decides the update is still unsafe can simply defer again.\n *\n * This file's own doc block is dropped from `dist`, but every member comment is\n * inlined into each consumer entry (`tsup` builds with `splitting: false`), so\n * rationale belongs here and contracts belong on the members.\n *\n * @example\n * ```ts\n * readonly #deferred = new BlurDeferral<HTMLElement>((trigger) => {\n *   if (this.#connected) this.#evaluate();\n * });\n *\n * #hide(trigger: HTMLElement) {\n *   if (document.activeElement === trigger) {\n *     this.#deferred.deferOnly(trigger); // stays visible until blur\n *     return;\n *   }\n *   this.#deferred.releaseAll();\n *   trigger.hidden = true;\n * }\n *\n * disconnect() {\n *   this.#deferred.releaseAll();\n * }\n * ```\n */\nexport class BlurDeferral<T extends HTMLElement = HTMLElement> {\n  /** Elements currently holding an update back, mapped to their `blur` listener. */\n  readonly #pending = new Map<T, () => void>();\n  /** Called after a pending element blurs and has been detached. */\n  readonly #onRelease: (element: T) => void;\n\n  /** @param onRelease - Invoked once `element` actually blurs; never on `release`. */\n  constructor(onRelease: (element: T) => void) {\n    this.#onRelease = onRelease;\n  }\n\n  /** Number of elements currently holding an update back. */\n  get size(): number {\n    return this.#pending.size;\n  }\n\n  /** Snapshot of the pending elements, safe to iterate while releasing them. */\n  get elements(): T[] {\n    return [...this.#pending.keys()];\n  }\n\n  /** Whether `element` is currently holding an update back. */\n  has(element: T): boolean {\n    return this.#pending.has(element);\n  }\n\n  /** Holds an update back until `element` blurs. Idempotent (no stacked listeners). */\n  defer(element: T): void {\n    if (this.#pending.has(element)) return;\n    const onBlur = (): void => {\n      this.#detach(element);\n      this.#onRelease(element);\n    };\n    this.#pending.set(element, onBlur);\n    element.addEventListener(\"blur\", onBlur);\n  }\n\n  /** Defers `element` as the only pending entry, cancelling any others. */\n  deferOnly(element: T): void {\n    for (const pending of this.elements) {\n      if (pending !== element) this.#detach(pending);\n    }\n    this.defer(element);\n  }\n\n  /** Cancels `element`'s deferral without completing it; no-ops when not pending. */\n  release(element: T): void {\n    this.#detach(element);\n  }\n\n  /** Cancels every deferral without completing any of them. */\n  releaseAll(): void {\n    for (const element of this.elements) this.#detach(element);\n  }\n\n  /** Removes the `blur` listener for `element` and forgets it. */\n  #detach(element: T): void {\n    const onBlur = this.#pending.get(element);\n    if (onBlur) element.removeEventListener(\"blur\", onBlur);\n    this.#pending.delete(element);\n  }\n}\n","/**\n * Unified element-size and viewport observation for Stimeo controllers.\n *\n * Layout-sensitive widgets (sliders, resizable panes, scroll spies, popovers)\n * need to react both to their *own* box changing — via {@link ResizeObserver} —\n * and to the *viewport* changing — via the `window` `resize` event. Wiring those\n * two sources by hand in every controller risks leaked listeners on\n * `disconnect()`. {@link LayoutObserver} owns both behind one callback and one\n * {@link LayoutObserver.disconnect | disconnect()} that releases everything.\n *\n * Behavior only: the helper reports *that* layout changed; it never reads or\n * writes styles. Consumers decide what to recompute.\n */\n\n/** Invoked whenever an observed element or the viewport changes size. */\nexport type LayoutCallback = () => void;\n\n/** Constructs a {@link ResizeObserver}; injectable so tests stay deterministic. */\nexport type ResizeObserverFactory = (callback: ResizeObserverCallback) => ResizeObserver;\n\n/** Options for {@link LayoutObserver}. */\nexport interface LayoutObserverOptions {\n  /**\n   * Factory for the {@link ResizeObserver} used by {@link LayoutObserver.observe}.\n   * Defaults to the global constructor; override it in tests, or to no-op in\n   * environments where `ResizeObserver` is unavailable.\n   */\n  resizeObserverFactory?: ResizeObserverFactory;\n}\n\n/**\n * Observes element resizes and/or viewport resizes through a single callback,\n * with guaranteed teardown.\n *\n * @example\n * ```ts\n * #layout = new LayoutObserver(() => this.#reposition());\n *\n * connect() {\n *   this.#layout.observe(this.panelTarget);\n *   this.#layout.observeViewport();\n * }\n *\n * disconnect() {\n *   this.#layout.disconnect();\n * }\n * ```\n */\nexport class LayoutObserver {\n  readonly #callback: LayoutCallback;\n  readonly #resizeObserverFactory: ResizeObserverFactory | null;\n  #resizeObserver: ResizeObserver | null = null;\n  #observingViewport = false;\n\n  /** Stable bound handler so add/removeEventListener target the same reference. */\n  readonly #handleViewportResize = (): void => {\n    this.#callback();\n  };\n\n  constructor(callback: LayoutCallback, options: LayoutObserverOptions = {}) {\n    this.#callback = callback;\n    this.#resizeObserverFactory =\n      options.resizeObserverFactory ??\n      (typeof ResizeObserver === \"undefined\" ? null : (cb) => new ResizeObserver(cb));\n  }\n\n  /**\n   * Starts observing an element's size. Repeated calls observe additional\n   * elements through the same shared observer. No-ops when no\n   * `ResizeObserver` implementation is available.\n   */\n  observe(element: Element): void {\n    if (!this.#resizeObserverFactory) return;\n    if (!this.#resizeObserver) {\n      this.#resizeObserver = this.#resizeObserverFactory(() => {\n        this.#callback();\n      });\n    }\n    this.#resizeObserver.observe(element);\n  }\n\n  /** Stops observing a single element while leaving any others in place. */\n  unobserve(element: Element): void {\n    this.#resizeObserver?.unobserve(element);\n  }\n\n  /** Starts observing viewport resizes. Idempotent: the listener is added once. */\n  observeViewport(): void {\n    if (this.#observingViewport) return;\n    this.#observingViewport = true;\n    window.addEventListener(\"resize\", this.#handleViewportResize);\n  }\n\n  /** Stops observing viewport resizes without affecting element observation. */\n  unobserveViewport(): void {\n    if (!this.#observingViewport) return;\n    this.#observingViewport = false;\n    window.removeEventListener(\"resize\", this.#handleViewportResize);\n  }\n\n  /**\n   * Releases every observation: disconnects the {@link ResizeObserver} and\n   * removes the viewport listener. Safe to call multiple times. Call this from a\n   * controller's `disconnect()`.\n   */\n  disconnect(): void {\n    this.#resizeObserver?.disconnect();\n    this.#resizeObserver = null;\n    this.unobserveViewport();\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { BlurDeferral } from \"../utils/blur_deferral\";\nimport { LayoutObserver } from \"../utils/layout_observer\";\n\n/**\n * Sub-pixel tolerance (px) applied to the overflow comparison.\n *\n * Fractional layout metrics (zoom, `border-box` rounding, fractional font\n * metrics) routinely make `scrollWidth` exceed `clientWidth` by a fraction of a\n * pixel on a trail that visually fits, which would collapse it for no reason.\n * Same constant and rationale as `scroll_area_controller.ts`'s `EDGE_EPSILON`.\n */\nconst OVERFLOW_EPSILON = 1;\n\n/**\n * Headless, accessible responsive breadcrumb behavior.\n *\n * Markup contract (identifier: `stimeo--breadcrumb`):\n *   <nav data-controller=\"stimeo--breadcrumb\" aria-label=\"Breadcrumb\">\n *     <ol data-stimeo--breadcrumb-target=\"list\">\n *       <li><a href=\"/\">Home</a></li>\n *       <li data-stimeo--breadcrumb-target=\"ellipsis\" hidden>\n *         <button type=\"button\" aria-expanded=\"false\" aria-controls=\"bc-a bc-b\"\n *                 aria-label=\"Show full path\"\n *                 data-stimeo--breadcrumb-target=\"trigger\"\n *                 data-action=\"click->stimeo--breadcrumb#toggle\">…</button>\n *       </li>\n *       <li id=\"bc-a\" data-stimeo--breadcrumb-target=\"collapsible\"><a href=\"/a\">Section A</a></li>\n *       <li id=\"bc-b\" data-stimeo--breadcrumb-target=\"collapsible\"><a href=\"/a/b\">Sub B</a></li>\n *       <li><a href=\"/a/b/c\" aria-current=\"page\">Item C</a></li>\n *     </ol>\n *   </nav>\n *\n * Implements the WAI-ARIA APG **Breadcrumb** pattern. The base structure (`nav`\n * + `ol` + `aria-current=\"page\"`) lives in the markup; this controller adds the\n * responsive behavior: when the trail overflows its container it collapses the\n * author-marked middle items behind a disclosure (`…`) button, which expands\n * them back on demand.\n *\n * @remarks\n * Behavior only — the consumer owns separators (CSS) and the look. The items to\n * collapse are the author-marked `collapsible` targets (the source of truth),\n * placed between the leading and trailing items that must always stay visible.\n *\n * Behavior provided:\n * - Detects overflow via {@link LayoutObserver} (element + viewport resize) and a\n *   `MutationObserver` on the list (content edits, Turbo Stream / morph item\n *   swaps); the public `update` action re-measures on demand.\n * - While overflowing and not expanded, hides the `collapsible` items and shows\n *   the `ellipsis` item; when it fits, shows everything, hides the ellipsis and\n *   resets the expanded state (so a later collapse starts collapsed).\n * - The disclosure `trigger` toggles `aria-expanded` and the collapsed items,\n *   dispatching `stimeo--breadcrumb:toggle`. `toggle` is a no-op (no state\n *   change, no event) while the trail fits, so a hidden trigger can never be\n *   left reporting `aria-expanded=\"true\"`.\n *\n * Layout requirements the behavior depends on:\n * - **The list must not wrap** (`white-space: nowrap` / `flex-wrap: nowrap`). A\n *   wrapping list grows in height instead of scroll width, so\n *   `scrollWidth === clientWidth` always holds and overflow is never detected.\n * - **The list width must follow its container** (no shrink-to-fit / intrinsic\n *   width). Overflow is re-measured synchronously inside the resize\n *   notification, so a list that widens to its content would never report\n *   overflow. There is deliberately no debounce: the pass is one write → one\n *   forced read → one write on a single element.\n * - Consumers must not neutralize `[hidden]` (e.g. `display: inline-flex` on the\n *   items wins over the UA's `[hidden] { display: none }`); collapsing is\n *   expressed exclusively through the `hidden` attribute.\n *\n * Ownership of `hidden`: this controller owns the attribute on an element **for as\n * long as that element is a `collapsible` target and the controller is connected**.\n * Outside that window it does not write it:\n * - lose the marker while connected → the element becomes an always-visible item\n *   and the controller clears the `hidden` it owned;\n * - controller `disconnect()` → the collapsed state is left in the DOM on purpose,\n *   because that DOM is what Turbo caches and restores.\n *\n * A consumer that also wants to own `hidden` on the same element (for a reason of\n * its own) is not supported: `#measureOverflow` clears it on every measurement to\n * read the expanded width.\n *\n * Focus safety: hiding the element the user is standing on would drop focus to\n * `<body>`. When a collapse would hide the focused item, focus moves to the\n * disclosure `trigger` first; when the ellipsis would be hidden while it holds\n * focus, the hide waits for `blur`.\n *\n * **Fail-safe when the disclosure is incomplete.** Collapsing needs all of\n * `list`, one `collapsible`, `ellipsis`, and `trigger`; miss any and the trail\n * degrades to a plain APG breadcrumb (every item visible, ellipsis hidden,\n * `aria-expanded=\"false\"`, `toggle` a silent no-op). Hiding the middle items\n * with no control that can reveal them puts the path out of reach for good — a\n * too-wide trail is the cheaper failure. Watched at runtime, so a swap that\n * breaks the set releases the items and one that completes it starts collapsing.\n */\nexport class BreadcrumbController extends Controller<HTMLElement> {\n  static override targets = [\"list\", \"collapsible\", \"ellipsis\", \"trigger\"];\n  static actions = [\"toggle\", \"update\"] as const;\n  static events = [\"toggle\"] as const;\n\n  declare readonly listTarget: HTMLElement;\n  declare readonly collapsibleTargets: HTMLElement[];\n  declare readonly ellipsisTarget: HTMLElement;\n  declare readonly triggerTarget: HTMLElement;\n  declare readonly hasListTarget: boolean;\n  declare readonly hasEllipsisTarget: boolean;\n  declare readonly hasTriggerTarget: boolean;\n\n  /** Guards target callbacks that can fire outside the connected window. */\n  #connected = false;\n  /** Whether the trail currently overflows its container. */\n  #overflowing = false;\n  /** Whether the user has expanded the collapsed items via the disclosure. */\n  #expanded = false;\n  /** The list element currently observed (resize + mutations), if any. */\n  #observedList: HTMLElement | null = null;\n  #listMutations: MutationObserver | null = null;\n  readonly #layout = new LayoutObserver(() => this.update());\n\n  readonly #onListMutation = (): void => {\n    this.update();\n  };\n\n  /** Holds the ellipsis hide back while it contains focus; re-renders on blur. */\n  readonly #deferredHide = new BlurDeferral(() => {\n    this.#render();\n  });\n\n  /** Starts observing for overflow and renders the initial state. */\n  override connect(): void {\n    this.#connected = true;\n    // The DOM is the source of truth on reconnect (Turbo cache restore / morph):\n    // the trigger's `aria-expanded` is where the expanded state lives, so a trail\n    // the user opened survives a back-navigation instead of silently re-collapsing.\n    this.#expanded = this.#initialExpanded();\n    this.#layout.observeViewport();\n    this.#syncListObservation();\n    this.update();\n  }\n\n  /** Releases the resize/mutation observation (Turbo navigation included). */\n  override disconnect(): void {\n    this.#connected = false;\n    this.#deferredHide.releaseAll();\n    this.#stopObservingList();\n    this.#layout.disconnect();\n  }\n\n  listTargetConnected(): void {\n    this.#resync();\n  }\n\n  listTargetDisconnected(): void {\n    this.#resync();\n  }\n\n  collapsibleTargetConnected(): void {\n    this.#resync();\n  }\n\n  /**\n   * Re-measures when the disclosure set gains or loses a member. The set is a\n   * precondition for collapsing at all, so it needs the same watching the list\n   * and items get: without these callbacks a swap that breaks or completes the\n   * set would only take effect at the next resize or list mutation, which may\n   * never come.\n   */\n  ellipsisTargetConnected(): void {\n    this.#resync();\n  }\n\n  ellipsisTargetDisconnected(): void {\n    this.#resync();\n  }\n\n  triggerTargetConnected(): void {\n    this.#resync();\n  }\n\n  triggerTargetDisconnected(): void {\n    this.#resync();\n  }\n\n  /**\n   * Hands `hidden` back when an element stops being a `collapsible` target.\n   *\n   * The marker is the source of truth for what may be collapsed, so an element\n   * that loses it while the controller is live is an always-visible item again —\n   * and `#render` only walks the *current* targets, so nothing else would ever\n   * clear the `hidden` this controller put there.\n   *\n   * The `#connected` guard is load-bearing, not defensive. Stimulus fires this\n   * callback for **every** target during teardown as well (`Context.disconnect()`\n   * stops the target observer after `disconnect()` has run), and there the\n   * collapsed DOM must survive untouched so Turbo's cache restores the trail in\n   * the state the user left it (see the ownership note in {@link BreadcrumbController}).\n   *\n   * @param element - the element that just left the `collapsible` target set\n   */\n  collapsibleTargetDisconnected(element: HTMLElement): void {\n    if (this.#connected) element.hidden = false;\n    this.#resync();\n  }\n\n  /**\n   * Expands or re-collapses the trail and dispatches `toggle`.\n   *\n   * No-op while the trail fits: there is nothing collapsed to reveal, and the\n   * (hidden) trigger would otherwise keep a stale `aria-expanded=\"true\"` that\n   * surfaces pre-expanded the next time the trail overflows. No event is\n   * dispatched in that case.\n   */\n  toggle(): void {\n    if (!this.#connected || !this.#overflowing) return;\n    this.#expanded = !this.#expanded;\n    this.#render();\n    this.dispatch(\"toggle\", { detail: { expanded: this.#expanded } });\n  }\n\n  /**\n   * Re-measures overflow and re-renders. Wired to resizes and list mutations;\n   * exposed as an action so consumers can re-measure after a change the\n   * observers cannot see (e.g. a web font swap that only alters text width).\n   */\n  update(): void {\n    if (!this.#connected) return;\n    this.#overflowing = this.#measureOverflow();\n    if (!this.#overflowing) this.#expanded = false;\n    this.#render();\n  }\n\n  /** Re-attaches the list observation (targets may have been swapped) and re-measures. */\n  #resync(): void {\n    if (!this.#connected) return;\n    this.#syncListObservation();\n    this.update();\n  }\n\n  /** Reads the expanded state back from its DOM home (the trigger's `aria-expanded`). */\n  #initialExpanded(): boolean {\n    return this.hasTriggerTarget && this.triggerTarget.getAttribute(\"aria-expanded\") === \"true\";\n  }\n\n  /**\n   * Points the resize + mutation observation at the current `list` target.\n   *\n   * The list is re-resolved rather than captured at connect so a target swapped\n   * at runtime (Turbo Stream replacement of the `<ol>`) is observed too. Only\n   * `childList` / `subtree` / `characterData` are watched — deliberately **not**\n   * `attributes`, which the controller's own `hidden` writes would re-trigger.\n   */\n  #syncListObservation(): void {\n    const next = this.hasListTarget ? this.listTarget : null;\n    if (next === this.#observedList) return;\n\n    this.#stopObservingList();\n    if (!next) return;\n\n    this.#observedList = next;\n    this.#layout.observe(next);\n    if (typeof MutationObserver !== \"undefined\") {\n      this.#listMutations = new MutationObserver(this.#onListMutation);\n      this.#listMutations.observe(next, { childList: true, subtree: true, characterData: true });\n    }\n  }\n\n  #stopObservingList(): void {\n    if (this.#observedList) this.#layout.unobserve(this.#observedList);\n    this.#observedList = null;\n    this.#listMutations?.disconnect();\n    this.#listMutations = null;\n  }\n\n  /**\n   * Measures overflow against the **fully expanded** layout so hiding items does\n   * not make the condition oscillate. Reveals every item, then compares the list's\n   * own scroll width to its own client width; `#render` immediately re-applies\n   * the correct hidden state afterward.\n   *\n   * Both widths are read from the list element itself (not the host `nav`) so the\n   * check is independent of any padding/border on the host — comparing against the\n   * host's `clientWidth` would over-report the available space by its padding and\n   * miss real overflow in a padded container.\n   *\n   * With no `collapsible` items there is nothing to collapse, so the trail is\n   * never reported as overflowing (which also keeps the disclosure out of the\n   * tab order — a button controlling nothing).\n   *\n   * The full disclosure set is a precondition: collapsing without an `ellipsis`\n   * *and* a `trigger` would hide items behind a control that does not exist, so\n   * an incomplete set reports \"not overflowing\" and `#render` degrades the trail\n   * to a plain breadcrumb. Losing layout is recoverable; losing the path is not.\n   */\n  #measureOverflow(): boolean {\n    if (!this.hasListTarget || this.collapsibleTargets.length === 0) return false;\n    if (!this.hasEllipsisTarget || !this.hasTriggerTarget) return false;\n    for (const item of this.collapsibleTargets) item.hidden = false;\n    // No `hasEllipsisTarget` check: the line above already returned without one.\n    this.ellipsisTarget.hidden = true;\n    return this.listTarget.scrollWidth > this.listTarget.clientWidth + OVERFLOW_EPSILON;\n  }\n\n  /** Applies the collapsed/expanded state to the items, ellipsis, and trigger. */\n  #render(): void {\n    const collapsed = this.#overflowing && !this.#expanded;\n    const showEllipsis = this.#overflowing && this.collapsibleTargets.length > 0;\n\n    // Decided *before* the writes below: once a focused item is hidden the browser\n    // drops focus to <body> and the information is gone (same reasoning as\n    // `overflow_menu_controller`'s pre-move focus decision).\n    const rescueFocus =\n      collapsed &&\n      this.hasTriggerTarget &&\n      this.collapsibleTargets.some((i) => this.#holdsFocus(i));\n\n    for (const item of this.collapsibleTargets) item.hidden = collapsed;\n    if (this.hasEllipsisTarget) this.#applyEllipsisVisibility(showEllipsis);\n    if (this.hasTriggerTarget) {\n      // Never report expanded while the trail fits: the trigger is hidden then.\n      const expanded = this.#overflowing && this.#expanded;\n      this.triggerTarget.setAttribute(\"aria-expanded\", expanded ? \"true\" : \"false\");\n    }\n    if (rescueFocus) this.triggerTarget.focus();\n  }\n\n  /**\n   * Shows or hides the ellipsis item, deferring a hide that would blur the user.\n   *\n   * Hiding the element that currently holds focus drops focus to `<body>`, so the\n   * hide waits for that element's `blur` and is re-applied then (the shared\n   * `BlurDeferral` registry).\n   */\n  #applyEllipsisVisibility(show: boolean): void {\n    const ellipsis = this.ellipsisTarget;\n    if (show) {\n      this.#deferredHide.releaseAll();\n      ellipsis.hidden = false;\n      return;\n    }\n\n    const active = document.activeElement;\n    if (active instanceof HTMLElement && ellipsis.contains(active)) {\n      ellipsis.hidden = false;\n      this.#deferredHide.deferOnly(active);\n      return;\n    }\n\n    this.#deferredHide.releaseAll();\n    ellipsis.hidden = true;\n  }\n\n  /** Whether `element` contains (or is) the currently focused element. */\n  #holdsFocus(element: HTMLElement): boolean {\n    const active = document.activeElement;\n    return active instanceof HTMLElement && element.contains(active);\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/blur_deferral.ts","../../src/utils/layout_observer.ts","../../src/controllers/breadcrumb_controller.ts"],"names":[],"mappings":"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","file":"breadcrumb_controller.js","sourcesContent":["/**\n * Shared bookkeeping for updates that must wait until an element loses focus.\n *\n * A control that becomes redundant while the user is standing on it cannot be\n * removed from the page immediately: hiding a focused element (or turning it\n * into a native `disabled` one) drops focus to `<body>`, stranding a keyboard\n * user mid-widget. The fix every affected controller reached for is the same —\n * keep the element reachable, hold the destructive update, listen for `blur`,\n * and apply it then.\n *\n * {@link BlurDeferral} owns *only* the registry part of that: which elements are\n * currently holding an update back, attaching and detaching the `blur` listener,\n * and guaranteeing teardown. It is deliberately **policy-free** — what the\n * interim state looks like (`aria-disabled`, an ownership marker, nothing at\n * all), and what the deferred update actually is, stay in the controller, which\n * receives the element back through its release callback.\n *\n * Three contracts are worth stating up front, because each one is a hazard the\n * consumers would otherwise hit:\n *\n * - **The release callback fires only on a real `blur`.** `release()` /\n *   `releaseAll()` *cancel* a deferral; they do not complete it. Conflating the\n *   two makes `overflow-indicator` disable a button that just left the boundary.\n * - **`elements` is a snapshot.** Iterating the live key set while releasing\n *   inside the loop is the failure this registry exists to prevent.\n * - **The entry is detached before the callback runs**, so a controller that\n *   decides the update is still unsafe can simply defer again.\n *\n * This file's own doc block is dropped from `dist`, but every member comment is\n * inlined into each consumer entry (`tsup` builds with `splitting: false`), so\n * rationale belongs here and contracts belong on the members.\n *\n * @example\n * ```ts\n * readonly #deferred = new BlurDeferral<HTMLElement>((trigger) => {\n *   if (this.#connected) this.#evaluate();\n * });\n *\n * #hide(trigger: HTMLElement) {\n *   if (document.activeElement === trigger) {\n *     this.#deferred.deferOnly(trigger); // stays visible until blur\n *     return;\n *   }\n *   this.#deferred.releaseAll();\n *   trigger.hidden = true;\n * }\n *\n * disconnect() {\n *   this.#deferred.releaseAll();\n * }\n * ```\n */\nexport class BlurDeferral<T extends HTMLElement = HTMLElement> {\n  /** Elements currently holding an update back, mapped to their `blur` listener. */\n  readonly #pending = new Map<T, () => void>();\n  /** Called after a pending element blurs and has been detached. */\n  readonly #onRelease: (element: T) => void;\n\n  /** @param onRelease - Invoked once `element` actually blurs; never on `release`. */\n  constructor(onRelease: (element: T) => void) {\n    this.#onRelease = onRelease;\n  }\n\n  /** Number of elements currently holding an update back. */\n  get size(): number {\n    return this.#pending.size;\n  }\n\n  /** Snapshot of the pending elements, safe to iterate while releasing them. */\n  get elements(): T[] {\n    return [...this.#pending.keys()];\n  }\n\n  /** Whether `element` is currently holding an update back. */\n  has(element: T): boolean {\n    return this.#pending.has(element);\n  }\n\n  /** Holds an update back until `element` blurs. Idempotent (no stacked listeners). */\n  defer(element: T): void {\n    if (this.#pending.has(element)) return;\n    const onBlur = (): void => {\n      this.#detach(element);\n      this.#onRelease(element);\n    };\n    this.#pending.set(element, onBlur);\n    element.addEventListener(\"blur\", onBlur);\n  }\n\n  /** Defers `element` as the only pending entry, cancelling any others. */\n  deferOnly(element: T): void {\n    for (const pending of this.elements) {\n      if (pending !== element) this.#detach(pending);\n    }\n    this.defer(element);\n  }\n\n  /** Cancels `element`'s deferral without completing it; no-ops when not pending. */\n  release(element: T): void {\n    this.#detach(element);\n  }\n\n  /** Cancels every deferral without completing any of them. */\n  releaseAll(): void {\n    for (const element of this.elements) this.#detach(element);\n  }\n\n  /** Removes the `blur` listener for `element` and forgets it. */\n  #detach(element: T): void {\n    const onBlur = this.#pending.get(element);\n    if (onBlur) element.removeEventListener(\"blur\", onBlur);\n    this.#pending.delete(element);\n  }\n}\n","/**\n * Unified element-size and viewport observation for Stimeo controllers.\n *\n * Layout-sensitive widgets (sliders, resizable panes, scroll spies, popovers)\n * need to react both to their *own* box changing — via {@link ResizeObserver} —\n * and to the *viewport* changing — via the `window` `resize` event. Wiring those\n * two sources by hand in every controller risks leaked listeners on\n * `disconnect()`. {@link LayoutObserver} owns both behind one callback and one\n * {@link LayoutObserver.disconnect | disconnect()} that releases everything.\n *\n * Behavior only: the helper reports *that* layout changed; it never reads or\n * writes styles. Consumers decide what to recompute.\n */\n\n/** Invoked whenever an observed element or the viewport changes size. */\nexport type LayoutCallback = () => void;\n\n/** Constructs a {@link ResizeObserver}; injectable so tests stay deterministic. */\nexport type ResizeObserverFactory = (callback: ResizeObserverCallback) => ResizeObserver;\n\n/** Options for {@link LayoutObserver}. */\nexport interface LayoutObserverOptions {\n  /**\n   * Factory for the {@link ResizeObserver} used by {@link LayoutObserver.observe}.\n   * Defaults to the global constructor; override it in tests, or to no-op in\n   * environments where `ResizeObserver` is unavailable.\n   */\n  resizeObserverFactory?: ResizeObserverFactory;\n}\n\n/**\n * Observes element resizes and/or viewport resizes through a single callback,\n * with guaranteed teardown.\n *\n * @example\n * ```ts\n * #layout = new LayoutObserver(() => this.#reposition());\n *\n * connect() {\n *   this.#layout.observe(this.panelTarget);\n *   this.#layout.observeViewport();\n * }\n *\n * disconnect() {\n *   this.#layout.disconnect();\n * }\n * ```\n */\nexport class LayoutObserver {\n  readonly #callback: LayoutCallback;\n  readonly #resizeObserverFactory: ResizeObserverFactory | null;\n  #resizeObserver: ResizeObserver | null = null;\n  #observingViewport = false;\n\n  /** Stable bound handler so add/removeEventListener target the same reference. */\n  readonly #handleViewportResize = (): void => {\n    this.#callback();\n  };\n\n  constructor(callback: LayoutCallback, options: LayoutObserverOptions = {}) {\n    this.#callback = callback;\n    this.#resizeObserverFactory =\n      options.resizeObserverFactory ??\n      (typeof ResizeObserver === \"undefined\" ? null : (cb) => new ResizeObserver(cb));\n  }\n\n  /**\n   * Starts observing an element's size. Repeated calls observe additional\n   * elements through the same shared observer. No-ops when no\n   * `ResizeObserver` implementation is available.\n   */\n  observe(element: Element): void {\n    if (!this.#resizeObserverFactory) return;\n    if (!this.#resizeObserver) {\n      this.#resizeObserver = this.#resizeObserverFactory(() => {\n        this.#callback();\n      });\n    }\n    this.#resizeObserver.observe(element);\n  }\n\n  /** Stops observing a single element while leaving any others in place. */\n  unobserve(element: Element): void {\n    this.#resizeObserver?.unobserve(element);\n  }\n\n  /** Starts observing viewport resizes. Idempotent: the listener is added once. */\n  observeViewport(): void {\n    if (this.#observingViewport) return;\n    this.#observingViewport = true;\n    window.addEventListener(\"resize\", this.#handleViewportResize);\n  }\n\n  /** Stops observing viewport resizes without affecting element observation. */\n  unobserveViewport(): void {\n    if (!this.#observingViewport) return;\n    this.#observingViewport = false;\n    window.removeEventListener(\"resize\", this.#handleViewportResize);\n  }\n\n  /**\n   * Releases every observation: disconnects the {@link ResizeObserver} and\n   * removes the viewport listener. Safe to call multiple times. Call this from a\n   * controller's `disconnect()`.\n   */\n  disconnect(): void {\n    this.#resizeObserver?.disconnect();\n    this.#resizeObserver = null;\n    this.unobserveViewport();\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { BlurDeferral } from \"../utils/blur_deferral\";\nimport { LayoutObserver } from \"../utils/layout_observer\";\n\n/**\n * Sub-pixel tolerance (px) applied to the overflow comparison.\n *\n * Fractional layout metrics (zoom, `border-box` rounding, fractional font\n * metrics) routinely make `scrollWidth` exceed `clientWidth` by a fraction of a\n * pixel on a trail that visually fits, which would collapse it for no reason.\n * Same constant and rationale as `scroll_area_controller.ts`'s `EDGE_EPSILON`.\n */\nconst OVERFLOW_EPSILON = 1;\n\n/**\n * Headless, accessible responsive breadcrumb behavior.\n *\n * Markup contract (identifier: `stimeo--breadcrumb`):\n *   <nav data-controller=\"stimeo--breadcrumb\" aria-label=\"Breadcrumb\">\n *     <ol data-stimeo--breadcrumb-target=\"list\">\n *       <li><a href=\"/\">Home</a></li>\n *       <li data-stimeo--breadcrumb-target=\"ellipsis\" hidden>\n *         <button type=\"button\" aria-expanded=\"false\" aria-controls=\"bc-a bc-b\"\n *                 aria-label=\"Show full path\"\n *                 data-stimeo--breadcrumb-target=\"trigger\"\n *                 data-action=\"click->stimeo--breadcrumb#toggle\">…</button>\n *       </li>\n *       <li id=\"bc-a\" data-stimeo--breadcrumb-target=\"collapsible\"><a href=\"/a\">Section A</a></li>\n *       <li id=\"bc-b\" data-stimeo--breadcrumb-target=\"collapsible\"><a href=\"/a/b\">Sub B</a></li>\n *       <li><a href=\"/a/b/c\" aria-current=\"page\">Item C</a></li>\n *     </ol>\n *   </nav>\n *\n * Implements the WAI-ARIA APG **Breadcrumb** pattern. The base structure (`nav`\n * + `ol` + `aria-current=\"page\"`) lives in the markup; this controller adds the\n * responsive behavior: when the trail overflows its container it collapses the\n * author-marked middle items behind a disclosure (`…`) button, which expands\n * them back on demand.\n *\n * @remarks\n * Behavior only — the consumer owns separators (CSS) and the look. The items to\n * collapse are the author-marked `collapsible` targets (the source of truth),\n * placed between the leading and trailing items that must always stay visible.\n *\n * Behavior provided:\n * - Detects overflow via {@link LayoutObserver} (element + viewport resize) and a\n *   `MutationObserver` on the list (content edits, Turbo Stream / morph item\n *   swaps); the public `update` action re-measures on demand.\n * - While overflowing and not expanded, hides the `collapsible` items and shows\n *   the `ellipsis` item; when it fits, shows everything, hides the ellipsis and\n *   resets the expanded state (so a later collapse starts collapsed).\n * - The disclosure `trigger` toggles `aria-expanded` and the collapsed items,\n *   dispatching `stimeo--breadcrumb:toggle`. `toggle` is a no-op (no state\n *   change, no event) while the trail fits, so a hidden trigger can never be\n *   left reporting `aria-expanded=\"true\"`.\n *\n * Layout requirements the behavior depends on:\n * - **The list must not wrap** (`white-space: nowrap` / `flex-wrap: nowrap`). A\n *   wrapping list grows in height instead of scroll width, so\n *   `scrollWidth === clientWidth` always holds and overflow is never detected.\n * - **The list width must follow its container** (no shrink-to-fit / intrinsic\n *   width). Overflow is re-measured synchronously inside the resize\n *   notification, so a list that widens to its content would never report\n *   overflow. There is deliberately no debounce: the pass is one write → one\n *   forced read → one write on a single element.\n * - Consumers must not neutralize `[hidden]` (e.g. `display: inline-flex` on the\n *   items wins over the UA's `[hidden] { display: none }`); collapsing is\n *   expressed exclusively through the `hidden` attribute.\n *\n * Ownership of `hidden`: this controller owns the attribute on an element **for as\n * long as that element is a `collapsible` target and the controller is connected**.\n * Outside that window it does not write it:\n * - lose the marker while connected → the element becomes an always-visible item\n *   and the controller clears the `hidden` it owned;\n * - controller `disconnect()` → the collapsed state is left in the DOM on purpose,\n *   because that DOM is what Turbo caches and restores.\n *\n * A consumer that also wants to own `hidden` on the same element (for a reason of\n * its own) is not supported: `#measureOverflow` clears it on every measurement to\n * read the expanded width.\n *\n * Focus safety: hiding the element the user is standing on would drop focus to\n * `<body>`. When a collapse would hide the focused item, focus moves to the\n * disclosure `trigger` first; when the ellipsis would be hidden while it holds\n * focus, the hide waits for `blur`.\n *\n * **Fail-safe when the disclosure is incomplete.** Collapsing needs all of\n * `list`, one `collapsible`, `ellipsis`, and `trigger`; miss any and the trail\n * degrades to a plain APG breadcrumb (every item visible, ellipsis hidden,\n * `aria-expanded=\"false\"`, `toggle` a silent no-op). Hiding the middle items\n * with no control that can reveal them puts the path out of reach for good — a\n * too-wide trail is the cheaper failure. Watched at runtime, so a swap that\n * breaks the set releases the items and one that completes it starts collapsing.\n */\nexport class BreadcrumbController extends Controller<HTMLElement> {\n  static override targets = [\"list\", \"collapsible\", \"ellipsis\", \"trigger\"];\n  static actions = [\"toggle\", \"update\"] as const;\n  static events = [\"toggle\"] as const;\n\n  declare readonly listTarget: HTMLElement;\n  declare readonly collapsibleTargets: HTMLElement[];\n  declare readonly ellipsisTarget: HTMLElement;\n  declare readonly triggerTarget: HTMLElement;\n  declare readonly hasListTarget: boolean;\n  declare readonly hasEllipsisTarget: boolean;\n  declare readonly hasTriggerTarget: boolean;\n\n  /** Guards target callbacks that can fire outside the connected window. */\n  #connected = false;\n  /** Whether the trail currently overflows its container. */\n  #overflowing = false;\n  /** Whether the user has expanded the collapsed items via the disclosure. */\n  #expanded = false;\n  /** The list element currently observed (resize + mutations), if any. */\n  #observedList: HTMLElement | null = null;\n  #listMutations: MutationObserver | null = null;\n  readonly #layout = new LayoutObserver(() => this.update());\n\n  readonly #onListMutation = (): void => {\n    this.update();\n  };\n\n  /** Holds the ellipsis hide back while it contains focus; re-renders on blur. */\n  readonly #deferredHide = new BlurDeferral(() => {\n    this.#render();\n  });\n\n  /** Starts observing for overflow and renders the initial state. */\n  override connect(): void {\n    this.#connected = true;\n    // The DOM is the source of truth on reconnect (Turbo cache restore / morph):\n    // the trigger's `aria-expanded` is where the expanded state lives, so a trail\n    // the user opened survives a back-navigation instead of silently re-collapsing.\n    this.#expanded = this.#initialExpanded();\n    this.#layout.observeViewport();\n    this.#syncListObservation();\n    this.update();\n  }\n\n  /** Releases the resize/mutation observation (Turbo navigation included). */\n  override disconnect(): void {\n    this.#connected = false;\n    this.#deferredHide.releaseAll();\n    this.#stopObservingList();\n    this.#layout.disconnect();\n  }\n\n  listTargetConnected(): void {\n    this.#resync();\n  }\n\n  listTargetDisconnected(): void {\n    this.#resync();\n  }\n\n  collapsibleTargetConnected(): void {\n    this.#resync();\n  }\n\n  /**\n   * Re-measures when the disclosure set gains or loses a member. The set is a\n   * precondition for collapsing at all, so it needs the same watching the list\n   * and items get: without these callbacks a swap that breaks or completes the\n   * set would only take effect at the next resize or list mutation, which may\n   * never come.\n   */\n  ellipsisTargetConnected(): void {\n    this.#resync();\n  }\n\n  ellipsisTargetDisconnected(): void {\n    this.#resync();\n  }\n\n  triggerTargetConnected(): void {\n    this.#resync();\n  }\n\n  triggerTargetDisconnected(): void {\n    this.#resync();\n  }\n\n  /**\n   * Hands `hidden` back when an element stops being a `collapsible` target.\n   *\n   * The marker is the source of truth for what may be collapsed, so an element\n   * that loses it while the controller is live is an always-visible item again —\n   * and `#render` only walks the *current* targets, so nothing else would ever\n   * clear the `hidden` this controller put there.\n   *\n   * The `#connected` guard is load-bearing, not defensive. Stimulus fires this\n   * callback for **every** target during teardown as well (`Context.disconnect()`\n   * stops the target observer after `disconnect()` has run), and there the\n   * collapsed DOM must survive untouched so Turbo's cache restores the trail in\n   * the state the user left it (see the ownership note in {@link BreadcrumbController}).\n   *\n   * @param element - the element that just left the `collapsible` target set\n   */\n  collapsibleTargetDisconnected(element: HTMLElement): void {\n    if (this.#connected) element.hidden = false;\n    this.#resync();\n  }\n\n  /**\n   * Expands or re-collapses the trail and dispatches `toggle`.\n   *\n   * No-op while the trail fits: there is nothing collapsed to reveal, and the\n   * (hidden) trigger would otherwise keep a stale `aria-expanded=\"true\"` that\n   * surfaces pre-expanded the next time the trail overflows. No event is\n   * dispatched in that case.\n   */\n  toggle(): void {\n    if (!this.#connected || !this.#overflowing) return;\n    this.#expanded = !this.#expanded;\n    this.#render();\n    this.dispatch(\"toggle\", { detail: { expanded: this.#expanded } });\n  }\n\n  /**\n   * Re-measures overflow and re-renders. Wired to resizes and list mutations;\n   * exposed as an action so consumers can re-measure after a change the\n   * observers cannot see (e.g. a web font swap that only alters text width).\n   */\n  update(): void {\n    if (!this.#connected) return;\n    this.#overflowing = this.#measureOverflow();\n    if (!this.#overflowing) this.#expanded = false;\n    this.#render();\n  }\n\n  /** Re-attaches the list observation (targets may have been swapped) and re-measures. */\n  #resync(): void {\n    if (!this.#connected) return;\n    this.#syncListObservation();\n    this.update();\n  }\n\n  /** Reads the expanded state back from its DOM home (the trigger's `aria-expanded`). */\n  #initialExpanded(): boolean {\n    return this.hasTriggerTarget && this.triggerTarget.getAttribute(\"aria-expanded\") === \"true\";\n  }\n\n  /**\n   * Points the resize + mutation observation at the current `list` target.\n   *\n   * The list is re-resolved rather than captured at connect so a target swapped\n   * at runtime (Turbo Stream replacement of the `<ol>`) is observed too. Only\n   * `childList` / `subtree` / `characterData` are watched — deliberately **not**\n   * `attributes`, which the controller's own `hidden` writes would re-trigger.\n   */\n  #syncListObservation(): void {\n    const next = this.hasListTarget ? this.listTarget : null;\n    if (next === this.#observedList) return;\n\n    this.#stopObservingList();\n    if (!next) return;\n\n    this.#observedList = next;\n    this.#layout.observe(next);\n    if (typeof MutationObserver !== \"undefined\") {\n      this.#listMutations = new MutationObserver(this.#onListMutation);\n      this.#listMutations.observe(next, { childList: true, subtree: true, characterData: true });\n    }\n  }\n\n  #stopObservingList(): void {\n    if (this.#observedList) this.#layout.unobserve(this.#observedList);\n    this.#observedList = null;\n    this.#listMutations?.disconnect();\n    this.#listMutations = null;\n  }\n\n  /**\n   * Measures overflow against the **fully expanded** layout so hiding items does\n   * not make the condition oscillate. Reveals every item, then compares the list's\n   * own scroll width to its own client width; `#render` immediately re-applies\n   * the correct hidden state afterward.\n   *\n   * Both widths are read from the list element itself (not the host `nav`) so the\n   * check is independent of any padding/border on the host — comparing against the\n   * host's `clientWidth` would over-report the available space by its padding and\n   * miss real overflow in a padded container.\n   *\n   * With no `collapsible` items there is nothing to collapse, so the trail is\n   * never reported as overflowing (which also keeps the disclosure out of the\n   * tab order — a button controlling nothing).\n   *\n   * The full disclosure set is a precondition: collapsing without an `ellipsis`\n   * *and* a `trigger` would hide items behind a control that does not exist, so\n   * an incomplete set reports \"not overflowing\" and `#render` degrades the trail\n   * to a plain breadcrumb. Losing layout is recoverable; losing the path is not.\n   */\n  #measureOverflow(): boolean {\n    if (!this.hasListTarget || this.collapsibleTargets.length === 0) return false;\n    if (!this.hasEllipsisTarget || !this.hasTriggerTarget) return false;\n    for (const item of this.collapsibleTargets) item.hidden = false;\n    // No `hasEllipsisTarget` check: the line above already returned without one.\n    this.ellipsisTarget.hidden = true;\n    return this.listTarget.scrollWidth > this.listTarget.clientWidth + OVERFLOW_EPSILON;\n  }\n\n  /**\n   * Applies the collapsed/expanded state to the items, ellipsis, and trigger.\n   *\n   * @stimeoRenderRoot\n   */\n  #render(): void {\n    const collapsed = this.#overflowing && !this.#expanded;\n    const showEllipsis = this.#overflowing && this.collapsibleTargets.length > 0;\n\n    // Decided *before* the writes below: once a focused item is hidden the browser\n    // drops focus to <body> and the information is gone (same reasoning as\n    // `overflow_menu_controller`'s pre-move focus decision).\n    const rescueFocus =\n      collapsed &&\n      this.hasTriggerTarget &&\n      this.collapsibleTargets.some((i) => this.#holdsFocus(i));\n\n    for (const item of this.collapsibleTargets) item.hidden = collapsed;\n    if (this.hasEllipsisTarget) this.#applyEllipsisVisibility(showEllipsis);\n    if (this.hasTriggerTarget) {\n      // Never report expanded while the trail fits: the trigger is hidden then.\n      const expanded = this.#overflowing && this.#expanded;\n      this.triggerTarget.setAttribute(\"aria-expanded\", expanded ? \"true\" : \"false\");\n    }\n    if (rescueFocus) this.triggerTarget.focus();\n  }\n\n  /**\n   * Shows or hides the ellipsis item, deferring a hide that would blur the user.\n   *\n   * Hiding the element that currently holds focus drops focus to `<body>`, so the\n   * hide waits for that element's `blur` and is re-applied then (the shared\n   * `BlurDeferral` registry).\n   */\n  #applyEllipsisVisibility(show: boolean): void {\n    const ellipsis = this.ellipsisTarget;\n    if (show) {\n      this.#deferredHide.releaseAll();\n      ellipsis.hidden = false;\n      return;\n    }\n\n    const active = document.activeElement;\n    if (active instanceof HTMLElement && ellipsis.contains(active)) {\n      ellipsis.hidden = false;\n      this.#deferredHide.deferOnly(active);\n      return;\n    }\n\n    this.#deferredHide.releaseAll();\n    ellipsis.hidden = true;\n  }\n\n  /** Whether `element` contains (or is) the currently focused element. */\n  #holdsFocus(element: HTMLElement): boolean {\n    const active = document.activeElement;\n    return active instanceof HTMLElement && element.contains(active);\n  }\n}\n"]}

package/dist/controllers/carousel_controller.js

@@ -271,7 +271,11 @@ var CarouselController = class extends Controller {
     this.#syncTimer();
     if (changed) this.dispatch("change", { detail: { index, total: this.slideTargets.length } });
   }
-  /** Reflects `this.#index` onto slides and pickers (state hooks + roving). */
+  /**
+   * Reflects `this.#index` onto slides and pickers (state hooks + roving).
+   *
+   * @stimeoRenderRoot
+   */
   #render({ focus }) {
     this.slideTargets.forEach((slide, i) => {
       const active = i === this.#index;