RubyGems - stimeo-ui - Versions diffs - 0.14.0 → 0.15.0 - Mend

stimeo-ui 0.14.0 → 0.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (35) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +34 -0
data/dist/cable/index.js +60 -14
data/dist/controllers/announcer_controller.js +88 -61
data/dist/controllers/auto_submit_controller.js +40 -5
data/dist/controllers/breadcrumb_controller.js +29 -3
data/dist/controllers/calendar_controller.js +20 -3
data/dist/controllers/checkbox_controller.js +27 -2
data/dist/controllers/conditional_fields_controller.js +29 -6
data/dist/controllers/currency_input_controller.js +16 -9
data/dist/controllers/date_range_picker_controller.js +12 -3
data/dist/controllers/dirty_form_controller.js +32 -12
data/dist/controllers/flash_controller.js +145 -43
data/dist/controllers/frame_loading_controller.js +29 -6
data/dist/controllers/highlight_controller.js +63 -23
data/dist/controllers/local_time_controller.js +10 -5
data/dist/controllers/masonry_controller.js +31 -13
data/dist/controllers/optimistic_controller.js +28 -4
data/dist/controllers/overflow_indicator_controller.js +31 -8
data/dist/controllers/overflow_menu_controller.js +29 -3
data/dist/controllers/read_more_controller.js +31 -5
data/dist/controllers/reading_progress_controller.js +65 -19
data/dist/controllers/relative_time_controller.js +10 -5
data/dist/controllers/scroll_area_controller.js +70 -26
data/dist/controllers/scroll_restore_controller.js +37 -16
data/dist/controllers/scroll_visibility_controller.js +49 -29
data/dist/controllers/scrollspy_controller.js +65 -26
data/dist/controllers/smart_sticky_header_controller.js +49 -25
data/dist/controllers/stick_to_bottom_controller.js +29 -3
data/dist/controllers/submit_once_controller.js +29 -6
data/dist/controllers/textarea_autosize_controller.js +29 -3
data/dist/controllers/toast_controller.js +136 -73
data/dist/index.js +473 -435
data/lib/stimeo/ui/version.rb +1 -1
metadata +2 -2

checksums.yaml CHANGED Viewed

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8220bc5fa861ec2aa75c7abeb2fcb6758a4ba6b56606b77d5bc6d948c9550a09
-  data.tar.gz: 95b3643b1a9bbdfdf7d556b5952c1431e6adc1ae557e5d0cf5f40b102276593a
+  metadata.gz: 401c70da7398b7e246c7858cebc821e6f9b6e6a079b196ad277180187aa1ae9d
+  data.tar.gz: ff726d279d0e91491558b60e69bacf76ae8a3d340c7ee5cd94982f8bc00e02d7
 SHA512:
-  metadata.gz: 837c894e5a64b823b2afc662dc4cb6e74daeedb04bee3d348bbd56127ee544cb31247f0534ffca2c60a1f676a2421ec2e3dbe0bef6ecbaeed85eac17f41ac1e1
-  data.tar.gz: 22e7cfc49254e48c27915cb9b83f632ea1348db396046a5a41be5513c8a8e4f01f00feee422c582c2423569d1cdf73228201ffc848554bb54cd1d927e18d9550
+  metadata.gz: 70da6b350c9495cfada5f6f17606e11092274160587faf5e62b8b7767e685d8dc4aa63bf096cf62d1f9e1ad6ee9629a7bbbba9eecd0999d061c0baff993648ce
+  data.tar.gz: 93f0139a4720f0b00109f0bb8ff3833be11d4780db1a8993effb7624b39f327861c09f3b7b6c0d37f8dbba4c26101aec6d0c81f2c35382f6f0c938655f42704f

data/CHANGELOG.md CHANGED Viewed

