stimeo-ui 0.3.0 → 0.5.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;

package/dist/controllers/carousel_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/logical_scroll.ts","../../src/utils/arrow_step.ts","../../src/utils/roving_tabindex.ts","../../src/utils/safe_timeout.ts","../../src/controllers/carousel_controller.ts"],"names":[],"mappings":"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","file":"carousel_controller.js","sourcesContent":["/** Normalized scroll position and maximum distance on one logical axis. */\nexport interface LogicalScrollMetrics {\n  position: number;\n  max: number;\n}\n\n/**\n * Whether horizontal scrolling on `element` follows right-to-left inline flow.\n *\n * Resolved from the **computed** `direction`, so the authoring contract is the\n * usual `dir=\"rtl\"` (or a stylesheet) on the element or any ancestor.\n *\n * Scope: horizontal writing modes. A vertical writing mode (`writing-mode:\n * vertical-rl`) also inverts the horizontal axis, which this check does not\n * model — vertical writing modes are out of scope for the scroll utilities\n * (their consumers describe axes as horizontal/vertical, not inline/block).\n */\nexport function isRtl(element: Element): boolean {\n  return window.getComputedStyle(element).direction === \"rtl\";\n}\n\n/**\n * Returns scroll distance from the logical start edge.\n *\n * CSSOM View exposes standards-mode RTL horizontal offsets as `0` at the inline\n * start (right) and increasingly negative values toward the inline end (left).\n * The normalized position is always clamped to `[0, max]`, which also absorbs\n * Safari's elastic overscroll values.\n */\nexport function logicalScrollMetrics(\n  element: HTMLElement,\n  horizontal: boolean,\n): LogicalScrollMetrics {\n  const max = Math.max(\n    0,\n    horizontal\n      ? element.scrollWidth - element.clientWidth\n      : element.scrollHeight - element.clientHeight,\n  );\n  const raw = horizontal ? element.scrollLeft : element.scrollTop;\n  const position = horizontal && isRtl(element) ? -raw : raw;\n  return { position: Math.min(max, Math.max(0, position)), max };\n}\n\n/**\n * Converts a logical start/end delta to the physical value accepted by\n * `Element.scrollBy`.\n */\nexport function physicalScrollDelta(\n  element: HTMLElement,\n  horizontal: boolean,\n  logicalDelta: number,\n): number {\n  return horizontal && isRtl(element) ? -logicalDelta : logicalDelta;\n}\n","import { isRtl } from \"./logical_scroll\";\n\n/**\n * Turns an arrow key into a **logical** step: `+1` for \"next\", `-1` for\n * \"previous\", `0` when the key names neither.\n *\n * APG defines the horizontal pair as *next / previous* and says a vertical\n * arrangement swaps in Down/Up for the same meaning — so the pair is one axis's\n * spelling of an order, and the order reverses with the writing direction. Only\n * the horizontal pair reverses. Down/Up name an axis the writing direction does\n * not mirror, and returning them unchanged is the point: many controllers fold\n * both pairs into one branch, where swapping the branches under RTL would flip\n * the vertical axis too — a bug that reads as \"the arrows work\" until someone\n * presses Down.\n *\n * **Direction is read from the element the caller passes, which should be the\n * container that lays the items out** — not the focused child. A child may carry\n * its own `dir` (an LTR input inside an RTL form is ordinary authoring), and\n * probing per handler makes two handlers disagree at the boundary between them.\n *\n * This decides direction only. Whether the axis is even active (an\n * `orientation=\"horizontal\"` widget ignoring Down/Up), how far the step lands,\n * and what wrapping does all stay with the caller.\n *\n * **It encodes the list-order convention: `ArrowDown` is *next*.** Widgets that\n * pair the arrows by *value* instead — `ArrowUp` meaning \"more\", as a rating or a\n * slider does — must not use this, or their vertical axis inverts. Reverse the\n * horizontal pair on its own there.\n *\n * @example\n * ```ts\n * const step = logicalArrowStep(event.key, this.element);\n * if (step === 0) return;\n * this.#roving.setActive(rovingMove(current, length, step, \"wrap\"), { focus: true });\n * ```\n */\nexport function logicalArrowStep(key: string, element: Element): 1 | -1 | 0 {\n  if (key === \"ArrowDown\") return 1;\n  if (key === \"ArrowUp\") return -1;\n  if (key !== \"ArrowRight\" && key !== \"ArrowLeft\") return 0;\n  const forward = isRtl(element) ? \"ArrowLeft\" : \"ArrowRight\";\n  return key === forward ? 1 : -1;\n}\n\n/**\n * Rewrites `key` so an existing LTR-shaped branch keeps working under RTL:\n * `ArrowRight` and `ArrowLeft` trade places, everything else passes through.\n *\n * The alternative — negating a delta — silently breaks handlers whose two\n * horizontal branches are **not mirror images**. A grid that clamps one edge but\n * not the other, or a segmented field guarding `index > 0` on one side and\n * `index < length - 1` on the other, ends up applying the wrong guard to the\n * wrong direction. Swapping the key leaves each branch, guards and all, exactly\n * where its author put it.\n *\n * Same rule as {@link logicalArrowStep} about which element to read: pass the\n * container that lays the items out, not the focused child.\n *\n * @example\n * ```ts\n * switch (logicalArrowKey(event.key, this.element)) {\n *   case \"ArrowLeft\": // \"previous\" — whatever direction that is on screen\n * ```\n */\nexport function logicalArrowKey(key: string, element: Element): string {\n  if (key !== \"ArrowRight\" && key !== \"ArrowLeft\") return key;\n  if (!isRtl(element)) return key;\n  return key === \"ArrowRight\" ? \"ArrowLeft\" : \"ArrowRight\";\n}\n\n/** Modifiers a widget may claim on an arrow key, named for the `allow` list. */\nexport type ArrowModifier = \"alt\" | \"ctrl\" | \"meta\" | \"shift\";\n\n/**\n * True when an arrow key arrived carrying a modifier the widget must leave to\n * the browser: return without calling `preventDefault()` and without moving any\n * state.\n *\n * A bare arrow belongs to the widget; a chorded one usually does not.\n * `Alt`/`Meta` plus a horizontal arrow is history back/forward on every desktop\n * browser, and a widget that swallows it makes the shortcut work or not\n * depending on where focus happens to sit — a coin-flip the user cannot see.\n *\n * `allow` is for the combinations APG assigns to a pattern **and the widget\n * actually implements** — today only Combobox's optional `Alt+Down`/`Alt+Up`.\n * Listing one the widget does not implement defeats the point: the chord then\n * runs the plain-arrow branch, which is exactly what this guard exists to stop.\n * Non-arrow keys return `false`, so chorded letters and\n * `Control+Home`/`Control+End` are untouched.\n *\n * @example\n * ```ts\n * if (isReservedArrowChord(event)) return;\n * ```\n */\nexport function isReservedArrowChord(\n  event: KeyboardEvent,\n  allow: readonly ArrowModifier[] = [],\n): boolean {\n  if (!event.key.startsWith(\"Arrow\")) return false;\n  return (\n    (event.altKey && !allow.includes(\"alt\")) ||\n    (event.ctrlKey && !allow.includes(\"ctrl\")) ||\n    (event.metaKey && !allow.includes(\"meta\")) ||\n    (event.shiftKey && !allow.includes(\"shift\"))\n  );\n}\n","/**\n * Low-level roving-tabindex primitive shared by composite-widget controllers.\n *\n * The APG roving-tabindex pattern keeps a composite widget a single Tab stop:\n * exactly one item is in the Tab sequence (`tabindex=\"0\"`) while the rest are\n * removed from it (`tabindex=\"-1\"`), and the arrow keys move both DOM focus and\n * that single tabbable position together. {@link RovingTabindex} owns *only* that\n * mechanical bookkeeping — \"which one item is tabbable, and move focus there\".\n *\n * It is intentionally **policy-free**. Orientation, wrapping vs. clamping,\n * selection-follows-focus, typeahead, and `Home`/`End` semantics differ per APG\n * pattern (Radio Group, Toolbar, Rating, …); folding them into one helper would\n * flatten those widgets to a lowest common denominator and lose each pattern's\n * correctness. Those decisions therefore stay in each controller, which calls\n * {@link RovingTabindex.setActive} with an index it computed itself (optionally\n * via the pure {@link rovingMove} helper).\n *\n * @remarks\n * Items are read lazily through a getter so a controller can add or remove\n * targets (Stimulus re-scans the DOM) without re-wiring this helper.\n */\nexport class RovingTabindex {\n  /** Returns the current ordered item elements; called on every operation. */\n  readonly #getItems: () => HTMLElement[];\n\n  /**\n   * @param getItems - Returns the current ordered item elements. Called on every\n   *   operation so the live target list is always used.\n   */\n  constructor(getItems: () => HTMLElement[]) {\n    this.#getItems = getItems;\n  }\n\n  /** Index of the currently tabbable item (`tabindex=\"0\"`), or `-1` if none. */\n  get activeIndex(): number {\n    return this.#getItems().findIndex((item) => item.tabIndex === 0);\n  }\n\n  /**\n   * Makes exactly the item at `index` tabbable (`tabindex=\"0\"`) and removes every\n   * other item from the Tab sequence (`tabindex=\"-1\"`). An out-of-range `index`\n   * (e.g. `-1`) leaves all items at `-1`, which a controller can use to express\n   * \"nothing is currently tabbable\".\n   *\n   * @param index - Position of the item to make tabbable.\n   * @param options - Pass `{ focus: true }` to also move DOM focus to that item.\n   */\n  setActive(index: number, { focus = false }: { focus?: boolean } = {}): void {\n    const items = this.#getItems();\n    items.forEach((item, i) => {\n      item.tabIndex = i === index ? 0 : -1;\n    });\n    if (focus) items[index]?.focus();\n  }\n}\n\n/** Edge behavior for {@link rovingMove}: cycle past the ends, or stop at them. */\nexport type RovingWrap = \"wrap\" | \"clamp\";\n\n/**\n * Pure helper that resolves the target index for a one-step directional move.\n *\n * Keyboard/orientation mapping stays in the caller: it decides that a key means\n * `delta` `+1` (next) or `-1` (previous) and whether the widget should `\"wrap\"`\n * (Radio Group, Toolbar) or `\"clamp\"` at the ends.\n *\n * @param current - The index focus is moving from.\n * @param length - Number of items in the set.\n * @param delta - `+1` to move to the next item, `-1` for the previous.\n * @param wrap - `\"wrap\"` cycles around the ends; `\"clamp\"` stops at them.\n * @returns The resolved index, or `-1` when there are no items.\n */\nexport function rovingMove(\n  current: number,\n  length: number,\n  delta: number,\n  wrap: RovingWrap,\n): number {\n  if (length === 0) return -1;\n  const next = current + delta;\n  if (wrap === \"wrap\") return (next + length) % length;\n  return Math.min(length - 1, Math.max(0, next));\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 { isReservedArrowChord, logicalArrowStep } from \"../utils/arrow_step\";\nimport { RovingTabindex, rovingMove } from \"../utils/roving_tabindex\";\nimport { SafeInterval } from \"../utils/safe_timeout\";\n\n/**\n * Headless, accessible **Carousel** (slideshow) behavior.\n *\n * Markup contract (identifier: `stimeo--carousel`):\n *   <section data-controller=\"stimeo--carousel\" aria-roledescription=\"carousel\"\n *            aria-label=\"Featured\"\n *            data-stimeo--carousel-autoplay-value=\"false\"\n *            data-stimeo--carousel-interval-value=\"5000\"\n *            data-stimeo--carousel-loop-value=\"true\"\n *            data-action=\"mouseenter->stimeo--carousel#pause\n *                         mouseleave->stimeo--carousel#resume\n *                         focusin->stimeo--carousel#pause\n *                         focusout->stimeo--carousel#resume\">\n *     <button data-stimeo--carousel-target=\"playToggle\"\n *             data-action=\"stimeo--carousel#togglePlay\">…</button>\n *     <div data-stimeo--carousel-target=\"viewport\">\n *       <div role=\"tabpanel\" data-stimeo--carousel-target=\"slide\">…</div>\n *       <div role=\"tabpanel\" data-stimeo--carousel-target=\"slide\" hidden>…</div>\n *     </div>\n *     <button data-stimeo--carousel-target=\"prev\" data-action=\"stimeo--carousel#prev\">‹</button>\n *     <button data-stimeo--carousel-target=\"next\" data-action=\"stimeo--carousel#next\">›</button>\n *     <div role=\"tablist\">\n *       <button role=\"tab\" data-stimeo--carousel-target=\"picker\"\n *               data-action=\"stimeo--carousel#goto\n *                            keydown->stimeo--carousel#onPickerKeydown\"></button>\n *     </div>\n *   </section>\n *\n * Implements the WAI-ARIA APG **Carousel** (tabbed) pattern. The current slide is\n * exposed through `data-state` (`active`/`inactive`) and the `hidden` attribute on\n * inactive slides (removing them from focus order); the matching picker carries\n * `aria-selected` and the single roving `tabindex`. The play/pause toggle's\n * `aria-pressed` mirrors the autoplay state.\n *\n * @remarks\n * Behavior only — transitions, layout, and visuals are the consumer's CSS.\n * Autoplay honors WCAG 2.2.2: it suspends while the pointer is over the carousel\n * and **hard-stops** when keyboard focus enters (it does not silently resume on\n * focus out — the user must press play), so motion never surprises a keyboard\n * user. The interval is cleared on `disconnect()` (Turbo navigation included).\n * Picker arrow keys move focus only (manual activation); slide changes never steal\n * focus from the control the user operated.\n */\nexport class CarouselController extends Controller<HTMLElement> {\n  static override targets = [\"slide\", \"viewport\", \"prev\", \"next\", \"picker\", \"playToggle\"];\n  static override values = {\n    autoplay: { type: Boolean, default: false },\n    interval: { type: Number, default: 5000 },\n    loop: { type: Boolean, default: true },\n  };\n  static actions = [\n    \"goto\",\n    \"next\",\n    \"onPickerKeydown\",\n    \"pause\",\n    \"prev\",\n    \"resume\",\n    \"togglePlay\",\n  ] as const;\n  static events = [\"change\", \"pause\", \"play\"] as const;\n\n  declare readonly slideTargets: HTMLElement[];\n  declare readonly pickerTargets: HTMLElement[];\n  declare readonly playToggleTarget: HTMLElement;\n  declare readonly hasPlayToggleTarget: boolean;\n  declare autoplayValue: boolean;\n  declare intervalValue: number;\n  declare loopValue: boolean;\n\n  readonly #roving = new RovingTabindex(() => this.pickerTargets);\n  /** Gates the target callback so it does not repaint once per authored picker on mount. */\n  #connected = false;\n  readonly #intervals = new SafeInterval();\n  /** Index of the visible slide. */\n  #index = 0;\n  /** User intent to autoplay (toggled by the play button / focus hard-stop). */\n  #playing = false;\n  /** Pointer is hovering the carousel: a temporary, auto-resuming suspension. */\n  #pointerPaused = false;\n  /** Id of the live autoplay interval, or null when stopped. */\n  #timerId: number | null = null;\n\n  /**\n   * Renders the initial slide and starts autoplay when requested.\n   *\n   * `findIndex` makes the authored pre-selection first-wins when several pickers\n   * are marked; `#render` then writes an explicit value onto every picker.\n   */\n  override connect(): void {\n    const preselected = this.pickerTargets.findIndex(\n      (picker) => picker.getAttribute(\"aria-selected\") === \"true\",\n    );\n    this.#index = preselected === -1 ? 0 : preselected;\n    this.#playing = this.#initialPlaying();\n    this.#render({ focus: false });\n    this.#syncTimer();\n    this.#connected = true;\n  }\n\n  /**\n   * Re-establishes the single selected picker when one is added after connect.\n   *\n   * Without this an appended picker that arrives `aria-selected=\"true\"` leaves two\n   * marked at once — the authored pre-selection is only read on connect, so\n   * nothing else ever resolves the conflict. The current slide is kept: the\n   * repaint re-derives every picker from `#index`, so a late arrival never steals\n   * the selection.\n   */\n  pickerTargetConnected(): void {\n    if (!this.#connected) return;\n    this.#render({ focus: false });\n  }\n\n  /**\n   * Resolves the starting autoplay intent. The play toggle's `aria-pressed` is the\n   * source of truth **when present**, so a Turbo Drive cache restore / morph that\n   * re-runs `connect()` against existing DOM does not silently resume autoplay the\n   * user had stopped (e.g. by focusing into the carousel). Only when no toggle\n   * carries `aria-pressed` does it fall back to the declarative `autoplay` value.\n   */\n  #initialPlaying(): boolean {\n    if (this.hasPlayToggleTarget && this.playToggleTarget.hasAttribute(\"aria-pressed\")) {\n      return this.playToggleTarget.getAttribute(\"aria-pressed\") === \"true\";\n    }\n    return this.autoplayValue;\n  }\n\n  /** Clears the autoplay interval so it never fires after teardown. */\n  override disconnect(): void {\n    this.#connected = false;\n    this.#intervals.clearAll();\n    this.#timerId = null;\n  }\n\n  /** Advances to the next slide. Bound via `data-action`. */\n  next(): void {\n    this.#select(this.#step(1), { focus: false });\n  }\n\n  /** Returns to the previous slide. Bound via `data-action`. */\n  prev(): void {\n    this.#select(this.#step(-1), { focus: false });\n  }\n\n  /** Jumps to the slide whose picker was activated (click / Enter / Space). */\n  goto(event: Event): void {\n    const target = event.currentTarget as HTMLElement;\n    const index = this.pickerTargets.indexOf(target);\n    if (index !== -1) this.#select(index, { focus: false });\n  }\n\n  /** Toggles autoplay on the user's explicit request and syncs the timer. */\n  togglePlay(): void {\n    this.#playing = !this.#playing;\n    this.#syncTimer();\n  }\n\n  /**\n   * Suspends autoplay. Hover (`mouseenter`) is a temporary suspension that resumes\n   * on leave; keyboard focus (`focusin`) is a hard stop that turns autoplay off so\n   * it cannot resume without an explicit play (WCAG 2.2.2).\n   */\n  pause(event?: Event): void {\n    if (event?.type.startsWith(\"focus\")) {\n      this.#playing = false;\n    } else {\n      this.#pointerPaused = true;\n    }\n    this.#syncTimer();\n  }\n\n  /**\n   * Lifts a hover suspension (`mouseleave`) and resumes autoplay if it is still\n   * on. A `focusout` does nothing here: the focus pause was a hard stop, so the\n   * user must press play to restart.\n   */\n  resume(event?: Event): void {\n    if (event?.type.startsWith(\"focus\")) return;\n    this.#pointerPaused = false;\n    this.#syncTimer();\n  }\n\n  /** Picker roving: arrows move focus only; Home/End activate first/last slide. */\n  onPickerKeydown(event: KeyboardEvent): void {\n    // A descendant widget that already claimed the key must not ALSO move the\n    // picker focus or change the slide — composition depends on this yield.\n    if (event.defaultPrevented) return;\n    if (isReservedArrowChord(event)) return;\n    const current = this.pickerTargets.indexOf(event.currentTarget as HTMLElement);\n    if (current === -1) return;\n\n    const length = this.pickerTargets.length;\n    // Logical, not physical. The helper reverses only the horizontal\n    // pair, so folding Down/Up into the same branch stays correct.\n    switch (event.key) {\n      case \"ArrowRight\":\n      case \"ArrowDown\":\n      case \"ArrowLeft\":\n      case \"ArrowUp\": {\n        event.preventDefault();\n        const step = logicalArrowStep(event.key, this.element);\n        this.#roving.setActive(rovingMove(current, length, step, \"wrap\"), { focus: true });\n        return;\n      }\n      case \"Home\":\n        event.preventDefault();\n        this.#select(0, { focus: true });\n        return;\n      case \"End\":\n        event.preventDefault();\n        this.#select(length - 1, { focus: true });\n        return;\n      default:\n    }\n  }\n\n  /** Resolves the index one step away from the current one, honoring `loop`. */\n  #step(delta: number): number {\n    const total = this.slideTargets.length;\n    if (total === 0) return 0;\n    const next = this.#index + delta;\n    if (this.loopValue) return (next + total) % total;\n    return Math.min(total - 1, Math.max(0, next));\n  }\n\n  /**\n   * Changes the active slide, updates state hooks, and emits `change` — but only\n   * when the index actually changes, so a `next`/`prev` clamped at the end (or an\n   * autoplay tick at a non-looping boundary) re-renders without a spurious event\n   * (matching the \"emit on real change\" policy of flash/masonry/bulk-select).\n   */\n  #select(index: number, { focus }: { focus: boolean }): void {\n    const changed = index !== this.#index;\n    this.#index = index;\n    this.#render({ focus });\n    // Re-evaluate autoplay after every move so reaching the non-looping end stops\n    // the timer (see `#syncTimer`); idempotent for moves that don't cross a boundary.\n    this.#syncTimer();\n    if (changed) this.dispatch(\"change\", { detail: { index, total: this.slideTargets.length } });\n  }\n\n  /** Reflects `this.#index` onto slides and pickers (state hooks + roving). */\n  #render({ focus }: { focus: boolean }): void {\n    this.slideTargets.forEach((slide, i) => {\n      const active = i === this.#index;\n      slide.setAttribute(\"data-state\", active ? \"active\" : \"inactive\");\n      slide.hidden = !active;\n    });\n    this.pickerTargets.forEach((picker, i) => {\n      picker.setAttribute(\"aria-selected\", i === this.#index ? \"true\" : \"false\");\n    });\n    this.#roving.setActive(this.#index, { focus });\n  }\n\n  /**\n   * Drives the autoplay interval toward the desired state. Autoplay should run\n   * only when the user wants it (`playing`), the pointer is not hovering, and more\n   * than one slide exists. Transitions emit `play`/`pause` and keep the toggle's\n   * `aria-pressed` in sync.\n   */\n  #syncTimer(): void {\n    // A non-looping carousel sitting on its last slide has nothing left to advance\n    // to, so autoplay turns itself off (a hard stop, like the focus pause): the\n    // timer is cleared, `aria-pressed` flips to false, and a manual step back will\n    // not silently restart it without an explicit play.\n    if (!this.loopValue && this.#index >= this.slideTargets.length - 1) {\n      this.#playing = false;\n    }\n    const shouldRun = this.#playing && !this.#pointerPaused && this.slideTargets.length > 1;\n\n    if (shouldRun && this.#timerId === null) {\n      this.#timerId = this.#intervals.set(() => this.next(), this.intervalValue);\n      this.dispatch(\"play\");\n    } else if (!shouldRun && this.#timerId !== null) {\n      this.#intervals.clear(this.#timerId);\n      this.#timerId = null;\n      this.dispatch(\"pause\");\n    }\n\n    if (this.hasPlayToggleTarget) {\n      this.playToggleTarget.setAttribute(\"aria-pressed\", this.#playing ? \"true\" : \"false\");\n    }\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/logical_scroll.ts","../../src/utils/arrow_step.ts","../../src/utils/roving_tabindex.ts","../../src/utils/safe_timeout.ts","../../src/controllers/carousel_controller.ts"],"names":[],"mappings":"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","file":"carousel_controller.js","sourcesContent":["/** Normalized scroll position and maximum distance on one logical axis. */\nexport interface LogicalScrollMetrics {\n  position: number;\n  max: number;\n}\n\n/**\n * Whether horizontal scrolling on `element` follows right-to-left inline flow.\n *\n * Resolved from the **computed** `direction`, so the authoring contract is the\n * usual `dir=\"rtl\"` (or a stylesheet) on the element or any ancestor.\n *\n * Scope: horizontal writing modes. A vertical writing mode (`writing-mode:\n * vertical-rl`) also inverts the horizontal axis, which this check does not\n * model — vertical writing modes are out of scope for the scroll utilities\n * (their consumers describe axes as horizontal/vertical, not inline/block).\n */\nexport function isRtl(element: Element): boolean {\n  return window.getComputedStyle(element).direction === \"rtl\";\n}\n\n/**\n * Returns scroll distance from the logical start edge.\n *\n * CSSOM View exposes standards-mode RTL horizontal offsets as `0` at the inline\n * start (right) and increasingly negative values toward the inline end (left).\n * The normalized position is always clamped to `[0, max]`, which also absorbs\n * Safari's elastic overscroll values.\n */\nexport function logicalScrollMetrics(\n  element: HTMLElement,\n  horizontal: boolean,\n): LogicalScrollMetrics {\n  const max = Math.max(\n    0,\n    horizontal\n      ? element.scrollWidth - element.clientWidth\n      : element.scrollHeight - element.clientHeight,\n  );\n  const raw = horizontal ? element.scrollLeft : element.scrollTop;\n  const position = horizontal && isRtl(element) ? -raw : raw;\n  return { position: Math.min(max, Math.max(0, position)), max };\n}\n\n/**\n * Converts a logical start/end delta to the physical value accepted by\n * `Element.scrollBy`.\n */\nexport function physicalScrollDelta(\n  element: HTMLElement,\n  horizontal: boolean,\n  logicalDelta: number,\n): number {\n  return horizontal && isRtl(element) ? -logicalDelta : logicalDelta;\n}\n","import { isRtl } from \"./logical_scroll\";\n\n/**\n * Turns an arrow key into a **logical** step: `+1` for \"next\", `-1` for\n * \"previous\", `0` when the key names neither.\n *\n * APG defines the horizontal pair as *next / previous* and says a vertical\n * arrangement swaps in Down/Up for the same meaning — so the pair is one axis's\n * spelling of an order, and the order reverses with the writing direction. Only\n * the horizontal pair reverses. Down/Up name an axis the writing direction does\n * not mirror, and returning them unchanged is the point: many controllers fold\n * both pairs into one branch, where swapping the branches under RTL would flip\n * the vertical axis too — a bug that reads as \"the arrows work\" until someone\n * presses Down.\n *\n * **Direction is read from the element the caller passes, which should be the\n * container that lays the items out** — not the focused child. A child may carry\n * its own `dir` (an LTR input inside an RTL form is ordinary authoring), and\n * probing per handler makes two handlers disagree at the boundary between them.\n *\n * This decides direction only. Whether the axis is even active (an\n * `orientation=\"horizontal\"` widget ignoring Down/Up), how far the step lands,\n * and what wrapping does all stay with the caller.\n *\n * **It encodes the list-order convention: `ArrowDown` is *next*.** Widgets that\n * pair the arrows by *value* instead — `ArrowUp` meaning \"more\", as a rating or a\n * slider does — must not use this, or their vertical axis inverts. Reverse the\n * horizontal pair on its own there.\n *\n * @example\n * ```ts\n * const step = logicalArrowStep(event.key, this.element);\n * if (step === 0) return;\n * this.#roving.setActive(rovingMove(current, length, step, \"wrap\"), { focus: true });\n * ```\n */\nexport function logicalArrowStep(key: string, element: Element): 1 | -1 | 0 {\n  if (key === \"ArrowDown\") return 1;\n  if (key === \"ArrowUp\") return -1;\n  if (key !== \"ArrowRight\" && key !== \"ArrowLeft\") return 0;\n  const forward = isRtl(element) ? \"ArrowLeft\" : \"ArrowRight\";\n  return key === forward ? 1 : -1;\n}\n\n/**\n * Rewrites `key` so an existing LTR-shaped branch keeps working under RTL:\n * `ArrowRight` and `ArrowLeft` trade places, everything else passes through.\n *\n * The alternative — negating a delta — silently breaks handlers whose two\n * horizontal branches are **not mirror images**. A grid that clamps one edge but\n * not the other, or a segmented field guarding `index > 0` on one side and\n * `index < length - 1` on the other, ends up applying the wrong guard to the\n * wrong direction. Swapping the key leaves each branch, guards and all, exactly\n * where its author put it.\n *\n * Same rule as {@link logicalArrowStep} about which element to read: pass the\n * container that lays the items out, not the focused child.\n *\n * @example\n * ```ts\n * switch (logicalArrowKey(event.key, this.element)) {\n *   case \"ArrowLeft\": // \"previous\" — whatever direction that is on screen\n * ```\n */\nexport function logicalArrowKey(key: string, element: Element): string {\n  if (key !== \"ArrowRight\" && key !== \"ArrowLeft\") return key;\n  if (!isRtl(element)) return key;\n  return key === \"ArrowRight\" ? \"ArrowLeft\" : \"ArrowRight\";\n}\n\n/** Modifiers a widget may claim on an arrow key, named for the `allow` list. */\nexport type ArrowModifier = \"alt\" | \"ctrl\" | \"meta\" | \"shift\";\n\n/**\n * True when an arrow key arrived carrying a modifier the widget must leave to\n * the browser: return without calling `preventDefault()` and without moving any\n * state.\n *\n * A bare arrow belongs to the widget; a chorded one usually does not.\n * `Alt`/`Meta` plus a horizontal arrow is history back/forward on every desktop\n * browser, and a widget that swallows it makes the shortcut work or not\n * depending on where focus happens to sit — a coin-flip the user cannot see.\n *\n * `allow` is for the combinations APG assigns to a pattern **and the widget\n * actually implements** — today only Combobox's optional `Alt+Down`/`Alt+Up`.\n * Listing one the widget does not implement defeats the point: the chord then\n * runs the plain-arrow branch, which is exactly what this guard exists to stop.\n * Non-arrow keys return `false`, so chorded letters and\n * `Control+Home`/`Control+End` are untouched.\n *\n * @example\n * ```ts\n * if (isReservedArrowChord(event)) return;\n * ```\n */\nexport function isReservedArrowChord(\n  event: KeyboardEvent,\n  allow: readonly ArrowModifier[] = [],\n): boolean {\n  if (!event.key.startsWith(\"Arrow\")) return false;\n  return (\n    (event.altKey && !allow.includes(\"alt\")) ||\n    (event.ctrlKey && !allow.includes(\"ctrl\")) ||\n    (event.metaKey && !allow.includes(\"meta\")) ||\n    (event.shiftKey && !allow.includes(\"shift\"))\n  );\n}\n","/**\n * Low-level roving-tabindex primitive shared by composite-widget controllers.\n *\n * The APG roving-tabindex pattern keeps a composite widget a single Tab stop:\n * exactly one item is in the Tab sequence (`tabindex=\"0\"`) while the rest are\n * removed from it (`tabindex=\"-1\"`), and the arrow keys move both DOM focus and\n * that single tabbable position together. {@link RovingTabindex} owns *only* that\n * mechanical bookkeeping — \"which one item is tabbable, and move focus there\".\n *\n * It is intentionally **policy-free**. Orientation, wrapping vs. clamping,\n * selection-follows-focus, typeahead, and `Home`/`End` semantics differ per APG\n * pattern (Radio Group, Toolbar, Rating, …); folding them into one helper would\n * flatten those widgets to a lowest common denominator and lose each pattern's\n * correctness. Those decisions therefore stay in each controller, which calls\n * {@link RovingTabindex.setActive} with an index it computed itself (optionally\n * via the pure {@link rovingMove} helper).\n *\n * @remarks\n * Items are read lazily through a getter so a controller can add or remove\n * targets (Stimulus re-scans the DOM) without re-wiring this helper.\n */\nexport class RovingTabindex {\n  /** Returns the current ordered item elements; called on every operation. */\n  readonly #getItems: () => HTMLElement[];\n\n  /**\n   * @param getItems - Returns the current ordered item elements. Called on every\n   *   operation so the live target list is always used.\n   */\n  constructor(getItems: () => HTMLElement[]) {\n    this.#getItems = getItems;\n  }\n\n  /** Index of the currently tabbable item (`tabindex=\"0\"`), or `-1` if none. */\n  get activeIndex(): number {\n    return this.#getItems().findIndex((item) => item.tabIndex === 0);\n  }\n\n  /**\n   * Makes exactly the item at `index` tabbable (`tabindex=\"0\"`) and removes every\n   * other item from the Tab sequence (`tabindex=\"-1\"`). An out-of-range `index`\n   * (e.g. `-1`) leaves all items at `-1`, which a controller can use to express\n   * \"nothing is currently tabbable\".\n   *\n   * @param index - Position of the item to make tabbable.\n   * @param options - Pass `{ focus: true }` to also move DOM focus to that item.\n   */\n  setActive(index: number, { focus = false }: { focus?: boolean } = {}): void {\n    const items = this.#getItems();\n    items.forEach((item, i) => {\n      item.tabIndex = i === index ? 0 : -1;\n    });\n    if (focus) items[index]?.focus();\n  }\n}\n\n/** Edge behavior for {@link rovingMove}: cycle past the ends, or stop at them. */\nexport type RovingWrap = \"wrap\" | \"clamp\";\n\n/**\n * Pure helper that resolves the target index for a one-step directional move.\n *\n * Keyboard/orientation mapping stays in the caller: it decides that a key means\n * `delta` `+1` (next) or `-1` (previous) and whether the widget should `\"wrap\"`\n * (Radio Group, Toolbar) or `\"clamp\"` at the ends.\n *\n * @param current - The index focus is moving from.\n * @param length - Number of items in the set.\n * @param delta - `+1` to move to the next item, `-1` for the previous.\n * @param wrap - `\"wrap\"` cycles around the ends; `\"clamp\"` stops at them.\n * @returns The resolved index, or `-1` when there are no items.\n */\nexport function rovingMove(\n  current: number,\n  length: number,\n  delta: number,\n  wrap: RovingWrap,\n): number {\n  if (length === 0) return -1;\n  const next = current + delta;\n  if (wrap === \"wrap\") return (next + length) % length;\n  return Math.min(length - 1, Math.max(0, next));\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 { isReservedArrowChord, logicalArrowStep } from \"../utils/arrow_step\";\nimport { RovingTabindex, rovingMove } from \"../utils/roving_tabindex\";\nimport { SafeInterval } from \"../utils/safe_timeout\";\n\n/**\n * Headless, accessible **Carousel** (slideshow) behavior.\n *\n * Markup contract (identifier: `stimeo--carousel`):\n *   <section data-controller=\"stimeo--carousel\" aria-roledescription=\"carousel\"\n *            aria-label=\"Featured\"\n *            data-stimeo--carousel-autoplay-value=\"false\"\n *            data-stimeo--carousel-interval-value=\"5000\"\n *            data-stimeo--carousel-loop-value=\"true\"\n *            data-action=\"mouseenter->stimeo--carousel#pause\n *                         mouseleave->stimeo--carousel#resume\n *                         focusin->stimeo--carousel#pause\n *                         focusout->stimeo--carousel#resume\">\n *     <button data-stimeo--carousel-target=\"playToggle\"\n *             data-action=\"stimeo--carousel#togglePlay\">…</button>\n *     <div data-stimeo--carousel-target=\"viewport\">\n *       <div role=\"tabpanel\" data-stimeo--carousel-target=\"slide\">…</div>\n *       <div role=\"tabpanel\" data-stimeo--carousel-target=\"slide\" hidden>…</div>\n *     </div>\n *     <button data-stimeo--carousel-target=\"prev\" data-action=\"stimeo--carousel#prev\">‹</button>\n *     <button data-stimeo--carousel-target=\"next\" data-action=\"stimeo--carousel#next\">›</button>\n *     <div role=\"tablist\">\n *       <button role=\"tab\" data-stimeo--carousel-target=\"picker\"\n *               data-action=\"stimeo--carousel#goto\n *                            keydown->stimeo--carousel#onPickerKeydown\"></button>\n *     </div>\n *   </section>\n *\n * Implements the WAI-ARIA APG **Carousel** (tabbed) pattern. The current slide is\n * exposed through `data-state` (`active`/`inactive`) and the `hidden` attribute on\n * inactive slides (removing them from focus order); the matching picker carries\n * `aria-selected` and the single roving `tabindex`. The play/pause toggle's\n * `aria-pressed` mirrors the autoplay state.\n *\n * @remarks\n * Behavior only — transitions, layout, and visuals are the consumer's CSS.\n * Autoplay honors WCAG 2.2.2: it suspends while the pointer is over the carousel\n * and **hard-stops** when keyboard focus enters (it does not silently resume on\n * focus out — the user must press play), so motion never surprises a keyboard\n * user. The interval is cleared on `disconnect()` (Turbo navigation included).\n * Picker arrow keys move focus only (manual activation); slide changes never steal\n * focus from the control the user operated.\n */\nexport class CarouselController extends Controller<HTMLElement> {\n  static override targets = [\"slide\", \"viewport\", \"prev\", \"next\", \"picker\", \"playToggle\"];\n  static override values = {\n    autoplay: { type: Boolean, default: false },\n    interval: { type: Number, default: 5000 },\n    loop: { type: Boolean, default: true },\n  };\n  static actions = [\n    \"goto\",\n    \"next\",\n    \"onPickerKeydown\",\n    \"pause\",\n    \"prev\",\n    \"resume\",\n    \"togglePlay\",\n  ] as const;\n  static events = [\"change\", \"pause\", \"play\"] as const;\n\n  declare readonly slideTargets: HTMLElement[];\n  declare readonly pickerTargets: HTMLElement[];\n  declare readonly playToggleTarget: HTMLElement;\n  declare readonly hasPlayToggleTarget: boolean;\n  declare autoplayValue: boolean;\n  declare intervalValue: number;\n  declare loopValue: boolean;\n\n  readonly #roving = new RovingTabindex(() => this.pickerTargets);\n  /** Gates the target callback so it does not repaint once per authored picker on mount. */\n  #connected = false;\n  readonly #intervals = new SafeInterval();\n  /** Index of the visible slide. */\n  #index = 0;\n  /** User intent to autoplay (toggled by the play button / focus hard-stop). */\n  #playing = false;\n  /** Pointer is hovering the carousel: a temporary, auto-resuming suspension. */\n  #pointerPaused = false;\n  /** Id of the live autoplay interval, or null when stopped. */\n  #timerId: number | null = null;\n\n  /**\n   * Renders the initial slide and starts autoplay when requested.\n   *\n   * `findIndex` makes the authored pre-selection first-wins when several pickers\n   * are marked; `#render` then writes an explicit value onto every picker.\n   */\n  override connect(): void {\n    const preselected = this.pickerTargets.findIndex(\n      (picker) => picker.getAttribute(\"aria-selected\") === \"true\",\n    );\n    this.#index = preselected === -1 ? 0 : preselected;\n    this.#playing = this.#initialPlaying();\n    this.#render({ focus: false });\n    this.#syncTimer();\n    this.#connected = true;\n  }\n\n  /**\n   * Re-establishes the single selected picker when one is added after connect.\n   *\n   * Without this an appended picker that arrives `aria-selected=\"true\"` leaves two\n   * marked at once — the authored pre-selection is only read on connect, so\n   * nothing else ever resolves the conflict. The current slide is kept: the\n   * repaint re-derives every picker from `#index`, so a late arrival never steals\n   * the selection.\n   */\n  pickerTargetConnected(): void {\n    if (!this.#connected) return;\n    this.#render({ focus: false });\n  }\n\n  /**\n   * Resolves the starting autoplay intent. The play toggle's `aria-pressed` is the\n   * source of truth **when present**, so a Turbo Drive cache restore / morph that\n   * re-runs `connect()` against existing DOM does not silently resume autoplay the\n   * user had stopped (e.g. by focusing into the carousel). Only when no toggle\n   * carries `aria-pressed` does it fall back to the declarative `autoplay` value.\n   */\n  #initialPlaying(): boolean {\n    if (this.hasPlayToggleTarget && this.playToggleTarget.hasAttribute(\"aria-pressed\")) {\n      return this.playToggleTarget.getAttribute(\"aria-pressed\") === \"true\";\n    }\n    return this.autoplayValue;\n  }\n\n  /** Clears the autoplay interval so it never fires after teardown. */\n  override disconnect(): void {\n    this.#connected = false;\n    this.#intervals.clearAll();\n    this.#timerId = null;\n  }\n\n  /** Advances to the next slide. Bound via `data-action`. */\n  next(): void {\n    this.#select(this.#step(1), { focus: false });\n  }\n\n  /** Returns to the previous slide. Bound via `data-action`. */\n  prev(): void {\n    this.#select(this.#step(-1), { focus: false });\n  }\n\n  /** Jumps to the slide whose picker was activated (click / Enter / Space). */\n  goto(event: Event): void {\n    const target = event.currentTarget as HTMLElement;\n    const index = this.pickerTargets.indexOf(target);\n    if (index !== -1) this.#select(index, { focus: false });\n  }\n\n  /** Toggles autoplay on the user's explicit request and syncs the timer. */\n  togglePlay(): void {\n    this.#playing = !this.#playing;\n    this.#syncTimer();\n  }\n\n  /**\n   * Suspends autoplay. Hover (`mouseenter`) is a temporary suspension that resumes\n   * on leave; keyboard focus (`focusin`) is a hard stop that turns autoplay off so\n   * it cannot resume without an explicit play (WCAG 2.2.2).\n   */\n  pause(event?: Event): void {\n    if (event?.type.startsWith(\"focus\")) {\n      this.#playing = false;\n    } else {\n      this.#pointerPaused = true;\n    }\n    this.#syncTimer();\n  }\n\n  /**\n   * Lifts a hover suspension (`mouseleave`) and resumes autoplay if it is still\n   * on. A `focusout` does nothing here: the focus pause was a hard stop, so the\n   * user must press play to restart.\n   */\n  resume(event?: Event): void {\n    if (event?.type.startsWith(\"focus\")) return;\n    this.#pointerPaused = false;\n    this.#syncTimer();\n  }\n\n  /** Picker roving: arrows move focus only; Home/End activate first/last slide. */\n  onPickerKeydown(event: KeyboardEvent): void {\n    // A descendant widget that already claimed the key must not ALSO move the\n    // picker focus or change the slide — composition depends on this yield.\n    if (event.defaultPrevented) return;\n    if (isReservedArrowChord(event)) return;\n    const current = this.pickerTargets.indexOf(event.currentTarget as HTMLElement);\n    if (current === -1) return;\n\n    const length = this.pickerTargets.length;\n    // Logical, not physical. The helper reverses only the horizontal\n    // pair, so folding Down/Up into the same branch stays correct.\n    switch (event.key) {\n      case \"ArrowRight\":\n      case \"ArrowDown\":\n      case \"ArrowLeft\":\n      case \"ArrowUp\": {\n        event.preventDefault();\n        const step = logicalArrowStep(event.key, this.element);\n        this.#roving.setActive(rovingMove(current, length, step, \"wrap\"), { focus: true });\n        return;\n      }\n      case \"Home\":\n        event.preventDefault();\n        this.#select(0, { focus: true });\n        return;\n      case \"End\":\n        event.preventDefault();\n        this.#select(length - 1, { focus: true });\n        return;\n      default:\n    }\n  }\n\n  /** Resolves the index one step away from the current one, honoring `loop`. */\n  #step(delta: number): number {\n    const total = this.slideTargets.length;\n    if (total === 0) return 0;\n    const next = this.#index + delta;\n    if (this.loopValue) return (next + total) % total;\n    return Math.min(total - 1, Math.max(0, next));\n  }\n\n  /**\n   * Changes the active slide, updates state hooks, and emits `change` — but only\n   * when the index actually changes, so a `next`/`prev` clamped at the end (or an\n   * autoplay tick at a non-looping boundary) re-renders without a spurious event\n   * (matching the \"emit on real change\" policy of flash/masonry/bulk-select).\n   */\n  #select(index: number, { focus }: { focus: boolean }): void {\n    const changed = index !== this.#index;\n    this.#index = index;\n    this.#render({ focus });\n    // Re-evaluate autoplay after every move so reaching the non-looping end stops\n    // the timer (see `#syncTimer`); idempotent for moves that don't cross a boundary.\n    this.#syncTimer();\n    if (changed) this.dispatch(\"change\", { detail: { index, total: this.slideTargets.length } });\n  }\n\n  /**\n   * Reflects `this.#index` onto slides and pickers (state hooks + roving).\n   *\n   * @stimeoRenderRoot\n   */\n  #render({ focus }: { focus: boolean }): void {\n    this.slideTargets.forEach((slide, i) => {\n      const active = i === this.#index;\n      slide.setAttribute(\"data-state\", active ? \"active\" : \"inactive\");\n      slide.hidden = !active;\n    });\n    this.pickerTargets.forEach((picker, i) => {\n      picker.setAttribute(\"aria-selected\", i === this.#index ? \"true\" : \"false\");\n    });\n    this.#roving.setActive(this.#index, { focus });\n  }\n\n  /**\n   * Drives the autoplay interval toward the desired state. Autoplay should run\n   * only when the user wants it (`playing`), the pointer is not hovering, and more\n   * than one slide exists. Transitions emit `play`/`pause` and keep the toggle's\n   * `aria-pressed` in sync.\n   */\n  #syncTimer(): void {\n    // A non-looping carousel sitting on its last slide has nothing left to advance\n    // to, so autoplay turns itself off (a hard stop, like the focus pause): the\n    // timer is cleared, `aria-pressed` flips to false, and a manual step back will\n    // not silently restart it without an explicit play.\n    if (!this.loopValue && this.#index >= this.slideTargets.length - 1) {\n      this.#playing = false;\n    }\n    const shouldRun = this.#playing && !this.#pointerPaused && this.slideTargets.length > 1;\n\n    if (shouldRun && this.#timerId === null) {\n      this.#timerId = this.#intervals.set(() => this.next(), this.intervalValue);\n      this.dispatch(\"play\");\n    } else if (!shouldRun && this.#timerId !== null) {\n      this.#intervals.clear(this.#timerId);\n      this.#timerId = null;\n      this.dispatch(\"pause\");\n    }\n\n    if (this.hasPlayToggleTarget) {\n      this.playToggleTarget.setAttribute(\"aria-pressed\", this.#playing ? \"true\" : \"false\");\n    }\n  }\n}\n"]}

