stimeo-ui 0.6.0 → 0.7.0

package/dist/controllers/character_counter_controller.js

@@ -2,6 +2,93 @@ import { Controller } from '@hotwired/stimulus';
 
 // src/controllers/character_counter_controller.ts
 
+// src/utils/announce.ts
+function announce(message, options = {}) {
+  const text = message.trim();
+  if (text.length === 0) return;
+  window.dispatchEvent(
+    new CustomEvent("stimeo--announcer:announce", {
+      detail: { message: text, assertive: options.assertive === true }
+    })
+  );
+}
+function fillTemplate(template, values) {
+  return template.replace(/\{([a-zA-Z][a-zA-Z0-9]*)\}/g, (match, name) => {
+    const replacement = values[name];
+    return replacement === void 0 ? match : String(replacement);
+  });
+}
+
+// src/utils/attribute_lease.ts
+var AttributeLease = class {
+  #attribute;
+  #records = /* @__PURE__ */ new Map();
+  /** @param attribute - The attribute whose temporary values this lease owns. */
+  constructor(attribute) {
+    this.#attribute = attribute;
+  }
+  /** Writes or removes the leased attribute while preserving its authored value. */
+  write(element, value) {
+    const existing = this.#records.get(element);
+    if (existing) {
+      existing.written = value;
+    } else {
+      this.#records.set(element, {
+        original: element.getAttribute(this.#attribute),
+        written: value
+      });
+    }
+    this.#reflect(element, value);
+  }
+  /** Returns one lease without overwriting a value subsequently authored by a consumer. */
+  return(element) {
+    const record = this.#records.get(element);
+    if (!record) return;
+    this.#records.delete(element);
+    const stillOwned = element.getAttribute(this.#attribute) === record.written;
+    if (stillOwned) this.#reflect(element, record.original);
+  }
+  /** Reflects only a real value transition, avoiding self-triggered mutation work. */
+  #reflect(element, value) {
+    if (element.getAttribute(this.#attribute) === value) return;
+    if (value === null) element.removeAttribute(this.#attribute);
+    else element.setAttribute(this.#attribute, value);
+  }
+  /** Returns every outstanding lease using the same ownership check as {@link return}. */
+  returnAll() {
+    for (const element of Array.from(this.#records.keys())) this.return(element);
+  }
+};
+
+// 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();
@@ -49,6 +136,39 @@ var CompositionTracker = class {
   };
 };
 
+// src/utils/microtask_coalescer.ts
+var MicrotaskCoalescer = class {
+  #run;
+  #queued = false;
+  #active = false;
+  #generation = 0;
+  /** @param run - the single reconciliation pass, invoked at most once per batch. */
+  constructor(run) {
+    this.#run = run;
+  }
+  /** Opens the window in which {@link schedule} is honoured; call from `connect()`. */
+  activate() {
+    this.#active = true;
+  }
+  /** Closes the window and drops any pending pass; call from `disconnect()`. */
+  cancel() {
+    this.#active = false;
+    this.#queued = false;
+    this.#generation += 1;
+  }
+  /** Requests one pass after the batch settles. Idempotent; inert outside the window. */
+  schedule() {
+    if (!this.#active || this.#queued) return;
+    this.#queued = true;
+    const generation = this.#generation;
+    queueMicrotask(() => {
+      if (generation !== this.#generation || !this.#queued || !this.#active) return;
+      this.#queued = false;
+      this.#run();
+    });
+  }
+};
+
 // src/utils/safe_timeout.ts
 var TimerRegistry = class {
   /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */
@@ -103,110 +223,265 @@ var SafeTimeout = class extends TimerRegistry {
 };
 
 // src/controllers/character_counter_controller.ts
-var ORIGINAL_INVALID = "data-character-counter-original-invalid";
 var CharacterCounterController = class _CharacterCounterController extends Controller {
   static targets = ["input", "output"];
   static values = {
     max: { type: Number, default: 0 },
     warnAt: { type: Number, default: 0 },
-    mode: { type: String, default: "remaining" }
+    mode: { type: String, default: "remaining" },
+    announceText: { type: String, default: "" }
   };
-  static events = ["change"];
-  /** Delay (ms) before the live-region count is written, to throttle SR flooding. */
+  static events = ["change", "reconcile"];
+  /** Delay (ms) before one settled count is sent to the shared announcer. */
   static #announceDelay = 200;
   #timeouts = new SafeTimeout();
+  #ariaInvalid = new AttributeLease("aria-invalid");
+  #beforeCache = new BeforeCacheReset(() => this.#rewindForCache());
+  #repaint = new MicrotaskCoalescer(() => this.#reconcile(true));
+  #composition = new CompositionTracker({
+    onEnd: (event) => this.#commitFrom(event.currentTarget)
+  });
   #announceId = null;
-  /** Owns IME lifecycle state and applies the confirmed count once. */
-  #composition = new CompositionTracker({ onEnd: () => this.#update() });
+  #boundField = null;
+  #lastLength = null;
+  #lastDetail = null;
+  #reflectedOver = null;
   #onInput = (event) => {
+    const field = this.#boundField;
+    if (!field || event.currentTarget !== field || this.#field !== field) return;
     if (this.#composition.isComposing(event)) return;
-    this.#update();
+    this.#commit(field);
   };
+  /** Reflects the current DOM state and opens the mutation-reconciliation window. */
   connect() {
-    const field = this.#field;
-    if (!field) return;
-    field.addEventListener("input", this.#onInput);
-    this.#composition.observe(field);
-    this.#update({ announce: false });
+    this.#repaint.activate();
+    this.#beforeCache.activate();
+    this.#reconcile(false);
   }
+  /** Releases listeners, timers, borrowed ARIA, and controller-owned state hooks. */
   disconnect() {
-    const field = this.#field;
-    field?.removeEventListener("input", this.#onInput);
+    this.#repaint.cancel();
+    this.#beforeCache.deactivate();
+    this.#cancelAnnouncement();
+    this.#bindField(null);
     this.#composition.disconnect();
-    this.#timeouts.clearAll();
-    this.#announceId = null;
+    this.#clearStateHooks();
+    this.#lastLength = null;
+    this.#lastDetail = null;
+  }
+  /** Rebinds and repaints after an input target is added or replaced at runtime. */
+  inputTargetConnected() {
+    this.#repaint.schedule();
+  }
+  /** Releases and repaints after an input target is removed or replaced at runtime. */
+  inputTargetDisconnected() {
+    this.#repaint.schedule();
+  }
+  /** Initializes a display target inserted after the controller connected. */
+  outputTargetConnected() {
+    this.#repaint.schedule();
+  }
+  /** Reconciles the optional display target set after a removal or replacement. */
+  outputTargetDisconnected() {
+    this.#repaint.schedule();
+  }
+  /** Repaints when application code or a Turbo morph changes `max`. */
+  maxValueChanged() {
+    this.#repaint.schedule();
+  }
+  /** Repaints when application code or a Turbo morph changes `warnAt`. */
+  warnAtValueChanged() {
+    this.#repaint.schedule();
+  }
+  /** Repaints when application code or a Turbo morph changes `mode`. */
+  modeValueChanged() {
+    this.#repaint.schedule();
+  }
+  /** Cancels a pending old message when its consumer-authored template changes. */
+  announceTextValueChanged() {
+    this.#repaint.schedule();
+  }
+  /** Rebinds one mutation batch and reports a changed controller-derived state. */
+  #reconcile(report) {
+    const previous = this.#lastDetail;
+    const owedField = this.#announceId === null ? null : this.#boundField;
+    this.#cancelAnnouncement();
+    this.#bindField(this.#field);
+    if (this.#composition.isComposing()) return;
+    const field = this.#boundField;
+    if (!field) {
+      this.#renderEmpty();
+      this.#lastLength = null;
+      this.#lastDetail = null;
+      return;
+    }
+    const reading = this.#render(field);
+    const detail = this.#detail(reading);
+    this.#lastLength = reading.length;
+    this.#lastDetail = detail;
+    if (owedField === field) this.#scheduleAnnouncement(reading);
+    if (report && previous && this.#detailsDiffer(previous, detail)) {
+      this.dispatch("reconcile", { detail });
+    }
+  }
+  /** Commits a composition only when it came from the field still owned here. */
+  #commitFrom(target) {
+    const field = this.#boundField;
+    if (!field || target !== field || this.#field !== field) return;
+    this.#commit(field);
+  }
+  /** Reflects one confirmed user input and reports only a real length transition. */
+  #commit(field) {
+    const reading = this.#render(field);
+    const previousLength = this.#lastLength;
+    const previousDetail = this.#lastDetail;
+    const detail = this.#detail(reading);
+    this.#lastLength = reading.length;
+    this.#lastDetail = detail;
+    if (previousLength === reading.length) {
+      if (previousDetail && this.#detailsDiffer(previousDetail, detail)) {
+        this.dispatch("reconcile", { detail });
+      }
+      return;
+    }
+    this.dispatch("change", { detail });
+    this.#scheduleAnnouncement(reading);
+  }
+  /** Selects the public event state from the richer internal reading. */
+  #detail(reading) {
+    return {
+      length: reading.length,
+      remaining: reading.remaining,
+      over: reading.over
+    };
+  }
+  /** Compares exactly the state carried by `change` and `reconcile`. */
+  #detailsDiffer(left, right) {
+    return left.length !== right.length || left.remaining !== right.remaining || left.over !== right.over;
   }
   /**
-   * Recomputes length-derived state. Non-text state (data hooks, `aria-invalid`)
-   * and the `change` event apply immediately; the live-region count text is
-   * debounced unless `announce` is `false` (initial render).
+   * Synchronizes visible count, state hooks, and temporary validation ARIA.
+   *
+   * @stimeoRenderRoot
    */
-  #update(options = {}) {
-    const field = this.#field;
-    if (!field) return;
+  #render(field) {
     const length = field.value.length;
-    const hasLimit = this.maxValue > 0;
-    const remaining = hasLimit ? this.maxValue - length : null;
-    const over = hasLimit && length > this.maxValue;
-    const near = hasLimit && this.warnAtValue > 0 && !over && remaining !== null && remaining <= this.warnAtValue;
+    const max = this.#normalizeCount(this.maxValue);
+    const warnAt = this.#normalizeCount(this.warnAtValue);
+    const remaining = max > 0 ? max - length : null;
+    const over = remaining !== null && remaining < 0;
+    const near = remaining !== null && warnAt > 0 && !over && remaining <= warnAt;
     this.#toggle("data-over-limit", over);
     this.#toggle("data-near-limit", near);
-    if (hasLimit && over) {
-      if (!field.hasAttribute(ORIGINAL_INVALID)) {
-        field.setAttribute(ORIGINAL_INVALID, field.getAttribute("aria-invalid") ?? "");
-      }
-      field.setAttribute("aria-invalid", "true");
-    } else if (field.hasAttribute(ORIGINAL_INVALID)) {
-      const original = field.getAttribute(ORIGINAL_INVALID);
-      if (original) {
-        field.setAttribute("aria-invalid", original);
-      } else {
-        field.removeAttribute("aria-invalid");
-      }
-      field.removeAttribute(ORIGINAL_INVALID);
-    }
-    const text = this.#format(length, remaining);
-    if (options.announce === false) {
-      this.#writeOutput(text);
-      return;
+    this.#reflectInvalid(field, over);
+    const text = this.#format(length, remaining, max);
+    this.#writeOutput(text);
+    return { length, remaining, over, max, text };
+  }
+  /** Clears derived output when the declarative input set has no usable field. */
+  #renderEmpty() {
+    this.#ariaInvalid.returnAll();
+    this.#reflectedOver = null;
+    this.#clearStateHooks();
+    this.#writeOutput("");
+  }
+  /** Replaces the observed field symmetrically, returning state from the old one. */
+  #bindField(field) {
+    if (field === this.#boundField) return;
+    const previous = this.#boundField;
+    if (previous) {
+      previous.removeEventListener("input", this.#onInput);
+      this.#composition.unobserve(previous);
+      this.#ariaInvalid.return(previous);
     }
-    this.dispatch("change", { detail: { length, remaining, over } });
-    if (this.#announceId !== null) this.#timeouts.clear(this.#announceId);
-    this.#announceId = this.#timeouts.set(() => {
-      this.#writeOutput(text);
-      this.#announceId = null;
-    }, _CharacterCounterController.#announceDelay);
+    this.#boundField = field;
+    this.#lastLength = null;
+    this.#reflectedOver = null;
+    if (!field) return;
+    field.addEventListener("input", this.#onInput);
+    this.#composition.observe(field);
+  }
+  /** Leases `aria-invalid` only on the edge into over-limit, then returns it. */
+  #reflectInvalid(field, over) {
+    if (this.#reflectedOver === over) return;
+    this.#reflectedOver = over;
+    if (over) this.#ariaInvalid.write(field, "true");
+    else this.#ariaInvalid.return(field);
   }
-  /** Builds the count text for the active `mode`. */
-  #format(length, remaining) {
+  /** Builds the visible count for the normalized display mode. */
+  #format(length, remaining, max) {
     if (remaining === null) return String(length);
-    switch (this.modeValue) {
+    switch (this.#mode) {
       case "used":
         return String(length);
       case "both":
-        return `${length}/${this.maxValue}`;
+        return `${length}/${max}`;
       default:
         return String(remaining);
     }
   }
+  /** Debounces one i18n-neutral message into the shared polite announcer. */
+  #scheduleAnnouncement(reading) {
+    this.#cancelAnnouncement();
+    const message = fillTemplate(this.announceTextValue, {
+      count: reading.text,
+      length: reading.length,
+      remaining: reading.remaining ?? "",
+      max: reading.max,
+      over: String(reading.over)
+    });
+    if (message.trim().length === 0) return;
+    this.#announceId = this.#timeouts.set(() => {
+      announce(message);
+      this.#announceId = null;
+    }, _CharacterCounterController.#announceDelay);
+  }
+  /** Cancels the one outstanding announcement without touching visible output. */
+  #cancelAnnouncement() {
+    if (this.#announceId !== null) this.#timeouts.clear(this.#announceId);
+    this.#announceId = null;
+  }
+  /** Writes the optional display only when its text actually changed. */
   #writeOutput(text) {
-    if (this.hasOutputTarget) this.outputTarget.textContent = text;
+    if (!this.hasOutputTarget || this.outputTarget.textContent === text) return;
+    this.outputTarget.textContent = text;
   }
-  /** Sets a presence-style boolean data hook (attribute present when `on`). */
+  /** Reflects a presence-style state hook without redundant attribute writes. */
   #toggle(name, on) {
     if (on) {
-      this.element.setAttribute(name, "true");
-    } else {
+      if (this.element.getAttribute(name) !== "true") this.element.setAttribute(name, "true");
+    } else if (this.element.hasAttribute(name)) {
       this.element.removeAttribute(name);
     }
   }
-  /** The watched field: the `input` target, or the element itself when it is one. */
+  /** Removes both state hooks owned by this controller. */
+  #clearStateHooks() {
+    this.#toggle("data-over-limit", false);
+    this.#toggle("data-near-limit", false);
+  }
+  /** Returns borrowed ARIA and transient hooks before Turbo snapshots the page. */
+  #rewindForCache() {
+    this.#cancelAnnouncement();
+    this.#ariaInvalid.returnAll();
+    this.#reflectedOver = null;
+    this.#clearStateHooks();
+  }
+  /** Converts a public count Value into a finite non-negative integer. */
+  #normalizeCount(raw) {
+    if (!Number.isFinite(raw)) return 0;
+    return Math.max(0, Math.trunc(raw));
+  }
+  /** Falls back to `remaining` when an authored display mode is unknown. */
+  get #mode() {
+    if (this.modeValue === "used" || this.modeValue === "both") return this.modeValue;
+    return "remaining";
+  }
+  /** The watched field: the first target, or a directly controlled form field. */
   get #field() {
     if (this.hasInputTarget) return this.inputTarget;