@@ -7,6 +7,39 @@ 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.15.0] - 2026-09-20
+Minor release with no new components. Shared internals were consolidated across
+five refactors; toast and the locale-aware components change behaviour, so read
+Changed before upgrading. The Inspector manifest stays on schema v12.
+### Added
+- calendar, date-range-picker: a `locale` Value.
+### Changed
+- toast: a toast whose dismiss deadline has already lapsed is no longer removed
+  the moment a pointer or focus enters it. It stays, marked `data-paused="true"`,
+  and leaves 1ms after the last hold is released — so focus never drops to
+  `<body>` from under the close button it was on.
+- calendar, date-range-picker: the month label resolves its locale as the
+  `locale` Value, then the nearest `lang` (the element itself included), then the
+  runtime default — instead of `<html lang>` with an `"en"` fallback.
+- currency-input: `locale` no longer defaults to `"en-US"` and resolves the same
+  way, so a page under `<html lang="de">` reads and writes `1.234,56`. The hidden
+  value stays in its ASCII normal form, and a declaration `Intl` rejects still
+  falls back to `"en-US"`.
+- auto-submit: the `stimeo--announcer:announce` it bridges carries
+  `assertive: false` and a trimmed `message`; a message of only whitespace is not
+  announced.
+### Fixed
+- announcer: region timers are released on `disconnect()` and before a Turbo
+  snapshot, so an announcement made after reconnecting can no longer cancel the
+  auto-clear of a different live region.
 ## [0.14.0] - 2026-09-19
 Minor release with no new components. input-mask changes what a broken `tokens`
@@ -1068,6 +1101,7 @@ Initial public alpha: 101 behavior-only, accessible Stimulus controllers driven
 by `data-*` attributes, shipping no CSS. Published to npm (with provenance) and
 RubyGems.
+[0.15.0]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.15.0
 [0.14.0]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.14.0
 [0.13.0]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.13.0
 [0.12.0]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.12.0

data/dist/cable/index.js CHANGED Viewed

@@ -530,6 +530,51 @@ var LiveCounterController = class _LiveCounterController extends Controller {
     }, _LiveCounterController.#announceDelay);
   }
 };
+// src/utils/keyed_timers.ts
+var KeyedTimers = class {
+  #timers = new SafeTimeout();
+  /** The pending timer of each key; an entry lives exactly as long as its timer. */
+  #pending = /* @__PURE__ */ new Map();
+  /**
+   * Arms `callback` after `delay` ms for `key`, cancelling the timer `key` had
+   * pending. The entry is dropped before the callback runs, so the callback sees
+   * the key unarmed and may arm it again for the next round.
+   */
+  set(key, callback, delay) {
+    this.clear(key);
+    const id = this.#timers.set(() => {
+      this.#pending.delete(key);
+      callback();
+    }, delay);
+    this.#pending.set(key, id);
+  }
+  /**
+   * Cancels `key`'s pending timer, if it has one.
+   *
+   * A timer id is a positive integer, so `-1` stands for "nothing pending" and
+   * the registry ignores an id it does not own — the unarmed case needs no
+   * branch of its own, and no other key's timer can be reached from here.
+   */
+  clear(key) {
+    this.#timers.clear(this.#pending.get(key) ?? -1);
+    this.#pending.delete(key);
+  }
+  /**
+   * Cancels every pending timer and forgets every key. Call this from a
+   * controller's `disconnect()` so no timer, and no entry, outlives the element.
+   */
+  clearAll() {
+    this.#timers.clearAll();
+    this.#pending.clear();
+  }
+  /** Whether `key` has a timer pending. */
+  has(key) {
+    return this.#pending.has(key);
+  }
+};
+// src/cable/presence_controller.ts
 var BEACON_THROTTLE_MS = 2e3;
 var DEFAULT_HEARTBEAT_MS = 15e3;
 var DEFAULT_TIMEOUT_MS = 4e4;
