stimeo-ui 0.7.0 → 0.9.0

package/CHANGELOG.md

@@ -7,6 +7,155 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 While the version is `0.x`, the public API (the `stimeo--*` data attributes) may
 change between releases.
 
+## [0.9.0] - 2026-08-28
+
+Minor release with no new components. Ten existing ones are reworked —
+bulk-select, clipboard, color-picker, data-grid, editable, filter, masonry, otp,
+reset-before-cache, and resizable — and of those, bulk-select, clipboard,
+data-grid, and editable also changed their markup contracts, so read Removed and
+Changed before upgrading. The Inspector manifest stays on schema v12.
+
+### Removed
+
+- bulk-select: `announce`, and the `aria-live` on the `bar` target that went with
+  it — the count goes through the page's `stimeo--announcer` now.
+- clipboard: the live-region requirement on the `feedback` target. Drop the
+  `role="status"` and `aria-live`; the slot is a plain visible label.
+- editable: the `onBlur` action. Drop `blur->stimeo--editable#onBlur` — the
+  departure is watched on the controller element.
+
+### Added
+
+- bulk-select: `announceText`, carrying `{count}`, and a `reconcile` event.
+- clipboard: `announceCopiedText` and `announceErrorText`. Like `announceText`
+  they default to empty, so seat a `stimeo--announcer` on the page and write the
+  wording you want read.
+- editable: `save` / `cancel` / `revert` actions, and `data-value` on the
+  `display` target for a display that renders the value rather than being it.
+- color-picker: `data-value-text`, an `aria-valuetext` template whose `{value}`
+  carries the channel value, for pages that are not in English.
+- Declarations read once are followed when they change — filter's `match`,
+  masonry's `minColumnWidth` / `gap`, resizable's `min` / `max` — as are targets
+  swapped in later by color-picker, editable, masonry, and resizable, and masonry
+  also relays out when a descendant resource finishes loading.
+
+### Changed
+
+- bulk-select: `selectAllPages` checks the rows on the page too, so a row that
+  arrives while the mode is on lands checked. Hiding the bar hands focus to the
+  select-all box, and a `bar` carrying `role="toolbar"` wants `stimeo--toolbar`
+  alongside it for the arrow keys and the single tab stop.
+- clipboard: `copied` and `error` are transient `data-state` values — a
+  `connect()` that finds either returns to `idle`, and the state is rewound
+  before Turbo caches the page. Any other authored `data-state` is left alone.
+- color-picker: `aria-valuenow` / `aria-valuetext` / `aria-valuemin` /
+  `aria-valuemax` are controller-owned, so the markup supplies `role="slider"`
+  and a name; an omitted range resolves to the channel default (hue `0`–`360`,
+  the rest `0`–`100`). Only a primary-button press drags, and an `alpha` slider
+  is inert unless `alpha` is on.
+- data-grid: a keystroke or click that reached a control inside a cell, and one
+  an IME is composing, belongs to that control — no move, no sort, no selection.
+  The exception is a click on a sortable header's own `<button>`, which needs
+  `tabindex="-1"`; host `gridcell` / `columnheader` on `td` / `th`.
+- editable: the mode is read back from the DOM and the controller writes no ARIA.
+  Focus landing inside the component has not left the edit, so a Save or Cancel
+  button beside the input keeps it open, and the value is trimmed once at the save.
+- reset-before-cache: `data-reset-value` returns a field to what the markup
+  declares — `defaultValue`, `defaultChecked`, the `selected` option — instead of
+  emptying it; a file input empties and `hidden` / `submit` / `reset` / `button` /
+  `image` are left alone.
+- resizable: a separator with no `aria-orientation` reads as `horizontal`, and
+  `toggle` reopens at the position the pane collapsed from. Pointer capture and
+  the drag listeners sit on the `separator` target, not on `event.target` and
+  `document`.
+- masonry: `layout` fires when the result moves, not only on a column count
+  change, and every relayout after the first is deferred to a microtask. otp:
+  `reconcile` reports a move in the pair (joined value, `data-state`).
+- A declaration that cannot be read falls back to its default instead of reaching
+  ARIA or CSS as `NaN` — masonry's `minColumnWidth` / `gap`, resizable's `min` /
+  `max` / `value` / `step`, bulk-select's `totalCount`, and reset-before-cache's
+  `scope`, which no longer aborts the whole sweep.
+- Inspector: clipboard's `feedback` is no longer required, a color-picker
+  `slider` is checked for `role` and a name only, and bulk-select and clipboard
+  join the components that need a `stimeo--announcer`.
+
+### Fixed
+
+- data-grid: `Enter` and `Space` on a `<button>` nested in a cell reach it, so a
+  row-action button is keyboard-reachable, and rows coming and going at runtime
+  re-establish exactly one tab stop. editable: tabbing past a Save or Cancel
+  button no longer strands the editor open, and a display removed mid-edit no
+  longer throws. bulk-select: a nested bulk-select's rows stay out of the outer
+  container's count.
+- clipboard: a copy that resolved after disconnect wrote to the detached element
+  and armed a timer past the teardown, and a repeat inside the feedback window is
+  read out again. In color-picker a drag belongs to the pointer that started it,
+  in masonry an item removed and re-appended in one batch keeps its layout hooks,
+  and in resizable `data-dragging` no longer rides a Turbo snapshot.
+- reset-before-cache: `data-reset-value` wrote an empty string into a checkbox's
+  `value` attribute, and could leave a select with nothing selected at all.
+
+## [0.8.0] - 2026-08-22
+
+Minor release with no new components. Eight existing ones are reworked —
+auto-submit, carousel, currency-input, file-dropzone, input-mask, nested-form,
+otp, and textarea-autosize — and of those, carousel, otp, and file-dropzone also
+changed their markup contracts, so read Removed and Changed before upgrading. The
+Inspector manifest stays on schema v12.
+
+### Removed
+
+- otp: `length` — the number of `field` targets is the passcode length.
+- file-dropzone: the `status` target, `dragLabel`, and the
+  `data-file-dropzone-slot` attributes.
+
+### Added
+
+- `reconcile` on auto-submit, direct-upload, file-dropzone, flash, frame-loading,
+  input-mask, nested-form, otp, spinner, and submit-once — it also reports the
+  state a Turbo rewind discarded, carrying what that component lost
+  (`{ files }`, `{ ids }`, `{ forms }`, `{ removed }`, or `{}`).
+- carousel: `data-state`, `inert` on inactive slides, `prefers-reduced-motion`,
+  and optional pickers. otp: `clear` / `onPointerDown`, and text carrying several
+  characters spread across the following fields. file-dropzone:
+  `allowDuplicates`, a `thumb` target, and the `announce*Text` wording.
+- Characters an IME commits full-width are read as their half-width form in
+  input-mask, otp, and currency-input.
+- Inspector: rules for the reworked markup — carousel's controller-owned ARIA,
+  the `playToggle` an `autoplay` carousel needs, the `prev` / `next` pair, a
+  finite positive `interval`, otp's group and field names, and the parts
+  file-dropzone's item template must contain.
+
+### Changed
+
+- carousel: drop the `data-action` wiring and any authored `aria-pressed` —
+  clicks, picker keys, hover, and focus are delegated, and `aria-pressed` /
+  `aria-disabled` / `aria-live` / `aria-atomic` are controller-owned. Name the
+  toggle with `aria-label`, pair `prev` with `next`, and give an `autoplay`
+  carousel a `playToggle` (WCAG 2.2.2).
+- otp: the root needs `role="group"` and a name, and each `field` its own.
+  `invalid` reports only input that filled no field.
+- file-dropzone: put a `stimeo--announcer` on the page, set the `announce*Text`
+  wording, and use `name` / `thumb` / `remove` targets in the item template with
+  an authored `aria-label`. Validation runs `type` → `size` → `duplicate` →
+  `count`, and `change` precedes `reject`.
+- input-mask: `change` fires only for a user edit; normalization and runtime
+  Value changes report `reconcile`. The manifest reports `tokens` as `String`
+  where it reported `Object`.
+- textarea-autosize: `resize` no longer fires when a connect leaves the height
+  unchanged; width, font, and runtime `minRows` / `maxRows` changes are followed.
+- currency-input keeps what was typed while typing and rounds on blur;
+  nested-form absorbs rows added or removed outside it; auto-submit follows a
+  swapped `form` target.
+
+### Fixed
+
+- carousel: the play toggle stops rotation — the `focusin` before the click no
+  longer makes the press resume instead. otp: a full-width commit into one field
+  fills the following ones. currency-input: a locale with non-Latin digits
+  reparses its own output. nested-form: a discarded-but-visible row's remove
+  button no longer swallows the click.
+
 ## [0.7.0] - 2026-08-16
 
 Minor release reworking the form stack, separator, and scroll-area, with
