npm - 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 (73) hide show

package/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

package/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);