@@ -554,6 +599,8 @@ var PresenceController = class _PresenceController extends Controller {
   #subscription = null;
   /** Present peers keyed by id (insertion order = join order). */
   #peers = /* @__PURE__ */ new Map();
+  /** Each peer's auto-expiry timer, restarted by every beacon from that peer. */
+  #expiry = new KeyedTimers();
   #timers = new SafeTimeout();
   #intervals = new SafeInterval();
   /** Epoch ms of the last outgoing beacon, for the convergence throttle. */
@@ -739,9 +786,8 @@ ${this.idValue}`;
     }
     const name = typeof beacon?.name === "string" ? beacon.name : "";
     const existing = this.#peers.get(id);
-    if (existing !== void 0) this.#timers.clear(existing.timer);
-    const timer = this.#timers.set(() => this.#drop(id), this.#timeout);
-    this.#peers.set(id, { name, timer });
+    this.#expiry.set(id, () => this.#drop(id), this.#timeout);
+    this.#peers.set(id, { name });
     if (existing === void 0) {
       this.#appendClone(id, name);
       this.#render();
@@ -757,7 +803,7 @@ ${this.idValue}`;
   #drop(id) {
     const peer = this.#peers.get(id);
     if (peer === void 0) return;
-    this.#timers.clear(peer.timer);
+    this.#expiry.clear(id);
     this.#peers.delete(id);
     this.#removeClone(id);
     this.#render();
@@ -834,6 +880,7 @@ ${this.idValue}`;
   /** Clears the transient roster state (connect reset + disconnect teardown). */
   #reset() {
     this.#timers.clearAll();
+    this.#expiry.clearAll();
     this.#pendingBeacon = null;
     this.#announceId = null;
     this.#peers.clear();
@@ -871,8 +918,10 @@ var TypingIndicatorController = class _TypingIndicatorController extends Control
   /** Identifier parameters parsed once from their declaration, never in the hot path. */
   #params = {};
   #subscription = null;
-  /** Names currently typing (other clients), each with its auto-clear timer id. */
-  #typers = /* @__PURE__ */ new Map();
+  /** Names currently typing (other clients), in the order their first signal arrived. */
+  #typers = /* @__PURE__ */ new Set();
+  /** Each typer's auto-clear timer, restarted by every further signal from that name. */
+  #expiry = new KeyedTimers();
   #timers = new SafeTimeout();
   /** Epoch ms of the last broadcast, for leading-edge throttling. */
   #lastSentAt = 0;
@@ -922,6 +971,7 @@ var TypingIndicatorController = class _TypingIndicatorController extends Control
     this.#subscription?.unsubscribe();
     this.#subscription = null;
     this.#timers.clearAll();
+    this.#expiry.clearAll();
     this.#announceId = null;
     this.#typers.clear();
     this.element.removeAttribute("data-typing");
@@ -945,13 +995,9 @@ var TypingIndicatorController = class _TypingIndicatorController extends Control
   #onReceived(data) {
     const name = data?.name;
     if (typeof name !== "string" || name === "" || name === this.nameValue) return;
-    const existing = this.#typers.get(name);
-    if (existing !== void 0) this.#timers.clear(existing);
-    const added = existing === void 0;
-    this.#typers.set(
-      name,
-      this.#timers.set(() => this.#untrack(name), this.#timeout)
-    );
+    const added = !this.#typers.has(name);
+    this.#typers.add(name);
+    this.#expiry.set(name, () => this.#untrack(name), this.#timeout);
     if (added) this.#render();
   }
   /**
@@ -1011,7 +1057,7 @@ var TypingIndicatorController = class _TypingIndicatorController extends Control
   }
   /** Writes the current typer set onto the hook and the status slot. */
   #paint() {
-    const names = [...this.#typers.keys()];
+    const names = [...this.#typers];
     this.element.setAttribute("data-typing", names.length > 0 ? "true" : "false");
     if (this.hasStatusTarget) {
       this.statusTarget.textContent = this.#message(names);

data/dist/controllers/announcer_controller.js CHANGED Viewed

@@ -31,39 +31,6 @@ var BeforeCacheReset = class _BeforeCacheReset {
   }
 };
-// 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). */
@@ -117,6 +84,82 @@ var SafeTimeout = class extends TimerRegistry {
   }
 };
+// src/utils/keyed_timers.ts
+var KeyedTimers = class {
+  #timers = new SafeTimeout();
+  /** The pending timer of each key; an entry lives exactly as long as its timer. */
+  #pending = /* @__PURE__ */ new Map();
+  /**
+   * Arms `callback` after `delay` ms for `key`, cancelling the timer `key` had
+   * pending. The entry is dropped before the callback runs, so the callback sees
+   * the key unarmed and may arm it again for the next round.
+   */
+  set(key, callback, delay) {
+    this.clear(key);
+    const id = this.#timers.set(() => {
+      this.#pending.delete(key);
+      callback();
+    }, delay);
+    this.#pending.set(key, id);
+  }
+  /**
+   * Cancels `key`'s pending timer, if it has one.
+   *
+   * A timer id is a positive integer, so `-1` stands for "nothing pending" and
+   * the registry ignores an id it does not own — the unarmed case needs no
+   * branch of its own, and no other key's timer can be reached from here.
+   */
+  clear(key) {
+    this.#timers.clear(this.#pending.get(key) ?? -1);
+    this.#pending.delete(key);
+  }
+  /**
+   * Cancels every pending timer and forgets every key. Call this from a
+   * controller's `disconnect()` so no timer, and no entry, outlives the element.
+   */
+  clearAll() {
+    this.#timers.clearAll();
+    this.#pending.clear();
+  }
+  /** Whether `key` has a timer pending. */
+  has(key) {
+    return this.#pending.has(key);
+  }
+};
+// 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/controllers/announcer_controller.ts
 var LEVELS = ["polite", "assertive"];
 var AnnouncerController = class extends Controller {
@@ -126,8 +169,14 @@ var AnnouncerController = class extends Controller {
     dedupeReannounce: { type: Boolean, default: true }
   };
   static actions = ["announce"];
-  /** Clear/re-announce timers; one `clearAll()` in disconnect tears them all down. */
+  /** Drain timers, which belong to a politeness level rather than to a region. */
   #timers = new SafeTimeout();
+  /**
+   * The one timer a region may have outstanding — its dedupe re-set, then its
+   * auto-clear. A region carries at most one, and the registry releases the
+   * previous one whenever a newer message takes the region over.
+   */
+  #regionTimers = new KeyedTimers();
   /** Live regions generated to stand in for absent targets, for teardown. */
   #generated = /* @__PURE__ */ new Map();
   /** Messages waiting to be written, oldest first, one queue per politeness. */
@@ -147,13 +196,6 @@ var AnnouncerController = class extends Controller {
   });
   /** Rewinds to an announceable initial state for the snapshot; see the remarks. */
   #beforeCache = new BeforeCacheReset(() => this.#rewindForCache());
-  /**
-   * The one timer a region may have outstanding — its dedupe re-set, then its
-   * auto-clear. Held weakly so a swapped-out target is not retained; a leftover
-   * id is harmless because {@link SafeTimeout.clear} no-ops on an id it does not
-   * own.
-   */
-  #pending = /* @__PURE__ */ new WeakMap();
   /**
    * Guards against handling the same CustomEvent twice. An event dispatched on
    * the controller element with `bubbles: true` reaches both the element and the
@@ -184,6 +226,7 @@ var AnnouncerController = class extends Controller {
     this.element.removeEventListener("stimeo--announcer:announce", this.#onAnnounceEvent);
     window.removeEventListener("stimeo--announcer:announce", this.#onAnnounceEvent);
     this.#timers.clearAll();
+    this.#regionTimers.clearAll();
     this.#queues.clear();
     this.#draining.clear();
     this.#removeGenerated();
@@ -314,13 +357,13 @@ var AnnouncerController = class extends Controller {
     }
     const region = this.#regionFor(level);
     if (this.dedupeReannounceValue && region.textContent === message) {
-      this.#cancelPending(region);
+      this.#regionTimers.clear(region);
       region.textContent = "";
       this.#scheduleDrain(level);
       return;
     }
     queue.shift();
-    this.#cancelPending(region);
+    this.#regionTimers.clear(region);
     region.textContent = message;
     this.#scheduleClear(region, message);
     if (queue.length > 0) this.#scheduleDrain(level);
@@ -328,7 +371,7 @@ var AnnouncerController = class extends Controller {
   /** Clears the region after `clearAfter` ms, unless a newer message replaced it. */
   #scheduleClear(region, message) {
     if (this.clearAfterValue <= 0) return;
-    this.#schedule(
+    this.#regionTimers.set(
       region,
       () => {
         if (region.textContent === message) region.textContent = "";
@@ -336,23 +379,6 @@ var AnnouncerController = class extends Controller {
       this.clearAfterValue
     );
   }
-  /**
-   * Arms `region`'s single pending timer. Callers reach here with the slot
-   * already free — `#drain` releases it before writing, and a fired timer clears its own
-   * entry below — so this does not cancel again.
-   */
-  #schedule(region, callback, delay) {
-    const id = this.#timers.set(() => {
-      this.#pending.delete(region);
-      callback();
-    }, delay);
-    this.#pending.set(region, id);
-  }
-  /** Releases `region`'s pending timer, if it has one. */
-  #cancelPending(region) {
-    this.#timers.clear(this.#pending.get(region) ?? -1);
-    this.#pending.delete(region);
-  }
   /**
    * Resolves the live region for a politeness level.
    *
@@ -378,6 +404,7 @@ var AnnouncerController = class extends Controller {
     this.#queues.clear();
     this.#draining.clear();
     this.#timers.clearAll();
+    this.#regionTimers.clearAll();
     for (const level of LEVELS) {
       if (this.#hasTargetFor(level)) {
         const target = level === "assertive" ? this.assertiveTarget : this.politeTarget;

data/dist/controllers/auto_submit_controller.js CHANGED Viewed

@@ -2,6 +2,17 @@ import { Controller } from '@hotwired/stimulus';
 // src/controllers/auto_submit_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 }
+    })
+  );
+}
 // src/utils/before_cache_reset.ts
 var BeforeCacheReset = class _BeforeCacheReset {
   /** Every subscribed instance, iterated by the one shared document listener. */
