stimeo-ui 0.7.0 → 0.9.0

package/dist/controllers/nested_form_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controllers/nested_form_controller.ts"],"names":[],"mappings":"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","file":"nested_form_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\n\n/**\n * Headless **nested / dynamic fields** for Rails `fields_for` +\n * `accepts_nested_attributes_for` (no dedicated APG pattern — form editing). The\n * Headless successor to the cocoon / nested_form gems: clone a `<template>` row,\n * renumber its index, and remove rows by flagging `_destroy` (persisted) or\n * dropping them from the DOM (unsaved).\n *\n * Markup contract (identifier: `stimeo--nested-form`):\n *   <div data-controller=\"stimeo--nested-form\" data-stimeo--nested-form-min-value=\"1\">\n *     <div data-stimeo--nested-form-target=\"list\">\n *       <!-- existing rows; a persisted row carries a _destroy flag + remove button -->\n *     </div>\n *     <template data-stimeo--nested-form-target=\"template\">\n *       <fieldset>\n *         <input name=\"order[items_attributes][__INDEX__][name]\">\n *         <button type=\"button\" data-stimeo--nested-form-target=\"remove\">Remove</button>\n *       </fieldset>\n *     </template>\n *     <button type=\"button\" data-stimeo--nested-form-target=\"add\"\n *             data-action=\"click->stimeo--nested-form#add\">Add</button>\n *   </div>\n *\n * `add` dispatches `{ index, element }`; `remove` dispatches `{ element, persisted }`.\n *\n * @remarks\n * Behavior only — server-side `accepts_nested_attributes_for`, per-field\n * validation, and reordering are out of scope. Row state lives **only** in the DOM\n * (inserted nodes + each `_destroy` hidden input); there is no module-scope index\n * counter, so the controller stays idempotent across Turbo swaps. Remove buttons\n * are handled by **delegation** on the container, so dynamically-added rows work\n * without per-row `data-action`. Adding a row moves focus to its first control and\n * removing returns focus to a neighbor (WCAG 2.2 2.4.3); count changes are announced\n * through the shared `stimeo--announcer` (WCAG 2.2 4.1.3) when `announce` +\n * `countMessage` are set. The delegated listener is removed on `disconnect()`.\n */\nexport class NestedFormController extends Controller<HTMLElement> {\n  static override targets = [\"list\", \"template\", \"add\", \"remove\", \"destroyFlag\"];\n  static override values = {\n    min: { type: Number, default: 0 },\n    max: { type: Number, default: 0 },\n    indexPlaceholder: { type: String, default: \"__INDEX__\" },\n    announce: { type: Boolean, default: true },\n    countMessage: { type: String, default: \"\" },\n  };\n  static actions = [\"add\"] as const;\n  static events = [\"add\", \"remove\"] as const;\n\n  declare readonly listTarget: HTMLElement;\n  declare readonly templateTarget: HTMLTemplateElement;\n  declare readonly addTarget: HTMLButtonElement;\n  declare readonly hasListTarget: boolean;\n  declare readonly hasTemplateTarget: boolean;\n  declare readonly hasAddTarget: boolean;\n\n  declare minValue: number;\n  declare maxValue: number;\n  declare indexPlaceholderValue: string;\n  declare announceValue: boolean;\n  declare countMessageValue: string;\n\n  /** Monotonic source for unique row indices; never a row-state counter. */\n  #lastIndex = 0;\n\n  /** Delegated click handler for the per-row remove buttons (dynamic-safe). */\n  readonly #onClick = (event: Event): void => {\n    const target = event.target as HTMLElement | null;\n    const button = target?.closest('[data-stimeo--nested-form-target=\"remove\"]');\n    if (!button || !this.element.contains(button)) return;\n    const row = this.#rowContaining(button);\n    if (row) this.#removeRow(row);\n  };\n\n  override connect(): void {\n    this.element.addEventListener(\"click\", this.#onClick);\n    this.#refresh();\n  }\n\n  override disconnect(): void {\n    this.element.removeEventListener(\"click\", this.#onClick);\n  }\n\n  /**\n   * Clones the template row, replaces the index placeholder with a unique value,\n   * appends it, focuses its first control, and announces the new count. No-ops at\n   * `max`.\n   */\n  add(): void {\n    if (!this.hasTemplateTarget || !this.hasListTarget || this.#atMax) return;\n\n    const index = this.#nextIndex();\n    const markup = this.templateTarget.innerHTML.replaceAll(\n      this.indexPlaceholderValue,\n      String(index),\n    );\n    this.listTarget.insertAdjacentHTML(\"beforeend\", markup);\n    const row = this.listTarget.lastElementChild as HTMLElement | null;\n    if (!row) return;\n\n    this.#refresh();\n    this.#firstControl(row)?.focus();\n    this.dispatch(\"add\", { detail: { index, element: row } });\n    this.#announce();\n  }\n\n  /**\n   * Removes a row: a persisted row (one carrying a `destroyFlag`) has its flag set\n   * to `1` and is hidden so Rails destroys it on submit; an unsaved row is dropped\n   * from the DOM. Returns focus to a neighboring row. No-ops at `min`.\n   */\n  #removeRow(row: HTMLElement): void {\n    if (this.#effectiveRows.length <= this.minValue) return;\n\n    const neighbors = this.#effectiveRows;\n    const position = neighbors.indexOf(row);\n    const neighbor = neighbors[position + 1] ?? neighbors[position - 1] ?? null;\n\n    const flag = row.querySelector<HTMLInputElement>(\n      '[data-stimeo--nested-form-target=\"destroyFlag\"]',\n    );\n    const persisted = flag !== null;\n    if (persisted) {\n      flag.value = \"1\";\n      row.hidden = true;\n    } else {\n      row.remove();\n    }\n\n    this.#refresh();\n    const focusTarget = neighbor\n      ? this.#firstControl(neighbor)\n      : this.hasAddTarget\n        ? this.addTarget\n        : null;\n    focusTarget?.focus();\n    this.dispatch(\"remove\", { detail: { element: row, persisted } });\n    this.#announce();\n  }\n\n  /** Recomputes the live count and the min/max state hooks from the DOM. */\n  #refresh(): void {\n    const count = this.#effectiveRows.length;\n    this.element.setAttribute(\"data-nested-count\", String(count));\n    this.#reflect(\"data-nested-at-max\", this.maxValue > 0 && count >= this.maxValue);\n    this.#reflect(\"data-nested-at-min\", count <= this.minValue);\n    if (this.hasAddTarget) this.addTarget.disabled = this.#atMax;\n  }\n\n  /** Bridges the count change to the shared announcer when configured. */\n  #announce(): void {\n    if (!this.announceValue || !this.countMessageValue) return;\n    const message = this.countMessageValue.replaceAll(\n      \"{count}\",\n      String(this.#effectiveRows.length),\n    );\n    window.dispatchEvent(new CustomEvent(\"stimeo--announcer:announce\", { detail: { message } }));\n  }\n\n  /** Sets `attribute` to `\"true\"` when `on`, else removes it. */\n  #reflect(attribute: string, on: boolean): void {\n    if (on) this.element.setAttribute(attribute, \"true\");\n    else this.element.removeAttribute(attribute);\n  }\n\n  /** A strictly-increasing unique index (collision-free even on rapid adds). */\n  #nextIndex(): number {\n    const index = Math.max(Date.now(), this.#lastIndex + 1);\n    this.#lastIndex = index;\n    return index;\n  }\n\n  get #atMax(): boolean {\n    return this.maxValue > 0 && this.#effectiveRows.length >= this.maxValue;\n  }\n\n  /** Direct child rows of the list that are not flagged for destruction. */\n  get #effectiveRows(): HTMLElement[] {\n    return (Array.from(this.listTarget.children) as HTMLElement[]).filter((row) => !row.hidden);\n  }\n\n  /** The nearest ancestor of `el` that is a direct child of the list, else null. */\n  #rowContaining(el: Element): HTMLElement | null {\n    let node: Element | null = el;\n    while (node && node.parentElement !== this.listTarget) {\n      node = node.parentElement;\n    }\n    return node as HTMLElement | null;\n  }\n\n  /** First visible focusable control inside `row` (skips hidden inputs). */\n  #firstControl(row: HTMLElement): HTMLElement | null {\n    return row.querySelector<HTMLElement>(\n      'input:not([type=\"hidden\"]), select, textarea, button, [tabindex]',\n    );\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/announce.ts","../../src/utils/attribute_lease.ts","../../src/utils/before_cache_reset.ts","../../src/utils/focus_candidate.ts","../../src/utils/microtask_coalescer.ts","../../src/utils/tabindex_loan.ts","../../src/controllers/nested_form_controller.ts"],"names":[],"mappings":"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","file":"nested_form_controller.js","sourcesContent":["/**\n * Sends one message to the page's shared `stimeo--announcer`.\n *\n * A component that has to reach assistive tech does not carry a live region of its\n * own: a region only announces what changes *after* assistive tech already knows\n * about it, which a region that appears (or is un-hidden) with its message cannot\n * satisfy. The one region that can is the announcer sitting in the page from the\n * start, so state changes are handed to it as an event and it does the reading.\n *\n * The event goes to `window` because the announcer is usually a sibling high in the\n * document rather than an ancestor of the component dispatching it.\n *\n * Wording comes from the consumer — the library ships no English strings — so an\n * empty message is silently dropped and nothing is announced.\n *\n * @example\n * ```ts\n * announce(this.announceTextValue, { assertive: false });\n * ```\n */\nexport function announce(message: string, options: { assertive?: boolean } = {}): void {\n  const text = message.trim();\n  if (text.length === 0) return;\n  window.dispatchEvent(\n    new CustomEvent(\"stimeo--announcer:announce\", {\n      detail: { message: text, assertive: options.assertive === true },\n    }),\n  );\n}\n\n/**\n * Fills `{name}` placeholders in an announcement template from `values`.\n *\n * The same substitution the value-text templates use, so a consumer writes\n * `\"{percent}% complete\"` in one attribute and gets the same rules everywhere. A\n * placeholder with no matching entry is left as authored rather than blanked, which\n * keeps a typo visible instead of silently swallowing the word.\n */\nexport function fillTemplate(template: string, values: Record<string, string | number>): string {\n  return template.replace(/\\{([a-zA-Z][a-zA-Z0-9]*)\\}/g, (match, name: string) => {\n    const replacement = values[name];\n    return replacement === undefined ? match : String(replacement);\n  });\n}\n","/** One temporarily controlled attribute value and the authored value it displaced. */\ninterface AttributeLeaseRecord {\n  readonly original: string | null;\n  written: string | null;\n}\n\n/**\n * Temporarily controls one attribute across a changing set of elements.\n *\n * The first write remembers the authored value, including the distinction between\n * an absent attribute and an authored empty string. Returning a lease restores that\n * value only while the attribute still matches the controller's last write. If a\n * consumer changed it in the meantime, the consumer owns the new value and teardown\n * leaves it alone.\n *\n * A `null` write deliberately removes the attribute while retaining the lease. This\n * is useful for derived ARIA whose valid absence is itself controller state, such as\n * an unbounded `aria-valuemin` or a blank spinbutton's `aria-valuenow`.\n *\n * The lease has no lifecycle of its own, so it never subscribes to document events.\n * A consumer that must not let a derived value become the authored baseline of a\n * cached page returns its leases from its own `turbo:before-cache` rewind, where the\n * matching `disconnect()` also releases the subscription.\n */\nexport class AttributeLease<T extends Element = Element> {\n  readonly #attribute: string;\n  readonly #records = new Map<T, AttributeLeaseRecord>();\n\n  /** @param attribute - The attribute whose temporary values this lease owns. */\n  constructor(attribute: string) {\n    this.#attribute = attribute;\n  }\n\n  /** Writes or removes the leased attribute while preserving its authored value. */\n  write(element: T, value: string | null): void {\n    const existing = this.#records.get(element);\n    if (existing) {\n      existing.written = value;\n    } else {\n      this.#records.set(element, {\n        original: element.getAttribute(this.#attribute),\n        written: value,\n      });\n    }\n\n    this.#reflect(element, value);\n  }\n\n  /** Returns one lease without overwriting a value subsequently authored by a consumer. */\n  return(element: T): void {\n    const record = this.#records.get(element);\n    if (!record) return;\n    this.#records.delete(element);\n    const stillOwned = element.getAttribute(this.#attribute) === record.written;\n    if (stillOwned) this.#reflect(element, record.original);\n  }\n\n  /** Reflects only a real value transition, avoiding self-triggered mutation work. */\n  #reflect(element: T, value: string | null): void {\n    if (element.getAttribute(this.#attribute) === value) return;\n    if (value === null) element.removeAttribute(this.#attribute);\n    else element.setAttribute(this.#attribute, value);\n  }\n\n  /** Returns every outstanding lease using the same ownership check as {@link return}. */\n  returnAll(): void {\n    for (const element of Array.from(this.#records.keys())) this.return(element);\n  }\n}\n","/**\n * Runs a controller's \"return to the initial state\" pass just before Turbo\n * caches the page.\n *\n * **`disconnect()` cannot do this job, for two independent reasons.** Turbo\n * queues the clone from this event rather than taking it here, and the body swap\n * that runs the controller's `disconnect()` is queued separately — so which of\n * the two lands first is not something a controller can rely on, and a rewind\n * written in `disconnect()` may reach only the DOM being thrown away. In the\n * other direction, `disconnect()` also fires on an in-page move (Stimulus tears\n * down and reconnects the same element), where rewinding would wipe a\n * legitimately in-progress interaction — a spinner mid-load would vanish. One\n * timing is unreliable, the other is too eager; `turbo:before-cache` is the only\n * point that is exactly \"the page is about to be frozen\".\n *\n * Scope is the subscription only: registering on `activate()`, unregistering on\n * `deactivate()`, and one shared document listener no matter how many instances\n * are live. *What* to return to its initial state — which `data-state`, which\n * `hidden`, which `aria-busy` — stays in the controller, because no two\n * consumers answer it the same way (the `MicrotaskCoalescer` split).\n *\n * **Rewind state, not appearance.** The pass writes attributes the controller\n * itself owns; the visual result of those attributes is the consumer's CSS, and\n * a library that reached for style or class names would be guessing at markup\n * it does not own.\n *\n * Both entry points are idempotent, so the lifecycle hooks can call them\n * unconditionally: a second `activate()` does not double-subscribe and does not\n * make the callback run twice, and `deactivate()` on an instance that never\n * subscribed is a no-op.\n *\n * This file's own doc block is dropped from `dist`, but every member comment is\n * inlined into each consumer entry (`tsup` builds with `splitting: false`), so\n * rationale belongs here and only the contract belongs on the members.\n *\n * @example\n * ```ts\n * readonly #beforeCache = new BeforeCacheReset(() => this.#rewind());\n *\n * connect()    { this.#beforeCache.activate(); }\n * disconnect() { this.#beforeCache.deactivate(); }\n * ```\n */\nexport class BeforeCacheReset {\n  /** Every subscribed instance, iterated by the one shared document listener. */\n  static readonly #subscribers = new Set<BeforeCacheReset>();\n\n  /** The shared listener; installed while at least one instance is subscribed. */\n  static readonly #onBeforeCache = (): void => {\n    for (const subscriber of BeforeCacheReset.#subscribers) subscriber.#rewind();\n  };\n\n  readonly #rewind: () => void;\n\n  /** @param rewind - the pass that returns this controller's state to its initial form. */\n  constructor(rewind: () => void) {\n    this.#rewind = rewind;\n  }\n\n  /** Subscribes to `turbo:before-cache`; call from `connect()`. Idempotent. */\n  activate(): void {\n    const first = BeforeCacheReset.#subscribers.size === 0;\n    BeforeCacheReset.#subscribers.add(this);\n    if (first) {\n      document.addEventListener(\"turbo:before-cache\", BeforeCacheReset.#onBeforeCache);\n    }\n  }\n\n  /** Unsubscribes; call from `disconnect()`. Safe when never subscribed. */\n  deactivate(): void {\n    BeforeCacheReset.#subscribers.delete(this);\n    if (BeforeCacheReset.#subscribers.size > 0) return;\n    document.removeEventListener(\"turbo:before-cache\", BeforeCacheReset.#onBeforeCache);\n  }\n}\n","/**\n * Whether a disabled `<fieldset>` ancestor actually reaches `control`.\n *\n * HTML exempts the contents of a fieldset's **first direct-child `<legend>`**, and\n * the exemption is per fieldset — a control legal in one legend can still be\n * disabled by a second, outer fieldset, so the walk continues upward.\n *\n * Exported for the consumer that needs this rule *without* the rest of\n * {@link canTakeFocus}: `toolbar` bounds its own `hidden` walk at the toolbar\n * root, which is a different rule, so it composes the two itself.\n */\nexport function inheritsFieldsetDisabled(control: HTMLElement): boolean {\n  let fieldset: Element | null = control.closest(\"fieldset[disabled]\");\n  while (fieldset) {\n    const legend = Array.from(fieldset.children).find((child) => child.tagName === \"LEGEND\");\n    if (!legend?.contains(control)) return true;\n    fieldset = fieldset.parentElement?.closest(\"fieldset[disabled]\") ?? null;\n  }\n  return false;\n}\n\n/**\n * Whether an element can actually take focus, checked **before** `focus()` runs.\n *\n * A controller that must move focus off a control it is about to disable or hide\n * picks a destination and calls `focus()` on it. If that destination cannot take\n * focus, the call **fails silently**: `hidden` and natively `disabled` elements\n * swallow it, so the caret stays in the subtree that is disappearing and lands on\n * `<body>` a frame later — the exact outcome the rescue exists to prevent, minus\n * any signal that it happened.\n *\n * Testing after the fact is the obvious alternative and is deliberately not the\n * rule. Reading `document.activeElement` back only works in a real browser, and\n * looping over candidates that way performs a real focus move per failure —\n * observable to assistive technology. Checking first costs nothing and catches\n * the cases that actually occur.\n *\n * **`aria-disabled` is not disqualifying.** It is the attribute an author uses\n * for a control that must stay *discoverable*, and the roving contract keeps\n * such items reachable. Only the three conditions that make the platform refuse\n * focus are checked: `hidden` / `inert` (an ancestor's counts),\n * `input[type=\"hidden\"]`, the native `disabled` property, and `disabled`\n * inherited from an ancestor `fieldset`. CSS-only invisibility is handled by\n * {@link isRenderedForFocus} when a consumer needs sequential-focus semantics.\n *\n * Reading `:disabled` instead of walking the fieldset chain would be shorter, but\n * that pseudo-class is not evaluated consistently outside real browsers and this\n * has to be right headlessly too. happy-dom in particular focuses a `<button>`\n * inside a disabled fieldset where a real engine refuses, so the inheritance is\n * spelled out rather than delegated.\n *\n * What a consumer does when nothing survives is its own call: some fall back to\n * their landmark, while a widget whose caret already sits somewhere legitimate\n * refuses the move outright rather than relocating it.\n *\n * @example\n * ```ts\n * const target = candidates.find(canTakeFocus);\n * if (target) target.focus();\n * else {\n *   this.#tabindex.lend(this.element); // nothing left: fall back to the landmark\n *   this.element.focus();\n * }\n * ```\n *\n * @param element - the candidate destination\n */\nexport function canTakeFocus(element: HTMLElement): boolean {\n  if (element.closest(\"[hidden], [inert]\")) return false;\n  if (element instanceof HTMLInputElement && element.type === \"hidden\") return false;\n  if (!(\"disabled\" in element)) return true;\n  if ((element as HTMLElement & { disabled: boolean }).disabled) return false;\n  return !inheritsFieldsetDisabled(element);\n}\n\n/** Elements whose semantics or authored attributes can place them in sequential focus order. */\nexport const TAB_STOP_CANDIDATE_SELECTOR = [\n  \"a[href]\",\n  \"area[href]\",\n  \"button\",\n  \"input\",\n  \"select\",\n  \"textarea\",\n  \"summary\",\n  \"iframe\",\n  \"audio[controls]\",\n  \"video[controls]\",\n  \"[tabindex]\",\n  \"[contenteditable]\",\n].join(\",\");\n\n/** Optional browser visibility API used to exclude CSS-hidden candidates. */\ninterface VisibilityCheckable {\n  checkVisibility?: (options?: { visibilityProperty?: boolean }) => boolean;\n}\n\n/** Whether CSS visibility allows an otherwise eligible element to participate in focus order. */\nexport function isRenderedForFocus(element: HTMLElement): boolean {\n  const check = (element as HTMLElement & VisibilityCheckable).checkVisibility;\n  return typeof check === \"function\" ? check.call(element, { visibilityProperty: true }) : true;\n}\n\n/** Parses an authored `tabindex`; invalid syntax has no explicit focus-order meaning. */\nfunction authoredTabindex(element: HTMLElement): number | null {\n  const value = element.getAttribute(\"tabindex\");\n  if (value === null || !/^[+-]?\\d+$/.test(value.trim())) return null;\n  return Number(value);\n}\n\n/** Whether the element's native semantics place it in sequential focus order. */\nfunction hasNativeTabStop(element: HTMLElement): boolean {\n  if (element instanceof HTMLAnchorElement || element instanceof HTMLAreaElement) {\n    return element.hasAttribute(\"href\");\n  }\n  if (\n    element instanceof HTMLButtonElement ||\n    element instanceof HTMLSelectElement ||\n    element instanceof HTMLTextAreaElement\n  ) {\n    return true;\n  }\n  if (element instanceof HTMLInputElement) return element.type !== \"hidden\";\n  if (element instanceof HTMLIFrameElement) return true;\n  if (element.tagName === \"AUDIO\" || element.tagName === \"VIDEO\") {\n    return element.hasAttribute(\"controls\");\n  }\n  if (element instanceof HTMLElement && element.tagName === \"SUMMARY\") {\n    const details = element.parentElement;\n    return (\n      details instanceof HTMLDetailsElement &&\n      Array.from(details.children).find((child) => child.tagName === \"SUMMARY\") === element\n    );\n  }\n  return false;\n}\n\n/** Whether an explicit `contenteditable` value creates an editable tab stop. */\nfunction hasEditableTabStop(element: HTMLElement): boolean {\n  const value = element.getAttribute(\"contenteditable\")?.toLowerCase();\n  return value === \"\" || value === \"true\" || value === \"plaintext-only\";\n}\n\n/**\n * Whether an element is a usable sequential Tab stop right now.\n *\n * Native semantics, authored `tabindex`, editable hosts, inherited disabled state,\n * HTML `hidden`/`inert`, and CSS visibility are evaluated together. `aria-disabled`\n * remains focusable because it communicates unavailability without removing the\n * control from discovery order.\n */\nexport function isTabStop(element: HTMLElement): boolean {\n  if (!canTakeFocus(element) || !isRenderedForFocus(element)) return false;\n\n  const tabindex = authoredTabindex(element);\n  if (tabindex !== null) return tabindex >= 0;\n  return hasNativeTabStop(element) || hasEditableTabStop(element);\n}\n\n/** Returns every usable sequential Tab stop below `root` in document order. */\nexport function tabStopsWithin(root: ParentNode): HTMLElement[] {\n  return Array.from(root.querySelectorAll<HTMLElement>(TAB_STOP_CANDIDATE_SELECTOR)).filter(\n    isTabStop,\n  );\n}\n\n/** Returns the first usable sequential Tab stop below `root`, if one exists. */\nexport function firstTabStop(root: ParentNode): HTMLElement | null {\n  for (const candidate of root.querySelectorAll<HTMLElement>(TAB_STOP_CANDIDATE_SELECTOR)) {\n    if (isTabStop(candidate)) return candidate;\n  }\n  return null;\n}\n\n/** Whether `root` contains at least one usable sequential Tab stop. */\nexport function hasTabStop(root: ParentNode): boolean {\n  return firstTabStop(root) !== null;\n}\n","/**\n * Collapses many Stimulus lifecycle callbacks from one DOM mutation into a\n * single pass.\n *\n * Stimulus fires `<name>TargetConnected` / `Disconnected` once per element and\n * `<name>ValueChanged` once per changed attribute. Replacing a list of N options\n * or morphing several render Values therefore delivers N callbacks — but the\n * useful unit of work is \"reconcile against the resulting declarative input\",\n * once, after the batch has settled. Every controller with reconcilable targets\n * or render Values needs the same shape: a `queued` flag plus `queueMicrotask`.\n *\n * **A microtask is the right horizon, and the reason is specific.** Stimulus\n * drives these callbacks from a `MutationObserver`, whose own callback already\n * runs as a microtask with the whole batch in hand; scheduling one more lands\n * after the last sibling callback of that batch and still before paint or any\n * event handler. A timer would be later than it needs to be, and reconciling\n * synchronously would run once per element against a half-applied DOM.\n *\n * **The two guards are not the same guard.** Scheduling is refused before the\n * controller connects, and running is refused after it disconnects:\n *\n * - **Before `connect()`** — Stimulus delivers initial target and Value callbacks\n *   ahead of `connect()`. Reconciling there would compute output against a\n *   controller whose own state has not been initialised, and `connect()` is\n *   about to do a full pass anyway.\n * - **After `disconnect()`** — Stimulus fires a callback for **every** target\n *   during teardown, and a microtask queued just before it would otherwise run\n *   against a detached tree. {@link MicrotaskCoalescer.cancel} exists for the\n *   teardown path to drop the pending pass outright.\n *\n * Both guards are part of one contract here rather than something each consumer\n * has to remember separately.\n *\n * Scope is the scheduling only. *What* to reconcile — keep the surviving active\n * option, fall back to the next / previous / first visible one, rebuild derived\n * chips or hidden fields — stays in the controller, because no two consumers\n * answer it the same way.\n *\n * This file's own doc block is dropped from `dist`, but every member comment is\n * inlined into each consumer entry (`tsup` builds with `splitting: false`), so\n * rationale belongs here and only the contract belongs on the members.\n *\n * @example\n * ```ts\n * readonly #reconcile = new MicrotaskCoalescer(() => this.#reconcileOptions());\n *\n * connect()    { this.#reconcile.activate(); }\n * disconnect() { this.#reconcile.cancel(); }\n *\n * optionTargetConnected()    { this.#reconcile.schedule(); }\n * optionTargetDisconnected() { this.#reconcile.schedule(); }\n * ```\n */\nexport class MicrotaskCoalescer {\n  readonly #run: () => void;\n  #queued = false;\n  #active = false;\n  #generation = 0;\n\n  /** @param run - the single reconciliation pass, invoked at most once per batch. */\n  constructor(run: () => void) {\n    this.#run = run;\n  }\n\n  /** Opens the window in which {@link schedule} is honoured; call from `connect()`. */\n  activate(): void {\n    this.#active = true;\n  }\n\n  /** Closes the window and drops any pending pass; call from `disconnect()`. */\n  cancel(): void {\n    this.#active = false;\n    this.#queued = false;\n    this.#generation += 1;\n  }\n\n  /** Requests one pass after the batch settles. Idempotent; inert outside the window. */\n  schedule(): void {\n    if (!this.#active || this.#queued) return;\n    this.#queued = true;\n    const generation = this.#generation;\n    queueMicrotask(() => {\n      // A cancelled callback must not consume a pass queued after reconnect.\n      if (generation !== this.#generation || !this.#queued || !this.#active) return;\n      this.#queued = false;\n      this.#run();\n    });\n  }\n}\n","import { BeforeCacheReset } from \"./before_cache_reset\";\n\n/**\n * Shared bookkeeping for a `tabindex` a controller lends an element temporarily.\n *\n * A controller that must move focus somewhere the author never made focusable\n * (a landmark root, a scroll destination) reaches for the same trick: add a\n * `tabindex` just-in-time and hand it back once it is no longer needed. The\n * borrow is the easy half; the return is what the two conditions below are for.\n *\n * **Returning needs two conditions, not one.** Owning the borrow is not enough:\n * the attribute must also still hold the value this instance wrote. A consumer\n * that changed it afterwards — `tabindex=\"0\"` to make the root its own Tab stop\n * — owns it now, and removing it there silently discards authored markup. The\n * bookkeeping is dropped either way, since the loan is over regardless of who\n * ends up owning the value.\n *\n * **Never borrow over an existing value.** An element that already carries a\n * `tabindex` is the author's to control, so there is nothing to lend and nothing\n * to return.\n *\n * Every live loan also owns a shared `turbo:before-cache` subscription. The loan\n * is returned before Turbo can copy it into a snapshot, so consumers get cache\n * safety without duplicating a lifecycle hook; `returnAll()` removes the\n * subscription again as soon as no loan remains.\n *\n * The registry is keyed by element, so a controller borrowing on a single\n * element (`this.element`) and one borrowing across a changing set of targets\n * use the same API — the single-element case is a set of one. It holds no\n * opinion about *when* to borrow or where focus goes next; that stays in the\n * controller.\n *\n * **The API is deliberately two methods.** This file's own doc block is dropped\n * from `dist`, but every member comment is inlined into **each** consumer entry\n * (`tsup` builds with `splitting: false`), so rationale belongs here, only the\n * contract belongs on the members, and every method no consumer calls is still\n * paid for once per consumer entry.\n *\n * @example\n * ```ts\n * readonly #tabindex = new TabindexLoan();\n *\n * #rescueFocus() {\n *   this.#tabindex.lend(this.element);\n *   this.element.focus();\n * }\n *\n * disconnect() {\n *   this.#tabindex.returnAll();\n * }\n * ```\n */\nexport class TabindexLoan<T extends HTMLElement = HTMLElement> {\n  readonly #value: string;\n  readonly #lent = new Set<T>();\n  /** Returns live loans before Turbo can copy them into its page snapshot. */\n  readonly #beforeCache = new BeforeCacheReset(() => this.returnAll());\n\n  /**\n   * @param value - the `tabindex` to lend. `\"-1\"` (the default) is\n   *   programmatically focusable but not a Tab stop; `\"0\"` is a real Tab stop,\n   *   which a scroll region with no focusable content of its own needs.\n   */\n  constructor(value: string = \"-1\") {\n    this.#value = value;\n  }\n\n  /** Lends `element` the value; no-ops when it already carries a `tabindex`. */\n  lend(element: T): void {\n    if (element.hasAttribute(\"tabindex\")) return;\n    element.setAttribute(\"tabindex\", this.#value);\n    this.#lent.add(element);\n    // Subscribe only while a real loan exists. Keeping this guarantee here means\n    // every consumer is Turbo-safe without another lifecycle hook to remember.\n    this.#beforeCache.activate();\n  }\n\n  /** Takes back every loan whose value is still the one that was lent. */\n  returnAll(): void {\n    for (const element of this.#lent) {\n      if (element.getAttribute(\"tabindex\") === this.#value) element.removeAttribute(\"tabindex\");\n    }\n    this.#lent.clear();\n    this.#beforeCache.deactivate();\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { announce, fillTemplate } from \"../utils/announce\";\nimport { AttributeLease } from \"../utils/attribute_lease\";\nimport { BeforeCacheReset } from \"../utils/before_cache_reset\";\nimport { firstTabStop, isTabStop } from \"../utils/focus_candidate\";\nimport { MicrotaskCoalescer } from \"../utils/microtask_coalescer\";\nimport { TabindexLoan } from \"../utils/tabindex_loan\";\n\n/** Selects any nested-form root; the nearest one is an element's owning instance. */\nconst ROOT_SELECTOR = '[data-controller~=\"stimeo--nested-form\"]';\n/** Selects per-row remove buttons (resolved through delegation, never per-row wiring). */\nconst REMOVE_SELECTOR = '[data-stimeo--nested-form-target=\"remove\"]';\n/** Selects the hidden `_destroy` input a persisted row carries. */\nconst DESTROY_FLAG_SELECTOR = '[data-stimeo--nested-form-target=\"destroyFlag\"]';\n\n/** `_destroy` values Rails treats as truthy; the flag value is the destruction truth source. */\nconst DESTROYED_VALUES = new Set([\"1\", \"true\"]);\n\n/**\n * Headless **nested / dynamic fields** for Rails `fields_for` +\n * `accepts_nested_attributes_for` (no dedicated APG pattern — form editing).\n * Clone a `<template>` row, renumber its index, and remove rows by flagging\n * `_destroy` (persisted) or dropping them from the DOM (unsaved).\n *\n * Markup contract (identifier: `stimeo--nested-form`):\n *   <div data-controller=\"stimeo--nested-form\" data-stimeo--nested-form-min-value=\"1\">\n *     <div data-stimeo--nested-form-target=\"list\">\n *       <!-- existing rows; a persisted row carries a _destroy flag + remove button -->\n *     </div>\n *     <template data-stimeo--nested-form-target=\"template\">\n *       <fieldset>\n *         <input name=\"order[items_attributes][__INDEX__][name]\">\n *         <button type=\"button\" data-stimeo--nested-form-target=\"remove\">Remove</button>\n *       </fieldset>\n *     </template>\n *     <button type=\"button\" data-stimeo--nested-form-target=\"add\"\n *             data-action=\"click->stimeo--nested-form#add\">Add</button>\n *   </div>\n *\n * Values: `min` / `max` bound the effective row count (`max` `0` = unlimited;\n * both are followed at runtime), `indexPlaceholder` is the template token\n * replaced per row (default `__INDEX__`), and `announce` + `countMessage` (a\n * `{count}` template) opt into the announcer bridge.\n *\n * `add` dispatches `{ index, element }`; `remove` dispatches `{ element, persisted }`;\n * `reconcile` dispatches `{ count, atMin, atMax }` when a change the controller did\n * not perform itself — rows appended or removed by Turbo Streams / a morph, or a\n * runtime `min` / `max` change — moves the published state.\n *\n * @remarks\n * Behavior only — server-side `accepts_nested_attributes_for`, per-field\n * validation, and reordering are out of scope. Row state lives **only** in the DOM\n * (inserted nodes + each `_destroy` hidden input); there is no module-scope index\n * counter, so the controller stays idempotent across Turbo swaps. A row counts as\n * destroyed when its own `_destroy` flag holds a truthy value — `hidden` is the\n * visual half the controller writes alongside the flag, so a consumer hiding rows\n * for other reasons does not affect the count. Remove buttons and destroy flags\n * are resolved by **delegation scoped to their nearest nested-form root**, so\n * dynamically-added rows work without per-row `data-action` and one instance\n * nested inside another never acts on the inner instance's buttons or flags.\n * External row changes are observed on the list and reconciled once per mutation\n * batch. Adding a row moves focus to its first tab stop; removing returns focus to\n * the nearest surviving row's first tab stop, falling back to the add button and\n * finally to the root via a temporary `tabindex` (WCAG 2.2 2.4.3) — candidates\n * that cannot take focus (natively `disabled`, inside `fieldset[disabled]`, or not\n * rendered) are skipped. Count changes from the controller's own add / remove are\n * announced through the shared `stimeo--announcer` (WCAG 2.2 4.1.3) when\n * `announce` + `countMessage` are set; reconciliation stays silent to assistive\n * tech. The add button's `disabled` is managed only while `max` is set, and the\n * authored value is restored on teardown. A template must produce exactly one\n * root element; markup lacking the required `list` / `template` targets, or a\n * template producing anything else, is named on the console once per connection\n * and every operation stays a safe no-op with nothing left in the list. Clicking\n * remove on a row whose flag is already truthy only completes its hiding —\n * nothing effective changes, so no event and no announcement. The delegated\n * listener, the observer, and every lease are released on `disconnect()`.\n */\nexport class NestedFormController extends Controller<HTMLElement> {\n  static override targets = [\"list\", \"template\", \"add\", \"remove\", \"destroyFlag\"];\n  static override values = {\n    min: { type: Number, default: 0 },\n    max: { type: Number, default: 0 },\n    indexPlaceholder: { type: String, default: \"__INDEX__\" },\n    announce: { type: Boolean, default: true },\n    countMessage: { type: String, default: \"\" },\n  };\n  static actions = [\"add\"] as const;\n  static events = [\"add\", \"remove\", \"reconcile\"] as const;\n\n  declare readonly listTarget: HTMLElement;\n  declare readonly templateTarget: HTMLTemplateElement;\n  declare readonly addTarget: HTMLButtonElement;\n  declare readonly hasListTarget: boolean;\n  declare readonly hasTemplateTarget: boolean;\n  declare readonly hasAddTarget: boolean;\n\n  declare minValue: number;\n  declare maxValue: number;\n  declare indexPlaceholderValue: string;\n  declare announceValue: boolean;\n  declare countMessageValue: string;\n\n  /** Monotonic source for unique row indices; never a row-state counter. */\n  #lastIndex = 0;\n\n  #warnedMissing = false;\n  #warnedTemplate = false;\n\n  /** The state last written to the hooks; reconciliation reports only real moves. */\n  #published: { count: number; atMin: boolean; atMax: boolean } | null = null;\n\n  /** Watches the list for row changes the controller did not perform itself. */\n  #observer: MutationObserver | null = null;\n\n  readonly #reconcile = new MicrotaskCoalescer(() => this.#reconcileNow());\n  /** Restores the authored add-button `disabled` when a lease ends. */\n  readonly #addDisabled = new AttributeLease<HTMLButtonElement>(\"disabled\");\n  readonly #beforeCache = new BeforeCacheReset(() => this.#rewindForCache());\n  /** Makes the root a programmatic focus destination when no other candidate survives. */\n  readonly #tabindex = new TabindexLoan();\n\n  /**\n   * Delegated click handler for the per-row remove buttons (dynamic-safe). Only\n   * buttons whose nearest nested-form root is this instance are acted on, so a\n   * nested inner form's buttons never remove an outer row.\n   */\n  readonly #onClick = (event: Event): void => {\n    const target = event.target as HTMLElement | null;\n    const button = target?.closest<HTMLElement>(REMOVE_SELECTOR);\n    if (!button || this.#ownerOf(button) !== this.element) return;\n    const row = this.#rowContaining(button);\n    if (row) this.#removeRow(row);\n  };\n\n  override connect(): void {\n    this.#warnedMissing = false;\n    this.#warnedTemplate = false;\n    this.element.addEventListener(\"click\", this.#onClick);\n    this.#reconcile.activate();\n    this.#beforeCache.activate();\n    if (!this.hasListTarget || !this.hasTemplateTarget) this.#warnMissing();\n    this.#refresh();\n  }\n\n  override disconnect(): void {\n    this.element.removeEventListener(\"click\", this.#onClick);\n    this.#observer?.disconnect();\n    this.#observer = null;\n    this.#reconcile.cancel();\n    this.#beforeCache.deactivate();\n    this.#rewindForCache();\n    this.#tabindex.returnAll();\n    this.#published = null;\n  }\n\n  /** Follows an arriving or swapped-in list: rebind to the primary, then reconcile. */\n  listTargetConnected(): void {\n    this.#rebindObserver();\n    this.#reconcile.schedule();\n  }\n\n  /** Follows a departing list the same way — the primary may have changed. */\n  listTargetDisconnected(): void {\n    this.#rebindObserver();\n    this.#reconcile.schedule();\n  }\n\n  /**\n   * Points the observer at the current primary list. Re-deriving on every list\n   * arrival and departure makes the binding independent of the order Stimulus\n   * reports an overlapping swap in — a staggered swap (successor appended before\n   * the old list leaves) ends observed and reconciled either way.\n   */\n  #rebindObserver(): void {\n    this.#observer?.disconnect();\n    this.#observer = null;\n    if (!this.hasListTarget) return;\n    this.#observer = new MutationObserver(() => this.#reconcile.schedule());\n    this.#observer.observe(this.listTarget, {\n      childList: true,\n      subtree: true,\n      attributes: true,\n      attributeFilter: [\"value\"],\n    });\n  }\n\n  /** Returns the lease with a departing add button; a new one re-arms on refresh. */\n  addTargetDisconnected(target: HTMLButtonElement): void {\n    this.#addDisabled.return(target);\n    this.#reconcile.schedule();\n  }\n\n  addTargetConnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Re-clamps when application code or a Turbo morph changes `min`. */\n  minValueChanged(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Re-clamps when application code or a Turbo morph changes `max`. */\n  maxValueChanged(): void {\n    this.#reconcile.schedule();\n  }\n\n  /**\n   * Clones the template row, replaces the index placeholder with a unique value,\n   * appends it, focuses its first tab stop, and announces the new count. No-ops at\n   * `max`, when the required targets are missing (named on the console once per\n   * connection), or when the template does not produce exactly one root element\n   * (also named once; the insertion is rolled back so nothing accumulates).\n   */\n  add(): void {\n    if (!this.hasListTarget || !this.hasTemplateTarget) {\n      this.#warnMissing();\n      return;\n    }\n    if (this.#atMax) return;\n\n    const index = this.#nextIndex();\n    const markup = this.templateTarget.innerHTML.replaceAll(\n      this.indexPlaceholderValue,\n      String(index),\n    );\n    const list = this.listTarget;\n    const beforeNodes = list.childNodes.length;\n    const beforeElements = list.childElementCount;\n    list.insertAdjacentHTML(\"beforeend\", markup);\n    const added = (Array.from(list.children) as HTMLElement[]).slice(beforeElements);\n    if (added.length !== 1) {\n      // A row is exactly one element. Anything else — escaped text, nothing, or\n      // several roots (which the max gate above cannot account for) — rolls back\n      // so repeated clicks cannot accumulate garbage or overshoot the max.\n      while (list.childNodes.length > beforeNodes) list.lastChild?.remove();\n      this.#warnBadTemplate(added.length);\n      return;\n    }\n    const row = added[0] as HTMLElement;\n\n    this.#refresh();\n    firstTabStop(row)?.focus();\n    this.dispatch(\"add\", { detail: { index, element: row } });\n    this.#announce();\n  }\n\n  /**\n   * Removes a row: a persisted row (one carrying its own `destroyFlag`) has the\n   * flag set to `1` and is hidden so Rails destroys it on submit; an unsaved row\n   * is dropped from the DOM. Returns focus to a surviving row. No-ops at `min`.\n   */\n  #removeRow(row: HTMLElement): void {\n    const rows = this.#effectiveRows;\n    if (this.#destroyed(row)) {\n      // An already-destroyed row left visible (a server re-render keeps the\n      // flag but not the hiding): complete the visual half. The effective\n      // state does not move, so no event, no announcement, and no min gate.\n      row.hidden = true;\n      this.#focusAfterRemove(this.#positionAmong(rows, row));\n      return;\n    }\n    if (rows.length <= this.minValue) return;\n\n    const position = rows.indexOf(row);\n    const flag = this.#destroyFlagOf(row);\n    const persisted = flag !== null;\n    if (flag) {\n      flag.value = \"1\";\n      row.hidden = true;\n    } else {\n      row.remove();\n    }\n\n    this.#refresh();\n    this.#focusAfterRemove(Math.max(0, position));\n    this.dispatch(\"remove\", { detail: { element: row, persisted } });\n    this.#announce();\n  }\n\n  /**\n   * The index of the first effective row following `row` in document order.\n   * -1 (no following row) feeds the focus slices as a negative index, which\n   * yields the same fully-reversed nearest-first order as `rows.length` would.\n   */\n  #positionAmong(rows: HTMLElement[], row: HTMLElement): number {\n    return rows.findIndex(\n      (candidate) =>\n        (row.compareDocumentPosition(candidate) & Node.DOCUMENT_POSITION_FOLLOWING) !== 0,\n    );\n  }\n\n  /**\n   * Moves focus to the first tab stop of the nearest surviving row — following\n   * rows first, then preceding ones — falling back to the add button and finally\n   * to the root via a temporary `tabindex`.\n   */\n  #focusAfterRemove(position: number): void {\n    const rows = this.#effectiveRows;\n    const ordered = [...rows.slice(position), ...rows.slice(0, position).reverse()];\n    for (const row of ordered) {\n      const stop = firstTabStop(row);\n      if (stop) {\n        stop.focus();\n        return;\n      }\n    }\n    if (this.hasAddTarget && isTabStop(this.addTarget)) {\n      this.addTarget.focus();\n      return;\n    }\n    this.#tabindex.lend(this.element);\n    this.element.focus();\n  }\n\n  /** Recomputes the count and min/max hooks from the DOM and records them as published. */\n  #refresh(): void {\n    if (!this.hasListTarget) return;\n    const count = this.#effectiveRows.length;\n    const atMin = count <= this.minValue;\n    const atMax = this.maxValue > 0 && count >= this.maxValue;\n    this.element.setAttribute(\"data-nested-count\", String(count));\n    this.#reflect(\"data-nested-at-max\", atMax);\n    this.#reflect(\"data-nested-at-min\", atMin);\n    if (this.hasAddTarget) {\n      // The button's disabled is controller state only while a max exists;\n      // without one there is nothing to derive and the authored value stands.\n      if (this.maxValue > 0) this.#addDisabled.write(this.addTarget, atMax ? \"\" : null);\n      else this.#addDisabled.return(this.addTarget);\n    }\n    this.#published = { count, atMin, atMax };\n  }\n\n  /**\n   * Applies row changes the controller did not perform itself (Turbo Streams,\n   * morphs, runtime Value changes): refreshes the hooks and reports a moved\n   * public state as `reconcile`. The controller's own operations refresh\n   * synchronously first, so their observer echo arrives here as a no-move.\n   */\n  #reconcileNow(): void {\n    const previous = this.#published;\n    this.#refresh();\n    const current = this.#published;\n    if (!previous || !current) return;\n    const moved =\n      previous.count !== current.count ||\n      previous.atMin !== current.atMin ||\n      previous.atMax !== current.atMax;\n    if (moved) this.dispatch(\"reconcile\", { detail: { ...current } });\n  }\n\n  /** Bridges the count change to the shared announcer when configured. */\n  #announce(): void {\n    if (!this.announceValue || this.countMessageValue === \"\") return;\n    announce(fillTemplate(this.countMessageValue, { count: this.#effectiveRows.length }));\n  }\n\n  /** Sets `attribute` to `\"true\"` when `on`, else removes it. */\n  #reflect(attribute: string, on: boolean): void {\n    if (on) this.element.setAttribute(attribute, \"true\");\n    else this.element.removeAttribute(attribute);\n  }\n\n  /** Returns the disabled lease so an authored value never leaks into a snapshot. */\n  #rewindForCache(): void {\n    if (this.hasAddTarget) this.#addDisabled.return(this.addTarget);\n  }\n\n  /** Names the missing required target(s) once per connection. */\n  #warnMissing(): void {\n    if (this.#warnedMissing) return;\n    this.#warnedMissing = true;\n    const missing = [\n      this.hasListTarget ? null : 'a \"list\" target',\n      this.hasTemplateTarget ? null : 'a \"template\" target',\n    ]\n      .filter((part): part is string => part !== null)\n      .join(\" and \");\n    console.warn(\n      `Stimeo UI: \"${this.identifier}\" cannot manage rows because its markup lacks ${missing}.`,\n    );\n  }\n\n  /** Names a template that does not produce exactly one element, once per connection. */\n  #warnBadTemplate(produced: number): void {\n    if (this.#warnedTemplate) return;\n    this.#warnedTemplate = true;\n    const reason = produced === 0 ? \"produces no element\" : \"must produce exactly one root element\";\n    console.warn(`Stimeo UI: \"${this.identifier}\" added no row because its template ${reason}.`);\n  }\n\n  /** A strictly-increasing unique index (collision-free even on rapid adds). */\n  #nextIndex(): number {\n    const index = Math.max(Date.now(), this.#lastIndex + 1);\n    this.#lastIndex = index;\n    return index;\n  }\n\n  get #atMax(): boolean {\n    return this.maxValue > 0 && this.#effectiveRows.length >= this.maxValue;\n  }\n\n  /**\n   * Direct child rows of the list whose own destroy flag is not set. Callers\n   * reach this only behind a list-presence gate (`add`, `#refresh`, and the\n   * click path through `#rowContaining`).\n   */\n  get #effectiveRows(): HTMLElement[] {\n    return (Array.from(this.listTarget.children) as HTMLElement[]).filter(\n      (row) => !this.#destroyed(row),\n    );\n  }\n\n  /** Whether `row` is flagged for destruction; the flag value is the truth source. */\n  #destroyed(row: HTMLElement): boolean {\n    const flag = this.#destroyFlagOf(row);\n    return flag !== null && DESTROYED_VALUES.has(flag.value);\n  }\n\n  /** The row's own destroy flag, skipping flags owned by a nested inner form. */\n  #destroyFlagOf(row: HTMLElement): HTMLInputElement | null {\n    for (const flag of row.querySelectorAll<HTMLInputElement>(DESTROY_FLAG_SELECTOR)) {\n      if (this.#ownerOf(flag) === this.element) return flag;\n    }\n    return null;\n  }\n\n  /** The nearest nested-form root that owns `el`. */\n  #ownerOf(el: Element): Element | null {\n    return el.closest(ROOT_SELECTOR);\n  }\n\n  /** The nearest ancestor of `el` that is a direct child of the list, else null. */\n  #rowContaining(el: Element): HTMLElement | null {\n    if (!this.hasListTarget) return null;\n    let node: Element | null = el;\n    while (node && node.parentElement !== this.listTarget) {\n      node = node.parentElement;\n    }\n    return node as HTMLElement | null;\n  }\n}\n"]}

