stimeo-ui 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2883d44061c4c7ec8e5cd1a3b021c1d7fa8bf34bf8f2f74df1a3f496fe99f578
-  data.tar.gz: 9024ef97e2802777390ebc1a18cbbc202df8643ccac875d59b49a06bf6ae7f3e
+  metadata.gz: 8e3f69e3521c7e5d2ffa5e4b948aabbb26dc9bf8429217fa6235c9cdcafb53b1
+  data.tar.gz: d9722417ea447febdc5188eb50812a3725987f65a6920e49f98e852b5f0076ba
 SHA512:
-  metadata.gz: a6dd511725546fc75ffa9e150ff02640d22c09404238f9ac418b8042eac78fab90bf6c19e8266933a5b2c47178ccc13dea00793c76c7e4184f708e9619afb84c
-  data.tar.gz: 926ccd828054b1e374bc5e9039d94d0eb4b0c398a45b235090af702ce037993e2bff6b774f6932d39e8eabdb27e69ae80fd953e25b2a8ead7525c1ee6a59d585
+  metadata.gz: 1fe28608ac28813a4e12b448b438853d19e2acdd948fe2af5d287b615e83439a933023881a72bec2a50d579c384141be0c132310a640540b5d7eaee5554e2f28
+  data.tar.gz: ddb5ffd05af127033055296b6a66e6e71344b89dbcc42f0c88a34bc7e88193cb2c48deb67f4f2250edd19a0bed15957914c5ee90afd137ecce1c11cfc818df5b

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.7.0] - 2026-08-16
+
+Minor release reworking the form stack, separator, and scroll-area, with
+announcements moving onto the shared `stimeo--announcer`. The Inspector manifest
+moves to schema v12, so `stimeo check` can report on views that passed under
+0.6.0.
+
+### Removed
+
+- **Breaking** — direct-upload: the `status` target and the `announce` /
+  `doneLabel` / `errorLabel` Values. Use `announceDoneText` /
+  `announceErrorText` with `{name}` instead of `%{name}`.
+- **Breaking** — persist: the unversioned draft format. Drafts written by earlier
+  releases are discarded, not migrated.
+
+### Added
+
+- separator `min` / `max` / `value`; submit-once `finish` / `cancel` and
+  `idle` / `busy` targets; dirty-form `acceptRestore`; character-counter
+  `announceText`; form-field `setError(message, { focus })`; persist `error`;
+  `reconcile` on character-counter and conditional-fields.
+- form-validation: localized constraint wording through
+  `data-stimeo--form-validation-message[-<constraint>]`, a declarative
+  `disallow="whitespace"`, and controls attached with `form="id"`.
+- Inspector: schema v12 (`requiredActions`, `actionCompletion`) with the
+  `missing-required-action`, `missing-action-completion`, and
+  `missing-announcer` diagnostics.
+
+### Changed
+
+- **Breaking** — announcing components need a `stimeo--announcer` on the page
+  plus the wording: character-counter `announceText`, direct-upload
+  `announceDoneText` / `announceErrorText`, submit-once `announceText` /
+  `announceReadyText`. Drop `role="alert"` from form-field's `error` target and
+  `aria-live` from character-counter's `output`.
+- **Breaking** — separator: the Values are the only runtime input, so move
+  `role`, `tabindex`, and the orientation / range ARIA into `orientation`,
+  `focusable`, `min`, `max`, `step`, and `value`. A `focusable` separator also
+  needs `keydown->stimeo--separator#onKeydown` on itself and an accessible name.
+- **Breaking** — submit-once: sessions are per form, and `preventDefault()` no
+  longer ends one — wire `finish` or `cancel`, or set a `timeout`. `start` /
+  `end` carry `{ form, submitter, … }`.
+- **Breaking** — direct-upload: `done` fires only on success, and a row that
+  reached `error` stays there.
+- **Breaking** — dirty-form: a successful submit re-baselines to what Turbo
+  submitted, so later edits stay dirty, and one native confirmation covers every
+  dirty form per navigation. With persist, add
+  `data-action="stimeo--persist:restore->stimeo--dirty-form#acceptRestore"`.
+- **Breaking** — character-counter: `change` fires only when a committed edit
+  changes the length. form-field: `validate` fires only for `setError` /
+  `clearError`.
+- persist: `exclude` defaults to Rails' `authenticity_token` / `_method` /
+  `utf8`; `password` is always excluded regardless of the list.
+
+### Fixed
+
+- Attribute and style leases are released by the subscriber that owns the
+  lifecycle, so a cached page no longer retains detached elements.
+- localStorage access goes through one guarded helper, so persist, sidebar, and
+  theme keep working when the browser denies storage.
+
 ## [0.6.0] - 2026-08-15
 
 Minor release that separates reconciled state from user edits: `change` now
@@ -573,6 +634,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.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
 [0.4.0]: https://github.com/taiyaky/stimeo-ui/releases/tag/v0.4.0

data/dist/controllers/alert_dialog_controller.js

@@ -115,8 +115,81 @@ var EscapeLayer = class _EscapeLayer {
   }
 };
 
