stimeo-ui 0.1.0-alpha.1

package/dist/controllers/confirm_controller.d.ts

@@ -0,0 +1,83 @@
+import { Controller } from '@hotwired/stimulus';
+
+/**
+ * Headless **confirm bridge** — replaces the native `window.confirm()` Turbo uses
+ * for `data-turbo-confirm` with an accessible **Alert Dialog** (WAI-ARIA APG Alert
+ * Dialog pattern). Reuses the shared {@link FocusTrap}; the consumer only writes the
+ * dialog markup and "what to do on confirm".
+ *
+ * Markup contract (identifier: `stimeo--confirm`):
+ *   <div data-controller="stimeo--confirm">
+ *     <div data-stimeo--confirm-target="dialog" role="alertdialog" aria-modal="true"
+ *          aria-labelledby="ct" aria-describedby="cm" hidden>
+ *       <h2 id="ct" data-stimeo--confirm-target="title">Are you sure?</h2>
+ *       <p id="cm" data-stimeo--confirm-target="message"></p>
+ *       <button data-stimeo--confirm-target="cancel"
+ *               data-action="click->stimeo--confirm#cancel"></button>
+ *       <button data-stimeo--confirm-target="confirm"
+ *               data-action="click->stimeo--confirm#confirm"></button>
+ *     </div>
+ *   </div>
+ *
+ *   <!-- Driven automatically through Turbo's confirm hook: -->
+ *   <form data-turbo-confirm="Delete this item?" action="/items/1" method="post">…</form>
+ *   <!-- Or intercept any link/button directly: -->
+ *   <a href="/items/1" data-action="click->stimeo--confirm#request"
+ *      data-stimeo--confirm-message-param="Delete this item?">Delete</a>
+ *
+ * @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
+ * confirm/cancel resolution. On `connect()` it swaps `Turbo.config.forms.confirm`
+ * for a Promise-returning method and restores the original on `disconnect()` (Turbo
+ * navigation included), so registration never leaks or stacks. Escape cancels
+ * (returns `false`); when no dialog target exists it degrades to native
+ * `window.confirm`. The least-destructive button (cancel, by default) takes initial
+ * focus.
+ */
+declare class ConfirmController extends Controller<HTMLElement> {
+    #private;
+    static targets: string[];
+    static values: {
+        confirmLabel: {
+            type: StringConstructor;
+            default: string;
+        };
+        cancelLabel: {
+            type: StringConstructor;
+            default: string;
+        };
+        initialFocus: {
+            type: StringConstructor;
+            default: string;
+        };
+    };
+    static actions: readonly ["confirm", "cancel", "request"];
+    static events: readonly ["open", "resolve"];
+    readonly dialogTarget: HTMLElement;
+    readonly titleTarget: HTMLElement;
+    readonly messageTarget: HTMLElement;
+    readonly confirmTarget: HTMLElement;
+    readonly cancelTarget: HTMLElement;
+    readonly hasDialogTarget: boolean;
+    readonly hasMessageTarget: boolean;
+    readonly hasConfirmTarget: boolean;
+    readonly hasCancelTarget: boolean;
+    confirmLabelValue: string;
+    cancelLabelValue: string;
+    initialFocusValue: string;
+    connect(): void;
+    disconnect(): void;
+    /** Confirms the pending request (resolves `true`). Bound via `data-action`. */
+    confirm(): void;
+    /** Cancels the pending request (resolves `false`). Bound via `data-action`. */
+    cancel(): void;
+    /**
+     * Intercepts a link/button click, shows the confirm dialog, and continues the
+     * original action (form submit or navigation) only when confirmed. The message
+     * comes from the `message` action param or the element's `data-turbo-confirm`.
+     */
+    request(event: Event): void;
+}
+
+export { ConfirmController };

package/dist/controllers/confirm_controller.js

