stimeo-ui 0.2.0 → 0.2.1

package/dist/controllers/menubar_controller.d.ts

@@ -0,0 +1,62 @@
+import { Controller } from '@hotwired/stimulus';
+
+/**
+ * Headless, accessible **menubar** behavior.
+ *
+ * Markup contract (identifier: `stimeo--menubar`):
+ *   <div data-controller="stimeo--menubar" role="menubar" aria-label="Main">
+ *     <button role="menuitem" aria-haspopup="menu" aria-expanded="false"
+ *             aria-controls="m-file" data-stimeo--menubar-target="top"
+ *             data-action="click->stimeo--menubar#toggle
+ *                          keydown->stimeo--menubar#onTopKeydown">File</button>
+ *     <ul id="m-file" role="menu" data-stimeo--menubar-target="menu" hidden>
+ *       <li role="none">
+ *         <button role="menuitem" tabindex="-1" data-stimeo--menubar-target="item"
+ *                 data-action="click->stimeo--menubar#activate
+ *                              keydown->stimeo--menubar#onItemKeydown">New</button>
+ *       </li>
+ *     </ul>
+ *     <!-- more top items + menus -->
+ *   </div>
+ *
+ * Implements the WAI-ARIA APG **Menubar** pattern (single level): the top items
+ * form one Tab stop via roving tabindex and the arrow keys move between them;
+ * `ArrowDown`/`Enter`/`Space` open a menu (`ArrowUp` opens it at the last item),
+ * the arrow keys then move within the menu, and pressing `ArrowLeft`/`ArrowRight`
+ * while a menu is open jumps to the adjacent top menu. `Escape` closes and
+ * returns focus to the owning top item — while a menu is open the menubar is a
+ * layer on the shared {@link EscapeLayer} stack, claiming a press only while
+ * focus is inside the controller or fell to the body, so one keypress closes
+ * exactly one layer (the shared layered-Escape contract). `Tab` and an outside
+ * click close.
+ *
+ * @remarks
+ * Behavior only. Each top item↔menu pair is linked by `aria-controls`/`id` (not by
+ * position), so the markup order is free. Menu placement and viewport-edge
+ * collision are out of scope — static placement is the consumer's CSS, and dynamic
+ * placement is delegated to the opt-in `stimeo-ui/positioning` module (never
+ * imported here, keeping the core zero-dependency). Roving mechanics across the top
+ * items are delegated to {@link RovingTabindex}.
+ */
+declare class MenubarController extends Controller<HTMLElement> {
+    #private;
+    static targets: string[];
+    static actions: readonly ["activate", "onItemKeydown", "onTopKeydown", "toggle"];
+    readonly topTargets: HTMLElement[];
+    readonly menuTargets: HTMLElement[];
+    readonly itemTargets: HTMLElement[];
+    /** Establishes the single tab stop and the closed baseline. */
+    connect(): void;
+    /** Removes the document listener, stack membership, and any pending typeahead timer. */
+    disconnect(): void;
+    /** Toggles a top item's menu. Bound via `data-action` (click on the top item). */
+    toggle(event: Event): void;
+    /** Keyboard handling while focus is on a top item. */
+    onTopKeydown(event: KeyboardEvent): void;
+    /** Keyboard handling while focus is on a menu item. */
+    onItemKeydown(event: KeyboardEvent): void;
+    /** Closes the owning menu after an item is activated and refocuses its top. */
+    activate(event: Event): void;
+}
+
+export { MenubarController };

package/dist/controllers/menubar_controller.js

