stimeo-ui 0.2.1 → 0.4.0

package/dist/controllers/form_validation_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/focus_trap.ts","../../src/controllers/form_validation_controller.ts"],"names":[],"mappings":"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","file":"form_validation_controller.js","sourcesContent":["import { EscapeLayer } from \"./escape_layer\";\n\n/**\n * Modal focus-trap primitive shared by the modal-overlay controllers\n * (dialog / alert-dialog / confirm / drawer / command-palette / sidebar); the\n * non-modal focus scope (focus) reuses it with the modal side effects opted out.\n *\n * The WAI-ARIA APG modal pattern is more than \"cycle Tab inside a box\": a modal\n * also locks background scroll, makes the rest of the page `inert` (so assistive\n * technology and pointer/Tab cannot reach it, honoring `aria-modal=\"true\"`),\n * sends focus inside on open, and restores it to the opener on close — and every\n * one of those side effects must be reverted if the element is torn down while\n * open (a Turbo navigation mid-dialog) and kept out of the snapshot Turbo\n * caches (`turbo:before-cache`). {@link FocusTrap} owns that whole modal\n * lifecycle so each controller only decides *when* to open/close and *what*\n * \"close\" means.\n *\n * It is intentionally **policy-free about closing**. Escape semantics differ per\n * widget (a plain dialog just closes; an alert-dialog closes *as a cancel* with a\n * reason; a drawer runs an exit transition), so the trap merely forwards Escape\n * to an {@link FocusTrapOptions.onEscape | onEscape} callback and never decides on\n * its own what closing entails.\n *\n * @remarks\n * The container is read through a getter so a controller can hand over a Stimulus\n * target without worrying about when the trap instance is constructed relative to\n * `connect()`.\n */\n\n/**\n * Selector matching the elements considered focusable. Shared by the trap's Tab\n * cycling and by form-validation's invalid-focus delegation.\n */\nexport const FOCUSABLE =\n  'a[href], button:not([disabled]), textarea:not([disabled]), input:not([disabled]), select:not([disabled]), [tabindex]:not([tabindex=\"-1\"])';\n\n/** Behavior hooks a controller supplies when constructing a {@link FocusTrap}. */\nexport interface FocusTrapOptions {\n  /**\n   * Called when `Escape` is pressed while the trap is active. When omitted,\n   * `Escape` is left alone (the trap never joins the Escape stack). Dismissal\n   * is resolved by the shared {@link EscapeLayer}: an Escape already consumed\n   * by an inner handler is ignored, and among active layers the most recently\n   * activated claiming one owns the press. The resolver consumes the event\n   * before invoking the callback (the shared layered-Escape contract).\n   */\n  onEscape?: () => void;\n  /**\n   * Returns the element to focus when the trap activates. When it returns `null`\n   * (or is omitted), the first focusable descendant is used, falling back to the\n   * container itself (made programmatically focusable with `tabindex=-1`).\n   */\n  initialFocus?: () => HTMLElement | null;\n  /**\n   * Returns the element to focus on deactivation when nothing was focused before\n   * the trap opened (e.g. the trigger). The element focused *before* opening\n   * always takes precedence.\n   */\n  fallbackFocus?: () => HTMLElement | null;\n  /**\n   * Lock background scroll (`body` overflow) while active. Defaults to `true` for\n   * the modal overlays; a lighter focus scope passes `false`. Read on `activate`.\n   */\n  lockScroll?: boolean | (() => boolean);\n  /**\n   * Make background siblings `inert` while active (the `aria-modal` isolation).\n   * Defaults to `true` for the modal overlays; a soft focus scope can opt out so\n   * the background stays reachable while `Tab` still cycles inside. Read on `activate`.\n   */\n  isolate?: boolean | (() => boolean);\n  /**\n   * Move focus inside on `activate`. Defaults to `true`; a focus scope that only\n   * wants the `Tab` boundary (no focus move) passes `false`. Read on `activate`.\n   */\n  autoFocus?: boolean | (() => boolean);\n}\n\n/**\n * Owns the modal side effects (scroll lock, background `inert`, focus trap, focus\n * restore) for a single container, applied on {@link activate} and reverted on\n * {@link deactivate}.\n */\nexport class FocusTrap {\n  /** The element focused before activation, restored on deactivation. */\n  #previouslyFocused: HTMLElement | null = null;\n  /** The body's inline `overflow` before locking, restored on deactivation. */\n  #previousBodyOverflow = \"\";\n  /** Whether scroll was locked this activation (so it is only restored if applied). */\n  #scrollLocked = false;\n  /** Background siblings made `inert` while active, restored on deactivation. */\n  #inertedSiblings: HTMLElement[] = [];\n  /** Whether the modal side effects are currently applied. */\n  #activeState = false;\n  /** Registers the trap on the shared Escape stack while active (see {@link EscapeLayer}). */\n  readonly #escapeLayer = new EscapeLayer();\n\n  /** Returns the trapped element; called on every operation for the live target. */\n  readonly #getContainer: () => HTMLElement;\n  /** Closing/focus hooks; see {@link FocusTrapOptions}. */\n  readonly #options: FocusTrapOptions;\n\n  /**\n   * @param getContainer - Returns the trapped element. Called on every operation\n   *   so the live target is always used.\n   * @param options - Closing/focus hooks; see {@link FocusTrapOptions}.\n   */\n  constructor(getContainer: () => HTMLElement, options: FocusTrapOptions = {}) {\n    this.#getContainer = getContainer;\n    this.#options = options;\n  }\n\n  /** Whether the trap is currently active. */\n  get active(): boolean {\n    return this.#activeState;\n  }\n\n  /**\n   * Applies the trap: records the current focus, optionally locks background scroll\n   * and makes background siblings `inert`, listens for `Tab`/`Escape`, and (unless\n   * `autoFocus` is off) moves focus inside. No-ops if already active.\n   */\n  activate(): void {\n    if (this.#activeState) return;\n    this.#activeState = true;\n    // Record the opener so it can be refocused on close. `<body>` (the default\n    // active element when nothing is focused) is treated as \"nothing\", so the\n    // fallback target — typically the trigger — wins in that case.\n    const active = document.activeElement;\n    this.#previouslyFocused =\n      active instanceof HTMLElement && active !== document.body ? active : null;\n    if (this.#flag(this.#options.lockScroll, true)) {\n      this.#previousBodyOverflow = document.body.style.overflow;\n      document.body.style.overflow = \"hidden\";\n      this.#scrollLocked = true;\n    }\n    if (this.#flag(this.#options.isolate, true)) this.#isolateBackground();\n    document.addEventListener(\"keydown\", this.#onKeydown);\n    document.addEventListener(\"turbo:before-cache\", this.#onBeforeCache);\n    const onEscape = this.#options.onEscape;\n    if (onEscape) this.#escapeLayer.activate(document, { onDismiss: () => onEscape() });\n    if (this.#flag(this.#options.autoFocus, true)) this.#focusInitial();\n  }\n\n  /**\n   * Reverts every side effect applied by {@link activate}. No-ops if inactive, so\n   * a controller can call it defensively from both `close()` and `disconnect()`.\n   *\n   * @param restoreFocus - Move focus back to the opener (default `true`). Pass\n   *   `false` on teardown (`disconnect`), where yanking focus is undesirable.\n   */\n  deactivate({ restoreFocus = true }: { restoreFocus?: boolean } = {}): void {\n    if (!this.#activeState) return;\n    this.#activeState = false;\n    this.#escapeLayer.deactivate();\n    document.removeEventListener(\"keydown\", this.#onKeydown);\n    document.removeEventListener(\"turbo:before-cache\", this.#onBeforeCache);\n    if (this.#scrollLocked) {\n      document.body.style.overflow = this.#previousBodyOverflow;\n      this.#scrollLocked = false;\n    }\n    this.#releaseBackground();\n    if (restoreFocus) {\n      const target = this.#previouslyFocused ?? this.#options.fallbackFocus?.() ?? null;\n      target?.focus();\n    }\n  }\n\n  /** Resolves a boolean-or-getter option, defaulting when it was not provided. */\n  #flag(option: boolean | (() => boolean) | undefined, fallback: boolean): boolean {\n    if (option === undefined) return fallback;\n    return typeof option === \"function\" ? option() : option;\n  }\n\n  /**\n   * Reverts the side effects just before Turbo caches the page snapshot, so an\n   * overlay left open does not bake the scroll lock into `body[style]` — a\n   * restored page would feed that locked value back into {@link activate} as the\n   * baseline, and closing would then never unlock the page. Markup state stays\n   * untouched (restore-open designs reopen against a clean baseline), and focus\n   * is left alone mid-navigation. The listener lives only while active.\n   */\n  readonly #onBeforeCache = (): void => {\n    this.deactivate({ restoreFocus: false });\n  };\n\n  /**\n   * Handles `Tab` (focus trap) while active. `Escape` dismissal is owned by the\n   * shared {@link EscapeLayer} resolver, so Tab trapping stays independent of\n   * which layer currently owns Escape.\n   */\n  readonly #onKeydown = (event: KeyboardEvent): void => {\n    if (event.key === \"Tab\") this.#trapTab(event);\n  };\n\n  /** Keeps `Tab` focus cycling within the container's focusable elements. */\n  #trapTab(event: KeyboardEvent): void {\n    const focusable = this.#focusableElements();\n    if (focusable.length === 0) {\n      event.preventDefault();\n      return;\n    }\n    const first = focusable[0];\n    const last = focusable[focusable.length - 1];\n    const active = document.activeElement;\n\n    // If focus has somehow escaped the container, pull it back to the first item.\n    if (!(active instanceof Node) || !this.#getContainer().contains(active)) {\n      event.preventDefault();\n      first?.focus();\n      return;\n    }\n\n    if (event.shiftKey && active === first) {\n      event.preventDefault();\n      last?.focus();\n    } else if (!event.shiftKey && active === last) {\n      event.preventDefault();\n      first?.focus();\n    }\n  }\n\n  /**\n   * Marks every element outside the container's subtree as `inert` so background\n   * content cannot be focused or reached by assistive technology, honoring the\n   * `aria-modal=\"true\"` contract. An element that was *already* `inert` is left\n   * untracked so `#releaseBackground` does not wrongly clear it.\n   */\n  #isolateBackground(): void {\n    const container = this.#getContainer();\n    this.#inertedSiblings = [];\n    for (const sibling of Array.from(document.body.children)) {\n      if (!(sibling instanceof HTMLElement)) continue;\n      if (sibling.contains(container) || sibling.inert) continue;\n      sibling.inert = true;\n      this.#inertedSiblings.push(sibling);\n    }\n  }\n\n  /** Reverts the `inert` flags applied by `#isolateBackground`. */\n  #releaseBackground(): void {\n    for (const sibling of this.#inertedSiblings) {\n      sibling.inert = false;\n    }\n    this.#inertedSiblings = [];\n  }\n\n  /** Moves focus to the initial target, the first focusable, or the container. */\n  #focusInitial(): void {\n    const preferred = this.#options.initialFocus?.();\n    if (preferred) {\n      preferred.focus();\n      return;\n    }\n    const focusable = this.#focusableElements();\n    if (focusable[0]) {\n      focusable[0].focus();\n      return;\n    }\n    const container = this.#getContainer();\n    container.tabIndex = -1;\n    container.focus();\n  }\n\n  /** Collects the container's currently focusable descendants in DOM order. */\n  #focusableElements(): HTMLElement[] {\n    return Array.from(this.#getContainer().querySelectorAll<HTMLElement>(FOCUSABLE)).filter(\n      (el) => !el.hidden,\n    );\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { FOCUSABLE } from \"../utils/focus_trap\";\nimport type { FormFieldController } from \"./form_field_controller\";\n\n/** Native form controls that participate in constraint validation. */\ntype ValidatableControl = HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement;\n\n/**\n * Maps each `ValidityState` flag (in priority order) to the kebab-case suffix of\n * its per-constraint message-override attribute. The first flag that is `true`\n * wins, so e.g. `valueMissing` is reported before a stale `patternMismatch`.\n */\nconst CONSTRAINT_MESSAGE_KEYS: ReadonlyArray<readonly [keyof ValidityState, string]> = [\n  [\"valueMissing\", \"value-missing\"],\n  [\"typeMismatch\", \"type-mismatch\"],\n  [\"patternMismatch\", \"pattern-mismatch\"],\n  [\"tooShort\", \"too-short\"],\n  [\"tooLong\", \"too-long\"],\n  [\"rangeUnderflow\", \"range-underflow\"],\n  [\"rangeOverflow\", \"range-overflow\"],\n  [\"stepMismatch\", \"step-mismatch\"],\n  [\"badInput\", \"bad-input\"],\n];\n\n/** Attribute prefix for a per-constraint message override, authored on the control. */\nconst MESSAGE_ATTR_PREFIX = \"data-stimeo--form-field-message-\";\n/** Attribute for a generic message override applied to any failing constraint. */\nconst MESSAGE_ATTR_GENERIC = \"data-stimeo--form-field-message\";\n/** Attribute opting a control into a declarative custom rule (`\"whitespace\"`). */\nconst DISALLOW_ATTR = \"data-stimeo--form-field-disallow\";\n/** Default message when `disallow=\"whitespace\"` fails and no override is given. */\nconst DISALLOW_WHITESPACE_DEFAULT = \"Please enter a value that is not only whitespace.\";\n\n/** A field's validatable controls, grouped so the whole field validates together. */\ninterface FieldGroup {\n  readonly field: FormFieldController | undefined;\n  readonly controls: ValidatableControl[];\n}\n\n/**\n * Headless, accessible **form-validation orchestration**.\n *\n * Markup contract (identifier: `stimeo--form-validation`):\n *   <form data-controller=\"stimeo--form-validation\"\n *         data-stimeo--form-validation-stimeo--form-field-outlet=\"[data-controller~='stimeo--form-field']\">\n *     <div data-controller=\"stimeo--form-field\">\n *       <label for=\"email\">Email</label>\n *       <input id=\"email\" type=\"email\" required\n *              data-stimeo--form-field-target=\"control\" />\n *       <p role=\"alert\" hidden data-stimeo--form-field-target=\"error\"></p>\n *     </div>\n *     <button type=\"submit\">Save</button>\n *   </form>\n *\n * Not an APG widget pattern — this is the *timing* layer for **error\n * identification** (WCAG 3.3.1) and **error suggestion** (3.3.3): it decides\n * *when* each control is checked and routes the browser's native\n * `validationMessage` into the field's {@link FormFieldController} error region.\n * The per-field ARIA wiring (`aria-invalid` / `aria-errormessage` /\n * `aria-describedby`) therefore lives in exactly one place — `stimeo--form-field`,\n * reached through a Stimulus **outlet** — and is never re-implemented here.\n *\n * @remarks\n * Behavior only — validation **rules** stay in the markup (native HTML\n * constraints: `required`, `type`, `pattern`, `min`/`max`, …) or in the consumer's\n * own `setCustomValidity()` calls, which `checkValidity()` surfaces transparently.\n * It sets the form's `novalidate` so it can replace the browser's default error\n * bubbles with the accessible, in-page `role=\"alert\"` regions, and restores the\n * attribute on disconnect.\n *\n * Two declarative escape hatches let a field **exceed** native validation with no\n * consumer JS (author them on the control):\n * - **Per-constraint messages** — `data-stimeo--form-field-message-<constraint>`\n *   (`value-missing`, `too-short`, `too-long`, `pattern-mismatch`, `type-mismatch`,\n *   `range-overflow`, `range-underflow`, `step-mismatch`, `bad-input`), or a generic\n *   `data-stimeo--form-field-message` fallback, override the shown text per failing\n *   `ValidityState` flag — controlled, localizable wording that also fixes headless\n *   browsers returning an empty native `validationMessage`. Falls back to native.\n * - **`data-stimeo--form-field-disallow=\"whitespace\"`** — a built-in custom rule\n *   rejecting a value that is blank after trimming (which slips past `required` /\n *   `minlength`), wired through `setCustomValidity` so it blocks submit like any\n *   native constraint.\n *\n * Behavior provided:\n * - On connect, suppresses native bubbles (`novalidate`, restored on disconnect)\n *   and intercepts the form's `submit` in the **capture phase** so an invalid form\n *   is cancelled before any other submit handler (e.g. `stimeo--submit-once`)\n *   reacts to a submission that will never happen.\n * - On submit, validates every control; if any is invalid it blocks submission,\n *   moves focus to the first invalid control (unless `focusInvalid` is `false`),\n *   and dispatches `stimeo--form-validation:invalid`. An all-valid form dispatches\n *   `:valid` and submits normally.\n * - Validates a field on blur once it has been interacted with (`validateOnBlur`),\n *   and re-validates it on input while it is already touched\n *   (`revalidateOnInput`) so a shown message clears the moment the value becomes\n *   valid — but a pristine field is never eagerly flagged mid-typing.\n *\n * A control with no owning `stimeo--form-field` outlet is still validated (it can\n * block submit and receive focus) but renders no message.\n *\n * Radio groups work unchanged: point the field's `control` target at the\n * `role=\"radiogroup\"` container so the invalid state lands on the group, and the\n * group is reported as a single invalid entry (not one per radio).\n *\n * Rich widgets (listbox, time-picker, …) that keep their committed value in a\n * hidden holder participate by making that holder a **validatable mirror**:\n * `<input type=\"text\" hidden required>` — the `hidden` *attribute*, not\n * `type=\"hidden\"`, which is barred from constraint validation. Native\n * constraints then govern the widget's value with no extra JavaScript. The\n * widget dispatches a bubbling `change` on the mirror when a value is committed\n * (a completed interaction, so it validates immediately), and focus for an\n * invalid mirror is delegated to the field's visible `control` target — the\n * target itself when focusable, else its first focusable descendant.\n *\n * No-JS caveat: a `required` mirror also gates the browser's own pre-Stimulus\n * validation, which cannot surface UI on an invisible control. When the no-JS\n * fallback matters, author `novalidate` on the form (this controller preserves\n * an author-set attribute) so the submission reaches the server's validation.\n */\nexport class FormValidationController extends Controller<HTMLFormElement> {\n  static override outlets = [\"stimeo--form-field\"];\n  static override values = {\n    validateOnBlur: { type: Boolean, default: true },\n    validateOnChange: { type: Boolean, default: true },\n    revalidateOnInput: { type: Boolean, default: true },\n    focusInvalid: { type: Boolean, default: true },\n  };\n  static actions = [\"validate\"] as const;\n  static events = [\"valid\", \"invalid\"] as const;\n\n  declare readonly stimeoFormFieldOutlets: FormFieldController[];\n  declare readonly stimeoFormFieldOutletElements: HTMLElement[];\n\n  declare validateOnBlurValue: boolean;\n  declare validateOnChangeValue: boolean;\n  declare revalidateOnInputValue: boolean;\n  declare focusInvalidValue: boolean;\n\n  /** Marker recording that we added `novalidate`, so we only remove our own. */\n  static readonly #NOVALIDATE_MARKER = \"data-stimeo--form-validation-novalidate\";\n\n  /** Controls already interacted with — the gate for blur / input (re)validation. */\n  readonly #touched = new WeakSet<ValidatableControl>();\n\n  /**\n   * Controls whose `customError` *we* set via the `disallow` rule. Tracked so we\n   * only ever clear our own custom validity — a consumer's `setCustomValidity` on\n   * the same control survives once our rule passes (don't-clobber-authored-state).\n   */\n  readonly #ownedCustomError = new WeakSet<ValidatableControl>();\n\n  readonly #onSubmit = (event: SubmitEvent): void => {\n    if (event.target !== this.element) return;\n    const invalid = this.#validateAll();\n    if (invalid.length === 0) {\n      this.dispatch(\"valid\", { detail: {} });\n      return;\n    }\n    // Cancel the whole submit: preventDefault stops native/Turbo navigation;\n    // stopImmediatePropagation keeps later submit handlers (e.g. submit-once's\n    // busy state) from acting on a submission that will never happen.\n    event.preventDefault();\n    event.stopImmediatePropagation();\n    const first = invalid[0];\n    if (this.focusInvalidValue && first) this.#focusTargetFor(first)?.focus();\n    this.dispatch(\"invalid\", { detail: { invalid } });\n  };\n\n  readonly #onFocusOut = (event: FocusEvent): void => {\n    if (!this.validateOnBlurValue) return;\n    const control = this.#controlFrom(event.target);\n    if (!control) return;\n    // Focus moving *within* the same field (e.g. between members of a radio\n    // group) is not leaving it — defer validation until focus actually exits.\n    const field = this.#fieldFor(control);\n    const related = event.relatedTarget;\n    if (field && related instanceof Node && field.element.contains(related)) return;\n    this.#touched.add(control);\n    this.#validateControl(control);\n  };\n\n  readonly #onInput = (event: Event): void => {\n    if (!this.revalidateOnInputValue) return;\n    const control = this.#controlFrom(event.target);\n    // Only re-validate a field the user has already left once, so the first\n    // keystroke never eagerly flags a control they are still filling in.\n    if (!control || !this.#touched.has(control)) return;\n    this.#validateControl(control);\n  };\n\n  readonly #onChange = (event: Event): void => {\n    if (!this.validateOnChangeValue) return;\n    const control = this.#controlFrom(event.target);\n    if (!control) return;\n    // change marks a *committed* interaction (a picked option, a toggled box, a\n    // widget writing its mirror), so unlike input it both touches and validates.\n    this.#touched.add(control);\n    this.#validateControl(control);\n  };\n\n  /** Suppresses native bubbles and binds the submit / blur / input listeners. */\n  override connect(): void {\n    if (!this.element.hasAttribute(\"novalidate\")) {\n      this.element.setAttribute(\"novalidate\", \"\");\n      this.element.setAttribute(FormValidationController.#NOVALIDATE_MARKER, \"\");\n    }\n    // Capture phase on the document so we run before any submit listener bound to\n    // the form itself (Stimulus actions, submit-once), whose relative order in the\n    // target phase would otherwise be unpredictable.\n    document.addEventListener(\"submit\", this.#onSubmit, true);\n    this.element.addEventListener(\"focusout\", this.#onFocusOut);\n    this.element.addEventListener(\"input\", this.#onInput);\n    this.element.addEventListener(\"change\", this.#onChange);\n  }\n\n  /** Tears down listeners and restores `novalidate` if we added it. */\n  override disconnect(): void {\n    document.removeEventListener(\"submit\", this.#onSubmit, true);\n    this.element.removeEventListener(\"focusout\", this.#onFocusOut);\n    this.element.removeEventListener(\"input\", this.#onInput);\n    this.element.removeEventListener(\"change\", this.#onChange);\n    if (this.element.hasAttribute(FormValidationController.#NOVALIDATE_MARKER)) {\n      this.element.removeAttribute(\"novalidate\");\n      this.element.removeAttribute(FormValidationController.#NOVALIDATE_MARKER);\n    }\n  }\n\n  /**\n   * Validates every control now, rendering or clearing each field's message, and\n   * returns whether the whole form is valid. Marks every control touched so a\n   * later input re-validates it. Bound via `data-action`\n   * (`#validate`) or callable directly (e.g. before a programmatic submit).\n   */\n  validate(): boolean {\n    return this.#validateAll().length === 0;\n  }\n\n  /**\n   * Validates every control and returns one invalid control per field. Controls\n   * are grouped by field first (see {@link #keyFor}) so a field with several\n   * controls — a radio group, or a mirror plus its visible control — reflects\n   * *all* of them: a valid sibling must never clear an invalid one's message.\n   * Each group's first invalid control supplies the message and the focus target.\n   */\n  #validateAll(): ValidatableControl[] {\n    const groups = new Map<unknown, FieldGroup>();\n    for (const control of this.#controls) {\n      this.#touched.add(control);\n      const field = this.#fieldFor(control);\n      const key = this.#keyFor(control, field);\n      const group = groups.get(key);\n      if (group) {\n        group.controls.push(control);\n      } else {\n        groups.set(key, { field, controls: [control] });\n      }\n    }\n\n    const invalid: ValidatableControl[] = [];\n    for (const group of groups.values()) {\n      const firstInvalid = this.#applyGroup(group);\n      if (firstInvalid) invalid.push(firstInvalid);\n    }\n    return invalid;\n  }\n\n  /** Re-validates the whole field a single control belongs to (or that control). */\n  #validateControl(control: ValidatableControl): void {\n    const field = this.#fieldFor(control);\n    const key = this.#keyFor(control, field);\n    const controls = this.#controls.filter(\n      (other) => this.#keyFor(other, this.#fieldFor(other)) === key,\n    );\n    this.#applyGroup({ field, controls });\n  }\n\n  /**\n   * Runs native constraint validation across a field's controls and routes the\n   * result to its `stimeo--form-field` outlet: the first invalid control's\n   * `validationMessage` is shown, an all-valid field is cleared. Returns the\n   * first invalid control (for the invalid list / focus), or `null` when valid.\n   * Routing goes through the outlet, so the ARIA wiring is never duplicated here.\n   */\n  #applyGroup(group: FieldGroup): ValidatableControl | null {\n    // Apply declarative custom rules (e.g. disallow=\"whitespace\") before reading\n    // validity so they participate in checkValidity() like a native constraint.\n    for (const control of group.controls) this.#syncCustomValidity(control);\n    const firstInvalid = group.controls.find((control) => !control.checkValidity()) ?? null;\n    if (group.field) {\n      if (firstInvalid) {\n        group.field.setError(this.#messageFor(firstInvalid));\n      } else {\n        group.field.clearError();\n      }\n    }\n    return firstInvalid;\n  }\n\n  /**\n   * Resolves the message to show for an invalid control: a per-constraint\n   * override (`data-stimeo--form-field-message-<constraint>`) for the first failing\n   * `ValidityState` flag, then a generic `data-stimeo--form-field-message`\n   * override, then the browser's native `validationMessage`. Authoring an override\n   * gives controlled, localizable, theme-able wording with **no consumer JS** —\n   * and sidesteps headless browsers that return an empty native message.\n   */\n  #messageFor(control: ValidatableControl): string {\n    for (const [flag, key] of CONSTRAINT_MESSAGE_KEYS) {\n      if (control.validity[flag]) {\n        return (\n          control.getAttribute(`${MESSAGE_ATTR_PREFIX}${key}`) ??\n          control.getAttribute(MESSAGE_ATTR_GENERIC) ??\n          control.validationMessage\n        );\n      }\n    }\n    // customError (our `disallow` rule, or a consumer's setCustomValidity): for our\n    // rule the message was already resolved with per-constraint > generic > default\n    // precedence when set, and a consumer error carries its own text — so return the\n    // live validationMessage as-is, falling back to the generic override then \"\".\n    return control.validationMessage || control.getAttribute(MESSAGE_ATTR_GENERIC) || \"\";\n  }\n\n  /**\n   * Applies (or clears) a declarative custom constraint via `setCustomValidity`,\n   * for controls that opt in with `data-stimeo--form-field-disallow`. The supported\n   * rule is `\"whitespace\"` — a value that is non-empty but blank\n   * after trimming (which slips past `required` / `minlength`); its message follows\n   * the per-constraint (`value-missing`) → generic → default chain.\n   *\n   * Don't-clobber-authored-state: an unknown/absent rule is never touched, and a\n   * custom error is only cleared when *we* set it (tracked in {@link #ownedCustomError}),\n   * so a consumer's own `setCustomValidity` on the same control survives.\n   */\n  #syncCustomValidity(control: ValidatableControl): void {\n    const violates =\n      control.getAttribute(DISALLOW_ATTR) === \"whitespace\" &&\n      control.value.length > 0 &&\n      control.value.trim() === \"\";\n    if (violates) {\n      control.setCustomValidity(\n        control.getAttribute(`${MESSAGE_ATTR_PREFIX}value-missing`) ??\n          control.getAttribute(MESSAGE_ATTR_GENERIC) ??\n          DISALLOW_WHITESPACE_DEFAULT,\n      );\n      this.#ownedCustomError.add(control);\n    } else if (this.#ownedCustomError.has(control)) {\n      // Only clear the custom error we previously set; leave a consumer's intact.\n      this.#ownedCustomError.delete(control);\n      control.setCustomValidity(\"\");\n    }\n  }\n\n  /**\n   * A grouping key that collects controls belonging to the same field: the owning\n   * `stimeo--form-field` when present, else a radio group's shared `name`, else\n   * the control itself (always distinct).\n   */\n  #keyFor(control: ValidatableControl, field: FormFieldController | undefined): unknown {\n    if (field) return field;\n    if (control instanceof HTMLInputElement && control.type === \"radio\" && control.name) {\n      return `radio:${control.name}`;\n    }\n    return control;\n  }\n\n  /**\n   * Where focus should land for an invalid control. A visible control is focused\n   * directly (status quo for native fields and radios). A validatable mirror\n   * (the `hidden` attribute) cannot receive focus, so focus is delegated to the\n   * visible widget: the owning field's `control` target when it is itself\n   * focusable, else its first focusable descendant (e.g. a roving-tabindex\n   * member). Resolved structurally — never by probing `focus()` — so behavior\n   * is deterministic and CSS-independent.\n   */\n  #focusTargetFor(control: ValidatableControl): HTMLElement | null {\n    if (!control.hidden) return control;\n    const field = this.#fieldFor(control);\n    if (!field?.hasControlTarget) return null;\n    const root = field.controlTarget;\n    if (root.matches(FOCUSABLE)) return root;\n    return root.querySelector<HTMLElement>(FOCUSABLE);\n  }\n\n  /** The `stimeo--form-field` outlet whose element contains `control`, if any. */\n  #fieldFor(control: ValidatableControl): FormFieldController | undefined {\n    const elements = this.stimeoFormFieldOutletElements;\n    for (let index = 0; index < elements.length; index++) {\n      if (elements[index]?.contains(control)) return this.stimeoFormFieldOutlets[index];\n    }\n    return undefined;\n  }\n\n  /** This form's native controls that participate in constraint validation. */\n  get #controls(): ValidatableControl[] {\n    const controls: ValidatableControl[] = [];\n    for (const element of Array.from(this.element.elements)) {\n      if (this.#isValidatable(element)) controls.push(element);\n    }\n    return controls;\n  }\n\n  /** Narrows an event target to a validatable control. */\n  #controlFrom(target: EventTarget | null): ValidatableControl | null {\n    return target instanceof Element && this.#isValidatable(target) ? target : null;\n  }\n\n  #isValidatable(element: Element): element is ValidatableControl {\n    return (\n      (element instanceof HTMLInputElement ||\n        element instanceof HTMLSelectElement ||\n        element instanceof HTMLTextAreaElement) &&\n      // `willValidate` already excludes disabled, read-only, hidden, and button\n      // controls — the exact set barred from constraint validation.\n      element.willValidate\n    );\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/focus_trap.ts","../../src/controllers/form_validation_controller.ts"],"names":[],"mappings":"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","file":"form_validation_controller.js","sourcesContent":["import { BeforeCacheReset } from \"./before_cache_reset\";\nimport { EscapeLayer } from \"./escape_layer\";\n\n/**\n * Modal focus-trap primitive shared by the modal-overlay controllers\n * (dialog / alert-dialog / confirm / drawer / command-palette / sidebar); the\n * non-modal focus scope (focus) reuses it with the modal side effects opted out.\n *\n * The WAI-ARIA APG modal pattern is more than \"cycle Tab inside a box\": a modal\n * also locks background scroll, makes the rest of the page `inert` (so assistive\n * technology and pointer/Tab cannot reach it, honoring `aria-modal=\"true\"`),\n * sends focus inside on open, and restores it to the opener on close — and every\n * one of those side effects must be reverted if the element is torn down while\n * open (a Turbo navigation mid-dialog) and kept out of the snapshot Turbo\n * caches (`turbo:before-cache`). {@link FocusTrap} owns that whole modal\n * lifecycle so each controller only decides *when* to open/close and *what*\n * \"close\" means.\n *\n * It is intentionally **policy-free about closing**. Escape semantics differ per\n * widget (a plain dialog just closes; an alert-dialog closes *as a cancel* with a\n * reason; a drawer runs an exit transition), so the trap merely forwards Escape\n * to an {@link FocusTrapOptions.onEscape | onEscape} callback and never decides on\n * its own what closing entails.\n *\n * @remarks\n * The container is read through a getter so a controller can hand over a Stimulus\n * target without worrying about when the trap instance is constructed relative to\n * `connect()`.\n */\n\n/**\n * Selector matching the elements considered focusable. Shared by the trap's Tab\n * cycling and by form-validation's invalid-focus delegation.\n */\nexport const FOCUSABLE =\n  'a[href], button:not([disabled]), textarea:not([disabled]), input:not([disabled]), select:not([disabled]), [tabindex]:not([tabindex=\"-1\"])';\n\n/** Behavior hooks a controller supplies when constructing a {@link FocusTrap}. */\nexport interface FocusTrapOptions {\n  /**\n   * Called when `Escape` is pressed while the trap is active. When omitted,\n   * `Escape` is left alone (the trap never joins the Escape stack). Dismissal\n   * is resolved by the shared {@link EscapeLayer}: an Escape already consumed\n   * by an inner handler is ignored, and among active layers the most recently\n   * activated claiming one owns the press. The resolver consumes the event\n   * before invoking the callback.\n   */\n  onEscape?: () => void;\n  /**\n   * Returns the element to focus when the trap activates. When it returns `null`\n   * (or is omitted), the first focusable descendant is used, falling back to the\n   * container itself (made programmatically focusable with `tabindex=-1`).\n   */\n  initialFocus?: () => HTMLElement | null;\n  /**\n   * Returns the element to focus on deactivation when nothing was focused before\n   * the trap opened (e.g. the trigger). The element focused *before* opening\n   * always takes precedence.\n   */\n  fallbackFocus?: () => HTMLElement | null;\n  /**\n   * Lock background scroll (`body` overflow) while active. Defaults to `true` for\n   * the modal overlays; a lighter focus scope passes `false`. Read on `activate`.\n   */\n  lockScroll?: boolean | (() => boolean);\n  /**\n   * Make background siblings `inert` while active (the `aria-modal` isolation).\n   * Defaults to `true` for the modal overlays; a soft focus scope can opt out so\n   * the background stays reachable while `Tab` still cycles inside. Read on `activate`.\n   */\n  isolate?: boolean | (() => boolean);\n  /**\n   * Move focus inside on `activate`. Defaults to `true`; a focus scope that only\n   * wants the `Tab` boundary (no focus move) passes `false`. Read on `activate`.\n   */\n  autoFocus?: boolean | (() => boolean);\n}\n\n/**\n * Owns the modal side effects (scroll lock, background `inert`, focus trap, focus\n * restore) for a single container, applied on {@link activate} and reverted on\n * {@link deactivate}.\n */\nexport class FocusTrap {\n  /** The element focused before activation, restored on deactivation. */\n  #previouslyFocused: HTMLElement | null = null;\n  /** The body's inline `overflow` before locking, restored on deactivation. */\n  #previousBodyOverflow = \"\";\n  /** Whether scroll was locked this activation (so it is only restored if applied). */\n  #scrollLocked = false;\n  /** Background siblings made `inert` while active, restored on deactivation. */\n  #inertedSiblings: HTMLElement[] = [];\n  /** Whether the modal side effects are currently applied. */\n  #activeState = false;\n  /** Registers the trap on the shared Escape stack while active (see {@link EscapeLayer}). */\n  readonly #escapeLayer = new EscapeLayer();\n\n  /** Returns the trapped element; called on every operation for the live target. */\n  readonly #getContainer: () => HTMLElement;\n  /** Closing/focus hooks; see {@link FocusTrapOptions}. */\n  readonly #options: FocusTrapOptions;\n\n  /**\n   * @param getContainer - Returns the trapped element. Called on every operation\n   *   so the live target is always used.\n   * @param options - Closing/focus hooks; see {@link FocusTrapOptions}.\n   */\n  constructor(getContainer: () => HTMLElement, options: FocusTrapOptions = {}) {\n    this.#getContainer = getContainer;\n    this.#options = options;\n  }\n\n  /** Whether the trap is currently active. */\n  get active(): boolean {\n    return this.#activeState;\n  }\n\n  /**\n   * Applies the trap: records the current focus, optionally locks background scroll\n   * and makes background siblings `inert`, listens for `Tab`/`Escape`, and (unless\n   * `autoFocus` is off) moves focus inside. No-ops if already active.\n   */\n  activate(): void {\n    if (this.#activeState) return;\n    this.#activeState = true;\n    // Record the opener so it can be refocused on close. `<body>` (the default\n    // active element when nothing is focused) is treated as \"nothing\", so the\n    // fallback target — typically the trigger — wins in that case.\n    const active = document.activeElement;\n    this.#previouslyFocused =\n      active instanceof HTMLElement && active !== document.body ? active : null;\n    if (this.#flag(this.#options.lockScroll, true)) {\n      this.#previousBodyOverflow = document.body.style.overflow;\n      document.body.style.overflow = \"hidden\";\n      this.#scrollLocked = true;\n    }\n    if (this.#flag(this.#options.isolate, true)) this.#isolateBackground();\n    document.addEventListener(\"keydown\", this.#onKeydown);\n    this.#beforeCache.activate();\n    const onEscape = this.#options.onEscape;\n    if (onEscape) this.#escapeLayer.activate(document, { onDismiss: () => onEscape() });\n    if (this.#flag(this.#options.autoFocus, true)) this.#focusInitial();\n  }\n\n  /**\n   * Reverts every side effect applied by {@link activate}. No-ops if inactive, so\n   * a controller can call it defensively from both `close()` and `disconnect()`.\n   *\n   * @param restoreFocus - Move focus back to the opener (default `true`). Pass\n   *   `false` on teardown (`disconnect`), where yanking focus is undesirable.\n   */\n  deactivate({ restoreFocus = true }: { restoreFocus?: boolean } = {}): void {\n    if (!this.#activeState) return;\n    this.#activeState = false;\n    this.#escapeLayer.deactivate();\n    document.removeEventListener(\"keydown\", this.#onKeydown);\n    this.#beforeCache.deactivate();\n    if (this.#scrollLocked) {\n      document.body.style.overflow = this.#previousBodyOverflow;\n      this.#scrollLocked = false;\n    }\n    this.#releaseBackground();\n    if (restoreFocus) {\n      const target = this.#previouslyFocused ?? this.#options.fallbackFocus?.() ?? null;\n      target?.focus();\n    }\n  }\n\n  /** Resolves a boolean-or-getter option, defaulting when it was not provided. */\n  #flag(option: boolean | (() => boolean) | undefined, fallback: boolean): boolean {\n    if (option === undefined) return fallback;\n    return typeof option === \"function\" ? option() : option;\n  }\n\n  /**\n   * Reverts the side effects just before Turbo caches the page snapshot, so an\n   * overlay left open does not bake the scroll lock into `body[style]` — a\n   * restored page would feed that locked value back into {@link activate} as the\n   * baseline, and closing would then never unlock the page. Markup state stays\n   * untouched (restore-open designs reopen against a clean baseline), and focus\n   * is left alone mid-navigation. The listener lives only while active.\n   */\n  readonly #beforeCache = new BeforeCacheReset(() => this.deactivate({ restoreFocus: false }));\n\n  /**\n   * Handles `Tab` (focus trap) while active. `Escape` dismissal is owned by the\n   * shared {@link EscapeLayer} resolver, so Tab trapping stays independent of\n   * which layer currently owns Escape.\n   */\n  readonly #onKeydown = (event: KeyboardEvent): void => {\n    if (event.key === \"Tab\") this.#trapTab(event);\n  };\n\n  /** Keeps `Tab` focus cycling within the container's focusable elements. */\n  #trapTab(event: KeyboardEvent): void {\n    const focusable = this.#focusableElements();\n    if (focusable.length === 0) {\n      event.preventDefault();\n      return;\n    }\n    const first = focusable[0];\n    const last = focusable[focusable.length - 1];\n    const active = document.activeElement;\n\n    // If focus has somehow escaped the container, pull it back to the first item.\n    if (!(active instanceof Node) || !this.#getContainer().contains(active)) {\n      event.preventDefault();\n      first?.focus();\n      return;\n    }\n\n    if (event.shiftKey && active === first) {\n      event.preventDefault();\n      last?.focus();\n    } else if (!event.shiftKey && active === last) {\n      event.preventDefault();\n      first?.focus();\n    }\n  }\n\n  /**\n   * Marks every element outside the container's subtree as `inert` so background\n   * content cannot be focused or reached by assistive technology, honoring the\n   * `aria-modal=\"true\"` contract. An element that was *already* `inert` is left\n   * untracked so `#releaseBackground` does not wrongly clear it.\n   */\n  #isolateBackground(): void {\n    const container = this.#getContainer();\n    this.#inertedSiblings = [];\n    for (const sibling of Array.from(document.body.children)) {\n      if (!(sibling instanceof HTMLElement)) continue;\n      if (sibling.contains(container) || sibling.inert) continue;\n      sibling.inert = true;\n      this.#inertedSiblings.push(sibling);\n    }\n  }\n\n  /** Reverts the `inert` flags applied by `#isolateBackground`. */\n  #releaseBackground(): void {\n    for (const sibling of this.#inertedSiblings) {\n      sibling.inert = false;\n    }\n    this.#inertedSiblings = [];\n  }\n\n  /** Moves focus to the initial target, the first focusable, or the container. */\n  #focusInitial(): void {\n    const preferred = this.#options.initialFocus?.();\n    if (preferred) {\n      preferred.focus();\n      return;\n    }\n    const focusable = this.#focusableElements();\n    if (focusable[0]) {\n      focusable[0].focus();\n      return;\n    }\n    const container = this.#getContainer();\n    container.tabIndex = -1;\n    container.focus();\n  }\n\n  /** Collects the container's currently focusable descendants in DOM order. */\n  #focusableElements(): HTMLElement[] {\n    return Array.from(this.#getContainer().querySelectorAll<HTMLElement>(FOCUSABLE)).filter(\n      (el) => !el.hidden,\n    );\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { FOCUSABLE } from \"../utils/focus_trap\";\nimport type { FormFieldController } from \"./form_field_controller\";\n\n/** Native form controls that participate in constraint validation. */\ntype ValidatableControl = HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement;\n\n/**\n * Maps each `ValidityState` flag (in priority order) to the kebab-case suffix of\n * its per-constraint message-override attribute. The first flag that is `true`\n * wins, so e.g. `valueMissing` is reported before a stale `patternMismatch`.\n */\nconst CONSTRAINT_MESSAGE_KEYS: ReadonlyArray<readonly [keyof ValidityState, string]> = [\n  [\"valueMissing\", \"value-missing\"],\n  [\"typeMismatch\", \"type-mismatch\"],\n  [\"patternMismatch\", \"pattern-mismatch\"],\n  [\"tooShort\", \"too-short\"],\n  [\"tooLong\", \"too-long\"],\n  [\"rangeUnderflow\", \"range-underflow\"],\n  [\"rangeOverflow\", \"range-overflow\"],\n  [\"stepMismatch\", \"step-mismatch\"],\n  [\"badInput\", \"bad-input\"],\n];\n\n/** Attribute prefix for a per-constraint message override, authored on the control. */\nconst MESSAGE_ATTR_PREFIX = \"data-stimeo--form-field-message-\";\n/** Attribute for a generic message override applied to any failing constraint. */\nconst MESSAGE_ATTR_GENERIC = \"data-stimeo--form-field-message\";\n/** Attribute opting a control into a declarative custom rule (`\"whitespace\"`). */\nconst DISALLOW_ATTR = \"data-stimeo--form-field-disallow\";\n/** Default message when `disallow=\"whitespace\"` fails and no override is given. */\nconst DISALLOW_WHITESPACE_DEFAULT = \"Please enter a value that is not only whitespace.\";\n\n/** A field's validatable controls, grouped so the whole field validates together. */\ninterface FieldGroup {\n  readonly field: FormFieldController | undefined;\n  readonly controls: ValidatableControl[];\n}\n\n/**\n * Headless, accessible **form-validation orchestration**.\n *\n * Markup contract (identifier: `stimeo--form-validation`):\n *   <form data-controller=\"stimeo--form-validation\"\n *         data-stimeo--form-validation-stimeo--form-field-outlet=\"[data-controller~='stimeo--form-field']\">\n *     <div data-controller=\"stimeo--form-field\">\n *       <label for=\"email\">Email</label>\n *       <input id=\"email\" type=\"email\" required\n *              data-stimeo--form-field-target=\"control\" />\n *       <p role=\"alert\" hidden data-stimeo--form-field-target=\"error\"></p>\n *     </div>\n *     <button type=\"submit\">Save</button>\n *   </form>\n *\n * Not an APG widget pattern — this is the *timing* layer for **error\n * identification** (WCAG 3.3.1) and **error suggestion** (3.3.3): it decides\n * *when* each control is checked and routes the browser's native\n * `validationMessage` into the field's {@link FormFieldController} error region.\n * The per-field ARIA wiring (`aria-invalid` / `aria-errormessage` /\n * `aria-describedby`) therefore lives in exactly one place — `stimeo--form-field`,\n * reached through a Stimulus **outlet** — and is never re-implemented here.\n *\n * @remarks\n * Behavior only — validation **rules** stay in the markup (native HTML\n * constraints: `required`, `type`, `pattern`, `min`/`max`, …) or in the consumer's\n * own `setCustomValidity()` calls, which `checkValidity()` surfaces transparently.\n * It sets the form's `novalidate` so it can replace the browser's default error\n * bubbles with the accessible, in-page `role=\"alert\"` regions, and restores the\n * attribute on disconnect.\n *\n * Two declarative escape hatches let a field **exceed** native validation with no\n * consumer JS (author them on the control):\n * - **Per-constraint messages** — `data-stimeo--form-field-message-<constraint>`\n *   (`value-missing`, `too-short`, `too-long`, `pattern-mismatch`, `type-mismatch`,\n *   `range-overflow`, `range-underflow`, `step-mismatch`, `bad-input`), or a generic\n *   `data-stimeo--form-field-message` fallback, override the shown text per failing\n *   `ValidityState` flag — controlled, localizable wording that also fixes headless\n *   browsers returning an empty native `validationMessage`. Falls back to native.\n * - **`data-stimeo--form-field-disallow=\"whitespace\"`** — a built-in custom rule\n *   rejecting a value that is blank after trimming (which slips past `required` /\n *   `minlength`), wired through `setCustomValidity` so it blocks submit like any\n *   native constraint.\n *\n * Behavior provided:\n * - On connect, suppresses native bubbles (`novalidate`, restored on disconnect)\n *   and intercepts the form's `submit` in the **capture phase** so an invalid form\n *   is cancelled before any other submit handler (e.g. `stimeo--submit-once`)\n *   reacts to a submission that will never happen.\n * - On submit, validates every control; if any is invalid it blocks submission,\n *   moves focus to the first invalid control (unless `focusInvalid` is `false`),\n *   and dispatches `stimeo--form-validation:invalid`. An all-valid form dispatches\n *   `:valid` and submits normally.\n * - Validates a field on blur once it has been interacted with (`validateOnBlur`),\n *   and re-validates it on input while it is already touched\n *   (`revalidateOnInput`) so a shown message clears the moment the value becomes\n *   valid — but a pristine field is never eagerly flagged mid-typing.\n *\n * A control with no owning `stimeo--form-field` outlet is still validated (it can\n * block submit and receive focus) but renders no message.\n *\n * Radio groups work unchanged: point the field's `control` target at the\n * `role=\"radiogroup\"` container so the invalid state lands on the group, and the\n * group is reported as a single invalid entry (not one per radio).\n *\n * Rich widgets (listbox, time-picker, …) that keep their committed value in a\n * hidden holder participate by making that holder a **validatable mirror**:\n * `<input type=\"text\" hidden required>` — the `hidden` *attribute*, not\n * `type=\"hidden\"`, which is barred from constraint validation. Native\n * constraints then govern the widget's value with no extra JavaScript. The\n * widget dispatches a bubbling `change` on the mirror when a value is committed\n * (a completed interaction, so it validates immediately), and focus for an\n * invalid mirror is delegated to the field's visible `control` target — the\n * target itself when focusable, else its first focusable descendant.\n *\n * No-JS caveat: a `required` mirror also gates the browser's own pre-Stimulus\n * validation, which cannot surface UI on an invisible control. When the no-JS\n * fallback matters, author `novalidate` on the form (this controller preserves\n * an author-set attribute) so the submission reaches the server's validation.\n */\nexport class FormValidationController extends Controller<HTMLFormElement> {\n  static override outlets = [\"stimeo--form-field\"];\n  static override values = {\n    validateOnBlur: { type: Boolean, default: true },\n    validateOnChange: { type: Boolean, default: true },\n    revalidateOnInput: { type: Boolean, default: true },\n    focusInvalid: { type: Boolean, default: true },\n  };\n  static actions = [\"validate\"] as const;\n  static events = [\"valid\", \"invalid\"] as const;\n\n  declare readonly stimeoFormFieldOutlets: FormFieldController[];\n  declare readonly stimeoFormFieldOutletElements: HTMLElement[];\n\n  declare validateOnBlurValue: boolean;\n  declare validateOnChangeValue: boolean;\n  declare revalidateOnInputValue: boolean;\n  declare focusInvalidValue: boolean;\n\n  /** Marker recording that we added `novalidate`, so we only remove our own. */\n  static readonly #NOVALIDATE_MARKER = \"data-stimeo--form-validation-novalidate\";\n\n  /** Controls already interacted with — the gate for blur / input (re)validation. */\n  readonly #touched = new WeakSet<ValidatableControl>();\n\n  /**\n   * Controls whose `customError` *we* set via the `disallow` rule. Tracked so we\n   * only ever clear our own custom validity — a consumer's `setCustomValidity` on\n   * the same control survives once our rule passes (don't-clobber-authored-state).\n   */\n  readonly #ownedCustomError = new WeakSet<ValidatableControl>();\n\n  readonly #onSubmit = (event: SubmitEvent): void => {\n    if (event.target !== this.element) return;\n    const invalid = this.#validateAll();\n    if (invalid.length === 0) {\n      this.dispatch(\"valid\", { detail: {} });\n      return;\n    }\n    // Cancel the whole submit: preventDefault stops native/Turbo navigation;\n    // stopImmediatePropagation keeps later submit handlers (e.g. submit-once's\n    // busy state) from acting on a submission that will never happen.\n    event.preventDefault();\n    event.stopImmediatePropagation();\n    const first = invalid[0];\n    if (this.focusInvalidValue && first) this.#focusTargetFor(first)?.focus();\n    this.dispatch(\"invalid\", { detail: { invalid } });\n  };\n\n  readonly #onFocusOut = (event: FocusEvent): void => {\n    if (!this.validateOnBlurValue) return;\n    const control = this.#controlFrom(event.target);\n    if (!control) return;\n    // Focus moving *within* the same field (e.g. between members of a radio\n    // group) is not leaving it — defer validation until focus actually exits.\n    const field = this.#fieldFor(control);\n    const related = event.relatedTarget;\n    if (field && related instanceof Node && field.element.contains(related)) return;\n    this.#touched.add(control);\n    this.#validateControl(control);\n  };\n\n  readonly #onInput = (event: Event): void => {\n    if (!this.revalidateOnInputValue) return;\n    const control = this.#controlFrom(event.target);\n    // Only re-validate a field the user has already left once, so the first\n    // keystroke never eagerly flags a control they are still filling in.\n    if (!control || !this.#touched.has(control)) return;\n    this.#validateControl(control);\n  };\n\n  readonly #onChange = (event: Event): void => {\n    if (!this.validateOnChangeValue) return;\n    const control = this.#controlFrom(event.target);\n    if (!control) return;\n    // change marks a *committed* interaction (a picked option, a toggled box, a\n    // widget writing its mirror), so unlike input it both touches and validates.\n    this.#touched.add(control);\n    this.#validateControl(control);\n  };\n\n  /** Suppresses native bubbles and binds the submit / blur / input listeners. */\n  override connect(): void {\n    if (!this.element.hasAttribute(\"novalidate\")) {\n      this.element.setAttribute(\"novalidate\", \"\");\n      this.element.setAttribute(FormValidationController.#NOVALIDATE_MARKER, \"\");\n    }\n    // Capture phase on the document so we run before any submit listener bound to\n    // the form itself (Stimulus actions, submit-once), whose relative order in the\n    // target phase would otherwise be unpredictable.\n    document.addEventListener(\"submit\", this.#onSubmit, true);\n    this.element.addEventListener(\"focusout\", this.#onFocusOut);\n    this.element.addEventListener(\"input\", this.#onInput);\n    this.element.addEventListener(\"change\", this.#onChange);\n  }\n\n  /** Tears down listeners and restores `novalidate` if we added it. */\n  override disconnect(): void {\n    document.removeEventListener(\"submit\", this.#onSubmit, true);\n    this.element.removeEventListener(\"focusout\", this.#onFocusOut);\n    this.element.removeEventListener(\"input\", this.#onInput);\n    this.element.removeEventListener(\"change\", this.#onChange);\n    if (this.element.hasAttribute(FormValidationController.#NOVALIDATE_MARKER)) {\n      this.element.removeAttribute(\"novalidate\");\n      this.element.removeAttribute(FormValidationController.#NOVALIDATE_MARKER);\n    }\n  }\n\n  /**\n   * Validates every control now, rendering or clearing each field's message, and\n   * returns whether the whole form is valid. Marks every control touched so a\n   * later input re-validates it. Bound via `data-action`\n   * (`#validate`) or callable directly (e.g. before a programmatic submit).\n   */\n  validate(): boolean {\n    return this.#validateAll().length === 0;\n  }\n\n  /**\n   * Validates every control and returns one invalid control per field. Controls\n   * are grouped by field first (see {@link #keyFor}) so a field with several\n   * controls — a radio group, or a mirror plus its visible control — reflects\n   * *all* of them: a valid sibling must never clear an invalid one's message.\n   * Each group's first invalid control supplies the message and the focus target.\n   */\n  #validateAll(): ValidatableControl[] {\n    const groups = new Map<unknown, FieldGroup>();\n    for (const control of this.#controls) {\n      this.#touched.add(control);\n      const field = this.#fieldFor(control);\n      const key = this.#keyFor(control, field);\n      const group = groups.get(key);\n      if (group) {\n        group.controls.push(control);\n      } else {\n        groups.set(key, { field, controls: [control] });\n      }\n    }\n\n    const invalid: ValidatableControl[] = [];\n    for (const group of groups.values()) {\n      const firstInvalid = this.#applyGroup(group);\n      if (firstInvalid) invalid.push(firstInvalid);\n    }\n    return invalid;\n  }\n\n  /** Re-validates the whole field a single control belongs to (or that control). */\n  #validateControl(control: ValidatableControl): void {\n    const field = this.#fieldFor(control);\n    const key = this.#keyFor(control, field);\n    const controls = this.#controls.filter(\n      (other) => this.#keyFor(other, this.#fieldFor(other)) === key,\n    );\n    this.#applyGroup({ field, controls });\n  }\n\n  /**\n   * Runs native constraint validation across a field's controls and routes the\n   * result to its `stimeo--form-field` outlet: the first invalid control's\n   * `validationMessage` is shown, an all-valid field is cleared. Returns the\n   * first invalid control (for the invalid list / focus), or `null` when valid.\n   * Routing goes through the outlet, so the ARIA wiring is never duplicated here.\n   */\n  #applyGroup(group: FieldGroup): ValidatableControl | null {\n    // Apply declarative custom rules (e.g. disallow=\"whitespace\") before reading\n    // validity so they participate in checkValidity() like a native constraint.\n    for (const control of group.controls) this.#syncCustomValidity(control);\n    const firstInvalid = group.controls.find((control) => !control.checkValidity()) ?? null;\n    if (group.field) {\n      if (firstInvalid) {\n        group.field.setError(this.#messageFor(firstInvalid));\n      } else {\n        group.field.clearError();\n      }\n    }\n    return firstInvalid;\n  }\n\n  /**\n   * Resolves the message to show for an invalid control: a per-constraint\n   * override (`data-stimeo--form-field-message-<constraint>`) for the first failing\n   * `ValidityState` flag, then a generic `data-stimeo--form-field-message`\n   * override, then the browser's native `validationMessage`. Authoring an override\n   * gives controlled, localizable, theme-able wording with **no consumer JS** —\n   * and sidesteps headless browsers that return an empty native message.\n   */\n  #messageFor(control: ValidatableControl): string {\n    for (const [flag, key] of CONSTRAINT_MESSAGE_KEYS) {\n      if (control.validity[flag]) {\n        return (\n          control.getAttribute(`${MESSAGE_ATTR_PREFIX}${key}`) ??\n          control.getAttribute(MESSAGE_ATTR_GENERIC) ??\n          control.validationMessage\n        );\n      }\n    }\n    // customError (our `disallow` rule, or a consumer's setCustomValidity): for our\n    // rule the message was already resolved with per-constraint > generic > default\n    // precedence when set, and a consumer error carries its own text — so return the\n    // live validationMessage as-is, falling back to the generic override then \"\".\n    return control.validationMessage || control.getAttribute(MESSAGE_ATTR_GENERIC) || \"\";\n  }\n\n  /**\n   * Applies (or clears) a declarative custom constraint via `setCustomValidity`,\n   * for controls that opt in with `data-stimeo--form-field-disallow`. The supported\n   * rule is `\"whitespace\"` — a value that is non-empty but blank\n   * after trimming (which slips past `required` / `minlength`); its message follows\n   * the per-constraint (`value-missing`) → generic → default chain.\n   *\n   * Don't-clobber-authored-state: an unknown/absent rule is never touched, and a\n   * custom error is only cleared when *we* set it (tracked in {@link #ownedCustomError}),\n   * so a consumer's own `setCustomValidity` on the same control survives.\n   */\n  #syncCustomValidity(control: ValidatableControl): void {\n    const violates =\n      control.getAttribute(DISALLOW_ATTR) === \"whitespace\" &&\n      control.value.length > 0 &&\n      control.value.trim() === \"\";\n    if (violates) {\n      control.setCustomValidity(\n        control.getAttribute(`${MESSAGE_ATTR_PREFIX}value-missing`) ??\n          control.getAttribute(MESSAGE_ATTR_GENERIC) ??\n          DISALLOW_WHITESPACE_DEFAULT,\n      );\n      this.#ownedCustomError.add(control);\n    } else if (this.#ownedCustomError.has(control)) {\n      // Only clear the custom error this controller set; leave a consumer's intact.\n      this.#ownedCustomError.delete(control);\n      control.setCustomValidity(\"\");\n    }\n  }\n\n  /**\n   * A grouping key that collects controls belonging to the same field: the owning\n   * `stimeo--form-field` when present, else a radio group's shared `name`, else\n   * the control itself (always distinct).\n   */\n  #keyFor(control: ValidatableControl, field: FormFieldController | undefined): unknown {\n    if (field) return field;\n    if (control instanceof HTMLInputElement && control.type === \"radio\" && control.name) {\n      return `radio:${control.name}`;\n    }\n    return control;\n  }\n\n  /**\n   * Where focus should land for an invalid control. A visible control is focused\n   * directly — the case for native fields and radios. A validatable mirror\n   * (the `hidden` attribute) cannot receive focus, so focus is delegated to the\n   * visible widget: the owning field's `control` target when it is itself\n   * focusable, else its first focusable descendant (e.g. a roving-tabindex\n   * member). Resolved structurally — never by probing `focus()` — so behavior\n   * is deterministic and CSS-independent.\n   */\n  #focusTargetFor(control: ValidatableControl): HTMLElement | null {\n    if (!control.hidden) return control;\n    const field = this.#fieldFor(control);\n    if (!field?.hasControlTarget) return null;\n    const root = field.controlTarget;\n    if (root.matches(FOCUSABLE)) return root;\n    return root.querySelector<HTMLElement>(FOCUSABLE);\n  }\n\n  /** The `stimeo--form-field` outlet whose element contains `control`, if any. */\n  #fieldFor(control: ValidatableControl): FormFieldController | undefined {\n    const elements = this.stimeoFormFieldOutletElements;\n    for (let index = 0; index < elements.length; index++) {\n      if (elements[index]?.contains(control)) return this.stimeoFormFieldOutlets[index];\n    }\n    return undefined;\n  }\n\n  /** This form's native controls that participate in constraint validation. */\n  get #controls(): ValidatableControl[] {\n    const controls: ValidatableControl[] = [];\n    for (const element of Array.from(this.element.elements)) {\n      if (this.#isValidatable(element)) controls.push(element);\n    }\n    return controls;\n  }\n\n  /** Narrows an event target to a validatable control. */\n  #controlFrom(target: EventTarget | null): ValidatableControl | null {\n    return target instanceof Element && this.#isValidatable(target) ? target : null;\n  }\n\n  #isValidatable(element: Element): element is ValidatableControl {\n    return (\n      (element instanceof HTMLInputElement ||\n        element instanceof HTMLSelectElement ||\n        element instanceof HTMLTextAreaElement) &&\n      // `willValidate` already excludes disabled, read-only, hidden, and button\n      // controls — the exact set barred from constraint validation.\n      element.willValidate\n    );\n  }\n}\n"]}