@@ -0,0 +1,276 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/confirm_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/confirm_controller.ts
+var ConfirmController = class extends Controller {
+  static targets = ["dialog", "title", "message", "confirm", "cancel"];
+  static values = {
+    confirmLabel: { type: String, default: "OK" },
+    cancelLabel: { type: String, default: "Cancel" },
+    initialFocus: { type: String, default: "cancel" }
+  };
+  static actions = ["confirm", "cancel", "request"];
+  static events = ["open", "resolve"];
+  /** Resolver for the in-flight confirmation Promise (one dialog at a time). */
+  #pending = null;
+  /** Turbo's forms config and its original confirm method, for restore. */
+  #turboForms = null;
+  #previousConfirm = void 0;
+  #trap = new FocusTrap(() => this.dialogTarget, {
+    onEscape: () => this.#resolve(false),
+    initialFocus: () => this.#initialFocusElement()
+  });
+  connect() {
+    if (this.hasDialogTarget) this.dialogTarget.hidden = true;
+    this.#installTurboHook();
+  }
+  disconnect() {
+    if (this.#turboForms) {
+      this.#turboForms.confirm = this.#previousConfirm;
+      this.#turboForms = null;
+    }
+    this.#resolve(false, false);
+    this.#trap.deactivate({ restoreFocus: false });
+  }
+  /** Confirms the pending request (resolves `true`). Bound via `data-action`. */
+  confirm() {
+    this.#resolve(true);
+  }
+  /** Cancels the pending request (resolves `false`). Bound via `data-action`. */
+  cancel() {
+    this.#resolve(false);
+  }
+  /**
+   * Intercepts a link/button click, shows the confirm dialog, and continues the
+   * original action (form submit or navigation) only when confirmed. The message
+   * comes from the `message` action param or the element's `data-turbo-confirm`.
+   */
+  request(event) {
+    const element = event.currentTarget ?? event.target;
+    if (!element) return;
+    event.preventDefault();
+    const params = event.params;
+    const fromParam = typeof params?.message === "string" ? params.message : null;
+    const message = fromParam ?? element.getAttribute("data-turbo-confirm") ?? "";
+    void this.#prompt(message).then((confirmed) => {
+      if (confirmed) this.#continue(element);
+    });
+  }
+  /**
+   * Opens the dialog for `message` and resolves once the user confirms or cancels.
+   * Degrades to native `window.confirm` when no dialog target is present.
+   */
+  #prompt(message) {
+    if (!this.hasDialogTarget) return Promise.resolve(window.confirm(message));
+    this.#resolve(false);
+    if (this.hasMessageTarget) this.messageTarget.textContent = message;
+    if (this.hasConfirmTarget) this.confirmTarget.textContent = this.confirmLabelValue;
+    if (this.hasCancelTarget) this.cancelTarget.textContent = this.cancelLabelValue;
+    return new Promise((resolve) => {
+      this.#pending = resolve;
+      this.dialogTarget.hidden = false;
+      this.dispatch("open", { detail: { message } });
+      this.#trap.activate();
+    });
+  }
+  /**
+   * Settles the pending Promise, closes the dialog, and emits `resolve`.
+   * `restoreFocus` is forwarded to the trap so teardown (disconnect) can settle a
+   * pending confirmation without moving focus.
+   */
+  #resolve(confirmed, restoreFocus = true) {
+    const pending = this.#pending;
+    if (!pending) return;
+    this.#pending = null;
+    if (this.hasDialogTarget) this.dialogTarget.hidden = true;
+    this.#trap.deactivate({ restoreFocus });
+    this.dispatch("resolve", { detail: { confirmed } });
+    pending(confirmed);
+  }
+  /** Continues the intercepted action when confirmed: submit a form, else navigate. */
+  #continue(element) {
+    if (element instanceof HTMLAnchorElement && element.href) {
+      window.location.href = element.href;
+      return;
+    }
+    const form = element instanceof HTMLFormElement ? element : element.closest("form");
+    if (form) {
+      form.requestSubmit(element instanceof HTMLButtonElement ? element : void 0);
+    }
+  }
+  /** Swaps Turbo's confirm method for a Promise-returning bridge to this dialog. */
+  #installTurboHook() {
+    const turbo = window.Turbo;
+    const forms = turbo?.config?.forms;
+    if (!forms) return;
+    this.#turboForms = forms;
+    this.#previousConfirm = forms.confirm;
+    forms.confirm = (message) => this.#prompt(message);
+  }
+  /** The button to focus on open — the least-destructive one (cancel) by default. */
+  #initialFocusElement() {
+    if (this.initialFocusValue === "confirm" && this.hasConfirmTarget) return this.confirmTarget;
+    return this.hasCancelTarget ? this.cancelTarget : null;
+  }
+};
+
+export { ConfirmController };
+//# sourceMappingURL=confirm_controller.js.map
+//# sourceMappingURL=confirm_controller.js.map

