stimeo-ui 0.5.0 → 0.7.0

package/dist/controllers/conditional_fields_controller.js

@@ -1,7 +1,134 @@
 import { Controller } from '@hotwired/stimulus';
 
+// src/controllers/conditional_fields_controller.ts
+
+// 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);
+}
+
+// src/utils/microtask_coalescer.ts
+var MicrotaskCoalescer = class {
+  #run;
+  #queued = false;
+  #active = false;
+  #generation = 0;
+  /** @param run - the single reconciliation pass, invoked at most once per batch. */
+  constructor(run) {
+    this.#run = run;
+  }
+  /** Opens the window in which {@link schedule} is honoured; call from `connect()`. */
+  activate() {
+    this.#active = true;
+  }
+  /** Closes the window and drops any pending pass; call from `disconnect()`. */
+  cancel() {
+    this.#active = false;
+    this.#queued = false;
+    this.#generation += 1;
+  }
+  /** Requests one pass after the batch settles. Idempotent; inert outside the window. */
+  schedule() {
+    if (!this.#active || this.#queued) return;
+    this.#queued = true;
+    const generation = this.#generation;
+    queueMicrotask(() => {
+      if (generation !== this.#generation || !this.#queued || !this.#active) return;
+      this.#queued = false;
+      this.#run();
+    });
+  }
+};
+
+// 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/tabindex_loan.ts
+var TabindexLoan = class {
+  #value;
+  #lent = /* @__PURE__ */ new Set();
+  /** Returns live loans before Turbo can copy them into its page snapshot. */
+  #beforeCache = new BeforeCacheReset(() => this.returnAll());
+  /**
+   * @param value - the `tabindex` to lend. `"-1"` (the default) is
+   *   programmatically focusable but not a Tab stop; `"0"` is a real Tab stop,
+   *   which a scroll region with no focusable content of its own needs.
+   */
+  constructor(value = "-1") {
+    this.#value = value;
+  }
+  /** Lends `element` the value; no-ops when it already carries a `tabindex`. */
+  lend(element) {
+    if (element.hasAttribute("tabindex")) return;
+    element.setAttribute("tabindex", this.#value);
+    this.#lent.add(element);
+    this.#beforeCache.activate();
+  }
+  /** Takes back every loan whose value is still the one that was lent. */
+  returnAll() {
+    for (const element of this.#lent) {
+      if (element.getAttribute("tabindex") === this.#value) element.removeAttribute("tabindex");
+    }
+    this.#lent.clear();
+    this.#beforeCache.deactivate();
+  }
+};
+
 // src/controllers/conditional_fields_controller.ts
 var DISABLED_MARKER = "data-conditional-disabled";
+var OBSERVED_ATTRIBUTES = [
+  "hidden",
+  "aria-hidden",
+  "data-visible",
+  DISABLED_MARKER,
+  "disabled",
+  "data-when-checked",
+  "data-when-unchecked",
+  "data-when-value",
+  "checked",
+  "selected",
+  "value",
+  "type"
+];
 var ConditionalFieldsController = class extends Controller {
   static targets = ["trigger", "region"];
   static values = {
@@ -9,56 +136,171 @@ var ConditionalFieldsController = class extends Controller {
     match: { type: String, default: "any" }
   };
   static actions = ["evaluate"];
-  static events = ["change"];
+  static events = ["change", "reconcile"];
+  /** Logical state last committed for each current region; rebuilt on every connect. */
   #lastVisible = /* @__PURE__ */ new WeakMap();
-  #onChange = () => {
-    this.evaluate();
+  /** Controller writes awaiting an observer callback, separated from authored morphs. */
+  #internalWrites = /* @__PURE__ */ new WeakMap();
+  #observing = false;
+  /** Coalesces one target/morph/mutation batch into one full DOM reconciliation. */
+  #reconcile = new MicrotaskCoalescer(() => this.#reconcileDom());
+  /** Provides the last-resort focus landmark without claiming an authored tabindex. */
+  #rootTabindex = new TabindexLoan();
+  /** Watches retained targets and controls whose declarative or reflected state changed. */
+  #observer = new MutationObserver((records) => this.#onMutations(records));
+  /** Evaluates only events whose source is one of this instance's live trigger targets. */
+  #onTriggerInput = (event) => {
+    const target = event.target;
+    const triggers = this.triggerTargets;
+    if (target instanceof Element && triggers.some((trigger) => trigger === target)) {
+      this.#commitChange(triggers);
+    }
+  };
+  /** Reconciles property-only retained-element changes after Turbo morphs. */
+  #onMorph = () => {
+    this.#reconcile.schedule();
+  };
+  /** Reconciles the settled defaults after a non-cancelled owning form reset. */
+  #onReset = (event) => {
+    const form = event.target;
+    if (form instanceof HTMLFormElement && this.#hasTriggerOwnedBy(form)) {
+      queueMicrotask(() => {
+        if (!event.defaultPrevented) this.#reconcile.schedule();
+      });
+    }
   };
+  /** Reflects initial live state and opens every retained-DOM reconciliation path. */
   connect() {
-    this.evaluate();
-    this.element.addEventListener("change", this.#onChange);
-    this.element.addEventListener("input", this.#onChange);
+    this.#lastVisible = /* @__PURE__ */ new WeakMap();
+    this.#internalWrites = /* @__PURE__ */ new WeakMap();
+    this.#reconcile.activate();
+    this.#settle();
+    this.#observer.observe(this.element, {
+      attributes: true,
+      attributeFilter: OBSERVED_ATTRIBUTES,
+      childList: true,
+      subtree: true
+    });
+    this.#observing = true;
+    this.element.addEventListener("change", this.#onTriggerInput);
+    this.element.addEventListener("input", this.#onTriggerInput);
+    this.element.addEventListener("turbo:morph-element", this.#onMorph);
+    document.addEventListener("reset", this.#onReset, true);
   }
+  /** Releases all external resources and returns the temporary focus landmark loan. */
   disconnect() {
-    this.element.removeEventListener("change", this.#onChange);
-    this.element.removeEventListener("input", this.#onChange);
+    this.#reconcile.cancel();
+    this.#observing = false;
+    this.#observer.disconnect();
+    this.element.removeEventListener("change", this.#onTriggerInput);
+    this.element.removeEventListener("input", this.#onTriggerInput);
+    this.element.removeEventListener("turbo:morph-element", this.#onMorph);
+    document.removeEventListener("reset", this.#onReset, true);
+    this.#rootTabindex.returnAll();
+  }
+  /** Reconciles after a trigger target is inserted or restored. */
+  triggerTargetConnected() {
+    this.#reconcile.schedule();
+  }
+  /** Reconciles after a trigger target is removed or replaced. */
+  triggerTargetDisconnected() {
+    this.#reconcile.schedule();
+  }
+  /** Initializes a region target inserted or restored at runtime. */
+  regionTargetConnected() {
+    this.#reconcile.schedule();
+  }
+  /** Reconciles the remaining region set after a target leaves. */
+  regionTargetDisconnected() {
+    this.#reconcile.schedule();
   }
-  /** Re-evaluates every region against the current trigger state. */
+  /** Reconciles when application code or a morph changes the match policy. */
+  matchValueChanged() {
+    this.#reconcile.schedule();
+  }
+  /** Reconciles control ownership when hidden controls become enabled or excluded. */
+  disableHiddenValueChanged() {
+    this.#reconcile.schedule();
+  }
+  /** Re-evaluates every region and repairs all reflected DOM state. */
   evaluate() {
-    const triggers = this.triggerTargets;
-    for (const region of this.regionTargets) {
-      this.#applyRegion(region, this.#isVisible(region, triggers));
+    this.#commitChange();
+  }
+  /**
+   * Computes one settled plan, shows destinations before hiding sources, and then
+   * returns logical transitions in DOM order after every region is internally coherent.
+   */
+  #settle(triggers = this.triggerTargets) {
+    const regions = this.regionTargets;
+    const plan = /* @__PURE__ */ new Map();
+    for (const region of regions) plan.set(region, this.#isVisible(region, triggers));
+    const changed = /* @__PURE__ */ new Set();
+    const applicationOrder = [
+      ...regions.filter((region) => plan.get(region) === true),
+      ...regions.filter((region) => plan.get(region) === false)
+    ];
+    for (const region of applicationOrder) {
+      const visible = plan.get(region);
+      if (visible !== void 0 && this.#applyRegion(region, visible, plan)) {
+        changed.add(region);
+      }
+    }
+    return regions.filter((region) => changed.has(region)).map((region) => ({ region, visible: plan.get(region) === true }));
+  }
+  /** Reports logical transitions caused by user input or the public action. */
+  #commitChange(triggers = this.triggerTargets) {
+    for (const detail of this.#settle(triggers)) {
+      this.dispatch("change", { detail });
+    }
+  }
+  /** Reports logical transitions derived from DOM, lifecycle, reset, or Value state. */
+  #reconcileDom() {
+    for (const detail of this.#settle()) {
+      this.dispatch("reconcile", { detail });
     }
   }
-  /** Applies a region's visibility, syncing hidden/aria/disabled and emitting change. */
-  #applyRegion(region, visible) {
+  /** Applies one planned state while keeping event history separate from DOM repair. */
+  #applyRegion(region, visible, plan) {
     const previous = this.#lastVisible.get(region) ?? !region.hidden;
-    if (visible === previous && this.#lastVisible.has(region)) return;
+    const changed = visible !== previous;
     this.#lastVisible.set(region, visible);
-    if (visible) {
-      region.hidden = false;
-      region.removeAttribute("aria-hidden");
-      region.setAttribute("data-visible", "true");
-      this.#setRegionDisabled(region, false);
-    } else {
-      this.#retreatFocus(region);
-      region.hidden = true;
-      region.setAttribute("aria-hidden", "true");
-      region.removeAttribute("data-visible");
-      this.#setRegionDisabled(region, true);
-    }
-    if (visible !== previous) {
-      this.dispatch("change", { detail: { region, visible } });
+    if (!visible) this.#retreatFocus(region, plan);
+    this.#syncRegionState(region, visible);
+    this.#syncRegionControls(region, visible);
+    return changed;
+  }
+  /** Reflects visibility idempotently, recording writes so the observer ignores its own work. */
+  #syncRegionState(region, visible) {
+    this.#writeAttribute(region, "hidden", visible ? null : "");
+    this.#writeAttribute(region, "aria-hidden", visible ? null : "true");
+    this.#writeAttribute(region, "data-visible", visible ? "true" : null);
+  }
+  /** Enables/disables descendant controls, touching only state carrying our marker. */
+  #syncRegionControls(region, visible) {
+    const shouldDisable = !visible && this.disableHiddenValue;
+    const controls = region.querySelectorAll("input, textarea, select, button");
+    for (const control of controls) {
+      const marked = control.hasAttribute(DISABLED_MARKER);
+      if (shouldDisable) {
+        if (!control.disabled) {
+          this.#writeAttribute(control, "disabled", "");
+          this.#writeAttribute(control, DISABLED_MARKER, "true");
+        } else if (marked && control.getAttribute(DISABLED_MARKER) !== "true") {
+          this.#writeAttribute(control, DISABLED_MARKER, "true");
+        }
+      } else if (marked) {
+        this.#writeAttribute(control, "disabled", null);
+        this.#writeAttribute(control, DISABLED_MARKER, null);
+      }
     }
   }
   /** Whether a region's declared condition holds across `triggers` per `match`. */
   #isVisible(region, triggers) {
     const predicate = this.#predicateFor(region);
     if (predicate === null) return !region.hidden;
-    if (triggers.length === 0) return false;
-    return this.matchValue === "all" ? triggers.every(predicate) : triggers.some(predicate);
+    return triggers.length > 0 && (this.matchValue === "all" ? triggers.every(predicate) : triggers.some(predicate));
   }
-  /** Builds the per-trigger predicate from the region's `data-when-*` attribute. */
+  /** Builds the deterministic per-trigger predicate from the region's condition. */
   #predicateFor(region) {
     if (region.hasAttribute("data-when-checked")) {
       return (trigger) => this.#isChecked(trigger);
@@ -75,35 +317,87 @@ var ConditionalFieldsController = class extends Controller {
   #isChecked(trigger) {
     return trigger instanceof HTMLInputElement && trigger.checked;
   }
-  /** A trigger "has" a value: selected radio/checkbox value, or the control value. */
+  /** A trigger has a value when a radio/checkbox is selected, or its control value matches. */
   #matchesValue(trigger, wanted) {
     if (trigger instanceof HTMLInputElement && (trigger.type === "checkbox" || trigger.type === "radio")) {
       return trigger.checked && trigger.value === wanted;
     }
     return trigger.value === wanted;
   }
-  /** Enables/disables a region's inputs, tracking only the ones we disabled. */
-  #setRegionDisabled(region, disabled) {
-    if (!this.disableHiddenValue) return;
-    const controls = region.querySelectorAll("input, textarea, select, button");
-    for (const control of Array.from(controls)) {
-      if (disabled) {
-        if (!control.disabled) {
-          control.disabled = true;
-          control.setAttribute(DISABLED_MARKER, "true");
+  /** Moves focus to the first safe trigger, or to the controller landmark as a fallback. */
+  #retreatFocus(region, plan) {
+    const active = document.activeElement;
+    if (active && region.contains(active)) this.#moveFocus(plan);
+  }
+  /** Moves focus after the caller establishes that the active node is being hidden. */
+  #moveFocus(plan) {
+    const destination = this.triggerTargets.find(
+      (trigger) => canTakeFocus(trigger) && this.#survivesPlan(trigger, plan)
+    );
+    if (destination) {
+      this.#rootTabindex.returnAll();
+      destination.focus();
+      return;
+    }
+    this.#rootTabindex.lend(this.element);
+    this.element.focus();
+  }
+  /** Whether a focus candidate sits outside every region this pass will hide. */
+  #survivesPlan(candidate, plan) {
+    return [...plan].every(([region, visible]) => visible || !region.contains(candidate));
+  }
+  /** Records one idempotent attribute write before MutationObserver sees it. */
+  #writeAttribute(element, name, value) {
+    if (element.getAttribute(name) !== value) {
+      if (this.#observing) {
+        let writes = this.#internalWrites.get(element);
+        if (!writes) {
+          writes = /* @__PURE__ */ new Map();
+          this.#internalWrites.set(element, writes);
         }
-      } else if (control.hasAttribute(DISABLED_MARKER)) {
-        control.disabled = false;
-        control.removeAttribute(DISABLED_MARKER);
+        writes.set(name, value);
       }
+      if (value === null) element.removeAttribute(name);
+      else element.setAttribute(name, value);
     }
   }
-  /** Moves focus out of a region about to be hidden, to a trigger when possible. */
-  #retreatFocus(region) {
-    const active = document.activeElement;
-    if (!(active instanceof HTMLElement) || !region.contains(active)) return;
-    active.blur();
-    if (this.hasTriggerTarget) this.triggerTargets[0]?.focus();
+  /** Separates authored records from controller writes and queues one relevant repair. */
+  #onMutations(records) {
+    const triggers = this.triggerTargets;
+    const regions = this.regionTargets;
+    const touchedWrites = /* @__PURE__ */ new Map();
+    let needsReconcile = false;
+    for (const record of records) {
+      if (record.type === "attributes" && record.target instanceof Element) {
+        const name = record.attributeName;
+        const writes = this.#internalWrites.get(record.target);
+        if (name && writes?.has(name)) {
+          let names = touchedWrites.get(record.target);
+          if (!names) {
+            names = /* @__PURE__ */ new Set();
+            touchedWrites.set(record.target, names);
+          }
+          names.add(name);
+          if (record.target.getAttribute(name) === writes.get(name)) continue;
+        }
+      }
+      if (record.target instanceof Element && this.#elementAffectsState(record.target, triggers, regions)) {
+        needsReconcile = true;
+      }
+    }
+    for (const [element, names] of touchedWrites) {
+      const writes = this.#internalWrites.get(element);
+      for (const name of names) writes?.delete(name);
+    }
+    if (needsReconcile) this.#reconcile.schedule();
+  }
+  /** Whether an authored mutation target belongs to a trigger, region, or managed control. */
+  #elementAffectsState(target, triggers, regions) {
+    return triggers.some((trigger) => trigger === target || trigger.contains(target)) || regions.some((region) => region === target || region.contains(target));
+  }
+  /** Whether a form owns at least one current trigger, including `form=` associations. */
+  #hasTriggerOwnedBy(form) {
+    return this.triggerTargets.some((trigger) => trigger.form === form);
   }
 };
 

package/dist/controllers/conditional_fields_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controllers/conditional_fields_controller.ts"],"names":[],"mappings":"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","file":"conditional_fields_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\n\n/** Trigger controls whose state drives region visibility. */\ntype Trigger = HTMLInputElement | HTMLSelectElement;\n/** Form controls inside a region that get disabled while hidden. */\ntype Disableable = HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement | HTMLButtonElement;\n\n/** Marker on inputs this controller disabled (so we never re-enable authored-disabled ones). */\nconst DISABLED_MARKER = \"data-conditional-disabled\";\n\n/**\n * Headless dependent-fields behavior: shows/hides (and enables/disables) regions\n * based on trigger control values, keeping `hidden` / `aria-hidden` / `disabled` in\n * sync (no dedicated APG pattern).\n *\n * Markup contract (identifier: `stimeo--conditional-fields`):\n *   <form data-controller=\"stimeo--conditional-fields\">\n *     <input type=\"checkbox\" data-stimeo--conditional-fields-target=\"trigger\">\n *     <fieldset data-stimeo--conditional-fields-target=\"region\" data-when-checked>\n *       …address…\n *     </fieldset>\n *   </form>\n *\n * Each region declares its condition with a data attribute: `data-when-checked`,\n * `data-when-unchecked`, or `data-when-value=\"x\"`. When the condition (combined\n * across triggers per `match`) holds the region is shown and its inputs enabled;\n * otherwise it is hidden, `aria-hidden`, and — with `disableHidden` — its inputs are\n * disabled so they drop out of the submission. Hiding a region that holds focus\n * first retreats focus to a trigger.\n *\n * @remarks\n * Behavior only. Visibility/enabled state lives entirely on the elements' `hidden` /\n * `disabled` / `aria-hidden`, re-derived from triggers on `connect()` (Morph-safe).\n * The change/input listener is removed on `disconnect()` (Turbo navigation included).\n */\nexport class ConditionalFieldsController extends Controller<HTMLElement> {\n  static override targets = [\"trigger\", \"region\"];\n  static override values = {\n    disableHidden: { type: Boolean, default: true },\n    match: { type: String, default: \"any\" },\n  };\n  static actions = [\"evaluate\"] as const;\n  static events = [\"change\"] as const;\n\n  declare readonly triggerTargets: Trigger[];\n  declare readonly regionTargets: HTMLElement[];\n  declare readonly hasTriggerTarget: boolean;\n\n  declare disableHiddenValue: boolean;\n  declare matchValue: string;\n\n  readonly #lastVisible = new WeakMap<HTMLElement, boolean>();\n\n  readonly #onChange = (): void => {\n    this.evaluate();\n  };\n\n  override connect(): void {\n    this.evaluate();\n    this.element.addEventListener(\"change\", this.#onChange);\n    this.element.addEventListener(\"input\", this.#onChange);\n  }\n\n  override disconnect(): void {\n    this.element.removeEventListener(\"change\", this.#onChange);\n    this.element.removeEventListener(\"input\", this.#onChange);\n  }\n\n  /** Re-evaluates every region against the current trigger state. */\n  evaluate(): void {\n    // Resolved once per pass: this runs per keystroke (input/change bubble up from\n    // the whole form) and every Stimulus target access re-queries the scope.\n    const triggers = this.triggerTargets;\n    for (const region of this.regionTargets) {\n      this.#applyRegion(region, this.#isVisible(region, triggers));\n    }\n  }\n\n  /** Applies a region's visibility, syncing hidden/aria/disabled and emitting change. */\n  #applyRegion(region: HTMLElement, visible: boolean): void {\n    const previous = this.#lastVisible.get(region) ?? !region.hidden;\n    if (visible === previous && this.#lastVisible.has(region)) return;\n    this.#lastVisible.set(region, visible);\n\n    if (visible) {\n      region.hidden = false;\n      region.removeAttribute(\"aria-hidden\");\n      region.setAttribute(\"data-visible\", \"true\");\n      this.#setRegionDisabled(region, false);\n    } else {\n      this.#retreatFocus(region);\n      region.hidden = true;\n      region.setAttribute(\"aria-hidden\", \"true\");\n      region.removeAttribute(\"data-visible\");\n      this.#setRegionDisabled(region, true);\n    }\n\n    if (visible !== previous) {\n      this.dispatch(\"change\", { detail: { region, visible } });\n    }\n  }\n\n  /** Whether a region's declared condition holds across `triggers` per `match`. */\n  #isVisible(region: HTMLElement, triggers: Trigger[]): boolean {\n    const predicate = this.#predicateFor(region);\n    if (predicate === null) return !region.hidden; // no condition declared → leave as-is\n    if (triggers.length === 0) return false;\n    return this.matchValue === \"all\" ? triggers.every(predicate) : triggers.some(predicate);\n  }\n\n  /** Builds the per-trigger predicate from the region's `data-when-*` attribute. */\n  #predicateFor(region: HTMLElement): ((trigger: Trigger) => boolean) | null {\n    if (region.hasAttribute(\"data-when-checked\")) {\n      return (trigger) => this.#isChecked(trigger);\n    }\n    if (region.hasAttribute(\"data-when-unchecked\")) {\n      return (trigger) => !this.#isChecked(trigger);\n    }\n    const wanted = region.dataset.whenValue;\n    if (wanted !== undefined) {\n      return (trigger) => this.#matchesValue(trigger, wanted);\n    }\n    return null;\n  }\n\n  #isChecked(trigger: Trigger): boolean {\n    return trigger instanceof HTMLInputElement && trigger.checked;\n  }\n\n  /** A trigger \"has\" a value: selected radio/checkbox value, or the control value. */\n  #matchesValue(trigger: Trigger, wanted: string): boolean {\n    if (\n      trigger instanceof HTMLInputElement &&\n      (trigger.type === \"checkbox\" || trigger.type === \"radio\")\n    ) {\n      return trigger.checked && trigger.value === wanted;\n    }\n    return trigger.value === wanted;\n  }\n\n  /** Enables/disables a region's inputs, tracking only the ones we disabled. */\n  #setRegionDisabled(region: HTMLElement, disabled: boolean): void {\n    if (!this.disableHiddenValue) return;\n    const controls = region.querySelectorAll<Disableable>(\"input, textarea, select, button\");\n    for (const control of Array.from(controls)) {\n      if (disabled) {\n        if (!control.disabled) {\n          control.disabled = true;\n          control.setAttribute(DISABLED_MARKER, \"true\");\n        }\n      } else if (control.hasAttribute(DISABLED_MARKER)) {\n        control.disabled = false;\n        control.removeAttribute(DISABLED_MARKER);\n      }\n    }\n  }\n\n  /** Moves focus out of a region about to be hidden, to a trigger when possible. */\n  #retreatFocus(region: HTMLElement): void {\n    const active = document.activeElement;\n    if (!(active instanceof HTMLElement) || !region.contains(active)) return;\n    active.blur();\n    if (this.hasTriggerTarget) this.triggerTargets[0]?.focus();\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/focus_candidate.ts","../../src/utils/microtask_coalescer.ts","../../src/utils/before_cache_reset.ts","../../src/utils/tabindex_loan.ts","../../src/controllers/conditional_fields_controller.ts"],"names":[],"mappings":"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","file":"conditional_fields_controller.js","sourcesContent":["/**\n * Whether a disabled `<fieldset>` ancestor actually reaches `control`.\n *\n * HTML exempts the contents of a fieldset's **first direct-child `<legend>`**, and\n * the exemption is per fieldset — a control legal in one legend can still be\n * disabled by a second, outer fieldset, so the walk continues upward.\n *\n * Exported for the consumer that needs this rule *without* the rest of\n * {@link canTakeFocus}: `toolbar` bounds its own `hidden` walk at the toolbar\n * root, which is a different rule, so it composes the two itself.\n */\nexport function inheritsFieldsetDisabled(control: HTMLElement): boolean {\n  let fieldset: Element | null = control.closest(\"fieldset[disabled]\");\n  while (fieldset) {\n    const legend = Array.from(fieldset.children).find((child) => child.tagName === \"LEGEND\");\n    if (!legend?.contains(control)) return true;\n    fieldset = fieldset.parentElement?.closest(\"fieldset[disabled]\") ?? null;\n  }\n  return false;\n}\n\n/**\n * Whether an element can actually take focus, checked **before** `focus()` runs.\n *\n * A controller that must move focus off a control it is about to disable or hide\n * picks a destination and calls `focus()` on it. If that destination cannot take\n * focus, the call **fails silently**: `hidden` and natively `disabled` elements\n * swallow it, so the caret stays in the subtree that is disappearing and lands on\n * `<body>` a frame later — the exact outcome the rescue exists to prevent, minus\n * any signal that it happened.\n *\n * Testing after the fact is the obvious alternative and is deliberately not the\n * rule. Reading `document.activeElement` back only works in a real browser, and\n * looping over candidates that way performs a real focus move per failure —\n * observable to assistive technology. Checking first costs nothing and catches\n * the cases that actually occur.\n *\n * **`aria-disabled` is not disqualifying.** It is the attribute an author uses\n * for a control that must stay *discoverable*, and the roving contract keeps\n * such items reachable. Only the three conditions that make the platform refuse\n * focus are checked: `hidden` / `inert` (an ancestor's counts),\n * `input[type=\"hidden\"]`, the native `disabled` property, and `disabled`\n * inherited from an ancestor `fieldset`. CSS-only invisibility is handled by\n * {@link isRenderedForFocus} when a consumer needs sequential-focus semantics.\n *\n * Reading `:disabled` instead of walking the fieldset chain would be shorter, but\n * that pseudo-class is not evaluated consistently outside real browsers and this\n * has to be right headlessly too. happy-dom in particular focuses a `<button>`\n * inside a disabled fieldset where a real engine refuses, so the inheritance is\n * spelled out rather than delegated.\n *\n * What a consumer does when nothing survives is its own call: some fall back to\n * their landmark, while a widget whose caret already sits somewhere legitimate\n * refuses the move outright rather than relocating it.\n *\n * @example\n * ```ts\n * const target = candidates.find(canTakeFocus);\n * if (target) target.focus();\n * else {\n *   this.#tabindex.lend(this.element); // nothing left: fall back to the landmark\n *   this.element.focus();\n * }\n * ```\n *\n * @param element - the candidate destination\n */\nexport function canTakeFocus(element: HTMLElement): boolean {\n  if (element.closest(\"[hidden], [inert]\")) return false;\n  if (element instanceof HTMLInputElement && element.type === \"hidden\") return false;\n  if (!(\"disabled\" in element)) return true;\n  if ((element as HTMLElement & { disabled: boolean }).disabled) return false;\n  return !inheritsFieldsetDisabled(element);\n}\n\n/** Elements whose semantics or authored attributes can place them in sequential focus order. */\nexport const TAB_STOP_CANDIDATE_SELECTOR = [\n  \"a[href]\",\n  \"area[href]\",\n  \"button\",\n  \"input\",\n  \"select\",\n  \"textarea\",\n  \"summary\",\n  \"iframe\",\n  \"audio[controls]\",\n  \"video[controls]\",\n  \"[tabindex]\",\n  \"[contenteditable]\",\n].join(\",\");\n\n/** Optional browser visibility API used to exclude CSS-hidden candidates. */\ninterface VisibilityCheckable {\n  checkVisibility?: (options?: { visibilityProperty?: boolean }) => boolean;\n}\n\n/** Whether CSS visibility allows an otherwise eligible element to participate in focus order. */\nexport function isRenderedForFocus(element: HTMLElement): boolean {\n  const check = (element as HTMLElement & VisibilityCheckable).checkVisibility;\n  return typeof check === \"function\" ? check.call(element, { visibilityProperty: true }) : true;\n}\n\n/** Parses an authored `tabindex`; invalid syntax has no explicit focus-order meaning. */\nfunction authoredTabindex(element: HTMLElement): number | null {\n  const value = element.getAttribute(\"tabindex\");\n  if (value === null || !/^[+-]?\\d+$/.test(value.trim())) return null;\n  return Number(value);\n}\n\n/** Whether the element's native semantics place it in sequential focus order. */\nfunction hasNativeTabStop(element: HTMLElement): boolean {\n  if (element instanceof HTMLAnchorElement || element instanceof HTMLAreaElement) {\n    return element.hasAttribute(\"href\");\n  }\n  if (\n    element instanceof HTMLButtonElement ||\n    element instanceof HTMLSelectElement ||\n    element instanceof HTMLTextAreaElement\n  ) {\n    return true;\n  }\n  if (element instanceof HTMLInputElement) return element.type !== \"hidden\";\n  if (element instanceof HTMLIFrameElement) return true;\n  if (element.tagName === \"AUDIO\" || element.tagName === \"VIDEO\") {\n    return element.hasAttribute(\"controls\");\n  }\n  if (element instanceof HTMLElement && element.tagName === \"SUMMARY\") {\n    const details = element.parentElement;\n    return (\n      details instanceof HTMLDetailsElement &&\n      Array.from(details.children).find((child) => child.tagName === \"SUMMARY\") === element\n    );\n  }\n  return false;\n}\n\n/** Whether an explicit `contenteditable` value creates an editable tab stop. */\nfunction hasEditableTabStop(element: HTMLElement): boolean {\n  const value = element.getAttribute(\"contenteditable\")?.toLowerCase();\n  return value === \"\" || value === \"true\" || value === \"plaintext-only\";\n}\n\n/**\n * Whether an element is a usable sequential Tab stop right now.\n *\n * Native semantics, authored `tabindex`, editable hosts, inherited disabled state,\n * HTML `hidden`/`inert`, and CSS visibility are evaluated together. `aria-disabled`\n * remains focusable because it communicates unavailability without removing the\n * control from discovery order.\n */\nexport function isTabStop(element: HTMLElement): boolean {\n  if (!canTakeFocus(element) || !isRenderedForFocus(element)) return false;\n\n  const tabindex = authoredTabindex(element);\n  if (tabindex !== null) return tabindex >= 0;\n  return hasNativeTabStop(element) || hasEditableTabStop(element);\n}\n\n/** Returns every usable sequential Tab stop below `root` in document order. */\nexport function tabStopsWithin(root: ParentNode): HTMLElement[] {\n  return Array.from(root.querySelectorAll<HTMLElement>(TAB_STOP_CANDIDATE_SELECTOR)).filter(\n    isTabStop,\n  );\n}\n\n/** Returns the first usable sequential Tab stop below `root`, if one exists. */\nexport function firstTabStop(root: ParentNode): HTMLElement | null {\n  for (const candidate of root.querySelectorAll<HTMLElement>(TAB_STOP_CANDIDATE_SELECTOR)) {\n    if (isTabStop(candidate)) return candidate;\n  }\n  return null;\n}\n\n/** Whether `root` contains at least one usable sequential Tab stop. */\nexport function hasTabStop(root: ParentNode): boolean {\n  return firstTabStop(root) !== null;\n}\n","/**\n * Collapses many Stimulus lifecycle callbacks from one DOM mutation into a\n * single pass.\n *\n * Stimulus fires `<name>TargetConnected` / `Disconnected` once per element and\n * `<name>ValueChanged` once per changed attribute. Replacing a list of N options\n * or morphing several render Values therefore delivers N callbacks — but the\n * useful unit of work is \"reconcile against the resulting declarative input\",\n * once, after the batch has settled. Every controller with reconcilable targets\n * or render Values needs the same shape: a `queued` flag plus `queueMicrotask`.\n *\n * **A microtask is the right horizon, and the reason is specific.** Stimulus\n * drives these callbacks from a `MutationObserver`, whose own callback already\n * runs as a microtask with the whole batch in hand; scheduling one more lands\n * after the last sibling callback of that batch and still before paint or any\n * event handler. A timer would be later than it needs to be, and reconciling\n * synchronously would run once per element against a half-applied DOM.\n *\n * **The two guards are not the same guard.** Scheduling is refused before the\n * controller connects, and running is refused after it disconnects:\n *\n * - **Before `connect()`** — Stimulus delivers initial target and Value callbacks\n *   ahead of `connect()`. Reconciling there would compute output against a\n *   controller whose own state has not been initialised, and `connect()` is\n *   about to do a full pass anyway.\n * - **After `disconnect()`** — Stimulus fires a callback for **every** target\n *   during teardown, and a microtask queued just before it would otherwise run\n *   against a detached tree. {@link MicrotaskCoalescer.cancel} exists for the\n *   teardown path to drop the pending pass outright.\n *\n * Both guards are part of one contract here rather than something each consumer\n * has to remember separately.\n *\n * Scope is the scheduling only. *What* to reconcile — keep the surviving active\n * option, fall back to the next / previous / first visible one, rebuild derived\n * chips or hidden fields — stays in the controller, because no two consumers\n * answer it the same way.\n *\n * This file's own doc block is dropped from `dist`, but every member comment is\n * inlined into each consumer entry (`tsup` builds with `splitting: false`), so\n * rationale belongs here and only the contract belongs on the members.\n *\n * @example\n * ```ts\n * readonly #reconcile = new MicrotaskCoalescer(() => this.#reconcileOptions());\n *\n * connect()    { this.#reconcile.activate(); }\n * disconnect() { this.#reconcile.cancel(); }\n *\n * optionTargetConnected()    { this.#reconcile.schedule(); }\n * optionTargetDisconnected() { this.#reconcile.schedule(); }\n * ```\n */\nexport class MicrotaskCoalescer {\n  readonly #run: () => void;\n  #queued = false;\n  #active = false;\n  #generation = 0;\n\n  /** @param run - the single reconciliation pass, invoked at most once per batch. */\n  constructor(run: () => void) {\n    this.#run = run;\n  }\n\n  /** Opens the window in which {@link schedule} is honoured; call from `connect()`. */\n  activate(): void {\n    this.#active = true;\n  }\n\n  /** Closes the window and drops any pending pass; call from `disconnect()`. */\n  cancel(): void {\n    this.#active = false;\n    this.#queued = false;\n    this.#generation += 1;\n  }\n\n  /** Requests one pass after the batch settles. Idempotent; inert outside the window. */\n  schedule(): void {\n    if (!this.#active || this.#queued) return;\n    this.#queued = true;\n    const generation = this.#generation;\n    queueMicrotask(() => {\n      // A cancelled callback must not consume a pass queued after reconnect.\n      if (generation !== this.#generation || !this.#queued || !this.#active) return;\n      this.#queued = false;\n      this.#run();\n    });\n  }\n}\n","/**\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","import { BeforeCacheReset } from \"./before_cache_reset\";\n\n/**\n * Shared bookkeeping for a `tabindex` a controller lends an element temporarily.\n *\n * A controller that must move focus somewhere the author never made focusable\n * (a landmark root, a scroll destination) reaches for the same trick: add a\n * `tabindex` just-in-time and hand it back once it is no longer needed. The\n * borrow is the easy half; the return is what the two conditions below are for.\n *\n * **Returning needs two conditions, not one.** Owning the borrow is not enough:\n * the attribute must also still hold the value this instance wrote. A consumer\n * that changed it afterwards — `tabindex=\"0\"` to make the root its own Tab stop\n * — owns it now, and removing it there silently discards authored markup. The\n * bookkeeping is dropped either way, since the loan is over regardless of who\n * ends up owning the value.\n *\n * **Never borrow over an existing value.** An element that already carries a\n * `tabindex` is the author's to control, so there is nothing to lend and nothing\n * to return.\n *\n * Every live loan also owns a shared `turbo:before-cache` subscription. The loan\n * is returned before Turbo can copy it into a snapshot, so consumers get cache\n * safety without duplicating a lifecycle hook; `returnAll()` removes the\n * subscription again as soon as no loan remains.\n *\n * The registry is keyed by element, so a controller borrowing on a single\n * element (`this.element`) and one borrowing across a changing set of targets\n * use the same API — the single-element case is a set of one. It holds no\n * opinion about *when* to borrow or where focus goes next; that stays in the\n * controller.\n *\n * **The API is deliberately two methods.** This file's own doc block is dropped\n * from `dist`, but every member comment is inlined into **each** consumer entry\n * (`tsup` builds with `splitting: false`), so rationale belongs here, only the\n * contract belongs on the members, and every method no consumer calls is still\n * paid for once per consumer entry.\n *\n * @example\n * ```ts\n * readonly #tabindex = new TabindexLoan();\n *\n * #rescueFocus() {\n *   this.#tabindex.lend(this.element);\n *   this.element.focus();\n * }\n *\n * disconnect() {\n *   this.#tabindex.returnAll();\n * }\n * ```\n */\nexport class TabindexLoan<T extends HTMLElement = HTMLElement> {\n  readonly #value: string;\n  readonly #lent = new Set<T>();\n  /** Returns live loans before Turbo can copy them into its page snapshot. */\n  readonly #beforeCache = new BeforeCacheReset(() => this.returnAll());\n\n  /**\n   * @param value - the `tabindex` to lend. `\"-1\"` (the default) is\n   *   programmatically focusable but not a Tab stop; `\"0\"` is a real Tab stop,\n   *   which a scroll region with no focusable content of its own needs.\n   */\n  constructor(value: string = \"-1\") {\n    this.#value = value;\n  }\n\n  /** Lends `element` the value; no-ops when it already carries a `tabindex`. */\n  lend(element: T): void {\n    if (element.hasAttribute(\"tabindex\")) return;\n    element.setAttribute(\"tabindex\", this.#value);\n    this.#lent.add(element);\n    // Subscribe only while a real loan exists. Keeping this guarantee here means\n    // every consumer is Turbo-safe without another lifecycle hook to remember.\n    this.#beforeCache.activate();\n  }\n\n  /** Takes back every loan whose value is still the one that was lent. */\n  returnAll(): void {\n    for (const element of this.#lent) {\n      if (element.getAttribute(\"tabindex\") === this.#value) element.removeAttribute(\"tabindex\");\n    }\n    this.#lent.clear();\n    this.#beforeCache.deactivate();\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { canTakeFocus } from \"../utils/focus_candidate\";\nimport { MicrotaskCoalescer } from \"../utils/microtask_coalescer\";\nimport { TabindexLoan } from \"../utils/tabindex_loan\";\n\n/** Trigger controls whose live state drives region visibility. */\ntype Trigger = HTMLInputElement | HTMLSelectElement;\n/** Form controls inside a region that can be excluded from submission. */\ntype Disableable = HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement | HTMLButtonElement;\n/** One logical visibility transition settled during an evaluation pass. */\ntype RegionTransition = { region: HTMLElement; visible: boolean };\n\n/** Marker on controls this component disabled, so authored disabled state remains untouched. */\nconst DISABLED_MARKER = \"data-conditional-disabled\";\n\n/** Retained-DOM inputs and controller outputs that can require reconciliation. */\nconst OBSERVED_ATTRIBUTES = [\n  \"hidden\",\n  \"aria-hidden\",\n  \"data-visible\",\n  DISABLED_MARKER,\n  \"disabled\",\n  \"data-when-checked\",\n  \"data-when-unchecked\",\n  \"data-when-value\",\n  \"checked\",\n  \"selected\",\n  \"value\",\n  \"type\",\n];\n\n/** Attribute value expected after one controller-owned DOM write. */\ntype ExpectedAttribute = string | null;\n\n/**\n * Headless dependent-fields behavior: shows/hides (and enables/disables) regions\n * from trigger control values while keeping submission and accessibility state in\n * sync (no dedicated APG pattern).\n *\n * Markup contract (identifier: `stimeo--conditional-fields`):\n *   <form data-controller=\"stimeo--conditional-fields\">\n *     <input type=\"checkbox\" data-stimeo--conditional-fields-target=\"trigger\">\n *     <fieldset data-stimeo--conditional-fields-target=\"region\" data-when-checked>\n *       …address…\n *     </fieldset>\n *   </form>\n *\n * A region declares one condition: `data-when-checked`, `data-when-unchecked`,\n * or `data-when-value=\"x\"`. The condition is combined across all triggers using\n * `match` (`\"any\"` by default, or `\"all\"`). A region with no condition preserves\n * its authored `hidden` state; a declared condition with no triggers is false.\n *\n * Hidden regions receive `hidden` and `aria-hidden=\"true\"`; visible regions expose\n * `data-visible=\"true\"`. With `disableHidden`, descendant controls are disabled and\n * marked with `data-conditional-disabled=\"true\"`, and only marked controls are\n * re-enabled. Before a focused region is hidden, focus moves to the first trigger\n * that can actually receive it. If every trigger is unsafe — including one inside\n * another region being hidden in the same pass — the controller root temporarily\n * receives `tabindex=\"-1\"` and focus.\n *\n * `change` and `reconcile` dispatch `{ region, visible }`.\n *\n * @remarks\n * Behavior only. Trigger `input` / `change`, dynamic targets and descendants,\n * condition attributes, Values, native form reset, and Turbo retained-element\n * morphs all reconcile against the live DOM. Direct writes to an input's live\n * `checked` / `value` property remain observable only when the caller also emits\n * the corresponding native event. DOM repair is silent. User input or the public\n * action dispatches `stimeo--conditional-fields:change`; a lifecycle, Value,\n * reset, mutation, or morph reconciliation dispatches\n * `stimeo--conditional-fields:reconcile` instead. Initial connection is silent.\n * Every listener, observer, queued pass, and borrowed root `tabindex` is released\n * on `disconnect()`.\n */\nexport class ConditionalFieldsController extends Controller<HTMLElement> {\n  static override targets = [\"trigger\", \"region\"];\n  static override values = {\n    disableHidden: { type: Boolean, default: true },\n    match: { type: String, default: \"any\" },\n  };\n  static actions = [\"evaluate\"] as const;\n  static events = [\"change\", \"reconcile\"] as const;\n\n  declare readonly triggerTargets: Trigger[];\n  declare readonly regionTargets: HTMLElement[];\n\n  declare disableHiddenValue: boolean;\n  declare matchValue: string;\n\n  /** Logical state last committed for each current region; rebuilt on every connect. */\n  #lastVisible = new WeakMap<HTMLElement, boolean>();\n  /** Controller writes awaiting an observer callback, separated from authored morphs. */\n  #internalWrites = new WeakMap<Element, Map<string, ExpectedAttribute>>();\n  #observing = false;\n\n  /** Coalesces one target/morph/mutation batch into one full DOM reconciliation. */\n  readonly #reconcile = new MicrotaskCoalescer(() => this.#reconcileDom());\n  /** Provides the last-resort focus landmark without claiming an authored tabindex. */\n  readonly #rootTabindex = new TabindexLoan<HTMLElement>();\n  /** Watches retained targets and controls whose declarative or reflected state changed. */\n  readonly #observer = new MutationObserver((records) => this.#onMutations(records));\n\n  /** Evaluates only events whose source is one of this instance's live trigger targets. */\n  readonly #onTriggerInput = (event: Event): void => {\n    const target = event.target;\n    const triggers = this.triggerTargets;\n    if (target instanceof Element && triggers.some((trigger) => trigger === target)) {\n      this.#commitChange(triggers);\n    }\n  };\n\n  /** Reconciles property-only retained-element changes after Turbo morphs. */\n  readonly #onMorph = (): void => {\n    this.#reconcile.schedule();\n  };\n\n  /** Reconciles the settled defaults after a non-cancelled owning form reset. */\n  readonly #onReset = (event: Event): void => {\n    const form = event.target;\n    if (form instanceof HTMLFormElement && this.#hasTriggerOwnedBy(form)) {\n      queueMicrotask(() => {\n        if (!event.defaultPrevented) this.#reconcile.schedule();\n      });\n    }\n  };\n\n  /** Reflects initial live state and opens every retained-DOM reconciliation path. */\n  override connect(): void {\n    this.#lastVisible = new WeakMap();\n    this.#internalWrites = new WeakMap();\n    this.#reconcile.activate();\n    this.#settle();\n    this.#observer.observe(this.element, {\n      attributes: true,\n      attributeFilter: OBSERVED_ATTRIBUTES,\n      childList: true,\n      subtree: true,\n    });\n    this.#observing = true;\n    this.element.addEventListener(\"change\", this.#onTriggerInput);\n    this.element.addEventListener(\"input\", this.#onTriggerInput);\n    this.element.addEventListener(\"turbo:morph-element\", this.#onMorph);\n    document.addEventListener(\"reset\", this.#onReset, true);\n  }\n\n  /** Releases all external resources and returns the temporary focus landmark loan. */\n  override disconnect(): void {\n    this.#reconcile.cancel();\n    this.#observing = false;\n    this.#observer.disconnect();\n    this.element.removeEventListener(\"change\", this.#onTriggerInput);\n    this.element.removeEventListener(\"input\", this.#onTriggerInput);\n    this.element.removeEventListener(\"turbo:morph-element\", this.#onMorph);\n    document.removeEventListener(\"reset\", this.#onReset, true);\n    this.#rootTabindex.returnAll();\n  }\n\n  /** Reconciles after a trigger target is inserted or restored. */\n  triggerTargetConnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Reconciles after a trigger target is removed or replaced. */\n  triggerTargetDisconnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Initializes a region target inserted or restored at runtime. */\n  regionTargetConnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Reconciles the remaining region set after a target leaves. */\n  regionTargetDisconnected(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Reconciles when application code or a morph changes the match policy. */\n  matchValueChanged(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Reconciles control ownership when hidden controls become enabled or excluded. */\n  disableHiddenValueChanged(): void {\n    this.#reconcile.schedule();\n  }\n\n  /** Re-evaluates every region and repairs all reflected DOM state. */\n  evaluate(): void {\n    this.#commitChange();\n  }\n\n  /**\n   * Computes one settled plan, shows destinations before hiding sources, and then\n   * returns logical transitions in DOM order after every region is internally coherent.\n   */\n  #settle(triggers: Trigger[] = this.triggerTargets): RegionTransition[] {\n    const regions = this.regionTargets;\n    const plan = new Map<HTMLElement, boolean>();\n    for (const region of regions) plan.set(region, this.#isVisible(region, triggers));\n\n    const changed = new Set<HTMLElement>();\n    const applicationOrder = [\n      ...regions.filter((region) => plan.get(region) === true),\n      ...regions.filter((region) => plan.get(region) === false),\n    ];\n    for (const region of applicationOrder) {\n      const visible = plan.get(region);\n      if (visible !== undefined && this.#applyRegion(region, visible, plan)) {\n        changed.add(region);\n      }\n    }\n\n    return regions\n      .filter((region) => changed.has(region))\n      .map((region) => ({ region, visible: plan.get(region) === true }));\n  }\n\n  /** Reports logical transitions caused by user input or the public action. */\n  #commitChange(triggers: Trigger[] = this.triggerTargets): void {\n    for (const detail of this.#settle(triggers)) {\n      this.dispatch(\"change\", { detail });\n    }\n  }\n\n  /** Reports logical transitions derived from DOM, lifecycle, reset, or Value state. */\n  #reconcileDom(): void {\n    for (const detail of this.#settle()) {\n      this.dispatch(\"reconcile\", { detail });\n    }\n  }\n\n  /** Applies one planned state while keeping event history separate from DOM repair. */\n  #applyRegion(\n    region: HTMLElement,\n    visible: boolean,\n    plan: ReadonlyMap<HTMLElement, boolean>,\n  ): boolean {\n    const previous = this.#lastVisible.get(region) ?? !region.hidden;\n    const changed = visible !== previous;\n    this.#lastVisible.set(region, visible);\n\n    if (!visible) this.#retreatFocus(region, plan);\n    this.#syncRegionState(region, visible);\n    this.#syncRegionControls(region, visible);\n    return changed;\n  }\n\n  /** Reflects visibility idempotently, recording writes so the observer ignores its own work. */\n  #syncRegionState(region: HTMLElement, visible: boolean): void {\n    this.#writeAttribute(region, \"hidden\", visible ? null : \"\");\n    this.#writeAttribute(region, \"aria-hidden\", visible ? null : \"true\");\n    this.#writeAttribute(region, \"data-visible\", visible ? \"true\" : null);\n  }\n\n  /** Enables/disables descendant controls, touching only state carrying our marker. */\n  #syncRegionControls(region: HTMLElement, visible: boolean): void {\n    const shouldDisable = !visible && this.disableHiddenValue;\n    const controls = region.querySelectorAll<Disableable>(\"input, textarea, select, button\");\n    for (const control of controls) {\n      const marked = control.hasAttribute(DISABLED_MARKER);\n      if (shouldDisable) {\n        if (!control.disabled) {\n          this.#writeAttribute(control, \"disabled\", \"\");\n          this.#writeAttribute(control, DISABLED_MARKER, \"true\");\n        } else if (marked && control.getAttribute(DISABLED_MARKER) !== \"true\") {\n          this.#writeAttribute(control, DISABLED_MARKER, \"true\");\n        }\n      } else if (marked) {\n        this.#writeAttribute(control, \"disabled\", null);\n        this.#writeAttribute(control, DISABLED_MARKER, null);\n      }\n    }\n  }\n\n  /** Whether a region's declared condition holds across `triggers` per `match`. */\n  #isVisible(region: HTMLElement, triggers: Trigger[]): boolean {\n    const predicate = this.#predicateFor(region);\n    if (predicate === null) return !region.hidden;\n    return (\n      triggers.length > 0 &&\n      (this.matchValue === \"all\" ? triggers.every(predicate) : triggers.some(predicate))\n    );\n  }\n\n  /** Builds the deterministic per-trigger predicate from the region's condition. */\n  #predicateFor(region: HTMLElement): ((trigger: Trigger) => boolean) | null {\n    if (region.hasAttribute(\"data-when-checked\")) {\n      return (trigger) => this.#isChecked(trigger);\n    }\n    if (region.hasAttribute(\"data-when-unchecked\")) {\n      return (trigger) => !this.#isChecked(trigger);\n    }\n    const wanted = region.dataset.whenValue;\n    if (wanted !== undefined) {\n      return (trigger) => this.#matchesValue(trigger, wanted);\n    }\n    return null;\n  }\n\n  #isChecked(trigger: Trigger): boolean {\n    return trigger instanceof HTMLInputElement && trigger.checked;\n  }\n\n  /** A trigger has a value when a radio/checkbox is selected, or its control value matches. */\n  #matchesValue(trigger: Trigger, wanted: string): boolean {\n    if (\n      trigger instanceof HTMLInputElement &&\n      (trigger.type === \"checkbox\" || trigger.type === \"radio\")\n    ) {\n      return trigger.checked && trigger.value === wanted;\n    }\n    return trigger.value === wanted;\n  }\n\n  /** Moves focus to the first safe trigger, or to the controller landmark as a fallback. */\n  #retreatFocus(region: HTMLElement, plan: ReadonlyMap<HTMLElement, boolean>): void {\n    const active = document.activeElement;\n    if (active && region.contains(active)) this.#moveFocus(plan);\n  }\n\n  /** Moves focus after the caller establishes that the active node is being hidden. */\n  #moveFocus(plan: ReadonlyMap<HTMLElement, boolean>): void {\n    const destination = this.triggerTargets.find(\n      (trigger) => canTakeFocus(trigger) && this.#survivesPlan(trigger, plan),\n    );\n    if (destination) {\n      this.#rootTabindex.returnAll();\n      destination.focus();\n      return;\n    }\n\n    this.#rootTabindex.lend(this.element);\n    this.element.focus();\n  }\n\n  /** Whether a focus candidate sits outside every region this pass will hide. */\n  #survivesPlan(candidate: HTMLElement, plan: ReadonlyMap<HTMLElement, boolean>): boolean {\n    return [...plan].every(([region, visible]) => visible || !region.contains(candidate));\n  }\n\n  /** Records one idempotent attribute write before MutationObserver sees it. */\n  #writeAttribute(element: Element, name: string, value: ExpectedAttribute): void {\n    if (element.getAttribute(name) !== value) {\n      if (this.#observing) {\n        let writes = this.#internalWrites.get(element);\n        if (!writes) {\n          writes = new Map();\n          this.#internalWrites.set(element, writes);\n        }\n        writes.set(name, value);\n      }\n      if (value === null) element.removeAttribute(name);\n      else element.setAttribute(name, value);\n    }\n  }\n\n  /** Separates authored records from controller writes and queues one relevant repair. */\n  #onMutations(records: MutationRecord[]): void {\n    const triggers = this.triggerTargets;\n    const regions = this.regionTargets;\n    const touchedWrites = new Map<Element, Set<string>>();\n    let needsReconcile = false;\n\n    for (const record of records) {\n      if (record.type === \"attributes\" && record.target instanceof Element) {\n        const name = record.attributeName;\n        const writes = this.#internalWrites.get(record.target);\n        if (name && writes?.has(name)) {\n          let names = touchedWrites.get(record.target);\n          if (!names) {\n            names = new Set();\n            touchedWrites.set(record.target, names);\n          }\n          names.add(name);\n          if (record.target.getAttribute(name) === writes.get(name)) continue;\n        }\n      }\n      if (\n        record.target instanceof Element &&\n        this.#elementAffectsState(record.target, triggers, regions)\n      ) {\n        needsReconcile = true;\n      }\n    }\n\n    for (const [element, names] of touchedWrites) {\n      const writes = this.#internalWrites.get(element);\n      for (const name of names) writes?.delete(name);\n    }\n    if (needsReconcile) this.#reconcile.schedule();\n  }\n\n  /** Whether an authored mutation target belongs to a trigger, region, or managed control. */\n  #elementAffectsState(target: Element, triggers: Trigger[], regions: HTMLElement[]): boolean {\n    return (\n      triggers.some((trigger) => trigger === target || trigger.contains(target)) ||\n      regions.some((region) => region === target || region.contains(target))\n    );\n  }\n\n  /** Whether a form owns at least one current trigger, including `form=` associations. */\n  #hasTriggerOwnedBy(form: HTMLFormElement): boolean {\n    return this.triggerTargets.some((trigger) => trigger.form === form);\n  }\n}\n"]}

package/dist/controllers/confirm_controller.d.ts

@@ -25,6 +25,8 @@ import { Controller } from '@hotwired/stimulus';
  *   <a href="/items/1" data-action="click->stimeo--confirm#request"
  *      data-stimeo--confirm-message-param="Delete this item?">Delete</a>
  *
+ * `open` dispatches `{ message }`; `resolve` dispatches `{ confirmed }`.
+ *
  * @remarks
  * Behavior only — the dialog's a11y (focus trap, restore, roles) is delegated to
  * the shared {@link FocusTrap}; this controller adds the Turbo bridge and the