stimeo-ui 0.1.0-alpha.1

package/dist/controllers/command_palette_controller.js

@@ -0,0 +1,381 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/command_palette_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"])';
+var FocusTrap = class {
+  /** The element focused before activation, restored on deactivation. */
+  #previouslyFocused = null;
+  /** The body's inline `overflow` before locking, restored on deactivation. */
+  #previousBodyOverflow = "";
+  /** Whether scroll was locked this activation (so it is only restored if applied). */
+  #scrollLocked = false;
+  /** Background siblings made `inert` while active, restored on deactivation. */
+  #inertedSiblings = [];
+  /** Whether the modal side effects are currently applied. */
+  #activeState = false;
+  /** Returns the trapped element; called on every operation for the live target. */
+  #getContainer;
+  /** Closing/focus hooks; see {@link FocusTrapOptions}. */
+  #options;
+  /**
+   * @param getContainer - Returns the trapped element. Called on every operation
+   *   so the live target is always used.
+   * @param options - Closing/focus hooks; see {@link FocusTrapOptions}.
+   */
+  constructor(getContainer, options = {}) {
+    this.#getContainer = getContainer;
+    this.#options = options;
+  }
+  /** Whether the trap is currently active. */
+  get active() {
+    return this.#activeState;
+  }
+  /**
+   * Applies the trap: records the current focus, optionally locks background scroll
+   * and makes background siblings `inert`, listens for `Tab`/`Escape`, and (unless
+   * `autoFocus` is off) moves focus inside. No-ops if already active.
+   */
+  activate() {
+    if (this.#activeState) return;
+    this.#activeState = true;
+    const active = document.activeElement;
+    this.#previouslyFocused = active instanceof HTMLElement && active !== document.body ? active : null;
+    if (this.#flag(this.#options.lockScroll, true)) {
+      this.#previousBodyOverflow = document.body.style.overflow;
+      document.body.style.overflow = "hidden";
+      this.#scrollLocked = true;
+    }
+    if (this.#flag(this.#options.isolate, true)) this.#isolateBackground();
+    document.addEventListener("keydown", this.#onKeydown);
+    if (this.#flag(this.#options.autoFocus, true)) this.#focusInitial();
+  }
+  /**
+   * Reverts every side effect applied by {@link activate}. No-ops if inactive, so
+   * a controller can call it defensively from both `close()` and `disconnect()`.
+   *
+   * @param restoreFocus - Move focus back to the opener (default `true`). Pass
+   *   `false` on teardown (`disconnect`), where yanking focus is undesirable.
+   */
+  deactivate({ restoreFocus = true } = {}) {
+    if (!this.#activeState) return;
+    this.#activeState = false;
+    document.removeEventListener("keydown", this.#onKeydown);
+    if (this.#scrollLocked) {
+      document.body.style.overflow = this.#previousBodyOverflow;
+      this.#scrollLocked = false;
+    }
+    this.#releaseBackground();
+    if (restoreFocus) {
+      const target = this.#previouslyFocused ?? this.#options.fallbackFocus?.() ?? null;
+      target?.focus();
+    }
+  }
+  /** Resolves a boolean-or-getter option, defaulting when it was not provided. */
+  #flag(option, fallback) {
+    if (option === void 0) return fallback;
+    return typeof option === "function" ? option() : option;
+  }
+  /** Handles `Escape` (delegated) and `Tab` (focus trap) while active. */
+  #onKeydown = (event) => {
+    if (event.key === "Escape") {
+      if (this.#options.onEscape) {
+        event.preventDefault();
+        this.#options.onEscape();
+      }
+      return;
+    }
+    if (event.key === "Tab") this.#trapTab(event);
+  };
+  /** Keeps `Tab` focus cycling within the container's focusable elements. */
+  #trapTab(event) {
+    const focusable = this.#focusableElements();
+    if (focusable.length === 0) {
+      event.preventDefault();
+      return;
+    }
+    const first = focusable[0];
+    const last = focusable[focusable.length - 1];
+    const active = document.activeElement;
+    if (!(active instanceof Node) || !this.#getContainer().contains(active)) {
+      event.preventDefault();
+      first?.focus();
+      return;
+    }
+    if (event.shiftKey && active === first) {
+      event.preventDefault();
+      last?.focus();
+    } else if (!event.shiftKey && active === last) {
+      event.preventDefault();
+      first?.focus();
+    }
+  }
+  /**
+   * Marks every element outside the container's subtree as `inert` so background
+   * content cannot be focused or reached by assistive technology, honoring the
+   * `aria-modal="true"` contract. An element that was *already* `inert` is left
+   * untracked so `#releaseBackground` does not wrongly clear it.
+   */
+  #isolateBackground() {
+    const container = this.#getContainer();
+    this.#inertedSiblings = [];
+    for (const sibling of Array.from(document.body.children)) {
+      if (!(sibling instanceof HTMLElement)) continue;
+      if (sibling.contains(container) || sibling.inert) continue;
+      sibling.inert = true;
+      this.#inertedSiblings.push(sibling);
+    }
+  }
+  /** Reverts the `inert` flags applied by `#isolateBackground`. */
+  #releaseBackground() {
+    for (const sibling of this.#inertedSiblings) {
+      sibling.inert = false;
+    }
+    this.#inertedSiblings = [];
+  }
+  /** Moves focus to the initial target, the first focusable, or the container. */
+  #focusInitial() {
+    const preferred = this.#options.initialFocus?.();
+    if (preferred) {
+      preferred.focus();
+      return;
+    }
+    const focusable = this.#focusableElements();
+    if (focusable[0]) {
+      focusable[0].focus();
+      return;
+    }
+    const container = this.#getContainer();
+    container.tabIndex = -1;
+    container.focus();
+  }
+  /** Collects the container's currently focusable descendants in DOM order. */
+  #focusableElements() {
+    return Array.from(this.#getContainer().querySelectorAll(FOCUSABLE)).filter(
+      (el) => !el.hidden
+    );
+  }
+};
+
+// src/controllers/command_palette_controller.ts
+var CommandPaletteController = class extends Controller {
+  static targets = ["dialog", "input", "list", "option", "empty"];
+  static values = {
+    hotkey: { type: String, default: "mod+k" },
+    open: { type: Boolean, default: false }
+  };
+  static actions = [
+    "close",
+    "closeOnBackdrop",
+    "filter",
+    "onKeydown",
+    "open",
+    "selectByClick",
+    "toggle"
+  ];
+  static events = ["select"];
+  /** The index of the currently active option within the visible subset. */
+  #activeIndex = -1;
+  /**
+   * Owns the modal side effects (focus trap, scroll lock, background `inert`, focus
+   * restore). Escape closes; focus on open goes to the input, and is restored to
+   * whatever opened the palette on close.
+   */
+  #trap = new FocusTrap(() => this.dialogTarget, {
+    onEscape: () => this.close(),
+    initialFocus: () => this.hasInputTarget ? this.inputTarget : null
+  });
+  /**
+   * Initializes the global hotkey handler and establishes the initial open state.
+   *
+   * The DOM is the source of truth on reconnect (Turbo cache restore / morph): if
+   * the restored snapshot already shows the dialog open, honor that rather than
+   * re-deriving from the declarative `open` Value (which would slam a user-opened
+   * palette shut). The `open` Value only seeds the initial state of a genuinely
+   * fresh render. We normalize to a clean closed baseline first so {@link open}
+   * runs its full setup — the {@link FocusTrap} is a fresh instance after a
+   * reconnect and must be re-activated.
+   */
+  connect() {
+    document.addEventListener("keydown", this.#onGlobalKeydown);
+    const shouldOpen = this.#isOpen || this.openValue;
+    this.#resetToClosedState();
+    if (shouldOpen) this.open();
+  }
+  /** Tears down the global hotkey listener and reverts the modal side effects. */
+  disconnect() {
+    document.removeEventListener("keydown", this.#onGlobalKeydown);
+    this.#trap.deactivate({ restoreFocus: false });
+    this.#resetToClosedState();
+  }
+  /** Toggles the open state of the command palette. */
+  toggle() {
+    if (this.#isOpen) {
+      this.close();
+    } else {
+      this.open();
+    }
+  }
+  /** Opens the palette, traps focus, and shifts focus to the input. */
+  open() {
+    if (!this.hasDialogTarget || this.#isOpen) return;
+    this.dialogTarget.hidden = false;
+    this.openValue = true;
+    if (this.hasInputTarget) this.inputTarget.setAttribute("aria-expanded", "true");
+    this.#resetFilter();
+    this.#trap.activate();
+  }
+  /** Closes the palette and restores focus back to the opener. */
+  close() {
+    if (!this.hasDialogTarget || !this.#isOpen) return;
+    this.#resetToClosedState();
+    this.#trap.deactivate();
+  }
+  /** Filters option elements in-memory matching the input value. Bound to input target. */
+  filter() {
+    if (!this.hasInputTarget) return;
+    const query = this.inputTarget.value.trim().toLowerCase();
+    let hasSelectableMatch = false;
+    for (const option of this.optionTargets) {
+      const searchText = (option.dataset.searchValue || option.textContent || "").trim().toLowerCase();
+      const matches = searchText.includes(query);
+      if (matches) {
+        option.removeAttribute("hidden");
+        if (!this.#isDisabled(option)) hasSelectableMatch = true;
+      } else {
+        option.setAttribute("hidden", "true");
+      }
+    }
+    if (this.hasEmptyTarget) {
+      this.emptyTarget.hidden = hasSelectableMatch;
+    }
+    this.#setActiveIndex(hasSelectableMatch ? 0 : -1);
+  }
+  /** Selects the clicked option. Bound to option targets. */
+  selectByClick(event) {
+    const target = event.currentTarget;
+    if (!target) return;
+    const option = target.closest("[role='option']");
+    if (option && !this.#isDisabled(option)) {
+      this.#confirmSelection(option);
+    }
+  }
+  /** Closes when the backdrop (the dialog target itself) is clicked, ignoring inner clicks. */
+  closeOnBackdrop(event) {
+    if (event.target === this.dialogTarget) this.close();
+  }
+  /**
+   * Combobox navigation keys (arrows / Home / End / Enter), bound to the input.
+   * `Tab` (focus trap) and `Escape` (close) are owned by the {@link FocusTrap} at
+   * the document level, so they work no matter which element inside the dialog has
+   * focus — not only the input.
+   */
+  onKeydown(event) {
+    if (!this.#isOpen) return;
+    switch (event.key) {
+      case "ArrowDown":
+        event.preventDefault();
+        this.#navigate(1);
+        break;
+      case "ArrowUp":
+        event.preventDefault();
+        this.#navigate(-1);
+        break;
+      case "Home":
+        event.preventDefault();
+        this.#setActiveIndex(0);
+        break;
+      case "End":
+        event.preventDefault();
+        this.#setActiveIndex(this.#visibleOptions.length - 1);
+        break;
+      case "Enter": {
+        event.preventDefault();
+        const activeOption = this.#visibleOptions[this.#activeIndex];
+        if (activeOption) this.#confirmSelection(activeOption);
+        break;
+      }
+    }
+  }
+  #navigate(direction) {
+    const visible = this.#visibleOptions;
+    if (visible.length === 0) return;
+    let newIndex = this.#activeIndex + direction;
+    if (newIndex >= visible.length) newIndex = 0;
+    if (newIndex < 0) newIndex = visible.length - 1;
+    this.#setActiveIndex(newIndex);
+  }
+  #setActiveIndex(index) {
+    const visible = this.#visibleOptions;
+    this.#activeIndex = index;
+    visible.forEach((option, i) => {
+      if (i === index) {
+        option.setAttribute("aria-selected", "true");
+        option.setAttribute("data-active", "true");
+        if (this.hasInputTarget) {
+          this.inputTarget.setAttribute("aria-activedescendant", option.id || "");
+        }
+        option.scrollIntoView({ block: "nearest" });
+      } else {
+        option.setAttribute("aria-selected", "false");
+        option.removeAttribute("data-active");
+      }
+    });
+    if (index === -1 && this.hasInputTarget) {
+      this.inputTarget.removeAttribute("aria-activedescendant");
+    }
+  }
+  #confirmSelection(option) {
+    const value = option.dataset.value || option.textContent || "";
+    this.dispatch("select", { detail: { value, option } });
+    this.close();
+  }
+  #resetFilter() {
+    if (this.hasInputTarget) this.inputTarget.value = "";
+    for (const option of this.optionTargets) {
+      option.removeAttribute("hidden");
+    }
+    if (this.hasEmptyTarget) this.emptyTarget.hidden = true;
+    this.#setActiveIndex(0);
+  }
+  get #visibleOptions() {
+    return this.optionTargets.filter(
+      (option) => !option.hasAttribute("hidden") && !this.#isDisabled(option)
+    );
+  }
+  #isDisabled(option) {
+    return option.dataset.disabled === "true";
+  }
+  get #isOpen() {
+    return this.hasDialogTarget && !this.dialogTarget.hidden;
+  }
+  #onGlobalKeydown = (event) => {
+    const hotkey = this.hotkeyValue.toLowerCase();
+    const isMod = hotkey.includes("mod+");
+    const key = hotkey.split("+").pop();
+    if (!key) return;
+    const modPressed = isMod ? event.metaKey || event.ctrlKey : !event.metaKey && !event.ctrlKey;
+    const keyMatch = event.key.toLowerCase() === key;
+    if (modPressed && keyMatch) {
+      event.preventDefault();
+      this.toggle();
+    }
+  };
+  /** Resets transient open state so reconnect starts from a predictable closed snapshot. */
+  #resetToClosedState() {
+    this.#activeIndex = -1;
+    this.openValue = false;
+    if (this.hasDialogTarget) {
+      this.dialogTarget.hidden = true;
+    }
+    if (this.hasInputTarget) {
+      this.inputTarget.setAttribute("aria-expanded", "false");
+      this.inputTarget.removeAttribute("aria-activedescendant");
+    }
+  }
+};
+
+export { CommandPaletteController };
+//# sourceMappingURL=command_palette_controller.js.map
+//# sourceMappingURL=command_palette_controller.js.map

