stimeo-ui 0.16.0 → 0.17.0

data/dist/controllers/otp_controller.js

@@ -1,14 +1,21 @@
 import { Controller } from '@hotwired/stimulus';
 
-// src/controllers/otp_controller.ts
+function sharedRegistry(key, create) {
+  const symbol = Symbol.for(key);
+  const scope = globalThis;
+  const existing = scope[symbol];
+  if (existing !== void 0) return existing;
+  const registry = create();
+  Object.defineProperty(globalThis, symbol, { value: registry });
+  return registry;
+}
 
-// src/utils/aria_ids.ts
-var counter = 0;
+var ids = sharedRegistry("stimeo-ui.aria-ids.registry.v1", () => ({ counter: 0 }));
 function uniqueId(prefix = "stimeo") {
   let candidate;
   do {
-    counter += 1;
-    candidate = `${prefix}-${counter}`;
+    ids.counter += 1;
+    candidate = `${prefix}-${ids.counter}`;
   } while (typeof document !== "undefined" && document.getElementById(candidate) !== null);
   return candidate;
 }
@@ -19,12 +26,10 @@ function ensureId(element, prefix = "stimeo") {
   return id;
 }
 
-// src/utils/logical_scroll.ts
 function isRtl(element) {
   return window.getComputedStyle(element).direction === "rtl";
 }
 