package/dist/controllers/otp_controller.d.ts

@@ -5,67 +5,106 @@ import { Controller } from '@hotwired/stimulus';
  *
  * Markup contract (identifier: `stimeo--otp`):
  *   <div data-controller="stimeo--otp"
- *        data-stimeo--otp-length-value="6"
  *        data-stimeo--otp-pattern-value="[0-9]"
  *        role="group" aria-label="One-time passcode">
  *     <input data-stimeo--otp-target="field" inputmode="numeric" maxlength="1"
+ *            autocomplete="one-time-code" aria-label="Digit 1"
  *            data-action="input->stimeo--otp#onInput
  *                         keydown->stimeo--otp#onKeydown
- *                         paste->stimeo--otp#onPaste" />
- *     <input type="hidden" data-stimeo--otp-target="value" />
+ *                         paste->stimeo--otp#onPaste
+ *                         pointerdown->stimeo--otp#onPointerDown" />
+ *     <!-- repeat one field per digit -->
+ *     <p data-stimeo--otp-target="error" hidden>Digits only.</p>
+ *     <input type="hidden" data-stimeo--otp-target="value" name="otp" />
  *   </div>
  *
- * Implements highly polished UX conventions for single-digit field groups:
- * - Dynamic autofocus advancement upon valid inputs.
- * - Auto-selection `select()` upon gaining focus to enable frictionless digit overwrites.
- * - Retroactive Backspace key focus stepping to clear preceding values safely.
- * - Clipboard intercepting paste division across fields with trailing focus positioning.
- * - Hidden form sync and complete/change event dispatching.
+ * The passcode length is the number of connected `field` targets, so nothing has
+ * to declare it twice and fields added or removed at runtime are absorbed.
  *
