stimeo-ui 0.5.0 → 0.7.0

package/dist/controllers/dirty_form_controller.d.ts

@@ -12,11 +12,17 @@ import { Controller } from '@hotwired/stimulus';
  * Snapshots the form's field values on connect, marks the form `data-dirty` once a
  * value changes, and — while dirty — guards both a full unload (`beforeunload`) and
  * a Turbo visit (`turbo:before-visit`). On a Turbo visit it dispatches a cancelable
- * `guard` event; if a consumer cancels it (or `confirmBridge` is set) the visit is
- * blocked, otherwise it falls back to a native `confirm(message)`. While a submit is
- * in flight the guard is suppressed (so a legitimate submit never prompts); the dirty
- * state is cleared only on a successful `turbo:submit-end`, and a failed submit
- * re-arms the guard. `markClean` clears it manually (e.g. after a custom save).
+ * `guard` event for each eligible form; if a consumer cancels one (or any form uses
+ * `confirmBridge`) the visit is blocked, otherwise the document falls back to one
+ * native `confirm(message)`, using the first eligible form in live DOM order. While a
+ * submit is in flight the guard is suppressed until another edit occurs (so a
+ * legitimate submit never prompts); the browser's `formdata` event captures the exact
+ * revision Turbo materializes, and a successful `turbo:submit-end` accepts only that
+ * revision, preserving any later edits as dirty. A failed submit re-arms the guard;
+ * `markClean` clears it manually (e.g. after a custom save), while `acceptRestore`
+ * adopts a restored draft only while no user edit is already dirty.
+ *
+ * `dirty` dispatches `{ dirty }`; `guard` dispatches `{ event }`.
  *
  * @remarks
  * Behavior only — it renders no confirmation UI (pair with a Confirm Bridge) and
@@ -39,7 +45,7 @@ declare class DirtyFormController extends Controller<HTMLFormElement> {
             default: boolean;
         };
     };
-    static actions: readonly ["markClean"];
+    static actions: readonly ["markClean", "acceptRestore"];
     static events: readonly ["dirty", "guard"];
     messageValue: string;
     confirmBridgeValue: boolean;
@@ -47,6 +53,8 @@ declare class DirtyFormController extends Controller<HTMLFormElement> {
     disconnect(): void;
     /** Re-baselines to the current values and clears the dirty state (e.g. after a save). */
     markClean(): void;
+    /** Adopts restored values without erasing an already-dirty user revision. */
+    acceptRestore(): void;
 }
 
 export { DirtyFormController };

package/dist/controllers/dirty_form_controller.js

@@ -1,60 +1,220 @@
 import { Controller } from '@hotwired/stimulus';
 
 // src/controllers/dirty_form_controller.ts
+
+// src/utils/safe_timeout.ts
+var TimerRegistry = class {
+  /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */
+  ids = /* @__PURE__ */ new Set();
+  /**
+   * Cancels a single tracked timer.
+   *
+   * No-ops if the id is unknown (already cleared, fired, or never owned by this
+   * registry), so callers can clear defensively without guarding.
+   */
+  clear(id) {
+    if (this.ids.delete(id)) {
+      this.cancel(id);
+    }
+  }
+  /**
+   * Cancels every tracked timer. Call this from a controller's `disconnect()`
+   * to guarantee no timer outlives the element.
+   */
+  clearAll() {
+    for (const id of this.ids) {
+      this.cancel(id);
+    }
+    this.ids.clear();
+  }
+  /** Number of timers currently tracked (pending). */
+  get size() {
+    return this.ids.size;
+  }
+};
+var SafeTimeout = class extends TimerRegistry {
+  /**
+   * Schedules `callback` after `delay` ms and returns the timer id.
+   *
+   * The id is removed from the registry automatically when the timeout fires,
+   * so {@link TimerRegistry.size | size} reflects only still-pending timers.
+   */
+  set(callback, delay) {
+    const id = this.schedule(() => {
+      this.ids.delete(id);
+      callback();
+    }, delay);
+    this.ids.add(id);
+    return id;
+  }
+  schedule(callback, delay) {
+    return window.setTimeout(callback, delay);
+  }
+  cancel(id) {
+    window.clearTimeout(id);
+  }
+};
+
+// src/controllers/dirty_form_controller.ts
+var visitCoordinators = /* @__PURE__ */ new WeakMap();
+var TurboVisitCoordinator = class {
+  #document;
+  #participants = /* @__PURE__ */ new Set();
+  #onBeforeVisit = (event) => {
+    let blocked = event.defaultPrevented;
+    let message;
+    for (const participant of this.#participantsInDomOrder()) {
+      if (!participant.form.isConnected) continue;
+      const decision = participant.evaluate(event);
+      blocked ||= event.defaultPrevented;
+      if (decision === null) continue;
+      if (decision.kind === "block") {
+        blocked = true;
+      } else {
+        message ??= decision.message;
+      }
+    }
+    if (blocked) {
+      event.preventDefault();
+      return;
+    }
+    if (message === void 0) return;
+    if (!this.#document.defaultView?.confirm(message)) event.preventDefault();
+  };
+  constructor(document) {
+    this.#document = document;
+  }
+  add(participant) {
+    if (this.#participants.size === 0) {
+      this.#document.addEventListener("turbo:before-visit", this.#onBeforeVisit);
+    }
+    this.#participants.add(participant);
+  }
+  /** Removes a participant and reports whether the coordinator became empty. */
+  remove(participant) {
+    this.#participants.delete(participant);
+    if (this.#participants.size > 0) return false;
+    this.#document.removeEventListener("turbo:before-visit", this.#onBeforeVisit);
+    return true;
+  }
+  #participantsInDomOrder() {
+    return Array.from(this.#participants).filter(
+      (participant) => participant.form.isConnected && participant.form.ownerDocument === this.#document
+    ).sort((left, right) => {
+      const position = left.form.compareDocumentPosition(right.form);
+      return Number(Boolean(position & Node.DOCUMENT_POSITION_PRECEDING)) - Number(Boolean(position & Node.DOCUMENT_POSITION_FOLLOWING));
+    });
+  }
+};
+function registerVisitParticipant(document, participant) {
+  const coordinator = visitCoordinators.get(document) ?? new TurboVisitCoordinator(document);
+  visitCoordinators.set(document, coordinator);
+  coordinator.add(participant);
+  return () => {
+    if (coordinator.remove(participant)) visitCoordinators.delete(document);
+  };
+}
 var DirtyFormController = class extends Controller {
   static values = {
     message: { type: String, default: "You have unsaved changes that will be lost." },
     confirmBridge: { type: Boolean, default: false }
   };
-  static actions = ["markClean"];
+  static actions = ["markClean", "acceptRestore"];
   static events = ["dirty", "guard"];
   #baseline = "";
   #dirty = false;
   #beforeunloadBound = false;
-  /** True between a form `submit` and its `turbo:submit-end`, suppressing the guard. */
+  #timeouts = new SafeTimeout();
+  /** Whether the active submission still represents the form's current values. */
   #submitting = false;
+  #submitAttempt = null;
+  #submittedBaseline = null;
+  #activeSubmission = null;
+  #unregisterVisit = null;
   #onFieldChange = () => {
     this.#submitting = false;
     this.#evaluate();
   };