-// src/utils/arrow_step.ts
 function logicalArrowKey(key, element) {
   if (key !== "ArrowRight" && key !== "ArrowLeft") return key;
   if (!isRtl(element)) return key;
@@ -35,77 +40,143 @@ function isReservedArrowChord(event, allow = []) {
   return event.altKey && !allow.includes("alt") || event.ctrlKey && !allow.includes("ctrl") || event.metaKey && !allow.includes("meta") || event.shiftKey && !allow.includes("shift");
 }
 
-// src/utils/attribute_lease.ts
-var AttributeLease = class {
+function isAttributeValue(value) {
+  return value === null || typeof value === "string";
+}
+function readLeaseRecord(element, record) {
+  try {
+    const parsed = JSON.parse(element.getAttribute(record) ?? "null");
+    if (!Array.isArray(parsed)) return void 0;
+    const [original, written, ...rest] = parsed;
+    const linked = rest[0] !== false;
+    const beneath = linked ? rest : rest.slice(1);
+    if (!beneath.every((under) => typeof under === "string")) return void 0;
+    return isAttributeValue(original) && isAttributeValue(written) ? { original, written, linked, beneath } : void 0;
+  } catch {
+    return void 0;
+  }
+}
+var AttributeLease = class _AttributeLease {
+  static #registry = sharedRegistry(
+    "stimeo-ui.attribute-lease.registry.v1",
+    () => ({ stacks: /* @__PURE__ */ new WeakMap(), names: /* @__PURE__ */ new Map() })
+  );
   #attribute;
-  #records = /* @__PURE__ */ new Map();
-  /** @param attribute - The attribute whose temporary values this lease owns. */
-  constructor(attribute) {
+  #record;
+  #base;
+  #held = /* @__PURE__ */ new Set();
+  constructor(attribute, owner, options = {}) {
     this.#attribute = attribute;
+    this.#record = `data-${owner}-${attribute}-lease`;
+    this.#base = options.base === true;
+    const names = _AttributeLease.#registry.names;
+    names.set(attribute, (names.get(attribute) ?? /* @__PURE__ */ new Set()).add(this.#record));
   }
-  /** Writes or removes the leased attribute while preserving its authored value. */
   write(element, value) {
-    const existing = this.#records.get(element);
-    if (existing) {
-      existing.written = value;
-    } else {
-      this.#records.set(element, {
-        original: element.getAttribute(this.#attribute),
-        written: value
-      });
-    }
-    this.#reflect(element, value);
+    const stack = this.#stack(element);
+    const hold = this.#take(stack) ?? this.#acquire(element, stack);
+    this.#held.add(element);
+    const shows = !this.#covered(element, stack, hold);
+    hold.written = value;
+    this.#mark(element, stack);
+    if (shows) 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);
-    const stillOwned = element.getAttribute(this.#attribute) === record.written;
-    if (stillOwned) this.#reflect(element, record.original);
+    const held = this.#held.delete(element);
+    const known = _AttributeLease.#registry.stacks.get(element)?.has(this.#attribute);
+    const stack = held || known || element.hasAttribute(this.#record) ? this.#stack(element) : [];
+    const hold = this.#take(stack);
+    if (!hold) return false;
+    const carries = element.getAttribute(this.#attribute) === hold.written;
+    const owns = carries && !this.#covered(element, stack, hold);
+    const index = stack.indexOf(hold);
+    stack.splice(index, 1);
+    const above = stack[index];
+    if (above) above.linked &&= hold.linked;
+    this.#mark(element, stack);
+    if (!owns) return true;
+    const below = hold.linked ? stack[index - 1] : void 0;
+    this.#reflect(element, below ? below.written : hold.original);
+    return true;
+  }
+  returnAll() {
+    for (const element of Array.from(this.#held)) this.return(element);
+  }
+  #stack(element) {
+    const stacks = _AttributeLease.#registry.stacks;
+    const byAttribute = stacks.get(element) ?? /* @__PURE__ */ new Map();
+    stacks.set(element, byAttribute);
+    const stack = byAttribute.get(this.#attribute) ?? this.#seed(element);
+    byAttribute.set(this.#attribute, stack);
+    return stack;
+  }
+  #seed(element) {
+    const found = [];
+    for (const record of _AttributeLease.#registry.names.get(this.#attribute) ?? []) {
+      const read = readLeaseRecord(element, record);
+      if (read) found.push({ ...read, record });
+    }
+    const depth = ({ beneath }) => beneath.filter((name) => found.some((other) => other.record === name)).length;
+    return found.sort((one, other) => depth(one) - depth(other)).map(({ record, written, original, linked }, index) => ({
+      lease: null,
+      record,
+      written,
+      original,
+      linked: linked && index > 0
+    }));
+  }
+  #take(stack) {
+    const hold = stack.find((held) => held.lease === this) ?? stack.find((held) => held.lease === null && held.record === this.#record);
+    if (hold) hold.lease = this;
+    return hold;
+  }
+  #acquire(element, stack) {
+    const current = element.getAttribute(this.#attribute);
+    const top = stack.at(-1);
+    const bottom = stack[0];
+    const over = top?.written === current ? top : void 0;
+    const from = this.#base ? bottom : over;
+    const hold = {
+      lease: this,
+      record: this.#record,
+      written: current,
+      original: from ? from.original : current,
+      linked: !this.#base && over !== void 0
+    };
+    if (this.#base && bottom) {
+      bottom.linked = true;
+      stack.unshift(hold);
+    } else stack.push(hold);
+    return hold;
+  }
+  #covered(element, stack, hold) {
+    const current = element.getAttribute(this.#attribute);
+    return stack.slice(stack.indexOf(hold) + 1).some((above) => above.written === current);
+  }
+  #mark(element, stack) {
+    const records = /* @__PURE__ */ new Map([[this.#record, null]]);
+    stack.forEach((hold, index) => {
+      const names = stack.slice(0, index).map((under) => under.record);
+      const beneath = [...new Set(names.reverse())].filter((name) => name !== hold.record);
+      const marker = hold.linked || beneath.length === 0 ? [] : [false];
+      records.set(
+        hold.record,
+        hold.written === hold.original && beneath.length === 0 && index === stack.length - 1 ? null : JSON.stringify([hold.original, hold.written, ...marker, ...beneath])
+      );
+    });
+    for (const [name, recorded] of records) {
+      if (element.getAttribute(name) === recorded) continue;
+      if (recorded === null) element.removeAttribute(name);
+      else element.setAttribute(name, recorded);
+    }
   }
-  /** 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() {
-    for (const element of Array.from(this.#records.keys())) this.return(element);
-  }
-};
-
-// 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 COMPOSITION_INPUT_TYPES = /* @__PURE__ */ new Set([
   "insertCompositionText",
   "insertFromComposition",
@@ -117,13 +188,11 @@ var CompositionTracker = class {
   #activeTargets = /* @__PURE__ */ new Set();
   #onStart;
   #onEnd;
-  /** The field whose confirming `input` is still owed, while the window is open. */
   #confirmedTarget = null;
   constructor(options = {}) {
     this.#onStart = options.onStart;
     this.#onEnd = options.onEnd;
   }
-  /** Starts lifecycle tracking for `target`; repeated calls are idempotent. */
   observe(target) {
     if (this.#observedTargets.has(target)) return;
     target.addEventListener("compositionstart", this.#handleStart);
@@ -131,7 +200,6 @@ var CompositionTracker = class {
     target.addEventListener("keydown", this.#handleKeydown);
     this.#observedTargets.add(target);
   }
-  /** Stops tracking one target and clears any active composition it owned. */
   unobserve(target) {
     if (!this.#observedTargets.delete(target)) return;
     target.removeEventListener("compositionstart", this.#handleStart);
@@ -140,7 +208,6 @@ var CompositionTracker = class {
     this.#activeTargets.delete(target);
     if (this.#confirmedTarget === target) this.#confirmedTarget = null;
   }
-  /** Releases every listener and clears state so reconnect starts cleanly. */
   disconnect() {
     for (const target of this.#observedTargets) {
       target.removeEventListener("compositionstart", this.#handleStart);
@@ -151,16 +218,9 @@ var CompositionTracker = class {
     this.#activeTargets.clear();
     this.#confirmedTarget = null;
   }
-  /** True when lifecycle tracking or the current event reports composition. */
   isComposing(event) {
     return this.#activeTargets.size > 0 || event?.isComposing === true;
   }
-  /**
-   * Whether `event` is the `input` echoing the composition just confirmed.
-   *
-   * Asking closes the window either way, so one confirmation is folded at most
-   * once and a consumer asks once per `input`.
-   */
   consumesConfirmedInput(event) {
     const confirmed = this.#confirmedTarget;
     this.#confirmedTarget = null;
@@ -178,13 +238,11 @@ var CompositionTracker = class {
     this.#confirmedTarget = event.target;
     this.#onEnd?.(event);
   };
-  /** A key on an observed field opens an edit of its own, so no echo is owed. */
   #handleKeydown = () => {
     this.#confirmedTarget = null;
   };
 };
 
-// src/utils/declared_value.ts
 function parseDeclared(raw, parse, fallback) {
   try {
     return parse(raw);
@@ -203,25 +261,18 @@ function compileRegExp(source, anchor = "none") {
   );
 }
 
-// src/utils/form_reset_watcher.ts
 var FormResetWatcher = class {
   #owns;
   #onReset;
   #frames = /* @__PURE__ */ new Set();
   #generation = 0;
-  /**
-   * @param owns - whether `form` owns a control this controller derives from.
-   * @param onReset - the reconciliation pass, run once per honoured reset.
-   */
   constructor(owns, onReset) {
     this.#owns = owns;
     this.#onReset = onReset;
   }
-  /** Subscribes to `reset` at the document; call from `connect()`. Idempotent. */
   observe() {
     document.addEventListener("reset", this.#handleReset, true);
   }
-  /** Unsubscribes and drops every pending pass; call from `disconnect()`. */
   disconnect() {
     document.removeEventListener("reset", this.#handleReset, true);
     this.#generation += 1;
@@ -245,13 +296,11 @@ var FormResetWatcher = class {
       this.#frames.add(frame);
     });
   };
-  /** Runs the pass unless a listener cancelled the reset before it landed. */
   #settle(event) {
     if (!event.defaultPrevented) this.#onReset();
   }
 };
 
-// src/utils/half_width.ts
 var FULL_WIDTH_SHIFT = 65248;
 function halfWidthChar(char) {
   if (char >= "\uFF01" && char <= "\uFF5E") {
@@ -265,27 +314,22 @@ function toHalfWidth(text) {
   return out;
 }
 
-// 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;
@@ -298,7 +342,17 @@ var MicrotaskCoalescer = class {
   }
 };
 
-// src/controllers/otp_controller.ts
+var MoveCounter = class {
+  #sequence = 0;
+  record() {
+    this.#sequence += 1;
+    return this.#sequence;
+  }
+  isLatest(token) {
+    return token === this.#sequence;
+  }
+};
+
 var LEASE_MARKERS = {
   "aria-invalid": "data-otp-invalid-lease",
   "aria-errormessage": "data-otp-errormessage-lease",
@@ -316,8 +370,8 @@ function readLease(field, marker) {
     return null;
   }
 }
-function describedByWith(described, errorId) {
-  const tokens = (described ?? "").split(/\s+/).filter((token) => token.length > 0 && token !== errorId);
+function describedByWith(described, errorId, earlier) {
+  const tokens = (described ?? "").split(/\s+/).filter((token) => token.length > 0 && token !== errorId && token !== earlier);
   return [...tokens, errorId].join(" ");
 }
 var DEFAULT_PATTERN = "[0-9]";
@@ -329,36 +383,23 @@ function statesDiffer(left, right) {
   return left.value !== right.value || left.state !== right.state;
 }
 var OtpController = class extends Controller {
+  #moves = new MoveCounter();
   static targets = ["field", "value", "error"];
   static values = {
     pattern: { type: String, default: DEFAULT_PATTERN }
   };
   static actions = ["onInput", "onKeydown", "onPaste", "onPointerDown", "clear"];
   static events = ["change", "complete", "invalid", "reconcile"];
-  /** Validated matcher; the hot path never compiles a raw declaration. */
   #pattern = DEFAULT_MATCHER;
-  /** Source of {@link #pattern}, reported in `invalid` so consumers can word it. */
   #patternSource = DEFAULT_PATTERN;
-  /** Public state carried by the last dispatch; keeps a no-op sync silent. */
   #published = null;
-  /** True between connect and disconnect, so pre-connect Value changes stay silent. */
   #connected = false;
-  /** Digit each field last committed, restored when rejected input replaced it. */
   #committed = /* @__PURE__ */ new WeakMap();
-  /** The field being composed, and the text it held when the composition began. */
   #composing = null;
-  /** A `pattern` change whose rejected characters wait for the composition to end. */
   #dropHeld = false;
-  /**
-   * Collapses one batch of page changes — field target and `pattern` callbacks, a
-   * form reset — into a single reconciliation.
-   */
   #reconcile = new MicrotaskCoalescer(() => this.#reconcileFields());
-  #errorHidden = new AttributeLease("hidden");
-  #state = new AttributeLease("data-state");
-  /** Rewinds the transient error surface before Turbo freezes the page. */
-  #beforeCache = new BeforeCacheReset(() => this.#clearError());
-  /** Reads the fields back once a native reset restored them, as a reconciliation. */
+  #errorHidden = new AttributeLease("hidden", this.identifier);
+  #state = new AttributeLease("data-state", this.identifier);
   #formReset = new FormResetWatcher(
     (form) => this.#ownedBy(form),
     () => {
@@ -366,11 +407,6 @@ var OtpController = class extends Controller {
       this.#reconcile.schedule();
     }
   );
-  /**
-   * Owns IME lifecycle state across every digit field. When a composition ends, a
-   * `pattern` drop it held back applies first — it was declared first — and the
-   * user's commit is taken after it.
-   */
   #composition = new CompositionTracker({
     onStart: (event) => {
       const field = this.#fieldFrom(event);
@@ -394,7 +430,6 @@ var OtpController = class extends Controller {
     this.#connected = true;
     for (const field of this.fieldTargets) this.#bind(field);
     this.#formReset.observe();
-    this.#beforeCache.activate();
     this.#reconcile.activate();
     this.#adopt();
     this.#sync();
@@ -404,35 +439,34 @@ var OtpController = class extends Controller {
     for (const field of this.fieldTargets) this.#unbind(field);
     this.#composition.disconnect();
     this.#formReset.disconnect();
-    this.#beforeCache.deactivate();
     this.#reconcile.cancel();
     this.#dropHeld = false;
     this.#clearError();
     this.#state.return(this.element);
   }
-  /**
-   * Stimulus lifecycle callback when a new field target enters the DOM.
-   * Wires the new field and folds the wider digit count into one reconciliation,
-   * which stays inert until `connect()` opens the window.
-   */
   fieldTargetConnected(element) {
     this.#bind(element);
     this.#adoptField(element);
     this.#reconcile.schedule();
   }
-  /** Releases a dropped field's listeners and leases, then reconciles the rest. */
   fieldTargetDisconnected(element) {
     this.#unbind(element);
     this.#returnLeases(element);
     this.#reconcile.schedule();
   }
-  /**
-   * Re-validates a changed `pattern` declaration once and drops any entered digit
-   * the new pattern no longer accepts, so the combined value stays interpretable.
-   * The page changed the declaration, so the move joins the same reconciliation
-   * as fields added or removed in that mutation. While a field is composing, its
-   * text is the IME's, and the drop waits for the composition to end.
-   */
+  valueTargetConnected() {
+    this.#reconcile.schedule();
+  }
+  valueTargetDisconnected() {
+    this.#reconcile.schedule();
+  }
+  errorTargetConnected() {
+    this.#followError();
+  }
+  errorTargetDisconnected(element) {
+    if (!this.errorTargets.includes(element)) this.#errorHidden.return(element);
+    this.#followError();
+  }
   patternValueChanged() {
     const compiled = compileRegExp(this.patternValue, "exact");
     this.#patternSource = compiled ? this.patternValue : DEFAULT_PATTERN;
@@ -444,7 +478,6 @@ var OtpController = class extends Controller {
     }
     if (this.#dropRejected()) this.#reconcile.schedule();
   }
-  /** Empties every writable field holding a character the pattern rejects; whether one did. */
   #dropRejected() {
     let dropped = false;
     for (const field of this.fieldTargets) {
@@ -455,7 +488,6 @@ var OtpController = class extends Controller {
     }
     return dropped;
   }
-  /** Handles keystroke inputs, distributes autofilled text, and advances focus. */
   onInput(event) {
     const input = this.#fieldFrom(event);
     if (!input) return;
@@ -463,7 +495,6 @@ var OtpController = class extends Controller {
     if (this.#composition.isComposing(event)) return;
     this.#accept(input);
   }
-  /** Handles Backspace clearing, arrows, and home/end navigation. */
   onKeydown(event) {
     if (isReservedArrowChord(event)) return;
     const input = this.#fieldFrom(event);
@@ -526,18 +557,12 @@ var OtpController = class extends Controller {
       }
     }
   }
-  /** Divides pasted string characters across the available input fields. */
   onPaste(event) {
     const input = this.#fieldFrom(event);
     if (!input) return;
     event.preventDefault();
     this.#distribute(input, toHalfWidth(event.clipboardData?.getData("text") ?? ""));
   }
-  /**
-   * Redirects a pointer landing on an empty field to the earliest empty one, so
-   * a passcode is entered in order. Filled fields stay directly reachable for
-   * correction, and keyboard focus is left alone.
-   */
   onPointerDown(event) {
     const input = this.#fieldFrom(event);
     if (input?.value !== "") return;
@@ -546,7 +571,6 @@ var OtpController = class extends Controller {
     event.preventDefault();
     first.focus();
   }
-  /** Empties every writable field and restarts entry at the first of them. */
   clear() {
     for (const field of this.fieldTargets) {
       if (this.#isWritable(field)) this.#writeField(field, "");
@@ -561,7 +585,6 @@ var OtpController = class extends Controller {
       input.select();
     }
   };
-  /** Whether a form owns at least one field or the hidden combined value. */
   #ownedBy(form) {
     if (this.fieldTargets.some((field) => field.form === form)) return true;
     return this.hasValueTarget && this.valueTarget.form === form;
@@ -575,13 +598,10 @@ var OtpController = class extends Controller {
     this.#composition.unobserve(field);
     if (this.#composing?.field === field) this.#composing = null;
   }
-  /** Reads every field back so a restored or reset group starts consistent. */
   #adopt() {
     for (const field of this.fieldTargets) this.#adoptField(field);
     this.#clearError();
-    if (this.hasErrorTarget) this.errorTarget.setAttribute("hidden", "");
   }
-  /** Writes one error attribute, keeping the first authored value it displaces. */
   #lease(field, attribute, value) {
     const marker = LEASE_MARKERS[attribute];
     const held = readLease(field, marker);
@@ -589,7 +609,6 @@ var OtpController = class extends Controller {
     field.setAttribute(marker, JSON.stringify({ authored, written: value }));
     field.setAttribute(attribute, value);
   }
-  /** Gives one field's error attributes back where they still hold what this wrote. */
   #returnLeases(field) {
     for (const [attribute, marker] of Object.entries(LEASE_MARKERS)) {
       const held = readLease(field, marker);
@@ -600,31 +619,10 @@ var OtpController = class extends Controller {
       else field.setAttribute(attribute, held.authored);
     }
   }
-  /** Takes one field's current value as the truth behind its derived state. */
   #adoptField(field) {
     this.#committed.set(field, field.value);
     this.#markFilled(field, field.value);
   }
-  /**
-   * Absorbs one batch of page changes — fields added or removed, entered digits a
-   * new `pattern` rejects, fields a native form reset restored — as one state
-   * transition.
-   *
-   * Nobody edited the passcode here, so the move is reported as `reconcile`:
-   * automation listening for `change` must not read a re-render or a reset as an
-   * edit, and a passcode that happens to end up full must not fire the
-   * `complete` that submits it.
-   *
-   * Completeness moves on its own when the field count changes: dropping a
-   * trailing empty field completes a passcode whose combined value never moved,
-   * and adding one un-completes it. Comparing the whole derived state, not the
-   * string it contains, is what makes those transitions reportable.
-   *
-   * A change already in the DOM — a field added or removed, a reset — is
-   * published at once, even while a field is composing: that field counts by the
-   * character it had committed, never by the IME's uncommitted text. Only a
-   * `pattern` drop waits for the composition to end.
-   */
   #reconcileFields() {
     if (this.#dropHeld && this.#composing === null) {
       this.#dropHeld = false;
@@ -633,13 +631,9 @@ var OtpController = class extends Controller {
     const previous = this.#published;
     const current = this.#sync();
     if (previous && !statesDiffer(previous, current)) return;
+    this.#moves.record();
     this.dispatch("reconcile", { detail: { value: current.value } });
   }
-  /**
-   * Validates the text an entry point received and distributes what it accepts.
-   * `text` defaults to the field's own value; a confirmation passes the string it
-   * committed, which `maxlength` would otherwise have truncated.
-   */
   #accept(input, text = input.value) {
     const raw = toHalfWidth(text);
     if (raw === "") {
@@ -650,10 +644,6 @@ var OtpController = class extends Controller {
     }
     this.#distribute(input, raw);
   }
-  /**
-   * Fills `text`'s accepted characters into the writable fields at and after the
-   * entry point, then leaves focus on the field after the last one filled.
-   */
   #distribute(from, text) {
     const accepted = Array.from(text).filter((char) => this.#pattern.test(char));
     let reached = false;
@@ -678,11 +668,9 @@ var OtpController = class extends Controller {
     this.#clearError();
     this.#syncAndDispatch();
   }
-  /** Restores the digit a field committed before rejected input replaced it. */
   #restore(field) {
     this.#writeField(field, this.#committed.get(field) ?? "");
   }
-  /** Commits one field's value and the derived hook that reports it as entered. */
   #writeField(field, value) {
     field.value = value;
     this.#committed.set(field, value);
@@ -711,11 +699,9 @@ var OtpController = class extends Controller {
   #focusableBefore(index) {
     return this.#before(index).find((field) => this.#isFocusable(field)) ?? null;
   }
-  /** Fields before `index`, nearest first; empty at the first field. */
   #before(index) {
     return this.fieldTargets.slice(0, Math.max(index, 0)).reverse();
   }
-  /** The event's field target, or `null` when the wiring points somewhere else. */
   #fieldFrom(event) {
     const input = event.currentTarget;
     return this.fieldTargets.find((field) => field === input) ?? null;
@@ -723,19 +709,13 @@ var OtpController = class extends Controller {
   #combinedValue() {
     return this.fieldTargets.map((field) => this.#publishedText(field)).join("");
   }
-  /** Every field carries a character, and there is at least one field. */
   #isComplete() {
     const fields = this.fieldTargets;
     return fields.length > 0 && fields.every((field) => this.#publishedText(field).length > 0);
   }
-  /** A field's text as the combined value counts it: a composing field by its committed character. */
   #publishedText(field) {
     return field === this.#composing?.field ? this.#committed.get(field) ?? "" : field.value;
   }
-  /**
-   * Mirrors the combined value into the form and the root's readable state, and
-   * records what was published so the next pass can compare against it.
-   */
   #sync() {
     const combined = this.#combinedValue();
     if (this.hasValueTarget) {
@@ -755,31 +735,56 @@ var OtpController = class extends Controller {
     const previous = this.#published;
     const { value: combined } = this.#sync();
     if (previous?.value === combined) return;
+    const token = this.#moves.record();
     this.dispatch("change", { detail: { value: combined } });
+    if (!this.#moves.isLatest(token)) return;
     if (this.#isComplete()) {
       this.dispatch("complete", { detail: { value: combined } });
     }
   }
-  /** Surfaces rejected input on every field and on the optional error target. */
   #showError() {
     const errorId = this.hasErrorTarget ? ensureId(this.errorTarget, "stimeo--otp-error") : null;
     for (const field of this.fieldTargets) {
       this.#lease(field, "aria-invalid", "true");
-      if (!errorId) continue;
-      this.#lease(field, "aria-errormessage", errorId);
-      const described = field.getAttribute("aria-describedby");
-      this.#lease(field, "aria-describedby", describedByWith(described, errorId));
+      if (errorId) this.#pointAtError(field, errorId);
     }
     if (this.hasErrorTarget) this.#errorHidden.write(this.errorTarget, null);
     this.dispatch("invalid", { detail: { pattern: this.#patternSource } });
   }
-  /** Returns every error lease, restoring the authored error surface. */
+  #pointAtError(field, errorId) {
+    const earlier = readLease(field, LEASE_MARKERS["aria-errormessage"])?.written ?? null;
+    this.#lease(field, "aria-errormessage", errorId);
+    const described = field.getAttribute("aria-describedby");
+    this.#lease(field, "aria-describedby", describedByWith(described, errorId, earlier));
+  }
+  #followError() {
+    if (!this.#connected) return;
+    const reported = this.fieldTargets.filter(
+      (field) => readLease(field, LEASE_MARKERS["aria-invalid"]) !== null
+    );
+    if (reported.length === 0) {
+      this.#hideErrors();
+      return;
+    }
+    if (!this.hasErrorTarget) return;
+    const errorId = ensureId(this.errorTarget, "stimeo--otp-error");
+    for (const field of reported) this.#pointAtError(field, errorId);
+    this.#errorHidden.write(this.errorTarget, null);
+  }
   #clearError() {
     for (const field of this.fieldTargets) this.#returnLeases(field);
-    this.#errorHidden.returnAll();
+    if (!this.#connected) {
+      this.#errorHidden.returnAll();
+      return;
+    }
+    this.#hideErrors();
+  }
+  #hideErrors() {
+    const [first, ...others] = this.errorTargets;
+    for (const other of others) this.#errorHidden.return(other);
+    if (first) this.#errorHidden.write(first, "");
   }
 };
 
 export { OtpController };
-//# sourceMappingURL=otp_controller.js.map
 //# sourceMappingURL=otp_controller.js.map