package/dist/controllers/command_palette_controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/focus_trap.ts","../../src/controllers/command_palette_controller.ts"],"names":[],"mappings":"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","file":"command_palette_controller.js","sourcesContent":["/**\n * Modal focus-trap primitive shared by the modal-overlay controllers\n * (dialog / alert-dialog / drawer).\n *\n * The WAI-ARIA APG modal pattern is more than \"cycle Tab inside a box\": a modal\n * also locks background scroll, makes the rest of the page `inert` (so assistive\n * technology and pointer/Tab cannot reach it, honoring `aria-modal=\"true\"`),\n * sends focus inside on open, and restores it to the opener on close — and every\n * one of those side effects must be reverted if the element is torn down while\n * open (a Turbo navigation mid-dialog). {@link FocusTrap} owns that whole modal\n * lifecycle so each controller only decides *when* to open/close and *what*\n * \"close\" means.\n *\n * It is intentionally **policy-free about closing**. Escape semantics differ per\n * widget (a plain dialog just closes; an alert-dialog closes *as a cancel* with a\n * reason; a drawer runs an exit transition), so the trap merely forwards Escape\n * to an {@link FocusTrapOptions.onEscape | onEscape} callback and never decides on\n * its own what closing entails.\n *\n * @remarks\n * The container is read through a getter so a controller can hand over a Stimulus\n * target without worrying about when the trap instance is constructed relative to\n * `connect()`.\n */\n\n/**\n * Selector matching the elements considered focusable. Shared by the trap's Tab\n * cycling and by form-validation's invalid-focus delegation.\n */\nexport const FOCUSABLE =\n  'a[href], button:not([disabled]), textarea:not([disabled]), input:not([disabled]), select:not([disabled]), [tabindex]:not([tabindex=\"-1\"])';\n\n/** Behavior hooks a controller supplies when constructing a {@link FocusTrap}. */\nexport interface FocusTrapOptions {\n  /**\n   * Called when `Escape` is pressed while the trap is active. When omitted,\n   * `Escape` is left alone (the trap never closes itself). The trap calls\n   * `preventDefault()` before invoking it.\n   */\n  onEscape?: () => void;\n  /**\n   * Returns the element to focus when the trap activates. When it returns `null`\n   * (or is omitted), the first focusable descendant is used, falling back to the\n   * container itself (made programmatically focusable with `tabindex=-1`).\n   */\n  initialFocus?: () => HTMLElement | null;\n  /**\n   * Returns the element to focus on deactivation when nothing was focused before\n   * the trap opened (e.g. the trigger). The element focused *before* opening\n   * always takes precedence.\n   */\n  fallbackFocus?: () => HTMLElement | null;\n  /**\n   * Lock background scroll (`body` overflow) while active. Defaults to `true` for\n   * the modal overlays; a lighter focus scope passes `false`. Read on `activate`.\n   */\n  lockScroll?: boolean | (() => boolean);\n  /**\n   * Make background siblings `inert` while active (the `aria-modal` isolation).\n   * Defaults to `true` for the modal overlays; a soft focus scope can opt out so\n   * the background stays reachable while `Tab` still cycles inside. Read on `activate`.\n   */\n  isolate?: boolean | (() => boolean);\n  /**\n   * Move focus inside on `activate`. Defaults to `true`; a focus scope that only\n   * wants the `Tab` boundary (no focus move) passes `false`. Read on `activate`.\n   */\n  autoFocus?: boolean | (() => boolean);\n}\n\n/**\n * Owns the modal side effects (scroll lock, background `inert`, focus trap, focus\n * restore) for a single container, applied on {@link activate} and reverted on\n * {@link deactivate}.\n */\nexport class FocusTrap {\n  /** The element focused before activation, restored on deactivation. */\n  #previouslyFocused: HTMLElement | null = null;\n  /** The body's inline `overflow` before locking, restored on deactivation. */\n  #previousBodyOverflow = \"\";\n  /** Whether scroll was locked this activation (so it is only restored if applied). */\n  #scrollLocked = false;\n  /** Background siblings made `inert` while active, restored on deactivation. */\n  #inertedSiblings: HTMLElement[] = [];\n  /** Whether the modal side effects are currently applied. */\n  #activeState = false;\n\n  /** Returns the trapped element; called on every operation for the live target. */\n  readonly #getContainer: () => HTMLElement;\n  /** Closing/focus hooks; see {@link FocusTrapOptions}. */\n  readonly #options: FocusTrapOptions;\n\n  /**\n   * @param getContainer - Returns the trapped element. Called on every operation\n   *   so the live target is always used.\n   * @param options - Closing/focus hooks; see {@link FocusTrapOptions}.\n   */\n  constructor(getContainer: () => HTMLElement, options: FocusTrapOptions = {}) {\n    this.#getContainer = getContainer;\n    this.#options = options;\n  }\n\n  /** Whether the trap is currently active. */\n  get active(): boolean {\n    return this.#activeState;\n  }\n\n  /**\n   * Applies the trap: records the current focus, optionally locks background scroll\n   * and makes background siblings `inert`, listens for `Tab`/`Escape`, and (unless\n   * `autoFocus` is off) moves focus inside. No-ops if already active.\n   */\n  activate(): void {\n    if (this.#activeState) return;\n    this.#activeState = true;\n    // Record the opener so it can be refocused on close. `<body>` (the default\n    // active element when nothing is focused) is treated as \"nothing\", so the\n    // fallback target — typically the trigger — wins in that case.\n    const active = document.activeElement;\n    this.#previouslyFocused =\n      active instanceof HTMLElement && active !== document.body ? active : null;\n    if (this.#flag(this.#options.lockScroll, true)) {\n      this.#previousBodyOverflow = document.body.style.overflow;\n      document.body.style.overflow = \"hidden\";\n      this.#scrollLocked = true;\n    }\n    if (this.#flag(this.#options.isolate, true)) this.#isolateBackground();\n    document.addEventListener(\"keydown\", this.#onKeydown);\n    if (this.#flag(this.#options.autoFocus, true)) this.#focusInitial();\n  }\n\n  /**\n   * Reverts every side effect applied by {@link activate}. No-ops if inactive, so\n   * a controller can call it defensively from both `close()` and `disconnect()`.\n   *\n   * @param restoreFocus - Move focus back to the opener (default `true`). Pass\n   *   `false` on teardown (`disconnect`), where yanking focus is undesirable.\n   */\n  deactivate({ restoreFocus = true }: { restoreFocus?: boolean } = {}): void {\n    if (!this.#activeState) return;\n    this.#activeState = false;\n    document.removeEventListener(\"keydown\", this.#onKeydown);\n    if (this.#scrollLocked) {\n      document.body.style.overflow = this.#previousBodyOverflow;\n      this.#scrollLocked = false;\n    }\n    this.#releaseBackground();\n    if (restoreFocus) {\n      const target = this.#previouslyFocused ?? this.#options.fallbackFocus?.() ?? null;\n      target?.focus();\n    }\n  }\n\n  /** Resolves a boolean-or-getter option, defaulting when it was not provided. */\n  #flag(option: boolean | (() => boolean) | undefined, fallback: boolean): boolean {\n    if (option === undefined) return fallback;\n    return typeof option === \"function\" ? option() : option;\n  }\n\n  /** Handles `Escape` (delegated) and `Tab` (focus trap) while active. */\n  readonly #onKeydown = (event: KeyboardEvent): void => {\n    if (event.key === \"Escape\") {\n      if (this.#options.onEscape) {\n        event.preventDefault();\n        this.#options.onEscape();\n      }\n      return;\n    }\n    if (event.key === \"Tab\") this.#trapTab(event);\n  };\n\n  /** Keeps `Tab` focus cycling within the container's focusable elements. */\n  #trapTab(event: KeyboardEvent): void {\n    const focusable = this.#focusableElements();\n    if (focusable.length === 0) {\n      event.preventDefault();\n      return;\n    }\n    const first = focusable[0];\n    const last = focusable[focusable.length - 1];\n    const active = document.activeElement;\n\n    // If focus has somehow escaped the container, pull it back to the first item.\n    if (!(active instanceof Node) || !this.#getContainer().contains(active)) {\n      event.preventDefault();\n      first?.focus();\n      return;\n    }\n\n    if (event.shiftKey && active === first) {\n      event.preventDefault();\n      last?.focus();\n    } else if (!event.shiftKey && active === last) {\n      event.preventDefault();\n      first?.focus();\n    }\n  }\n\n  /**\n   * Marks every element outside the container's subtree as `inert` so background\n   * content cannot be focused or reached by assistive technology, honoring the\n   * `aria-modal=\"true\"` contract. An element that was *already* `inert` is left\n   * untracked so `#releaseBackground` does not wrongly clear it.\n   */\n  #isolateBackground(): void {\n    const container = this.#getContainer();\n    this.#inertedSiblings = [];\n    for (const sibling of Array.from(document.body.children)) {\n      if (!(sibling instanceof HTMLElement)) continue;\n      if (sibling.contains(container) || sibling.inert) continue;\n      sibling.inert = true;\n      this.#inertedSiblings.push(sibling);\n    }\n  }\n\n  /** Reverts the `inert` flags applied by `#isolateBackground`. */\n  #releaseBackground(): void {\n    for (const sibling of this.#inertedSiblings) {\n      sibling.inert = false;\n    }\n    this.#inertedSiblings = [];\n  }\n\n  /** Moves focus to the initial target, the first focusable, or the container. */\n  #focusInitial(): void {\n    const preferred = this.#options.initialFocus?.();\n    if (preferred) {\n      preferred.focus();\n      return;\n    }\n    const focusable = this.#focusableElements();\n    if (focusable[0]) {\n      focusable[0].focus();\n      return;\n    }\n    const container = this.#getContainer();\n    container.tabIndex = -1;\n    container.focus();\n  }\n\n  /** Collects the container's currently focusable descendants in DOM order. */\n  #focusableElements(): HTMLElement[] {\n    return Array.from(this.#getContainer().querySelectorAll<HTMLElement>(FOCUSABLE)).filter(\n      (el) => !el.hidden,\n    );\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { FocusTrap } from \"../utils/focus_trap\";\n\n/**\n * Headless, highly accessible Command Palette behavior.\n *\n * Markup contract (identifier: `stimeo--command-palette`):\n *   <div data-controller=\"stimeo--command-palette\"\n *        data-stimeo--command-palette-hotkey-value=\"mod+k\">\n *     <div data-stimeo--command-palette-target=\"dialog\" role=\"dialog\"\n *          aria-modal=\"true\" aria-label=\"Command palette\"\n *          data-action=\"click->stimeo--command-palette#closeOnBackdrop\" hidden>\n *       <input data-stimeo--command-palette-target=\"input\" role=\"combobox\"\n *              aria-expanded=\"false\" aria-controls=\"cmdk-list\"\n *              aria-autocomplete=\"list\" aria-label=\"Search commands\"\n *              data-action=\"input->stimeo--command-palette#filter\n *                           keydown->stimeo--command-palette#onKeydown\" />\n *       <ul id=\"cmdk-list\" data-stimeo--command-palette-target=\"list\" role=\"listbox\">\n *         <li id=\"cmd-new\" role=\"option\"\n *             data-stimeo--command-palette-target=\"option\"\n *             data-action=\"click->stimeo--command-palette#selectByClick\">New…</li>\n *         <li role=\"option\" data-stimeo--command-palette-target=\"option\"\n *             data-disabled=\"true\">Section heading (shown but not selectable)</li>\n *       </ul>\n *       <p data-stimeo--command-palette-target=\"empty\" hidden>No commands</p>\n *     </div>\n *   </div>\n *\n * Implements a composite **Dialog (Modal)** + **Combobox** (Listbox options) pattern.\n * A customizable global hotkey (Command/Ctrl + K) toggles it, focus is trapped\n * within the dialog, virtual focus roves via `aria-activedescendant`, and filtering\n * is performed in memory.\n *\n * @remarks\n * Behavior only. The combobox concerns (filtering, virtual focus, selection) live\n * here; the modal lifecycle — focus trap, scroll lock, background `inert`, focus\n * restore, and teardown reversal — is delegated to the shared {@link FocusTrap}\n * primitive (also used by dialog / alert-dialog / drawer). `Escape` closes and\n * `Tab`/`Shift+Tab` cycle focus regardless of which element inside the dialog holds\n * focus (input, close button, …), because the trap listens at the document level.\n * Styling, transitions, and the actual command handlers remain the consumer's.\n */\nexport class CommandPaletteController extends Controller<HTMLElement> {\n  static override targets = [\"dialog\", \"input\", \"list\", \"option\", \"empty\"];\n  static override values = {\n    hotkey: { type: String, default: \"mod+k\" },\n    open: { type: Boolean, default: false },\n  };\n  static actions = [\n    \"close\",\n    \"closeOnBackdrop\",\n    \"filter\",\n    \"onKeydown\",\n    \"open\",\n    \"selectByClick\",\n    \"toggle\",\n  ] as const;\n  static events = [\"select\"] as const;\n\n  declare readonly dialogTarget: HTMLElement;\n  declare readonly inputTarget: HTMLInputElement;\n  declare readonly listTarget: HTMLElement;\n  declare readonly optionTargets: HTMLElement[];\n  declare readonly emptyTarget: HTMLElement;\n\n  declare readonly hasDialogTarget: boolean;\n  declare readonly hasInputTarget: boolean;\n  declare readonly hasListTarget: boolean;\n  declare readonly hasEmptyTarget: boolean;\n\n  declare hotkeyValue: string;\n  declare openValue: boolean;\n\n  /** The index of the currently active option within the visible subset. */\n  #activeIndex = -1;\n\n  /**\n   * Owns the modal side effects (focus trap, scroll lock, background `inert`, focus\n   * restore). Escape closes; focus on open goes to the input, and is restored to\n   * whatever opened the palette on close.\n   */\n  readonly #trap = new FocusTrap(() => this.dialogTarget, {\n    onEscape: () => this.close(),\n    initialFocus: () => (this.hasInputTarget ? this.inputTarget : null),\n  });\n\n  /**\n   * Initializes the global hotkey handler and establishes the initial open state.\n   *\n   * The DOM is the source of truth on reconnect (Turbo cache restore / morph): if\n   * the restored snapshot already shows the dialog open, honor that rather than\n   * re-deriving from the declarative `open` Value (which would slam a user-opened\n   * palette shut). The `open` Value only seeds the initial state of a genuinely\n   * fresh render. We normalize to a clean closed baseline first so {@link open}\n   * runs its full setup — the {@link FocusTrap} is a fresh instance after a\n   * reconnect and must be re-activated.\n   */\n  override connect(): void {\n    document.addEventListener(\"keydown\", this.#onGlobalKeydown);\n    const shouldOpen = this.#isOpen || this.openValue;\n    this.#resetToClosedState();\n    if (shouldOpen) this.open();\n  }\n\n  /** Tears down the global hotkey listener and reverts the modal side effects. */\n  override disconnect(): void {\n    document.removeEventListener(\"keydown\", this.#onGlobalKeydown);\n    this.#trap.deactivate({ restoreFocus: false });\n    this.#resetToClosedState();\n  }\n\n  /** Toggles the open state of the command palette. */\n  toggle(): void {\n    if (this.#isOpen) {\n      this.close();\n    } else {\n      this.open();\n    }\n  }\n\n  /** Opens the palette, traps focus, and shifts focus to the input. */\n  open(): void {\n    if (!this.hasDialogTarget || this.#isOpen) return;\n    this.dialogTarget.hidden = false;\n    this.openValue = true;\n    if (this.hasInputTarget) this.inputTarget.setAttribute(\"aria-expanded\", \"true\");\n    this.#resetFilter();\n    this.#trap.activate();\n  }\n\n  /** Closes the palette and restores focus back to the opener. */\n  close(): void {\n    if (!this.hasDialogTarget || !this.#isOpen) return;\n    this.#resetToClosedState();\n    this.#trap.deactivate();\n  }\n\n  /** Filters option elements in-memory matching the input value. Bound to input target. */\n  filter(): void {\n    if (!this.hasInputTarget) return;\n    const query = this.inputTarget.value.trim().toLowerCase();\n    // Disabled options (e.g. group headings) may still be shown, but they do not\n    // count toward the empty state and are never navigable/selectable.\n    let hasSelectableMatch = false;\n\n    for (const option of this.optionTargets) {\n      const searchText = (option.dataset.searchValue || option.textContent || \"\")\n        .trim()\n        .toLowerCase();\n      const matches = searchText.includes(query);\n\n      if (matches) {\n        option.removeAttribute(\"hidden\");\n        if (!this.#isDisabled(option)) hasSelectableMatch = true;\n      } else {\n        option.setAttribute(\"hidden\", \"true\");\n      }\n    }\n\n    if (this.hasEmptyTarget) {\n      this.emptyTarget.hidden = hasSelectableMatch;\n    }\n\n    this.#setActiveIndex(hasSelectableMatch ? 0 : -1);\n  }\n\n  /** Selects the clicked option. Bound to option targets. */\n  selectByClick(event: MouseEvent): void {\n    const target = event.currentTarget as HTMLElement | null;\n    if (!target) return;\n    const option = target.closest(\"[role='option']\") as HTMLElement | null;\n    // Ignore clicks on disabled options (e.g. group headings) so they never fire select.\n    if (option && !this.#isDisabled(option)) {\n      this.#confirmSelection(option);\n    }\n  }\n\n  /** Closes when the backdrop (the dialog target itself) is clicked, ignoring inner clicks. */\n  closeOnBackdrop(event: MouseEvent): void {\n    if (event.target === this.dialogTarget) this.close();\n  }\n\n  /**\n   * Combobox navigation keys (arrows / Home / End / Enter), bound to the input.\n   * `Tab` (focus trap) and `Escape` (close) are owned by the {@link FocusTrap} at\n   * the document level, so they work no matter which element inside the dialog has\n   * focus — not only the input.\n   */\n  onKeydown(event: KeyboardEvent): void {\n    if (!this.#isOpen) return;\n\n    switch (event.key) {\n      case \"ArrowDown\":\n        event.preventDefault();\n        this.#navigate(1);\n        break;\n      case \"ArrowUp\":\n        event.preventDefault();\n        this.#navigate(-1);\n        break;\n      case \"Home\":\n        event.preventDefault();\n        this.#setActiveIndex(0);\n        break;\n      case \"End\":\n        event.preventDefault();\n        this.#setActiveIndex(this.#visibleOptions.length - 1);\n        break;\n      case \"Enter\": {\n        event.preventDefault();\n        const activeOption = this.#visibleOptions[this.#activeIndex];\n        if (activeOption) this.#confirmSelection(activeOption);\n        break;\n      }\n    }\n  }\n\n  #navigate(direction: number): void {\n    const visible = this.#visibleOptions;\n    if (visible.length === 0) return;\n\n    let newIndex = this.#activeIndex + direction;\n    if (newIndex >= visible.length) newIndex = 0;\n    if (newIndex < 0) newIndex = visible.length - 1;\n\n    this.#setActiveIndex(newIndex);\n  }\n\n  #setActiveIndex(index: number): void {\n    const visible = this.#visibleOptions;\n    this.#activeIndex = index;\n\n    visible.forEach((option, i) => {\n      if (i === index) {\n        option.setAttribute(\"aria-selected\", \"true\");\n        option.setAttribute(\"data-active\", \"true\");\n        if (this.hasInputTarget) {\n          this.inputTarget.setAttribute(\"aria-activedescendant\", option.id || \"\");\n        }\n        option.scrollIntoView({ block: \"nearest\" });\n      } else {\n        option.setAttribute(\"aria-selected\", \"false\");\n        option.removeAttribute(\"data-active\");\n      }\n    });\n\n    if (index === -1 && this.hasInputTarget) {\n      this.inputTarget.removeAttribute(\"aria-activedescendant\");\n    }\n  }\n\n  #confirmSelection(option: HTMLElement): void {\n    const value = option.dataset.value || option.textContent || \"\";\n    this.dispatch(\"select\", { detail: { value, option } });\n    this.close();\n  }\n\n  #resetFilter(): void {\n    if (this.hasInputTarget) this.inputTarget.value = \"\";\n    for (const option of this.optionTargets) {\n      option.removeAttribute(\"hidden\");\n    }\n    if (this.hasEmptyTarget) this.emptyTarget.hidden = true;\n    this.#setActiveIndex(0);\n  }\n\n  get #visibleOptions(): HTMLElement[] {\n    // Only options that are both shown and not disabled are navigable/selectable.\n    return this.optionTargets.filter(\n      (option) => !option.hasAttribute(\"hidden\") && !this.#isDisabled(option),\n    );\n  }\n\n  #isDisabled(option: HTMLElement): boolean {\n    return option.dataset.disabled === \"true\";\n  }\n\n  get #isOpen(): boolean {\n    return this.hasDialogTarget && !this.dialogTarget.hidden;\n  }\n\n  readonly #onGlobalKeydown = (event: KeyboardEvent): void => {\n    const hotkey = this.hotkeyValue.toLowerCase();\n    const isMod = hotkey.includes(\"mod+\");\n    const key = hotkey.split(\"+\").pop();\n\n    if (!key) return;\n\n    // \"mod\" accepts *either* Cmd or Ctrl so the documented \"Cmd+K / Ctrl+K\" works\n    // on every platform — including Ctrl+K on macOS, not just Cmd+K. Without \"mod\",\n    // the hotkey is a bare key that must be pressed with no Cmd/Ctrl held.\n    const modPressed = isMod ? event.metaKey || event.ctrlKey : !event.metaKey && !event.ctrlKey;\n    const keyMatch = event.key.toLowerCase() === key;\n\n    if (modPressed && keyMatch) {\n      event.preventDefault();\n      this.toggle();\n    }\n  };\n\n  /** Resets transient open state so reconnect starts from a predictable closed snapshot. */\n  #resetToClosedState(): void {\n    this.#activeIndex = -1;\n    this.openValue = false;\n\n    if (this.hasDialogTarget) {\n      this.dialogTarget.hidden = true;\n    }\n\n    if (this.hasInputTarget) {\n      this.inputTarget.setAttribute(\"aria-expanded\", \"false\");\n      this.inputTarget.removeAttribute(\"aria-activedescendant\");\n    }\n  }\n}\n"]}

package/dist/controllers/conditional_fields_controller.d.ts

@@ -0,0 +1,56 @@
+import { Controller } from '@hotwired/stimulus';
+
+/** Trigger controls whose state drives region visibility. */
+type Trigger = HTMLInputElement | HTMLSelectElement;
+/**
+ * Headless dependent-fields behavior: shows/hides (and enables/disables) regions
+ * based on trigger control values, keeping `hidden` / `aria-hidden` / `disabled` in
+ * sync (no dedicated APG pattern).
+ *
+ * Markup contract (identifier: `stimeo--conditional-fields`):
+ *   <form data-controller="stimeo--conditional-fields">
+ *     <input type="checkbox" data-stimeo--conditional-fields-target="trigger">
+ *     <fieldset data-stimeo--conditional-fields-target="region" data-when-checked>
+ *       …address…
+ *     </fieldset>
+ *   </form>
+ *
+ * Each region declares its condition with a data attribute: `data-when-checked`,
+ * `data-when-unchecked`, or `data-when-value="x"`. When the condition (combined
+ * across triggers per `match`) holds the region is shown and its inputs enabled;
+ * otherwise it is hidden, `aria-hidden`, and — with `disableHidden` — its inputs are
+ * disabled so they drop out of the submission. Hiding a region that holds focus
+ * first retreats focus to a trigger.
+ *
+ * @remarks
+ * Behavior only. Visibility/enabled state lives entirely on the elements' `hidden` /
+ * `disabled` / `aria-hidden`, re-derived from triggers on `connect()` (Morph-safe).
+ * The change/input listener is removed on `disconnect()` (Turbo navigation included).
+ */
+declare class ConditionalFieldsController extends Controller<HTMLElement> {
+    #private;
+    static targets: string[];
+    static values: {
+        disableHidden: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        match: {
+            type: StringConstructor;
+            default: string;
+        };
+    };
+    static actions: readonly ["evaluate"];
+    static events: readonly ["change"];
+    readonly triggerTargets: Trigger[];
+    readonly regionTargets: HTMLElement[];
+    readonly hasTriggerTarget: boolean;
+    disableHiddenValue: boolean;
+    matchValue: string;
+    connect(): void;
+    disconnect(): void;
+    /** Re-evaluates every region against the current trigger state. */
+    evaluate(): void;
+}
+
+export { ConditionalFieldsController };

package/dist/controllers/conditional_fields_controller.js

@@ -0,0 +1,112 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/conditional_fields_controller.ts
+var DISABLED_MARKER = "data-conditional-disabled";
+var ConditionalFieldsController = class extends Controller {
+  static targets = ["trigger", "region"];
+  static values = {
+    disableHidden: { type: Boolean, default: true },
+    match: { type: String, default: "any" }
+  };
+  static actions = ["evaluate"];
+  static events = ["change"];
+  #lastVisible = /* @__PURE__ */ new WeakMap();
+  #onChange = () => {
+    this.evaluate();
+  };
+  connect() {
+    this.evaluate();
+    this.element.addEventListener("change", this.#onChange);
+    this.element.addEventListener("input", this.#onChange);
+  }
+  disconnect() {
+    this.element.removeEventListener("change", this.#onChange);
+    this.element.removeEventListener("input", this.#onChange);
+  }
+  /** Re-evaluates every region against the current trigger state. */
+  evaluate() {
+    const triggers = this.triggerTargets;
+    for (const region of this.regionTargets) {
+      this.#applyRegion(region, this.#isVisible(region, triggers));
+    }
+  }
+  /** Applies a region's visibility, syncing hidden/aria/disabled and emitting change. */
+  #applyRegion(region, visible) {
+    const previous = this.#lastVisible.get(region) ?? !region.hidden;
+    if (visible === previous && this.#lastVisible.has(region)) return;
+    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 } });
+    }
+  }
+  /** 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);
+  }
+  /** Builds the per-trigger predicate from the region's `data-when-*` attribute. */
+  #predicateFor(region) {
+    if (region.hasAttribute("data-when-checked")) {
+      return (trigger) => this.#isChecked(trigger);
+    }
+    if (region.hasAttribute("data-when-unchecked")) {
+      return (trigger) => !this.#isChecked(trigger);
+    }
+    const wanted = region.dataset.whenValue;
+    if (wanted !== void 0) {
+      return (trigger) => this.#matchesValue(trigger, wanted);
+    }
+    return null;
+  }
+  #isChecked(trigger) {
+    return trigger instanceof HTMLInputElement && trigger.checked;
+  }
+  /** A trigger "has" a value: selected radio/checkbox value, or the control value. */
+  #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");
+        }
+      } else if (control.hasAttribute(DISABLED_MARKER)) {
+        control.disabled = false;
+        control.removeAttribute(DISABLED_MARKER);
+      }
+    }
+  }
+  /** 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();
+  }
+};
+
+export { ConditionalFieldsController };
+//# sourceMappingURL=conditional_fields_controller.js.map
+//# sourceMappingURL=conditional_fields_controller.js.map

package/dist/controllers/conditional_fields_controller.js.map

@@ -0,0 +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"]}