stimeo-ui 0.14.0 → 0.16.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 * Widgets whose output is measured — an overflow boundary, a masonry column count,\n * an autosized textarea — 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 */\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 * `toggle` dispatches `{ expanded: boolean }`.\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 a shared layout observer (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.\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: nothing is collapsed to reveal.\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 layout observation for Stimeo controllers.\n *\n * Widgets whose output is measured — an overflow boundary, a masonry column count,\n * an autosized textarea — have three sources that move the layout under them: their\n * *own* box changing — via {@link ResizeObserver} — the *viewport* changing — via the\n * `window` `resize` event — and a descendant *resource settling*, because an image or\n * a frame reports a height of zero until it has loaded. Wiring those three by hand in\n * every controller risks leaked listeners on `disconnect()`. {@link LayoutObserver}\n * owns all three 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 *   this.#layout.observeDescendantLoads(this.panelTarget);\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  #loadContainer: Element | null = null;\n\n  /** Stable bound handler so add/removeEventListener target the same reference. */\n  readonly #handleViewportResize = (): void => {\n    this.#callback();\n  };\n\n  /** Stable bound handler for the capture-phase `load`; see {@link observeDescendantLoads}. */\n  readonly #handleDescendantLoad = (): 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   * Starts reporting a `load` from anywhere inside `container` — an image or a\n   * frame settling changes the box it sits in, and it measures as zero high until\n   * then. `load` does not bubble, so the subscription is a capture-phase listener\n   * on the container itself and nothing the caller spells.\n   *\n   * **One container at a time.** A further call moves the observation, so a widget\n   * whose content element is swapped at runtime releases the element it let go by\n   * naming the new one — there is no second place for the release to drift from.\n   */\n  observeDescendantLoads(container: Element): void {\n    this.unobserveDescendantLoads();\n    this.#loadContainer = container;\n    container.addEventListener(\"load\", this.#handleDescendantLoad, true);\n  }\n\n  /** Stops reporting descendant loads without affecting element or viewport observation. */\n  unobserveDescendantLoads(): void {\n    this.#loadContainer?.removeEventListener(\"load\", this.#handleDescendantLoad, true);\n    this.#loadContainer = null;\n  }\n\n  /**\n   * Releases every observation: disconnects the {@link ResizeObserver} and removes\n   * the viewport and descendant-load listeners. Safe to call multiple times. Call\n   * this from a controller's `disconnect()`.\n   */\n  disconnect(): void {\n    this.#resizeObserver?.disconnect();\n    this.#resizeObserver = null;\n    this.unobserveViewport();\n    this.unobserveDescendantLoads();\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 */\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 * `toggle` dispatches `{ expanded: boolean }`.\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 a shared layout observer (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: the overflow measurement clears it on every pass 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 an `ellipsis` target arrives. The `ellipsis` and `trigger`\n   * targets form the disclosure set, a precondition for collapsing at all, so they\n   * need the same watching the list and items get: without their callbacks a swap\n   * that breaks or completes the set would only take effect at the next resize or\n   * list mutation, which may never come.\n   */\n  ellipsisTargetConnected(): void {\n    this.#resync();\n  }\n\n  /** Re-measures when an `ellipsis` target leaves the disclosure set. */\n  ellipsisTargetDisconnected(): void {\n    this.#resync();\n  }\n\n  /** Re-measures when a `trigger` target joins the disclosure set. */\n  triggerTargetConnected(): void {\n    this.#resync();\n  }\n\n  /** Re-measures when a `trigger` target leaves the disclosure set. */\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 rendering 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  #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.\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: nothing is collapsed to reveal.\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/bulk_select_controller.d.ts

@@ -4,7 +4,7 @@ import { Controller } from '@hotwired/stimulus';
  * Headless **bulk select / batch action bar** (no dedicated APG pattern — a
  * composition of a checkbox group and a toolbar). Mirrors the Gmail/admin UX where
  * checking one or more rows reveals a sticky action bar with the selected count,
- * select-all, and clear. Data Grid owns per-row `aria-selected`; this is the
+ * select-all, and clear. `stimeo--data-grid` owns per-row `aria-selected`; this is the
  * contextual action-bar layer on top.
  *
  * Markup contract (identifier: `stimeo--bulk-select`):
@@ -58,8 +58,8 @@ import { Controller } from '@hotwired/stimulus';
  * the select-all box first when the bar holds it, so the keyboard user keeps a Tab
  * position instead of falling back to the document.
  *
- * A non-finite `totalCount` falls back to the Value's default and is written back
- * to the attribute, so the count never renders as `NaN`.
+ * A non-finite `totalCount` counts as the Value's default `0`, so the count never
+ * renders as `NaN`. The attribute keeps what the page wrote.
  *
  * The delegated listener and the pending repair are both released on `disconnect()`.
  */
@@ -97,7 +97,7 @@ declare class BulkSelectController extends Controller<HTMLElement> {
     allTargetConnected(): void;
     /** Repairs the figures after the select-all box leaves. */
     allTargetDisconnected(): void;
-    /** Repaints the count for a total that changed at runtime, rejecting non-finite ones. */
+    /** Repaints the count for a total that changed at runtime. */
     totalCountValueChanged(): void;
     /** Repaints so wording changed at runtime is used by the next announcement. */
     announceTextValueChanged(): void;

package/dist/controllers/bulk_select_controller.js

@@ -108,12 +108,8 @@ var BulkSelectController = class extends Controller {
   allTargetDisconnected() {
     this.#reconcile.schedule();
   }
-  /** Repaints the count for a total that changed at runtime, rejecting non-finite ones. */
+  /** Repaints the count for a total that changed at runtime. */
   totalCountValueChanged() {
-    if (!Number.isFinite(this.totalCountValue)) {
-      this.totalCountValue = 0;
-      return;
-    }
     this.#reconcile.schedule();
   }
   /** Repaints so wording changed at runtime is used by the next announcement. */
@@ -175,6 +171,11 @@ var BulkSelectController = class extends Controller {
   #announce(detail) {
     announce(fillTemplate(this.announceTextValue, { count: detail.count }));
   }
+  /** The declared `totalCount`, or the default `0` in place of a non-finite one. */
+  get #totalCount() {
+    const declared = this.totalCountValue;
+    return Number.isFinite(declared) ? declared : 0;
+  }
   /**
    * Recomputes the count, the select-all checked/indeterminate state, and the bar
    * visibility from the current DOM. Returns the figures when the emitted count or
@@ -191,7 +192,7 @@ var BulkSelectController = class extends Controller {
       this.allTarget.checked = total > 0 && checked === total;
       this.allTarget.indeterminate = checked > 0 && checked < total;
     }
-    const count = allPages ? this.totalCountValue : checked;
+    const count = allPages ? this.#totalCount : checked;
     const show = allPages || checked > 0;
     if (this.hasBarTarget) {
       if (!show && this.hasAllTarget && this.barTarget.contains(document.activeElement)) {

package/dist/controllers/bulk_select_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/announce.ts","../../src/utils/microtask_coalescer.ts","../../src/controllers/bulk_select_controller.ts"],"names":[],"mappings":"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","file":"bulk_select_controller.js","sourcesContent":["/**\n * Sends one message to the page's shared `stimeo--announcer`.\n *\n * A component that has to reach assistive tech does not carry a live region of its\n * own: a region only announces what changes *after* assistive tech already knows\n * about it, which a region that appears (or is un-hidden) with its message cannot\n * satisfy. The one region that can is the announcer sitting in the page from the\n * start, so state changes are handed to it as an event and it does the reading.\n *\n * The event goes to `window` because the announcer is usually a sibling high in the\n * document rather than an ancestor of the component dispatching it.\n *\n * Wording comes from the consumer — the library ships no English strings — so an\n * empty message is silently dropped and nothing is announced.\n *\n * @example\n * ```ts\n * announce(this.announceTextValue, { assertive: false });\n * ```\n */\nexport function announce(message: string, options: { assertive?: boolean } = {}): void {\n  const text = message.trim();\n  if (text.length === 0) return;\n  window.dispatchEvent(\n    new CustomEvent(\"stimeo--announcer:announce\", {\n      detail: { message: text, assertive: options.assertive === true },\n    }),\n  );\n}\n\n/**\n * Fills `{name}` placeholders in an announcement template from `values`.\n *\n * The same substitution the value-text templates use, so a consumer writes\n * `\"{percent}% complete\"` in one attribute and gets the same rules everywhere. A\n * placeholder with no matching entry is left as authored rather than blanked, which\n * keeps a typo visible instead of silently swallowing the word.\n */\nexport function fillTemplate(template: string, values: Record<string, string | number>): string {\n  return template.replace(/\\{([a-zA-Z][a-zA-Z0-9]*)\\}/g, (match, name: string) => {\n    const replacement = values[name];\n    return replacement === undefined ? match : String(replacement);\n  });\n}\n","/**\n * Collapses many Stimulus lifecycle callbacks from one DOM mutation into a\n * single pass.\n *\n * Stimulus fires `<name>TargetConnected` / `Disconnected` once per element and\n * `<name>ValueChanged` once per changed attribute. Replacing a list of N options\n * or morphing several render Values therefore delivers N callbacks — but the\n * useful unit of work is \"reconcile against the resulting declarative input\",\n * once, after the batch has settled. Every controller with reconcilable targets\n * or render Values needs the same shape: a `queued` flag plus `queueMicrotask`.\n *\n * **A microtask is the right horizon, and the reason is specific.** Stimulus\n * drives these callbacks from a `MutationObserver`, whose own callback already\n * runs as a microtask with the whole batch in hand; scheduling one more lands\n * after the last sibling callback of that batch and still before paint or any\n * event handler. A timer would be later than it needs to be, and reconciling\n * synchronously would run once per element against a half-applied DOM.\n *\n * **The two guards are not the same guard.** Scheduling is refused before the\n * controller connects, and running is refused after it disconnects:\n *\n * - **Before `connect()`** — Stimulus delivers initial target and Value callbacks\n *   ahead of `connect()`. Reconciling there would compute output against a\n *   controller whose own state has not been initialised, and `connect()` is\n *   about to do a full pass anyway.\n * - **After `disconnect()`** — Stimulus fires a callback for **every** target\n *   during teardown, and a microtask queued just before it would otherwise run\n *   against a detached tree. {@link MicrotaskCoalescer.cancel} exists for the\n *   teardown path to drop the pending pass outright.\n *\n * Both guards are part of one contract here rather than something each consumer\n * has to remember separately.\n *\n * Scope is the scheduling only. *What* to reconcile — keep the surviving active\n * option, fall back to the next / previous / first visible one, rebuild derived\n * chips or hidden fields — stays in the controller, because no two consumers\n * answer it the same way.\n *\n * This file's own doc block is dropped from `dist`, but every member comment is\n * inlined into each consumer entry (`tsup` builds with `splitting: false`), so\n * rationale belongs here and only the contract belongs on the members.\n *\n * @example\n * ```ts\n * readonly #reconcile = new MicrotaskCoalescer(() => this.#reconcileOptions());\n *\n * connect()    { this.#reconcile.activate(); }\n * disconnect() { this.#reconcile.cancel(); }\n *\n * optionTargetConnected()    { this.#reconcile.schedule(); }\n * optionTargetDisconnected() { this.#reconcile.schedule(); }\n * ```\n */\nexport class MicrotaskCoalescer {\n  readonly #run: () => void;\n  #queued = false;\n  #active = false;\n  #generation = 0;\n\n  /** @param run - the single reconciliation pass, invoked at most once per batch. */\n  constructor(run: () => void) {\n    this.#run = run;\n  }\n\n  /** Opens the window in which {@link schedule} is honoured; call from `connect()`. */\n  activate(): void {\n    this.#active = true;\n  }\n\n  /** Closes the window and drops any pending pass; call from `disconnect()`. */\n  cancel(): void {\n    this.#active = false;\n    this.#queued = false;\n    this.#generation += 1;\n  }\n\n  /** Requests one pass after the batch settles. Idempotent; inert outside the window. */\n  schedule(): void {\n    if (!this.#active || this.#queued) return;\n    this.#queued = true;\n    const generation = this.#generation;\n    queueMicrotask(() => {\n      // A cancelled callback must not consume a pass queued after reconnect.\n      if (generation !== this.#generation || !this.#queued || !this.#active) return;\n      this.#queued = false;\n      this.#run();\n    });\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { announce, fillTemplate } from \"../utils/announce\";\nimport { MicrotaskCoalescer } from \"../utils/microtask_coalescer\";\n\n/** The selection figures every report carries. */\ntype SelectionDetail = { count: number; allPages: boolean };\n\n/**\n * Headless **bulk select / batch action bar** (no dedicated APG pattern — a\n * composition of a checkbox group and a toolbar). Mirrors the Gmail/admin UX where\n * checking one or more rows reveals a sticky action bar with the selected count,\n * select-all, and clear. Data Grid owns per-row `aria-selected`; this is the\n * contextual action-bar layer on top.\n *\n * Markup contract (identifier: `stimeo--bulk-select`):\n *   <div data-controller=\"stimeo--bulk-select\"\n *        data-stimeo--bulk-select-total-count-value=\"128\"\n *        data-stimeo--bulk-select-announce-text-value=\"{count} selected\">\n *     <input type=\"checkbox\" data-stimeo--bulk-select-target=\"all\">\n *     <!-- rows (may be added dynamically; handled via event delegation) -->\n *     <input type=\"checkbox\" data-stimeo--bulk-select-target=\"item\">\n *     <input type=\"checkbox\" data-stimeo--bulk-select-target=\"item\">\n *     <div data-stimeo--bulk-select-target=\"bar\" hidden role=\"toolbar\"\n *          data-controller=\"stimeo--toolbar\" aria-label=\"Bulk actions\">\n *       <span data-stimeo--bulk-select-target=\"count\"></span> selected\n *       <button data-stimeo--bulk-select-target=\"selectAllPages\"\n *               data-stimeo--toolbar-target=\"control\"\n *               data-action=\"click->stimeo--bulk-select#selectAllPages\">Select all</button>\n *       <button data-stimeo--toolbar-target=\"control\"\n *               data-action=\"click->stimeo--bulk-select#clear\">Clear</button>\n *     </div>\n *   </div>\n *\n * The bar carries `role=\"toolbar\"`, so it is composed with `stimeo--toolbar` to get\n * the arrow-key movement and single tab stop that role calls for.\n *\n * `change` and `reconcile` both dispatch `{ count, allPages }`.\n *\n * Selection is two-stage. The select-all box covers the rows on this page; the\n * optional `selectAllPages` control extends the selection to `totalCount` rows\n * across every page, checking each row here as it does so. Touching any single row\n * leaves that mode, because the selection is no longer the whole set.\n *\n * @remarks\n * Behavior only — it never runs the batch action (that is the consumer's\n * form/Turbo) nor fetches/pages rows. Selection lives **only** in each checkbox's\n * `checked` (no module-scope set), so `connect()` recomputes idempotently from the\n * DOM after a Turbo swap. Row `change` is handled by **delegation** on the\n * container, so dynamically-added rows work without per-row `data-action`, while\n * rows arriving or leaving on their own are picked up by the target callbacks and\n * coalesced into one repair per batch.\n *\n * `change` is dispatched when the user moves the selection; `reconcile` when the\n * controller repairs the figures itself — a row added or removed by the page, or a\n * render input changing at runtime. Both carry the same detail.\n *\n * The count reaches assistive tech through the page's shared `stimeo--announcer`,\n * worded by the consumer via `announceText` (`{count}` expands to the figure being\n * shown; an empty template stays silent, keeping announcements opt-in and\n * i18n-neutral).\n *\n * Showing the bar never steals focus (WCAG 2.2 2.4.3). Hiding it hands focus to\n * the select-all box first when the bar holds it, so the keyboard user keeps a Tab\n * position instead of falling back to the document.\n *\n * A non-finite `totalCount` falls back to the Value's default and is written back\n * to the attribute, so the count never renders as `NaN`.\n *\n * The delegated listener and the pending repair are both released on `disconnect()`.\n */\nexport class BulkSelectController extends Controller<HTMLElement> {\n  static override targets = [\"all\", \"item\", \"bar\", \"count\", \"selectAllPages\"];\n  static override values = {\n    totalCount: { type: Number, default: 0 },\n    announceText: { type: String, default: \"\" },\n  };\n  static actions = [\"clear\", \"selectAllPages\"] as const;\n  static events = [\"change\", \"reconcile\"] as const;\n\n  declare readonly allTarget: HTMLInputElement;\n  declare readonly barTarget: HTMLElement;\n  declare readonly countTarget: HTMLElement;\n  declare readonly itemTargets: HTMLInputElement[];\n  declare readonly hasAllTarget: boolean;\n  declare readonly hasBarTarget: boolean;\n  declare readonly hasCountTarget: boolean;\n\n  declare totalCountValue: number;\n  declare announceTextValue: string;\n\n  /** All-pages mode is a transient UI state, mirrored to `data-all-pages` so a\n   *  `connect()` over markup that already carries the attribute rehydrates the\n   *  mode — a morph, a Turbo Stream, a server that renders it back, or a restore\n   *  visit, whose cached snapshot carries the attribute too. */\n  #allPagesMode = false;\n  /** Last emitted figures, so a recompute reports only on a real change. */\n  #lastCount = -1;\n  #lastAllPages = false;\n\n  /** Collapses every signal from one DOM or Value update into one repair. */\n  readonly #reconcile = new MicrotaskCoalescer(() => this.#reconcileNow());\n\n  /** Delegated `change` handler covering the select-all box and every row. */\n  readonly #onChange = (event: Event): void => {\n    const target = event.target as HTMLElement | null;\n    if (!target) return;\n    if (this.hasAllTarget && target === this.allTarget) {\n      this.#applyAll();\n    } else if (this.itemTargets.some((item) => item === target)) {\n      this.#exitAllPages();\n      this.#reportChange(this.#recompute());\n    }\n  };\n\n  override connect(): void {\n    this.#allPagesMode = this.element.dataset.allPages === \"true\";\n    this.#reconcile.activate();\n    this.element.addEventListener(\"change\", this.#onChange);\n    this.#recompute();\n  }\n\n  override disconnect(): void {\n    this.element.removeEventListener(\"change\", this.#onChange);\n    this.#reconcile.cancel();\n  }\n\n  /** Repairs the figures for a row that arrived at runtime. */\n  itemTargetConnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Repairs the figures after a row leaves, so a removed selection stops counting. */\n  itemTargetDisconnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Reflects the current selection onto a select-all box added at runtime. */\n  allTargetConnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Repairs the figures after the select-all box leaves. */\n  allTargetDisconnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Repaints the count for a total that changed at runtime, rejecting non-finite ones. */\n  totalCountValueChanged(): void {\n    if (!Number.isFinite(this.totalCountValue)) {\n      this.totalCountValue = 0;\n      return;\n    }\n    this.#reconcile.schedule();\n  }\n\n  /** Repaints so wording changed at runtime is used by the next announcement. */\n  announceTextValueChanged(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Clears every selection (rows + select-all) and exits all-pages mode. */\n  clear(): void {\n    for (const item of this.itemTargets) item.checked = false;\n    if (this.hasAllTarget) {\n      this.allTarget.checked = false;\n      this.allTarget.indeterminate = false;\n    }\n    this.#exitAllPages();\n    this.#reportChange(this.#recompute());\n  }\n\n  /**\n   * Enters \"select all across pages\" mode: the count shows `totalCount`, and every\n   * row on this page is checked.\n   *\n   * The mode's claim is that the whole set is selected, so leaving a visible row\n   * unchecked would put the page and the count in open disagreement.\n   */\n  selectAllPages(): void {\n    this.#allPagesMode = true;\n    this.#checkEveryRow();\n    this.#reportChange(this.#recompute());\n  }\n\n  /** Marks every row on this page selected. */\n  #checkEveryRow(): void {\n    for (const item of this.itemTargets) item.checked = true;\n  }\n\n  /** Mirrors the select-all box to every row, then recomputes. */\n  #applyAll(): void {\n    if (!this.hasAllTarget) return;\n    const { checked } = this.allTarget;\n    for (const item of this.itemTargets) item.checked = checked;\n    this.#exitAllPages();\n    this.#reportChange(this.#recompute());\n  }\n\n  #exitAllPages(): void {\n    this.#allPagesMode = false;\n  }\n\n  /** Repairs the derived state after the page moved rows or a render input. */\n  #reconcileNow(): void {\n    // A row that arrives while the whole set is selected is one of the rows the\n    // mode already claims, so it lands checked instead of contradicting the count.\n    if (this.#allPagesMode) this.#checkEveryRow();\n    const detail = this.#recompute();\n    if (!detail) return;\n    this.dispatch(\"reconcile\", { detail });\n    this.#announce(detail);\n  }\n\n  /** Reports a selection the user moved. */\n  #reportChange(detail: SelectionDetail | null): void {\n    if (!detail) return;\n    this.dispatch(\"change\", { detail });\n    this.#announce(detail);\n  }\n\n  /** Hands the count to the shared announcer, worded by the consumer. */\n  #announce(detail: SelectionDetail): void {\n    announce(fillTemplate(this.announceTextValue, { count: detail.count }));\n  }\n\n  /**\n   * Recomputes the count, the select-all checked/indeterminate state, and the bar\n   * visibility from the current DOM. Returns the figures when the emitted count or\n   * all-pages flag actually moved, and `null` when they did not.\n   *\n   * @stimeoRenderRoot\n   */\n  #recompute(): SelectionDetail | null {\n    const items = this.itemTargets;\n    const total = items.length;\n    const checked = items.filter((item) => item.checked).length;\n    const allPages = this.#allPagesMode;\n\n    if (this.hasAllTarget) {\n      this.allTarget.checked = total > 0 && checked === total;\n      this.allTarget.indeterminate = checked > 0 && checked < total;\n    }\n\n    const count = allPages ? this.totalCountValue : checked;\n    const show = allPages || checked > 0;\n\n    if (this.hasBarTarget) {\n      // Hand the Tab position over before the bar leaves, or focus falls to the\n      // document and the keyboard user loses their place.\n      if (!show && this.hasAllTarget && this.barTarget.contains(document.activeElement)) {\n        this.allTarget.focus();\n      }\n      this.barTarget.hidden = !show;\n    }\n    if (this.hasCountTarget) this.countTarget.textContent = String(count);\n\n    this.element.setAttribute(\"data-selected-count\", String(checked));\n    if (allPages) this.element.setAttribute(\"data-all-pages\", \"true\");\n    else this.element.removeAttribute(\"data-all-pages\");\n\n    const changed = count !== this.#lastCount || allPages !== this.#lastAllPages;\n    this.#lastCount = count;\n    this.#lastAllPages = allPages;\n    return changed ? { count, allPages } : null;\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/announce.ts","../../src/utils/microtask_coalescer.ts","../../src/controllers/bulk_select_controller.ts"],"names":[],"mappings":"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","file":"bulk_select_controller.js","sourcesContent":["/**\n * Sends one message to the page's shared `stimeo--announcer`.\n *\n * A component that has to reach assistive tech does not carry a live region of its\n * own: a region only announces what changes *after* assistive tech already knows\n * about it, which a region that appears (or is un-hidden) with its message cannot\n * satisfy. The one region that can is the announcer sitting in the page from the\n * start, so state changes are handed to it as an event and it does the reading.\n *\n * The event goes to `window` because the announcer is usually a sibling high in the\n * document rather than an ancestor of the component dispatching it.\n *\n * Wording comes from the consumer — the library ships no English strings — so an\n * empty message is silently dropped and nothing is announced.\n *\n * @example\n * ```ts\n * announce(this.announceTextValue, { assertive: false });\n * ```\n */\nexport function announce(message: string, options: { assertive?: boolean } = {}): void {\n  const text = message.trim();\n  if (text.length === 0) return;\n  window.dispatchEvent(\n    new CustomEvent(\"stimeo--announcer:announce\", {\n      detail: { message: text, assertive: options.assertive === true },\n    }),\n  );\n}\n\n/**\n * Fills `{name}` placeholders in an announcement template from `values`.\n *\n * The same substitution the value-text templates use, so a consumer writes\n * `\"{percent}% complete\"` in one attribute and gets the same rules everywhere. A\n * placeholder with no matching entry is left as authored rather than blanked, which\n * keeps a typo visible instead of silently swallowing the word.\n */\nexport function fillTemplate(template: string, values: Record<string, string | number>): string {\n  return template.replace(/\\{([a-zA-Z][a-zA-Z0-9]*)\\}/g, (match, name: string) => {\n    const replacement = values[name];\n    return replacement === undefined ? match : String(replacement);\n  });\n}\n","/**\n * Collapses many Stimulus lifecycle callbacks from one DOM mutation into a\n * single pass.\n *\n * Stimulus fires `<name>TargetConnected` / `Disconnected` once per element and\n * `<name>ValueChanged` once per changed attribute. Replacing a list of N options\n * or morphing several render Values therefore delivers N callbacks — but the\n * useful unit of work is \"reconcile against the resulting declarative input\",\n * once, after the batch has settled. Every controller with reconcilable targets\n * or render Values needs the same shape: a `queued` flag plus `queueMicrotask`.\n *\n * **A microtask is the right horizon, and the reason is specific.** Stimulus\n * drives these callbacks from a `MutationObserver`, whose own callback already\n * runs as a microtask with the whole batch in hand; scheduling one more lands\n * after the last sibling callback of that batch and still before paint or any\n * event handler. A timer would be later than it needs to be, and reconciling\n * synchronously would run once per element against a half-applied DOM.\n *\n * **The two guards are not the same guard.** Scheduling is refused before the\n * controller connects, and running is refused after it disconnects:\n *\n * - **Before `connect()`** — Stimulus delivers initial target and Value callbacks\n *   ahead of `connect()`. Reconciling there would compute output against a\n *   controller whose own state has not been initialised, and `connect()` is\n *   about to do a full pass anyway.\n * - **After `disconnect()`** — Stimulus fires a callback for **every** target\n *   during teardown, and a microtask queued just before it would otherwise run\n *   against a detached tree. {@link MicrotaskCoalescer.cancel} exists for the\n *   teardown path to drop the pending pass outright.\n *\n * Both guards are part of one contract here rather than something each consumer\n * has to remember separately.\n *\n * Scope is the scheduling only. *What* to reconcile — keep the surviving active\n * option, fall back to the next / previous / first visible one, rebuild derived\n * chips or hidden fields — stays in the controller, because no two consumers\n * answer it the same way.\n *\n * This file's own doc block is dropped from `dist`, but every member comment is\n * inlined into each consumer entry (`tsup` builds with `splitting: false`), so\n * rationale belongs here and only the contract belongs on the members.\n *\n * @example\n * ```ts\n * readonly #reconcile = new MicrotaskCoalescer(() => this.#reconcileOptions());\n *\n * connect()    { this.#reconcile.activate(); }\n * disconnect() { this.#reconcile.cancel(); }\n *\n * optionTargetConnected()    { this.#reconcile.schedule(); }\n * optionTargetDisconnected() { this.#reconcile.schedule(); }\n * ```\n */\nexport class MicrotaskCoalescer {\n  readonly #run: () => void;\n  #queued = false;\n  #active = false;\n  #generation = 0;\n\n  /** @param run - the single reconciliation pass, invoked at most once per batch. */\n  constructor(run: () => void) {\n    this.#run = run;\n  }\n\n  /** Opens the window in which {@link schedule} is honoured; call from `connect()`. */\n  activate(): void {\n    this.#active = true;\n  }\n\n  /** Closes the window and drops any pending pass; call from `disconnect()`. */\n  cancel(): void {\n    this.#active = false;\n    this.#queued = false;\n    this.#generation += 1;\n  }\n\n  /** Requests one pass after the batch settles. Idempotent; inert outside the window. */\n  schedule(): void {\n    if (!this.#active || this.#queued) return;\n    this.#queued = true;\n    const generation = this.#generation;\n    queueMicrotask(() => {\n      // A cancelled callback must not consume a pass queued after reconnect.\n      if (generation !== this.#generation || !this.#queued || !this.#active) return;\n      this.#queued = false;\n      this.#run();\n    });\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { announce, fillTemplate } from \"../utils/announce\";\nimport { MicrotaskCoalescer } from \"../utils/microtask_coalescer\";\n\n/** The selection figures every report carries. */\ntype SelectionDetail = { count: number; allPages: boolean };\n\n/**\n * Headless **bulk select / batch action bar** (no dedicated APG pattern — a\n * composition of a checkbox group and a toolbar). Mirrors the Gmail/admin UX where\n * checking one or more rows reveals a sticky action bar with the selected count,\n * select-all, and clear. `stimeo--data-grid` owns per-row `aria-selected`; this is the\n * contextual action-bar layer on top.\n *\n * Markup contract (identifier: `stimeo--bulk-select`):\n *   <div data-controller=\"stimeo--bulk-select\"\n *        data-stimeo--bulk-select-total-count-value=\"128\"\n *        data-stimeo--bulk-select-announce-text-value=\"{count} selected\">\n *     <input type=\"checkbox\" data-stimeo--bulk-select-target=\"all\">\n *     <!-- rows (may be added dynamically; handled via event delegation) -->\n *     <input type=\"checkbox\" data-stimeo--bulk-select-target=\"item\">\n *     <input type=\"checkbox\" data-stimeo--bulk-select-target=\"item\">\n *     <div data-stimeo--bulk-select-target=\"bar\" hidden role=\"toolbar\"\n *          data-controller=\"stimeo--toolbar\" aria-label=\"Bulk actions\">\n *       <span data-stimeo--bulk-select-target=\"count\"></span> selected\n *       <button data-stimeo--bulk-select-target=\"selectAllPages\"\n *               data-stimeo--toolbar-target=\"control\"\n *               data-action=\"click->stimeo--bulk-select#selectAllPages\">Select all</button>\n *       <button data-stimeo--toolbar-target=\"control\"\n *               data-action=\"click->stimeo--bulk-select#clear\">Clear</button>\n *     </div>\n *   </div>\n *\n * The bar carries `role=\"toolbar\"`, so it is composed with `stimeo--toolbar` to get\n * the arrow-key movement and single tab stop that role calls for.\n *\n * `change` and `reconcile` both dispatch `{ count, allPages }`.\n *\n * Selection is two-stage. The select-all box covers the rows on this page; the\n * optional `selectAllPages` control extends the selection to `totalCount` rows\n * across every page, checking each row here as it does so. Touching any single row\n * leaves that mode, because the selection is no longer the whole set.\n *\n * @remarks\n * Behavior only — it never runs the batch action (that is the consumer's\n * form/Turbo) nor fetches/pages rows. Selection lives **only** in each checkbox's\n * `checked` (no module-scope set), so `connect()` recomputes idempotently from the\n * DOM after a Turbo swap. Row `change` is handled by **delegation** on the\n * container, so dynamically-added rows work without per-row `data-action`, while\n * rows arriving or leaving on their own are picked up by the target callbacks and\n * coalesced into one repair per batch.\n *\n * `change` is dispatched when the user moves the selection; `reconcile` when the\n * controller repairs the figures itself — a row added or removed by the page, or a\n * render input changing at runtime. Both carry the same detail.\n *\n * The count reaches assistive tech through the page's shared `stimeo--announcer`,\n * worded by the consumer via `announceText` (`{count}` expands to the figure being\n * shown; an empty template stays silent, keeping announcements opt-in and\n * i18n-neutral).\n *\n * Showing the bar never steals focus (WCAG 2.2 2.4.3). Hiding it hands focus to\n * the select-all box first when the bar holds it, so the keyboard user keeps a Tab\n * position instead of falling back to the document.\n *\n * A non-finite `totalCount` counts as the Value's default `0`, so the count never\n * renders as `NaN`. The attribute keeps what the page wrote.\n *\n * The delegated listener and the pending repair are both released on `disconnect()`.\n */\nexport class BulkSelectController extends Controller<HTMLElement> {\n  static override targets = [\"all\", \"item\", \"bar\", \"count\", \"selectAllPages\"];\n  static override values = {\n    totalCount: { type: Number, default: 0 },\n    announceText: { type: String, default: \"\" },\n  };\n  static actions = [\"clear\", \"selectAllPages\"] as const;\n  static events = [\"change\", \"reconcile\"] as const;\n\n  declare readonly allTarget: HTMLInputElement;\n  declare readonly barTarget: HTMLElement;\n  declare readonly countTarget: HTMLElement;\n  declare readonly itemTargets: HTMLInputElement[];\n  declare readonly hasAllTarget: boolean;\n  declare readonly hasBarTarget: boolean;\n  declare readonly hasCountTarget: boolean;\n\n  declare totalCountValue: number;\n  declare announceTextValue: string;\n\n  /** All-pages mode is a transient UI state, mirrored to `data-all-pages` so a\n   *  `connect()` over markup that already carries the attribute rehydrates the\n   *  mode — a morph, a Turbo Stream, a server that renders it back, or a restore\n   *  visit, whose cached snapshot carries the attribute too. */\n  #allPagesMode = false;\n  /** Last emitted figures, so a recompute reports only on a real change. */\n  #lastCount = -1;\n  #lastAllPages = false;\n\n  /** Collapses every signal from one DOM or Value update into one repair. */\n  readonly #reconcile = new MicrotaskCoalescer(() => this.#reconcileNow());\n\n  /** Delegated `change` handler covering the select-all box and every row. */\n  readonly #onChange = (event: Event): void => {\n    const target = event.target as HTMLElement | null;\n    if (!target) return;\n    if (this.hasAllTarget && target === this.allTarget) {\n      this.#applyAll();\n    } else if (this.itemTargets.some((item) => item === target)) {\n      this.#exitAllPages();\n      this.#reportChange(this.#recompute());\n    }\n  };\n\n  override connect(): void {\n    this.#allPagesMode = this.element.dataset.allPages === \"true\";\n    this.#reconcile.activate();\n    this.element.addEventListener(\"change\", this.#onChange);\n    this.#recompute();\n  }\n\n  override disconnect(): void {\n    this.element.removeEventListener(\"change\", this.#onChange);\n    this.#reconcile.cancel();\n  }\n\n  /** Repairs the figures for a row that arrived at runtime. */\n  itemTargetConnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Repairs the figures after a row leaves, so a removed selection stops counting. */\n  itemTargetDisconnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Reflects the current selection onto a select-all box added at runtime. */\n  allTargetConnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Repairs the figures after the select-all box leaves. */\n  allTargetDisconnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Repaints the count for a total that changed at runtime. */\n  totalCountValueChanged(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Repaints so wording changed at runtime is used by the next announcement. */\n  announceTextValueChanged(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Clears every selection (rows + select-all) and exits all-pages mode. */\n  clear(): void {\n    for (const item of this.itemTargets) item.checked = false;\n    if (this.hasAllTarget) {\n      this.allTarget.checked = false;\n      this.allTarget.indeterminate = false;\n    }\n    this.#exitAllPages();\n    this.#reportChange(this.#recompute());\n  }\n\n  /**\n   * Enters \"select all across pages\" mode: the count shows `totalCount`, and every\n   * row on this page is checked.\n   *\n   * The mode's claim is that the whole set is selected, so leaving a visible row\n   * unchecked would put the page and the count in open disagreement.\n   */\n  selectAllPages(): void {\n    this.#allPagesMode = true;\n    this.#checkEveryRow();\n    this.#reportChange(this.#recompute());\n  }\n\n  /** Marks every row on this page selected. */\n  #checkEveryRow(): void {\n    for (const item of this.itemTargets) item.checked = true;\n  }\n\n  /** Mirrors the select-all box to every row, then recomputes. */\n  #applyAll(): void {\n    if (!this.hasAllTarget) return;\n    const { checked } = this.allTarget;\n    for (const item of this.itemTargets) item.checked = checked;\n    this.#exitAllPages();\n    this.#reportChange(this.#recompute());\n  }\n\n  #exitAllPages(): void {\n    this.#allPagesMode = false;\n  }\n\n  /** Repairs the derived state after the page moved rows or a render input. */\n  #reconcileNow(): void {\n    // A row that arrives while the whole set is selected is one of the rows the\n    // mode already claims, so it lands checked instead of contradicting the count.\n    if (this.#allPagesMode) this.#checkEveryRow();\n    const detail = this.#recompute();\n    if (!detail) return;\n    this.dispatch(\"reconcile\", { detail });\n    this.#announce(detail);\n  }\n\n  /** Reports a selection the user moved. */\n  #reportChange(detail: SelectionDetail | null): void {\n    if (!detail) return;\n    this.dispatch(\"change\", { detail });\n    this.#announce(detail);\n  }\n\n  /** Hands the count to the shared announcer, worded by the consumer. */\n  #announce(detail: SelectionDetail): void {\n    announce(fillTemplate(this.announceTextValue, { count: detail.count }));\n  }\n\n  /** The declared `totalCount`, or the default `0` in place of a non-finite one. */\n  get #totalCount(): number {\n    const declared = this.totalCountValue;\n    return Number.isFinite(declared) ? declared : 0;\n  }\n\n  /**\n   * Recomputes the count, the select-all checked/indeterminate state, and the bar\n   * visibility from the current DOM. Returns the figures when the emitted count or\n   * all-pages flag actually moved, and `null` when they did not.\n   *\n   * @stimeoRenderRoot\n   */\n  #recompute(): SelectionDetail | null {\n    const items = this.itemTargets;\n    const total = items.length;\n    const checked = items.filter((item) => item.checked).length;\n    const allPages = this.#allPagesMode;\n\n    if (this.hasAllTarget) {\n      this.allTarget.checked = total > 0 && checked === total;\n      this.allTarget.indeterminate = checked > 0 && checked < total;\n    }\n\n    const count = allPages ? this.#totalCount : checked;\n    const show = allPages || checked > 0;\n\n    if (this.hasBarTarget) {\n      // Hand the Tab position over before the bar leaves, or focus falls to the\n      // document and the keyboard user loses their place.\n      if (!show && this.hasAllTarget && this.barTarget.contains(document.activeElement)) {\n        this.allTarget.focus();\n      }\n      this.barTarget.hidden = !show;\n    }\n    if (this.hasCountTarget) this.countTarget.textContent = String(count);\n\n    this.element.setAttribute(\"data-selected-count\", String(checked));\n    if (allPages) this.element.setAttribute(\"data-all-pages\", \"true\");\n    else this.element.removeAttribute(\"data-all-pages\");\n\n    const changed = count !== this.#lastCount || allPages !== this.#lastAllPages;\n    this.#lastCount = count;\n    this.#lastAllPages = allPages;\n    return changed ? { count, allPages } : null;\n  }\n}\n"]}

package/dist/controllers/calendar_controller.d.ts

@@ -7,6 +7,8 @@ import { Controller } from '@hotwired/stimulus';
  *   <div data-controller="stimeo--calendar"
  *        data-stimeo--calendar-month-value="2026-05"
  *        data-stimeo--calendar-selected-value="2026-05-31">
+ *     <input type="hidden" name="on" data-stimeo--calendar-target="field" />
+ *     <input type="hidden" name="month" data-stimeo--calendar-target="monthField" />
  *     <button data-action="click->stimeo--calendar#prev">Previous</button>
  *     <span data-stimeo--calendar-target="label">May 2026</span>
  *     <button data-action="click->stimeo--calendar#next">Next</button>
@@ -23,17 +25,67 @@ import { Controller } from '@hotwired/stimulus';
  *   </div>
  *
  * Implements the WAI-ARIA APG **Date Picker Dialog** grid navigation pattern:
- * - Locale-aware month/year labels using native `Intl.DateTimeFormat`, read from
- *   `<html lang>`; a malformed language tag falls back to English so the grid still paints.
- * - Roving tabindex focus tracking (exactly one focusable day at any time).
+ * - Locale-aware month/year labels using native `Intl.DateTimeFormat`, taken from
+ *   the `locale` Value, else the nearest `lang` up the ancestor chain, else the
+ *   runtime default; a malformed language tag falls back to English so the grid
+ *   still paints.
+ * - Without a `month`, the grid opens on the month of the selected day, else on
+ *   the current month, when an instance first connects, and stays on the month
+ *   it shows until a month step or the page writes `month` — a later connection
+ *   of the same instance, after an in-page move or with the identifier added
+ *   back, keeps it too. Opening on a month writes nothing to `month`.
+ * - Roving tabindex focus tracking (exactly one focusable day at any time). The
+ *   tab stop opens on the selected day, else on today when the shown month
+ *   holds it, else on the 1st of the shown month; a selected day the grid does
+ *   not show leaves it on the 1st.
  * - Full grid keyboard controls (arrows, PageUp/Down, Home/End, Shift+PageUp/Down).
  * - Automatic month wrapping and date clamping for missing dates (e.g. leap years, 31st to 30th).
+ * - `min`, `max` and `weekStart` changed at runtime repaint the month on screen
+ *   once connected, and DOM focus in the grid stays on the day it was on while
+ *   that day is still shown.
+ * - A `month` that moves the painted month — written by application code, a
+ *   morph, or the grid's own month steps — takes DOM focus in the grid to the
+ *   tab stop of the new month. A key that crosses into another month makes the
+ *   day it moved to that tab stop, so focus lands there.
+ * - An `aria-disabled` the consumer wrote on a day stays with that date while
+ *   the grid shows it, in whichever cell a repaint moves the date to.
+ *
+ * `selected` is a request: the grid publishes it as the selection only while
+ * `min` / `max` allow that day. A day outside them is neither `aria-selected`
+ * nor mirrored into `field`, and it comes back once the bounds allow it again;
+ * the Value itself is never rewritten.
  *
  * `monthchange` dispatches `{ month: string }`; `select` dispatches `{ date: string }`.
+ * `reconcile` dispatches `{ date: string }` — the selection now published, empty
+ * when there is none — once per paint in which a change the page made after
+ * connect moved the published selection: `selected` written by application
+ * code or a morph, or `min` / `max` withholding the requested day or giving it
+ * back. A selection the user picks is reported as `select` alone. Connecting,
+ * or connecting again, reports neither `monthchange` nor `reconcile`, whichever
+ * month the grid opens on.
+ *
+ * Two optional fields carry the grid's state into a form, so a server can serve
+ * the days it is showing: `field` mirrors the published selection (`YYYY-MM-DD`,
+ * empty when nothing is selected) and `monthField` the month being painted
+ * (`YYYY-MM`). A move the user made — the previous/next controls, a month
+ * crossing by keyboard, picking a day — emits a native bubbling `change` from
+ * the field that moved, the way a form control does, so `stimeo--auto-submit`
+ * and form-level validation hear it. A repaint driven by the Values, by a
+ * replacement field, or by the initial paint refreshes both mirrors silently,
+ * and so does a move of the selection a change the page made, which `reconcile`
+ * reports even in a paint the user's own move asked for.
+ *
+ * A day `min` / `max` exclude cannot be picked, even before a paint has marked
+ * its cell. A pick is painted — `aria-selected` and both fields — before
+ * anything reports it: each field that moved, then `monthchange` when the paint
+ * moved the month, then `select`. A listener that replaces the selection before
+ * these reports are all out — by picking another day, or with a paint in which
+ * `min` / `max` withhold this one — has the newer selection report itself, and
+ * what is still pending for the replaced pick is not sent.
  *
  * @remarks
- * Behavior only. The controller updates classes, attributes (aria-selected, data-outside, etc.),
- * and text contents dynamically on 42 pre-allocated `day` targets.
+ * Behavior only. The controller updates attributes (`aria-selected`, `data-outside`,
+ * `tabindex`, …) and text content on the 42 pre-allocated `day` targets.
  */
 declare class CalendarController extends Controller<HTMLElement> {
     #private;
@@ -59,34 +111,68 @@ declare class CalendarController extends Controller<HTMLElement> {
             type: NumberConstructor;
             default: number;
         };
+        locale: {
+            type: StringConstructor;
+            default: string;
+        };
     };
     static actions: readonly ["next", "onKeydown", "prev", "selectByClick"];
-    static events: readonly ["monthchange", "select"];
+    static events: readonly ["monthchange", "reconcile", "select"];
     readonly labelTarget: HTMLElement;
     readonly gridTarget: HTMLElement;
     readonly dayTargets: HTMLElement[];
+    readonly fieldTarget: HTMLInputElement;
+    readonly monthFieldTarget: HTMLInputElement;
     readonly hasLabelTarget: boolean;
     readonly hasGridTarget: boolean;
+    readonly hasFieldTarget: boolean;
+    readonly hasMonthFieldTarget: boolean;
     monthValue: string;
     selectedValue: string;
     minValue: string;
     maxValue: string;
     weekStartValue: number;
+    localeValue: string;
     /** The date currently receiving focus in the grid (local time). */
     focusedDate: Date;
     connect(): void;
-    /** Cancels any pending deferred focus so it never fires on a detached element. */
+    /**
+     * Drops a pending repaint and a pending focus move, and stops reporting, so
+     * nothing reaches for a grid that is not connected.
+     */
     disconnect(): void;
     /**
-     * Stimulus lifecycle callback triggered automatically when the monthValue changes.
-     * Forces a re-render of the date grid and updates labels.
+     * Paints the month `month` names, whether application code, a morph or the
+     * grid's own navigation wrote it; focus in the grid follows to the tab stop.
      */
     monthValueChanged(): void;
     /**
-     * Stimulus lifecycle callback triggered automatically when the selectedValue changes.
-     * Re-renders grid cells to update `aria-selected` indicators.
+     * Repaints the label when application code changes `locale` at runtime.
+     *
+     * Stimulus runs this for the initial Value too, before `connect()`. The paint
+     * it triggers is idempotent — the month comes from `month` (or, while that is
+     * still empty, from `focusedDate`) — and a grid that has not connected
+     * reports nothing, so that paint never reports a month.
+     */
+    localeValueChanged(): void;
+    /**
+     * Repaints `aria-selected` and the field when the requested day changes, and
+     * moves the tab stop to the day the grid now publishes. A request `min` /
+     * `max` withhold is not published, so the tab stop stays where it was.
      */
     selectedValueChanged(): void;
+    /** Repaints when `min` changes after connect, so the disabled days and the selection follow. */
+    minValueChanged(): void;
+    /** Repaints when `max` changes after connect, so the disabled days and the selection follow. */
+    maxValueChanged(): void;
+    /**
+     * Lays the grid out again when `weekStart` changes after connect, so every
+     * date moves to the column of its weekday.
+     *
+     * Only the day cells are painted: column headers are author markup, so the
+     * author updates them together with the Value.
+     */
+    weekStartValueChanged(): void;
     /** Navigates to the previous month. */
     prev(event?: Event): void;
     /** Navigates to the next month. */
@@ -95,18 +181,10 @@ declare class CalendarController extends Controller<HTMLElement> {
     selectByClick(event: MouseEvent): void;
     /** Handles grid cell keyboard navigation and triggers selection. */
     onKeydown(event: KeyboardEvent): void;
-    /**
-     * Renders the grid days and updates the month/year label, then reports the
-     * painted month once it differs from the one already announced.
-     *
-     * The report belongs to the paint, not to the `month` Value: the Value is only
-     * one of the things that decide the month on screen. While a malformed `month`
-     * falls back, changing `selected` and selecting a neighbouring month's cell
-     * move the painted month too, and both repaint from here. Reading the report
-     * off the paint keeps the event naming the month the grid shows, in the
-     * `YYYY-MM` the detail contract promises, whichever route repainted.
-     */
-    render(): void;
+    /** Fills a selected-day field inserted or replaced at runtime with the published selection. */
+    fieldTargetConnected(field: HTMLInputElement): void;
+    /** Fills a painted-month field inserted or replaced at runtime. */
+    monthFieldTargetConnected(field: HTMLInputElement): void;
     selectDayElement(dayElement: HTMLElement): void;
 }