package/dist/controllers/confirm_controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/focus_trap.ts","../../src/controllers/confirm_controller.ts"],"names":[],"mappings":"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","file":"confirm_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/** The slice of Turbo's form config this controller swaps the confirm method on. */\ninterface TurboFormsConfig {\n  confirm?: (message: string, element?: HTMLElement) => boolean | Promise<boolean>;\n}\ninterface TurboLike {\n  config?: { forms?: TurboFormsConfig };\n}\n\n/**\n * Headless **confirm bridge** — replaces the native `window.confirm()` Turbo uses\n * for `data-turbo-confirm` with an accessible **Alert Dialog** (WAI-ARIA APG Alert\n * Dialog pattern). Reuses the shared {@link FocusTrap}; the consumer only writes the\n * dialog markup and \"what to do on confirm\".\n *\n * Markup contract (identifier: `stimeo--confirm`):\n *   <div data-controller=\"stimeo--confirm\">\n *     <div data-stimeo--confirm-target=\"dialog\" role=\"alertdialog\" aria-modal=\"true\"\n *          aria-labelledby=\"ct\" aria-describedby=\"cm\" hidden>\n *       <h2 id=\"ct\" data-stimeo--confirm-target=\"title\">Are you sure?</h2>\n *       <p id=\"cm\" data-stimeo--confirm-target=\"message\"></p>\n *       <button data-stimeo--confirm-target=\"cancel\"\n *               data-action=\"click->stimeo--confirm#cancel\"></button>\n *       <button data-stimeo--confirm-target=\"confirm\"\n *               data-action=\"click->stimeo--confirm#confirm\"></button>\n *     </div>\n *   </div>\n *\n *   <!-- Driven automatically through Turbo's confirm hook: -->\n *   <form data-turbo-confirm=\"Delete this item?\" action=\"/items/1\" method=\"post\">…</form>\n *   <!-- Or intercept any link/button directly: -->\n *   <a href=\"/items/1\" data-action=\"click->stimeo--confirm#request\"\n *      data-stimeo--confirm-message-param=\"Delete this item?\">Delete</a>\n *\n * @remarks\n * Behavior only — the dialog's a11y (focus trap, restore, roles) is delegated to\n * the shared {@link FocusTrap}; this controller adds the Turbo bridge and the\n * confirm/cancel resolution. On `connect()` it swaps `Turbo.config.forms.confirm`\n * for a Promise-returning method and restores the original on `disconnect()` (Turbo\n * navigation included), so registration never leaks or stacks. Escape cancels\n * (returns `false`); when no dialog target exists it degrades to native\n * `window.confirm`. The least-destructive button (cancel, by default) takes initial\n * focus.\n */\nexport class ConfirmController extends Controller<HTMLElement> {\n  static override targets = [\"dialog\", \"title\", \"message\", \"confirm\", \"cancel\"];\n  static override values = {\n    confirmLabel: { type: String, default: \"OK\" },\n    cancelLabel: { type: String, default: \"Cancel\" },\n    initialFocus: { type: String, default: \"cancel\" },\n  };\n  static actions = [\"confirm\", \"cancel\", \"request\"] as const;\n  static events = [\"open\", \"resolve\"] as const;\n\n  declare readonly dialogTarget: HTMLElement;\n  declare readonly titleTarget: HTMLElement;\n  declare readonly messageTarget: HTMLElement;\n  declare readonly confirmTarget: HTMLElement;\n  declare readonly cancelTarget: HTMLElement;\n  declare readonly hasDialogTarget: boolean;\n  declare readonly hasMessageTarget: boolean;\n  declare readonly hasConfirmTarget: boolean;\n  declare readonly hasCancelTarget: boolean;\n\n  declare confirmLabelValue: string;\n  declare cancelLabelValue: string;\n  declare initialFocusValue: string;\n\n  /** Resolver for the in-flight confirmation Promise (one dialog at a time). */\n  #pending: ((confirmed: boolean) => void) | null = null;\n  /** Turbo's forms config and its original confirm method, for restore. */\n  #turboForms: TurboFormsConfig | null = null;\n  #previousConfirm: TurboFormsConfig[\"confirm\"] = undefined;\n\n  readonly #trap = new FocusTrap(() => this.dialogTarget, {\n    onEscape: () => this.#resolve(false),\n    initialFocus: () => this.#initialFocusElement(),\n  });\n\n  override connect(): void {\n    if (this.hasDialogTarget) this.dialogTarget.hidden = true;\n    this.#installTurboHook();\n  }\n\n  override disconnect(): void {\n    if (this.#turboForms) {\n      this.#turboForms.confirm = this.#previousConfirm;\n      this.#turboForms = null;\n    }\n    // Settle any pending confirmation as cancelled WITHOUT restoring focus: a Turbo\n    // teardown must not move focus. The trailing deactivate covers the (defensive)\n    // case where the trap is active with nothing pending.\n    this.#resolve(false, false);\n    this.#trap.deactivate({ restoreFocus: false });\n  }\n\n  /** Confirms the pending request (resolves `true`). Bound via `data-action`. */\n  confirm(): void {\n    this.#resolve(true);\n  }\n\n  /** Cancels the pending request (resolves `false`). Bound via `data-action`. */\n  cancel(): void {\n    this.#resolve(false);\n  }\n\n  /**\n   * Intercepts a link/button click, shows the confirm dialog, and continues the\n   * original action (form submit or navigation) only when confirmed. The message\n   * comes from the `message` action param or the element's `data-turbo-confirm`.\n   */\n  request(event: Event): void {\n    const element = (event.currentTarget ?? event.target) as HTMLElement | null;\n    if (!element) return;\n    event.preventDefault();\n\n    const params = (event as { params?: Record<string, unknown> }).params;\n    const fromParam = typeof params?.message === \"string\" ? params.message : null;\n    const message = fromParam ?? element.getAttribute(\"data-turbo-confirm\") ?? \"\";\n\n    void this.#prompt(message).then((confirmed) => {\n      if (confirmed) this.#continue(element);\n    });\n  }\n\n  /**\n   * Opens the dialog for `message` and resolves once the user confirms or cancels.\n   * Degrades to native `window.confirm` when no dialog target is present.\n   */\n  #prompt(message: string): Promise<boolean> {\n    if (!this.hasDialogTarget) return Promise.resolve(window.confirm(message));\n    // A second prompt while one is open cancels the first to keep a single dialog.\n    this.#resolve(false);\n\n    if (this.hasMessageTarget) this.messageTarget.textContent = message;\n    if (this.hasConfirmTarget) this.confirmTarget.textContent = this.confirmLabelValue;\n    if (this.hasCancelTarget) this.cancelTarget.textContent = this.cancelLabelValue;\n\n    return new Promise<boolean>((resolve) => {\n      this.#pending = resolve;\n      this.dialogTarget.hidden = false;\n      this.dispatch(\"open\", { detail: { message } });\n      this.#trap.activate();\n    });\n  }\n\n  /**\n   * Settles the pending Promise, closes the dialog, and emits `resolve`.\n   * `restoreFocus` is forwarded to the trap so teardown (disconnect) can settle a\n   * pending confirmation without moving focus.\n   */\n  #resolve(confirmed: boolean, restoreFocus = true): void {\n    const pending = this.#pending;\n    if (!pending) return;\n    this.#pending = null;\n\n    if (this.hasDialogTarget) this.dialogTarget.hidden = true;\n    this.#trap.deactivate({ restoreFocus });\n    this.dispatch(\"resolve\", { detail: { confirmed } });\n    pending(confirmed);\n  }\n\n  /** Continues the intercepted action when confirmed: submit a form, else navigate. */\n  #continue(element: HTMLElement): void {\n    if (element instanceof HTMLAnchorElement && element.href) {\n      window.location.href = element.href;\n      return;\n    }\n    const form = element instanceof HTMLFormElement ? element : element.closest(\"form\");\n    if (form) {\n      form.requestSubmit(element instanceof HTMLButtonElement ? element : undefined);\n    }\n  }\n\n  /** Swaps Turbo's confirm method for a Promise-returning bridge to this dialog. */\n  #installTurboHook(): void {\n    const turbo = (window as Window & { Turbo?: TurboLike }).Turbo;\n    const forms = turbo?.config?.forms;\n    if (!forms) return;\n    this.#turboForms = forms;\n    this.#previousConfirm = forms.confirm;\n    forms.confirm = (message: string) => this.#prompt(message);\n  }\n\n  /** The button to focus on open — the least-destructive one (cancel) by default. */\n  #initialFocusElement(): HTMLElement | null {\n    if (this.initialFocusValue === \"confirm\" && this.hasConfirmTarget) return this.confirmTarget;\n    return this.hasCancelTarget ? this.cancelTarget : null;\n  }\n}\n"]}

