stimeo-ui 0.2.1 → 0.3.0

package/dist/controllers/navigation_menu_controller.js

@@ -2,6 +2,17 @@ import { Controller } from '@hotwired/stimulus';
 
 // src/controllers/navigation_menu_controller.ts
 
+// src/utils/logical_scroll.ts
+function isRtl(element) {
+  return window.getComputedStyle(element).direction === "rtl";
+}
+
+// src/utils/arrow_step.ts
+function isReservedArrowChord(event, allow = []) {
+  if (!event.key.startsWith("Arrow")) return false;
+  return event.altKey && !allow.includes("alt") || event.ctrlKey && !allow.includes("ctrl") || event.metaKey && !allow.includes("meta") || event.shiftKey && !allow.includes("shift");
+}
+
 // src/utils/escape_layer.ts
 function claimsWhileFocusWithin(element) {
   return () => {
@@ -157,27 +168,52 @@ var NavigationMenuController = class extends Controller {
   #hoverTimers = new SafeTimeout();
   /**
    * Elements currently carrying hover listeners. Removal always mirrors this
-   * set (not a recomputed target snapshot), so add/remove stays symmetric even
-   * when targets churn between connect and disconnect.
+   * set (not a recomputed target snapshot), so a rebuild driven by target churn
+   * can never strand a listener on an element that stopped being a target.
    */
   #hoverWired = /* @__PURE__ */ new Set();
+  /**
+   * The trigger whose hover region the pointer currently occupies, if any. Only
+   * the click semantics under `openOnHover` read it (see {@link toggle}).
+   */
+  #hoveredTrigger = null;
+  /**
+   * Whether the controller is between `connect()` and `disconnect()`. Stimulus
+   * disconnects the controller **before** disconnecting its targets, so the
+   * target callbacks below also fire during teardown; without this flag their
+   * rebuild would re-wire hover listeners onto an already-disconnected nav.
+   */
+  #connected = false;
   /** Escape-stack membership while any panel is open; the shared resolver dismisses via it. */
   #escapeLayer = new EscapeLayer();
   /** Establishes the closed baseline and the dismissal listeners. */
   connect() {
+    this.#connected = true;
     this.#closeAll();
-    document.addEventListener("click", this.#onOutsideClick);
+    document.addEventListener("click", this.#onOutsideClick, true);
     this.element.addEventListener("focusout", this.#onFocusOut);
     if (this.openOnHoverValue) this.#addHoverListeners();
   }
-  /** Removes every listener, pending hover timer, and stack membership registered while connected. */
+  /** Removes every listener, pending hover timer, and stack membership taken while connected. */
   disconnect() {
+    this.#connected = false;
     this.#escapeLayer.deactivate();
-    document.removeEventListener("click", this.#onOutsideClick);
+    document.removeEventListener("click", this.#onOutsideClick, true);
     this.element.removeEventListener("focusout", this.#onFocusOut);
     this.#removeHoverListeners();
     this.#hoverTimers.clearAll();
   }
+  /**
+   * Follows a runtime flip of `openOnHover` (a morph or a scripted attribute
+   * change) by wiring or unwiring the hover listeners in place. Stimulus also
+   * fires this once before `connect()`, which the `#connected` guard skips —
+   * `connect()` owns the initial wiring.
+   */
+  openOnHoverValueChanged() {
+    if (!this.#connected) return;
+    if (this.openOnHoverValue) this.#addHoverListeners();
+    else this.#removeHoverListeners();
+  }
   /** Re-wires hover listeners when a target is added after connect (Turbo Streams etc.). */
   triggerTargetConnected() {
     this.#rewireHoverListeners();
@@ -202,31 +238,65 @@ var NavigationMenuController = class extends Controller {
   hoverAreaTargetDisconnected() {
     this.#rewireHoverListeners();
   }
-  /** Toggles a trigger's panel (single-open). Bound via `data-action` (click). */
+  /**
+   * Toggles a trigger's panel (single-open). Bound via `data-action` (click).
+   *
+   * An explicit activation always wins over a scheduled hover open/close, so any
+   * pending hover timer is dropped first — otherwise a close scheduled just
+   * before the click would fire into the freshly opened panel.
+   *
+   * Under `openOnHover`, closing a panel the pointer itself is holding open is
+   * refused: the pointer stays put, `mouseenter` does not re-fire, and the panel
+   * would be unopenable until the pointer left and came back. Keyboard
+   * activation (pointer elsewhere) still toggles it closed, and `Escape` and
+   * outside clicks dismiss either way.
+   */
   toggle(event) {
     const trigger = event.currentTarget;
-    if (this.#isExpanded(trigger)) {
-      this.#closePanel(trigger);
-    } else {
+    this.#hoverTimers.clearAll();
+    if (!this.#isExpanded(trigger)) {
       this.#openPanel(trigger);
+      return;
     }
+    if (this.openOnHoverValue && this.#hoveredTrigger === trigger) return;
+    this.#closePanel(trigger);
   }
-  /** `ArrowLeft`/`ArrowRight` move focus between triggers (keeping Tab order). */
+  /**
+   * `ArrowLeft`/`ArrowRight` move focus between triggers (keeping Tab order).
+   *
+   * Only navigable triggers are destinations, so a `hidden` or disabled item
+   * never swallows the press. A modified arrow belongs to the browser or OS
+   * (`Alt+←`/`Alt+→` is history back/forward), and with no destination at all
+   * (a single-trigger nav) the press is left to the page — `preventDefault()` is
+   * called only when focus actually moves, keeping the scroll-suppression
+   * contract honest.
+   */
   onTriggerKeydown(event) {
-    const triggers = this.triggerTargets;
-    const index = triggers.indexOf(event.currentTarget);
-    if (index === -1) return;
-    const length = triggers.length;
-    if (event.key === "ArrowRight") {
-      event.preventDefault();
-      triggers[(index + 1) % length]?.focus();
-    } else if (event.key === "ArrowLeft") {
-      event.preventDefault();
-      triggers[(index - 1 + length) % length]?.focus();
-    }
+    if (event.defaultPrevented) return;
+    if (event.key !== "ArrowRight" && event.key !== "ArrowLeft") return;
+    if (isReservedArrowChord(event)) return;
+    const current = event.currentTarget;
+    const triggers = this.triggerTargets.filter(
+      (trigger) => trigger === current || this.#isNavigable(trigger)
+    );
+    const index = triggers.indexOf(current);
+    if (index === -1 || triggers.length < 2) return;
+    event.preventDefault();
+    const forward = isRtl(this.element) ? "ArrowLeft" : "ArrowRight";
+    const step = event.key === forward ? 1 : -1;
+    triggers[(index + step + triggers.length) % triggers.length]?.focus();
   }
-  /** Opens `trigger`'s panel, closing any other open panel first. */
+  /**
+   * Opens `trigger`'s panel, closing any other open panel first. Re-opening an
+   * already-open panel only re-asserts the Escape layer: the close/open
+   * round-trip would rewrite `aria-expanded` and `hidden` for no state change.
+   */
   #openPanel(trigger) {
+    if (trigger.getAttribute("aria-disabled") === "true") return;
+    if (this.#isExpanded(trigger)) {
+      this.#syncEscapeLayer();
+      return;
+    }
     this.#closeAll();
     const panel = this.#panelFor(trigger);
     if (!panel) return;
@@ -241,10 +311,30 @@ var NavigationMenuController = class extends Controller {
     trigger.setAttribute("aria-expanded", "false");
     this.#syncEscapeLayer();
   }
-  /** Closes every open panel. */
+  /**
+   * Closes every open panel and normalizes `aria-expanded="false"` on **all**
+   * triggers, so a trigger whose panel was hidden by other means cannot keep
+   * advertising an open panel.
+   */
   #closeAll() {
     for (const trigger of this.triggerTargets) this.#closePanel(trigger);
   }
+  /**
+   * Whether a trigger can receive arrow-key focus: not `hidden`, not a natively
+   * `disabled` control (mirrors `toolbar`). CSS-only visibility cannot be
+   * detected headlessly and stays the consumer's responsibility.
+   *
+   * **`aria-disabled="true"` stays reachable.** APG separates the attributes by
+   * intent: `disabled` is for controls a neighbour makes inferable, while
+   * `aria-disabled` marks one that must remain *discoverable* — and a nav
+   * section the user cannot even arrow to is a section they cannot learn exists.
+   * Opening is suppressed separately, so the trigger announces itself and does
+   * nothing.
+   */
+  #isNavigable(trigger) {
+    if (trigger.hasAttribute("hidden")) return false;
+    return !trigger.disabled;
+  }
   /**
    * Aligns Escape-stack membership with the open state: joins (or re-asserts to
    * the top) while a panel is open, leaves once none is. Re-asserting when the
@@ -260,10 +350,15 @@ var NavigationMenuController = class extends Controller {
       this.#escapeLayer.deactivate();
     }
   }
-  /** Closes any open panel and returns focus to its trigger (Escape path). */
+  /**
+   * Closes any open panel and returns focus to its trigger (Escape path). A
+   * pending hover open would otherwise re-open the panel the user just
+   * dismissed, so the reservation is dropped with it.
+   */
   #closeAndRestore() {
     const open = this.#openTrigger;
     if (!open) return;
+    this.#hoverTimers.clearAll();
     this.#closePanel(open);
     open.focus();
   }
@@ -288,8 +383,9 @@ var NavigationMenuController = class extends Controller {
   #onPointerEnter = (event) => {
     const trigger = this.#triggerForHover(event.currentTarget);
     if (!trigger) return;
+    this.#hoveredTrigger = trigger;
     this.#hoverTimers.clearAll();
-    this.#hoverTimers.set(() => this.#openPanel(trigger), this.hoverDelayValue);
+    this.#hoverTimers.set(() => this.#openFromHover(trigger), this.hoverDelayValue);
   };
   /**
    * Closes the open panel after the hover delay (hover mode) — unless the
@@ -300,9 +396,37 @@ var NavigationMenuController = class extends Controller {
   #onPointerLeave = (event) => {
     const next = event instanceof MouseEvent ? event.relatedTarget : null;
     if (next instanceof Node && this.#hoverElements.some((el) => el.contains(next))) return;
+    this.#hoveredTrigger = null;
     this.#hoverTimers.clearAll();
-    this.#hoverTimers.set(() => this.#closeAll(), this.hoverDelayValue);
+    this.#hoverTimers.set(() => this.#closeFromHover(), this.hoverDelayValue);
   };
+  /**
+   * Hover-driven open. Switching panels would hide the outgoing one, so focus
+   * standing inside it is handed back to its trigger first: pointer movement
+   * must never send focus to the body (the keyboard user would lose their
+   * place). Focus outside the closing panel is left alone.
+   */
+  #openFromHover(trigger) {
+    if (trigger.getAttribute("aria-disabled") === "true") return;
+    const open = this.#openTrigger;
+    if (open && open !== trigger && this.#holdsFocus(this.#panelFor(open))) open.focus();
+    this.#openPanel(trigger);
+  }
+  /**
+   * Hover-driven close: skipped while focus sits inside the panel it would hide,
+   * for the same no-focus-loss reason (cf. `hover_card`'s delayed close). The
+   * panel then stays open until `Escape`, an outside click, or focus leaving the
+   * nav dismisses it — all of which restore or keep focus deliberately.
+   */
+  #closeFromHover() {
+    const open = this.#openTrigger;
+    if (open && this.#holdsFocus(this.#panelFor(open))) return;
+    this.#closeAll();
+  }
+  /** Whether `panel` exists and currently contains the focused element. */
+  #holdsFocus(panel) {
+    return panel?.contains(document.activeElement) ?? false;
+  }
   /** Wires hover open/close on each hover element (opt-in), tracking what was wired. */
   #addHoverListeners() {
     for (const element of this.#hoverElements) {
@@ -318,14 +442,17 @@ var NavigationMenuController = class extends Controller {
       element.removeEventListener("mouseleave", this.#onPointerLeave);
     }
     this.#hoverWired.clear();
+    this.#hoveredTrigger = null;
   }
   /**
    * Rebuilds the hover wiring from the current targets. Target callbacks call
    * this so items added or removed after connect (e.g. a Turbo Stream append)
    * participate in hover; the wired-set removal keeps the rebuild symmetric.
+   * Stimulus fires those callbacks during teardown too, hence the `#connected`
+   * guard — a rebuild after `disconnect()` would resurrect the listeners.
    */
   #rewireHoverListeners() {
-    if (!this.openOnHoverValue) return;
+    if (!this.#connected || !this.openOnHoverValue) return;
     this.#removeHoverListeners();
     this.#addHoverListeners();
   }

package/dist/controllers/navigation_menu_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/utils/escape_layer.ts","../../src/utils/safe_timeout.ts","../../src/controllers/navigation_menu_controller.ts"],"names":[],"mappings":";;;;;AAgEO,SAAS,uBAAuB,OAAA,EAAiC;AACtE,EAAA,OAAO,MAAM;AACX,IAAA,MAAM,MAAA,GAAS,QAAQ,aAAA,CAAc,aAAA;AACrC,IAAA,OAAO,MAAA,KAAW,QAAQ,MAAA,KAAW,OAAA,CAAQ,cAAc,IAAA,IAAQ,OAAA,CAAQ,SAAS,MAAM,CAAA;AAAA,EAC5F,CAAA;AACF;AAEO,IAAM,WAAA,GAAN,MAAM,YAAA,CAAY;AAAA,EACvB,OAAgB,WAAA,mBAAc,IAAI,OAAA,EAAuC;AAAA,EAEzE,cAAA,GAAkC,IAAA;AAAA;AAAA,EAElC,UAAA,GAAkC,IAAA;AAAA;AAAA,EAElC,OAAA,GAAkC,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOlC,QAAA,CAAS,aAAA,GAA0B,QAAA,EAAU,OAAA,EAAmC;AAC9E,IAAA,IAAA,CAAK,UAAA,EAAW;AAChB,IAAA,IAAI,QAAA,GAAW,YAAA,CAAY,WAAA,CAAY,GAAA,CAAI,aAAa,CAAA;AACxD,IAAA,IAAI,CAAC,QAAA,EAAU;AACb,MAAA,QAAA,GAAW,aAAY,eAAA,EAAgB;AACvC,MAAA,YAAA,CAAY,WAAA,CAAY,GAAA,CAAI,aAAA,EAAe,QAAQ,CAAA;AACnD,MAAA,aAAA,CAAc,gBAAA,CAAiB,SAAA,EAAW,QAAA,CAAS,SAAS,CAAA;AAAA,IAC9D;AACA,IAAA,QAAA,CAAS,KAAA,CAAM,KAAK,IAAI,CAAA;AACxB,IAAA,IAAA,CAAK,cAAA,GAAiB,aAAA;AACtB,IAAA,IAAA,CAAK,aAAa,OAAA,CAAQ,SAAA;AAC1B,IAAA,IAAA,CAAK,OAAA,GAAU,QAAQ,MAAA,IAAU,IAAA;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,UAAA,GAAmB;AACjB,IAAA,MAAM,gBAAgB,IAAA,CAAK,cAAA;AAC3B,IAAA,IAAI,CAAC,aAAA,EAAe;AAEpB,IAAA,MAAM,QAAA,GAAW,YAAA,CAAY,WAAA,CAAY,GAAA,CAAI,aAAa,CAAA;AAC1D,IAAA,IAAI,QAAA,EAAU;AACZ,MAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,KAAA,CAAM,WAAA,CAAY,IAAI,CAAA;AAC7C,MAAA,IAAI,SAAS,CAAA,EAAG,QAAA,CAAS,KAAA,CAAM,MAAA,CAAO,OAAO,CAAC,CAAA;AAC9C,MAAA,IAAI,QAAA,CAAS,KAAA,CAAM,MAAA,KAAW,CAAA,EAAG;AAC/B,QAAA,aAAA,CAAc,mBAAA,CAAoB,SAAA,EAAW,QAAA,CAAS,SAAS,CAAA;AAC/D,QAAA,YAAA,CAAY,WAAA,CAAY,OAAO,aAAa,CAAA;AAAA,MAC9C;AAAA,IACF;AACA,IAAA,IAAA,CAAK,cAAA,GAAiB,IAAA;AACtB,IAAA,IAAA,CAAK,UAAA,GAAa,IAAA;AAClB,IAAA,IAAA,CAAK,OAAA,GAAU,IAAA;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,IAAI,UAAA,GAAsB;AACxB,IAAA,MAAM,gBAAgB,IAAA,CAAK,cAAA;AAC3B,IAAA,IAAI,CAAC,eAAe,OAAO,KAAA;AAC3B,IAAA,MAAM,QAAA,GAAW,YAAA,CAAY,WAAA,CAAY,GAAA,CAAI,aAAa,CAAA;AAC1D,IAAA,IAAI,CAAC,UAAU,OAAO,KAAA;AACtB,IAAA,OAAO,YAAA,CAAY,aAAA,CAAc,QAAA,CAAS,KAAK,CAAA,KAAM,IAAA;AAAA,EACvD;AAAA;AAAA,EAGA,OAAO,eAAA,GAAuC;AAC5C,IAAA,MAAM,QAAA,GAAgC;AAAA,MACpC,OAAO,EAAC;AAAA,MACR,SAAA,EAAW,CAAC,KAAA,KAA+B;AACzC,QAAA,IAAI,MAAM,GAAA,KAAQ,QAAA,IAAY,KAAA,CAAM,gBAAA,IAAoB,MAAM,WAAA,EAAa;AAC3E,QAAA,MAAM,KAAA,GAAQ,YAAA,CAAY,aAAA,CAAc,QAAA,CAAS,KAAK,CAAA;AACtD,QAAA,IAAI,CAAC,KAAA,EAAO;AACZ,QAAA,KAAA,CAAM,cAAA,EAAe;AACrB,QAAA,KAAA,CAAM,UAAA,IAAa;AAAA,MACrB;AAAA,KACF;AACA,IAAA,OAAO,QAAA;AAAA,EACT;AAAA;AAAA,EAGA,OAAO,cAAc,KAAA,EAA0C;AAC7D,IAAA,KAAA,IAAS,QAAQ,KAAA,CAAM,MAAA,GAAS,CAAA,EAAG,KAAA,IAAS,GAAG,KAAA,EAAA,EAAS;AACtD,MAAA,MAAM,KAAA,GAAQ,MAAM,KAAK,CAAA;AACzB,MAAA,IAAI,CAAC,KAAA,EAAO;AACZ,MAAA,IAAI,KAAA,CAAM,OAAA,IAAW,CAAC,KAAA,CAAM,SAAQ,EAAG;AACvC,MAAA,OAAO,KAAA;AAAA,IACT;AACA,IAAA,OAAO,IAAA;AAAA,EACT;AACF,CAAA;;;ACvIA,IAAe,gBAAf,MAA6B;AAAA;AAAA,EAER,GAAA,uBAAU,GAAA,EAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAczC,MAAM,EAAA,EAAkB;AACtB,IAAA,IAAI,IAAA,CAAK,GAAA,CAAI,MAAA,CAAO,EAAE,CAAA,EAAG;AACvB,MAAA,IAAA,CAAK,OAAO,EAAE,CAAA;AAAA,IAChB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,QAAA,GAAiB;AACf,IAAA,KAAA,MAAW,EAAA,IAAM,KAAK,GAAA,EAAK;AACzB,MAAA,IAAA,CAAK,OAAO,EAAE,CAAA;AAAA,IAChB;AACA,IAAA,IAAA,CAAK,IAAI,KAAA,EAAM;AAAA,EACjB;AAAA;AAAA,EAGA,IAAI,IAAA,GAAe;AACjB,IAAA,OAAO,KAAK,GAAA,CAAI,IAAA;AAAA,EAClB;AACF,CAAA;AAmBO,IAAM,WAAA,GAAN,cAA0B,aAAA,CAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO7C,GAAA,CAAI,UAAsB,KAAA,EAAuB;AAC/C,IAAA,MAAM,EAAA,GAAK,IAAA,CAAK,QAAA,CAAS,MAAM;AAC7B,MAAA,IAAA,CAAK,GAAA,CAAI,OAAO,EAAE,CAAA;AAClB,MAAA,QAAA,EAAS;AAAA,IACX,GAAG,KAAK,CAAA;AACR,IAAA,IAAA,CAAK,GAAA,CAAI,IAAI,EAAE,CAAA;AACf,IAAA,OAAO,EAAA;AAAA,EACT;AAAA,EAEU,QAAA,CAAS,UAAsB,KAAA,EAAuB;AAC9D,IAAA,OAAO,MAAA,CAAO,UAAA,CAAW,QAAA,EAAU,KAAK,CAAA;AAAA,EAC1C;AAAA,EAEU,OAAO,EAAA,EAAkB;AACjC,IAAA,MAAA,CAAO,aAAa,EAAE,CAAA;AAAA,EACxB;AACF,CAAA;;;AC5CO,IAAM,wBAAA,GAAN,cAAuC,UAAA,CAAwB;AAAA,EACpE,OAAgB,OAAA,GAAU,CAAC,SAAA,EAAW,SAAS,WAAW,CAAA;AAAA,EAC1D,OAAgB,MAAA,GAAS;AAAA,IACvB,WAAA,EAAa,EAAE,IAAA,EAAM,OAAA,EAAS,SAAS,KAAA,EAAM;AAAA,IAC7C,UAAA,EAAY,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAS,GAAA;AAAI,GAC3C;AAAA,EACA,OAAO,OAAA,GAAU,CAAC,kBAAA,EAAoB,QAAQ,CAAA;AAAA;AAAA,EAUrC,YAAA,GAAe,IAAI,WAAA,EAAY;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO/B,WAAA,uBAAkB,GAAA,EAAiB;AAAA;AAAA,EAGnC,YAAA,GAAe,IAAI,WAAA,EAAY;AAAA;AAAA,EAG/B,OAAA,GAAgB;AACvB,IAAA,IAAA,CAAK,SAAA,EAAU;AACf,IAAA,QAAA,CAAS,gBAAA,CAAiB,OAAA,EAAS,IAAA,CAAK,eAAe,CAAA;AACvD,IAAA,IAAA,CAAK,OAAA,CAAQ,gBAAA,CAAiB,UAAA,EAAY,IAAA,CAAK,WAAW,CAAA;AAC1D,IAAA,IAAI,IAAA,CAAK,gBAAA,EAAkB,IAAA,CAAK,kBAAA,EAAmB;AAAA,EACrD;AAAA;AAAA,EAGS,UAAA,GAAmB;AAC1B,IAAA,IAAA,CAAK,aAAa,UAAA,EAAW;AAC7B,IAAA,QAAA,CAAS,mBAAA,CAAoB,OAAA,EAAS,IAAA,CAAK,eAAe,CAAA;AAC1D,IAAA,IAAA,CAAK,OAAA,CAAQ,mBAAA,CAAoB,UAAA,EAAY,IAAA,CAAK,WAAW,CAAA;AAC7D,IAAA,IAAA,CAAK,qBAAA,EAAsB;AAC3B,IAAA,IAAA,CAAK,aAAa,QAAA,EAAS;AAAA,EAC7B;AAAA;AAAA,EAGA,sBAAA,GAA+B;AAC7B,IAAA,IAAA,CAAK,qBAAA,EAAsB;AAAA,EAC7B;AAAA;AAAA,EAGA,yBAAA,GAAkC;AAChC,IAAA,IAAA,CAAK,qBAAA,EAAsB;AAAA,EAC7B;AAAA;AAAA,EAGA,oBAAA,GAA6B;AAC3B,IAAA,IAAA,CAAK,qBAAA,EAAsB;AAAA,EAC7B;AAAA;AAAA,EAGA,uBAAA,GAAgC;AAC9B,IAAA,IAAA,CAAK,qBAAA,EAAsB;AAAA,EAC7B;AAAA;AAAA,EAGA,wBAAA,GAAiC;AAC/B,IAAA,IAAA,CAAK,qBAAA,EAAsB;AAAA,EAC7B;AAAA;AAAA,EAGA,2BAAA,GAAoC;AAClC,IAAA,IAAA,CAAK,qBAAA,EAAsB;AAAA,EAC7B;AAAA;AAAA,EAGA,OAAO,KAAA,EAAoB;AACzB,IAAA,MAAM,UAAU,KAAA,CAAM,aAAA;AACtB,IAAA,IAAI,IAAA,CAAK,WAAA,CAAY,OAAO,CAAA,EAAG;AAC7B,MAAA,IAAA,CAAK,YAAY,OAAO,CAAA;AAAA,IAC1B,CAAA,MAAO;AACL,MAAA,IAAA,CAAK,WAAW,OAAO,CAAA;AAAA,IACzB;AAAA,EACF;AAAA;AAAA,EAGA,iBAAiB,KAAA,EAA4B;AAC3C,IAAA,MAAM,WAAW,IAAA,CAAK,cAAA;AACtB,IAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,OAAA,CAAQ,KAAA,CAAM,aAA4B,CAAA;AACjE,IAAA,IAAI,UAAU,EAAA,EAAI;AAClB,IAAA,MAAM,SAAS,QAAA,CAAS,MAAA;AAExB,IAAA,IAAI,KAAA,CAAM,QAAQ,YAAA,EAAc;AAC9B,MAAA,KAAA,CAAM,cAAA,EAAe;AACrB,MAAA,QAAA,CAAA,CAAU,KAAA,GAAQ,CAAA,IAAK,MAAM,CAAA,EAAG,KAAA,EAAM;AAAA,IACxC,CAAA,MAAA,IAAW,KAAA,CAAM,GAAA,KAAQ,WAAA,EAAa;AACpC,MAAA,KAAA,CAAM,cAAA,EAAe;AACrB,MAAA,QAAA,CAAA,CAAU,KAAA,GAAQ,CAAA,GAAI,MAAA,IAAU,MAAM,GAAG,KAAA,EAAM;AAAA,IACjD;AAAA,EACF;AAAA;AAAA,EAGA,WAAW,OAAA,EAA4B;AACrC,IAAA,IAAA,CAAK,SAAA,EAAU;AACf,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,SAAA,CAAU,OAAO,CAAA;AACpC,IAAA,IAAI,CAAC,KAAA,EAAO;AACZ,IAAA,KAAA,CAAM,MAAA,GAAS,KAAA;AACf,IAAA,OAAA,CAAQ,YAAA,CAAa,iBAAiB,MAAM,CAAA;AAC5C,IAAA,IAAA,CAAK,gBAAA,EAAiB;AAAA,EACxB;AAAA;AAAA,EAGA,YAAY,OAAA,EAA4B;AACtC,IAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,SAAA,CAAU,OAAO,CAAA;AACpC,IAAA,IAAI,KAAA,QAAa,MAAA,GAAS,IAAA;AAC1B,IAAA,OAAA,CAAQ,YAAA,CAAa,iBAAiB,OAAO,CAAA;AAC7C,IAAA,IAAA,CAAK,gBAAA,EAAiB;AAAA,EACxB;AAAA;AAAA,EAGA,SAAA,GAAkB;AAChB,IAAA,KAAA,MAAW,OAAA,IAAW,IAAA,CAAK,cAAA,EAAgB,IAAA,CAAK,YAAY,OAAO,CAAA;AAAA,EACrE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,gBAAA,GAAyB;AACvB,IAAA,IAAI,KAAK,UAAA,EAAY;AACnB,MAAA,IAAA,CAAK,YAAA,CAAa,SAAS,QAAA,EAAU;AAAA,QACnC,SAAA,EAAW,MAAM,IAAA,CAAK,gBAAA,EAAiB;AAAA,QACvC,MAAA,EAAQ,sBAAA,CAAuB,IAAA,CAAK,OAAO;AAAA,OAC5C,CAAA;AAAA,IACH,CAAA,MAAO;AACL,MAAA,IAAA,CAAK,aAAa,UAAA,EAAW;AAAA,IAC/B;AAAA,EACF;AAAA;AAAA,EAGA,gBAAA,GAAyB;AACvB,IAAA,MAAM,OAAO,IAAA,CAAK,YAAA;AAClB,IAAA,IAAI,CAAC,IAAA,EAAM;AACX,IAAA,IAAA,CAAK,YAAY,IAAI,CAAA;AACrB,IAAA,IAAA,CAAK,KAAA,EAAM;AAAA,EACb;AAAA;AAAA,EAGS,eAAA,GAAkB,CAAC,KAAA,KAA4B;AACtD,IAAA,IAAI,IAAA,CAAK,UAAA,IAAc,CAAC,IAAA,CAAK,OAAA,CAAQ,SAAS,KAAA,CAAM,MAAc,CAAA,EAAG,IAAA,CAAK,SAAA,EAAU;AAAA,EACtF,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUS,WAAA,GAAc,CAAC,KAAA,KAA4B;AAClD,IAAA,MAAM,OAAO,KAAA,CAAM,aAAA;AACnB,IAAA,IAAI,EAAE,IAAA,YAAgB,IAAA,CAAA,IAAS,KAAK,OAAA,CAAQ,QAAA,CAAS,IAAI,CAAA,EAAG;AAC5D,IAAA,IAAA,CAAK,SAAA,EAAU;AAAA,EACjB,CAAA;AAAA;AAAA,EAGS,eAAA,GAAkB,CAAC,KAAA,KAAuB;AACjD,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,gBAAA,CAAiB,KAAA,CAAM,aAA4B,CAAA;AACxE,IAAA,IAAI,CAAC,OAAA,EAAS;AACd,IAAA,IAAA,CAAK,aAAa,QAAA,EAAS;AAC3B,IAAA,IAAA,CAAK,YAAA,CAAa,IAAI,MAAM,IAAA,CAAK,WAAW,OAAO,CAAA,EAAG,KAAK,eAAe,CAAA;AAAA,EAC5E,CAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQS,eAAA,GAAkB,CAAC,KAAA,KAAuB;AACjD,IAAA,MAAM,IAAA,GAAO,KAAA,YAAiB,UAAA,GAAa,KAAA,CAAM,aAAA,GAAgB,IAAA;AACjE,IAAA,IAAI,IAAA,YAAgB,IAAA,IAAQ,IAAA,CAAK,cAAA,CAAe,IAAA,CAAK,CAAC,EAAA,KAAO,EAAA,CAAG,QAAA,CAAS,IAAI,CAAC,CAAA,EAAG;AACjF,IAAA,IAAA,CAAK,aAAa,QAAA,EAAS;AAC3B,IAAA,IAAA,CAAK,aAAa,GAAA,CAAI,MAAM,KAAK,SAAA,EAAU,EAAG,KAAK,eAAe,CAAA;AAAA,EACpE,CAAA;AAAA;AAAA,EAGA,kBAAA,GAA2B;AACzB,IAAA,KAAA,MAAW,OAAA,IAAW,KAAK,cAAA,EAAgB;AACzC,MAAA,OAAA,CAAQ,gBAAA,CAAiB,YAAA,EAAc,IAAA,CAAK,eAAe,CAAA;AAC3D,MAAA,OAAA,CAAQ,gBAAA,CAAiB,YAAA,EAAc,IAAA,CAAK,eAAe,CAAA;AAC3D,MAAA,IAAA,CAAK,WAAA,CAAY,IAAI,OAAO,CAAA;AAAA,IAC9B;AAAA,EACF;AAAA;AAAA,EAGA,qBAAA,GAA8B;AAC5B,IAAA,KAAA,MAAW,OAAA,IAAW,KAAK,WAAA,EAAa;AACtC,MAAA,OAAA,CAAQ,mBAAA,CAAoB,YAAA,EAAc,IAAA,CAAK,eAAe,CAAA;AAC9D,MAAA,OAAA,CAAQ,mBAAA,CAAoB,YAAA,EAAc,IAAA,CAAK,eAAe,CAAA;AAAA,IAChE;AACA,IAAA,IAAA,CAAK,YAAY,KAAA,EAAM;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,qBAAA,GAA8B;AAC5B,IAAA,IAAI,CAAC,KAAK,gBAAA,EAAkB;AAC5B,IAAA,IAAA,CAAK,qBAAA,EAAsB;AAC3B,IAAA,IAAA,CAAK,kBAAA,EAAmB;AAAA,EAC1B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,IAAI,cAAA,GAAgC;AAClC,IAAA,MAAM,QAAQ,IAAA,CAAK,gBAAA;AACnB,IAAA,MAAM,OAAA,GAAU,CAAC,OAAA,KAAkC,KAAA,CAAM,IAAA,CAAK,CAAC,IAAA,KAAS,IAAA,CAAK,QAAA,CAAS,OAAO,CAAC,CAAA;AAC9F,IAAA,OAAO;AAAA,MACL,GAAG,KAAA;AAAA,MACH,GAAG,KAAK,cAAA,CAAe,MAAA,CAAO,CAAC,OAAA,KAAY,CAAC,OAAA,CAAQ,OAAO,CAAC,CAAA;AAAA,MAC5D,GAAG,KAAK,YAAA,CAAa,MAAA,CAAO,CAAC,KAAA,KAAU,CAAC,OAAA,CAAQ,KAAK,CAAC;AAAA,KACxD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,iBAAiB,OAAA,EAA0C;AACzD,IAAA,IAAI,IAAA,CAAK,cAAA,CAAe,QAAA,CAAS,OAAO,GAAG,OAAO,OAAA;AAClD,IAAA,IAAI,IAAA,CAAK,YAAA,CAAa,QAAA,CAAS,OAAO,CAAA,EAAG;AACvC,MAAA,OAAO,IAAA,CAAK,cAAA,CAAe,IAAA,CAAK,CAAC,OAAA,KAAY,KAAK,SAAA,CAAU,OAAO,CAAA,KAAM,OAAO,CAAA,IAAK,IAAA;AAAA,IACvF;AACA,IAAA,IAAI,IAAA,CAAK,gBAAA,CAAiB,QAAA,CAAS,OAAO,CAAA,EAAG;AAC3C,MAAA,OAAO,IAAA,CAAK,eAAe,IAAA,CAAK,CAAC,YAAY,OAAA,CAAQ,QAAA,CAAS,OAAO,CAAC,CAAA,IAAK,IAAA;AAAA,IAC7E;AACA,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA,EAGA,UAAU,OAAA,EAA0C;AAClD,IAAA,MAAM,EAAA,GAAK,OAAA,CAAQ,YAAA,CAAa,eAAe,CAAA;AAG/C,IAAA,OAAO,EAAA,GAAM,IAAA,CAAK,YAAA,CAAa,IAAA,CAAK,CAAC,UAAU,KAAA,CAAM,EAAA,KAAO,EAAE,CAAA,IAAK,IAAA,GAAQ,IAAA;AAAA,EAC7E;AAAA;AAAA,EAGA,YAAY,OAAA,EAA+B;AACzC,IAAA,OAAO,OAAA,CAAQ,YAAA,CAAa,eAAe,CAAA,KAAM,MAAA;AAAA,EACnD;AAAA;AAAA,EAGA,IAAI,YAAA,GAAmC;AACrC,IAAA,OAAO,IAAA,CAAK,eAAe,IAAA,CAAK,CAAC,YAAY,IAAA,CAAK,WAAA,CAAY,OAAO,CAAC,CAAA,IAAK,IAAA;AAAA,EAC7E;AAAA;AAAA,EAGA,IAAI,UAAA,GAAsB;AACxB,IAAA,OAAO,KAAK,YAAA,KAAiB,IAAA;AAAA,EAC/B;AACF","file":"navigation_menu_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 * 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 { SafeTimeout } from \"../utils/safe_timeout\";\n\n/**\n * Headless, accessible **navigation menu** behavior (disclosure navigation).\n *\n * Markup contract (identifier: `stimeo--navigation-menu`):\n *   <nav data-controller=\"stimeo--navigation-menu\" aria-label=\"Main\">\n *     <ul>\n *       <li>\n *         <button data-stimeo--navigation-menu-target=\"trigger\"\n *                 aria-expanded=\"false\" aria-controls=\"nav-products\"\n *                 data-action=\"click->stimeo--navigation-menu#toggle\n *                              keydown->stimeo--navigation-menu#onTriggerKeydown\">\n *           Products\n *         </button>\n *         <div id=\"nav-products\" data-stimeo--navigation-menu-target=\"panel\" hidden>\n *           <a href=\"/a\">Product A</a><a href=\"/b\">Product B</a>\n *         </div>\n *       </li>\n *     </ul>\n *   </nav>\n *\n * Implements the WAI-ARIA APG **Disclosure** navigation pattern: each top-level\n * button toggles its sub-panel (`aria-expanded` + `hidden` synced), only one panel\n * is open at a time, and the panel content is a plain set of links (not a\n * `role=\"menu\"`). Focus is **not** trapped — `Tab` moves through the links\n * naturally. `Escape` closes the open panel and returns focus to its trigger.\n * While a panel is open the nav is a layer on the shared {@link EscapeLayer}\n * stack; it claims a press only while focus is inside the nav or fell to the\n * body (a click on non-focusable panel content), so one keypress closes exactly\n * one layer (the shared layered-Escape contract). An outside click, or focus\n * leaving the nav for a known external destination, closes it. `ArrowLeft`/\n * `ArrowRight` move focus between triggers without rewriting `tabindex` (they\n * keep their natural Tab order). Hover open/close is opt-in via `openOnHover`.\n *\n * By default the hover region is each trigger and its panel. An optional\n * `hoverArea` target widens it: mark a wrapper that contains a trigger (e.g. the\n * `<li>` holding a top-level *link*, its disclosure button, and its panel — the\n * APG \"Disclosure Navigation with Top-Level Links\" arrangement) and hovering\n * anywhere over that wrapper opens the contained trigger's panel. A trigger or\n * panel inside a `hoverArea` defers to the wrapper (its own edges stop scheduling\n * open/close), so pointer movement within the area never flickers the panel.\n * Keep a trigger's panel inside its `hoverArea`: a panel left outside simply\n * falls back to the default two-region behavior — moving straight across a\n * shared edge never schedules a close (the leave handler checks\n * `relatedTarget`), and `hoverDelay` bridges the pointer's travel across an\n * actual gap. Targets added or removed while connected (e.g. a Turbo Stream\n * append) re-wire the hover listeners via Stimulus target callbacks.\n * `hoverArea` has no effect unless `openOnHover` is enabled.\n *\n * @remarks\n * Behavior only. Panel layout, mega-menu styling, and animation are the\n * consumer's CSS. Static placement is CSS; viewport-edge collision avoidance is\n * delegated to the opt-in `stimeo-ui/positioning` module (never imported here, so\n * the core stays zero-dependency). For an app command menu with arrow roving and\n * `role=\"menu\"`, use `stimeo--menubar` instead.\n */\nexport class NavigationMenuController extends Controller<HTMLElement> {\n  static override targets = [\"trigger\", \"panel\", \"hoverArea\"];\n  static override values = {\n    openOnHover: { type: Boolean, default: false },\n    hoverDelay: { type: Number, default: 150 },\n  };\n  static actions = [\"onTriggerKeydown\", \"toggle\"] as const;\n\n  declare readonly triggerTargets: HTMLElement[];\n  declare readonly panelTargets: HTMLElement[];\n  declare readonly hoverAreaTargets: HTMLElement[];\n\n  declare openOnHoverValue: boolean;\n  declare hoverDelayValue: number;\n\n  /** Open/close delay timers for hover mode; cleared together on disconnect. */\n  readonly #hoverTimers = new SafeTimeout();\n\n  /**\n   * Elements currently carrying hover listeners. Removal always mirrors this\n   * set (not a recomputed target snapshot), so add/remove stays symmetric even\n   * when targets churn between connect and disconnect.\n   */\n  readonly #hoverWired = new Set<HTMLElement>();\n\n  /** Escape-stack membership while any panel is open; the shared resolver dismisses via it. */\n  readonly #escapeLayer = new EscapeLayer();\n\n  /** Establishes the closed baseline and the dismissal listeners. */\n  override connect(): void {\n    this.#closeAll();\n    document.addEventListener(\"click\", this.#onOutsideClick);\n    this.element.addEventListener(\"focusout\", this.#onFocusOut);\n    if (this.openOnHoverValue) this.#addHoverListeners();\n  }\n\n  /** Removes every listener, pending hover timer, and stack membership registered while connected. */\n  override disconnect(): void {\n    this.#escapeLayer.deactivate();\n    document.removeEventListener(\"click\", this.#onOutsideClick);\n    this.element.removeEventListener(\"focusout\", this.#onFocusOut);\n    this.#removeHoverListeners();\n    this.#hoverTimers.clearAll();\n  }\n\n  /** Re-wires hover listeners when a target is added after connect (Turbo Streams etc.). */\n  triggerTargetConnected(): void {\n    this.#rewireHoverListeners();\n  }\n\n  /** Re-wires hover listeners when a target is removed while connected. */\n  triggerTargetDisconnected(): void {\n    this.#rewireHoverListeners();\n  }\n\n  /** See {@link NavigationMenuController.triggerTargetConnected}. */\n  panelTargetConnected(): void {\n    this.#rewireHoverListeners();\n  }\n\n  /** See {@link NavigationMenuController.triggerTargetDisconnected}. */\n  panelTargetDisconnected(): void {\n    this.#rewireHoverListeners();\n  }\n\n  /** See {@link NavigationMenuController.triggerTargetConnected}. */\n  hoverAreaTargetConnected(): void {\n    this.#rewireHoverListeners();\n  }\n\n  /** See {@link NavigationMenuController.triggerTargetDisconnected}. */\n  hoverAreaTargetDisconnected(): void {\n    this.#rewireHoverListeners();\n  }\n\n  /** Toggles a trigger's panel (single-open). Bound via `data-action` (click). */\n  toggle(event: Event): void {\n    const trigger = event.currentTarget as HTMLElement;\n    if (this.#isExpanded(trigger)) {\n      this.#closePanel(trigger);\n    } else {\n      this.#openPanel(trigger);\n    }\n  }\n\n  /** `ArrowLeft`/`ArrowRight` move focus between triggers (keeping Tab order). */\n  onTriggerKeydown(event: KeyboardEvent): void {\n    const triggers = this.triggerTargets;\n    const index = triggers.indexOf(event.currentTarget as HTMLElement);\n    if (index === -1) return;\n    const length = triggers.length;\n\n    if (event.key === \"ArrowRight\") {\n      event.preventDefault();\n      triggers[(index + 1) % length]?.focus();\n    } else if (event.key === \"ArrowLeft\") {\n      event.preventDefault();\n      triggers[(index - 1 + length) % length]?.focus();\n    }\n  }\n\n  /** Opens `trigger`'s panel, closing any other open panel first. */\n  #openPanel(trigger: HTMLElement): void {\n    this.#closeAll();\n    const panel = this.#panelFor(trigger);\n    if (!panel) return;\n    panel.hidden = false;\n    trigger.setAttribute(\"aria-expanded\", \"true\");\n    this.#syncEscapeLayer();\n  }\n\n  /** Closes `trigger`'s panel and reflects the collapsed state. */\n  #closePanel(trigger: HTMLElement): void {\n    const panel = this.#panelFor(trigger);\n    if (panel) panel.hidden = true;\n    trigger.setAttribute(\"aria-expanded\", \"false\");\n    this.#syncEscapeLayer();\n  }\n\n  /** Closes every open panel. */\n  #closeAll(): void {\n    for (const trigger of this.triggerTargets) this.#closePanel(trigger);\n  }\n\n  /**\n   * Aligns Escape-stack membership with the open state: joins (or re-asserts to\n   * the top) while a panel is open, leaves once none is. Re-asserting when the\n   * user switches panels is deliberate — the nav is again the newest layer.\n   */\n  #syncEscapeLayer(): void {\n    if (this.#isAnyOpen) {\n      this.#escapeLayer.activate(document, {\n        onDismiss: () => this.#closeAndRestore(),\n        claims: claimsWhileFocusWithin(this.element),\n      });\n    } else {\n      this.#escapeLayer.deactivate();\n    }\n  }\n\n  /** Closes any open panel and returns focus to its trigger (Escape path). */\n  #closeAndRestore(): void {\n    const open = this.#openTrigger;\n    if (!open) return;\n    this.#closePanel(open);\n    open.focus();\n  }\n\n  /** Closes panels when a click lands outside the nav element. */\n  readonly #onOutsideClick = (event: MouseEvent): void => {\n    if (this.#isAnyOpen && !this.element.contains(event.target as Node)) this.#closeAll();\n  };\n\n  /**\n   * Closes (without restoring focus) when focus leaves the nav for a known\n   * external destination. A null/non-Node destination is indeterminate:\n   * browsers use it for clicks on non-focusable content and for window\n   * deactivation, so those never close the nav here (matching the popover\n   * convention) — the outside-click handler decides pointer dismissal, and the\n   * Escape stack's body-focus claim keeps keyboard dismissal working.\n   */\n  readonly #onFocusOut = (event: FocusEvent): void => {\n    const next = event.relatedTarget;\n    if (!(next instanceof Node) || this.element.contains(next)) return;\n    this.#closeAll();\n  };\n\n  /** Opens a trigger's panel after the hover delay (hover mode). */\n  readonly #onPointerEnter = (event: Event): void => {\n    const trigger = this.#triggerForHover(event.currentTarget as HTMLElement);\n    if (!trigger) return;\n    this.#hoverTimers.clearAll();\n    this.#hoverTimers.set(() => this.#openPanel(trigger), this.hoverDelayValue);\n  };\n\n  /**\n   * Closes the open panel after the hover delay (hover mode) — unless the\n   * pointer moved directly into another part of the hover region (an adjacent\n   * trigger, panel, or hoverArea): crossing a shared edge must not schedule a\n   * spurious close, e.g. a hoverArea whose panel sits outside it as a sibling.\n   */\n  readonly #onPointerLeave = (event: Event): void => {\n    const next = event instanceof MouseEvent ? event.relatedTarget : null;\n    if (next instanceof Node && this.#hoverElements.some((el) => el.contains(next))) return;\n    this.#hoverTimers.clearAll();\n    this.#hoverTimers.set(() => this.#closeAll(), this.hoverDelayValue);\n  };\n\n  /** Wires hover open/close on each hover element (opt-in), tracking what was wired. */\n  #addHoverListeners(): void {\n    for (const element of this.#hoverElements) {\n      element.addEventListener(\"mouseenter\", this.#onPointerEnter);\n      element.addEventListener(\"mouseleave\", this.#onPointerLeave);\n      this.#hoverWired.add(element);\n    }\n  }\n\n  /** Removes the hover listeners from exactly the elements that were wired. */\n  #removeHoverListeners(): void {\n    for (const element of this.#hoverWired) {\n      element.removeEventListener(\"mouseenter\", this.#onPointerEnter);\n      element.removeEventListener(\"mouseleave\", this.#onPointerLeave);\n    }\n    this.#hoverWired.clear();\n  }\n\n  /**\n   * Rebuilds the hover wiring from the current targets. Target callbacks call\n   * this so items added or removed after connect (e.g. a Turbo Stream append)\n   * participate in hover; the wired-set removal keeps the rebuild symmetric.\n   */\n  #rewireHoverListeners(): void {\n    if (!this.openOnHoverValue) return;\n    this.#removeHoverListeners();\n    this.#addHoverListeners();\n  }\n\n  /**\n   * Elements that participate in hover: each `hoverArea`, plus every trigger and\n   * panel **not** wrapped by one. A wrapped trigger/panel must defer to its\n   * wrapper — its own mouseleave would otherwise schedule a close while the\n   * pointer is still inside the area (mouseenter does not re-fire on the wrapper\n   * when moving among its descendants), flickering the panel shut.\n   */\n  get #hoverElements(): HTMLElement[] {\n    const areas = this.hoverAreaTargets;\n    const covered = (element: HTMLElement): boolean => areas.some((area) => area.contains(element));\n    return [\n      ...areas,\n      ...this.triggerTargets.filter((trigger) => !covered(trigger)),\n      ...this.panelTargets.filter((panel) => !covered(panel)),\n    ];\n  }\n\n  /**\n   * Resolves the trigger for a hovered element: the trigger itself, the trigger\n   * controlling a hovered panel, or the first trigger contained in a hovered\n   * `hoverArea` wrapper.\n   */\n  #triggerForHover(element: HTMLElement): HTMLElement | null {\n    if (this.triggerTargets.includes(element)) return element;\n    if (this.panelTargets.includes(element)) {\n      return this.triggerTargets.find((trigger) => this.#panelFor(trigger) === element) ?? null;\n    }\n    if (this.hoverAreaTargets.includes(element)) {\n      return this.triggerTargets.find((trigger) => element.contains(trigger)) ?? null;\n    }\n    return null;\n  }\n\n  /** The panel controlled by `trigger` (matched by `aria-controls`/`id`). */\n  #panelFor(trigger: HTMLElement): HTMLElement | null {\n    const id = trigger.getAttribute(\"aria-controls\");\n    // Resolve against this controller's own panel targets (not a global id\n    // lookup) so it stays scoped to this nav instance.\n    return id ? (this.panelTargets.find((panel) => panel.id === id) ?? null) : null;\n  }\n\n  /** Whether `trigger`'s panel is currently expanded. */\n  #isExpanded(trigger: HTMLElement): boolean {\n    return trigger.getAttribute(\"aria-expanded\") === \"true\";\n  }\n\n  /** The trigger whose panel is currently open, if any. */\n  get #openTrigger(): HTMLElement | null {\n    return this.triggerTargets.find((trigger) => this.#isExpanded(trigger)) ?? null;\n  }\n\n  /** Whether any panel is currently open. */\n  get #isAnyOpen(): boolean {\n    return this.#openTrigger !== null;\n  }\n}\n"]}
+{"version":3,"sources":["../../src/utils/logical_scroll.ts","../../src/utils/arrow_step.ts","../../src/utils/escape_layer.ts","../../src/utils/safe_timeout.ts","../../src/controllers/navigation_menu_controller.ts"],"names":[],"mappings":"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","file":"navigation_menu_controller.js","sourcesContent":["/** Normalized scroll position and maximum distance on one logical axis. */\nexport interface LogicalScrollMetrics {\n  position: number;\n  max: number;\n}\n\n/**\n * Whether horizontal scrolling on `element` follows right-to-left inline flow.\n *\n * Resolved from the **computed** `direction`, so the authoring contract is the\n * usual `dir=\"rtl\"` (or a stylesheet) on the element or any ancestor.\n *\n * Scope: horizontal writing modes. A vertical writing mode (`writing-mode:\n * vertical-rl`) also inverts the horizontal axis, which this check does not\n * model — vertical writing modes are out of scope for the scroll utilities\n * (their consumers describe axes as horizontal/vertical, not inline/block).\n */\nexport function isRtl(element: Element): boolean {\n  return window.getComputedStyle(element).direction === \"rtl\";\n}\n\n/**\n * Returns scroll distance from the logical start edge.\n *\n * CSSOM View exposes standards-mode RTL horizontal offsets as `0` at the inline\n * start (right) and increasingly negative values toward the inline end (left).\n * The normalized position is always clamped to `[0, max]`, which also absorbs\n * Safari's elastic overscroll values.\n */\nexport function logicalScrollMetrics(\n  element: HTMLElement,\n  horizontal: boolean,\n): LogicalScrollMetrics {\n  const max = Math.max(\n    0,\n    horizontal\n      ? element.scrollWidth - element.clientWidth\n      : element.scrollHeight - element.clientHeight,\n  );\n  const raw = horizontal ? element.scrollLeft : element.scrollTop;\n  const position = horizontal && isRtl(element) ? -raw : raw;\n  return { position: Math.min(max, Math.max(0, position)), max };\n}\n\n/**\n * Converts a logical start/end delta to the physical value accepted by\n * `Element.scrollBy`.\n */\nexport function physicalScrollDelta(\n  element: HTMLElement,\n  horizontal: boolean,\n  logicalDelta: number,\n): number {\n  return horizontal && isRtl(element) ? -logicalDelta : logicalDelta;\n}\n","import { isRtl } from \"./logical_scroll\";\n\n/**\n * Turns an arrow key into a **logical** step: `+1` for \"next\", `-1` for\n * \"previous\", `0` when the key names neither.\n *\n * APG defines the horizontal pair as *next / previous* and says a vertical\n * arrangement swaps in Down/Up for the same meaning — so the pair is one axis's\n * spelling of an order, and the order reverses with the writing direction. Only\n * the horizontal pair reverses. Down/Up name an axis the writing direction does\n * not mirror, and returning them unchanged is the point: many controllers fold\n * both pairs into one branch, where swapping the branches under RTL would flip\n * the vertical axis too — a bug that reads as \"the arrows work\" until someone\n * presses Down.\n *\n * **Direction is read from the element the caller passes, which should be the\n * container that lays the items out** — not the focused child. A child may carry\n * its own `dir` (an LTR input inside an RTL form is ordinary authoring), and\n * probing per handler makes two handlers disagree at the boundary between them.\n *\n * This decides direction only. Whether the axis is even active (an\n * `orientation=\"horizontal\"` widget ignoring Down/Up), how far the step lands,\n * and what wrapping does all stay with the caller.\n *\n * **It encodes the list-order convention: `ArrowDown` is *next*.** Widgets that\n * pair the arrows by *value* instead — `ArrowUp` meaning \"more\", as a rating or a\n * slider does — must not use this, or their vertical axis inverts. Reverse the\n * horizontal pair on its own there.\n *\n * @example\n * ```ts\n * const step = logicalArrowStep(event.key, this.element);\n * if (step === 0) return;\n * this.#roving.setActive(rovingMove(current, length, step, \"wrap\"), { focus: true });\n * ```\n */\nexport function logicalArrowStep(key: string, element: Element): 1 | -1 | 0 {\n  if (key === \"ArrowDown\") return 1;\n  if (key === \"ArrowUp\") return -1;\n  if (key !== \"ArrowRight\" && key !== \"ArrowLeft\") return 0;\n  const forward = isRtl(element) ? \"ArrowLeft\" : \"ArrowRight\";\n  return key === forward ? 1 : -1;\n}\n\n/**\n * Rewrites `key` so an existing LTR-shaped branch keeps working under RTL:\n * `ArrowRight` and `ArrowLeft` trade places, everything else passes through.\n *\n * The alternative — negating a delta — silently breaks handlers whose two\n * horizontal branches are **not mirror images**. A grid that clamps one edge but\n * not the other, or a segmented field guarding `index > 0` on one side and\n * `index < length - 1` on the other, ends up applying the wrong guard to the\n * wrong direction. Swapping the key leaves each branch, guards and all, exactly\n * where its author put it.\n *\n * Same rule as {@link logicalArrowStep} about which element to read: pass the\n * container that lays the items out, not the focused child.\n *\n * @example\n * ```ts\n * switch (logicalArrowKey(event.key, this.element)) {\n *   case \"ArrowLeft\": // \"previous\" — whatever direction that is on screen\n * ```\n */\nexport function logicalArrowKey(key: string, element: Element): string {\n  if (key !== \"ArrowRight\" && key !== \"ArrowLeft\") return key;\n  if (!isRtl(element)) return key;\n  return key === \"ArrowRight\" ? \"ArrowLeft\" : \"ArrowRight\";\n}\n\n/** Modifiers a widget may claim on an arrow key, named for the `allow` list. */\nexport type ArrowModifier = \"alt\" | \"ctrl\" | \"meta\" | \"shift\";\n\n/**\n * True when an arrow key arrived carrying a modifier the widget must leave to\n * the browser: return without calling `preventDefault()` and without moving any\n * state.\n *\n * A bare arrow belongs to the widget; a chorded one usually does not.\n * `Alt`/`Meta` plus a horizontal arrow is history back/forward on every desktop\n * browser, and a widget that swallows it makes the shortcut work or not\n * depending on where focus happens to sit — a coin-flip the user cannot see.\n *\n * `allow` is for the combinations APG assigns to a pattern **and the widget\n * actually implements** — today only Combobox's optional `Alt+Down`/`Alt+Up`.\n * Listing one the widget does not implement defeats the point: the chord then\n * runs the plain-arrow branch, which is exactly what this guard exists to stop.\n * Non-arrow keys return `false`, so chorded letters and\n * `Control+Home`/`Control+End` are untouched.\n *\n * @example\n * ```ts\n * if (isReservedArrowChord(event)) return;\n * ```\n */\nexport function isReservedArrowChord(\n  event: KeyboardEvent,\n  allow: readonly ArrowModifier[] = [],\n): boolean {\n  if (!event.key.startsWith(\"Arrow\")) return false;\n  return (\n    (event.altKey && !allow.includes(\"alt\")) ||\n    (event.ctrlKey && !allow.includes(\"ctrl\")) ||\n    (event.metaKey && !allow.includes(\"meta\")) ||\n    (event.shiftKey && !allow.includes(\"shift\"))\n  );\n}\n","/**\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 handler resolves the\n * press. A keydown that is part of an IME composition (`event.isComposing`)\n * cancels the composition, never a layer, and is ignored here for every layer\n * 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 * 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 { isReservedArrowChord } from \"../utils/arrow_step\";\nimport { claimsWhileFocusWithin, EscapeLayer } from \"../utils/escape_layer\";\nimport { isRtl } from \"../utils/logical_scroll\";\nimport { SafeTimeout } from \"../utils/safe_timeout\";\n\n/**\n * Headless, accessible **navigation menu** behavior (disclosure navigation).\n *\n * Markup contract (identifier: `stimeo--navigation-menu`):\n *   <nav data-controller=\"stimeo--navigation-menu\" aria-label=\"Main\">\n *     <ul>\n *       <li>\n *         <button data-stimeo--navigation-menu-target=\"trigger\"\n *                 aria-expanded=\"false\" aria-controls=\"nav-products\"\n *                 data-action=\"click->stimeo--navigation-menu#toggle\n *                              keydown->stimeo--navigation-menu#onTriggerKeydown\">\n *           Products\n *         </button>\n *         <div id=\"nav-products\" data-stimeo--navigation-menu-target=\"panel\" hidden>\n *           <a href=\"/a\">Product A</a><a href=\"/b\">Product B</a>\n *         </div>\n *       </li>\n *     </ul>\n *   </nav>\n *\n * Implements the WAI-ARIA APG **Disclosure** navigation pattern: each top-level\n * button toggles its sub-panel (`aria-expanded` + `hidden` synced), only one panel\n * is open at a time, and the panel content is a plain set of links (not a\n * `role=\"menu\"`). Focus is **not** trapped — `Tab` moves through the links\n * naturally. `Escape` closes the open panel and returns focus to its trigger.\n * While a panel is open the nav is a layer on the shared {@link EscapeLayer}\n * stack; it claims a press only while focus is inside the nav or fell to the\n * body (a click on non-focusable panel content), so one keypress closes exactly\n * one layer. An outside click, or focus leaving the nav for a known external\n * destination, closes it. `ArrowLeft`/`ArrowRight` move focus between the\n * *navigable* triggers without rewriting `tabindex` (they keep their natural Tab\n * order); a modified press (`Alt`/`Ctrl`/`Meta`/`Shift`, e.g. the browser's\n * `Alt+←` history back) is left to the browser. Hover open/close is opt-in via\n * `openOnHover`.\n *\n * Every `panel` must be a **descendant of the nav element**: Stimulus resolves\n * targets within the controller's own scope, so a panel moved outside it (a\n * portal) never becomes a `panel` target and its trigger then opens nothing.\n *\n * By default the hover region is each trigger and its panel. An optional\n * `hoverArea` target widens it: mark a wrapper that contains **exactly one**\n * trigger (e.g. the `<li>` holding a top-level *link*, its disclosure button, and\n * its panel — the APG \"Disclosure Navigation with Top-Level Links\" arrangement)\n * and hovering anywhere over that wrapper opens the contained trigger's panel.\n * Wrapping several triggers at once (marking the whole `<ul>`, say) is not\n * supported: every hover over the area then resolves to the *first* contained\n * trigger. A trigger or panel inside a `hoverArea` defers to the wrapper (its own\n * edges stop scheduling open/close), so pointer movement within the area never\n * flickers the panel. Keep a trigger's panel inside its `hoverArea`: a panel left\n * outside simply falls back to the default two-region behavior — moving straight\n * across a shared edge never schedules a close (the leave handler checks\n * `relatedTarget`), and `hoverDelay` bridges the pointer's travel across an\n * actual gap. Targets added or removed **while connected** (e.g. a Turbo Stream\n * append) re-wire the hover listeners via Stimulus target callbacks; the same\n * callbacks also run during Stimulus teardown, so they no-op once disconnected.\n * Flipping `openOnHover` at runtime wires or unwires the listeners in place.\n * `hoverArea` has no effect unless `openOnHover` is enabled.\n *\n * Pointer-driven closing never hides focused content — hiding the panel would\n * take the focused link with it and drop focus to the body. So a hover *leave*\n * keeps the panel open while focus is inside it, and a hover *switch* to another\n * trigger returns focus to the outgoing trigger before hiding its panel. For the\n * same reason, while `openOnHover` is on, a click on a trigger whose hover region\n * the pointer currently occupies is a no-op: closing it would leave it unopenable\n * until the pointer left and re-entered (`mouseenter` does not re-fire in place).\n * `Escape` and outside clicks dismiss regardless.\n *\n * @remarks\n * Behavior only. Panel layout, mega-menu styling, and animation are the\n * consumer's CSS. Static placement is CSS; viewport-edge collision avoidance is\n * delegated to the opt-in `stimeo-ui/positioning` module (never imported here, so\n * the core stays zero-dependency). For an app command menu with arrow roving and\n * `role=\"menu\"`, use `stimeo--menubar` instead.\n */\nexport class NavigationMenuController extends Controller<HTMLElement> {\n  static override targets = [\"trigger\", \"panel\", \"hoverArea\"];\n  static override values = {\n    openOnHover: { type: Boolean, default: false },\n    hoverDelay: { type: Number, default: 150 },\n  };\n  static actions = [\"onTriggerKeydown\", \"toggle\"] as const;\n\n  declare readonly triggerTargets: HTMLElement[];\n  declare readonly panelTargets: HTMLElement[];\n  declare readonly hoverAreaTargets: HTMLElement[];\n\n  declare openOnHoverValue: boolean;\n  declare hoverDelayValue: number;\n\n  /** Open/close delay timers for hover mode; cleared together on disconnect. */\n  readonly #hoverTimers = new SafeTimeout();\n\n  /**\n   * Elements currently carrying hover listeners. Removal always mirrors this\n   * set (not a recomputed target snapshot), so a rebuild driven by target churn\n   * can never strand a listener on an element that stopped being a target.\n   */\n  readonly #hoverWired = new Set<HTMLElement>();\n\n  /**\n   * The trigger whose hover region the pointer currently occupies, if any. Only\n   * the click semantics under `openOnHover` read it (see {@link toggle}).\n   */\n  #hoveredTrigger: HTMLElement | null = null;\n\n  /**\n   * Whether the controller is between `connect()` and `disconnect()`. Stimulus\n   * disconnects the controller **before** disconnecting its targets, so the\n   * target callbacks below also fire during teardown; without this flag their\n   * rebuild would re-wire hover listeners onto an already-disconnected nav.\n   */\n  #connected = false;\n\n  /** Escape-stack membership while any panel is open; the shared resolver dismisses via it. */\n  readonly #escapeLayer = new EscapeLayer();\n\n  /** Establishes the closed baseline and the dismissal listeners. */\n  override connect(): void {\n    this.#connected = true;\n    this.#closeAll();\n    document.addEventListener(\"click\", this.#onOutsideClick, true);\n    this.element.addEventListener(\"focusout\", this.#onFocusOut);\n    if (this.openOnHoverValue) this.#addHoverListeners();\n  }\n\n  /** Removes every listener, pending hover timer, and stack membership taken while connected. */\n  override disconnect(): void {\n    this.#connected = false;\n    this.#escapeLayer.deactivate();\n    document.removeEventListener(\"click\", this.#onOutsideClick, true);\n    this.element.removeEventListener(\"focusout\", this.#onFocusOut);\n    this.#removeHoverListeners();\n    this.#hoverTimers.clearAll();\n  }\n\n  /**\n   * Follows a runtime flip of `openOnHover` (a morph or a scripted attribute\n   * change) by wiring or unwiring the hover listeners in place. Stimulus also\n   * fires this once before `connect()`, which the `#connected` guard skips —\n   * `connect()` owns the initial wiring.\n   */\n  openOnHoverValueChanged(): void {\n    if (!this.#connected) return;\n    if (this.openOnHoverValue) this.#addHoverListeners();\n    else this.#removeHoverListeners();\n  }\n\n  /** Re-wires hover listeners when a target is added after connect (Turbo Streams etc.). */\n  triggerTargetConnected(): void {\n    this.#rewireHoverListeners();\n  }\n\n  /** Re-wires hover listeners when a target is removed while connected. */\n  triggerTargetDisconnected(): void {\n    this.#rewireHoverListeners();\n  }\n\n  /** See {@link NavigationMenuController.triggerTargetConnected}. */\n  panelTargetConnected(): void {\n    this.#rewireHoverListeners();\n  }\n\n  /** See {@link NavigationMenuController.triggerTargetDisconnected}. */\n  panelTargetDisconnected(): void {\n    this.#rewireHoverListeners();\n  }\n\n  /** See {@link NavigationMenuController.triggerTargetConnected}. */\n  hoverAreaTargetConnected(): void {\n    this.#rewireHoverListeners();\n  }\n\n  /** See {@link NavigationMenuController.triggerTargetDisconnected}. */\n  hoverAreaTargetDisconnected(): void {\n    this.#rewireHoverListeners();\n  }\n\n  /**\n   * Toggles a trigger's panel (single-open). Bound via `data-action` (click).\n   *\n   * An explicit activation always wins over a scheduled hover open/close, so any\n   * pending hover timer is dropped first — otherwise a close scheduled just\n   * before the click would fire into the freshly opened panel.\n   *\n   * Under `openOnHover`, closing a panel the pointer itself is holding open is\n   * refused: the pointer stays put, `mouseenter` does not re-fire, and the panel\n   * would be unopenable until the pointer left and came back. Keyboard\n   * activation (pointer elsewhere) still toggles it closed, and `Escape` and\n   * outside clicks dismiss either way.\n   */\n  toggle(event: Event): void {\n    const trigger = event.currentTarget as HTMLElement;\n    this.#hoverTimers.clearAll();\n    if (!this.#isExpanded(trigger)) {\n      this.#openPanel(trigger);\n      return;\n    }\n    if (this.openOnHoverValue && this.#hoveredTrigger === trigger) return;\n    this.#closePanel(trigger);\n  }\n\n  /**\n   * `ArrowLeft`/`ArrowRight` move focus between triggers (keeping Tab order).\n   *\n   * Only navigable triggers are destinations, so a `hidden` or disabled item\n   * never swallows the press. A modified arrow belongs to the browser or OS\n   * (`Alt+←`/`Alt+→` is history back/forward), and with no destination at all\n   * (a single-trigger nav) the press is left to the page — `preventDefault()` is\n   * called only when focus actually moves, keeping the scroll-suppression\n   * contract honest.\n   */\n  onTriggerKeydown(event: KeyboardEvent): void {\n    // A descendant widget that already claimed the key must not ALSO move the\n    // trigger focus — composition depends on this yield. It runs ahead of the\n    // modifier check, so a claimed press is yielded whether or not it carries a\n    // modifier.\n    if (event.defaultPrevented) return;\n    if (event.key !== \"ArrowRight\" && event.key !== \"ArrowLeft\") return;\n    if (isReservedArrowChord(event)) return;\n\n    const current = event.currentTarget as HTMLElement;\n    // The focused trigger stays in the ring even when it is not navigable\n    // itself, so arrows still lead *out* of a trigger disabled while focused.\n    const triggers = this.triggerTargets.filter(\n      (trigger) => trigger === current || this.#isNavigable(trigger),\n    );\n    const index = triggers.indexOf(current);\n    if (index === -1 || triggers.length < 2) return;\n\n    event.preventDefault();\n    // Logical, not physical: the triggers are an ordered row, so which one is\n    // \"next\" follows the writing direction. Read from the controller element —\n    // the nav lays the triggers out, and a trigger may carry its own `dir`.\n    const forward = isRtl(this.element) ? \"ArrowLeft\" : \"ArrowRight\";\n    const step = event.key === forward ? 1 : -1;\n    triggers[(index + step + triggers.length) % triggers.length]?.focus();\n  }\n\n  /**\n   * Opens `trigger`'s panel, closing any other open panel first. Re-opening an\n   * already-open panel only re-asserts the Escape layer: the close/open\n   * round-trip would rewrite `aria-expanded` and `hidden` for no state change.\n   */\n  #openPanel(trigger: HTMLElement): void {\n    // Guarded here rather than in `toggle`, because hover reaches this method\n    // without going through it. Reaching an `aria-disabled` trigger is what the\n    // attribute asks for — opening its panel is the activation it forbids, and\n    // opening a popup counts as activation.\n    if (trigger.getAttribute(\"aria-disabled\") === \"true\") return;\n    if (this.#isExpanded(trigger)) {\n      this.#syncEscapeLayer();\n      return;\n    }\n    this.#closeAll();\n    const panel = this.#panelFor(trigger);\n    if (!panel) return;\n    panel.hidden = false;\n    trigger.setAttribute(\"aria-expanded\", \"true\");\n    this.#syncEscapeLayer();\n  }\n\n  /** Closes `trigger`'s panel and reflects the collapsed state. */\n  #closePanel(trigger: HTMLElement): void {\n    const panel = this.#panelFor(trigger);\n    if (panel) panel.hidden = true;\n    trigger.setAttribute(\"aria-expanded\", \"false\");\n    this.#syncEscapeLayer();\n  }\n\n  /**\n   * Closes every open panel and normalizes `aria-expanded=\"false\"` on **all**\n   * triggers, so a trigger whose panel was hidden by other means cannot keep\n   * advertising an open panel.\n   */\n  #closeAll(): void {\n    for (const trigger of this.triggerTargets) this.#closePanel(trigger);\n  }\n\n  /**\n   * Whether a trigger can receive arrow-key focus: not `hidden`, not a natively\n   * `disabled` control (mirrors `toolbar`). CSS-only visibility cannot be\n   * detected headlessly and stays the consumer's responsibility.\n   *\n   * **`aria-disabled=\"true\"` stays reachable.** APG separates the attributes by\n   * intent: `disabled` is for controls a neighbour makes inferable, while\n   * `aria-disabled` marks one that must remain *discoverable* — and a nav\n   * section the user cannot even arrow to is a section they cannot learn exists.\n   * Opening is suppressed separately, so the trigger announces itself and does\n   * nothing.\n   */\n  #isNavigable(trigger: HTMLElement): boolean {\n    if (trigger.hasAttribute(\"hidden\")) return false;\n    return !(trigger as HTMLButtonElement | HTMLInputElement).disabled;\n  }\n\n  /**\n   * Aligns Escape-stack membership with the open state: joins (or re-asserts to\n   * the top) while a panel is open, leaves once none is. Re-asserting when the\n   * user switches panels is deliberate — the nav is again the newest layer.\n   */\n  #syncEscapeLayer(): void {\n    if (this.#isAnyOpen) {\n      this.#escapeLayer.activate(document, {\n        onDismiss: () => this.#closeAndRestore(),\n        claims: claimsWhileFocusWithin(this.element),\n      });\n    } else {\n      this.#escapeLayer.deactivate();\n    }\n  }\n\n  /**\n   * Closes any open panel and returns focus to its trigger (Escape path). A\n   * pending hover open would otherwise re-open the panel the user just\n   * dismissed, so the reservation is dropped with it.\n   */\n  #closeAndRestore(): void {\n    const open = this.#openTrigger;\n    if (!open) return;\n    this.#hoverTimers.clearAll();\n    this.#closePanel(open);\n    open.focus();\n  }\n\n  /** Closes panels when a click lands outside the nav element. */\n  readonly #onOutsideClick = (event: MouseEvent): void => {\n    if (this.#isAnyOpen && !this.element.contains(event.target as Node)) this.#closeAll();\n  };\n\n  /**\n   * Closes (without restoring focus) when focus leaves the nav for a known\n   * external destination. A null/non-Node destination is indeterminate:\n   * browsers use it for clicks on non-focusable content and for window\n   * deactivation, so those never close the nav here (matching the popover\n   * convention) — the outside-click handler decides pointer dismissal, and the\n   * Escape stack's body-focus claim keeps keyboard dismissal working.\n   */\n  readonly #onFocusOut = (event: FocusEvent): void => {\n    const next = event.relatedTarget;\n    if (!(next instanceof Node) || this.element.contains(next)) return;\n    this.#closeAll();\n  };\n\n  /** Opens a trigger's panel after the hover delay (hover mode). */\n  readonly #onPointerEnter = (event: Event): void => {\n    const trigger = this.#triggerForHover(event.currentTarget as HTMLElement);\n    if (!trigger) return;\n    this.#hoveredTrigger = trigger;\n    this.#hoverTimers.clearAll();\n    this.#hoverTimers.set(() => this.#openFromHover(trigger), this.hoverDelayValue);\n  };\n\n  /**\n   * Closes the open panel after the hover delay (hover mode) — unless the\n   * pointer moved directly into another part of the hover region (an adjacent\n   * trigger, panel, or hoverArea): crossing a shared edge must not schedule a\n   * spurious close, e.g. a hoverArea whose panel sits outside it as a sibling.\n   */\n  readonly #onPointerLeave = (event: Event): void => {\n    const next = event instanceof MouseEvent ? event.relatedTarget : null;\n    if (next instanceof Node && this.#hoverElements.some((el) => el.contains(next))) return;\n    this.#hoveredTrigger = null;\n    this.#hoverTimers.clearAll();\n    this.#hoverTimers.set(() => this.#closeFromHover(), this.hoverDelayValue);\n  };\n\n  /**\n   * Hover-driven open. Switching panels would hide the outgoing one, so focus\n   * standing inside it is handed back to its trigger first: pointer movement\n   * must never send focus to the body (the keyboard user would lose their\n   * place). Focus outside the closing panel is left alone.\n   */\n  #openFromHover(trigger: HTMLElement): void {\n    // Checked before the rescue below, not only inside `#openPanel`. The rescue\n    // exists to get focus out of a panel that is about to be hidden; when the\n    // destination refuses to open, nothing is hidden and moving focus buys\n    // nothing — it just walks the caret out of a panel that stays open.\n    if (trigger.getAttribute(\"aria-disabled\") === \"true\") return;\n    const open = this.#openTrigger;\n    if (open && open !== trigger && this.#holdsFocus(this.#panelFor(open))) open.focus();\n    this.#openPanel(trigger);\n  }\n\n  /**\n   * Hover-driven close: skipped while focus sits inside the panel it would hide,\n   * for the same no-focus-loss reason (cf. `hover_card`'s delayed close). The\n   * panel then stays open until `Escape`, an outside click, or focus leaving the\n   * nav dismisses it — all of which restore or keep focus deliberately.\n   */\n  #closeFromHover(): void {\n    const open = this.#openTrigger;\n    if (open && this.#holdsFocus(this.#panelFor(open))) return;\n    this.#closeAll();\n  }\n\n  /** Whether `panel` exists and currently contains the focused element. */\n  #holdsFocus(panel: HTMLElement | null): boolean {\n    return panel?.contains(document.activeElement) ?? false;\n  }\n\n  /** Wires hover open/close on each hover element (opt-in), tracking what was wired. */\n  #addHoverListeners(): void {\n    for (const element of this.#hoverElements) {\n      element.addEventListener(\"mouseenter\", this.#onPointerEnter);\n      element.addEventListener(\"mouseleave\", this.#onPointerLeave);\n      this.#hoverWired.add(element);\n    }\n  }\n\n  /** Removes the hover listeners from exactly the elements that were wired. */\n  #removeHoverListeners(): void {\n    for (const element of this.#hoverWired) {\n      element.removeEventListener(\"mouseenter\", this.#onPointerEnter);\n      element.removeEventListener(\"mouseleave\", this.#onPointerLeave);\n    }\n    this.#hoverWired.clear();\n    this.#hoveredTrigger = null;\n  }\n\n  /**\n   * Rebuilds the hover wiring from the current targets. Target callbacks call\n   * this so items added or removed after connect (e.g. a Turbo Stream append)\n   * participate in hover; the wired-set removal keeps the rebuild symmetric.\n   * Stimulus fires those callbacks during teardown too, hence the `#connected`\n   * guard — a rebuild after `disconnect()` would resurrect the listeners.\n   */\n  #rewireHoverListeners(): void {\n    if (!this.#connected || !this.openOnHoverValue) return;\n    this.#removeHoverListeners();\n    this.#addHoverListeners();\n  }\n\n  /**\n   * Elements that participate in hover: each `hoverArea`, plus every trigger and\n   * panel **not** wrapped by one. A wrapped trigger/panel must defer to its\n   * wrapper — its own mouseleave would otherwise schedule a close while the\n   * pointer is still inside the area (mouseenter does not re-fire on the wrapper\n   * when moving among its descendants), flickering the panel shut.\n   */\n  get #hoverElements(): HTMLElement[] {\n    const areas = this.hoverAreaTargets;\n    const covered = (element: HTMLElement): boolean => areas.some((area) => area.contains(element));\n    return [\n      ...areas,\n      ...this.triggerTargets.filter((trigger) => !covered(trigger)),\n      ...this.panelTargets.filter((panel) => !covered(panel)),\n    ];\n  }\n\n  /**\n   * Resolves the trigger for a hovered element: the trigger itself, the trigger\n   * controlling a hovered panel, or the first trigger contained in a hovered\n   * `hoverArea` wrapper.\n   */\n  #triggerForHover(element: HTMLElement): HTMLElement | null {\n    if (this.triggerTargets.includes(element)) return element;\n    if (this.panelTargets.includes(element)) {\n      return this.triggerTargets.find((trigger) => this.#panelFor(trigger) === element) ?? null;\n    }\n    if (this.hoverAreaTargets.includes(element)) {\n      return this.triggerTargets.find((trigger) => element.contains(trigger)) ?? null;\n    }\n    return null;\n  }\n\n  /** The panel controlled by `trigger` (matched by `aria-controls`/`id`). */\n  #panelFor(trigger: HTMLElement): HTMLElement | null {\n    const id = trigger.getAttribute(\"aria-controls\");\n    // Resolve against this controller's own panel targets (not a global id\n    // lookup) so it stays scoped to this nav instance.\n    return id ? (this.panelTargets.find((panel) => panel.id === id) ?? null) : null;\n  }\n\n  /** Whether `trigger`'s panel is currently expanded. */\n  #isExpanded(trigger: HTMLElement): boolean {\n    return trigger.getAttribute(\"aria-expanded\") === \"true\";\n  }\n\n  /** The trigger whose panel is currently open, if any. */\n  get #openTrigger(): HTMLElement | null {\n    return this.triggerTargets.find((trigger) => this.#isExpanded(trigger)) ?? null;\n  }\n\n  /** Whether any panel is currently open. */\n  get #isAnyOpen(): boolean {\n    return this.#openTrigger !== null;\n  }\n}\n"]}

package/dist/controllers/nested_form_controller.d.ts

@@ -28,11 +28,10 @@ import { Controller } from '@hotwired/stimulus';
  * (inserted nodes + each `_destroy` hidden input); there is no module-scope index
  * counter, so the controller stays idempotent across Turbo swaps. Remove buttons
  * are handled by **delegation** on the container, so dynamically-added rows work
- * without per-row `data-action` (see `stimulus-lifecycle-turbo`). Adding a row moves
- * focus to its first control and removing returns focus to a neighbor (WCAG 2.2
- * 2.4.3); count changes are announced through the shared `stimeo--announcer`
- * (WCAG 2.2 4.1.3) when `announce` + `countMessage` are set. The delegated listener
- * is removed on `disconnect()`.
+ * without per-row `data-action`. Adding a row moves focus to its first control and
+ * removing returns focus to a neighbor (WCAG 2.2 2.4.3); count changes are announced
+ * through the shared `stimeo--announcer` (WCAG 2.2 4.1.3) when `announce` +
+ * `countMessage` are set. The delegated listener is removed on `disconnect()`.
  */
 declare class NestedFormController extends Controller<HTMLElement> {
     #private;

package/dist/controllers/nested_form_controller.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/controllers/nested_form_controller.ts"],"names":[],"mappings":"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","file":"nested_form_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\n\n/**\n * Headless **nested / dynamic fields** for Rails `fields_for` +\n * `accepts_nested_attributes_for` (no dedicated APG pattern — form editing). The\n * Headless successor to the cocoon / nested_form gems: clone a `<template>` row,\n * renumber its index, and remove rows by flagging `_destroy` (persisted) or\n * dropping them from the DOM (unsaved).\n *\n * Markup contract (identifier: `stimeo--nested-form`):\n *   <div data-controller=\"stimeo--nested-form\" data-stimeo--nested-form-min-value=\"1\">\n *     <div data-stimeo--nested-form-target=\"list\">\n *       <!-- existing rows; a persisted row carries a _destroy flag + remove button -->\n *     </div>\n *     <template data-stimeo--nested-form-target=\"template\">\n *       <fieldset>\n *         <input name=\"order[items_attributes][__INDEX__][name]\">\n *         <button type=\"button\" data-stimeo--nested-form-target=\"remove\">Remove</button>\n *       </fieldset>\n *     </template>\n *     <button type=\"button\" data-stimeo--nested-form-target=\"add\"\n *             data-action=\"click->stimeo--nested-form#add\">Add</button>\n *   </div>\n *\n * @remarks\n * Behavior only — server-side `accepts_nested_attributes_for`, per-field\n * validation, and reordering are out of scope. Row state lives **only** in the DOM\n * (inserted nodes + each `_destroy` hidden input); there is no module-scope index\n * counter, so the controller stays idempotent across Turbo swaps. Remove buttons\n * are handled by **delegation** on the container, so dynamically-added rows work\n * without per-row `data-action` (see `stimulus-lifecycle-turbo`). Adding a row moves\n * focus to its first control and removing returns focus to a neighbor (WCAG 2.2\n * 2.4.3); count changes are announced through the shared `stimeo--announcer`\n * (WCAG 2.2 4.1.3) when `announce` + `countMessage` are set. The delegated listener\n * is removed on `disconnect()`.\n */\nexport class NestedFormController extends Controller<HTMLElement> {\n  static override targets = [\"list\", \"template\", \"add\", \"remove\", \"destroyFlag\"];\n  static override values = {\n    min: { type: Number, default: 0 },\n    max: { type: Number, default: 0 },\n    indexPlaceholder: { type: String, default: \"__INDEX__\" },\n    announce: { type: Boolean, default: true },\n    countMessage: { type: String, default: \"\" },\n  };\n  static actions = [\"add\"] as const;\n  static events = [\"add\", \"remove\"] as const;\n\n  declare readonly listTarget: HTMLElement;\n  declare readonly templateTarget: HTMLTemplateElement;\n  declare readonly addTarget: HTMLButtonElement;\n  declare readonly hasListTarget: boolean;\n  declare readonly hasTemplateTarget: boolean;\n  declare readonly hasAddTarget: boolean;\n\n  declare minValue: number;\n  declare maxValue: number;\n  declare indexPlaceholderValue: string;\n  declare announceValue: boolean;\n  declare countMessageValue: string;\n\n  /** Monotonic source for unique row indices; never a row-state counter. */\n  #lastIndex = 0;\n\n  /** Delegated click handler for the per-row remove buttons (dynamic-safe). */\n  readonly #onClick = (event: Event): void => {\n    const target = event.target as HTMLElement | null;\n    const button = target?.closest('[data-stimeo--nested-form-target=\"remove\"]');\n    if (!button || !this.element.contains(button)) return;\n    const row = this.#rowContaining(button);\n    if (row) this.#removeRow(row);\n  };\n\n  override connect(): void {\n    this.element.addEventListener(\"click\", this.#onClick);\n    this.#refresh();\n  }\n\n  override disconnect(): void {\n    this.element.removeEventListener(\"click\", this.#onClick);\n  }\n\n  /**\n   * Clones the template row, replaces the index placeholder with a unique value,\n   * appends it, focuses its first control, and announces the new count. No-ops at\n   * `max`.\n   */\n  add(): void {\n    if (!this.hasTemplateTarget || !this.hasListTarget || this.#atMax) return;\n\n    const index = this.#nextIndex();\n    const markup = this.templateTarget.innerHTML.replaceAll(\n      this.indexPlaceholderValue,\n      String(index),\n    );\n    this.listTarget.insertAdjacentHTML(\"beforeend\", markup);\n    const row = this.listTarget.lastElementChild as HTMLElement | null;\n    if (!row) return;\n\n    this.#refresh();\n    this.#firstControl(row)?.focus();\n    this.dispatch(\"add\", { detail: { index, element: row } });\n    this.#announce();\n  }\n\n  /**\n   * Removes a row: a persisted row (one carrying a `destroyFlag`) has its flag set\n   * to `1` and is hidden so Rails destroys it on submit; an unsaved row is dropped\n   * from the DOM. Returns focus to a neighboring row. No-ops at `min`.\n   */\n  #removeRow(row: HTMLElement): void {\n    if (this.#effectiveRows.length <= this.minValue) return;\n\n    const neighbors = this.#effectiveRows;\n    const position = neighbors.indexOf(row);\n    const neighbor = neighbors[position + 1] ?? neighbors[position - 1] ?? null;\n\n    const flag = row.querySelector<HTMLInputElement>(\n      '[data-stimeo--nested-form-target=\"destroyFlag\"]',\n    );\n    const persisted = flag !== null;\n    if (persisted) {\n      flag.value = \"1\";\n      row.hidden = true;\n    } else {\n      row.remove();\n    }\n\n    this.#refresh();\n    const focusTarget = neighbor\n      ? this.#firstControl(neighbor)\n      : this.hasAddTarget\n        ? this.addTarget\n        : null;\n    focusTarget?.focus();\n    this.dispatch(\"remove\", { detail: { element: row, persisted } });\n    this.#announce();\n  }\n\n  /** Recomputes the live count and the min/max state hooks from the DOM. */\n  #refresh(): void {\n    const count = this.#effectiveRows.length;\n    this.element.setAttribute(\"data-nested-count\", String(count));\n    this.#reflect(\"data-nested-at-max\", this.maxValue > 0 && count >= this.maxValue);\n    this.#reflect(\"data-nested-at-min\", count <= this.minValue);\n    if (this.hasAddTarget) this.addTarget.disabled = this.#atMax;\n  }\n\n  /** Bridges the count change to the shared announcer when configured. */\n  #announce(): void {\n    if (!this.announceValue || !this.countMessageValue) return;\n    const message = this.countMessageValue.replaceAll(\n      \"{count}\",\n      String(this.#effectiveRows.length),\n    );\n    window.dispatchEvent(new CustomEvent(\"stimeo--announcer:announce\", { detail: { message } }));\n  }\n\n  /** Sets `attribute` to `\"true\"` when `on`, else removes it. */\n  #reflect(attribute: string, on: boolean): void {\n    if (on) this.element.setAttribute(attribute, \"true\");\n    else this.element.removeAttribute(attribute);\n  }\n\n  /** A strictly-increasing unique index (collision-free even on rapid adds). */\n  #nextIndex(): number {\n    const index = Math.max(Date.now(), this.#lastIndex + 1);\n    this.#lastIndex = index;\n    return index;\n  }\n\n  get #atMax(): boolean {\n    return this.maxValue > 0 && this.#effectiveRows.length >= this.maxValue;\n  }\n\n  /** Direct child rows of the list that are not flagged for destruction. */\n  get #effectiveRows(): HTMLElement[] {\n    return (Array.from(this.listTarget.children) as HTMLElement[]).filter((row) => !row.hidden);\n  }\n\n  /** The nearest ancestor of `el` that is a direct child of the list, else null. */\n  #rowContaining(el: Element): HTMLElement | null {\n    let node: Element | null = el;\n    while (node && node.parentElement !== this.listTarget) {\n      node = node.parentElement;\n    }\n    return node as HTMLElement | null;\n  }\n\n  /** First visible focusable control inside `row` (skips hidden inputs). */\n  #firstControl(row: HTMLElement): HTMLElement | null {\n    return row.querySelector<HTMLElement>(\n      'input:not([type=\"hidden\"]), select, textarea, button, [tabindex]',\n    );\n  }\n}\n"]}
+{"version":3,"sources":["../../src/controllers/nested_form_controller.ts"],"names":[],"mappings":"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","file":"nested_form_controller.js","sourcesContent":["import { Controller } from \"@hotwired/stimulus\";\n\n/**\n * Headless **nested / dynamic fields** for Rails `fields_for` +\n * `accepts_nested_attributes_for` (no dedicated APG pattern — form editing). The\n * Headless successor to the cocoon / nested_form gems: clone a `<template>` row,\n * renumber its index, and remove rows by flagging `_destroy` (persisted) or\n * dropping them from the DOM (unsaved).\n *\n * Markup contract (identifier: `stimeo--nested-form`):\n *   <div data-controller=\"stimeo--nested-form\" data-stimeo--nested-form-min-value=\"1\">\n *     <div data-stimeo--nested-form-target=\"list\">\n *       <!-- existing rows; a persisted row carries a _destroy flag + remove button -->\n *     </div>\n *     <template data-stimeo--nested-form-target=\"template\">\n *       <fieldset>\n *         <input name=\"order[items_attributes][__INDEX__][name]\">\n *         <button type=\"button\" data-stimeo--nested-form-target=\"remove\">Remove</button>\n *       </fieldset>\n *     </template>\n *     <button type=\"button\" data-stimeo--nested-form-target=\"add\"\n *             data-action=\"click->stimeo--nested-form#add\">Add</button>\n *   </div>\n *\n * @remarks\n * Behavior only — server-side `accepts_nested_attributes_for`, per-field\n * validation, and reordering are out of scope. Row state lives **only** in the DOM\n * (inserted nodes + each `_destroy` hidden input); there is no module-scope index\n * counter, so the controller stays idempotent across Turbo swaps. Remove buttons\n * are handled by **delegation** on the container, so dynamically-added rows work\n * without per-row `data-action`. Adding a row moves focus to its first control and\n * removing returns focus to a neighbor (WCAG 2.2 2.4.3); count changes are announced\n * through the shared `stimeo--announcer` (WCAG 2.2 4.1.3) when `announce` +\n * `countMessage` are set. The delegated listener is removed on `disconnect()`.\n */\nexport class NestedFormController extends Controller<HTMLElement> {\n  static override targets = [\"list\", \"template\", \"add\", \"remove\", \"destroyFlag\"];\n  static override values = {\n    min: { type: Number, default: 0 },\n    max: { type: Number, default: 0 },\n    indexPlaceholder: { type: String, default: \"__INDEX__\" },\n    announce: { type: Boolean, default: true },\n    countMessage: { type: String, default: \"\" },\n  };\n  static actions = [\"add\"] as const;\n  static events = [\"add\", \"remove\"] as const;\n\n  declare readonly listTarget: HTMLElement;\n  declare readonly templateTarget: HTMLTemplateElement;\n  declare readonly addTarget: HTMLButtonElement;\n  declare readonly hasListTarget: boolean;\n  declare readonly hasTemplateTarget: boolean;\n  declare readonly hasAddTarget: boolean;\n\n  declare minValue: number;\n  declare maxValue: number;\n  declare indexPlaceholderValue: string;\n  declare announceValue: boolean;\n  declare countMessageValue: string;\n\n  /** Monotonic source for unique row indices; never a row-state counter. */\n  #lastIndex = 0;\n\n  /** Delegated click handler for the per-row remove buttons (dynamic-safe). */\n  readonly #onClick = (event: Event): void => {\n    const target = event.target as HTMLElement | null;\n    const button = target?.closest('[data-stimeo--nested-form-target=\"remove\"]');\n    if (!button || !this.element.contains(button)) return;\n    const row = this.#rowContaining(button);\n    if (row) this.#removeRow(row);\n  };\n\n  override connect(): void {\n    this.element.addEventListener(\"click\", this.#onClick);\n    this.#refresh();\n  }\n\n  override disconnect(): void {\n    this.element.removeEventListener(\"click\", this.#onClick);\n  }\n\n  /**\n   * Clones the template row, replaces the index placeholder with a unique value,\n   * appends it, focuses its first control, and announces the new count. No-ops at\n   * `max`.\n   */\n  add(): void {\n    if (!this.hasTemplateTarget || !this.hasListTarget || this.#atMax) return;\n\n    const index = this.#nextIndex();\n    const markup = this.templateTarget.innerHTML.replaceAll(\n      this.indexPlaceholderValue,\n      String(index),\n    );\n    this.listTarget.insertAdjacentHTML(\"beforeend\", markup);\n    const row = this.listTarget.lastElementChild as HTMLElement | null;\n    if (!row) return;\n\n    this.#refresh();\n    this.#firstControl(row)?.focus();\n    this.dispatch(\"add\", { detail: { index, element: row } });\n    this.#announce();\n  }\n\n  /**\n   * Removes a row: a persisted row (one carrying a `destroyFlag`) has its flag set\n   * to `1` and is hidden so Rails destroys it on submit; an unsaved row is dropped\n   * from the DOM. Returns focus to a neighboring row. No-ops at `min`.\n   */\n  #removeRow(row: HTMLElement): void {\n    if (this.#effectiveRows.length <= this.minValue) return;\n\n    const neighbors = this.#effectiveRows;\n    const position = neighbors.indexOf(row);\n    const neighbor = neighbors[position + 1] ?? neighbors[position - 1] ?? null;\n\n    const flag = row.querySelector<HTMLInputElement>(\n      '[data-stimeo--nested-form-target=\"destroyFlag\"]',\n    );\n    const persisted = flag !== null;\n    if (persisted) {\n      flag.value = \"1\";\n      row.hidden = true;\n    } else {\n      row.remove();\n    }\n\n    this.#refresh();\n    const focusTarget = neighbor\n      ? this.#firstControl(neighbor)\n      : this.hasAddTarget\n        ? this.addTarget\n        : null;\n    focusTarget?.focus();\n    this.dispatch(\"remove\", { detail: { element: row, persisted } });\n    this.#announce();\n  }\n\n  /** Recomputes the live count and the min/max state hooks from the DOM. */\n  #refresh(): void {\n    const count = this.#effectiveRows.length;\n    this.element.setAttribute(\"data-nested-count\", String(count));\n    this.#reflect(\"data-nested-at-max\", this.maxValue > 0 && count >= this.maxValue);\n    this.#reflect(\"data-nested-at-min\", count <= this.minValue);\n    if (this.hasAddTarget) this.addTarget.disabled = this.#atMax;\n  }\n\n  /** Bridges the count change to the shared announcer when configured. */\n  #announce(): void {\n    if (!this.announceValue || !this.countMessageValue) return;\n    const message = this.countMessageValue.replaceAll(\n      \"{count}\",\n      String(this.#effectiveRows.length),\n    );\n    window.dispatchEvent(new CustomEvent(\"stimeo--announcer:announce\", { detail: { message } }));\n  }\n\n  /** Sets `attribute` to `\"true\"` when `on`, else removes it. */\n  #reflect(attribute: string, on: boolean): void {\n    if (on) this.element.setAttribute(attribute, \"true\");\n    else this.element.removeAttribute(attribute);\n  }\n\n  /** A strictly-increasing unique index (collision-free even on rapid adds). */\n  #nextIndex(): number {\n    const index = Math.max(Date.now(), this.#lastIndex + 1);\n    this.#lastIndex = index;\n    return index;\n  }\n\n  get #atMax(): boolean {\n    return this.maxValue > 0 && this.#effectiveRows.length >= this.maxValue;\n  }\n\n  /** Direct child rows of the list that are not flagged for destruction. */\n  get #effectiveRows(): HTMLElement[] {\n    return (Array.from(this.listTarget.children) as HTMLElement[]).filter((row) => !row.hidden);\n  }\n\n  /** The nearest ancestor of `el` that is a direct child of the list, else null. */\n  #rowContaining(el: Element): HTMLElement | null {\n    let node: Element | null = el;\n    while (node && node.parentElement !== this.listTarget) {\n      node = node.parentElement;\n    }\n    return node as HTMLElement | null;\n  }\n\n  /** First visible focusable control inside `row` (skips hidden inputs). */\n  #firstControl(row: HTMLElement): HTMLElement | null {\n    return row.querySelector<HTMLElement>(\n      'input:not([type=\"hidden\"]), select, textarea, button, [tabindex]',\n    );\n  }\n}\n"]}

package/dist/controllers/number_input_controller.d.ts

@@ -23,7 +23,7 @@ import { Controller } from '@hotwired/stimulus';
  * Implements the WAI-ARIA APG **Spinbutton** pattern. The arrow/step logic is
  * fully owned by the controller (not delegated to the browser's native number
  * stepping) so the behavior is identical for a native `<input type="number">` and
- * a custom `role="spinbutton"` host, and deterministic under happy-dom.
+ * a custom `role="spinbutton"` host.
  *
  * @remarks
  * Behavior only — the consumer styles the field and buttons. The input is the

package/dist/controllers/number_input_controller.js

@@ -2,6 +2,12 @@ import { Controller } from '@hotwired/stimulus';
 
 // src/controllers/number_input_controller.ts
 
+// src/utils/arrow_step.ts
+function isReservedArrowChord(event, allow = []) {
+  if (!event.key.startsWith("Arrow")) return false;
+  return event.altKey && !allow.includes("alt") || event.ctrlKey && !allow.includes("ctrl") || event.metaKey && !allow.includes("meta") || event.shiftKey && !allow.includes("shift");
+}
+
 // src/utils/safe_timeout.ts
 var TimerRegistry = class {
   /** Live timer ids that have not yet been cleared (or, for timeouts, fired). */
@@ -148,6 +154,7 @@ var NumberInputController = class _NumberInputController extends Controller {
   }
   /** Keyboard stepping per the APG spinbutton model. */
   onKeydown(event) {
+    if (isReservedArrowChord(event)) return;
     const page = this.pageStepValue > 0 ? this.pageStepValue : this.stepValue * 10;
     let next = null;
     switch (event.key) {