@@ -0,0 +1,433 @@
+import { Controller } from '@hotwired/stimulus';
+
+// src/controllers/menubar_controller.ts
+
+// src/utils/escape_layer.ts
+function claimsWhileFocusWithin(element) {
+  return () => {
+    const active = element.ownerDocument.activeElement;
+    return active === null || active === element.ownerDocument.body || element.contains(active);
+  };
+}
+var EscapeLayer = class _EscapeLayer {
+  static #registries = /* @__PURE__ */ new WeakMap();
+  #ownerDocument = null;
+  /** Dismissal callback while active; `null` when inactive. */
+  #onDismiss = null;
+  /** Live predicate deciding whether the layer claims a press; `null` = always. */
+  #claims = null;
+  /**
+   * Activates this layer at the top of its document's Escape stack, installing
+   * the document's shared resolver listener if this is its first layer.
+   * Re-activating an already-active layer moves it to the top.
+   */
+  activate(ownerDocument = document, options) {
+    this.deactivate();
+    let registry = _EscapeLayer.#registries.get(ownerDocument);
+    if (!registry) {
+      registry = _EscapeLayer.#createRegistry();
+      _EscapeLayer.#registries.set(ownerDocument, registry);
+      ownerDocument.addEventListener("keydown", registry.onKeydown);
+    }
+    registry.stack.push(this);
+    this.#ownerDocument = ownerDocument;
+    this.#onDismiss = options.onDismiss;
+    this.#claims = options.claims ?? null;
+  }
+  /**
+   * Removes this layer from its document's Escape stack, uninstalling the
+   * shared listener when the stack empties. Safe to call when inactive.
+   */
+  deactivate() {
+    const ownerDocument = this.#ownerDocument;
+    if (!ownerDocument) return;
+    const registry = _EscapeLayer.#registries.get(ownerDocument);
+    if (registry) {
+      const index = registry.stack.lastIndexOf(this);
+      if (index >= 0) registry.stack.splice(index, 1);
+      if (registry.stack.length === 0) {
+        ownerDocument.removeEventListener("keydown", registry.onKeydown);
+        _EscapeLayer.#registries.delete(ownerDocument);
+      }
+    }
+    this.#ownerDocument = null;
+    this.#onDismiss = null;
+    this.#claims = null;
+  }
+  /**
+   * Whether this active layer would own a press right now: it is the topmost
+   * layer whose {@link EscapeLayerOptions.claims} passes. Exposed for tests
+   * and diagnostics — production dismissal goes through the shared listener.
+   */
+  get ownsEscape() {
+    const ownerDocument = this.#ownerDocument;
+    if (!ownerDocument) return false;
+    const registry = _EscapeLayer.#registries.get(ownerDocument);
+    if (!registry) return false;
+    return _EscapeLayer.#resolveOwner(registry.stack) === this;
+  }
+  /** Builds a document's registry with its shared resolver listener. */
+  static #createRegistry() {
+    const registry = {
+      stack: [],
+      onKeydown: (event) => {
+        if (event.key !== "Escape" || event.defaultPrevented || event.isComposing) return;
+        const owner = _EscapeLayer.#resolveOwner(registry.stack);
+        if (!owner) return;
+        event.preventDefault();
+        owner.#onDismiss?.();
+      }
+    };
+    return registry;
+  }
+  /** The topmost stack layer whose claims predicate passes, or `null`. */
+  static #resolveOwner(stack) {
+    for (let index = stack.length - 1; index >= 0; index--) {
+      const layer = stack[index];
+      if (!layer) continue;
+      if (layer.#claims && !layer.#claims()) continue;
+      return layer;
+    }
+    return null;
+  }
+};
+
+// src/utils/roving_tabindex.ts
+var RovingTabindex = class {
+  /** Returns the current ordered item elements; called on every operation. */
+  #getItems;
+  /**
+   * @param getItems - Returns the current ordered item elements. Called on every
+   *   operation so the live target list is always used.
+   */
+  constructor(getItems) {
+    this.#getItems = getItems;
+  }
+  /** Index of the currently tabbable item (`tabindex="0"`), or `-1` if none. */
+  get activeIndex() {
+    return this.#getItems().findIndex((item) => item.tabIndex === 0);
+  }
+  /**
+   * Makes exactly the item at `index` tabbable (`tabindex="0"`) and removes every
+   * other item from the Tab sequence (`tabindex="-1"`). An out-of-range `index`
+   * (e.g. `-1`) leaves all items at `-1`, which a controller can use to express
+   * "nothing is currently tabbable".
+   *
+   * @param index - Position of the item to make tabbable.
+   * @param options - Pass `{ focus: true }` to also move DOM focus to that item.
+   */
+  setActive(index, { focus = false } = {}) {
+    const items = this.#getItems();
+    items.forEach((item, i) => {
+      item.tabIndex = i === index ? 0 : -1;
+    });
+    if (focus) items[index]?.focus();
+  }
+};
+
+// src/utils/safe_timeout.ts
+var TimerRegistry = class {
+  /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */
+  ids = /* @__PURE__ */ new Set();
+  /**
+   * Cancels a single tracked timer.
+   *
+   * No-ops if the id is unknown (already cleared, fired, or never owned by this
+   * registry), so callers can clear defensively without guarding.
+   */
+  clear(id) {
+    if (this.ids.delete(id)) {
+      this.cancel(id);
+    }
+  }
+  /**
+   * Cancels every tracked timer. Call this from a controller's `disconnect()`
+   * to guarantee no timer outlives the element.
+   */
+  clearAll() {
+    for (const id of this.ids) {
+      this.cancel(id);
+    }
+    this.ids.clear();
+  }
+  /** Number of timers currently tracked (pending). */
+  get size() {
+    return this.ids.size;
+  }
+};
+var SafeTimeout = class extends TimerRegistry {
+  /**
+   * Schedules `callback` after `delay` ms and returns the timer id.
+   *
+   * The id is removed from the registry automatically when the timeout fires,
+   * so {@link TimerRegistry.size | size} reflects only still-pending timers.
+   */
+  set(callback, delay) {
+    const id = this.schedule(() => {
+      this.ids.delete(id);
+      callback();
+    }, delay);
+    this.ids.add(id);
+    return id;
+  }
+  schedule(callback, delay) {
+    return window.setTimeout(callback, delay);
+  }
+  cancel(id) {
+    window.clearTimeout(id);
+  }
+};
+
+// src/controllers/menubar_controller.ts
+var TYPEAHEAD_RESET_MS = 500;
+var MenubarController = class extends Controller {
+  static targets = ["top", "menu", "item"];
+  static actions = ["activate", "onItemKeydown", "onTopKeydown", "toggle"];
+  /** Roving tabindex across the top-level menuitems (one Tab stop). */
+  #roving = new RovingTabindex(() => this.topTargets);
+  /** Typeahead buffer and its idle-reset timer (scoped to the open menu). */
+  #typeahead = "";
+  #typeaheadId = 0;
+  #timers = new SafeTimeout();
+  /** Escape-stack membership while a menu is open; the shared resolver dismisses via it. */
+  #escapeLayer = new EscapeLayer();
+  /** Establishes the single tab stop and the closed baseline. */
+  connect() {
+    const active = this.#roving.activeIndex;
+    this.#roving.setActive(active === -1 ? 0 : active);
+    this.#closeAllMenus();
+    document.addEventListener("click", this.#onOutsideClick);
+  }
+  /** Removes the document listener, stack membership, and any pending typeahead timer. */
+  disconnect() {
+    this.#escapeLayer.deactivate();
+    document.removeEventListener("click", this.#onOutsideClick);
+    this.#timers.clearAll();
+  }
+  /** Toggles a top item's menu. Bound via `data-action` (click on the top item). */
+  toggle(event) {
+    const top = event.currentTarget;
+    if (this.#isExpanded(top)) {
+      this.#closeMenu(top);
+    } else {
+      this.#openMenu(top, "first");
+    }
+  }
+  /** Keyboard handling while focus is on a top item. */
+  onTopKeydown(event) {
+    const tops = this.topTargets;
+    const index = tops.indexOf(event.currentTarget);
+    if (index === -1) return;
+    const length = tops.length;
+    const anyOpen = this.#isAnyOpen;
+    switch (event.key) {
+      case "ArrowRight":
+        event.preventDefault();
+        this.#gotoTop((index + 1) % length, anyOpen);
+        break;
+      case "ArrowLeft":
+        event.preventDefault();
+        this.#gotoTop((index - 1 + length) % length, anyOpen);
+        break;
+      case "ArrowDown":
+        event.preventDefault();
+        this.#openMenu(tops[index], "first");
+        break;
+      case "ArrowUp":
+        event.preventDefault();
+        this.#openMenu(tops[index], "last");
+        break;
+      case "Home":
+        event.preventDefault();
+        this.#gotoTop(0, anyOpen);
+        break;
+      case "End":
+        event.preventDefault();
+        this.#gotoTop(length - 1, anyOpen);
+        break;
+    }
+  }
+  /** Keyboard handling while focus is on a menu item. */
+  onItemKeydown(event) {
+    const item = event.currentTarget;
+    const menu = item.closest("[role='menu']");
+    if (!menu) return;
+    const items = this.#itemsIn(menu);
+    const index = items.indexOf(item);
+    const length = items.length;
+    switch (event.key) {
+      case "ArrowDown":
+        event.preventDefault();
+        this.#focusAt(items, (index + 1) % length);
+        break;
+      case "ArrowUp":
+        event.preventDefault();
+        this.#focusAt(items, (index - 1 + length) % length);
+        break;
+      case "Home":
+        event.preventDefault();
+        this.#focusAt(items, 0);
+        break;
+      case "End":
+        event.preventDefault();
+        this.#focusAt(items, length - 1);
+        break;
+      case "ArrowRight":
+        event.preventDefault();
+        this.#moveToAdjacentMenu(menu, 1);
+        break;
+      case "ArrowLeft":
+        event.preventDefault();
+        this.#moveToAdjacentMenu(menu, -1);
+        break;
+      case "Tab":
+        this.#closeAllMenus();
+        break;
+      default:
+        if (this.#isTypeaheadKey(event)) {
+          event.preventDefault();
+          this.#typeaheadTo(items, index, event.key);
+        }
+        break;
+    }
+  }
+  /** Closes the owning menu after an item is activated and refocuses its top. */
+  activate(event) {
+    const item = event.currentTarget;
+    const menu = item.closest("[role='menu']");
+    const top = this.#topFor(menu);
+    this.#closeAllMenus();
+    this.#focusTop(top);
+  }
+  /** Moves the roving focus to top `index`, opening its menu when one was open. */
+  #gotoTop(index, reopen) {
+    const top = this.topTargets[index];
+    if (!top) return;
+    if (reopen) {
+      this.#openMenu(top, "first");
+    } else {
+      this.#roving.setActive(index, { focus: true });
+    }
+  }
+  /** Opens `top`'s menu (closing others) and focuses its first/last item. */
+  #openMenu(top, focus) {
+    if (!top) return;
+    this.#closeAllMenus();
+    const menu = this.#menuFor(top);
+    if (!menu) return;
+    menu.hidden = false;
+    top.setAttribute("aria-expanded", "true");
+    this.#escapeLayer.activate(document, {
+      onDismiss: () => this.#dismissOpenMenu(),
+      claims: claimsWhileFocusWithin(this.element)
+    });
+    this.#roving.setActive(this.topTargets.indexOf(top));
+    const items = this.#itemsIn(menu);
+    this.#focusAt(items, focus === "first" ? 0 : items.length - 1);
+  }
+  /** Hides `top`'s menu and reflects the collapsed state. */
+  #closeMenu(top) {
+    if (!top) return;
+    const menu = this.#menuFor(top);
+    if (menu) menu.hidden = true;
+    top.setAttribute("aria-expanded", "false");
+    if (!this.#isAnyOpen) this.#escapeLayer.deactivate();
+  }
+  /** Closes every menu and resets the typeahead buffer. */
+  #closeAllMenus() {
+    for (const top of this.topTargets) this.#closeMenu(top);
+    this.#resetTypeahead();
+  }
+  /**
+   * Escape path, invoked by the shared resolver: pressed inside an open menu it
+   * closes that menu and returns focus to its top item (the APG behavior);
+   * pressed while focus is on a top item (or fell to the body) it closes every
+   * menu without moving focus.
+   */
+  #dismissOpenMenu() {
+    const active = document.activeElement;
+    const menu = this.menuTargets.find((candidate) => candidate.contains(active));
+    if (menu) {
+      const top = this.#topFor(menu);
+      this.#closeMenu(top);
+      this.#focusTop(top);
+      return;
+    }
+    this.#closeAllMenus();
+  }
+  /** Opens the menu of the top item `delta` steps from the one owning `menu`. */
+  #moveToAdjacentMenu(menu, delta) {
+    const top = this.#topFor(menu);
+    if (!top) return;
+    const tops = this.topTargets;
+    const next = (tops.indexOf(top) + delta + tops.length) % tops.length;
+    this.#openMenu(tops[next], "first");
+  }
+  /** Closes when a click lands outside the controller's element. */
+  #onOutsideClick = (event) => {
+    if (this.#isAnyOpen && !this.element.contains(event.target)) this.#closeAllMenus();
+  };
+  /** The menu element controlled by `top` (matched by `aria-controls`/`id`). */
+  #menuFor(top) {
+    const id = top.getAttribute("aria-controls");
+    return id ? this.menuTargets.find((menu) => menu.id === id) ?? null : null;
+  }
+  /** The top item that controls `menu` (reverse of `#menuFor`). */
+  #topFor(menu) {
+    if (!menu) return null;
+    return this.topTargets.find((top) => top.getAttribute("aria-controls") === menu.id) ?? null;
+  }
+  /** The item targets that live inside `menu`, in DOM order. */
+  #itemsIn(menu) {
+    return this.itemTargets.filter((item) => menu.contains(item));
+  }
+  /** Moves DOM focus to the item at `index` (no-op if out of range). */
+  #focusAt(items, index) {
+    items[index]?.focus();
+  }
+  /** Returns roving focus to a top item (and makes it the single tab stop). */
+  #focusTop(top) {
+    if (!top) return;
+    this.#roving.setActive(this.topTargets.indexOf(top), { focus: true });
+  }
+  /** Whether `top`'s menu is currently expanded. */
+  #isExpanded(top) {
+    return top.getAttribute("aria-expanded") === "true";
+  }
+  /** Whether any top item's menu is currently open. */
+  get #isAnyOpen() {
+    return this.topTargets.some((top) => this.#isExpanded(top));
+  }
+  /**
+   * Whether the event is a single printable character usable for typeahead.
+   * `Space` is excluded: on a `<button>` menuitem it natively activates the item
+   * (Enter/Space → click), so swallowing it for typeahead would break activation.
+   */
+  #isTypeaheadKey(event) {
+    return event.key.length === 1 && event.key !== " " && !event.ctrlKey && !event.metaKey && !event.altKey;
+  }
+  /** Advances focus to the next item in `items` matching the accumulated buffer. */
+  #typeaheadTo(items, current, key) {
+    this.#typeahead += key.toLowerCase();
+    this.#timers.clear(this.#typeaheadId);
+    this.#typeaheadId = this.#timers.set(() => this.#resetTypeahead(), TYPEAHEAD_RESET_MS);
+    const count = items.length;
+    for (let step = 1; step <= count; step++) {
+      const candidate = items[(current + step) % count];
+      const label = (candidate?.textContent ?? "").trim().toLowerCase();
+      if (label.startsWith(this.#typeahead)) {
+        candidate?.focus();
+        return;
+      }
+    }
+  }
+  /** Clears the typeahead buffer and its timer. */
+  #resetTypeahead() {
+    this.#typeahead = "";
+    this.#timers.clear(this.#typeaheadId);
+  }
+};
+
+export { MenubarController };
+//# sourceMappingURL=menubar_controller.js.map
+//# sourceMappingURL=menubar_controller.js.map