package/dist/controllers/context_menu_controller.d.ts

@@ -0,0 +1,81 @@
+import { Controller } from '@hotwired/stimulus';
+
+/**
+ * Headless, accessible **context menu** behavior.
+ *
+ * Markup contract (identifier: `stimeo--context-menu`):
+ *   <div data-controller="stimeo--context-menu">
+ *     <div data-stimeo--context-menu-target="region" tabindex="0"
+ *          aria-haspopup="menu" aria-controls="ctx"
+ *          data-action="contextmenu->stimeo--context-menu#open
+ *                       keydown->stimeo--context-menu#onRegionKeydown">…</div>
+ *     <ul id="ctx" role="menu" data-stimeo--context-menu-target="menu" hidden>
+ *       <li role="none">
+ *         <button role="menuitem" tabindex="-1"
+ *                 data-stimeo--context-menu-target="item"
+ *                 data-action="click->stimeo--context-menu#activate
+ *                              keydown->stimeo--context-menu#onItemKeydown">…</button>
+ *       </li>
+ *     </ul>
+ *   </div>
+ *
+ * Implements the WAI-ARIA APG **Menu** pattern; the only differences from
+ * `stimeo--menu` are the *trigger* (a `contextmenu` event or `Shift+F10` /
+ * `ContextMenu` key, not a button click) and that the menu is shown at the
+ * pointer coordinate.
+ *
+ * @remarks
+ * Behavior only — the controller reflects the click coordinate as the CSS custom
+ * properties `--stimeo-context-menu-x` / `--stimeo-context-menu-y` on the menu
+ * so the consumer's CSS can place it (works standalone, no positioning module
+ * required). Viewport-edge flip/shift is delegated to the opt-in
+ * `stimeo-ui/positioning` module, which this controller never imports.
+ *
+ * Open state is exposed on the region as `data-state` (`open`/`closed`) — a CSS
+ * hook, not an ARIA one. `aria-expanded` is deliberately *not* set on the region
+ * because it is a generic container, not a role that supports that state (doing so
+ * is an ARIA violation); the region's static `aria-haspopup="menu"` advertises the
+ * popup, and assistive tech perceives the open state when focus moves into the
+ * `role="menu"`.
+ *
+ * Behavior provided:
+ * - `contextmenu` on the region suppresses the browser menu and opens this one at
+ *   the pointer; `Shift+F10` / `ContextMenu` opens it at the region's center.
+ * - On open, focus moves to the first item; the region's `data-state` syncs.
+ * - Roving focus inside the menu: `ArrowUp`/`ArrowDown` (wrapping), `Home`/`End`.
+ * - Activating an item (click / native `Enter`/`Space` on the button) closes the
+ *   menu and restores focus to the region.
+ * - `Escape` closes and restores focus to the region; `Tab` closes without
+ *   restoring (focus moves on naturally); an outside click closes.
+ *
+ * Roving focus skips items that are not navigable — `hidden`, natively
+ * `disabled`, or `aria-disabled="true"` — so the keyboard never lands focus on an
+ * inert command (matching `stimeo--menu` / `stimeo--command-palette`).
+ */
+declare class ContextMenuController extends Controller<HTMLElement> {
+    #private;
+    static targets: string[];
+    static actions: readonly ["activate", "onItemKeydown", "onRegionKeydown", "open"];
+    readonly regionTarget: HTMLElement;
+    readonly menuTarget: HTMLElement;
+    readonly itemTargets: HTMLButtonElement[];
+    readonly hasRegionTarget: boolean;
+    readonly hasMenuTarget: boolean;
+    /** Starts closed and registers the outside-click listener. */
+    connect(): void;
+    /** Removes the document-level listener registered in {@link connect}. */
+    disconnect(): void;
+    /**
+     * Opens the menu from a `contextmenu` event: suppresses the native menu and
+     * places this one at the pointer coordinate.
+     */
+    open(event: MouseEvent): void;
+    /** Keyboard entry on the region: `Shift+F10` / `ContextMenu` open at center. */
+    onRegionKeydown(event: KeyboardEvent): void;
+    /** Roving focus and closing keys inside the menu. */
+    onItemKeydown(event: KeyboardEvent): void;
+    /** Closes after an item is activated and restores focus to the region. */
+    activate(): void;
+}
+
+export { ContextMenuController };

