stimeo-ui 0.7.0 → 0.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8e3f69e3521c7e5d2ffa5e4b948aabbb26dc9bf8429217fa6235c9cdcafb53b1
-  data.tar.gz: d9722417ea447febdc5188eb50812a3725987f65a6920e49f98e852b5f0076ba
+  metadata.gz: b7dc7faa9f1a7d87af3398be60736f22e76e8e1b6ef534d0b8605e3fcdb9f4eb
+  data.tar.gz: 05bd47298cc4e0592f1247140c83e1cedff106c91b6a972734e5d9d3a507e3ea
 SHA512:
-  metadata.gz: 1fe28608ac28813a4e12b448b438853d19e2acdd948fe2af5d287b615e83439a933023881a72bec2a50d579c384141be0c132310a640540b5d7eaee5554e2f28
-  data.tar.gz: ddb5ffd05af127033055296b6a66e6e71344b89dbcc42f0c88a34bc7e88193cb2c48deb67f4f2250edd19a0bed15957914c5ee90afd137ecce1c11cfc818df5b
+  metadata.gz: aa22c951a7b4d5ba07c34f5f17c86227f8079d1222c40d895a1198c274c021198dc89edad6c129df4526b79001455834c88bd7ffdd46eb95dbd76166dba5975e
+  data.tar.gz: f95da4d63fee6006b75ec78a7dd91a73d3535fe82b456a298dd7a273e1f415df829c0fe08fc4c065d0d680d70d8434874226f30eadb5eccf4e5fc1b5ef5c99cb

data/CHANGELOG.md

@@ -7,6 +7,67 @@ 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.8.0] - 2026-08-22
+
+Minor release with no new components. Eight existing ones are reworked —
+auto-submit, carousel, currency-input, file-dropzone, input-mask, nested-form,
+otp, and textarea-autosize — and of those, carousel, otp, and file-dropzone also
+changed their markup contracts, so read Removed and Changed before upgrading. The
+Inspector manifest stays on schema v12.
+
+### Removed
+
+- otp: `length` — the number of `field` targets is the passcode length.
+- file-dropzone: the `status` target, `dragLabel`, and the
+  `data-file-dropzone-slot` attributes.
+
+### Added
+
+- `reconcile` on auto-submit, direct-upload, file-dropzone, flash, frame-loading,
+  input-mask, nested-form, otp, spinner, and submit-once — it also reports the
+  state a Turbo rewind discarded, carrying what that component lost
+  (`{ files }`, `{ ids }`, `{ forms }`, `{ removed }`, or `{}`).
+- carousel: `data-state`, `inert` on inactive slides, `prefers-reduced-motion`,
+  and optional pickers. otp: `clear` / `onPointerDown`, and text carrying several
+  characters spread across the following fields. file-dropzone:
+  `allowDuplicates`, a `thumb` target, and the `announce*Text` wording.
+- Characters an IME commits full-width are read as their half-width form in
+  input-mask, otp, and currency-input.
+- Inspector: rules for the reworked markup — carousel's controller-owned ARIA,
+  the `playToggle` an `autoplay` carousel needs, the `prev` / `next` pair, a
+  finite positive `interval`, otp's group and field names, and the parts
+  file-dropzone's item template must contain.
+
+### Changed
+
+- carousel: drop the `data-action` wiring and any authored `aria-pressed` —
+  clicks, picker keys, hover, and focus are delegated, and `aria-pressed` /
+  `aria-disabled` / `aria-live` / `aria-atomic` are controller-owned. Name the
+  toggle with `aria-label`, pair `prev` with `next`, and give an `autoplay`
+  carousel a `playToggle` (WCAG 2.2.2).
+- otp: the root needs `role="group"` and a name, and each `field` its own.
+  `invalid` reports only input that filled no field.
+- file-dropzone: put a `stimeo--announcer` on the page, set the `announce*Text`
+  wording, and use `name` / `thumb` / `remove` targets in the item template with
+  an authored `aria-label`. Validation runs `type` → `size` → `duplicate` →
+  `count`, and `change` precedes `reject`.
+- input-mask: `change` fires only for a user edit; normalization and runtime
+  Value changes report `reconcile`. The manifest reports `tokens` as `String`
+  where it reported `Object`.
+- textarea-autosize: `resize` no longer fires when a connect leaves the height
+  unchanged; width, font, and runtime `minRows` / `maxRows` changes are followed.
+- currency-input keeps what was typed while typing and rounds on blur;
+  nested-form absorbs rows added or removed outside it; auto-submit follows a
+  swapped `form` target.
+
+### Fixed
+
+- carousel: the play toggle stops rotation — the `focusin` before the click no
+  longer makes the press resume instead. otp: a full-width commit into one field
+  fills the following ones. currency-input: a locale with non-Latin digits
+  reparses its own output. nested-form: a discarded-but-visible row's remove
+  button no longer swallows the click.
+
 ## [0.7.0] - 2026-08-16
 
 Minor release reworking the form stack, separator, and scroll-area, with
@@ -634,6 +695,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.8.0]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.8.0
 [0.7.0]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.7.0
 [0.6.0]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.6.0
 [0.5.0]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.5.0

data/dist/controllers/auto_submit_controller.js

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