- * `change` and `complete` dispatch `{ value: string }`; `invalid` dispatches
- * `{ pattern: string }`.
+ * Entry rules:
+ * - Text carrying more than one accepted character — an OS `one-time-code`
+ *   autofill, a password manager, an IME committing several digits, a paste —
+ *   is spread across the following writable fields from the entry point.
+ * - `disabled` and `readonly` fields keep their value: they are never written
+ *   and never receive auto-advance focus, matching what the platform allows a
+ *   user to do by hand.
+ * - Input that lands nowhere rolls the field back to the digit it last
+ *   committed, and is the only thing that reports `invalid` or reveals the
+ *   `error` target. Discarding a separator inside otherwise usable text
+ *   (`"1234-56"`) is a successful entry.
+ * - Pointing at an empty field ahead of an earlier empty one lands on the
+ *   earliest empty field instead, so a passcode fills in order. Keyboard focus
+ *   is never redirected.
+ *
+ * `change` and `complete` dispatch `{ value: string }` and fire only when the
+ * combined value actually moves — one confirmed IME character emits one event,
+ * and a passcode re-completed with a different digit reports the new value.
+ * State moved by adding or removing fields is the page's doing rather than an
+ * edit, so it is reported as `reconcile` with the same `{ value: string }`.
+ * Completeness belongs to that state: dropping a trailing empty field completes
+ * a passcode whose combined value never moved, and that transition is reported
+ * too, so a consumer reading `data-state` is never left behind a silent move.
+ * `invalid` dispatches `{ pattern: string }` carrying the compiled pattern.
+ *
+ * Controller-owned output: `data-filled` on each entered field, `data-state`
+ * (`empty` / `partial` / `complete`) on the root, and — while input is being
+ * reported invalid — `aria-invalid`, `aria-errormessage`, `aria-describedby`,
+ * and the `error` target's `hidden`. Those four are leased, so authored values
+ * return on teardown and before the page is cached.
  *
  * @remarks