package/dist/controllers/context_menu_controller.js

@@ -0,0 +1,112 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/context_menu_controller.ts
+var ContextMenuController = class extends Controller {
+  static targets = ["region", "menu", "item"];
+  static actions = ["activate", "onItemKeydown", "onRegionKeydown", "open"];
+  /** Starts closed and registers the outside-click listener. */
+  connect() {
+    this.#closeMenu();
+    document.addEventListener("click", this.#onOutsideClick);
+  }
+  /** Removes the document-level listener registered in {@link connect}. */
+  disconnect() {
+    document.removeEventListener("click", this.#onOutsideClick);
+  }
+  /**
+   * Opens the menu from a `contextmenu` event: suppresses the native menu and
+   * places this one at the pointer coordinate.
+   */
+  open(event) {
+    event.preventDefault();
+    this.#openAt(event.clientX, event.clientY);
+  }
+  /** Keyboard entry on the region: `Shift+F10` / `ContextMenu` open at center. */
+  onRegionKeydown(event) {
+    const isContextKey = event.key === "ContextMenu" || event.key === "F10" && event.shiftKey;
+    if (!isContextKey) return;
+    event.preventDefault();
+    const rect = this.hasRegionTarget ? this.regionTarget.getBoundingClientRect() : { left: 0, top: 0, width: 0, height: 0 };
+    this.#openAt(rect.left + rect.width / 2, rect.top + rect.height / 2);
+  }
+  /** Roving focus and closing keys inside the menu. */
+  onItemKeydown(event) {
+    const items = this.#navigableItems;
+    const currentIndex = items.indexOf(event.currentTarget);
+    switch (event.key) {
+      case "ArrowDown":
+        event.preventDefault();
+        if (items.length > 0) items[(currentIndex + 1) % items.length]?.focus();
+        break;
+      case "ArrowUp":
+        event.preventDefault();
+        if (items.length > 0) items[(currentIndex - 1 + items.length) % items.length]?.focus();
+        break;
+      case "Home":
+        event.preventDefault();
+        items[0]?.focus();
+        break;
+      case "End":
+        event.preventDefault();
+        items[items.length - 1]?.focus();
+        break;
+      case "Escape":
+        event.preventDefault();
+        this.#closeAndRestore();
+        break;
+      case "Tab":
+        this.#closeMenu();
+        break;
+    }
+  }
+  /** Closes after an item is activated and restores focus to the region. */
+  activate() {
+    this.#closeAndRestore();
+  }
+  /** Opens the menu at viewport coordinates `(x, y)` and focuses the first item. */
+  #openAt(x, y) {
+    if (!this.hasMenuTarget) return;
+    this.menuTarget.style.setProperty("--stimeo-context-menu-x", `${x}px`);
+    this.menuTarget.style.setProperty("--stimeo-context-menu-y", `${y}px`);
+    this.menuTarget.hidden = false;
+    if (this.hasRegionTarget) this.regionTarget.setAttribute("data-state", "open");
+    this.#navigableItems[0]?.focus();
+  }
+  /** Hides the menu and reflects the collapsed state on the region. */
+  #closeMenu() {
+    if (!this.hasMenuTarget) return;
+    this.menuTarget.hidden = true;
+    if (this.hasRegionTarget) this.regionTarget.setAttribute("data-state", "closed");
+  }
+  /** Closes the menu and returns focus to the region (Escape / activation). */
+  #closeAndRestore() {
+    this.#closeMenu();
+    if (this.hasRegionTarget) this.regionTarget.focus();
+  }
+  /** Closes the menu when a click lands outside the controller's element. */
+  #onOutsideClick = (event) => {
+    if (this.#isOpen && !this.element.contains(event.target)) this.#closeMenu();
+  };
+  /** Menu items eligible for roving focus (excludes disabled / hidden). */
+  get #navigableItems() {
+    return this.itemTargets.filter((item) => this.#isNavigable(item));
+  }
+  /**
+   * An item can take roving focus unless it is `hidden`, `aria-disabled="true"`,
+   * or a natively `disabled` form control. CSS-only visibility is not detectable
+   * here and is the consumer's responsibility.
+   */
+  #isNavigable(item) {
+    if (item.hasAttribute("hidden")) return false;
+    if (item.getAttribute("aria-disabled") === "true") return false;
+    return !item.disabled;
+  }
+  /** Whether the menu is currently visible. */
+  get #isOpen() {
+    return this.hasMenuTarget && !this.menuTarget.hidden;
+  }
+};
+
+export { ContextMenuController };
+//# sourceMappingURL=context_menu_controller.js.map
+//# sourceMappingURL=context_menu_controller.js.map