-  #onSubmit = () => {
+  #onSubmit = (event) => {
+    const attempt = { event, snapshot: this.#serialize() };
+    this.#submitAttempt = attempt;
     this.#submitting = true;
+    this.#timeouts.set(() => {
+      if (this.#submitAttempt !== attempt) return;
+      this.#submitting = false;
+    }, 0);
   };
-  #onBeforeVisit = (event) => {
-    this.#guardVisit(event);
+  #onFormData = () => {
+    if (this.#submitAttempt === null) return;
+    this.#submitAttempt.snapshot = this.#serialize();
+  };
+  #onSubmitStart = (event) => {
+    const detail = event.detail;
+    this.#activeSubmission = detail?.formSubmission ?? event;
+    this.#submittedBaseline = this.#submitAttempt?.snapshot ?? this.#serialize();
+    this.#submitAttempt = null;
+    this.#submitting = this.#serialize() === this.#submittedBaseline;
   };
   #onSubmitEnd = (event) => {
+    const detail = event.detail;
+    if (detail?.formSubmission !== void 0 && (this.#activeSubmission === null || detail.formSubmission !== this.#activeSubmission)) {
+      return;
+    }
+    const submittedBaseline = this.#submittedBaseline;
     this.#submitting = false;
-    const success = event.detail?.success;
-    if (success !== false) this.markClean();
+    this.#submittedBaseline = null;
+    this.#activeSubmission = null;
+    if (detail?.success === false) return;
+    if (submittedBaseline === null) {
+      this.markClean();
+      return;
+    }
+    this.#baseline = submittedBaseline;
+    this.#evaluate();
   };
   #onBeforeUnload = (event) => {