+// src/utils/focus_candidate.ts
+function inheritsFieldsetDisabled(control) {
+  let fieldset = control.closest("fieldset[disabled]");
+  while (fieldset) {
+    const legend = Array.from(fieldset.children).find((child) => child.tagName === "LEGEND");
+    if (!legend?.contains(control)) return true;
+    fieldset = fieldset.parentElement?.closest("fieldset[disabled]") ?? null;
+  }
+  return false;
+}
+function canTakeFocus(element) {
+  if (element.closest("[hidden], [inert]")) return false;
+  if (element instanceof HTMLInputElement && element.type === "hidden") return false;
+  if (!("disabled" in element)) return true;
+  if (element.disabled) return false;
+  return !inheritsFieldsetDisabled(element);
+}
+var TAB_STOP_CANDIDATE_SELECTOR = [
+  "a[href]",
+  "area[href]",
+  "button",
+  "input",
+  "select",
+  "textarea",
+  "summary",
+  "iframe",
+  "audio[controls]",
+  "video[controls]",
+  "[tabindex]",
+  "[contenteditable]"
+].join(",");
+function isRenderedForFocus(element) {
+  const check = element.checkVisibility;
+  return typeof check === "function" ? check.call(element, { visibilityProperty: true }) : true;
+}
+function authoredTabindex(element) {
+  const value = element.getAttribute("tabindex");
+  if (value === null || !/^[+-]?\d+$/.test(value.trim())) return null;
+  return Number(value);
+}
+function hasNativeTabStop(element) {
+  if (element instanceof HTMLAnchorElement || element instanceof HTMLAreaElement) {
+    return element.hasAttribute("href");
+  }
+  if (element instanceof HTMLButtonElement || element instanceof HTMLSelectElement || element instanceof HTMLTextAreaElement) {
+    return true;
+  }
+  if (element instanceof HTMLInputElement) return element.type !== "hidden";
+  if (element instanceof HTMLIFrameElement) return true;
+  if (element.tagName === "AUDIO" || element.tagName === "VIDEO") {
+    return element.hasAttribute("controls");
+  }
+  if (element instanceof HTMLElement && element.tagName === "SUMMARY") {
+    const details = element.parentElement;
+    return details instanceof HTMLDetailsElement && Array.from(details.children).find((child) => child.tagName === "SUMMARY") === element;
+  }
+  return false;
+}
+function hasEditableTabStop(element) {
+  const value = element.getAttribute("contenteditable")?.toLowerCase();
+  return value === "" || value === "true" || value === "plaintext-only";
+}
+function isTabStop(element) {
+  if (!canTakeFocus(element) || !isRenderedForFocus(element)) return false;
+  const tabindex = authoredTabindex(element);
+  if (tabindex !== null) return tabindex >= 0;
+  return hasNativeTabStop(element) || hasEditableTabStop(element);
+}
+function tabStopsWithin(root) {
+  return Array.from(root.querySelectorAll(TAB_STOP_CANDIDATE_SELECTOR)).filter(
+    isTabStop
+  );
+}
+
 // src/utils/focus_trap.ts
-var FOCUSABLE = 'a[href], button:not([disabled]), textarea:not([disabled]), input:not([disabled]), select:not([disabled]), [tabindex]:not([tabindex="-1"])';
 var FocusTrap = class {
   /** The element focused before activation, restored on deactivation. */
   #previouslyFocused = null;
@@ -278,9 +351,7 @@ var FocusTrap = class {
   }
   /** Collects the container's currently focusable descendants in DOM order. */
   #focusableElements() {
-    return Array.from(this.#getContainer().querySelectorAll(FOCUSABLE)).filter(
-      (el) => !el.hidden
-    );
+    return tabStopsWithin(this.#getContainer());
   }
 };
 

data/dist/controllers/avatar_controller.js

@@ -21,17 +21,21 @@ var AttributeLease = class {
         written: value
       });
     }
-    if (value === null) element.removeAttribute(this.#attribute);
-    else element.setAttribute(this.#attribute, 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);
-    if (element.getAttribute(this.#attribute) !== record.written) return;
-    if (record.original === null) element.removeAttribute(this.#attribute);
-    else element.setAttribute(this.#attribute, record.original);
+    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() {
@@ -39,6 +43,35 @@ var AttributeLease = class {
   }
 };
 
+// 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/microtask_coalescer.ts
 var MicrotaskCoalescer = class {
   #run;
@@ -81,6 +114,7 @@ var AvatarController = class extends Controller {
   /** Collapses one morph's Value, target, and direct-attribute signals into one pass. */
   #reconcile = new MicrotaskCoalescer(() => this.#render());
   /** Preserves directly-authored source and visibility while targets are controlled. */
+  #beforeCache = new BeforeCacheReset(() => this.#rewindForCache());
   #src = new AttributeLease("src");
   #imageHidden = new AttributeLease("hidden");
   #fallbackHidden = new AttributeLease("hidden");
@@ -96,6 +130,7 @@ var AvatarController = class extends Controller {
   connect() {
     this.#connected = true;
     this.#reconcile.activate();
+    this.#beforeCache.activate();
     this.#srcObserver.observe(this.element, {
       attributes: true,
       attributeFilter: ["src"],
@@ -107,6 +142,7 @@ var AvatarController = class extends Controller {
   disconnect() {
     this.#connected = false;
     this.#reconcile.cancel();
+    this.#beforeCache.deactivate();
     this.#srcObserver.disconnect();
   }
   /** Repaints when application code or a Turbo morph changes the source Value. */
@@ -214,6 +250,12 @@ var AvatarController = class extends Controller {
     }
     this.element.setAttribute("data-state", state);
   }
+  /** Returns borrowed image and fallback semantics before Turbo snapshots the page. */
+  #rewindForCache() {
+    this.#src.returnAll();
+    this.#imageHidden.returnAll();
+    this.#fallbackHidden.returnAll();
+  }
 };
 
 export { AvatarController };