package/dist/controllers/context_menu_controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/controllers/context_menu_controller.ts"],"names":[],"mappings":"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","file":"context_menu_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\n\n/**\n * Headless, accessible **context menu** behavior.\n *\n * Markup contract (identifier: `stimeo--context-menu`):\n *   <div data-controller=\"stimeo--context-menu\">\n *     <div data-stimeo--context-menu-target=\"region\" tabindex=\"0\"\n *          aria-haspopup=\"menu\" aria-controls=\"ctx\"\n *          data-action=\"contextmenu->stimeo--context-menu#open\n *                       keydown->stimeo--context-menu#onRegionKeydown\">…</div>\n *     <ul id=\"ctx\" role=\"menu\" data-stimeo--context-menu-target=\"menu\" hidden>\n *       <li role=\"none\">\n *         <button role=\"menuitem\" tabindex=\"-1\"\n *                 data-stimeo--context-menu-target=\"item\"\n *                 data-action=\"click->stimeo--context-menu#activate\n *                              keydown->stimeo--context-menu#onItemKeydown\">…</button>\n *       </li>\n *     </ul>\n *   </div>\n *\n * Implements the WAI-ARIA APG **Menu** pattern; the only differences from\n * `stimeo--menu` are the *trigger* (a `contextmenu` event or `Shift+F10` /\n * `ContextMenu` key, not a button click) and that the menu is shown at the\n * pointer coordinate.\n *\n * @remarks\n * Behavior only — the controller reflects the click coordinate as the CSS custom\n * properties `--stimeo-context-menu-x` / `--stimeo-context-menu-y` on the menu\n * so the consumer's CSS can place it (works standalone, no positioning module\n * required). Viewport-edge flip/shift is delegated to the opt-in\n * `stimeo-ui/positioning` module, which this controller never imports.\n *\n * Open state is exposed on the region as `data-state` (`open`/`closed`) — a CSS\n * hook, not an ARIA one. `aria-expanded` is deliberately *not* set on the region\n * because it is a generic container, not a role that supports that state (doing so\n * is an ARIA violation); the region's static `aria-haspopup=\"menu\"` advertises the\n * popup, and assistive tech perceives the open state when focus moves into the\n * `role=\"menu\"`.\n *\n * Behavior provided:\n * - `contextmenu` on the region suppresses the browser menu and opens this one at\n *   the pointer; `Shift+F10` / `ContextMenu` opens it at the region's center.\n * - On open, focus moves to the first item; the region's `data-state` syncs.\n * - Roving focus inside the menu: `ArrowUp`/`ArrowDown` (wrapping), `Home`/`End`.\n * - Activating an item (click / native `Enter`/`Space` on the button) closes the\n *   menu and restores focus to the region.\n * - `Escape` closes and restores focus to the region; `Tab` closes without\n *   restoring (focus moves on naturally); an outside click closes.\n *\n * Roving focus skips items that are not navigable — `hidden`, natively\n * `disabled`, or `aria-disabled=\"true\"` — so the keyboard never lands focus on an\n * inert command (matching `stimeo--menu` / `stimeo--command-palette`).\n */\nexport class ContextMenuController extends Controller<HTMLElement> {\n  static override targets = [\"region\", \"menu\", \"item\"];\n  static actions = [\"activate\", \"onItemKeydown\", \"onRegionKeydown\", \"open\"] as const;\n\n  declare readonly regionTarget: HTMLElement;\n  declare readonly menuTarget: HTMLElement;\n  declare readonly itemTargets: HTMLButtonElement[];\n  declare readonly hasRegionTarget: boolean;\n  declare readonly hasMenuTarget: boolean;\n\n  /** Starts closed and registers the outside-click listener. */\n  override connect(): void {\n    this.#closeMenu();\n    document.addEventListener(\"click\", this.#onOutsideClick);\n  }\n\n  /** Removes the document-level listener registered in {@link connect}. */\n  override disconnect(): void {\n    document.removeEventListener(\"click\", this.#onOutsideClick);\n  }\n\n  /**\n   * Opens the menu from a `contextmenu` event: suppresses the native menu and\n   * places this one at the pointer coordinate.\n   */\n  open(event: MouseEvent): void {\n    event.preventDefault();\n    this.#openAt(event.clientX, event.clientY);\n  }\n\n  /** Keyboard entry on the region: `Shift+F10` / `ContextMenu` open at center. */\n  onRegionKeydown(event: KeyboardEvent): void {\n    const isContextKey = event.key === \"ContextMenu\" || (event.key === \"F10\" && event.shiftKey);\n    if (!isContextKey) return;\n    event.preventDefault();\n    const rect = this.hasRegionTarget\n      ? this.regionTarget.getBoundingClientRect()\n      : { left: 0, top: 0, width: 0, height: 0 };\n    this.#openAt(rect.left + rect.width / 2, rect.top + rect.height / 2);\n  }\n\n  /** Roving focus and closing keys inside the menu. */\n  onItemKeydown(event: KeyboardEvent): void {\n    const items = this.#navigableItems;\n    const currentIndex = items.indexOf(event.currentTarget as HTMLButtonElement);\n\n    switch (event.key) {\n      case \"ArrowDown\":\n        event.preventDefault();\n        if (items.length > 0) items[(currentIndex + 1) % items.length]?.focus();\n        break;\n      case \"ArrowUp\":\n        event.preventDefault();\n        if (items.length > 0) items[(currentIndex - 1 + items.length) % items.length]?.focus();\n        break;\n      case \"Home\":\n        event.preventDefault();\n        items[0]?.focus();\n        break;\n      case \"End\":\n        event.preventDefault();\n        items[items.length - 1]?.focus();\n        break;\n      case \"Escape\":\n        event.preventDefault();\n        this.#closeAndRestore();\n        break;\n      case \"Tab\":\n        // Per APG, Tab closes the menu but lets focus move on naturally.\n        this.#closeMenu();\n        break;\n      default:\n        break;\n    }\n  }\n\n  /** Closes after an item is activated and restores focus to the region. */\n  activate(): void {\n    this.#closeAndRestore();\n  }\n\n  /** Opens the menu at viewport coordinates `(x, y)` and focuses the first item. */\n  #openAt(x: number, y: number): void {\n    if (!this.hasMenuTarget) return;\n    this.menuTarget.style.setProperty(\"--stimeo-context-menu-x\", `${x}px`);\n    this.menuTarget.style.setProperty(\"--stimeo-context-menu-y\", `${y}px`);\n    this.menuTarget.hidden = false;\n    if (this.hasRegionTarget) this.regionTarget.setAttribute(\"data-state\", \"open\");\n    this.#navigableItems[0]?.focus();\n  }\n\n  /** Hides the menu and reflects the collapsed state on the region. */\n  #closeMenu(): void {\n    if (!this.hasMenuTarget) return;\n    this.menuTarget.hidden = true;\n    if (this.hasRegionTarget) this.regionTarget.setAttribute(\"data-state\", \"closed\");\n  }\n\n  /** Closes the menu and returns focus to the region (Escape / activation). */\n  #closeAndRestore(): void {\n    this.#closeMenu();\n    if (this.hasRegionTarget) this.regionTarget.focus();\n  }\n\n  /** Closes the menu when a click lands outside the controller's element. */\n  readonly #onOutsideClick = (event: MouseEvent): void => {\n    if (this.#isOpen && !this.element.contains(event.target as Node)) this.#closeMenu();\n  };\n\n  /** Menu items eligible for roving focus (excludes disabled / hidden). */\n  get #navigableItems(): HTMLButtonElement[] {\n    return this.itemTargets.filter((item) => this.#isNavigable(item));\n  }\n\n  /**\n   * An item can take roving focus unless it is `hidden`, `aria-disabled=\"true\"`,\n   * or a natively `disabled` form control. CSS-only visibility is not detectable\n   * here and is the consumer's responsibility.\n   */\n  #isNavigable(item: HTMLButtonElement): boolean {\n    if (item.hasAttribute(\"hidden\")) return false;\n    if (item.getAttribute(\"aria-disabled\") === \"true\") return false;\n    return !item.disabled;\n  }\n\n  /** Whether the menu is currently visible. */\n  get #isOpen(): boolean {\n    return this.hasMenuTarget && !this.menuTarget.hidden;\n  }\n}\n"]}