- * Behavior only. The controller binds events dynamically to pre-rendered inputs,
- * updates `data-filled` and hidden value bindings, and emits Stimulus custom events.
+ * Behavior only. `connect()` reads the fields back as the source of truth, which
+ * is what restores consistency after a `type="password"` field returns from the
+ * Turbo cache emptied, or after a native form reset. A `pattern` that cannot
+ * compile falls back to `[0-9]`; the compiled matcher is built once per
+ * declaration rather than per keystroke.
  */
 declare class OtpController extends Controller<HTMLElement> {
     #private;
     static targets: string[];
     static values: {
-        length: {
-            type: NumberConstructor;
-            default: number;
-        };
         pattern: {
             type: StringConstructor;
             default: string;
         };
     };
-    static actions: readonly ["onInput", "onKeydown", "onPaste"];
-    static events: readonly ["change", "complete", "invalid"];
+    static actions: readonly ["onInput", "onKeydown", "onPaste", "onPointerDown", "clear"];
+    static events: readonly ["change", "complete", "invalid", "reconcile"];
     readonly fieldTargets: HTMLInputElement[];
     readonly valueTarget: HTMLInputElement;
     readonly errorTarget: HTMLElement;
     readonly hasValueTarget: boolean;
     readonly hasErrorTarget: boolean;
-    lengthValue: number;
     patternValue: string;
     connect(): void;
     disconnect(): void;
     /**
      * Stimulus lifecycle callback when a new field target enters the DOM.
-     * Ensures new additions are also wired with overwriting support.
+     * Wires the new field and folds the wider digit count into one reconciliation,
+     * which stays inert until `connect()` opens the window.
      */
     fieldTargetConnected(element: HTMLInputElement): void;
-    /** Removes focus listeners when fields are dropped. */
+    /** Releases a dropped field's listeners and leases, then reconciles the rest. */
     fieldTargetDisconnected(element: HTMLInputElement): void;
-    /** Handles keystroke inputs and advances focus to the next field. */
+    /**
+     * Re-validates a changed `pattern` declaration once and drops any entered digit
+     * the new pattern no longer accepts, so the combined value stays interpretable.
+     */
+    patternValueChanged(): void;
+    /** Handles keystroke inputs, distributes autofilled text, and advances focus. */
     onInput(event: Event): void;
-    /** Handles Backspace retreating, arrows, and home/end navigation. */
+    /** Handles Backspace clearing, arrows, and home/end navigation. */
     onKeydown(event: KeyboardEvent): void;
-    /** Divides pasted string characters across available input fields. */
+    /** Divides pasted string characters across the available input fields. */
     onPaste(event: ClipboardEvent): void;
+    /**
+     * 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: Event): void;
+    /** Empties every writable field and restarts entry at the first of them. */
+    clear(): void;
 }
 
 export { OtpController };