package/dist/controllers/frame_loading_controller.d.ts

@@ -25,14 +25,23 @@ import { Controller } from '@hotwired/stimulus';
  * targets' `hidden`. The `content` target is marked `inert` while loading to block
  * double-submits, and focus inside the frame is explicitly blurred then restored
  * (when `restoreFocus`) so it is testable without relying on emergent `inert`
- * focus behavior. Listeners and the min-duration timer are torn down on
- * `disconnect()` (Turbo navigation included), which also tidies the hooks so a
- * cached frame is never left busy.
+ * focus behavior. Listeners are torn down on `disconnect()` (Turbo navigation
+ * included) along with the {@link MinDurationFloor} holding the finish back, kept
+ * across an in-page move by {@link DetachGate}; the hooks a cached page would
+ * freeze are rewound by {@link BeforeCacheReset}.
  */
 declare class FrameLoadingController extends Controller<HTMLElement> {
     #private;
     static targets: string[];
     static values: {
+        announceText: {
+            type: StringConstructor;
+            default: string;
+        };
+        announceReadyText: {
+            type: StringConstructor;
+            default: string;
+        };
         minDuration: {
             type: NumberConstructor;
             default: number;
@@ -51,6 +60,8 @@ declare class FrameLoadingController extends Controller<HTMLElement> {
     readonly hasOverlayTarget: boolean;
     minDurationValue: number;
     restoreFocusValue: boolean;
+    announceTextValue: string;
+    announceReadyTextValue: string;
     connect(): void;
     disconnect(): void;
 }

package/dist/controllers/frame_loading_controller.js

@@ -2,6 +2,145 @@ import { Controller } from '@hotwired/stimulus';
 
 // src/controllers/frame_loading_controller.ts
 
+// src/utils/announce.ts
+function announce(message, options = {}) {
+  const text = message.trim();
+  if (text.length === 0) return;
+  window.dispatchEvent(
+    new CustomEvent("stimeo--announcer:announce", {
+      detail: { message: text, assertive: options.assertive === true }
+    })
+  );
+}
+function fillTemplate(template, values) {
+  return template.replace(/\{([a-zA-Z][a-zA-Z0-9]*)\}/g, (match, name) => {
+    const replacement = values[name];
+    return replacement === void 0 ? match : String(replacement);
+  });
+}
+
+// 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/detach_gate.ts
+var DetachGate = class _DetachGate {
+  /** Set while a probe is queued, waiting for a reconnect to cancel it. */
+  #pending = false;
+  /**
+   * True when the disconnect is definitely a real detach — the element left
+   * the document, or `data-controller` no longer lists the identifier. False
+   * means ambiguous (in-page move or observed-root exit), NOT "alive".
+   */
+  static isDetached(host) {
+    if (!host.element.isConnected) return true;
+    const tokens = (host.element.getAttribute("data-controller") ?? "").split(/\s+/);
+    return !tokens.includes(host.identifier);
+  }
+  /**
+   * Call from `disconnect()`: runs `teardown` synchronously on a definite
+   * detach (fast path), otherwise defers it one microtask — a reconnect
+   * ({@link cancel} from `connect()`) keeps the state, no reconnect runs it.
+   * One microtask is the whole probe window: Stimulus reconnects a moved
+   * element within the same mutation batch, before the checkpoint drains.
+   */
+  disconnected(host, teardown) {
+    if (_DetachGate.isDetached(host)) {
+      this.#pending = false;
+      teardown();
+      return;
+    }
+    this.#pending = true;
+    queueMicrotask(() => {
+      if (!this.#pending) return;
+      this.#pending = false;
+      teardown();
+    });
+  }
+  /**
+   * Disarms a pending probe. Call from `connect()` (the reconnect that proves
+   * an in-page move) and from the head of any teardown path not routed through
+   * {@link disconnected} (disabled-toggle, Escape), so an orphaned probe can
+   * never run the teardown a second time.
+   */
+  cancel() {
+    this.#pending = false;
+  }
+};
+
+// src/utils/min_duration_floor.ts
+var MinDurationFloor = class {
+  #timers;
+  /** Pending finish timer id, or `null` when nothing is held back. */
+  #timerId = null;
+  /** Epoch ms the floor is measured from. */
+  #since = 0;
+  /** @param timers - the controller's registry; the floor schedules into it. */
+  constructor(timers) {
+    this.#timers = timers;
+  }
+  /** Starts the floor: call when the state being held becomes visible. */
+  begin() {
+    this.#since = Date.now();
+  }
+  /** True while a finish is held back waiting for the floor to elapse. */
+  get pending() {
+    return this.#timerId !== null;
+  }
+  /**
+   * Runs `finish` once the floor has elapsed, immediately when it already has.
+   *
+   * A held-back finish is **replaced**, never stacked: only the most recently
+   * queued id is cancellable, so a second timer would outlive every cancel and
+   * end a state that has since restarted. Controllers that want the first signal
+   * to win guard on {@link pending} before calling.
+   */
+  schedule(minDuration, finish) {
+    this.cancel();
+    const remaining = minDuration - (Date.now() - this.#since);
+    if (remaining > 0) {
+      this.#timerId = this.#timers.set(() => {
+        this.#timerId = null;
+        finish();
+      }, remaining);
+    } else {
+      finish();
+    }
+  }
+  /** Drops a held-back finish. Safe when none is queued, or after a bulk clear. */
+  cancel() {
+    if (this.#timerId !== null) {
+      this.#timers.clear(this.#timerId);
+      this.#timerId = null;
+    }
+  }
+};
+
 // src/utils/safe_timeout.ts
 var TimerRegistry = class {
   /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */
@@ -59,32 +198,32 @@ var SafeTimeout = class extends TimerRegistry {
 var FrameLoadingController = class extends Controller {
   static targets = ["content", "skeleton", "overlay"];
   static values = {
+    announceText: { type: String, default: "" },
+    announceReadyText: { type: String, default: "" },
     minDuration: { type: Number, default: 0 },
     restoreFocus: { type: Boolean, default: true }
   };
   static events = ["start", "end"];
   #timeouts = new SafeTimeout();
+  #floor = new MinDurationFloor(this.#timeouts);
+  #gate = new DetachGate();
+  #beforeCache = new BeforeCacheReset(() => this.#rewindForCache());
   #loading = false;
-  #startedAt = 0;
   #inertApplied = false;
   #previousFocus = null;
   /** The id of the retreated element, used to re-find it if the load replaced it. */
   #previousFocusId = "";
   #onStart = () => {
-    this.#timeouts.clearAll();
+    this.#floor.cancel();
     if (!this.#loading) this.#begin();
   };
   #onEnd = () => {
     if (!this.#loading) return;
-    const remaining = this.minDurationValue - (Date.now() - this.#startedAt);
-    if (remaining > 0) {
-      this.#timeouts.clearAll();
-      this.#timeouts.set(() => this.#finish(), remaining);
-    } else {
-      this.#finish();
-    }
+    this.#floor.schedule(this.minDurationValue, () => this.#finish());
   };
   connect() {
+    this.#gate.cancel();
+    this.#beforeCache.activate();
     this.element.addEventListener("turbo:before-fetch-request", this.#onStart);
     this.element.addEventListener("turbo:frame-load", this.#onEnd);
     this.element.addEventListener("turbo:fetch-request-error", this.#onEnd);
@@ -93,19 +232,40 @@ var FrameLoadingController = class extends Controller {
     this.element.removeEventListener("turbo:before-fetch-request", this.#onStart);
     this.element.removeEventListener("turbo:frame-load", this.#onEnd);
     this.element.removeEventListener("turbo:fetch-request-error", this.#onEnd);
+    this.#beforeCache.deactivate();
+    this.#gate.disconnected(this, () => this.#teardown());
+  }
+  /**
+   * Drops the held finish and the loading bookkeeping on a real detach. The markup
+   * keeps whatever it last held: the page being cached is rewound at
+   * `turbo:before-cache` instead, where the frame is still whole.
+   */
+  #teardown() {
+    this.#gate.cancel();
     this.#timeouts.clearAll();
-    if (this.#loading) {
-      this.element.removeAttribute("aria-busy");
-      this.element.removeAttribute("data-frame-loading");
-      this.#clearInert();
-    }
+    this.#floor.cancel();
     this.#loading = false;
     this.#previousFocus = null;
   }
+  /**
+   * Returns the frame to its resting hooks for the snapshot Turbo is about to
+   * take, so a page reached with the Back button does not restore a frame that is
+   * busy and inert with nothing left to finish it. State only — no `end` event and
+   * no focus move, because the load did not actually complete. The live page keeps
+   * its held finish, so a navigation that never completes still ends properly.
+   */
+  #rewindForCache() {
+    if (!this.#loading) return;
+    this.element.removeAttribute("aria-busy");
+    this.element.removeAttribute("data-frame-loading");
+    if (this.hasSkeletonTarget) this.skeletonTarget.hidden = true;
+    if (this.hasOverlayTarget) this.overlayTarget.hidden = true;
+    this.#clearInert();
+  }
   /** Enters the loading state: hooks, skeleton/overlay, inert content, focus retreat. */
   #begin() {
     this.#loading = true;
-    this.#startedAt = Date.now();
+    this.#floor.begin();
     this.element.setAttribute("aria-busy", "true");
     this.element.setAttribute("data-frame-loading", "true");
     if (this.hasSkeletonTarget) this.skeletonTarget.hidden = false;
@@ -113,6 +273,7 @@ var FrameLoadingController = class extends Controller {
     this.#applyInert();
     this.#retreatFocus();
     this.dispatch("start", { detail: {} });
+    announce(fillTemplate(this.announceTextValue, {}));
   }
   /** Leaves the loading state: restore hooks, hide skeleton/overlay, restore focus. */
   #finish() {
@@ -124,6 +285,7 @@ var FrameLoadingController = class extends Controller {
     this.#clearInert();
     this.#restoreFocus();
     this.dispatch("end", { detail: {} });
+    announce(fillTemplate(this.announceReadyTextValue, {}));
   }
   /** Marks the content inert to block double-submits while stale (if we own it). */
   #applyInert() {

package/dist/controllers/frame_loading_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/safe_timeout.ts","../../src/controllers/frame_loading_controller.ts"],"names":[],"mappings":"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","file":"frame_loading_controller.js","sourcesContent":["/**\n * Self-cleaning timer registries shared by Stimeo controllers.\n *\n * Stimulus controllers frequently schedule `setTimeout` / `setInterval` work\n * (auto-dismiss, debouncing, polling). When the element leaves the DOM — a\n * Turbo Drive navigation, a Turbo Stream replacement, or any `disconnect()` —\n * orphaned timers keep firing against a detached controller, leaking memory and\n * mutating stale state. {@link SafeTimeout} and {@link SafeInterval} track every\n * timer they create so a single {@link TimerRegistry.clearAll | clearAll()} call\n * in `disconnect()` tears them all down.\n *\n * These are intentionally low-level primitives: they own *registration and\n * cleanup only*. Higher-level policy (pause/resume, remaining-time accounting)\n * stays in the individual controllers so per-widget semantics are not flattened\n * into a lowest-common-denominator helper.\n */\n\n/**\n * Shared registry bookkeeping for the timeout/interval variants.\n *\n * Subclasses provide the scheduling primitive ({@link schedule}) and its matching\n * canceller ({@link cancel}); this base owns the set of live ids plus the\n * per-id and bulk teardown shared by both.\n */\nabstract class TimerRegistry {\n  /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */\n  protected readonly ids = new Set<number>();\n\n  /** Schedules the underlying platform timer and returns its id. */\n  protected abstract schedule(callback: () => void, delay: number): number;\n\n  /** Cancels the underlying platform timer for `id`. */\n  protected abstract cancel(id: number): void;\n\n  /**\n   * Cancels a single tracked timer.\n   *\n   * No-ops if the id is unknown (already cleared, fired, or never owned by this\n   * registry), so callers can clear defensively without guarding.\n   */\n  clear(id: number): void {\n    if (this.ids.delete(id)) {\n      this.cancel(id);\n    }\n  }\n\n  /**\n   * Cancels every tracked timer. Call this from a controller's `disconnect()`\n   * to guarantee no timer outlives the element.\n   */\n  clearAll(): void {\n    for (const id of this.ids) {\n      this.cancel(id);\n    }\n    this.ids.clear();\n  }\n\n  /** Number of timers currently tracked (pending). */\n  get size(): number {\n    return this.ids.size;\n  }\n}\n\n/**\n * `setTimeout` wrapper that auto-forgets each timer once it fires and supports\n * bulk teardown on disconnect.\n *\n * @example\n * ```ts\n * #timers = new SafeTimeout();\n *\n * connect() {\n *   this.#timers.set(() => this.dismiss(), 5000);\n * }\n *\n * disconnect() {\n *   this.#timers.clearAll();\n * }\n * ```\n */\nexport class SafeTimeout extends TimerRegistry {\n  /**\n   * Schedules `callback` after `delay` ms and returns the timer id.\n   *\n   * The id is removed from the registry automatically when the timeout fires,\n   * so {@link TimerRegistry.size | size} reflects only still-pending timers.\n   */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(() => {\n      this.ids.delete(id);\n      callback();\n    }, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setTimeout(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearTimeout(id);\n  }\n}\n\n/**\n * `setInterval` wrapper that tracks every interval for bulk teardown on\n * disconnect. Unlike {@link SafeTimeout}, intervals are retained until they are\n * explicitly cleared because they fire repeatedly.\n *\n * @example\n * ```ts\n * #intervals = new SafeInterval();\n *\n * connect() {\n *   this.#intervals.set(() => this.tick(), 1000);\n * }\n *\n * disconnect() {\n *   this.#intervals.clearAll();\n * }\n * ```\n */\nexport class SafeInterval extends TimerRegistry {\n  /** Schedules a repeating `callback` every `delay` ms and returns the timer id. */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(callback, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setInterval(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearInterval(id);\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { SafeTimeout } from \"../utils/safe_timeout\";\n\n/**\n * Headless `<turbo-frame>` loading-state behavior: while the frame is fetching it\n * sets `aria-busy` + `data-frame-loading`, reveals an optional skeleton / overlay,\n * suppresses interaction with the stale content, and retreats focus, restoring it on\n * completion (no dedicated APG pattern; supports WCAG 2.2 **4.1.3 Status Messages**\n * via `aria-busy` and 2.4.3 focus order via the retreat/restore).\n *\n * Markup contract (identifier: `stimeo--frame-loading`):\n *   <turbo-frame id=\"panel\" data-controller=\"stimeo--frame-loading\">\n *     <div data-stimeo--frame-loading-target=\"skeleton\" hidden>…</div>\n *     <div data-stimeo--frame-loading-target=\"content\">…</div>\n *   </turbo-frame>\n *\n * It subscribes on the frame to Turbo's own fetch lifecycle: `turbo:before-fetch-request`\n * (which bubbles from the frame's links/forms or the frame itself) starts the loading\n * state, and `turbo:frame-load` ends it (with `turbo:fetch-request-error` as a safety\n * net so the state never sticks). `minDuration` keeps the skeleton up long enough to\n * avoid a flicker.\n *\n * @remarks\n * Behavior only — it ships no skeleton markup or styling (pair with Skeleton/CSS);\n * loading is held purely in `aria-busy` / `data-frame-loading` and the optional\n * targets' `hidden`. The `content` target is marked `inert` while loading to block\n * double-submits, and focus inside the frame is explicitly blurred then restored\n * (when `restoreFocus`) so it is testable without relying on emergent `inert`\n * focus behavior. Listeners and the min-duration timer are torn down on\n * `disconnect()` (Turbo navigation included), which also tidies the hooks so a\n * cached frame is never left busy.\n */\nexport class FrameLoadingController extends Controller<HTMLElement> {\n  static override targets = [\"content\", \"skeleton\", \"overlay\"];\n  static override values = {\n    minDuration: { type: Number, default: 0 },\n    restoreFocus: { type: Boolean, default: true },\n  };\n  static events = [\"start\", \"end\"] as const;\n\n  declare readonly contentTarget: HTMLElement;\n  declare readonly skeletonTarget: HTMLElement;\n  declare readonly overlayTarget: HTMLElement;\n  declare readonly hasContentTarget: boolean;\n  declare readonly hasSkeletonTarget: boolean;\n  declare readonly hasOverlayTarget: boolean;\n\n  declare minDurationValue: number;\n  declare restoreFocusValue: boolean;\n\n  readonly #timeouts = new SafeTimeout();\n  #loading = false;\n  #startedAt = 0;\n  #inertApplied = false;\n  #previousFocus: HTMLElement | null = null;\n  /** The id of the retreated element, used to re-find it if the load replaced it. */\n  #previousFocusId = \"\";\n\n  readonly #onStart = (): void => {\n    // A (possibly new) fetch began: cancel any pending min-duration finish so the\n    // loading state is not torn down mid-load, then begin if not already loading.\n    this.#timeouts.clearAll();\n    if (!this.#loading) this.#begin();\n  };\n\n  readonly #onEnd = (): void => {\n    if (!this.#loading) return;\n    const remaining = this.minDurationValue - (Date.now() - this.#startedAt);\n    if (remaining > 0) {\n      this.#timeouts.clearAll();\n      this.#timeouts.set(() => this.#finish(), remaining);\n    } else {\n      this.#finish();\n    }\n  };\n\n  override connect(): void {\n    this.element.addEventListener(\"turbo:before-fetch-request\", this.#onStart);\n    this.element.addEventListener(\"turbo:frame-load\", this.#onEnd);\n    this.element.addEventListener(\"turbo:fetch-request-error\", this.#onEnd);\n  }\n\n  override disconnect(): void {\n    this.element.removeEventListener(\"turbo:before-fetch-request\", this.#onStart);\n    this.element.removeEventListener(\"turbo:frame-load\", this.#onEnd);\n    this.element.removeEventListener(\"turbo:fetch-request-error\", this.#onEnd);\n    this.#timeouts.clearAll();\n    // Tidy the hooks so a cached frame is not restored mid-loading (no focus move —\n    // the element is leaving the DOM).\n    if (this.#loading) {\n      this.element.removeAttribute(\"aria-busy\");\n      this.element.removeAttribute(\"data-frame-loading\");\n      this.#clearInert();\n    }\n    this.#loading = false;\n    this.#previousFocus = null;\n  }\n\n  /** Enters the loading state: hooks, skeleton/overlay, inert content, focus retreat. */\n  #begin(): void {\n    this.#loading = true;\n    this.#startedAt = Date.now();\n    this.element.setAttribute(\"aria-busy\", \"true\");\n    this.element.setAttribute(\"data-frame-loading\", \"true\");\n    if (this.hasSkeletonTarget) this.skeletonTarget.hidden = false;\n    if (this.hasOverlayTarget) this.overlayTarget.hidden = false;\n    this.#applyInert();\n    this.#retreatFocus();\n    this.dispatch(\"start\", { detail: {} });\n  }\n\n  /** Leaves the loading state: restore hooks, hide skeleton/overlay, restore focus. */\n  #finish(): void {\n    this.#loading = false;\n    this.element.removeAttribute(\"aria-busy\");\n    this.element.removeAttribute(\"data-frame-loading\");\n    if (this.hasSkeletonTarget) this.skeletonTarget.hidden = true;\n    if (this.hasOverlayTarget) this.overlayTarget.hidden = true;\n    this.#clearInert();\n    this.#restoreFocus();\n    this.dispatch(\"end\", { detail: {} });\n  }\n\n  /** Marks the content inert to block double-submits while stale (if we own it). */\n  #applyInert(): void {\n    if (!this.hasContentTarget || this.contentTarget.hasAttribute(\"inert\")) return;\n    this.contentTarget.setAttribute(\"inert\", \"\");\n    this.#inertApplied = true;\n  }\n\n  #clearInert(): void {\n    if (!this.#inertApplied) return;\n    this.#inertApplied = false;\n    if (this.hasContentTarget) this.contentTarget.removeAttribute(\"inert\");\n  }\n\n  /** Saves and blurs focus if it sits inside the frame about to go stale. */\n  #retreatFocus(): void {\n    this.#previousFocus = null;\n    this.#previousFocusId = \"\";\n    if (!this.restoreFocusValue) return;\n    const active = document.activeElement;\n    if (active instanceof HTMLElement && active !== this.element && this.element.contains(active)) {\n      this.#previousFocus = active;\n      this.#previousFocusId = active.id;\n      active.blur();\n    }\n  }\n\n  /**\n   * Restores focus after the load. The same node when it survived (e.g. a\n   * non-replacing update), else the element re-rendered with the same id inside the\n   * frame — Turbo frames typically re-emit the same controls. When neither is present\n   * (an anonymous control was replaced) focus is left where the browser put it, to\n   * avoid an unexpected jump (WCAG 3.2.x).\n   */\n  #restoreFocus(): void {\n    const target = this.#previousFocus;\n    const id = this.#previousFocusId;\n    this.#previousFocus = null;\n    this.#previousFocusId = \"\";\n    if (!this.restoreFocusValue) return;\n    if (target?.isConnected) {\n      target.focus();\n      return;\n    }\n    if (id) {\n      const replacement = document.getElementById(id);\n      if (replacement && this.element.contains(replacement)) replacement.focus();\n    }\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/announce.ts","../../src/utils/before_cache_reset.ts","../../src/utils/detach_gate.ts","../../src/utils/min_duration_floor.ts","../../src/utils/safe_timeout.ts","../../src/controllers/frame_loading_controller.ts"],"names":[],"mappings":"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","file":"frame_loading_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","/**\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 * Shared \"in-page move vs real detach\" discriminator for `disconnect()`.\n *\n * A mid-session `disconnect()` whose element is still in the document is\n * ambiguous. It can be:\n *\n * - an **in-page move** — a consumer (sortable, a teleport) re-inserted the\n *   element; Stimulus reconnects the SAME instance in the same mutation batch\n *   and the controller's runtime state must survive;\n * - a **detach that keeps the element** — `data-controller` no longer lists the\n *   identifier (a Turbo 8 morph), or the element moved outside the observed\n *   root (a scoped `Application.start(root)`, a shadow root); no reconnect will\n *   ever come and the controller must tear down or it leaks its sessions,\n *   document listeners, and moved nodes.\n *\n * Neither available signal decides this alone. A synchronous `data-controller`\n * token check catches the morph case but misses an observed-root exit (the\n * token stays, the reconnect never comes). Deferring teardown one microtask and\n * letting `connect()` cancel it catches the root exit, but leans on Stimulus\n * reconnecting moved elements within the same mutation batch — internal\n * behavior, not a public contract. {@link DetachGate} composes both: the token\n * check is the synchronous fast path (no probe, no reliance on batching), the\n * microtask probe is the fallback for the genuinely ambiguous remainder.\n *\n * Policy stays with the consumer (the `SafeTimeout` / `FocusTrap` lineage —\n * this util owns the discrimination only):\n *\n * - **Probe** ({@link disconnected}) when the teardown must eventually happen —\n *   live drag sessions, document listeners, teleported *content*. Call\n *   {@link cancel} from `connect()` (a reconnect means in-page move) and from\n *   the head of any direct teardown path (see below).\n * - **Keep** (bare {@link DetachGate.isDetached}) when undoing the ambiguous\n *   case would fight the controller's own effect: a controller that moves its\n *   OWN element (portal's no-`content` form) exits a scoped observed root as\n *   its normal job — a probe-driven teardown would restore the element into\n *   the root, reconnect, re-teleport, and disconnect again, forever. Such\n *   controllers keep their state on an ambiguous disconnect and tear down only\n *   on {@link DetachGate.isDetached}.\n *\n * Event convention for probe consumers: teardown into a dead (detached) tree is\n * silent — consumers restore from their own `connect()`; a detach that keeps the\n * tree alive must end an in-flight session with a `cancel` event, or composing\n * consumers strand their session bookkeeping.\n */\n\n/** The slice of a Stimulus controller the gate inspects. */\nexport interface DetachGateHost {\n  readonly element: Element;\n  readonly identifier: string;\n}\n\n/**\n * Per-controller-instance gate deciding whether a `disconnect()` is a real\n * detach. Hold one per controller (`#gate = new DetachGate()`) — Stimulus\n * reuses the instance across reconnects, so the pending probe state carries\n * over exactly as the protocol needs.\n *\n * @example\n * ```ts\n * #gate = new DetachGate();\n *\n * connect(): void {\n *   this.#gate.cancel(); // a reconnect: the element moved in-page\n *   // …\n * }\n *\n * disconnect(): void {\n *   this.#gate.disconnected(this, () => this.#teardown());\n * }\n *\n * #teardown(): void {\n *   this.#gate.cancel(); // disarm a still-queued probe (double-run guard)\n *   // …\n * }\n * ```\n */\nexport class DetachGate {\n  /** Set while a probe is queued, waiting for a reconnect to cancel it. */\n  #pending = false;\n\n  /**\n   * True when the disconnect is definitely a real detach — the element left\n   * the document, or `data-controller` no longer lists the identifier. False\n   * means ambiguous (in-page move or observed-root exit), NOT \"alive\".\n   */\n  static isDetached(host: DetachGateHost): boolean {\n    if (!host.element.isConnected) return true;\n    const tokens = (host.element.getAttribute(\"data-controller\") ?? \"\").split(/\\s+/);\n    return !tokens.includes(host.identifier);\n  }\n\n  /**\n   * Call from `disconnect()`: runs `teardown` synchronously on a definite\n   * detach (fast path), otherwise defers it one microtask — a reconnect\n   * ({@link cancel} from `connect()`) keeps the state, no reconnect runs it.\n   * One microtask is the whole probe window: Stimulus reconnects a moved\n   * element within the same mutation batch, before the checkpoint drains.\n   */\n  disconnected(host: DetachGateHost, teardown: () => void): void {\n    if (DetachGate.isDetached(host)) {\n      // Also disarms a probe a previous ambiguous disconnect left queued\n      // (defer, element removed, disconnect again) — exactly one teardown.\n      this.#pending = false;\n      teardown();\n      return;\n    }\n    this.#pending = true;\n    queueMicrotask(() => {\n      if (!this.#pending) return;\n      this.#pending = false;\n      teardown();\n    });\n  }\n\n  /**\n   * Disarms a pending probe. Call from `connect()` (the reconnect that proves\n   * an in-page move) and from the head of any teardown path not routed through\n   * {@link disconnected} (disabled-toggle, Escape), so an orphaned probe can\n   * never run the teardown a second time.\n   */\n  cancel(): void {\n    this.#pending = false;\n  }\n}\n","import type { SafeTimeout } from \"./safe_timeout\";\n\n/**\n * Holds a transient state visible for a minimum time before letting it end.\n *\n * A loading indicator that appears and disappears within a few frames reads as a\n * flicker rather than as feedback, so several controllers keep one up for a floor\n * of `minDuration` milliseconds measured from the moment it became visible. The\n * shape is always the same: note the moment, and when the end signal arrives\n * either run it now, because the floor has already passed, or hold it on a timer\n * for whatever is left.\n *\n * The floor **borrows** a {@link SafeTimeout} instead of owning one, so a\n * controller that also schedules other work (a show delay) keeps every timer in a\n * single registry and one `clearAll()` in its teardown still drops them all.\n * Cancelling after such a bulk clear is safe: the registry no-ops on an id it no\n * longer holds.\n *\n * Scope is the floor itself. **When an end signal is allowed to arrive at all\n * stays with the controller**, because the answers differ — one keeps the first\n * queued finish and ignores repeats, another lets the newest replace it — and\n * flattening that into a shared default would silently change what the consumers\n * already promise.\n *\n * @example\n * ```ts\n * readonly #timers = new SafeTimeout();\n * readonly #floor = new MinDurationFloor(this.#timers);\n *\n * #show()  { this.#floor.begin(); … }\n * stop()   { this.#floor.schedule(this.minDurationValue, () => this.#hide()); }\n * ```\n */\nexport class MinDurationFloor {\n  readonly #timers: SafeTimeout;\n\n  /** Pending finish timer id, or `null` when nothing is held back. */\n  #timerId: number | null = null;\n\n  /** Epoch ms the floor is measured from. */\n  #since = 0;\n\n  /** @param timers - the controller's registry; the floor schedules into it. */\n  constructor(timers: SafeTimeout) {\n    this.#timers = timers;\n  }\n\n  /** Starts the floor: call when the state being held becomes visible. */\n  begin(): void {\n    this.#since = Date.now();\n  }\n\n  /** True while a finish is held back waiting for the floor to elapse. */\n  get pending(): boolean {\n    return this.#timerId !== null;\n  }\n\n  /**\n   * Runs `finish` once the floor has elapsed, immediately when it already has.\n   *\n   * A held-back finish is **replaced**, never stacked: only the most recently\n   * queued id is cancellable, so a second timer would outlive every cancel and\n   * end a state that has since restarted. Controllers that want the first signal\n   * to win guard on {@link pending} before calling.\n   */\n  schedule(minDuration: number, finish: () => void): void {\n    this.cancel();\n    const remaining = minDuration - (Date.now() - this.#since);\n    if (remaining > 0) {\n      this.#timerId = this.#timers.set(() => {\n        this.#timerId = null;\n        finish();\n      }, remaining);\n    } else {\n      finish();\n    }\n  }\n\n  /** Drops a held-back finish. Safe when none is queued, or after a bulk clear. */\n  cancel(): void {\n    if (this.#timerId !== null) {\n      this.#timers.clear(this.#timerId);\n      this.#timerId = null;\n    }\n  }\n}\n","/**\n * Self-cleaning timer registries shared by Stimeo controllers.\n *\n * Stimulus controllers frequently schedule `setTimeout` / `setInterval` work\n * (auto-dismiss, debouncing, polling). When the element leaves the DOM — a\n * Turbo Drive navigation, a Turbo Stream replacement, or any `disconnect()` —\n * orphaned timers keep firing against a detached controller, leaking memory and\n * mutating stale state. {@link SafeTimeout} and {@link SafeInterval} track every\n * timer they create so a single {@link TimerRegistry.clearAll | clearAll()} call\n * in `disconnect()` tears them all down.\n *\n * These are intentionally low-level primitives: they own *registration and\n * cleanup only*. Higher-level policy (pause/resume, remaining-time accounting)\n * stays in the individual controllers so per-widget semantics are not flattened\n * into a lowest-common-denominator helper.\n */\n\n/**\n * Shared registry bookkeeping for the timeout/interval variants.\n *\n * Subclasses provide the scheduling primitive ({@link schedule}) and its matching\n * canceller ({@link cancel}); this base owns the set of live ids plus the\n * per-id and bulk teardown shared by both.\n */\nabstract class TimerRegistry {\n  /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */\n  protected readonly ids = new Set<number>();\n\n  /** Schedules the underlying platform timer and returns its id. */\n  protected abstract schedule(callback: () => void, delay: number): number;\n\n  /** Cancels the underlying platform timer for `id`. */\n  protected abstract cancel(id: number): void;\n\n  /**\n   * Cancels a single tracked timer.\n   *\n   * No-ops if the id is unknown (already cleared, fired, or never owned by this\n   * registry), so callers can clear defensively without guarding.\n   */\n  clear(id: number): void {\n    if (this.ids.delete(id)) {\n      this.cancel(id);\n    }\n  }\n\n  /**\n   * Cancels every tracked timer. Call this from a controller's `disconnect()`\n   * to guarantee no timer outlives the element.\n   */\n  clearAll(): void {\n    for (const id of this.ids) {\n      this.cancel(id);\n    }\n    this.ids.clear();\n  }\n\n  /** Number of timers currently tracked (pending). */\n  get size(): number {\n    return this.ids.size;\n  }\n}\n\n/**\n * `setTimeout` wrapper that auto-forgets each timer once it fires and supports\n * bulk teardown on disconnect.\n *\n * @example\n * ```ts\n * #timers = new SafeTimeout();\n *\n * connect() {\n *   this.#timers.set(() => this.dismiss(), 5000);\n * }\n *\n * disconnect() {\n *   this.#timers.clearAll();\n * }\n * ```\n */\nexport class SafeTimeout extends TimerRegistry {\n  /**\n   * Schedules `callback` after `delay` ms and returns the timer id.\n   *\n   * The id is removed from the registry automatically when the timeout fires,\n   * so {@link TimerRegistry.size | size} reflects only still-pending timers.\n   */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(() => {\n      this.ids.delete(id);\n      callback();\n    }, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setTimeout(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearTimeout(id);\n  }\n}\n\n/**\n * `setInterval` wrapper that tracks every interval for bulk teardown on\n * disconnect. Unlike {@link SafeTimeout}, intervals are retained until they are\n * explicitly cleared because they fire repeatedly.\n *\n * @example\n * ```ts\n * #intervals = new SafeInterval();\n *\n * connect() {\n *   this.#intervals.set(() => this.tick(), 1000);\n * }\n *\n * disconnect() {\n *   this.#intervals.clearAll();\n * }\n * ```\n */\nexport class SafeInterval extends TimerRegistry {\n  /** Schedules a repeating `callback` every `delay` ms and returns the timer id. */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(callback, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setInterval(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearInterval(id);\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { announce, fillTemplate } from \"../utils/announce\";\nimport { BeforeCacheReset } from \"../utils/before_cache_reset\";\nimport { DetachGate } from \"../utils/detach_gate\";\nimport { MinDurationFloor } from \"../utils/min_duration_floor\";\nimport { SafeTimeout } from \"../utils/safe_timeout\";\n\n/**\n * Headless `<turbo-frame>` loading-state behavior: while the frame is fetching it\n * sets `aria-busy` + `data-frame-loading`, reveals an optional skeleton / overlay,\n * suppresses interaction with the stale content, and retreats focus, restoring it on\n * completion (no dedicated APG pattern; supports WCAG 2.2 **4.1.3 Status Messages**\n * via `aria-busy` and 2.4.3 focus order via the retreat/restore).\n *\n * Markup contract (identifier: `stimeo--frame-loading`):\n *   <turbo-frame id=\"panel\" data-controller=\"stimeo--frame-loading\">\n *     <div data-stimeo--frame-loading-target=\"skeleton\" hidden>…</div>\n *     <div data-stimeo--frame-loading-target=\"content\">…</div>\n *   </turbo-frame>\n *\n * It subscribes on the frame to Turbo's own fetch lifecycle: `turbo:before-fetch-request`\n * (which bubbles from the frame's links/forms or the frame itself) starts the loading\n * state, and `turbo:frame-load` ends it (with `turbo:fetch-request-error` as a safety\n * net so the state never sticks). `minDuration` keeps the skeleton up long enough to\n * avoid a flicker.\n *\n * @remarks\n * Behavior only — it ships no skeleton markup or styling (pair with Skeleton/CSS);\n * loading is held purely in `aria-busy` / `data-frame-loading` and the optional\n * targets' `hidden`. The `content` target is marked `inert` while loading to block\n * double-submits, and focus inside the frame is explicitly blurred then restored\n * (when `restoreFocus`) so it is testable without relying on emergent `inert`\n * focus behavior. Listeners are torn down on `disconnect()` (Turbo navigation\n * included) along with the {@link MinDurationFloor} holding the finish back, kept\n * across an in-page move by {@link DetachGate}; the hooks a cached page would\n * freeze are rewound by {@link BeforeCacheReset}.\n */\nexport class FrameLoadingController extends Controller<HTMLElement> {\n  static override targets = [\"content\", \"skeleton\", \"overlay\"];\n  static override values = {\n    announceText: { type: String, default: \"\" },\n    announceReadyText: { type: String, default: \"\" },\n    minDuration: { type: Number, default: 0 },\n    restoreFocus: { type: Boolean, default: true },\n  };\n  static events = [\"start\", \"end\"] as const;\n\n  declare readonly contentTarget: HTMLElement;\n  declare readonly skeletonTarget: HTMLElement;\n  declare readonly overlayTarget: HTMLElement;\n  declare readonly hasContentTarget: boolean;\n  declare readonly hasSkeletonTarget: boolean;\n  declare readonly hasOverlayTarget: boolean;\n\n  declare minDurationValue: number;\n  declare restoreFocusValue: boolean;\n  declare announceTextValue: string;\n  declare announceReadyTextValue: string;\n\n  readonly #timeouts = new SafeTimeout();\n  readonly #floor = new MinDurationFloor(this.#timeouts);\n  readonly #gate = new DetachGate();\n  readonly #beforeCache = new BeforeCacheReset(() => this.#rewindForCache());\n  #loading = false;\n  #inertApplied = false;\n  #previousFocus: HTMLElement | null = null;\n  /** The id of the retreated element, used to re-find it if the load replaced it. */\n  #previousFocusId = \"\";\n\n  readonly #onStart = (): void => {\n    // A (possibly new) fetch began: drop a finish the floor is still holding so the\n    // loading state is not torn down mid-load, then begin if not already loading.\n    this.#floor.cancel();\n    if (!this.#loading) this.#begin();\n  };\n\n  readonly #onEnd = (): void => {\n    if (!this.#loading) return;\n    // The newest end signal owns the finish: the floor replaces whatever it was\n    // holding rather than letting a second wait stack behind the first.\n    this.#floor.schedule(this.minDurationValue, () => this.#finish());\n  };\n\n  override connect(): void {\n    this.#gate.cancel();\n    this.#beforeCache.activate();\n    this.element.addEventListener(\"turbo:before-fetch-request\", this.#onStart);\n    this.element.addEventListener(\"turbo:frame-load\", this.#onEnd);\n    this.element.addEventListener(\"turbo:fetch-request-error\", this.#onEnd);\n  }\n\n  override disconnect(): void {\n    this.element.removeEventListener(\"turbo:before-fetch-request\", this.#onStart);\n    this.element.removeEventListener(\"turbo:frame-load\", this.#onEnd);\n    this.element.removeEventListener(\"turbo:fetch-request-error\", this.#onEnd);\n    this.#beforeCache.deactivate();\n    this.#gate.disconnected(this, () => this.#teardown());\n  }\n\n  /**\n   * Drops the held finish and the loading bookkeeping on a real detach. The markup\n   * keeps whatever it last held: the page being cached is rewound at\n   * `turbo:before-cache` instead, where the frame is still whole.\n   */\n  #teardown(): void {\n    this.#gate.cancel();\n    this.#timeouts.clearAll();\n    this.#floor.cancel();\n    this.#loading = false;\n    this.#previousFocus = null;\n  }\n\n  /**\n   * Returns the frame to its resting hooks for the snapshot Turbo is about to\n   * take, so a page reached with the Back button does not restore a frame that is\n   * busy and inert with nothing left to finish it. State only — no `end` event and\n   * no focus move, because the load did not actually complete. The live page keeps\n   * its held finish, so a navigation that never completes still ends properly.\n   */\n  #rewindForCache(): void {\n    if (!this.#loading) return;\n    this.element.removeAttribute(\"aria-busy\");\n    this.element.removeAttribute(\"data-frame-loading\");\n    if (this.hasSkeletonTarget) this.skeletonTarget.hidden = true;\n    if (this.hasOverlayTarget) this.overlayTarget.hidden = true;\n    this.#clearInert();\n  }\n\n  /** Enters the loading state: hooks, skeleton/overlay, inert content, focus retreat. */\n  #begin(): void {\n    this.#loading = true;\n    this.#floor.begin();\n    this.element.setAttribute(\"aria-busy\", \"true\");\n    this.element.setAttribute(\"data-frame-loading\", \"true\");\n    if (this.hasSkeletonTarget) this.skeletonTarget.hidden = false;\n    if (this.hasOverlayTarget) this.overlayTarget.hidden = false;\n    this.#applyInert();\n    this.#retreatFocus();\n    this.dispatch(\"start\", { detail: {} });\n    announce(fillTemplate(this.announceTextValue, {}));\n  }\n\n  /** Leaves the loading state: restore hooks, hide skeleton/overlay, restore focus. */\n  #finish(): void {\n    this.#loading = false;\n    this.element.removeAttribute(\"aria-busy\");\n    this.element.removeAttribute(\"data-frame-loading\");\n    if (this.hasSkeletonTarget) this.skeletonTarget.hidden = true;\n    if (this.hasOverlayTarget) this.overlayTarget.hidden = true;\n    this.#clearInert();\n    this.#restoreFocus();\n    this.dispatch(\"end\", { detail: {} });\n    announce(fillTemplate(this.announceReadyTextValue, {}));\n  }\n\n  /** Marks the content inert to block double-submits while stale (if we own it). */\n  #applyInert(): void {\n    if (!this.hasContentTarget || this.contentTarget.hasAttribute(\"inert\")) return;\n    this.contentTarget.setAttribute(\"inert\", \"\");\n    this.#inertApplied = true;\n  }\n\n  #clearInert(): void {\n    if (!this.#inertApplied) return;\n    this.#inertApplied = false;\n    if (this.hasContentTarget) this.contentTarget.removeAttribute(\"inert\");\n  }\n\n  /** Saves and blurs focus if it sits inside the frame about to go stale. */\n  #retreatFocus(): void {\n    this.#previousFocus = null;\n    this.#previousFocusId = \"\";\n    if (!this.restoreFocusValue) return;\n    const active = document.activeElement;\n    if (active instanceof HTMLElement && active !== this.element && this.element.contains(active)) {\n      this.#previousFocus = active;\n      this.#previousFocusId = active.id;\n      active.blur();\n    }\n  }\n\n  /**\n   * Restores focus after the load. The same node when it survived (e.g. a\n   * non-replacing update), else the element re-rendered with the same id inside the\n   * frame — Turbo frames typically re-emit the same controls. When neither is present\n   * (an anonymous control was replaced) focus is left where the browser put it, to\n   * avoid an unexpected jump (WCAG 3.2.x).\n   */\n  #restoreFocus(): void {\n    const target = this.#previousFocus;\n    const id = this.#previousFocusId;\n    this.#previousFocus = null;\n    this.#previousFocusId = \"\";\n    if (!this.restoreFocusValue) return;\n    if (target?.isConnected) {\n      target.focus();\n      return;\n    }\n    if (id) {\n      const replacement = document.getElementById(id);\n      if (replacement && this.element.contains(replacement)) replacement.focus();\n    }\n  }\n}\n"]}