package/dist/controllers/clipboard_controller.js

@@ -2,6 +2,13 @@ import { Controller } from '@hotwired/stimulus';
 
 // src/controllers/clipboard_controller.ts
 
+// src/utils/default_attribute.ts
+function setDefaultAttribute(element, name, value) {
+  if (element.hasAttribute(name)) return false;
+  element.setAttribute(name, value);
+  return true;
+}
+
 // src/utils/safe_timeout.ts
 var TimerRegistry = class {
   /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */
@@ -75,9 +82,7 @@ var ClipboardController = class extends Controller {
    */
   #resetTimerId = null;
   connect() {
-    if (!this.element.hasAttribute("data-state")) {
-      this.element.setAttribute("data-state", "idle");
-    }
+    setDefaultAttribute(this.element, "data-state", "idle");
   }
   disconnect() {
     this.#timers.clearAll();

package/dist/controllers/clipboard_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/safe_timeout.ts","../../src/controllers/clipboard_controller.ts"],"names":[],"mappings":";;;;;AAwBA,IAAe,gBAAf,MAA6B;AAAA;AAAA,EAER,GAAA,uBAAU,GAAA,EAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAczC,MAAM,EAAA,EAAkB;AACtB,IAAA,IAAI,IAAA,CAAK,GAAA,CAAI,MAAA,CAAO,EAAE,CAAA,EAAG;AACvB,MAAA,IAAA,CAAK,OAAO,EAAE,CAAA;AAAA,IAChB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,QAAA,GAAiB;AACf,IAAA,KAAA,MAAW,EAAA,IAAM,KAAK,GAAA,EAAK;AACzB,MAAA,IAAA,CAAK,OAAO,EAAE,CAAA;AAAA,IAChB;AACA,IAAA,IAAA,CAAK,IAAI,KAAA,EAAM;AAAA,EACjB;AAAA;AAAA,EAGA,IAAI,IAAA,GAAe;AACjB,IAAA,OAAO,KAAK,GAAA,CAAI,IAAA;AAAA,EAClB;AACF,CAAA;AAmBO,IAAM,WAAA,GAAN,cAA0B,aAAA,CAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO7C,GAAA,CAAI,UAAsB,KAAA,EAAuB;AAC/C,IAAA,MAAM,EAAA,GAAK,IAAA,CAAK,QAAA,CAAS,MAAM;AAC7B,MAAA,IAAA,CAAK,GAAA,CAAI,OAAO,EAAE,CAAA;AAClB,MAAA,QAAA,EAAS;AAAA,IACX,GAAG,KAAK,CAAA;AACR,IAAA,IAAA,CAAK,GAAA,CAAI,IAAI,EAAE,CAAA;AACf,IAAA,OAAO,EAAA;AAAA,EACT;AAAA,EAEU,QAAA,CAAS,UAAsB,KAAA,EAAuB;AAC9D,IAAA,OAAO,MAAA,CAAO,UAAA,CAAW,QAAA,EAAU,KAAK,CAAA;AAAA,EAC1C;AAAA,EAEU,OAAO,EAAA,EAAkB;AACjC,IAAA,MAAA,CAAO,aAAa,EAAE,CAAA;AAAA,EACxB;AACF,CAAA;;;AC1EO,IAAM,mBAAA,GAAN,cAAkC,UAAA,CAAwB;AAAA,EAC/D,OAAgB,OAAA,GAAU,CAAC,QAAA,EAAU,UAAU,UAAU,CAAA;AAAA,EACzD,OAAgB,MAAA,GAAS;AAAA,IACvB,IAAA,EAAM,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAS,EAAA,EAAG;AAAA,IAClC,gBAAA,EAAkB,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAS,GAAA,EAAK;AAAA,IAChD,WAAA,EAAa,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAS,QAAA,EAAS;AAAA,IAC/C,UAAA,EAAY,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAS,aAAA;AAAc,GACrD;AAAA,EACA,OAAO,OAAA,GAAU,CAAC,MAAM,CAAA;AAAA,EACxB,OAAO,MAAA,GAAS,CAAC,MAAM,CAAA;AAAA;AAAA,EAevB,OAAA,GAAU,IAAI,WAAA,EAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO1B,aAAA,GAA+B,IAAA;AAAA,EAEtB,OAAA,GAAgB;AACvB,IAAA,IAAI,CAAC,IAAA,CAAK,OAAA,CAAQ,YAAA,CAAa,YAAY,CAAA,EAAG;AAC5C,MAAA,IAAA,CAAK,OAAA,CAAQ,YAAA,CAAa,YAAA,EAAc,MAAM,CAAA;AAAA,IAChD;AAAA,EACF;AAAA,EAES,UAAA,GAAmB;AAC1B,IAAA,IAAA,CAAK,QAAQ,QAAA,EAAS;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,IAAA,GAAsB;AAC1B,IAAA,MAAM,IAAA,GAAO,KAAK,YAAA,EAAa;AAC/B,IAAA,IAAI,OAAA,GAAU,KAAA;AACd,IAAA,IAAI;AACF,MAAA,IAAI,CAAC,SAAA,CAAU,SAAA,EAAW,WAAW,MAAM,IAAI,MAAM,2BAA2B,CAAA;AAChF,MAAA,MAAM,SAAA,CAAU,SAAA,CAAU,SAAA,CAAU,IAAI,CAAA;AACxC,MAAA,OAAA,GAAU,IAAA;AAAA,IACZ,CAAA,CAAA,MAAQ;AACN,MAAA,OAAA,GAAU,KAAA;AAAA,IACZ;AAEA,IAAA,IAAA,CAAK,cAAc,OAAO,CAAA;AAC1B,IAAA,IAAA,CAAK,QAAA,CAAS,QAAQ,EAAE,MAAA,EAAQ,EAAE,OAAA,EAAS,IAAA,IAAQ,CAAA;AAAA,EACrD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,YAAA,GAAuB;AACrB,IAAA,IAAI,IAAA,CAAK,SAAA,CAAU,MAAA,GAAS,CAAA,SAAU,IAAA,CAAK,SAAA;AAC3C,IAAA,IAAI,CAAC,IAAA,CAAK,eAAA,EAAiB,OAAO,EAAA;AAClC,IAAA,MAAM,SAAS,IAAA,CAAK,YAAA;AACpB,IAAA,IAAI,MAAA,YAAkB,gBAAA,IAAoB,MAAA,YAAkB,mBAAA,EAAqB;AAC/E,MAAA,OAAO,MAAA,CAAO,KAAA;AAAA,IAChB;AACA,IAAA,OAAO,OAAO,WAAA,IAAe,EAAA;AAAA,EAC/B;AAAA;AAAA,EAGA,cAAc,OAAA,EAAwB;AACpC,IAAA,IAAA,CAAK,OAAA,CAAQ,YAAA,CAAa,YAAA,EAAc,OAAA,GAAU,WAAW,OAAO,CAAA;AACpE,IAAA,IAAI,KAAK,iBAAA,EAAmB;AAC1B,MAAA,IAAA,CAAK,cAAA,CAAe,WAAA,GAAc,OAAA,GAAU,IAAA,CAAK,mBAAmB,IAAA,CAAK,eAAA;AAAA,IAC3E;AAIA,IAAA,IAAI,IAAA,CAAK,kBAAkB,IAAA,EAAM;AAC/B,MAAA,IAAA,CAAK,OAAA,CAAQ,KAAA,CAAM,IAAA,CAAK,aAAa,CAAA;AACrC,MAAA,IAAA,CAAK,aAAA,GAAgB,IAAA;AAAA,IACvB;AACA,IAAA,IAAI,IAAA,CAAK,wBAAwB,CAAA,EAAG;AAClC,MAAA,IAAA,CAAK,aAAA,GAAgB,IAAA,CAAK,OAAA,CAAQ,GAAA,CAAI,MAAM;AAC1C,QAAA,IAAA,CAAK,aAAA,GAAgB,IAAA;AACrB,QAAA,IAAA,CAAK,MAAA,EAAO;AAAA,MACd,CAAA,EAAG,KAAK,qBAAqB,CAAA;AAAA,IAC/B;AAAA,EACF;AAAA;AAAA,EAGA,MAAA,GAAe;AACb,IAAA,IAAA,CAAK,OAAA,CAAQ,YAAA,CAAa,YAAA,EAAc,MAAM,CAAA;AAC9C,IAAA,IAAI,KAAK,iBAAA,EAAmB;AAC1B,MAAA,IAAA,CAAK,eAAe,WAAA,GAAc,EAAA;AAAA,IACpC;AAAA,EACF;AACF","file":"clipboard_controller.js","sourcesContent":["/**\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 { SafeTimeout } from \"../utils/safe_timeout\";\n\n/**\n * Headless copy-to-clipboard behavior with a live-region completion notice.\n *\n * Markup contract (identifier: `stimeo--clipboard`):\n *   <div data-controller=\"stimeo--clipboard\"\n *        data-stimeo--clipboard-feedback-duration-value=\"2000\">\n *     <input type=\"text\" value=\"https://example.com\" readonly\n *            data-stimeo--clipboard-target=\"source\">\n *     <button type=\"button\" data-stimeo--clipboard-target=\"button\"\n *             data-action=\"stimeo--clipboard#copy\">Copy</button>\n *     <span role=\"status\" aria-live=\"polite\"\n *           data-stimeo--clipboard-target=\"feedback\"></span>\n *   </div>\n *\n * No dedicated APG pattern; this follows the Button + live-region practice. The\n * copy uses the standard `navigator.clipboard` API (no extra dependency); when\n * it is unavailable or rejects, the failure is surfaced rather than silently\n * swallowed, and never communicated by icon alone — the `role=\"status\"` region\n * carries text so screen readers announce the outcome.\n *\n * @remarks\n * Behavior only — icon swaps and styling are the consumer's, keyed off\n * `data-state` (`idle` / `copied` / `error`). The completion notice clears\n * itself after `feedbackDuration`; that timer is torn down on disconnect (Turbo)\n * via {@link SafeTimeout}.\n */\nexport class ClipboardController extends Controller<HTMLElement> {\n  static override targets = [\"source\", \"button\", \"feedback\"];\n  static override values = {\n    text: { type: String, default: \"\" },\n    feedbackDuration: { type: Number, default: 2000 },\n    copiedLabel: { type: String, default: \"Copied\" },\n    errorLabel: { type: String, default: \"Copy failed\" },\n  };\n  static actions = [\"copy\"] as const;\n  static events = [\"copy\"] as const;\n\n  declare readonly sourceTarget: HTMLElement;\n  declare readonly buttonTarget: HTMLElement;\n  declare readonly feedbackTarget: HTMLElement;\n  declare readonly hasSourceTarget: boolean;\n  declare readonly hasButtonTarget: boolean;\n  declare readonly hasFeedbackTarget: boolean;\n\n  declare textValue: string;\n  declare feedbackDurationValue: number;\n  declare copiedLabelValue: string;\n  declare errorLabelValue: string;\n\n  /** Auto-clear timer for the completion notice; torn down on disconnect. */\n  #timers = new SafeTimeout();\n\n  /**\n   * The pending auto-clear timer id, or `null` when none is scheduled. Tracked so\n   * a rapid second copy cancels the first window instead of letting a stale timer\n   * reset the freshly-shown notice early.\n   */\n  #resetTimerId: number | null = null;\n\n  override connect(): void {\n    if (!this.element.hasAttribute(\"data-state\")) {\n      this.element.setAttribute(\"data-state\", \"idle\");\n    }\n  }\n\n  override disconnect(): void {\n    this.#timers.clearAll();\n  }\n\n  /**\n   * Copies the resolved text and reports the outcome. Bound via `data-action`\n   * (click). Always dispatches `stimeo--clipboard:copy` with `{ success, text }`\n   * — including on failure — so consumers can react either way.\n   */\n  async copy(): Promise<void> {\n    const text = this.#resolveText();\n    let success = false;\n    try {\n      if (!navigator.clipboard?.writeText) throw new Error(\"Clipboard API unavailable\");\n      await navigator.clipboard.writeText(text);\n      success = true;\n    } catch {\n      success = false;\n    }\n\n    this.#reportResult(success);\n    this.dispatch(\"copy\", { detail: { success, text } });\n  }\n\n  /**\n   * The text to copy: the explicit `text` value when set, otherwise the source\n   * target's current value (inputs/textareas) or text content.\n   */\n  #resolveText(): string {\n    if (this.textValue.length > 0) return this.textValue;\n    if (!this.hasSourceTarget) return \"\";\n    const source = this.sourceTarget;\n    if (source instanceof HTMLInputElement || source instanceof HTMLTextAreaElement) {\n      return source.value;\n    }\n    return source.textContent ?? \"\";\n  }\n\n  /** Reflects the result on `data-state`, announces it, and schedules a reset. */\n  #reportResult(success: boolean): void {\n    this.element.setAttribute(\"data-state\", success ? \"copied\" : \"error\");\n    if (this.hasFeedbackTarget) {\n      this.feedbackTarget.textContent = success ? this.copiedLabelValue : this.errorLabelValue;\n    }\n\n    // Cancel any in-flight reset so consecutive copies restart the full window\n    // rather than having the earlier timer clear the new notice prematurely.\n    if (this.#resetTimerId !== null) {\n      this.#timers.clear(this.#resetTimerId);\n      this.#resetTimerId = null;\n    }\n    if (this.feedbackDurationValue > 0) {\n      this.#resetTimerId = this.#timers.set(() => {\n        this.#resetTimerId = null;\n        this.#reset();\n      }, this.feedbackDurationValue);\n    }\n  }\n\n  /** Returns to the idle state and clears the completion notice. */\n  #reset(): void {\n    this.element.setAttribute(\"data-state\", \"idle\");\n    if (this.hasFeedbackTarget) {\n      this.feedbackTarget.textContent = \"\";\n    }\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/default_attribute.ts","../../src/utils/safe_timeout.ts","../../src/controllers/clipboard_controller.ts"],"names":[],"mappings":"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","file":"clipboard_controller.js","sourcesContent":["/**\n * Adds an attribute default without displacing an authored value.\n *\n * Attribute presence — including an authored empty string — is the ownership\n * boundary. The return value lets a caller remember that it supplied the\n * default when that caller must later restore the authored state.\n *\n * @param element - Element that owns the attribute\n * @param name - Attribute name\n * @param value - Value to write only when the attribute is absent\n * @returns Whether this call added the attribute\n */\nexport function setDefaultAttribute(element: Element, name: string, value: string): boolean {\n  if (element.hasAttribute(name)) return false;\n  element.setAttribute(name, value);\n  return true;\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 { setDefaultAttribute } from \"../utils/default_attribute\";\nimport { SafeTimeout } from \"../utils/safe_timeout\";\n\n/**\n * Headless copy-to-clipboard behavior with a live-region completion notice.\n *\n * Markup contract (identifier: `stimeo--clipboard`):\n *   <div data-controller=\"stimeo--clipboard\"\n *        data-stimeo--clipboard-feedback-duration-value=\"2000\">\n *     <input type=\"text\" value=\"https://example.com\" readonly\n *            data-stimeo--clipboard-target=\"source\">\n *     <button type=\"button\" data-stimeo--clipboard-target=\"button\"\n *             data-action=\"stimeo--clipboard#copy\">Copy</button>\n *     <span role=\"status\" aria-live=\"polite\"\n *           data-stimeo--clipboard-target=\"feedback\"></span>\n *   </div>\n *\n * No dedicated APG pattern; this follows the Button + live-region practice. The\n * copy uses the standard `navigator.clipboard` API (no extra dependency); when\n * it is unavailable or rejects, the failure is surfaced rather than silently\n * swallowed, and never communicated by icon alone — the `role=\"status\"` region\n * carries text so screen readers announce the outcome.\n *\n * @remarks\n * Behavior only — icon swaps and styling are the consumer's, keyed off\n * `data-state` (`idle` / `copied` / `error`). The completion notice clears\n * itself after `feedbackDuration`; that timer is torn down on disconnect (Turbo)\n * via {@link SafeTimeout}.\n */\nexport class ClipboardController extends Controller<HTMLElement> {\n  static override targets = [\"source\", \"button\", \"feedback\"];\n  static override values = {\n    text: { type: String, default: \"\" },\n    feedbackDuration: { type: Number, default: 2000 },\n    copiedLabel: { type: String, default: \"Copied\" },\n    errorLabel: { type: String, default: \"Copy failed\" },\n  };\n  static actions = [\"copy\"] as const;\n  static events = [\"copy\"] as const;\n\n  declare readonly sourceTarget: HTMLElement;\n  declare readonly buttonTarget: HTMLElement;\n  declare readonly feedbackTarget: HTMLElement;\n  declare readonly hasSourceTarget: boolean;\n  declare readonly hasButtonTarget: boolean;\n  declare readonly hasFeedbackTarget: boolean;\n\n  declare textValue: string;\n  declare feedbackDurationValue: number;\n  declare copiedLabelValue: string;\n  declare errorLabelValue: string;\n\n  /** Auto-clear timer for the completion notice; torn down on disconnect. */\n  #timers = new SafeTimeout();\n\n  /**\n   * The pending auto-clear timer id, or `null` when none is scheduled. Tracked so\n   * a rapid second copy cancels the first window instead of letting a stale timer\n   * reset the freshly-shown notice early.\n   */\n  #resetTimerId: number | null = null;\n\n  override connect(): void {\n    setDefaultAttribute(this.element, \"data-state\", \"idle\");\n  }\n\n  override disconnect(): void {\n    this.#timers.clearAll();\n  }\n\n  /**\n   * Copies the resolved text and reports the outcome. Bound via `data-action`\n   * (click). Always dispatches `stimeo--clipboard:copy` with `{ success, text }`\n   * — including on failure — so consumers can react either way.\n   */\n  async copy(): Promise<void> {\n    const text = this.#resolveText();\n    let success = false;\n    try {\n      if (!navigator.clipboard?.writeText) throw new Error(\"Clipboard API unavailable\");\n      await navigator.clipboard.writeText(text);\n      success = true;\n    } catch {\n      success = false;\n    }\n\n    this.#reportResult(success);\n    this.dispatch(\"copy\", { detail: { success, text } });\n  }\n\n  /**\n   * The text to copy: the explicit `text` value when set, otherwise the source\n   * target's current value (inputs/textareas) or text content.\n   */\n  #resolveText(): string {\n    if (this.textValue.length > 0) return this.textValue;\n    if (!this.hasSourceTarget) return \"\";\n    const source = this.sourceTarget;\n    if (source instanceof HTMLInputElement || source instanceof HTMLTextAreaElement) {\n      return source.value;\n    }\n    return source.textContent ?? \"\";\n  }\n\n  /** Reflects the result on `data-state`, announces it, and schedules a reset. */\n  #reportResult(success: boolean): void {\n    this.element.setAttribute(\"data-state\", success ? \"copied\" : \"error\");\n    if (this.hasFeedbackTarget) {\n      this.feedbackTarget.textContent = success ? this.copiedLabelValue : this.errorLabelValue;\n    }\n\n    // Cancel any in-flight reset so consecutive copies restart the full window\n    // rather than having the earlier timer clear the new notice prematurely.\n    if (this.#resetTimerId !== null) {\n      this.#timers.clear(this.#resetTimerId);\n      this.#resetTimerId = null;\n    }\n    if (this.feedbackDurationValue > 0) {\n      this.#resetTimerId = this.#timers.set(() => {\n        this.#resetTimerId = null;\n        this.#reset();\n      }, this.feedbackDurationValue);\n    }\n  }\n\n  /** Returns to the idle state and clears the completion notice. */\n  #reset(): void {\n    this.element.setAttribute(\"data-state\", \"idle\");\n    if (this.hasFeedbackTarget) {\n      this.feedbackTarget.textContent = \"\";\n    }\n  }\n}\n"]}

package/dist/controllers/collapsible_controller.d.ts

@@ -22,7 +22,7 @@ import { Controller } from '@hotwired/stimulus';
  * The controller keeps the open lifecycle ordered so `hidden` (effectively
  * `display:none`) never blocks measurement or the transition:
  * - **Open**: drop `hidden` → measure the natural height into
- *   `--stimeo-collapsible-content-height` → set `data-state="open"`.
+ *   `--stimeo--collapsible-content-height` → set `data-state="open"`.
  * - **Close**: set `data-state="closed"` (CSS shrinks the height) → re-apply
  *   `hidden` once the transition settles. With no transition (or reduced motion,
  *   which the consumer's CSS expresses as a zero duration) it is applied

package/dist/controllers/collapsible_controller.js

@@ -297,7 +297,10 @@ var CollapsibleController = class extends Controller {
   #applyContent(content, open, waitForCloseTransition) {
     if (open) {
       content.hidden = false;
-      content.style.setProperty("--stimeo-collapsible-content-height", `${content.scrollHeight}px`);
+      content.style.setProperty(
+        "--stimeo--collapsible-content-height",
+        `${content.scrollHeight}px`
+      );
       content.setAttribute("data-state", "open");
       return;
     }