npm - stimeo-ui - Versions diffs - 0.13.0 → 0.15.0 - Mend

stimeo-ui 0.13.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 (143) hide show

package/CHANGELOG.md CHANGED Viewed

@@ -7,6 +7,70 @@ 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`
+source falls back to, and currency-input, local-time, and relative-time narrow
+which failures they absorb, so read Changed before upgrading. The Inspector
+manifest stays on schema v12.
+### Added
+- Inspector: `missing-action-event` (error) — a `data-action` that omits the
+  event on an element with no default one binds nothing, while the markup still
+  reads as wired. The elements that have a default are `<a>`, `<button>`,
+  `<details>`, `<form>`, `<input>`, `<select>`, and `<textarea>`.
+- Inspector: `valueSyntaxConstraints` reports a `stimeo--otp` `pattern` that is
+  not a regular expression, and a `stimeo--input-mask` `tokens` that is not a
+  JSON object of them, before the page runs.
+### Changed
+- input-mask: a `tokens` source that does not compile leaves that key on its
+  default (`9`, `a`, `*`) instead of dropping the key, and a source that
+  compiles only against the anchors the controller adds — `0)|(1` — is refused.
+- currency-input, local-time, and relative-time absorb only what a declaration
+  can get wrong: a locale, time zone, currency code, or digit count `Intl`
+  rejects. Any other failure surfaces.
+- Inspector: a `data-action` that omits the event resolves to the one Stimulus
+  binds for that element, so a shorthand on a `<form>` reports
+  `missing-action-completion` where it passed in silence.
+- The markup examples in the published types name the event
+  (`click->stimeo--dialog#open`).
 ## [0.13.0] - 2026-09-13
 Minor release with no new components. The three server-bound components are
@@ -21,11 +85,13 @@ so read Changed before upgrading. The Inspector manifest stays on schema v12.
   A delta carrying your own `id` is applied unless an optimistic add of the same
   size is still outstanding. Runtime changes to `channel` / `params`
   re-subscribe.
-- presence: a leave notice is sent by the last element claiming that `id` rather
-  than by every element, a `channel` key in `params` no longer overrides the
-  declared `channel`, `heartbeat` / `timeout` fall back to their defaults unless
-  finite, positive and at most 2147483647 — typing-indicator's `timeout` takes
-  the same bound — and `template` clones only its root element.
+- presence: on `disconnect()` a leave notice is sent by the last element claiming
+  that `id` rather than by every element; `pagehide` still sends from each one,
+  because the whole page is going away. A `channel` key in `params` no longer
+  overrides the declared `channel`, `heartbeat` / `timeout` fall back to their
+  defaults unless finite, positive and within the browser timer ceiling
+  (2147483647 ms) — typing-indicator's `timeout` takes the same bound — and
+  `template` clones only its root element.
 - optimistic: `turbo:submit-end` is matched to the submission it names instead of
   to any ending that reaches the element, so a submission whose ending never
   arrives no longer strands the element. The `data-optimistic-toggled` marker
@@ -1035,6 +1101,8 @@ Initial public alpha: 101 behavior-only, accessible Stimulus controllers driven
 by `data-*` attributes, shipping no CSS. Published to npm (with provenance) and
 RubyGems.
+[0.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
 [0.11.0]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.11.0

package/dist/cable/index.d.ts CHANGED Viewed

@@ -14,7 +14,7 @@ import { Controller, Application } from '@hotwired/stimulus';
  *        data-stimeo--live-counter-params-value='{"post":42}'
  *        data-stimeo--live-counter-id-value="<%= SecureRandom.uuid %>">
  *     <span data-stimeo--live-counter-target="value">128</span>
- *     <button type="button" data-action="stimeo--live-counter#increment"
+ *     <button type="button" data-action="click->stimeo--live-counter#increment"
  *             data-stimeo--live-counter-target="trigger">♥</button>
  *   </div>
  *

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