package/dist/controllers/menubar_controller.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/escape_layer.ts","../../src/utils/roving_tabindex.ts","../../src/utils/safe_timeout.ts","../../src/controllers/menubar_controller.ts"],"names":[],"mappings":"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","file":"menubar_controller.js","sourcesContent":["/**\n * Single resolver for layered Escape dismissal.\n *\n * Every Escape-dismissable overlay layer (modal focus traps, disclosure\n * overlays like dropdown/popover/menu, and hover-triggered transient layers)\n * registers here while it is open. One document-level listener per document\n * resolves each press to exactly one owner and invokes that layer's\n * {@link EscapeLayerOptions.onDismiss} — controllers never listen for a\n * dismissing Escape themselves.\n *\n * @remarks\n * Each document owns an activation-ordered stack. The owner of a press is the\n * **topmost layer whose {@link EscapeLayerOptions.claims} passes**; a layer\n * that declines is transparent, so a background overlay opened behind a modal\n * never blocks it. Because a layer opened from within another is necessarily\n * activated later, LIFO order is also inner-first for nested layers — no DOM\n * inspection is needed.\n *\n * The shared listener runs in the document bubble phase and honors\n * `event.defaultPrevented`, so an element-level widget handler that consumes\n * Escape first (an editor cancelling its edit, a combobox closing its list)\n * always wins over every registered layer — the deepest-first half of the\n * shared layered-Escape contract. A keydown that is part of an IME composition\n * (`event.isComposing`) cancels the composition, never a layer, and is ignored\n * here for every layer at once.\n *\n * A WeakMap keeps documents collectible; the listener is installed only while\n * a document's stack is non-empty, and controller lifecycle hooks guarantee\n * that disconnected layers never remain registered.\n */\n\n/** Behavior a layer registers when it activates. */\nexport interface EscapeLayerOptions {\n  /**\n   * Dismisses the layer. Called by the shared resolver when this layer owns a\n   * press; the resolver has already consumed the event (`preventDefault()`),\n   * so the callback only needs to close and place focus per the widget's\n   * contract.\n   */\n  onDismiss: () => void;\n  /**\n   * Whether the layer claims the current press. Evaluated per press, so it can\n   * depend on live state (e.g. \"focus is inside me or fell to the body\"). A\n   * declining layer is skipped and the next layer down is consulted; omitting\n   * it means the layer always claims while active.\n   */\n  claims?: () => boolean;\n}\n\n/** A document's stack plus the one shared listener bound to it. */\ninterface EscapeLayerRegistry {\n  stack: EscapeLayer[];\n  onKeydown: (event: KeyboardEvent) => void;\n}\n\n/**\n * Claims predicate shared by the click-opened disclosure overlays (dropdown /\n * popover / navigation-menu / menu / context-menu / menubar): the layer claims\n * a press while focus is inside `element`, or after focus fell to the body —\n * a click on non-focusable overlay content blurs to `<body>`, and Escape must\n * still close the overlay (the \"body-focus rescue\"). A press made after focus\n * moved to another interactive element is declined, so closing never yanks\n * focus away from where the user deliberately went.\n */\nexport function claimsWhileFocusWithin(element: Element): () => boolean {\n  return () => {\n    const active = element.ownerDocument.activeElement;\n    return active === null || active === element.ownerDocument.body || element.contains(active);\n  };\n}\n\nexport class EscapeLayer {\n  static readonly #registries = new WeakMap<Document, EscapeLayerRegistry>();\n\n  #ownerDocument: Document | null = null;\n  /** Dismissal callback while active; `null` when inactive. */\n  #onDismiss: (() => void) | null = null;\n  /** Live predicate deciding whether the layer claims a press; `null` = always. */\n  #claims: (() => boolean) | null = null;\n\n  /**\n   * Activates this layer at the top of its document's Escape stack, installing\n   * the document's shared resolver listener if this is its first layer.\n   * Re-activating an already-active layer moves it to the top.\n   */\n  activate(ownerDocument: Document = document, options: EscapeLayerOptions): void {\n    this.deactivate();\n    let registry = EscapeLayer.#registries.get(ownerDocument);\n    if (!registry) {\n      registry = EscapeLayer.#createRegistry();\n      EscapeLayer.#registries.set(ownerDocument, registry);\n      ownerDocument.addEventListener(\"keydown\", registry.onKeydown);\n    }\n    registry.stack.push(this);\n    this.#ownerDocument = ownerDocument;\n    this.#onDismiss = options.onDismiss;\n    this.#claims = options.claims ?? null;\n  }\n\n  /**\n   * Removes this layer from its document's Escape stack, uninstalling the\n   * shared listener when the stack empties. Safe to call when inactive.\n   */\n  deactivate(): void {\n    const ownerDocument = this.#ownerDocument;\n    if (!ownerDocument) return;\n\n    const registry = EscapeLayer.#registries.get(ownerDocument);\n    if (registry) {\n      const index = registry.stack.lastIndexOf(this);\n      if (index >= 0) registry.stack.splice(index, 1);\n      if (registry.stack.length === 0) {\n        ownerDocument.removeEventListener(\"keydown\", registry.onKeydown);\n        EscapeLayer.#registries.delete(ownerDocument);\n      }\n    }\n    this.#ownerDocument = null;\n    this.#onDismiss = null;\n    this.#claims = null;\n  }\n\n  /**\n   * Whether this active layer would own a press right now: it is the topmost\n   * layer whose {@link EscapeLayerOptions.claims} passes. Exposed for tests\n   * and diagnostics — production dismissal goes through the shared listener.\n   */\n  get ownsEscape(): boolean {\n    const ownerDocument = this.#ownerDocument;\n    if (!ownerDocument) return false;\n    const registry = EscapeLayer.#registries.get(ownerDocument);\n    if (!registry) return false;\n    return EscapeLayer.#resolveOwner(registry.stack) === this;\n  }\n\n  /** Builds a document's registry with its shared resolver listener. */\n  static #createRegistry(): EscapeLayerRegistry {\n    const registry: EscapeLayerRegistry = {\n      stack: [],\n      onKeydown: (event: KeyboardEvent): void => {\n        if (event.key !== \"Escape\" || event.defaultPrevented || event.isComposing) return;\n        const owner = EscapeLayer.#resolveOwner(registry.stack);\n        if (!owner) return;\n        event.preventDefault();\n        owner.#onDismiss?.();\n      },\n    };\n    return registry;\n  }\n\n  /** The topmost stack layer whose claims predicate passes, or `null`. */\n  static #resolveOwner(stack: EscapeLayer[]): EscapeLayer | null {\n    for (let index = stack.length - 1; index >= 0; index--) {\n      const layer = stack[index];\n      if (!layer) continue;\n      if (layer.#claims && !layer.#claims()) continue;\n      return layer;\n    }\n    return null;\n  }\n}\n","/**\n * Low-level roving-tabindex primitive shared by composite-widget controllers.\n *\n * The APG roving-tabindex pattern keeps a composite widget a single Tab stop:\n * exactly one item is in the Tab sequence (`tabindex=\"0\"`) while the rest are\n * removed from it (`tabindex=\"-1\"`), and the arrow keys move both DOM focus and\n * that single tabbable position together. {@link RovingTabindex} owns *only* that\n * mechanical bookkeeping — \"which one item is tabbable, and move focus there\".\n *\n * It is intentionally **policy-free**. Orientation, wrapping vs. clamping,\n * selection-follows-focus, typeahead, and `Home`/`End` semantics differ per APG\n * pattern (Radio Group, Toolbar, Rating, …); folding them into one helper would\n * flatten those widgets to a lowest common denominator and lose each pattern's\n * correctness. Those decisions therefore stay in each controller, which calls\n * {@link RovingTabindex.setActive} with an index it computed itself (optionally\n * via the pure {@link rovingMove} helper).\n *\n * @remarks\n * Items are read lazily through a getter so a controller can add or remove\n * targets (Stimulus re-scans the DOM) without re-wiring this helper.\n */\nexport class RovingTabindex {\n  /** Returns the current ordered item elements; called on every operation. */\n  readonly #getItems: () => HTMLElement[];\n\n  /**\n   * @param getItems - Returns the current ordered item elements. Called on every\n   *   operation so the live target list is always used.\n   */\n  constructor(getItems: () => HTMLElement[]) {\n    this.#getItems = getItems;\n  }\n\n  /** Index of the currently tabbable item (`tabindex=\"0\"`), or `-1` if none. */\n  get activeIndex(): number {\n    return this.#getItems().findIndex((item) => item.tabIndex === 0);\n  }\n\n  /**\n   * Makes exactly the item at `index` tabbable (`tabindex=\"0\"`) and removes every\n   * other item from the Tab sequence (`tabindex=\"-1\"`). An out-of-range `index`\n   * (e.g. `-1`) leaves all items at `-1`, which a controller can use to express\n   * \"nothing is currently tabbable\".\n   *\n   * @param index - Position of the item to make tabbable.\n   * @param options - Pass `{ focus: true }` to also move DOM focus to that item.\n   */\n  setActive(index: number, { focus = false }: { focus?: boolean } = {}): void {\n    const items = this.#getItems();\n    items.forEach((item, i) => {\n      item.tabIndex = i === index ? 0 : -1;\n    });\n    if (focus) items[index]?.focus();\n  }\n}\n\n/** Edge behavior for {@link rovingMove}: cycle past the ends, or stop at them. */\nexport type RovingWrap = \"wrap\" | \"clamp\";\n\n/**\n * Pure helper that resolves the target index for a one-step directional move.\n *\n * Keyboard/orientation mapping stays in the caller: it decides that a key means\n * `delta` `+1` (next) or `-1` (previous) and whether the widget should `\"wrap\"`\n * (Radio Group, Toolbar) or `\"clamp\"` at the ends.\n *\n * @param current - The index focus is moving from.\n * @param length - Number of items in the set.\n * @param delta - `+1` to move to the next item, `-1` for the previous.\n * @param wrap - `\"wrap\"` cycles around the ends; `\"clamp\"` stops at them.\n * @returns The resolved index, or `-1` when there are no items.\n */\nexport function rovingMove(\n  current: number,\n  length: number,\n  delta: number,\n  wrap: RovingWrap,\n): number {\n  if (length === 0) return -1;\n  const next = current + delta;\n  if (wrap === \"wrap\") return (next + length) % length;\n  return Math.min(length - 1, Math.max(0, next));\n}\n","/**\n * Self-cleaning timer registries shared by Stimeo controllers.\n *\n * Stimulus controllers frequently schedule `setTimeout` / `setInterval` work\n * (auto-dismiss, debouncing, polling). When the element leaves the DOM — a\n * Turbo Drive navigation, a Turbo Stream replacement, or any `disconnect()` —\n * orphaned timers keep firing against a detached controller, leaking memory and\n * mutating stale state. {@link SafeTimeout} and {@link SafeInterval} track every\n * timer they create so a single {@link TimerRegistry.clearAll | clearAll()} call\n * in `disconnect()` tears them all down.\n *\n * These are intentionally low-level primitives: they own *registration and\n * cleanup only*. Higher-level policy (pause/resume, remaining-time accounting)\n * stays in the individual controllers so per-widget semantics are not flattened\n * into a lowest-common-denominator helper.\n */\n\n/**\n * Shared registry bookkeeping for the timeout/interval variants.\n *\n * Subclasses provide the scheduling primitive ({@link schedule}) and its matching\n * canceller ({@link cancel}); this base owns the set of live ids plus the\n * per-id and bulk teardown shared by both.\n */\nabstract class TimerRegistry {\n  /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */\n  protected readonly ids = new Set<number>();\n\n  /** Schedules the underlying platform timer and returns its id. */\n  protected abstract schedule(callback: () => void, delay: number): number;\n\n  /** Cancels the underlying platform timer for `id`. */\n  protected abstract cancel(id: number): void;\n\n  /**\n   * Cancels a single tracked timer.\n   *\n   * No-ops if the id is unknown (already cleared, fired, or never owned by this\n   * registry), so callers can clear defensively without guarding.\n   */\n  clear(id: number): void {\n    if (this.ids.delete(id)) {\n      this.cancel(id);\n    }\n  }\n\n  /**\n   * Cancels every tracked timer. Call this from a controller's `disconnect()`\n   * to guarantee no timer outlives the element.\n   */\n  clearAll(): void {\n    for (const id of this.ids) {\n      this.cancel(id);\n    }\n    this.ids.clear();\n  }\n\n  /** Number of timers currently tracked (pending). */\n  get size(): number {\n    return this.ids.size;\n  }\n}\n\n/**\n * `setTimeout` wrapper that auto-forgets each timer once it fires and supports\n * bulk teardown on disconnect.\n *\n * @example\n * ```ts\n * #timers = new SafeTimeout();\n *\n * connect() {\n *   this.#timers.set(() => this.dismiss(), 5000);\n * }\n *\n * disconnect() {\n *   this.#timers.clearAll();\n * }\n * ```\n */\nexport class SafeTimeout extends TimerRegistry {\n  /**\n   * Schedules `callback` after `delay` ms and returns the timer id.\n   *\n   * The id is removed from the registry automatically when the timeout fires,\n   * so {@link TimerRegistry.size | size} reflects only still-pending timers.\n   */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(() => {\n      this.ids.delete(id);\n      callback();\n    }, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setTimeout(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearTimeout(id);\n  }\n}\n\n/**\n * `setInterval` wrapper that tracks every interval for bulk teardown on\n * disconnect. Unlike {@link SafeTimeout}, intervals are retained until they are\n * explicitly cleared because they fire repeatedly.\n *\n * @example\n * ```ts\n * #intervals = new SafeInterval();\n *\n * connect() {\n *   this.#intervals.set(() => this.tick(), 1000);\n * }\n *\n * disconnect() {\n *   this.#intervals.clearAll();\n * }\n * ```\n */\nexport class SafeInterval extends TimerRegistry {\n  /** Schedules a repeating `callback` every `delay` ms and returns the timer id. */\n  set(callback: () => void, delay: number): number {\n    const id = this.schedule(callback, delay);\n    this.ids.add(id);\n    return id;\n  }\n\n  protected schedule(callback: () => void, delay: number): number {\n    return window.setInterval(callback, delay);\n  }\n\n  protected cancel(id: number): void {\n    window.clearInterval(id);\n  }\n}\n","import { Controller } from \"@hotwired/stimulus\";\nimport { claimsWhileFocusWithin, EscapeLayer } from \"../utils/escape_layer\";\nimport { RovingTabindex } from \"../utils/roving_tabindex\";\nimport { SafeTimeout } from \"../utils/safe_timeout\";\n\n/** Where to land focus when a menu opens. */\ntype OpenFocus = \"first\" | \"last\";\n\n/** Milliseconds of idle after which the typeahead buffer resets. */\nconst TYPEAHEAD_RESET_MS = 500;\n\n/**\n * Headless, accessible **menubar** behavior.\n *\n * Markup contract (identifier: `stimeo--menubar`):\n *   <div data-controller=\"stimeo--menubar\" role=\"menubar\" aria-label=\"Main\">\n *     <button role=\"menuitem\" aria-haspopup=\"menu\" aria-expanded=\"false\"\n *             aria-controls=\"m-file\" data-stimeo--menubar-target=\"top\"\n *             data-action=\"click->stimeo--menubar#toggle\n *                          keydown->stimeo--menubar#onTopKeydown\">File</button>\n *     <ul id=\"m-file\" role=\"menu\" data-stimeo--menubar-target=\"menu\" hidden>\n *       <li role=\"none\">\n *         <button role=\"menuitem\" tabindex=\"-1\" data-stimeo--menubar-target=\"item\"\n *                 data-action=\"click->stimeo--menubar#activate\n *                              keydown->stimeo--menubar#onItemKeydown\">New</button>\n *       </li>\n *     </ul>\n *     <!-- more top items + menus -->\n *   </div>\n *\n * Implements the WAI-ARIA APG **Menubar** pattern (single level): the top items\n * form one Tab stop via roving tabindex and the arrow keys move between them;\n * `ArrowDown`/`Enter`/`Space` open a menu (`ArrowUp` opens it at the last item),\n * the arrow keys then move within the menu, and pressing `ArrowLeft`/`ArrowRight`\n * while a menu is open jumps to the adjacent top menu. `Escape` closes and\n * returns focus to the owning top item — while a menu is open the menubar is a\n * layer on the shared {@link EscapeLayer} stack, claiming a press only while\n * focus is inside the controller or fell to the body, so one keypress closes\n * exactly one layer (the shared layered-Escape contract). `Tab` and an outside\n * click close.\n *\n * @remarks\n * Behavior only. Each top item↔menu pair is linked by `aria-controls`/`id` (not by\n * position), so the markup order is free. Menu placement and viewport-edge\n * collision are out of scope — static placement is the consumer's CSS, and dynamic\n * placement is delegated to the opt-in `stimeo-ui/positioning` module (never\n * imported here, keeping the core zero-dependency). Roving mechanics across the top\n * items are delegated to {@link RovingTabindex}.\n */\nexport class MenubarController extends Controller<HTMLElement> {\n  static override targets = [\"top\", \"menu\", \"item\"];\n  static actions = [\"activate\", \"onItemKeydown\", \"onTopKeydown\", \"toggle\"] as const;\n\n  declare readonly topTargets: HTMLElement[];\n  declare readonly menuTargets: HTMLElement[];\n  declare readonly itemTargets: HTMLElement[];\n\n  /** Roving tabindex across the top-level menuitems (one Tab stop). */\n  readonly #roving = new RovingTabindex(() => this.topTargets);\n  /** Typeahead buffer and its idle-reset timer (scoped to the open menu). */\n  #typeahead = \"\";\n  #typeaheadId = 0;\n  readonly #timers = new SafeTimeout();\n\n  /** Escape-stack membership while a menu is open; the shared resolver dismisses via it. */\n  readonly #escapeLayer = new EscapeLayer();\n\n  /** Establishes the single tab stop and the closed baseline. */\n  override connect(): void {\n    const active = this.#roving.activeIndex;\n    this.#roving.setActive(active === -1 ? 0 : active);\n    this.#closeAllMenus();\n    document.addEventListener(\"click\", this.#onOutsideClick);\n  }\n\n  /** Removes the document listener, stack membership, and any pending typeahead timer. */\n  override disconnect(): void {\n    this.#escapeLayer.deactivate();\n    document.removeEventListener(\"click\", this.#onOutsideClick);\n    this.#timers.clearAll();\n  }\n\n  /** Toggles a top item's menu. Bound via `data-action` (click on the top item). */\n  toggle(event: Event): void {\n    const top = event.currentTarget as HTMLElement;\n    if (this.#isExpanded(top)) {\n      this.#closeMenu(top);\n    } else {\n      this.#openMenu(top, \"first\");\n    }\n  }\n\n  /** Keyboard handling while focus is on a top item. */\n  onTopKeydown(event: KeyboardEvent): void {\n    const tops = this.topTargets;\n    const index = tops.indexOf(event.currentTarget as HTMLElement);\n    if (index === -1) return;\n    const length = tops.length;\n    // Whether a menu is currently open governs whether horizontal moves *open*\n    // the adjacent menu or merely move the roving focus between top items.\n    const anyOpen = this.#isAnyOpen;\n\n    switch (event.key) {\n      case \"ArrowRight\":\n        event.preventDefault();\n        this.#gotoTop((index + 1) % length, anyOpen);\n        break;\n      case \"ArrowLeft\":\n        event.preventDefault();\n        this.#gotoTop((index - 1 + length) % length, anyOpen);\n        break;\n      case \"ArrowDown\":\n        event.preventDefault();\n        this.#openMenu(tops[index], \"first\");\n        break;\n      case \"ArrowUp\":\n        event.preventDefault();\n        this.#openMenu(tops[index], \"last\");\n        break;\n      case \"Home\":\n        event.preventDefault();\n        this.#gotoTop(0, anyOpen);\n        break;\n      case \"End\":\n        event.preventDefault();\n        this.#gotoTop(length - 1, anyOpen);\n        break;\n      default:\n        break;\n    }\n    // Enter/Space are intentionally left to the native button click, which runs\n    // toggle() (open + focus first item) — handling them here would double-fire.\n    // Escape is owned by the shared EscapeLayer resolver (see #dismissOpenMenu).\n  }\n\n  /** Keyboard handling while focus is on a menu item. */\n  onItemKeydown(event: KeyboardEvent): void {\n    const item = event.currentTarget as HTMLElement;\n    const menu = item.closest<HTMLElement>(\"[role='menu']\");\n    if (!menu) return;\n    const items = this.#itemsIn(menu);\n    const index = items.indexOf(item);\n    const length = items.length;\n\n    switch (event.key) {\n      case \"ArrowDown\":\n        event.preventDefault();\n        this.#focusAt(items, (index + 1) % length);\n        break;\n      case \"ArrowUp\":\n        event.preventDefault();\n        this.#focusAt(items, (index - 1 + length) % length);\n        break;\n      case \"Home\":\n        event.preventDefault();\n        this.#focusAt(items, 0);\n        break;\n      case \"End\":\n        event.preventDefault();\n        this.#focusAt(items, length - 1);\n        break;\n      case \"ArrowRight\":\n        event.preventDefault();\n        this.#moveToAdjacentMenu(menu, 1);\n        break;\n      case \"ArrowLeft\":\n        event.preventDefault();\n        this.#moveToAdjacentMenu(menu, -1);\n        break;\n      case \"Tab\":\n        // Per APG, Tab closes the menubar but lets focus move on naturally.\n        this.#closeAllMenus();\n        break;\n      default:\n        if (this.#isTypeaheadKey(event)) {\n          event.preventDefault();\n          this.#typeaheadTo(items, index, event.key);\n        }\n        break;\n    }\n    // Enter/Space activate the item via its native button click → activate().\n  }\n\n  /** Closes the owning menu after an item is activated and refocuses its top. */\n  activate(event: Event): void {\n    const item = event.currentTarget as HTMLElement;\n    const menu = item.closest<HTMLElement>(\"[role='menu']\");\n    const top = this.#topFor(menu);\n    this.#closeAllMenus();\n    this.#focusTop(top);\n  }\n\n  /** Moves the roving focus to top `index`, opening its menu when one was open. */\n  #gotoTop(index: number, reopen: boolean): void {\n    const top = this.topTargets[index];\n    if (!top) return;\n    if (reopen) {\n      this.#openMenu(top, \"first\");\n    } else {\n      this.#roving.setActive(index, { focus: true });\n    }\n  }\n\n  /** Opens `top`'s menu (closing others) and focuses its first/last item. */\n  #openMenu(top: HTMLElement | null | undefined, focus: OpenFocus): void {\n    if (!top) return;\n    this.#closeAllMenus();\n    const menu = this.#menuFor(top);\n    if (!menu) return;\n    menu.hidden = false;\n    top.setAttribute(\"aria-expanded\", \"true\");\n    this.#escapeLayer.activate(document, {\n      onDismiss: () => this.#dismissOpenMenu(),\n      claims: claimsWhileFocusWithin(this.element),\n    });\n    this.#roving.setActive(this.topTargets.indexOf(top));\n    const items = this.#itemsIn(menu);\n    this.#focusAt(items, focus === \"first\" ? 0 : items.length - 1);\n  }\n\n  /** Hides `top`'s menu and reflects the collapsed state. */\n  #closeMenu(top: HTMLElement | null): void {\n    if (!top) return;\n    const menu = this.#menuFor(top);\n    if (menu) menu.hidden = true;\n    top.setAttribute(\"aria-expanded\", \"false\");\n    if (!this.#isAnyOpen) this.#escapeLayer.deactivate();\n  }\n\n  /** Closes every menu and resets the typeahead buffer. */\n  #closeAllMenus(): void {\n    for (const top of this.topTargets) this.#closeMenu(top);\n    this.#resetTypeahead();\n  }\n\n  /**\n   * Escape path, invoked by the shared resolver: pressed inside an open menu it\n   * closes that menu and returns focus to its top item (the APG behavior);\n   * pressed while focus is on a top item (or fell to the body) it closes every\n   * menu without moving focus.\n   */\n  #dismissOpenMenu(): void {\n    const active = document.activeElement;\n    const menu = this.menuTargets.find((candidate) => candidate.contains(active));\n    if (menu) {\n      const top = this.#topFor(menu);\n      this.#closeMenu(top);\n      this.#focusTop(top);\n      return;\n    }\n    this.#closeAllMenus();\n  }\n\n  /** Opens the menu of the top item `delta` steps from the one owning `menu`. */\n  #moveToAdjacentMenu(menu: HTMLElement, delta: number): void {\n    const top = this.#topFor(menu);\n    if (!top) return;\n    const tops = this.topTargets;\n    const next = (tops.indexOf(top) + delta + tops.length) % tops.length;\n    this.#openMenu(tops[next], \"first\");\n  }\n\n  /** Closes when a click lands outside the controller's element. */\n  readonly #onOutsideClick = (event: MouseEvent): void => {\n    if (this.#isAnyOpen && !this.element.contains(event.target as Node)) this.#closeAllMenus();\n  };\n\n  /** The menu element controlled by `top` (matched by `aria-controls`/`id`). */\n  #menuFor(top: HTMLElement): HTMLElement | null {\n    const id = top.getAttribute(\"aria-controls\");\n    // Resolve against this controller's own menu targets (not a global id lookup)\n    // so it stays scoped to this menubar instance.\n    return id ? (this.menuTargets.find((menu) => menu.id === id) ?? null) : null;\n  }\n\n  /** The top item that controls `menu` (reverse of `#menuFor`). */\n  #topFor(menu: HTMLElement | null): HTMLElement | null {\n    if (!menu) return null;\n    return this.topTargets.find((top) => top.getAttribute(\"aria-controls\") === menu.id) ?? null;\n  }\n\n  /** The item targets that live inside `menu`, in DOM order. */\n  #itemsIn(menu: HTMLElement): HTMLElement[] {\n    return this.itemTargets.filter((item) => menu.contains(item));\n  }\n\n  /** Moves DOM focus to the item at `index` (no-op if out of range). */\n  #focusAt(items: HTMLElement[], index: number): void {\n    items[index]?.focus();\n  }\n\n  /** Returns roving focus to a top item (and makes it the single tab stop). */\n  #focusTop(top: HTMLElement | null): void {\n    if (!top) return;\n    this.#roving.setActive(this.topTargets.indexOf(top), { focus: true });\n  }\n\n  /** Whether `top`'s menu is currently expanded. */\n  #isExpanded(top: HTMLElement): boolean {\n    return top.getAttribute(\"aria-expanded\") === \"true\";\n  }\n\n  /** Whether any top item's menu is currently open. */\n  get #isAnyOpen(): boolean {\n    return this.topTargets.some((top) => this.#isExpanded(top));\n  }\n\n  /**\n   * Whether the event is a single printable character usable for typeahead.\n   * `Space` is excluded: on a `<button>` menuitem it natively activates the item\n   * (Enter/Space → click), so swallowing it for typeahead would break activation.\n   */\n  #isTypeaheadKey(event: KeyboardEvent): boolean {\n    return (\n      event.key.length === 1 &&\n      event.key !== \" \" &&\n      !event.ctrlKey &&\n      !event.metaKey &&\n      !event.altKey\n    );\n  }\n\n  /** Advances focus to the next item in `items` matching the accumulated buffer. */\n  #typeaheadTo(items: HTMLElement[], current: number, key: string): void {\n    this.#typeahead += key.toLowerCase();\n    this.#timers.clear(this.#typeaheadId);\n    this.#typeaheadId = this.#timers.set(() => this.#resetTypeahead(), TYPEAHEAD_RESET_MS);\n\n    const count = items.length;\n    // Start the search just after the current item so repeated presses cycle.\n    for (let step = 1; step <= count; step++) {\n      const candidate = items[(current + step) % count];\n      const label = (candidate?.textContent ?? \"\").trim().toLowerCase();\n      if (label.startsWith(this.#typeahead)) {\n        candidate?.focus();\n        return;\n      }\n    }\n  }\n\n  /** Clears the typeahead buffer and its timer. */\n  #resetTypeahead(): void {\n    this.#typeahead = \"\";\n    this.#timers.clear(this.#typeaheadId);\n  }\n}\n"]}