@@ -634,6 +783,8 @@ Initial public alpha: 101 behavior-only, accessible Stimulus controllers driven
 by `data-*` attributes, shipping no CSS. Published to npm (with provenance) and
 RubyGems.
 
+[0.9.0]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.9.0
+[0.8.0]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.8.0
 [0.7.0]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.7.0
 [0.6.0]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.6.0
 [0.5.0]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.5.0

package/dist/controllers/auto_submit_controller.d.ts

@@ -19,6 +19,8 @@ import { Controller } from '@hotwired/stimulus';
  *   </div>
  *
  * `submit` dispatches `{ trigger }`; `done` dispatches `{ message? }`.
+ * `reconcile` dispatches `{}` when the Turbo cache rewind drops a submission
+ * that was pending or in flight — `done` would claim a response arrived.
  *
  * @remarks
  * Behavior only — it owns *triggering* the submit (debounce + `requestSubmit`),
@@ -28,8 +30,13 @@ import { Controller } from '@hotwired/stimulus';
  * setting `announce` bridges the completion to the shared `stimeo--announcer`
  * as a safety net; apps can also listen for `stimeo--auto-submit:done`
  * and announce richer text themselves. `aria-busy` marks the in-flight window and
- * `data-auto-submit-pending` the debounce window, for consumer CSS. During IME
- * composition it holds the submit until `compositionend` (the confirmed
+ * `data-auto-submit-pending` the debounce window, for consumer CSS; both hooks are
+ * rewound just before Turbo caches the page so they never burn into a snapshot.
+ * The `turbo:submit-end`/composition subscriptions follow the `form` target as it
+ * is added, replaced, or removed at runtime; unbinding a form drops its pending
+ * debounced submit, since that submit described a form that is going away. With
+ * no resolvable form (no target and a non-`<form>` root) the controller is inert.
+ * During IME composition it holds the submit until `compositionend` (the confirmed
  * conversion) so it does not fire on each intermediate keystroke. The debounce
  * timer and the `turbo:submit-end`/composition listeners are torn down on
  * `disconnect()`.
@@ -56,7 +63,7 @@ declare class AutoSubmitController extends Controller<HTMLElement> {
         };
     };
     static actions: readonly ["submit"];
-    static events: readonly ["submit", "done"];
+    static events: readonly ["submit", "done", "reconcile"];
     readonly formTarget: HTMLFormElement;
     readonly hasFormTarget: boolean;
     debounceValue: number;