@@ -78,6 +89,30 @@ var CompositionTracker = class {
   };
 };
+// src/utils/listener_set.ts
+var ListenerSet = class {
+  /** The generation every `add` joins until the next `dispose()`. */
+  #abort = new AbortController();
+  /**
+   * Attaches `handler` to the open generation, exactly as the caller spelled it.
+   *
+   * The set supplies the signal, so `options` carries everything else the DOM
+   * accepts — `capture` included, which has to match at release time and no
+   * longer has a second place to drift from.
+   */
+  add(target, type, handler, options) {
+    target.addEventListener(type, handler, { ...options, signal: this.#abort.signal });
+  }
+  /**
+   * Releases every listener of the open generation, synchronously, and opens the
+   * next one. Idempotent, and safe before anything has been added.
+   */
+  dispose() {
+    this.#abort.abort();
+    this.#abort = new AbortController();
+  }
+};
 // src/utils/safe_timeout.ts
 var TimerRegistry = class {
   /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */
@@ -146,6 +181,8 @@ var AutoSubmitController = class extends Controller {
   #timers = new SafeTimeout();
   /** Id of the pending debounce timer, so a new keystroke can reset it. */
   #pendingId = 0;
+  /** Listeners that live with the bound form rather than with the connection. */
+  #formListeners = new ListenerSet();
   /** The form the listeners are attached to; target callbacks rebind it. */
   #boundForm = null;
   /** Rewinds the transient state hooks just before Turbo snapshots the page. */
@@ -155,9 +192,7 @@ var AutoSubmitController = class extends Controller {
     this.#boundForm?.removeAttribute("aria-busy");
     const message = this.messageValue;
     this.dispatch("done", { detail: { message: message || void 0 } });
-    if (this.announceValue && message) {
-      window.dispatchEvent(new CustomEvent("stimeo--announcer:announce", { detail: { message } }));
-    }
+    if (this.announceValue) announce(message);
   };
   /** Owns delegated IME lifecycle state and submits confirmed input text. */
   #composition = new CompositionTracker({
@@ -228,12 +263,12 @@ var AutoSubmitController = class extends Controller {
     if (previous) {
       this.#cancelPending();
       previous.removeAttribute("data-auto-submit-pending");
-      previous.removeEventListener("turbo:submit-end", this.#onSubmitEnd);
+      this.#formListeners.dispose();
       this.#composition.unobserve(previous);
     }
     this.#boundForm = form;
     if (!form) return;
-    form.addEventListener("turbo:submit-end", this.#onSubmitEnd);
+    this.#formListeners.add(form, "turbo:submit-end", this.#onSubmitEnd);
     this.#composition.observe(form);
   }
   /** Resolves the form: the explicit `form` target, else a `<form>` root, else null. */

data/dist/controllers/breadcrumb_controller.js CHANGED Viewed

@@ -63,10 +63,15 @@ var LayoutObserver = class {
   #resizeObserverFactory;
   #resizeObserver = null;
   #observingViewport = false;
+  #loadContainer = null;
   /** Stable bound handler so add/removeEventListener target the same reference. */
   #handleViewportResize = () => {
     this.#callback();
   };
+  /** Stable bound handler for the capture-phase `load`; see {@link observeDescendantLoads}. */
+  #handleDescendantLoad = () => {
+    this.#callback();
+  };
   constructor(callback, options = {}) {
     this.#callback = callback;
     this.#resizeObserverFactory = options.resizeObserverFactory ?? (typeof ResizeObserver === "undefined" ? null : (cb) => new ResizeObserver(cb));
@@ -102,14 +107,35 @@ var LayoutObserver = class {
     window.removeEventListener("resize", this.#handleViewportResize);
   }
   /**
-   * Releases every observation: disconnects the {@link ResizeObserver} and
-   * removes the viewport listener. Safe to call multiple times. Call this from a
-   * controller's `disconnect()`.
+   * Starts reporting a `load` from anywhere inside `container` — an image or a
+   * frame settling changes the box it sits in, and it measures as zero high until
+   * then. `load` does not bubble, so the subscription is a capture-phase listener
+   * on the container itself and nothing the caller spells.
+   *
+   * **One container at a time.** A further call moves the observation, so a widget
+   * whose content element is swapped at runtime releases the element it let go by
+   * naming the new one — there is no second place for the release to drift from.
+   */
+  observeDescendantLoads(container) {
+    this.unobserveDescendantLoads();
+    this.#loadContainer = container;
+    container.addEventListener("load", this.#handleDescendantLoad, true);
+  }
+  /** Stops reporting descendant loads without affecting element or viewport observation. */
+  unobserveDescendantLoads() {
+    this.#loadContainer?.removeEventListener("load", this.#handleDescendantLoad, true);
+    this.#loadContainer = null;
+  }
+  /**
+   * Releases every observation: disconnects the {@link ResizeObserver} and removes
+   * the viewport and descendant-load listeners. Safe to call multiple times. Call
+   * this from a controller's `disconnect()`.
    */
   disconnect() {
     this.#resizeObserver?.disconnect();
     this.#resizeObserver = null;
     this.unobserveViewport();
+    this.unobserveDescendantLoads();
   }
 };

data/dist/controllers/calendar_controller.js CHANGED Viewed

@@ -85,6 +85,11 @@ function monthLabelFormatter(locale) {
   return intlFormatter(Intl.DateTimeFormat, locale, MONTH_LABEL_OPTIONS, "en");
 }
+// src/utils/locale.ts
+function resolveLocale(element, declared = "") {
+  return declared || element.closest("[lang]")?.getAttribute("lang") || void 0;
+}
 // src/utils/safe_timeout.ts
 var TimerRegistry = class {
   /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */
@@ -147,8 +152,9 @@ var CalendarController = class extends Controller {
     selected: { type: String, default: "" },
     min: { type: String, default: "" },
     max: { type: String, default: "" },
-    weekStart: { type: Number, default: 0 }
+    weekStart: { type: Number, default: 0 },
     // 0 = Sunday, 1 = Monday, etc.
+    locale: { type: String, default: "" }
   };
   static actions = ["next", "onKeydown", "prev", "selectByClick"];
   static events = ["monthchange", "select"];
@@ -190,6 +196,17 @@ var CalendarController = class extends Controller {
     this.#syncFocusedDateWithMonth();
     this.render();
   }
+  /**
+   * Repaints the label when application code changes `locale` at runtime.
+   *
+   * Stimulus runs this for the initial Value too, before `connect()`. The paint
+   * it triggers is idempotent — the month comes from `month` (or, while that is
+   * still empty, from `focusedDate`), and `monthchange` only reports a move away
+   * from a month already announced, so the first paint never reports one.
+   */
+  localeValueChanged() {
+    this.render();
+  }
   /**
    * Stimulus lifecycle callback triggered automatically when the selectedValue changes.
    * Re-renders grid cells to update `aria-selected` indicators.
@@ -320,8 +337,8 @@ var CalendarController = class extends Controller {
     const year = monthStart.getFullYear();
     const month = monthStart.getMonth() + 1;
     if (this.hasLabelTarget) {
-      const lang = document.documentElement.lang || "en";
-      this.labelTarget.textContent = monthLabelFormatter(lang).format(monthStart);
+      const locale = resolveLocale(this.element, this.localeValue);
+      this.labelTarget.textContent = monthLabelFormatter(locale).format(monthStart);
     }
     const days = this.#calculateGridDays(year, month);
     const dayElements = this.dayTargets;

data/dist/controllers/checkbox_controller.js CHANGED Viewed

@@ -2,6 +2,30 @@ import { Controller } from '@hotwired/stimulus';
 // src/controllers/checkbox_controller.ts
+// src/utils/listener_set.ts
+var ListenerSet = class {
+  /** The generation every `add` joins until the next `dispose()`. */
+  #abort = new AbortController();
+  /**
+   * Attaches `handler` to the open generation, exactly as the caller spelled it.
+   *
+   * The set supplies the signal, so `options` carries everything else the DOM
+   * accepts — `capture` included, which has to match at release time and no
+   * longer has a second place to drift from.
+   */
+  add(target, type, handler, options) {
+    target.addEventListener(type, handler, { ...options, signal: this.#abort.signal });
+  }
+  /**
+   * Releases every listener of the open generation, synchronously, and opens the
+   * next one. Idempotent, and safe before anything has been added.
+   */
+  dispose() {
+    this.#abort.abort();
+    this.#abort = new AbortController();
+  }
+};
 // src/utils/microtask_coalescer.ts
 var MicrotaskCoalescer = class {
   #run;
@@ -42,6 +66,7 @@ var CheckboxController = class extends Controller {
   static events = ["change", "reconcile"];
   /** Collapses every lifecycle signal from one DOM update into one derived pass. */
   #reconcile = new MicrotaskCoalescer(() => this.#reconcileFromChildren());
+  #listeners = new ListenerSet();
   /** Aggregate this root last settled on, so a derived repair is reported once. */
   #committedState = null;
   /** Watches authored checked-attribute changes on retained target elements. */
@@ -59,14 +84,14 @@ var CheckboxController = class extends Controller {
       attributeFilter: ["checked"],
       subtree: true
     });
-    this.element.addEventListener("turbo:morph-element", this.#onMorph);
+    this.#listeners.add(this.element, "turbo:morph-element", this.#onMorph);
     document.addEventListener("reset", this.#onReset, true);
   }
   /** Releases the observer, global reset listener, and every pending reconciliation. */
   disconnect() {
     this.#reconcile.cancel();
     this.#checkedObserver.disconnect();
-    this.element.removeEventListener("turbo:morph-element", this.#onMorph);
+    this.#listeners.dispose();
     document.removeEventListener("reset", this.#onReset, true);
   }
   /** Reconciles the aggregate for a parent added or replaced at runtime. */