-    if (!this.#dirty || this.#submitting) return;
+    if (!this.#dirty || this.#guardSuppressed()) return;
     event.preventDefault();
     event.returnValue = this.messageValue;
   };
   connect() {
+    this.#resetSubmission();
     this.#baseline = this.#serialize();
+    this.#setDirty(false);
     this.element.removeAttribute("data-dirty");
     this.element.addEventListener("input", this.#onFieldChange);
     this.element.addEventListener("change", this.#onFieldChange);
     this.element.addEventListener("submit", this.#onSubmit);
+    this.element.addEventListener("formdata", this.#onFormData);
+    this.element.addEventListener("turbo:submit-start", this.#onSubmitStart);
     this.element.addEventListener("turbo:submit-end", this.#onSubmitEnd);
-    document.addEventListener("turbo:before-visit", this.#onBeforeVisit);
+    this.#unregisterVisit = registerVisitParticipant(this.element.ownerDocument, {
+      form: this.element,
+      evaluate: (event) => this.#evaluateVisit(event)
+    });
   }
   disconnect() {
     this.element.removeEventListener("input", this.#onFieldChange);
     this.element.removeEventListener("change", this.#onFieldChange);
     this.element.removeEventListener("submit", this.#onSubmit);
+    this.element.removeEventListener("formdata", this.#onFormData);
+    this.element.removeEventListener("turbo:submit-start", this.#onSubmitStart);
     this.element.removeEventListener("turbo:submit-end", this.#onSubmitEnd);
-    document.removeEventListener("turbo:before-visit", this.#onBeforeVisit);
+    this.#unregisterVisit?.();
+    this.#unregisterVisit = null;
     this.#unbindBeforeUnload();
+    this.#resetSubmission();
   }
   /** Re-baselines to the current values and clears the dirty state (e.g. after a save). */
   markClean() {
     this.#baseline = this.#serialize();
     this.#setDirty(false);
   }
+  /** Adopts restored values without erasing an already-dirty user revision. */
+  acceptRestore() {
+    if (this.#dirty) return;
+    this.markClean();
+  }
   /** Recomputes dirty against the baseline and flips state when it changes. */
   #evaluate() {
     this.#setDirty(this.#serialize() !== this.#baseline);
@@ -71,21 +231,14 @@ var DirtyFormController = class extends Controller {
     }
     this.dispatch("dirty", { detail: { dirty } });
   }
-  /** Guards a Turbo visit while dirty: consumer cancel → confirmBridge → confirm. */
-  #guardVisit(event) {
-    if (!this.#dirty || this.#submitting) return;
+  /** Evaluates this form for the document-level Turbo visit coordinator. */
+  #evaluateVisit(event) {
+    if (!this.#dirty || this.#guardSuppressed()) return null;
     const guard = this.dispatch("guard", { detail: { event }, cancelable: true });
-    if (guard.defaultPrevented) {
-      event.preventDefault();
-      return;
-    }
-    if (this.confirmBridgeValue) {
-      event.preventDefault();
-      return;
-    }
-    if (!window.confirm(this.messageValue)) {
-      event.preventDefault();
-    }
+    if (guard.defaultPrevented) return { kind: "block" };
+    if (!this.element.isConnected || !this.#dirty || this.#guardSuppressed()) return null;
+    if (this.confirmBridgeValue) return { kind: "block" };
+    return { kind: "confirm", message: this.messageValue };
   }
   #bindBeforeUnload() {
     if (this.#beforeunloadBound) return;
@@ -97,6 +250,16 @@ var DirtyFormController = class extends Controller {
     window.removeEventListener("beforeunload", this.#onBeforeUnload);
     this.#beforeunloadBound = false;
   }
+  #guardSuppressed() {
+    return this.#submitting && (this.#submitAttempt === null || !this.#submitAttempt.event.defaultPrevented);
+  }
+  #resetSubmission() {
+    this.#timeouts.clearAll();
+    this.#submitting = false;
+    this.#submitAttempt = null;
+    this.#submittedBaseline = null;
+    this.#activeSubmission = null;
+  }
   /** Stable serialization of the form's controls for change detection. */
   #serialize() {
     const parts = [];
@@ -104,15 +267,15 @@ var DirtyFormController = class extends Controller {
       const name = this.#nameOf(el);
       if (name === null) continue;
       if (el instanceof HTMLInputElement && (el.type === "checkbox" || el.type === "radio")) {
-        parts.push(`${name}:${el.checked ? 1 : 0}`);
+        parts.push([el.type, name, el.value, el.checked ? 1 : 0]);
       } else if (el instanceof HTMLSelectElement) {
-        const value = el.multiple ? Array.from(el.selectedOptions).map((o) => o.value).join(",") : el.value;
-        parts.push(`${name}:${value}`);
+        const value = el.multiple ? Array.from(el.selectedOptions).map((option) => option.value) : el.value;
+        parts.push([el.type, name, value]);
       } else if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {
-        parts.push(`${name}:${el.value}`);
+        parts.push([el.type, name, el.value]);
       }
     }
-    return parts.join("|");
+    return JSON.stringify(parts);
   }
   /** A stable key for a control, or null for elements without value semantics. */
   #nameOf(el) {

package/dist/controllers/dirty_form_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controllers/dirty_form_controller.ts"],"names":[],"mappings":"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","file":"dirty_form_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\n\n/**\n * Headless \"unsaved changes\" guard for a form (no dedicated APG pattern; supports\n * WCAG 2.2 error-prevention 3.3.4 / 3.3.6 by preventing accidental data loss).\n *\n * Markup contract (identifier: `stimeo--dirty-form`):\n *   <form data-controller=\"stimeo--dirty-form\">\n *     …fields…\n *   </form>\n *\n * Snapshots the form's field values on connect, marks the form `data-dirty` once a\n * value changes, and — while dirty — guards both a full unload (`beforeunload`) and\n * a Turbo visit (`turbo:before-visit`). On a Turbo visit it dispatches a cancelable\n * `guard` event; if a consumer cancels it (or `confirmBridge` is set) the visit is\n * blocked, otherwise it falls back to a native `confirm(message)`. While a submit is\n * in flight the guard is suppressed (so a legitimate submit never prompts); the dirty\n * state is cleared only on a successful `turbo:submit-end`, and a failed submit\n * re-arms the guard. `markClean` clears it manually (e.g. after a custom save).\n *\n * @remarks\n * Behavior only — it renders no confirmation UI (pair with a Confirm Bridge) and\n * does not persist input (pair with Persist). The dirty baseline is read from the\n * DOM on `connect()` (no module-scope state) — which also clears a stale\n * `data-dirty` left in a Turbo cache snapshot, since the restored values are the\n * new baseline — `beforeunload` is wired only while dirty, and every listener is\n * removed on `disconnect()` (Turbo navigation included) so a stale guard never\n * outlives the form.\n */\nexport class DirtyFormController extends Controller<HTMLFormElement> {\n  static override values = {\n    message: { type: String, default: \"You have unsaved changes that will be lost.\" },\n    confirmBridge: { type: Boolean, default: false },\n  };\n  static actions = [\"markClean\"] as const;\n  static events = [\"dirty\", \"guard\"] as const;\n\n  declare messageValue: string;\n  declare confirmBridgeValue: boolean;\n\n  #baseline = \"\";\n  #dirty = false;\n  #beforeunloadBound = false;\n  /** True between a form `submit` and its `turbo:submit-end`, suppressing the guard. */\n  #submitting = false;\n\n  readonly #onFieldChange = (): void => {\n    // Any edit means the user is actively working again, so a prior submit that\n    // never resolved (e.g. one cancelled client-side, with no turbo:submit-end)\n    // must not keep the guard suppressed.\n    this.#submitting = false;\n    this.#evaluate();\n  };\n\n  readonly #onSubmit = (): void => {\n    // A real submit is leaving on purpose: suppress the guard for the in-flight\n    // request. We do NOT clear the baseline yet — a failed submit must stay dirty.\n    this.#submitting = true;\n  };\n\n  readonly #onBeforeVisit = (event: Event): void => {\n    this.#guardVisit(event);\n  };\n\n  readonly #onSubmitEnd = (event: Event): void => {\n    this.#submitting = false;\n    const success = (event as CustomEvent<{ success?: boolean }>).detail?.success;\n    // Only a successful submit clears the dirty state; a failure re-arms the guard.\n    if (success !== false) this.markClean();\n  };\n\n  readonly #onBeforeUnload = (event: BeforeUnloadEvent): void => {\n    if (!this.#dirty || this.#submitting) return;\n    event.preventDefault();\n    // Legacy requirement: a non-empty returnValue triggers the native prompt.\n    event.returnValue = this.messageValue;\n  };\n\n  override connect(): void {\n    this.#baseline = this.#serialize();\n    // Re-baselining means the restored values ARE the clean state, so a stale\n    // data-dirty captured in a Turbo cache snapshot mid-edit must not linger\n    // (the guard would not fire, but consumer CSS would keep claiming \"unsaved\").\n    this.element.removeAttribute(\"data-dirty\");\n    this.element.addEventListener(\"input\", this.#onFieldChange);\n    this.element.addEventListener(\"change\", this.#onFieldChange);\n    this.element.addEventListener(\"submit\", this.#onSubmit);\n    this.element.addEventListener(\"turbo:submit-end\", this.#onSubmitEnd);\n    document.addEventListener(\"turbo:before-visit\", this.#onBeforeVisit);\n  }\n\n  override disconnect(): void {\n    this.element.removeEventListener(\"input\", this.#onFieldChange);\n    this.element.removeEventListener(\"change\", this.#onFieldChange);\n    this.element.removeEventListener(\"submit\", this.#onSubmit);\n    this.element.removeEventListener(\"turbo:submit-end\", this.#onSubmitEnd);\n    document.removeEventListener(\"turbo:before-visit\", this.#onBeforeVisit);\n    this.#unbindBeforeUnload();\n  }\n\n  /** Re-baselines to the current values and clears the dirty state (e.g. after a save). */\n  markClean(): void {\n    this.#baseline = this.#serialize();\n    this.#setDirty(false);\n  }\n\n  /** Recomputes dirty against the baseline and flips state when it changes. */\n  #evaluate(): void {\n    this.#setDirty(this.#serialize() !== this.#baseline);\n  }\n\n  #setDirty(dirty: boolean): void {\n    if (dirty === this.#dirty) return;\n    this.#dirty = dirty;\n    if (dirty) {\n      this.element.setAttribute(\"data-dirty\", \"true\");\n      this.#bindBeforeUnload();\n    } else {\n      this.element.removeAttribute(\"data-dirty\");\n      this.#unbindBeforeUnload();\n    }\n    this.dispatch(\"dirty\", { detail: { dirty } });\n  }\n\n  /** Guards a Turbo visit while dirty: consumer cancel → confirmBridge → confirm. */\n  #guardVisit(event: Event): void {\n    if (!this.#dirty || this.#submitting) return;\n    const guard = this.dispatch(\"guard\", { detail: { event }, cancelable: true });\n    if (guard.defaultPrevented) {\n      event.preventDefault();\n      return;\n    }\n    if (this.confirmBridgeValue) {\n      // Defer the actual prompt to a consumer-wired Confirm Bridge (via the guard\n      // event); block the visit here so nothing navigates before it decides.\n      event.preventDefault();\n      return;\n    }\n    if (!window.confirm(this.messageValue)) {\n      event.preventDefault();\n    }\n  }\n\n  #bindBeforeUnload(): void {\n    if (this.#beforeunloadBound) return;\n    window.addEventListener(\"beforeunload\", this.#onBeforeUnload);\n    this.#beforeunloadBound = true;\n  }\n\n  #unbindBeforeUnload(): void {\n    if (!this.#beforeunloadBound) return;\n    window.removeEventListener(\"beforeunload\", this.#onBeforeUnload);\n    this.#beforeunloadBound = false;\n  }\n\n  /** Stable serialization of the form's controls for change detection. */\n  #serialize(): string {\n    const parts: string[] = [];\n    for (const el of Array.from(this.element.elements)) {\n      const name = this.#nameOf(el);\n      if (name === null) continue;\n      if (el instanceof HTMLInputElement && (el.type === \"checkbox\" || el.type === \"radio\")) {\n        parts.push(`${name}:${el.checked ? 1 : 0}`);\n      } else if (el instanceof HTMLSelectElement) {\n        // Single select: read `value` (robust); multi-select: join the selected values.\n        const value = el.multiple\n          ? Array.from(el.selectedOptions)\n              .map((o) => o.value)\n              .join(\",\")\n          : el.value;\n        parts.push(`${name}:${value}`);\n      } else if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {\n        parts.push(`${name}:${el.value}`);\n      }\n    }\n    return parts.join(\"|\");\n  }\n\n  /** A stable key for a control, or null for elements without value semantics. */\n  #nameOf(el: Element): string | null {\n    if (\n      el instanceof HTMLInputElement ||\n      el instanceof HTMLTextAreaElement ||\n      el instanceof HTMLSelectElement\n    ) {\n      return el.name || el.id || \"\";\n    }\n    return null;\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/safe_timeout.ts","../../src/controllers/dirty_form_controller.ts"],"names":[],"mappings":"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","file":"dirty_form_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\ntype VisitDecision =\n  | { readonly kind: \"block\" }\n  | { readonly kind: \"confirm\"; readonly message: string }\n  | null;\n\ninterface VisitParticipant {\n  readonly form: HTMLFormElement;\n  readonly evaluate: (event: Event) => VisitDecision;\n}\n\ninterface SubmitAttempt {\n  readonly event: Event;\n  snapshot: string;\n}\n\ninterface TurboSubmitDetail {\n  readonly formSubmission?: unknown;\n  readonly success?: boolean;\n}\n\ntype SerializedControl = readonly [\n  type: string,\n  name: string,\n  value: string | readonly string[],\n  checked?: 0 | 1,\n];\n\n/**\n * Coordinates native Turbo confirmations for every dirty form in one document.\n *\n * The weak document registry owns no dirty baseline or durable form state. Each\n * controller remains the source of truth for its own state and unregisters on\n * disconnect; the shared coordinator only gives one navigation event a single,\n * deterministic decision point.\n */\nconst visitCoordinators = new WeakMap<Document, TurboVisitCoordinator>();\n\nclass TurboVisitCoordinator {\n  readonly #document: Document;\n  readonly #participants = new Set<VisitParticipant>();\n\n  readonly #onBeforeVisit = (event: Event): void => {\n    let blocked = event.defaultPrevented;\n    let message: string | undefined;\n\n    // Every eligible form gets its public guard event before a native prompt.\n    // A later consumer can therefore block the visit without an earlier form\n    // opening a redundant confirm first.\n    for (const participant of this.#participantsInDomOrder()) {\n      if (!participant.form.isConnected) continue;\n      const decision = participant.evaluate(event);\n      blocked ||= event.defaultPrevented;\n      if (decision === null) continue;\n      if (decision.kind === \"block\") {\n        blocked = true;\n      } else {\n        message ??= decision.message;\n      }\n    }\n\n    if (blocked) {\n      event.preventDefault();\n      return;\n    }\n    if (message === undefined) return;\n    if (!this.#document.defaultView?.confirm(message)) event.preventDefault();\n  };\n\n  constructor(document: Document) {\n    this.#document = document;\n  }\n\n  add(participant: VisitParticipant): void {\n    if (this.#participants.size === 0) {\n      this.#document.addEventListener(\"turbo:before-visit\", this.#onBeforeVisit);\n    }\n    this.#participants.add(participant);\n  }\n\n  /** Removes a participant and reports whether the coordinator became empty. */\n  remove(participant: VisitParticipant): boolean {\n    this.#participants.delete(participant);\n    if (this.#participants.size > 0) return false;\n    this.#document.removeEventListener(\"turbo:before-visit\", this.#onBeforeVisit);\n    return true;\n  }\n\n  #participantsInDomOrder(): VisitParticipant[] {\n    return Array.from(this.#participants)\n      .filter(\n        (participant) =>\n          participant.form.isConnected && participant.form.ownerDocument === this.#document,\n      )\n      .sort((left, right) => {\n        const position = left.form.compareDocumentPosition(right.form);\n        return (\n          Number(Boolean(position & Node.DOCUMENT_POSITION_PRECEDING)) -\n          Number(Boolean(position & Node.DOCUMENT_POSITION_FOLLOWING))\n        );\n      });\n  }\n}\n\nfunction registerVisitParticipant(document: Document, participant: VisitParticipant): () => void {\n  const coordinator = visitCoordinators.get(document) ?? new TurboVisitCoordinator(document);\n  visitCoordinators.set(document, coordinator);\n  coordinator.add(participant);\n\n  return () => {\n    if (coordinator.remove(participant)) visitCoordinators.delete(document);\n  };\n}\n\n/**\n * Headless \"unsaved changes\" guard for a form (no dedicated APG pattern; supports\n * WCAG 2.2 error-prevention 3.3.4 / 3.3.6 by preventing accidental data loss).\n *\n * Markup contract (identifier: `stimeo--dirty-form`):\n *   <form data-controller=\"stimeo--dirty-form\">\n *     …fields…\n *   </form>\n *\n * Snapshots the form's field values on connect, marks the form `data-dirty` once a\n * value changes, and — while dirty — guards both a full unload (`beforeunload`) and\n * a Turbo visit (`turbo:before-visit`). On a Turbo visit it dispatches a cancelable\n * `guard` event for each eligible form; if a consumer cancels one (or any form uses\n * `confirmBridge`) the visit is blocked, otherwise the document falls back to one\n * native `confirm(message)`, using the first eligible form in live DOM order. While a\n * submit is in flight the guard is suppressed until another edit occurs (so a\n * legitimate submit never prompts); the browser's `formdata` event captures the exact\n * revision Turbo materializes, and a successful `turbo:submit-end` accepts only that\n * revision, preserving any later edits as dirty. A failed submit re-arms the guard;\n * `markClean` clears it manually (e.g. after a custom save), while `acceptRestore`\n * adopts a restored draft only while no user edit is already dirty.\n *\n * `dirty` dispatches `{ dirty }`; `guard` dispatches `{ event }`.\n *\n * @remarks\n * Behavior only — it renders no confirmation UI (pair with a Confirm Bridge) and\n * does not persist input (pair with Persist). The dirty baseline is read from the\n * DOM on `connect()` (no module-scope state) — which also clears a stale\n * `data-dirty` left in a Turbo cache snapshot, since the restored values are the\n * new baseline — `beforeunload` is wired only while dirty, and every listener is\n * removed on `disconnect()` (Turbo navigation included) so a stale guard never\n * outlives the form.\n */\nexport class DirtyFormController extends Controller<HTMLFormElement> {\n  static override values = {\n    message: { type: String, default: \"You have unsaved changes that will be lost.\" },\n    confirmBridge: { type: Boolean, default: false },\n  };\n  static actions = [\"markClean\", \"acceptRestore\"] as const;\n  static events = [\"dirty\", \"guard\"] as const;\n\n  declare messageValue: string;\n  declare confirmBridgeValue: boolean;\n\n  #baseline = \"\";\n  #dirty = false;\n  #beforeunloadBound = false;\n  readonly #timeouts = new SafeTimeout();\n  /** Whether the active submission still represents the form's current values. */\n  #submitting = false;\n  #submitAttempt: SubmitAttempt | null = null;\n  #submittedBaseline: string | null = null;\n  #activeSubmission: unknown | null = null;\n  #unregisterVisit: (() => void) | null = null;\n\n  readonly #onFieldChange = (): void => {\n    // An edit after submission belongs to a new unsaved revision. Keep the\n    // submitted snapshot for submit-end, but stop suppressing navigation now.\n    this.#submitting = false;\n    this.#evaluate();\n  };\n\n  readonly #onSubmit = (event: Event): void => {\n    const attempt: SubmitAttempt = { event, snapshot: this.#serialize() };\n    this.#submitAttempt = attempt;\n    this.#submitting = true;\n    // Native navigation runs before the next task. If it does not navigate and\n    // Turbo never claims the attempt, the form must not remain suppressed.\n    this.#timeouts.set(() => {\n      if (this.#submitAttempt !== attempt) return;\n      this.#submitting = false;\n    }, 0);\n  };\n\n  readonly #onFormData = (): void => {\n    if (this.#submitAttempt === null) return;\n    // Turbo constructs FormData after target-level submit consumers have run.\n    // Capturing here reflects exactly that revision, even when an asynchronous\n    // confirmation delays turbo:submit-start and the user edits in the meantime.\n    this.#submitAttempt.snapshot = this.#serialize();\n  };\n\n  readonly #onSubmitStart = (event: Event): void => {\n    const detail = (event as CustomEvent<TurboSubmitDetail>).detail;\n    this.#activeSubmission = detail?.formSubmission ?? event;\n    this.#submittedBaseline = this.#submitAttempt?.snapshot ?? this.#serialize();\n    this.#submitAttempt = null;\n    this.#submitting = this.#serialize() === this.#submittedBaseline;\n  };\n\n  readonly #onSubmitEnd = (event: Event): void => {\n    const detail = (event as CustomEvent<TurboSubmitDetail>).detail;\n    if (\n      detail?.formSubmission !== undefined &&\n      (this.#activeSubmission === null || detail.formSubmission !== this.#activeSubmission)\n    ) {\n      return;\n    }\n    const submittedBaseline = this.#submittedBaseline;\n    this.#submitting = false;\n    this.#submittedBaseline = null;\n    this.#activeSubmission = null;\n    if (detail?.success === false) return;\n    if (submittedBaseline === null) {\n      this.markClean();\n      return;\n    }\n    // The server accepted the submitted revision, not edits made after it left.\n    this.#baseline = submittedBaseline;\n    this.#evaluate();\n  };\n\n  readonly #onBeforeUnload = (event: BeforeUnloadEvent): void => {\n    if (!this.#dirty || this.#guardSuppressed()) return;\n    event.preventDefault();\n    // Legacy requirement: a non-empty returnValue triggers the native prompt.\n    event.returnValue = this.messageValue;\n  };\n\n  override connect(): void {\n    this.#resetSubmission();\n    this.#baseline = this.#serialize();\n    this.#setDirty(false);\n    // Re-baselining means the restored values ARE the clean state, so a stale\n    // data-dirty captured in a Turbo cache snapshot mid-edit must not linger\n    // (the guard would not fire, but consumer CSS would keep claiming \"unsaved\").\n    this.element.removeAttribute(\"data-dirty\");\n    this.element.addEventListener(\"input\", this.#onFieldChange);\n    this.element.addEventListener(\"change\", this.#onFieldChange);\n    this.element.addEventListener(\"submit\", this.#onSubmit);\n    this.element.addEventListener(\"formdata\", this.#onFormData);\n    this.element.addEventListener(\"turbo:submit-start\", this.#onSubmitStart);\n    this.element.addEventListener(\"turbo:submit-end\", this.#onSubmitEnd);\n    this.#unregisterVisit = registerVisitParticipant(this.element.ownerDocument, {\n      form: this.element,\n      evaluate: (event) => this.#evaluateVisit(event),\n    });\n  }\n\n  override disconnect(): void {\n    this.element.removeEventListener(\"input\", this.#onFieldChange);\n    this.element.removeEventListener(\"change\", this.#onFieldChange);\n    this.element.removeEventListener(\"submit\", this.#onSubmit);\n    this.element.removeEventListener(\"formdata\", this.#onFormData);\n    this.element.removeEventListener(\"turbo:submit-start\", this.#onSubmitStart);\n    this.element.removeEventListener(\"turbo:submit-end\", this.#onSubmitEnd);\n    this.#unregisterVisit?.();\n    this.#unregisterVisit = null;\n    this.#unbindBeforeUnload();\n    this.#resetSubmission();\n  }\n\n  /** Re-baselines to the current values and clears the dirty state (e.g. after a save). */\n  markClean(): void {\n    this.#baseline = this.#serialize();\n    this.#setDirty(false);\n  }\n\n  /** Adopts restored values without erasing an already-dirty user revision. */\n  acceptRestore(): void {\n    if (this.#dirty) return;\n    this.markClean();\n  }\n\n  /** Recomputes dirty against the baseline and flips state when it changes. */\n  #evaluate(): void {\n    this.#setDirty(this.#serialize() !== this.#baseline);\n  }\n\n  #setDirty(dirty: boolean): void {\n    if (dirty === this.#dirty) return;\n    this.#dirty = dirty;\n    if (dirty) {\n      this.element.setAttribute(\"data-dirty\", \"true\");\n      this.#bindBeforeUnload();\n    } else {\n      this.element.removeAttribute(\"data-dirty\");\n      this.#unbindBeforeUnload();\n    }\n    this.dispatch(\"dirty\", { detail: { dirty } });\n  }\n\n  /** Evaluates this form for the document-level Turbo visit coordinator. */\n  #evaluateVisit(event: Event): VisitDecision {\n    if (!this.#dirty || this.#guardSuppressed()) return null;\n    const guard = this.dispatch(\"guard\", { detail: { event }, cancelable: true });\n    if (guard.defaultPrevented) return { kind: \"block\" };\n    // A guard consumer may have saved, submitted, or removed the form synchronously.\n    if (!this.element.isConnected || !this.#dirty || this.#guardSuppressed()) return null;\n    if (this.confirmBridgeValue) return { kind: \"block\" };\n    return { kind: \"confirm\", message: this.messageValue };\n  }\n\n  #bindBeforeUnload(): void {\n    if (this.#beforeunloadBound) return;\n    window.addEventListener(\"beforeunload\", this.#onBeforeUnload);\n    this.#beforeunloadBound = true;\n  }\n\n  #unbindBeforeUnload(): void {\n    if (!this.#beforeunloadBound) return;\n    window.removeEventListener(\"beforeunload\", this.#onBeforeUnload);\n    this.#beforeunloadBound = false;\n  }\n\n  #guardSuppressed(): boolean {\n    return (\n      this.#submitting &&\n      (this.#submitAttempt === null || !this.#submitAttempt.event.defaultPrevented)\n    );\n  }\n\n  #resetSubmission(): void {\n    this.#timeouts.clearAll();\n    this.#submitting = false;\n    this.#submitAttempt = null;\n    this.#submittedBaseline = null;\n    this.#activeSubmission = null;\n  }\n\n  /** Stable serialization of the form's controls for change detection. */\n  #serialize(): string {\n    const parts: SerializedControl[] = [];\n    for (const el of Array.from(this.element.elements)) {\n      const name = this.#nameOf(el);\n      if (name === null) continue;\n      if (el instanceof HTMLInputElement && (el.type === \"checkbox\" || el.type === \"radio\")) {\n        parts.push([el.type, name, el.value, el.checked ? 1 : 0]);\n      } else if (el instanceof HTMLSelectElement) {\n        // Keep multi-select values structural so option values containing commas cannot collide.\n        const value = el.multiple\n          ? Array.from(el.selectedOptions).map((option) => option.value)\n          : el.value;\n        parts.push([el.type, name, value]);\n      } else if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {\n        parts.push([el.type, name, el.value]);\n      }\n    }\n    return JSON.stringify(parts);\n  }\n\n  /** A stable key for a control, or null for elements without value semantics. */\n  #nameOf(el: Element): string | null {\n    if (\n      el instanceof HTMLInputElement ||\n      el instanceof HTMLTextAreaElement ||\n      el instanceof HTMLSelectElement\n    ) {\n      return el.name || el.id || \"\";\n    }\n    return null;\n  }\n}\n"]}

package/dist/controllers/dismissible_controller.d.ts

@@ -18,6 +18,8 @@ import { Controller } from '@hotwired/stimulus';
  * it is moved to a safe place first so the close button vanishing never strands
  * the user (WCAG 2.4.3).
  *
+ * `dismiss` dispatches `{ mode: "remove" | "hide" }`.
+ *
  * @remarks
  * Behavior only — the consumer owns any exit transition (use `hide` mode, which
  * adds `hidden`, and animate off `data-state`) and any semantics like

package/dist/controllers/dismissible_controller.js

@@ -2,8 +2,79 @@ import { Controller } from '@hotwired/stimulus';
 
 // src/controllers/dismissible_controller.ts
 
-// src/utils/focus_trap.ts
-var FOCUSABLE = 'a[href], button:not([disabled]), textarea:not([disabled]), input:not([disabled]), select:not([disabled]), [tabindex]:not([tabindex="-1"])';
+// src/utils/focus_candidate.ts
+function inheritsFieldsetDisabled(control) {
+  let fieldset = control.closest("fieldset[disabled]");
+  while (fieldset) {
+    const legend = Array.from(fieldset.children).find((child) => child.tagName === "LEGEND");
+    if (!legend?.contains(control)) return true;
+    fieldset = fieldset.parentElement?.closest("fieldset[disabled]") ?? null;
+  }
+  return false;
+}
+function canTakeFocus(element) {
+  if (element.closest("[hidden], [inert]")) return false;
+  if (element instanceof HTMLInputElement && element.type === "hidden") return false;
+  if (!("disabled" in element)) return true;
+  if (element.disabled) return false;
+  return !inheritsFieldsetDisabled(element);
+}
+var TAB_STOP_CANDIDATE_SELECTOR = [
+  "a[href]",
+  "area[href]",
+  "button",
+  "input",
+  "select",
+  "textarea",
+  "summary",
+  "iframe",
+  "audio[controls]",
+  "video[controls]",
+  "[tabindex]",
+  "[contenteditable]"
+].join(",");
+function isRenderedForFocus(element) {
+  const check = element.checkVisibility;
+  return typeof check === "function" ? check.call(element, { visibilityProperty: true }) : true;
+}
+function authoredTabindex(element) {
+  const value = element.getAttribute("tabindex");
+  if (value === null || !/^[+-]?\d+$/.test(value.trim())) return null;
+  return Number(value);
+}
+function hasNativeTabStop(element) {
+  if (element instanceof HTMLAnchorElement || element instanceof HTMLAreaElement) {
+    return element.hasAttribute("href");
+  }
+  if (element instanceof HTMLButtonElement || element instanceof HTMLSelectElement || element instanceof HTMLTextAreaElement) {
+    return true;
+  }
+  if (element instanceof HTMLInputElement) return element.type !== "hidden";
+  if (element instanceof HTMLIFrameElement) return true;
+  if (element.tagName === "AUDIO" || element.tagName === "VIDEO") {
+    return element.hasAttribute("controls");
+  }
+  if (element instanceof HTMLElement && element.tagName === "SUMMARY") {
+    const details = element.parentElement;
+    return details instanceof HTMLDetailsElement && Array.from(details.children).find((child) => child.tagName === "SUMMARY") === element;
+  }
+  return false;
+}
+function hasEditableTabStop(element) {
+  const value = element.getAttribute("contenteditable")?.toLowerCase();
+  return value === "" || value === "true" || value === "plaintext-only";
+}
+function isTabStop(element) {
+  if (!canTakeFocus(element) || !isRenderedForFocus(element)) return false;
+  const tabindex = authoredTabindex(element);
+  if (tabindex !== null) return tabindex >= 0;
+  return hasNativeTabStop(element) || hasEditableTabStop(element);
+}
+function tabStopsWithin(root) {
+  return Array.from(root.querySelectorAll(TAB_STOP_CANDIDATE_SELECTOR)).filter(
+    isTabStop
+  );
+}
 
 // src/controllers/dismissible_controller.ts
 var DismissibleController = class extends Controller {
@@ -80,35 +151,29 @@ var DismissibleController = class extends Controller {
   /** Yields available focus fallbacks in precedence order, stopping after focus succeeds. */
   *#focusFallbacks(root) {
     const explicitFallback = this.hasFallbackTarget ? this.fallbackTarget : null;
-    if (explicitFallback && !root.contains(explicitFallback) && this.#isFocusAvailable(explicitFallback)) {
+    if (explicitFallback && !root.contains(explicitFallback) && this.#isExplicitFocusAvailable(explicitFallback)) {
       yield explicitFallback;
     }
-    const candidates = document.querySelectorAll(FOCUSABLE);
+    const candidates = tabStopsWithin(document);
     for (const element of candidates) {
       if (element === explicitFallback || root.contains(element) || !(root.compareDocumentPosition(element) & Node.DOCUMENT_POSITION_FOLLOWING)) {
         continue;
       }
-      if (this.#isFocusAvailable(element)) yield element;
+      yield element;
     }
     for (let index = candidates.length - 1; index >= 0; index -= 1) {
-      const element = candidates.item(index);
+      const element = candidates[index];
+      if (!element) continue;
       if (element === explicitFallback || root.contains(element) || !(root.compareDocumentPosition(element) & Node.DOCUMENT_POSITION_PRECEDING)) {
         continue;
       }
-      if (this.#isFocusAvailable(element)) yield element;
+      yield element;
     }
   }
-  /** Whether focus is allowed by the element and its semantic ancestors. */
-  #isFocusAvailable(element) {
-    if (!element.matches(FOCUSABLE) && !element.hasAttribute("tabindex") && !element.isContentEditable) {
-      return false;
-    }
-    if (element.matches(":disabled")) return false;
-    if (element instanceof HTMLInputElement && element.type === "hidden") return false;
-    for (let current = element; current; current = current.parentElement) {
-      if (current.hidden || current.inert) return false;
-    }
-    return true;
+  /** Whether an explicit fallback can receive programmatic focus right now. */
+  #isExplicitFocusAvailable(element) {
+    const programmaticallyFocusable = element.hasAttribute("tabindex") || isTabStop(element);
+    return programmaticallyFocusable && canTakeFocus(element) && isRenderedForFocus(element);
   }
 };