-    const el = this.element;
-    if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {
-      return el;
-    }
+    const element = this.element;
+    if (element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement)
+      return element;
     return null;
   }
 };

package/dist/controllers/character_counter_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/composition_tracker.ts","../../src/utils/safe_timeout.ts","../../src/controllers/character_counter_controller.ts"],"names":[],"mappings":"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","file":"character_counter_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/** Parks the field's original `aria-invalid` while we override it for over-limit. */\nconst ORIGINAL_INVALID = \"data-character-counter-original-invalid\";\n\n/**\n * Headless character-counter behavior for a text field (no dedicated APG\n * pattern; follows the WCAG 2.2 \"status messages\" practice, 4.1.3).\n *\n * Markup contract (identifier: `stimeo--character-counter`):\n *   <div data-controller=\"stimeo--character-counter\"\n *        data-stimeo--character-counter-max-value=\"140\">\n *     <textarea data-stimeo--character-counter-target=\"input\"\n *               aria-describedby=\"cc\"></textarea>\n *     <span id=\"cc\" data-stimeo--character-counter-target=\"output\"\n *           aria-live=\"polite\"></span>\n *   </div>\n *\n * Watches the field's length, writes the remaining/used count into `output`, and\n * toggles the `data-near-limit` / `data-over-limit` state hooks (plus\n * `aria-invalid` on the field once the limit is exceeded). The field is the\n * `input` target, or — when the controller is attached straight onto an\n * `<input>`/`<textarea>` — the controller element itself.\n *\n * @remarks\n * Behavior only — the count text is updated, not styled. Outside IME composition\n * the non-text state (`data-*` hooks, `aria-invalid`, and the `change` event)\n * updates **immediately** on every input so styling and consumers stay responsive,\n * while the visible count — in the `aria-live=\"polite\"` region — is written on a\n * short debounce so a screen reader is not flooded during fast typing (it hears the\n * settled count when the user pauses). During IME composition both are deferred to\n * `compositionend`, so they reflect the confirmed characters rather than the\n * intermediate (pre-conversion) kana. The debounce timer is owned by\n * {@link SafeTimeout} and torn down on `disconnect()` (Turbo navigation included);\n * `connect()` re-reads the field so the count is correct after a cache restore.\n */\nexport class CharacterCounterController extends Controller<HTMLElement> {\n  static override targets = [\"input\", \"output\"];\n  static override values = {\n    max: { type: Number, default: 0 },\n    warnAt: { type: Number, default: 0 },\n    mode: { type: String, default: \"remaining\" },\n  };\n  static events = [\"change\"] as const;\n\n  declare readonly inputTarget: HTMLInputElement | HTMLTextAreaElement;\n  declare readonly outputTarget: HTMLElement;\n  declare readonly hasInputTarget: boolean;\n  declare readonly hasOutputTarget: boolean;\n\n  declare maxValue: number;\n  declare warnAtValue: number;\n  declare modeValue: string;\n\n  /** Delay (ms) before the live-region count is written, to throttle SR flooding. */\n  static readonly #announceDelay = 200;\n\n  readonly #timeouts = new SafeTimeout();\n  #announceId: number | null = null;\n\n  /** Owns IME lifecycle state and applies the confirmed count once. */\n  readonly #composition = new CompositionTracker({ onEnd: () => this.#update() });\n\n  readonly #onInput = (event: Event): void => {\n    // During IME composition the field holds unconverted text; defer the count to\n    // `compositionend` so it reflects the confirmed characters, not each keystroke.\n    if (this.#composition.isComposing(event as InputEvent)) return;\n    this.#update();\n  };\n\n  override connect(): void {\n    const field = this.#field;\n    if (!field) return;\n    field.addEventListener(\"input\", this.#onInput);\n    this.#composition.observe(field);\n    // Initial render is synchronous (no announce debounce): reflect the current\n    // value on connect/cache-restore without queueing a screen-reader message.\n    this.#update({ announce: false });\n  }\n\n  override disconnect(): void {\n    const field = this.#field;\n    field?.removeEventListener(\"input\", this.#onInput);\n    this.#composition.disconnect();\n    this.#timeouts.clearAll();\n    this.#announceId = null;\n  }\n\n  /**\n   * Recomputes length-derived state. Non-text state (data hooks, `aria-invalid`)\n   * and the `change` event apply immediately; the live-region count text is\n   * debounced unless `announce` is `false` (initial render).\n   */\n  #update(options: { announce?: boolean } = {}): void {\n    const field = this.#field;\n    if (!field) return;\n\n    const length = field.value.length;\n    const hasLimit = this.maxValue > 0;\n    const remaining = hasLimit ? this.maxValue - length : null;\n    const over = hasLimit && length > this.maxValue;\n    const near =\n      hasLimit &&\n      this.warnAtValue > 0 &&\n      !over &&\n      remaining !== null &&\n      remaining <= this.warnAtValue;\n\n    this.#toggle(\"data-over-limit\", over);\n    this.#toggle(\"data-near-limit\", near);\n    // `aria-invalid` is a shared attribute (Form Field / server validation also use\n    // it), so we never clobber an authored value: park the original when flagging\n    // over-limit and restore it once back within the limit.\n    if (hasLimit && over) {\n      if (!field.hasAttribute(ORIGINAL_INVALID)) {\n        field.setAttribute(ORIGINAL_INVALID, field.getAttribute(\"aria-invalid\") ?? \"\");\n      }\n      field.setAttribute(\"aria-invalid\", \"true\");\n    } else if (field.hasAttribute(ORIGINAL_INVALID)) {\n      const original = field.getAttribute(ORIGINAL_INVALID);\n      if (original) {\n        field.setAttribute(\"aria-invalid\", original);\n      } else {\n        field.removeAttribute(\"aria-invalid\");\n      }\n      field.removeAttribute(ORIGINAL_INVALID);\n    }\n\n    const text = this.#format(length, remaining);\n    if (options.announce === false) {\n      // Initial render (connect / cache-restore): reflect the current state without\n      // emitting a change event or queueing a screen-reader announcement.\n      this.#writeOutput(text);\n      return;\n    }\n\n    this.dispatch(\"change\", { detail: { length, remaining, over } });\n    if (this.#announceId !== null) this.#timeouts.clear(this.#announceId);\n    this.#announceId = this.#timeouts.set(() => {\n      this.#writeOutput(text);\n      this.#announceId = null;\n    }, CharacterCounterController.#announceDelay);\n  }\n\n  /** Builds the count text for the active `mode`. */\n  #format(length: number, remaining: number | null): string {\n    if (remaining === null) return String(length); // no limit → used count only\n    switch (this.modeValue) {\n      case \"used\":\n        return String(length);\n      case \"both\":\n        return `${length}/${this.maxValue}`;\n      default:\n        return String(remaining); // \"remaining\"\n    }\n  }\n\n  #writeOutput(text: string): void {\n    if (this.hasOutputTarget) this.outputTarget.textContent = text;\n  }\n\n  /** Sets a presence-style boolean data hook (attribute present when `on`). */\n  #toggle(name: string, on: boolean): void {\n    if (on) {\n      this.element.setAttribute(name, \"true\");\n    } else {\n      this.element.removeAttribute(name);\n    }\n  }\n\n  /** The watched field: the `input` target, or the element itself when it is one. */\n  get #field(): HTMLInputElement | HTMLTextAreaElement | null {\n    if (this.hasInputTarget) return this.inputTarget;\n    const el: HTMLElement = this.element;\n    if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {\n      return el;\n    }\n    return null;\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/announce.ts","../../src/utils/attribute_lease.ts","../../src/utils/before_cache_reset.ts","../../src/utils/composition_tracker.ts","../../src/utils/microtask_coalescer.ts","../../src/utils/safe_timeout.ts","../../src/controllers/character_counter_controller.ts"],"names":[],"mappings":"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","file":"character_counter_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","/** One temporarily controlled attribute value and the authored value it displaced. */\ninterface AttributeLeaseRecord {\n  readonly original: string | null;\n  written: string | null;\n}\n\n/**\n * Temporarily controls one attribute across a changing set of elements.\n *\n * The first write remembers the authored value, including the distinction between\n * an absent attribute and an authored empty string. Returning a lease restores that\n * value only while the attribute still matches the controller's last write. If a\n * consumer changed it in the meantime, the consumer owns the new value and teardown\n * leaves it alone.\n *\n * A `null` write deliberately removes the attribute while retaining the lease. This\n * is useful for derived ARIA whose valid absence is itself controller state, such as\n * an unbounded `aria-valuemin` or a blank spinbutton's `aria-valuenow`.\n *\n * The lease has no lifecycle of its own, so it never subscribes to document events.\n * A consumer that must not let a derived value become the authored baseline of a\n * cached page returns its leases from its own `turbo:before-cache` rewind, where the\n * matching `disconnect()` also releases the subscription.\n */\nexport class AttributeLease<T extends Element = Element> {\n  readonly #attribute: string;\n  readonly #records = new Map<T, AttributeLeaseRecord>();\n\n  /** @param attribute - The attribute whose temporary values this lease owns. */\n  constructor(attribute: string) {\n    this.#attribute = attribute;\n  }\n\n  /** Writes or removes the leased attribute while preserving its authored value. */\n  write(element: T, value: string | null): void {\n    const existing = this.#records.get(element);\n    if (existing) {\n      existing.written = value;\n    } else {\n      this.#records.set(element, {\n        original: element.getAttribute(this.#attribute),\n        written: value,\n      });\n    }\n\n    this.#reflect(element, value);\n  }\n\n  /** Returns one lease without overwriting a value subsequently authored by a consumer. */\n  return(element: T): void {\n    const record = this.#records.get(element);\n    if (!record) return;\n    this.#records.delete(element);\n    const stillOwned = element.getAttribute(this.#attribute) === record.written;\n    if (stillOwned) this.#reflect(element, record.original);\n  }\n\n  /** Reflects only a real value transition, avoiding self-triggered mutation work. */\n  #reflect(element: T, value: string | null): void {\n    if (element.getAttribute(this.#attribute) === value) return;\n    if (value === null) element.removeAttribute(this.#attribute);\n    else element.setAttribute(this.#attribute, value);\n  }\n\n  /** Returns every outstanding lease using the same ownership check as {@link return}. */\n  returnAll(): void {\n    for (const element of Array.from(this.#records.keys())) this.return(element);\n  }\n}\n","/**\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 * Collapses many Stimulus lifecycle callbacks from one DOM mutation into a\n * single pass.\n *\n * Stimulus fires `<name>TargetConnected` / `Disconnected` once per element and\n * `<name>ValueChanged` once per changed attribute. Replacing a list of N options\n * or morphing several render Values therefore delivers N callbacks — but the\n * useful unit of work is \"reconcile against the resulting declarative input\",\n * once, after the batch has settled. Every controller with reconcilable targets\n * or render Values needs the same shape: a `queued` flag plus `queueMicrotask`.\n *\n * **A microtask is the right horizon, and the reason is specific.** Stimulus\n * drives these callbacks from a `MutationObserver`, whose own callback already\n * runs as a microtask with the whole batch in hand; scheduling one more lands\n * after the last sibling callback of that batch and still before paint or any\n * event handler. A timer would be later than it needs to be, and reconciling\n * synchronously would run once per element against a half-applied DOM.\n *\n * **The two guards are not the same guard.** Scheduling is refused before the\n * controller connects, and running is refused after it disconnects:\n *\n * - **Before `connect()`** — Stimulus delivers initial target and Value callbacks\n *   ahead of `connect()`. Reconciling there would compute output against a\n *   controller whose own state has not been initialised, and `connect()` is\n *   about to do a full pass anyway.\n * - **After `disconnect()`** — Stimulus fires a callback for **every** target\n *   during teardown, and a microtask queued just before it would otherwise run\n *   against a detached tree. {@link MicrotaskCoalescer.cancel} exists for the\n *   teardown path to drop the pending pass outright.\n *\n * Both guards are part of one contract here rather than something each consumer\n * has to remember separately.\n *\n * Scope is the scheduling only. *What* to reconcile — keep the surviving active\n * option, fall back to the next / previous / first visible one, rebuild derived\n * chips or hidden fields — stays in the controller, because no two consumers\n * answer it the same way.\n *\n * This file's own doc block is dropped from `dist`, but every member comment is\n * inlined into each consumer entry (`tsup` builds with `splitting: false`), so\n * rationale belongs here and only the contract belongs on the members.\n *\n * @example\n * ```ts\n * readonly #reconcile = new MicrotaskCoalescer(() => this.#reconcileOptions());\n *\n * connect()    { this.#reconcile.activate(); }\n * disconnect() { this.#reconcile.cancel(); }\n *\n * optionTargetConnected()    { this.#reconcile.schedule(); }\n * optionTargetDisconnected() { this.#reconcile.schedule(); }\n * ```\n */\nexport class MicrotaskCoalescer {\n  readonly #run: () => void;\n  #queued = false;\n  #active = false;\n  #generation = 0;\n\n  /** @param run - the single reconciliation pass, invoked at most once per batch. */\n  constructor(run: () => void) {\n    this.#run = run;\n  }\n\n  /** Opens the window in which {@link schedule} is honoured; call from `connect()`. */\n  activate(): void {\n    this.#active = true;\n  }\n\n  /** Closes the window and drops any pending pass; call from `disconnect()`. */\n  cancel(): void {\n    this.#active = false;\n    this.#queued = false;\n    this.#generation += 1;\n  }\n\n  /** Requests one pass after the batch settles. Idempotent; inert outside the window. */\n  schedule(): void {\n    if (!this.#active || this.#queued) return;\n    this.#queued = true;\n    const generation = this.#generation;\n    queueMicrotask(() => {\n      // A cancelled callback must not consume a pass queued after reconnect.\n      if (generation !== this.#generation || !this.#queued || !this.#active) return;\n      this.#queued = false;\n      this.#run();\n    });\n  }\n}\n","/**\n * Self-cleaning timer registries shared by Stimeo controllers.\n *\n * Stimulus controllers frequently schedule `setTimeout` / `setInterval` work\n * (auto-dismiss, debouncing, polling). When the element leaves the DOM — a\n * Turbo Drive navigation, a Turbo Stream replacement, or any `disconnect()` —\n * orphaned timers keep firing against a detached controller, leaking memory and\n * mutating stale state. {@link SafeTimeout} and {@link SafeInterval} track every\n * timer they create so a single {@link TimerRegistry.clearAll | clearAll()} call\n * in `disconnect()` tears them all down.\n *\n * These are intentionally low-level primitives: they own *registration and\n * cleanup only*. Higher-level policy (pause/resume, remaining-time accounting)\n * stays in the individual controllers so per-widget semantics are not flattened\n * into a lowest-common-denominator helper.\n */\n\n/**\n * Shared registry bookkeeping for the timeout/interval variants.\n *\n * Subclasses provide the scheduling primitive ({@link schedule}) and its matching\n * canceller ({@link cancel}); this base owns the set of live ids plus the\n * per-id and bulk teardown shared by both.\n */\nabstract class TimerRegistry {\n  /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */\n  protected readonly ids = new Set<number>();\n\n  /** Schedules the underlying platform timer and returns its id. */\n  protected abstract schedule(callback: () => void, delay: number): number;\n\n  /** Cancels the underlying platform timer for `id`. */\n  protected abstract cancel(id: number): void;\n\n  /**\n   * Cancels a single tracked timer.\n   *\n   * No-ops if the id is unknown (already cleared, fired, or never owned by this\n   * registry), so callers can clear defensively without guarding.\n   */\n  clear(id: number): void {\n    if (this.ids.delete(id)) {\n      this.cancel(id);\n    }\n  }\n\n  /**\n   * Cancels every tracked timer. Call this from a controller's `disconnect()`\n   * to guarantee no timer outlives the element.\n   */\n  clearAll(): void {\n    for (const id of this.ids) {\n      this.cancel(id);\n    }\n    this.ids.clear();\n  }\n\n  /** Number of timers currently tracked (pending). */\n  get size(): number {\n    return this.ids.size;\n  }\n}\n\n/**\n * `setTimeout` wrapper that auto-forgets each timer once it fires and supports\n * bulk teardown on disconnect.\n *\n * @example\n * ```ts\n * #timers = new SafeTimeout();\n *\n * connect() {\n *   this.#timers.set(() => this.dismiss(), 5000);\n * }\n *\n * disconnect() {\n *   this.#timers.clearAll();\n * }\n * ```\n */\nexport class SafeTimeout extends TimerRegistry {\n  /**\n   * Schedules `callback` after `delay` ms and returns the timer id.\n   *\n   * The id is removed from the registry automatically when the timeout fires,\n   * so {@link TimerRegistry.size | size} reflects only still-pending timers.\n   */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(() => {\n      this.ids.delete(id);\n      callback();\n    }, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setTimeout(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearTimeout(id);\n  }\n}\n\n/**\n * `setInterval` wrapper that tracks every interval for bulk teardown on\n * disconnect. Unlike {@link SafeTimeout}, intervals are retained until they are\n * explicitly cleared because they fire repeatedly.\n *\n * @example\n * ```ts\n * #intervals = new SafeInterval();\n *\n * connect() {\n *   this.#intervals.set(() => this.tick(), 1000);\n * }\n *\n * disconnect() {\n *   this.#intervals.clearAll();\n * }\n * ```\n */\nexport class SafeInterval extends TimerRegistry {\n  /** Schedules a repeating `callback` every `delay` ms and returns the timer id. */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(callback, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setInterval(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearInterval(id);\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { announce, fillTemplate } from \"../utils/announce\";\nimport { AttributeLease } from \"../utils/attribute_lease\";\nimport { BeforeCacheReset } from \"../utils/before_cache_reset\";\nimport { CompositionTracker } from \"../utils/composition_tracker\";\nimport { MicrotaskCoalescer } from \"../utils/microtask_coalescer\";\nimport { SafeTimeout } from \"../utils/safe_timeout\";\n\ntype CharacterCounterField = HTMLInputElement | HTMLTextAreaElement;\ntype DisplayMode = \"remaining\" | \"used\" | \"both\";\n\ninterface CharacterCountReading {\n  readonly length: number;\n  readonly remaining: number | null;\n  readonly over: boolean;\n  readonly max: number;\n  readonly text: string;\n}\n\ntype CharacterCounterDetail = Pick<CharacterCountReading, \"length\" | \"remaining\" | \"over\">;\n\n/**\n * Headless character-counter behavior for a text field (no dedicated APG\n * pattern; follows the WCAG 2.2 \"status messages\" practice, 4.1.3).\n *\n * Markup contract (identifier: `stimeo--character-counter`):\n *   <div data-controller=\"stimeo--character-counter\"\n *        data-stimeo--character-counter-max-value=\"140\"\n *        data-stimeo--character-counter-announce-text-value=\"{remaining} characters remaining\">\n *     <textarea data-stimeo--character-counter-target=\"input\"\n *               aria-describedby=\"cc\"></textarea>\n *     <span id=\"cc\" data-stimeo--character-counter-target=\"output\"></span>\n *   </div>\n *\n * Watches the field's UTF-16 code-unit length, writes the remaining/used count\n * into `output`, and toggles the `data-near-limit` / `data-over-limit` state\n * hooks. While over the limit it temporarily leases `aria-invalid=\"true\"` on\n * the field and returns the consumer's authored value on recovery or teardown.\n * The field is the first `input` target, or — when the controller is attached\n * straight onto an `<input>`/`<textarea>` — the controller element itself.\n *\n * `change` and `reconcile` dispatch\n * `{ length: number, remaining: number | null, over: boolean }`.\n *\n * @remarks\n * Behavior only — count text and state update synchronously, with no styling.\n * Confirmed user input dispatches `stimeo--character-counter:change` only when\n * the measured length actually changes. Its detail is `{ length, remaining,\n * over }`; `remaining` is `null` when `max` is disabled. IME intermediate input\n * is ignored, and `compositionend` commits the confirmed value exactly once.\n *\n * Assistive notification is opt-in and i18n-neutral. `announceText` accepts\n * `{count}`, `{length}`, `{remaining}`, `{max}`, and `{over}` placeholders and\n * sends the settled message to the page's shared `stimeo--announcer` after a\n * short debounce. The visible `output` is not itself required to be a live\n * region. Initial reflection and Turbo restoration never dispatch or announce.\n * Runtime target/Value reconciliation dispatches\n * `stimeo--character-counter:reconcile` only when the public derived state\n * changes, and never announces.\n */\nexport class CharacterCounterController extends Controller<HTMLElement> {\n  static override targets = [\"input\", \"output\"];\n  static override values = {\n    max: { type: Number, default: 0 },\n    warnAt: { type: Number, default: 0 },\n    mode: { type: String, default: \"remaining\" },\n    announceText: { type: String, default: \"\" },\n  };\n  static events = [\"change\", \"reconcile\"] as const;\n\n  declare readonly inputTarget: CharacterCounterField;\n  declare readonly outputTarget: HTMLElement;\n  declare readonly hasInputTarget: boolean;\n  declare readonly hasOutputTarget: boolean;\n\n  declare maxValue: number;\n  declare warnAtValue: number;\n  declare modeValue: string;\n  declare announceTextValue: string;\n\n  /** Delay (ms) before one settled count is sent to the shared announcer. */\n  static readonly #announceDelay = 200;\n\n  readonly #timeouts = new SafeTimeout();\n  readonly #ariaInvalid = new AttributeLease<CharacterCounterField>(\"aria-invalid\");\n  readonly #beforeCache = new BeforeCacheReset(() => this.#rewindForCache());\n  readonly #repaint = new MicrotaskCoalescer(() => this.#reconcile(true));\n  readonly #composition = new CompositionTracker({\n    onEnd: (event) => this.#commitFrom(event.currentTarget),\n  });\n  #announceId: number | null = null;\n  #boundField: CharacterCounterField | null = null;\n  #lastLength: number | null = null;\n  #lastDetail: CharacterCounterDetail | null = null;\n  #reflectedOver: boolean | null = null;\n\n  readonly #onInput = (event: Event): void => {\n    const field = this.#boundField;\n    if (!field || event.currentTarget !== field || this.#field !== field) return;\n    if (this.#composition.isComposing(event as InputEvent)) return;\n    this.#commit(field);\n  };\n\n  /** Reflects the current DOM state and opens the mutation-reconciliation window. */\n  override connect(): void {\n    this.#repaint.activate();\n    this.#beforeCache.activate();\n    this.#reconcile(false);\n  }\n\n  /** Releases listeners, timers, borrowed ARIA, and controller-owned state hooks. */\n  override disconnect(): void {\n    this.#repaint.cancel();\n    this.#beforeCache.deactivate();\n    this.#cancelAnnouncement();\n    this.#bindField(null);\n    this.#composition.disconnect();\n    this.#clearStateHooks();\n    this.#lastLength = null;\n    this.#lastDetail = null;\n  }\n\n  /** Rebinds and repaints after an input target is added or replaced at runtime. */\n  inputTargetConnected(): void {\n    this.#repaint.schedule();\n  }\n\n  /** Releases and repaints after an input target is removed or replaced at runtime. */\n  inputTargetDisconnected(): void {\n    this.#repaint.schedule();\n  }\n\n  /** Initializes a display target inserted after the controller connected. */\n  outputTargetConnected(): void {\n    this.#repaint.schedule();\n  }\n\n  /** Reconciles the optional display target set after a removal or replacement. */\n  outputTargetDisconnected(): void {\n    this.#repaint.schedule();\n  }\n\n  /** Repaints when application code or a Turbo morph changes `max`. */\n  maxValueChanged(): void {\n    this.#repaint.schedule();\n  }\n\n  /** Repaints when application code or a Turbo morph changes `warnAt`. */\n  warnAtValueChanged(): void {\n    this.#repaint.schedule();\n  }\n\n  /** Repaints when application code or a Turbo morph changes `mode`. */\n  modeValueChanged(): void {\n    this.#repaint.schedule();\n  }\n\n  /** Cancels a pending old message when its consumer-authored template changes. */\n  announceTextValueChanged(): void {\n    this.#repaint.schedule();\n  }\n\n  /** Rebinds one mutation batch and reports a changed controller-derived state. */\n  #reconcile(report: boolean): void {\n    const previous = this.#lastDetail;\n    // An edit inside the debounce window has already earned an announcement.\n    // Reconciliation never originates one, but it must not swallow that one\n    // either: the pending message is retargeted at the settled reading, so the\n    // user hears the count that ends up displayed rather than nothing. A\n    // replaced field is the exception — its pending message describes a field\n    // the reader can no longer reach.\n    const owedField = this.#announceId === null ? null : this.#boundField;\n    this.#cancelAnnouncement();\n    this.#bindField(this.#field);\n    if (this.#composition.isComposing()) return;\n    const field = this.#boundField;\n    if (!field) {\n      this.#renderEmpty();\n      this.#lastLength = null;\n      this.#lastDetail = null;\n      return;\n    }\n    const reading = this.#render(field);\n    const detail = this.#detail(reading);\n    this.#lastLength = reading.length;\n    this.#lastDetail = detail;\n    if (owedField === field) this.#scheduleAnnouncement(reading);\n    if (report && previous && this.#detailsDiffer(previous, detail)) {\n      this.dispatch(\"reconcile\", { detail });\n    }\n  }\n\n  /** Commits a composition only when it came from the field still owned here. */\n  #commitFrom(target: EventTarget | null): void {\n    const field = this.#boundField;\n    if (!field || target !== field || this.#field !== field) return;\n    this.#commit(field);\n  }\n\n  /** Reflects one confirmed user input and reports only a real length transition. */\n  #commit(field: CharacterCounterField): void {\n    const reading = this.#render(field);\n    const previousLength = this.#lastLength;\n    const previousDetail = this.#lastDetail;\n    const detail = this.#detail(reading);\n    this.#lastLength = reading.length;\n    this.#lastDetail = detail;\n    if (previousLength === reading.length) {\n      if (previousDetail && this.#detailsDiffer(previousDetail, detail)) {\n        this.dispatch(\"reconcile\", { detail });\n      }\n      return;\n    }\n\n    this.dispatch(\"change\", { detail });\n    this.#scheduleAnnouncement(reading);\n  }\n\n  /** Selects the public event state from the richer internal reading. */\n  #detail(reading: CharacterCountReading): CharacterCounterDetail {\n    return {\n      length: reading.length,\n      remaining: reading.remaining,\n      over: reading.over,\n    };\n  }\n\n  /** Compares exactly the state carried by `change` and `reconcile`. */\n  #detailsDiffer(left: CharacterCounterDetail, right: CharacterCounterDetail): boolean {\n    return (\n      left.length !== right.length || left.remaining !== right.remaining || left.over !== right.over\n    );\n  }\n\n  /**\n   * Synchronizes visible count, state hooks, and temporary validation ARIA.\n   *\n   * @stimeoRenderRoot\n   */\n  #render(field: CharacterCounterField): CharacterCountReading {\n    const length = field.value.length;\n    const max = this.#normalizeCount(this.maxValue);\n    const warnAt = this.#normalizeCount(this.warnAtValue);\n    const remaining = max > 0 ? max - length : null;\n    const over = remaining !== null && remaining < 0;\n    const near = remaining !== null && warnAt > 0 && !over && remaining <= warnAt;\n\n    this.#toggle(\"data-over-limit\", over);\n    this.#toggle(\"data-near-limit\", near);\n    this.#reflectInvalid(field, over);\n\n    const text = this.#format(length, remaining, max);\n    this.#writeOutput(text);\n    return { length, remaining, over, max, text };\n  }\n\n  /** Clears derived output when the declarative input set has no usable field. */\n  #renderEmpty(): void {\n    this.#ariaInvalid.returnAll();\n    this.#reflectedOver = null;\n    this.#clearStateHooks();\n    this.#writeOutput(\"\");\n  }\n\n  /** Replaces the observed field symmetrically, returning state from the old one. */\n  #bindField(field: CharacterCounterField | null): void {\n    if (field === this.#boundField) return;\n\n    const previous = this.#boundField;\n    if (previous) {\n      previous.removeEventListener(\"input\", this.#onInput);\n      this.#composition.unobserve(previous);\n      this.#ariaInvalid.return(previous);\n    }\n\n    this.#boundField = field;\n    this.#lastLength = null;\n    this.#reflectedOver = null;\n    if (!field) return;\n\n    field.addEventListener(\"input\", this.#onInput);\n    this.#composition.observe(field);\n  }\n\n  /** Leases `aria-invalid` only on the edge into over-limit, then returns it. */\n  #reflectInvalid(field: CharacterCounterField, over: boolean): void {\n    if (this.#reflectedOver === over) return;\n    this.#reflectedOver = over;\n    if (over) this.#ariaInvalid.write(field, \"true\");\n    else this.#ariaInvalid.return(field);\n  }\n\n  /** Builds the visible count for the normalized display mode. */\n  #format(length: number, remaining: number | null, max: number): string {\n    if (remaining === null) return String(length);\n    switch (this.#mode) {\n      case \"used\":\n        return String(length);\n      case \"both\":\n        return `${length}/${max}`;\n      default:\n        return String(remaining);\n    }\n  }\n\n  /** Debounces one i18n-neutral message into the shared polite announcer. */\n  #scheduleAnnouncement(reading: CharacterCountReading): void {\n    this.#cancelAnnouncement();\n    const message = fillTemplate(this.announceTextValue, {\n      count: reading.text,\n      length: reading.length,\n      remaining: reading.remaining ?? \"\",\n      max: reading.max,\n      over: String(reading.over),\n    });\n    if (message.trim().length === 0) return;\n\n    this.#announceId = this.#timeouts.set(() => {\n      announce(message);\n      this.#announceId = null;\n    }, CharacterCounterController.#announceDelay);\n  }\n\n  /** Cancels the one outstanding announcement without touching visible output. */\n  #cancelAnnouncement(): void {\n    if (this.#announceId !== null) this.#timeouts.clear(this.#announceId);\n    this.#announceId = null;\n  }\n\n  /** Writes the optional display only when its text actually changed. */\n  #writeOutput(text: string): void {\n    if (!this.hasOutputTarget || this.outputTarget.textContent === text) return;\n    this.outputTarget.textContent = text;\n  }\n\n  /** Reflects a presence-style state hook without redundant attribute writes. */\n  #toggle(name: string, on: boolean): void {\n    if (on) {\n      if (this.element.getAttribute(name) !== \"true\") this.element.setAttribute(name, \"true\");\n    } else if (this.element.hasAttribute(name)) {\n      this.element.removeAttribute(name);\n    }\n  }\n\n  /** Removes both state hooks owned by this controller. */\n  #clearStateHooks(): void {\n    this.#toggle(\"data-over-limit\", false);\n    this.#toggle(\"data-near-limit\", false);\n  }\n\n  /** Returns borrowed ARIA and transient hooks before Turbo snapshots the page. */\n  #rewindForCache(): void {\n    this.#cancelAnnouncement();\n    this.#ariaInvalid.returnAll();\n    this.#reflectedOver = null;\n    this.#clearStateHooks();\n  }\n\n  /** Converts a public count Value into a finite non-negative integer. */\n  #normalizeCount(raw: number): number {\n    if (!Number.isFinite(raw)) return 0;\n    return Math.max(0, Math.trunc(raw));\n  }\n\n  /** Falls back to `remaining` when an authored display mode is unknown. */\n  get #mode(): DisplayMode {\n    if (this.modeValue === \"used\" || this.modeValue === \"both\") return this.modeValue;\n    return \"remaining\";\n  }\n\n  /** The watched field: the first target, or a directly controlled form field. */\n  get #field(): CharacterCounterField | null {\n    if (this.hasInputTarget) return this.inputTarget;\n    const element: HTMLElement = this.element;\n    if (element instanceof HTMLInputElement || element instanceof HTMLTextAreaElement)\n      return element;\n    return null;\n  }\n}\n"]}

package/dist/controllers/checkbox_controller.d.ts

@@ -21,6 +21,9 @@ import { Controller } from '@hotwired/stimulus';
  * `indeterminate` property (announced as `mixed`) derived from its children, and
  * the cascade from a parent toggle to its children.
  *
+ * `change` and `reconcile` dispatch
+ * `{ checked: boolean, indeterminate: boolean, state: "all" | "partial" | "none" }`.
+ *
  * @remarks
  * Behavior only — the check mark and any "mixed" affordance are the consumer's
  * CSS (keyed off `:checked` / `:indeterminate` / `data-state`). The `parent`