@@ -65,6 +72,10 @@ declare class AutoSubmitController extends Controller<HTMLElement> {
     messageValue: string;
     connect(): void;
     disconnect(): void;
+    /** Follows a `form` target added (or swapped in) at runtime. */
+    formTargetConnected(): void;
+    /** Follows a `form` target removed (or swapped out) at runtime. */
+    formTargetDisconnected(): void;
     /**
      * Schedules a debounced submit. Wired to `input`/`change`; the `on` value is an
      * allowlist so a configured subset (e.g. only `change`) is honored even when both

package/dist/controllers/auto_submit_controller.js

@@ -2,6 +2,35 @@ import { Controller } from '@hotwired/stimulus';
 
 // src/controllers/auto_submit_controller.ts
 
+// src/utils/before_cache_reset.ts
+var BeforeCacheReset = class _BeforeCacheReset {
+  /** Every subscribed instance, iterated by the one shared document listener. */
+  static #subscribers = /* @__PURE__ */ new Set();
+  /** The shared listener; installed while at least one instance is subscribed. */
+  static #onBeforeCache = () => {
+    for (const subscriber of _BeforeCacheReset.#subscribers) subscriber.#rewind();
+  };
+  #rewind;
+  /** @param rewind - the pass that returns this controller's state to its initial form. */
+  constructor(rewind) {
+    this.#rewind = rewind;
+  }
+  /** Subscribes to `turbo:before-cache`; call from `connect()`. Idempotent. */
+  activate() {
+    const first = _BeforeCacheReset.#subscribers.size === 0;
+    _BeforeCacheReset.#subscribers.add(this);
+    if (first) {
+      document.addEventListener("turbo:before-cache", _BeforeCacheReset.#onBeforeCache);
+    }
+  }
+  /** Unsubscribes; call from `disconnect()`. Safe when never subscribed. */
+  deactivate() {
+    _BeforeCacheReset.#subscribers.delete(this);
+    if (_BeforeCacheReset.#subscribers.size > 0) return;
+    document.removeEventListener("turbo:before-cache", _BeforeCacheReset.#onBeforeCache);
+  }
+};
+
 // src/utils/composition_tracker.ts
 var CompositionTracker = class {
   #observedTargets = /* @__PURE__ */ new Set();
@@ -112,14 +141,18 @@ var AutoSubmitController = class extends Controller {
     message: { type: String, default: "" }
   };
   static actions = ["submit"];
-  static events = ["submit", "done"];
+  static events = ["submit", "done", "reconcile"];
   /** Debounce timer registry; one `clearAll()` in disconnect tears it down. */
   #timers = new SafeTimeout();
   /** Id of the pending debounce timer, so a new keystroke can reset it. */
   #pendingId = 0;
+  /** The form the listeners are attached to; target callbacks rebind it. */
+  #boundForm = null;
+  /** Rewinds the transient state hooks just before Turbo snapshots the page. */
+  #beforeCache = new BeforeCacheReset(() => this.#rewindForCache());
   /** Clears `aria-busy` and emits completion once Turbo finishes the submit. */
   #onSubmitEnd = () => {
-    this.#form.removeAttribute("aria-busy");
+    this.#boundForm?.removeAttribute("aria-busy");
     const message = this.messageValue;
     this.dispatch("done", { detail: { message: message || void 0 } });
     if (this.announceValue && message) {
@@ -133,15 +166,23 @@ var AutoSubmitController = class extends Controller {
     }
   });
   connect() {
-    this.#form.addEventListener("turbo:submit-end", this.#onSubmitEnd);
-    this.#composition.observe(this.#form);
+    this.#beforeCache.activate();
+    this.#bindForm(this.#resolveForm());
   }
   disconnect() {
+    this.#beforeCache.deactivate();
+    this.#bindForm(null);
+    this.#composition.disconnect();
     this.#timers.clearAll();
     this.#pendingId = 0;
-    this.#composition.disconnect();
-    this.#form.removeAttribute("data-auto-submit-pending");
-    this.#form.removeEventListener("turbo:submit-end", this.#onSubmitEnd);
+  }
+  /** Follows a `form` target added (or swapped in) at runtime. */
+  formTargetConnected() {
+    this.#bindForm(this.#resolveForm());
+  }
+  /** Follows a `form` target removed (or swapped out) at runtime. */
+  formTargetDisconnected() {
+    this.#bindForm(this.#resolveForm());
   }
   /**
    * Schedules a debounced submit. Wired to `input`/`change`; the `on` value is an
@@ -155,21 +196,58 @@ var AutoSubmitController = class extends Controller {
   }
   /** Schedules (and coalesces) the debounced submit for the given trigger. */
   #schedule(trigger) {
-    this.#form.setAttribute("data-auto-submit-pending", "true");
-    if (this.#pendingId) this.#timers.clear(this.#pendingId);
+    const form = this.#boundForm;
+    if (!form) return;
+    form.setAttribute("data-auto-submit-pending", "true");
+    this.#cancelPending();
     this.#pendingId = this.#timers.set(() => {
       this.#pendingId = 0;
-      this.#form.removeAttribute("data-auto-submit-pending");
+      form.removeAttribute("data-auto-submit-pending");
       this.dispatch("submit", { detail: { trigger } });
-      if (this.#form.checkValidity()) {
-        this.#form.setAttribute("aria-busy", "true");
+      if (form.checkValidity()) {
+        form.setAttribute("aria-busy", "true");
       }
-      this.#form.requestSubmit();
+      form.requestSubmit();
     }, this.debounceValue);
   }
-  /** Resolves the form element (explicit `form` target, else the controller root). */
-  get #form() {
-    return this.hasFormTarget ? this.formTarget : this.element;
+  /** Cancels the pending debounced submit, if any (`clear` no-ops on unknown ids). */
+  #cancelPending() {
+    this.#timers.clear(this.#pendingId);
+    this.#pendingId = 0;
+  }
+  /**
+   * Replaces the subscribed form symmetrically. The outgoing form loses the
+   * `turbo:submit-end`/composition listeners, its pending hook, and any pending
+   * debounced submit (which described the outgoing form). An in-flight `aria-busy`
+   * is left for `turbo:submit-end` or the pre-cache rewind — removing it here
+   * would wipe a legitimately in-progress submission.
+   */
+  #bindForm(form) {
+    if (form === this.#boundForm) return;
+    const previous = this.#boundForm;
+    if (previous) {
+      this.#cancelPending();
+      previous.removeAttribute("data-auto-submit-pending");
+      previous.removeEventListener("turbo:submit-end", this.#onSubmitEnd);
+      this.#composition.unobserve(previous);
+    }
+    this.#boundForm = form;
+    if (!form) return;
+    form.addEventListener("turbo:submit-end", this.#onSubmitEnd);
+    this.#composition.observe(form);
+  }
+  /** Resolves the form: the explicit `form` target, else a `<form>` root, else null. */
+  #resolveForm() {
+    if (this.hasFormTarget) return this.formTarget;
+    return this.element instanceof HTMLFormElement ? this.element : null;
+  }
+  /** Returns the transient state hooks to their initial (absent) state. */
+  #rewindForCache() {
+    const inProgress = this.#pendingId !== 0 || this.#boundForm?.hasAttribute("aria-busy") === true;
+    this.#cancelPending();
+    this.#boundForm?.removeAttribute("data-auto-submit-pending");
+    this.#boundForm?.removeAttribute("aria-busy");
+    if (inProgress) this.dispatch("reconcile", { detail: {} });
   }
   /** Whether `type` is one of the whitespace-separated event types in `on`. */
   #triggers(type) {

package/dist/controllers/auto_submit_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/composition_tracker.ts","../../src/utils/safe_timeout.ts","../../src/controllers/auto_submit_controller.ts"],"names":[],"mappings":"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","file":"auto_submit_controller.js","sourcesContent":["/** Minimal event shape carrying the platform's per-event composition signal. */\nexport interface CompositionSignal {\n  readonly isComposing?: boolean;\n}\n\n/** Hooks that keep component-specific work outside {@link CompositionTracker}. */\nexport interface CompositionTrackerOptions {\n  /** Runs after lifecycle state is set for a `compositionstart` event. */\n  readonly onStart?: (event: Event) => void;\n  /** Runs after lifecycle state is cleared for a `compositionend` event. */\n  readonly onEnd?: (event: Event) => void;\n}\n\n/**\n * Owns IME composition listeners and transient state for one or more event targets.\n *\n * Some browsers omit `KeyboardEvent.isComposing` on the keydown that confirms a\n * conversion. Tracking `compositionstart` through `compositionend` supplies the\n * missing lifecycle signal without relying on deprecated numeric key codes.\n * Component policy stays with the consumer: filtering, validation, and submission\n * belong in the optional {@link CompositionTrackerOptions.onEnd} callback.\n *\n * @example\n * ```ts\n * #composition = new CompositionTracker({ onEnd: () => this.filter() });\n *\n * connect(): void {\n *   this.#composition.observe(this.inputTarget);\n * }\n *\n * disconnect(): void {\n *   this.#composition.disconnect();\n * }\n *\n * onKeydown(event: KeyboardEvent): void {\n *   if (this.#composition.isComposing(event)) return;\n * }\n * ```\n */\nexport class CompositionTracker {\n  readonly #observedTargets = new Set<EventTarget>();\n  readonly #activeTargets = new Set<EventTarget>();\n  readonly #onStart: ((event: Event) => void) | undefined;\n  readonly #onEnd: ((event: Event) => void) | undefined;\n\n  constructor(options: CompositionTrackerOptions = {}) {\n    this.#onStart = options.onStart;\n    this.#onEnd = options.onEnd;\n  }\n\n  /** Starts lifecycle tracking for `target`; repeated calls are idempotent. */\n  observe(target: EventTarget): void {\n    if (this.#observedTargets.has(target)) return;\n    target.addEventListener(\"compositionstart\", this.#handleStart);\n    target.addEventListener(\"compositionend\", this.#handleEnd);\n    this.#observedTargets.add(target);\n  }\n\n  /** Stops tracking one target and clears any active composition it owned. */\n  unobserve(target: EventTarget): void {\n    if (!this.#observedTargets.delete(target)) return;\n    target.removeEventListener(\"compositionstart\", this.#handleStart);\n    target.removeEventListener(\"compositionend\", this.#handleEnd);\n    this.#activeTargets.delete(target);\n  }\n\n  /** Releases every listener and clears state so reconnect starts cleanly. */\n  disconnect(): void {\n    for (const target of this.#observedTargets) {\n      target.removeEventListener(\"compositionstart\", this.#handleStart);\n      target.removeEventListener(\"compositionend\", this.#handleEnd);\n    }\n    this.#observedTargets.clear();\n    this.#activeTargets.clear();\n  }\n\n  /** True when lifecycle tracking or the current event reports composition. */\n  isComposing(event?: CompositionSignal): boolean {\n    return this.#activeTargets.size > 0 || event?.isComposing === true;\n  }\n\n  readonly #handleStart = (event: Event): void => {\n    if (event.currentTarget) this.#activeTargets.add(event.currentTarget);\n    this.#onStart?.(event);\n  };\n\n  readonly #handleEnd = (event: Event): void => {\n    if (event.currentTarget) this.#activeTargets.delete(event.currentTarget);\n    this.#onEnd?.(event);\n  };\n}\n","/**\n * Self-cleaning timer registries shared by Stimeo controllers.\n *\n * Stimulus controllers frequently schedule `setTimeout` / `setInterval` work\n * (auto-dismiss, debouncing, polling). When the element leaves the DOM — a\n * Turbo Drive navigation, a Turbo Stream replacement, or any `disconnect()` —\n * orphaned timers keep firing against a detached controller, leaking memory and\n * mutating stale state. {@link SafeTimeout} and {@link SafeInterval} track every\n * timer they create so a single {@link TimerRegistry.clearAll | clearAll()} call\n * in `disconnect()` tears them all down.\n *\n * These are intentionally low-level primitives: they own *registration and\n * cleanup only*. Higher-level policy (pause/resume, remaining-time accounting)\n * stays in the individual controllers so per-widget semantics are not flattened\n * into a lowest-common-denominator helper.\n */\n\n/**\n * Shared registry bookkeeping for the timeout/interval variants.\n *\n * Subclasses provide the scheduling primitive ({@link schedule}) and its matching\n * canceller ({@link cancel}); this base owns the set of live ids plus the\n * per-id and bulk teardown shared by both.\n */\nabstract class TimerRegistry {\n  /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */\n  protected readonly ids = new Set<number>();\n\n  /** Schedules the underlying platform timer and returns its id. */\n  protected abstract schedule(callback: () => void, delay: number): number;\n\n  /** Cancels the underlying platform timer for `id`. */\n  protected abstract cancel(id: number): void;\n\n  /**\n   * Cancels a single tracked timer.\n   *\n   * No-ops if the id is unknown (already cleared, fired, or never owned by this\n   * registry), so callers can clear defensively without guarding.\n   */\n  clear(id: number): void {\n    if (this.ids.delete(id)) {\n      this.cancel(id);\n    }\n  }\n\n  /**\n   * Cancels every tracked timer. Call this from a controller's `disconnect()`\n   * to guarantee no timer outlives the element.\n   */\n  clearAll(): void {\n    for (const id of this.ids) {\n      this.cancel(id);\n    }\n    this.ids.clear();\n  }\n\n  /** Number of timers currently tracked (pending). */\n  get size(): number {\n    return this.ids.size;\n  }\n}\n\n/**\n * `setTimeout` wrapper that auto-forgets each timer once it fires and supports\n * bulk teardown on disconnect.\n *\n * @example\n * ```ts\n * #timers = new SafeTimeout();\n *\n * connect() {\n *   this.#timers.set(() => this.dismiss(), 5000);\n * }\n *\n * disconnect() {\n *   this.#timers.clearAll();\n * }\n * ```\n */\nexport class SafeTimeout extends TimerRegistry {\n  /**\n   * Schedules `callback` after `delay` ms and returns the timer id.\n   *\n   * The id is removed from the registry automatically when the timeout fires,\n   * so {@link TimerRegistry.size | size} reflects only still-pending timers.\n   */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(() => {\n      this.ids.delete(id);\n      callback();\n    }, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setTimeout(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearTimeout(id);\n  }\n}\n\n/**\n * `setInterval` wrapper that tracks every interval for bulk teardown on\n * disconnect. Unlike {@link SafeTimeout}, intervals are retained until they are\n * explicitly cleared because they fire repeatedly.\n *\n * @example\n * ```ts\n * #intervals = new SafeInterval();\n *\n * connect() {\n *   this.#intervals.set(() => this.tick(), 1000);\n * }\n *\n * disconnect() {\n *   this.#intervals.clearAll();\n * }\n * ```\n */\nexport class SafeInterval extends TimerRegistry {\n  /** Schedules a repeating `callback` every `delay` ms and returns the timer id. */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(callback, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setInterval(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearInterval(id);\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { CompositionTracker } from \"../utils/composition_tracker\";\nimport { SafeTimeout } from \"../utils/safe_timeout\";\n\n/**\n * Headless **debounced auto-submit** for forms (no dedicated APG pattern). Submits\n * the form a configurable delay after `input`/`change`, so Rails search/filter\n * forms refresh via Turbo without a submit button.\n *\n * Markup contract (identifier: `stimeo--auto-submit`):\n *   <form data-controller=\"stimeo--auto-submit\"\n *         data-stimeo--auto-submit-debounce-value=\"300\"\n *         data-action=\"input->stimeo--auto-submit#submit\n *                      change->stimeo--auto-submit#submit\">\n *     <input type=\"search\" name=\"q\">\n *   </form>\n *\n *   <!-- Or with the form as a target nested under the controller element: -->\n *   <div data-controller=\"stimeo--auto-submit\">\n *     <form data-stimeo--auto-submit-target=\"form\"> … </form>\n *   </div>\n *\n * `submit` dispatches `{ trigger }`; `done` dispatches `{ message? }`.\n *\n * @remarks\n * Behavior only — it owns *triggering* the submit (debounce + `requestSubmit`),\n * never the submit itself (Turbo / native form submission) or validation. It\n * **never moves focus** (WCAG 2.2 3.2.2 / 4.1.3): auto-submitting must not yank the\n * caret out of the field. While a result swap is silent for screen-reader users,\n * setting `announce` bridges the completion to the shared `stimeo--announcer`\n * as a safety net; apps can also listen for `stimeo--auto-submit:done`\n * and announce richer text themselves. `aria-busy` marks the in-flight window and\n * `data-auto-submit-pending` the debounce window, for consumer CSS. During IME\n * composition it holds the submit until `compositionend` (the confirmed\n * conversion) so it does not fire on each intermediate keystroke. The debounce\n * timer and the `turbo:submit-end`/composition listeners are torn down on\n * `disconnect()`.\n */\nexport class AutoSubmitController extends Controller<HTMLElement> {\n  static override targets = [\"form\"];\n  static override values = {\n    debounce: { type: Number, default: 300 },\n    on: { type: String, default: \"input change\" },\n    announce: { type: Boolean, default: false },\n    message: { type: String, default: \"\" },\n  };\n  static actions = [\"submit\"] as const;\n  static events = [\"submit\", \"done\"] as const;\n\n  declare readonly formTarget: HTMLFormElement;\n  declare readonly hasFormTarget: boolean;\n\n  declare debounceValue: number;\n  declare onValue: string;\n  declare announceValue: boolean;\n  declare messageValue: string;\n\n  /** Debounce timer registry; one `clearAll()` in disconnect tears it down. */\n  readonly #timers = new SafeTimeout();\n  /** Id of the pending debounce timer, so a new keystroke can reset it. */\n  #pendingId = 0;\n\n  /** Clears `aria-busy` and emits completion once Turbo finishes the submit. */\n  readonly #onSubmitEnd = (): void => {\n    this.#form.removeAttribute(\"aria-busy\");\n    const message = this.messageValue;\n    this.dispatch(\"done\", { detail: { message: message || undefined } });\n    // Bridge the silent result swap to the shared Announcer so SR users hear it.\n    if (this.announceValue && message) {\n      window.dispatchEvent(new CustomEvent(\"stimeo--announcer:announce\", { detail: { message } }));\n    }\n  };\n\n  /** Owns delegated IME lifecycle state and submits confirmed input text. */\n  readonly #composition = new CompositionTracker({\n    onEnd: (event) => {\n      if (this.#triggers(\"input\")) this.#schedule((event.target as HTMLElement | null) ?? null);\n    },\n  });\n\n  override connect(): void {\n    this.#form.addEventListener(\"turbo:submit-end\", this.#onSubmitEnd);\n    this.#composition.observe(this.#form);\n  }\n\n  override disconnect(): void {\n    this.#timers.clearAll();\n    this.#pendingId = 0;\n    this.#composition.disconnect();\n    this.#form.removeAttribute(\"data-auto-submit-pending\");\n    this.#form.removeEventListener(\"turbo:submit-end\", this.#onSubmitEnd);\n  }\n\n  /**\n   * Schedules a debounced submit. Wired to `input`/`change`; the `on` value is an\n   * allowlist so a configured subset (e.g. only `change`) is honored even when both\n   * are bound in markup. Coalesces rapid events into a single `requestSubmit`.\n   */\n  submit(event: Event): void {\n    if (!this.#triggers(event.type)) return;\n    // Ignore `input` events fired mid-IME-composition (e.g. typing kana before the\n    // Japanese conversion is confirmed); the confirmed text submits on\n    // `compositionend` and the browser's final post-composition `input`.\n    if (event.type === \"input\" && this.#composition.isComposing(event as InputEvent)) return;\n    this.#schedule((event.target as HTMLElement | null) ?? null);\n  }\n\n  /** Schedules (and coalesces) the debounced submit for the given trigger. */\n  #schedule(trigger: HTMLElement | null): void {\n    this.#form.setAttribute(\"data-auto-submit-pending\", \"true\");\n    if (this.#pendingId) this.#timers.clear(this.#pendingId);\n\n    this.#pendingId = this.#timers.set(() => {\n      this.#pendingId = 0;\n      this.#form.removeAttribute(\"data-auto-submit-pending\");\n      this.dispatch(\"submit\", { detail: { trigger } });\n      // `requestSubmit()` runs native constraint validation. If the form is\n      // invalid the actual submit never happens — the browser blocks it (or, when\n      // a `stimeo--form-validation` set `novalidate`, that controller cancels the\n      // submit) — so no `turbo:submit-end` arrives to clear `aria-busy`. Only mark\n      // the form busy when the submit will really proceed; still call\n      // `requestSubmit()` either way so the validation surfaces to the user.\n      if (this.#form.checkValidity()) {\n        this.#form.setAttribute(\"aria-busy\", \"true\");\n      }\n      this.#form.requestSubmit();\n    }, this.debounceValue);\n  }\n\n  /** Resolves the form element (explicit `form` target, else the controller root). */\n  get #form(): HTMLFormElement {\n    return this.hasFormTarget ? this.formTarget : (this.element as HTMLFormElement);\n  }\n\n  /** Whether `type` is one of the whitespace-separated event types in `on`. */\n  #triggers(type: string): boolean {\n    return this.onValue.split(/\\s+/).filter(Boolean).includes(type);\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/before_cache_reset.ts","../../src/utils/composition_tracker.ts","../../src/utils/safe_timeout.ts","../../src/controllers/auto_submit_controller.ts"],"names":[],"mappings":"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","file":"auto_submit_controller.js","sourcesContent":["/**\n * Runs a controller's \"return to the initial state\" pass just before Turbo\n * caches the page.\n *\n * **`disconnect()` cannot do this job, for two independent reasons.** Turbo\n * queues the clone from this event rather than taking it here, and the body swap\n * that runs the controller's `disconnect()` is queued separately — so which of\n * the two lands first is not something a controller can rely on, and a rewind\n * written in `disconnect()` may reach only the DOM being thrown away. In the\n * other direction, `disconnect()` also fires on an in-page move (Stimulus tears\n * down and reconnects the same element), where rewinding would wipe a\n * legitimately in-progress interaction — a spinner mid-load would vanish. One\n * timing is unreliable, the other is too eager; `turbo:before-cache` is the only\n * point that is exactly \"the page is about to be frozen\".\n *\n * Scope is the subscription only: registering on `activate()`, unregistering on\n * `deactivate()`, and one shared document listener no matter how many instances\n * are live. *What* to return to its initial state — which `data-state`, which\n * `hidden`, which `aria-busy` — stays in the controller, because no two\n * consumers answer it the same way (the `MicrotaskCoalescer` split).\n *\n * **Rewind state, not appearance.** The pass writes attributes the controller\n * itself owns; the visual result of those attributes is the consumer's CSS, and\n * a library that reached for style or class names would be guessing at markup\n * it does not own.\n *\n * Both entry points are idempotent, so the lifecycle hooks can call them\n * unconditionally: a second `activate()` does not double-subscribe and does not\n * make the callback run twice, and `deactivate()` on an instance that never\n * subscribed is a no-op.\n *\n * This file's own doc block is dropped from `dist`, but every member comment is\n * inlined into each consumer entry (`tsup` builds with `splitting: false`), so\n * rationale belongs here and only the contract belongs on the members.\n *\n * @example\n * ```ts\n * readonly #beforeCache = new BeforeCacheReset(() => this.#rewind());\n *\n * connect()    { this.#beforeCache.activate(); }\n * disconnect() { this.#beforeCache.deactivate(); }\n * ```\n */\nexport class BeforeCacheReset {\n  /** Every subscribed instance, iterated by the one shared document listener. */\n  static readonly #subscribers = new Set<BeforeCacheReset>();\n\n  /** The shared listener; installed while at least one instance is subscribed. */\n  static readonly #onBeforeCache = (): void => {\n    for (const subscriber of BeforeCacheReset.#subscribers) subscriber.#rewind();\n  };\n\n  readonly #rewind: () => void;\n\n  /** @param rewind - the pass that returns this controller's state to its initial form. */\n  constructor(rewind: () => void) {\n    this.#rewind = rewind;\n  }\n\n  /** Subscribes to `turbo:before-cache`; call from `connect()`. Idempotent. */\n  activate(): void {\n    const first = BeforeCacheReset.#subscribers.size === 0;\n    BeforeCacheReset.#subscribers.add(this);\n    if (first) {\n      document.addEventListener(\"turbo:before-cache\", BeforeCacheReset.#onBeforeCache);\n    }\n  }\n\n  /** Unsubscribes; call from `disconnect()`. Safe when never subscribed. */\n  deactivate(): void {\n    BeforeCacheReset.#subscribers.delete(this);\n    if (BeforeCacheReset.#subscribers.size > 0) return;\n    document.removeEventListener(\"turbo:before-cache\", BeforeCacheReset.#onBeforeCache);\n  }\n}\n","/** Minimal event shape carrying the platform's per-event composition signal. */\nexport interface CompositionSignal {\n  readonly isComposing?: boolean;\n}\n\n/** Hooks that keep component-specific work outside {@link CompositionTracker}. */\nexport interface CompositionTrackerOptions {\n  /** Runs after lifecycle state is set for a `compositionstart` event. */\n  readonly onStart?: (event: Event) => void;\n  /** Runs after lifecycle state is cleared for a `compositionend` event. */\n  readonly onEnd?: (event: Event) => void;\n}\n\n/**\n * Owns IME composition listeners and transient state for one or more event targets.\n *\n * Some browsers omit `KeyboardEvent.isComposing` on the keydown that confirms a\n * conversion. Tracking `compositionstart` through `compositionend` supplies the\n * missing lifecycle signal without relying on deprecated numeric key codes.\n * Component policy stays with the consumer: filtering, validation, and submission\n * belong in the optional {@link CompositionTrackerOptions.onEnd} callback.\n *\n * @example\n * ```ts\n * #composition = new CompositionTracker({ onEnd: () => this.filter() });\n *\n * connect(): void {\n *   this.#composition.observe(this.inputTarget);\n * }\n *\n * disconnect(): void {\n *   this.#composition.disconnect();\n * }\n *\n * onKeydown(event: KeyboardEvent): void {\n *   if (this.#composition.isComposing(event)) return;\n * }\n * ```\n */\nexport class CompositionTracker {\n  readonly #observedTargets = new Set<EventTarget>();\n  readonly #activeTargets = new Set<EventTarget>();\n  readonly #onStart: ((event: Event) => void) | undefined;\n  readonly #onEnd: ((event: Event) => void) | undefined;\n\n  constructor(options: CompositionTrackerOptions = {}) {\n    this.#onStart = options.onStart;\n    this.#onEnd = options.onEnd;\n  }\n\n  /** Starts lifecycle tracking for `target`; repeated calls are idempotent. */\n  observe(target: EventTarget): void {\n    if (this.#observedTargets.has(target)) return;\n    target.addEventListener(\"compositionstart\", this.#handleStart);\n    target.addEventListener(\"compositionend\", this.#handleEnd);\n    this.#observedTargets.add(target);\n  }\n\n  /** Stops tracking one target and clears any active composition it owned. */\n  unobserve(target: EventTarget): void {\n    if (!this.#observedTargets.delete(target)) return;\n    target.removeEventListener(\"compositionstart\", this.#handleStart);\n    target.removeEventListener(\"compositionend\", this.#handleEnd);\n    this.#activeTargets.delete(target);\n  }\n\n  /** Releases every listener and clears state so reconnect starts cleanly. */\n  disconnect(): void {\n    for (const target of this.#observedTargets) {\n      target.removeEventListener(\"compositionstart\", this.#handleStart);\n      target.removeEventListener(\"compositionend\", this.#handleEnd);\n    }\n    this.#observedTargets.clear();\n    this.#activeTargets.clear();\n  }\n\n  /** True when lifecycle tracking or the current event reports composition. */\n  isComposing(event?: CompositionSignal): boolean {\n    return this.#activeTargets.size > 0 || event?.isComposing === true;\n  }\n\n  readonly #handleStart = (event: Event): void => {\n    if (event.currentTarget) this.#activeTargets.add(event.currentTarget);\n    this.#onStart?.(event);\n  };\n\n  readonly #handleEnd = (event: Event): void => {\n    if (event.currentTarget) this.#activeTargets.delete(event.currentTarget);\n    this.#onEnd?.(event);\n  };\n}\n","/**\n * Self-cleaning timer registries shared by Stimeo controllers.\n *\n * Stimulus controllers frequently schedule `setTimeout` / `setInterval` work\n * (auto-dismiss, debouncing, polling). When the element leaves the DOM — a\n * Turbo Drive navigation, a Turbo Stream replacement, or any `disconnect()` —\n * orphaned timers keep firing against a detached controller, leaking memory and\n * mutating stale state. {@link SafeTimeout} and {@link SafeInterval} track every\n * timer they create so a single {@link TimerRegistry.clearAll | clearAll()} call\n * in `disconnect()` tears them all down.\n *\n * These are intentionally low-level primitives: they own *registration and\n * cleanup only*. Higher-level policy (pause/resume, remaining-time accounting)\n * stays in the individual controllers so per-widget semantics are not flattened\n * into a lowest-common-denominator helper.\n */\n\n/**\n * Shared registry bookkeeping for the timeout/interval variants.\n *\n * Subclasses provide the scheduling primitive ({@link schedule}) and its matching\n * canceller ({@link cancel}); this base owns the set of live ids plus the\n * per-id and bulk teardown shared by both.\n */\nabstract class TimerRegistry {\n  /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */\n  protected readonly ids = new Set<number>();\n\n  /** Schedules the underlying platform timer and returns its id. */\n  protected abstract schedule(callback: () => void, delay: number): number;\n\n  /** Cancels the underlying platform timer for `id`. */\n  protected abstract cancel(id: number): void;\n\n  /**\n   * Cancels a single tracked timer.\n   *\n   * No-ops if the id is unknown (already cleared, fired, or never owned by this\n   * registry), so callers can clear defensively without guarding.\n   */\n  clear(id: number): void {\n    if (this.ids.delete(id)) {\n      this.cancel(id);\n    }\n  }\n\n  /**\n   * Cancels every tracked timer. Call this from a controller's `disconnect()`\n   * to guarantee no timer outlives the element.\n   */\n  clearAll(): void {\n    for (const id of this.ids) {\n      this.cancel(id);\n    }\n    this.ids.clear();\n  }\n\n  /** Number of timers currently tracked (pending). */\n  get size(): number {\n    return this.ids.size;\n  }\n}\n\n/**\n * `setTimeout` wrapper that auto-forgets each timer once it fires and supports\n * bulk teardown on disconnect.\n *\n * @example\n * ```ts\n * #timers = new SafeTimeout();\n *\n * connect() {\n *   this.#timers.set(() => this.dismiss(), 5000);\n * }\n *\n * disconnect() {\n *   this.#timers.clearAll();\n * }\n * ```\n */\nexport class SafeTimeout extends TimerRegistry {\n  /**\n   * Schedules `callback` after `delay` ms and returns the timer id.\n   *\n   * The id is removed from the registry automatically when the timeout fires,\n   * so {@link TimerRegistry.size | size} reflects only still-pending timers.\n   */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(() => {\n      this.ids.delete(id);\n      callback();\n    }, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setTimeout(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearTimeout(id);\n  }\n}\n\n/**\n * `setInterval` wrapper that tracks every interval for bulk teardown on\n * disconnect. Unlike {@link SafeTimeout}, intervals are retained until they are\n * explicitly cleared because they fire repeatedly.\n *\n * @example\n * ```ts\n * #intervals = new SafeInterval();\n *\n * connect() {\n *   this.#intervals.set(() => this.tick(), 1000);\n * }\n *\n * disconnect() {\n *   this.#intervals.clearAll();\n * }\n * ```\n */\nexport class SafeInterval extends TimerRegistry {\n  /** Schedules a repeating `callback` every `delay` ms and returns the timer id. */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(callback, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setInterval(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearInterval(id);\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { BeforeCacheReset } from \"../utils/before_cache_reset\";\nimport { CompositionTracker } from \"../utils/composition_tracker\";\nimport { SafeTimeout } from \"../utils/safe_timeout\";\n\n/**\n * Headless **debounced auto-submit** for forms (no dedicated APG pattern). Submits\n * the form a configurable delay after `input`/`change`, so Rails search/filter\n * forms refresh via Turbo without a submit button.\n *\n * Markup contract (identifier: `stimeo--auto-submit`):\n *   <form data-controller=\"stimeo--auto-submit\"\n *         data-stimeo--auto-submit-debounce-value=\"300\"\n *         data-action=\"input->stimeo--auto-submit#submit\n *                      change->stimeo--auto-submit#submit\">\n *     <input type=\"search\" name=\"q\">\n *   </form>\n *\n *   <!-- Or with the form as a target nested under the controller element: -->\n *   <div data-controller=\"stimeo--auto-submit\">\n *     <form data-stimeo--auto-submit-target=\"form\"> … </form>\n *   </div>\n *\n * `submit` dispatches `{ trigger }`; `done` dispatches `{ message? }`.\n * `reconcile` dispatches `{}` when the Turbo cache rewind drops a submission\n * that was pending or in flight — `done` would claim a response arrived.\n *\n * @remarks\n * Behavior only — it owns *triggering* the submit (debounce + `requestSubmit`),\n * never the submit itself (Turbo / native form submission) or validation. It\n * **never moves focus** (WCAG 2.2 3.2.2 / 4.1.3): auto-submitting must not yank the\n * caret out of the field. While a result swap is silent for screen-reader users,\n * setting `announce` bridges the completion to the shared `stimeo--announcer`\n * as a safety net; apps can also listen for `stimeo--auto-submit:done`\n * and announce richer text themselves. `aria-busy` marks the in-flight window and\n * `data-auto-submit-pending` the debounce window, for consumer CSS; both hooks are\n * rewound just before Turbo caches the page so they never burn into a snapshot.\n * The `turbo:submit-end`/composition subscriptions follow the `form` target as it\n * is added, replaced, or removed at runtime; unbinding a form drops its pending\n * debounced submit, since that submit described a form that is going away. With\n * no resolvable form (no target and a non-`<form>` root) the controller is inert.\n * During IME composition it holds the submit until `compositionend` (the confirmed\n * conversion) so it does not fire on each intermediate keystroke. The debounce\n * timer and the `turbo:submit-end`/composition listeners are torn down on\n * `disconnect()`.\n */\nexport class AutoSubmitController extends Controller<HTMLElement> {\n  static override targets = [\"form\"];\n  static override values = {\n    debounce: { type: Number, default: 300 },\n    on: { type: String, default: \"input change\" },\n    announce: { type: Boolean, default: false },\n    message: { type: String, default: \"\" },\n  };\n  static actions = [\"submit\"] as const;\n  static events = [\"submit\", \"done\", \"reconcile\"] as const;\n\n  declare readonly formTarget: HTMLFormElement;\n  declare readonly hasFormTarget: boolean;\n\n  declare debounceValue: number;\n  declare onValue: string;\n  declare announceValue: boolean;\n  declare messageValue: string;\n\n  /** Debounce timer registry; one `clearAll()` in disconnect tears it down. */\n  readonly #timers = new SafeTimeout();\n  /** Id of the pending debounce timer, so a new keystroke can reset it. */\n  #pendingId = 0;\n  /** The form the listeners are attached to; target callbacks rebind it. */\n  #boundForm: HTMLFormElement | null = null;\n  /** Rewinds the transient state hooks just before Turbo snapshots the page. */\n  readonly #beforeCache = new BeforeCacheReset(() => this.#rewindForCache());\n\n  /** Clears `aria-busy` and emits completion once Turbo finishes the submit. */\n  readonly #onSubmitEnd = (): void => {\n    this.#boundForm?.removeAttribute(\"aria-busy\");\n    const message = this.messageValue;\n    this.dispatch(\"done\", { detail: { message: message || undefined } });\n    // Bridge the silent result swap to the shared Announcer so SR users hear it.\n    if (this.announceValue && message) {\n      window.dispatchEvent(new CustomEvent(\"stimeo--announcer:announce\", { detail: { message } }));\n    }\n  };\n\n  /** Owns delegated IME lifecycle state and submits confirmed input text. */\n  readonly #composition = new CompositionTracker({\n    onEnd: (event) => {\n      if (this.#triggers(\"input\")) this.#schedule((event.target as HTMLElement | null) ?? null);\n    },\n  });\n\n  override connect(): void {\n    this.#beforeCache.activate();\n    this.#bindForm(this.#resolveForm());\n  }\n\n  override disconnect(): void {\n    this.#beforeCache.deactivate();\n    this.#bindForm(null);\n    this.#composition.disconnect();\n    this.#timers.clearAll();\n    this.#pendingId = 0;\n  }\n\n  /** Follows a `form` target added (or swapped in) at runtime. */\n  formTargetConnected(): void {\n    this.#bindForm(this.#resolveForm());\n  }\n\n  /** Follows a `form` target removed (or swapped out) at runtime. */\n  formTargetDisconnected(): void {\n    this.#bindForm(this.#resolveForm());\n  }\n\n  /**\n   * Schedules a debounced submit. Wired to `input`/`change`; the `on` value is an\n   * allowlist so a configured subset (e.g. only `change`) is honored even when both\n   * are bound in markup. Coalesces rapid events into a single `requestSubmit`.\n   */\n  submit(event: Event): void {\n    if (!this.#triggers(event.type)) return;\n    // Ignore `input` events fired mid-IME-composition (e.g. typing kana before the\n    // Japanese conversion is confirmed); the confirmed text submits on\n    // `compositionend` and the browser's final post-composition `input`.\n    if (event.type === \"input\" && this.#composition.isComposing(event as InputEvent)) return;\n    this.#schedule((event.target as HTMLElement | null) ?? null);\n  }\n\n  /** Schedules (and coalesces) the debounced submit for the given trigger. */\n  #schedule(trigger: HTMLElement | null): void {\n    const form = this.#boundForm;\n    if (!form) return;\n    form.setAttribute(\"data-auto-submit-pending\", \"true\");\n    this.#cancelPending();\n\n    this.#pendingId = this.#timers.set(() => {\n      this.#pendingId = 0;\n      form.removeAttribute(\"data-auto-submit-pending\");\n      this.dispatch(\"submit\", { detail: { trigger } });\n      // `requestSubmit()` runs native constraint validation. If the form is\n      // invalid the actual submit never happens — the browser blocks it (or, when\n      // a `stimeo--form-validation` set `novalidate`, that controller cancels the\n      // submit) — so no `turbo:submit-end` arrives to clear `aria-busy`. Only mark\n      // the form busy when the submit will really proceed; still call\n      // `requestSubmit()` either way so the validation surfaces to the user.\n      if (form.checkValidity()) {\n        form.setAttribute(\"aria-busy\", \"true\");\n      }\n      form.requestSubmit();\n    }, this.debounceValue);\n  }\n\n  /** Cancels the pending debounced submit, if any (`clear` no-ops on unknown ids). */\n  #cancelPending(): void {\n    this.#timers.clear(this.#pendingId);\n    this.#pendingId = 0;\n  }\n\n  /**\n   * Replaces the subscribed form symmetrically. The outgoing form loses the\n   * `turbo:submit-end`/composition listeners, its pending hook, and any pending\n   * debounced submit (which described the outgoing form). An in-flight `aria-busy`\n   * is left for `turbo:submit-end` or the pre-cache rewind — removing it here\n   * would wipe a legitimately in-progress submission.\n   */\n  #bindForm(form: HTMLFormElement | null): void {\n    if (form === this.#boundForm) return;\n    const previous = this.#boundForm;\n    if (previous) {\n      this.#cancelPending();\n      previous.removeAttribute(\"data-auto-submit-pending\");\n      previous.removeEventListener(\"turbo:submit-end\", this.#onSubmitEnd);\n      this.#composition.unobserve(previous);\n    }\n    this.#boundForm = form;\n    if (!form) return;\n    form.addEventListener(\"turbo:submit-end\", this.#onSubmitEnd);\n    this.#composition.observe(form);\n  }\n\n  /** Resolves the form: the explicit `form` target, else a `<form>` root, else null. */\n  #resolveForm(): HTMLFormElement | null {\n    if (this.hasFormTarget) return this.formTarget;\n    return this.element instanceof HTMLFormElement ? this.element : null;\n  }\n\n  /** Returns the transient state hooks to their initial (absent) state. */\n  #rewindForCache(): void {\n    const inProgress = this.#pendingId !== 0 || this.#boundForm?.hasAttribute(\"aria-busy\") === true;\n    this.#cancelPending();\n    this.#boundForm?.removeAttribute(\"data-auto-submit-pending\");\n    this.#boundForm?.removeAttribute(\"aria-busy\");\n    if (inProgress) this.dispatch(\"reconcile\", { detail: {} });\n  }\n\n  /** Whether `type` is one of the whitespace-separated event types in `on`. */\n  #triggers(type: string): boolean {\n    return this.onValue.split(/\\s+/).filter(Boolean).includes(type);\n  }\n}\n"]}

package/dist/controllers/bulk_select_controller.d.ts

@@ -9,31 +9,59 @@ import { Controller } from '@hotwired/stimulus';
  *
  * Markup contract (identifier: `stimeo--bulk-select`):
  *   <div data-controller="stimeo--bulk-select"
- *        data-stimeo--bulk-select-total-count-value="128">
+ *        data-stimeo--bulk-select-total-count-value="128"
+ *        data-stimeo--bulk-select-announce-text-value="{count} selected">
  *     <input type="checkbox" data-stimeo--bulk-select-target="all">
  *     <!-- rows (may be added dynamically; handled via event delegation) -->
  *     <input type="checkbox" data-stimeo--bulk-select-target="item">
  *     <input type="checkbox" data-stimeo--bulk-select-target="item">
- *     <div data-stimeo--bulk-select-target="bar" hidden role="toolbar" aria-live="polite">
+ *     <div data-stimeo--bulk-select-target="bar" hidden role="toolbar"
+ *          data-controller="stimeo--toolbar" aria-label="Bulk actions">
  *       <span data-stimeo--bulk-select-target="count"></span> selected
  *       <button data-stimeo--bulk-select-target="selectAllPages"
+ *               data-stimeo--toolbar-target="control"
  *               data-action="click->stimeo--bulk-select#selectAllPages">Select all</button>
- *       <button data-action="click->stimeo--bulk-select#clear">Clear</button>
+ *       <button data-stimeo--toolbar-target="control"
+ *               data-action="click->stimeo--bulk-select#clear">Clear</button>
  *     </div>
  *   </div>
  *
- * `change` dispatches `{ count, allPages }`.
+ * The bar carries `role="toolbar"`, so it is composed with `stimeo--toolbar` to get
+ * the arrow-key movement and single tab stop that role calls for.
+ *
+ * `change` and `reconcile` both dispatch `{ count, allPages }`.
+ *
+ * Selection is two-stage. The select-all box covers the rows on this page; the
+ * optional `selectAllPages` control extends the selection to `totalCount` rows
+ * across every page, checking each row here as it does so. Touching any single row
+ * leaves that mode, because the selection is no longer the whole set.
  *
  * @remarks
  * Behavior only — it never runs the batch action (that is the consumer's
  * form/Turbo) nor fetches/pages rows. Selection lives **only** in each checkbox's
  * `checked` (no module-scope set), so `connect()` recomputes idempotently from the
  * DOM after a Turbo swap. Row `change` is handled by **delegation** on the
- * container, so dynamically-added rows work without per-row `data-action`.
- * Showing the bar never steals focus
- * (WCAG 2.2 2.4.3); the count rides the bar's own `aria-live` region (WCAG 2.2
- * 4.1.3) — the bar is revealed *before* the count text is written so the change is
- * observed and announced. The delegated listener is removed on `disconnect()`.
+ * container, so dynamically-added rows work without per-row `data-action`, while
+ * rows arriving or leaving on their own are picked up by the target callbacks and
+ * coalesced into one repair per batch.
+ *
+ * `change` is dispatched when the user moves the selection; `reconcile` when the
+ * controller repairs the figures itself — a row added or removed by the page, or a
+ * render input changing at runtime. Both carry the same detail.
+ *
+ * The count reaches assistive tech through the page's shared `stimeo--announcer`,
+ * worded by the consumer via `announceText` (`{count}` expands to the figure being
+ * shown; an empty template stays silent, keeping announcements opt-in and
+ * i18n-neutral).
+ *
+ * Showing the bar never steals focus (WCAG 2.2 2.4.3). Hiding it hands focus to
+ * 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`.
+ *
+ * The delegated listener and the pending repair are both released on `disconnect()`.
  */
 declare class BulkSelectController extends Controller<HTMLElement> {
     #private;
@@ -43,26 +71,45 @@ declare class BulkSelectController extends Controller<HTMLElement> {
             type: NumberConstructor;
             default: number;
         };
-        announce: {
-            type: BooleanConstructor;
-            default: boolean;
+        announceText: {
+            type: StringConstructor;
+            default: string;
         };
     };
     static actions: readonly ["clear", "selectAllPages"];
-    static events: readonly ["change"];
+    static events: readonly ["change", "reconcile"];
     readonly allTarget: HTMLInputElement;
     readonly barTarget: HTMLElement;
     readonly countTarget: HTMLElement;
+    readonly itemTargets: HTMLInputElement[];
     readonly hasAllTarget: boolean;
     readonly hasBarTarget: boolean;
     readonly hasCountTarget: boolean;
     totalCountValue: number;
-    announceValue: boolean;
+    announceTextValue: string;
     connect(): void;
     disconnect(): void;
+    /** Repairs the figures for a row that arrived at runtime. */
+    itemTargetConnected(): void;
+    /** Repairs the figures after a row leaves, so a removed selection stops counting. */
+    itemTargetDisconnected(): void;
+    /** Reflects the current selection onto a select-all box added at runtime. */
+    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. */
+    totalCountValueChanged(): void;
+    /** Repaints so wording changed at runtime is used by the next announcement. */
+    announceTextValueChanged(): void;
     /** Clears every selection (rows + select-all) and exits all-pages mode. */
     clear(): void;
-    /** Enters "select all across pages" mode (count shows `totalCount`). */
+    /**
+     * Enters "select all across pages" mode: the count shows `totalCount`, and every
+     * row on this page is checked.
+     *
+     * The mode's claim is that the whole set is selected, so leaving a visible row
+     * unchecked would put the page and the count in open disagreement.
+     */
     selectAllPages(): void;
 }