@dloizides/game-input 1.3.0 → 1.5.0

package/CHANGELOG.md

@@ -1,26 +1,41 @@
-# Changelog
-
-All notable changes to `@dloizides/game-input` are documented here.
-
-## 1.3.0
-
-Standard Gamepad action poller (first consumer: NextGame console-dashboard UI).
-
-- `stepPad(prev, next, repeat, now)` — pure per-frame reducer: face/shoulder buttons fire on the
-  rising edge by W3C Standard POSITION; D-pad or left stick (0.5 dead-zone, dominant axis) fires
-  once, repeats after 380 ms, then every 110 ms; release resets the repeat.
-- `createGamepadPoller({ getPads, requestFrame, cancelFrame, onAction })` — injectable rAF loop over
-  the first connected pad; a disappearing pad resets state; `stop()` is safe from inside `onAction`.
-- `PAD_ACTIONS`, `STANDARD_BUTTON`, `IDLE_REPEAT` + types `PadAction`, `PadSnapshot`, `RepeatState`,
-  `PadLike`, `GamepadPollerOptions`.
-
-## 1.0.0
-
-Initial release — the haptics primitive of the C4 games shared kit.
-
-- `createHaptics(options)` — player-toggleable, always-safe Web Vibration API wrapper
-  (localStorage-gated, structural/injectable `navigator` + `storage`, never throws into the game loop).
-- `HAPTIC_PATTERNS` — shared semantic vibration vocabulary (tap/select/lock/bump/navigate/success/error/loss/reveal).
-- Zero runtime dependencies; isomorphic; dual CJS/ESM; 100% test coverage.
-
-Extracted from Aurora's `src/input/haptics.ts`. First consumers: Aurora (re-export shim) and Morphe (new adoption).
+# Changelog
+
+All notable changes to `@dloizides/game-input` are documented here.
+
+## 1.5.0
+
+- `createMenuNav`: one menu focus engine for arrow keys (capture phase) and pad actions; top-most dialog owns focus, focus restored on close, sliders/selects step on Left/Right, text fields keep arrows until Escape/B, `data-nav-input` on <html> (NAV-1 "Every game menu works with arrow keys and controller").
+- `MENU_FOCUSABLE_SELECTOR`, `menuRoot`, `focusables`, `pickTarget` exported (pickTarget moved from Surge).
+
+## 1.4.0
+
+GI-HAPTICS-1 "Haptics vibrate only after a user activation".
+
+- `createHaptics` no longer calls `navigator.vibrate` before a user gesture (Chrome blocks it and logs an
+  intervention). Gate: `navigator.userActivation.hasBeenActive` where present, else a capture-phase latch on
+  the first `pointerdown` / `keydown` / `touchstart` of `activationTarget` (new option, default `globalThis`).
+- The enable-confirmation tick follows the same gate. Disabled and unsupported stay silent no-ops.
+- New exports: `ActivationTarget` type, `USER_ACTIVATION_EVENTS`.
+
+## 1.3.0
+
+Standard Gamepad action poller (first consumer: NextGame console-dashboard UI).
+
+- `stepPad(prev, next, repeat, now)` — pure per-frame reducer: face/shoulder buttons fire on the
+  rising edge by W3C Standard POSITION; D-pad or left stick (0.5 dead-zone, dominant axis) fires
+  once, repeats after 380 ms, then every 110 ms; release resets the repeat.
+- `createGamepadPoller({ getPads, requestFrame, cancelFrame, onAction })` — injectable rAF loop over
+  the first connected pad; a disappearing pad resets state; `stop()` is safe from inside `onAction`.
+- `PAD_ACTIONS`, `STANDARD_BUTTON`, `IDLE_REPEAT` + types `PadAction`, `PadSnapshot`, `RepeatState`,
+  `PadLike`, `GamepadPollerOptions`.
+
+## 1.0.0
+
+Initial release — the haptics primitive of the C4 games shared kit.
+
+- `createHaptics(options)` — player-toggleable, always-safe Web Vibration API wrapper
+  (localStorage-gated, structural/injectable `navigator` + `storage`, never throws into the game loop).
+- `HAPTIC_PATTERNS` — shared semantic vibration vocabulary (tap/select/lock/bump/navigate/success/error/loss/reveal).
+- Zero runtime dependencies; isomorphic; dual CJS/ESM; 100% test coverage.
+
+Extracted from Aurora's `src/input/haptics.ts`. First consumers: Aurora (re-export shim) and Morphe (new adoption).

package/README.md

@@ -1,74 +1,76 @@
-# @dloizides/game-input
-
-Framework-agnostic game input primitives. **v1 ships safe, player-toggleable haptics** — a thin wrapper
-over the Web Vibration API that no-ops silently when disabled, unsupported, or blocked, so call sites can
-fire haptics unconditionally alongside their SFX/visual feedback.
-
-Zero runtime dependencies. Isomorphic (no DOM lib required — `navigator` and storage are structural and
-injectable), so it works in browser games, React Native shells, and tests alike.
-
-> **Scope note:** keyboard/gamepad normalization is intentionally *not* in v1. The games that were audited
-> (Aurora, Morphe) implemented input with fundamentally different designs — there is no shared logic to
-> extract yet. It will be added when a genuine 2nd same-stack consumer appears (extract-on-2nd-use).
-
-## Install
-
-```bash
-npm install @dloizides/game-input
-```
-
-## Usage
-
-```ts
-import { createHaptics, HAPTIC_PATTERNS } from '@dloizides/game-input';
-
-// One controller per game; the storage key namespaces the player's preference.
-const haptics = createHaptics({ storageKey: 'aurora.haptics' });
-
-// Fire unconditionally — disabled/unsupported just no-ops.
-haptics.vibrate(HAPTIC_PATTERNS.tap);      // menu navigation / selection
-haptics.vibrate(HAPTIC_PATTERNS.success);  // level cleared
-haptics.vibrate([0, 14, 24, 14]);          // or your own pattern
-
-// Settings toggle — returns the new state, fires a confirming tick when enabling.
-function onHapticsToggle(): boolean {
-  return haptics.toggle();
-}
-haptics.isEnabled();
-```
-
-### Semantic pattern vocabulary
-
-`HAPTIC_PATTERNS` is a shared set of tuned vibration patterns keyed by intent, so every game uses the same
-feel instead of re-picking magic durations:
-
-| Intent | Pattern | Use |
-|---|---|---|
-| `tap` | `10` | menu nav / select / undo / restart |
-| `select` | `12` | pick up a tool/charm/item |
-| `lock` | `18` | something locks into place |
-| `bump` | `24` | action blocked |
-| `navigate` | `16` | portal / page turn |
-| `success` | `[0,40,50,90]` | level/chamber cleared |
-| `error` | `[0,14,24,14]` | fatal/destructive event |
-| `loss` | `[0,40,50,40]` | player loses / falls |
-| `reveal` | `[0,14,20,18,26,24]` | puzzle resolves / exit opens |
-
-## API
-
-- `createHaptics(options?)` → `Haptics` — `{ isEnabled, setEnabled, toggle, vibrate }`.
-  - `options.storageKey` (default `game.haptics`) — localStorage key for the on/off preference.
-  - `options.enableConfirmation` (default a `15`ms tick; pass `null` to disable) — fired when turning ON.
-  - `options.navigator` / `options.storage` — inject for tests/RN; default to `globalThis`.
-- `HAPTIC_PATTERNS`, `DEFAULT_HAPTICS_STORAGE_KEY`, `DEFAULT_ENABLE_CONFIRMATION`.
-- `createGamepadPoller({ getPads, requestFrame, cancelFrame, onAction })` → `{ start, stop }` — polls the
-  first connected W3C Standard Gamepad each frame and calls `onAction(PadAction)`. Pass
-  `() => navigator.getGamepads()`, `requestAnimationFrame`, `cancelAnimationFrame` in the browser.
-  - Buttons by POSITION: south → `confirm`, east → `back`, west → `view`, north → `mood`,
-    L/R shoulder → `pagePrev`/`pageNext` (rising edge only).
-  - D-pad or left stick (0.5 dead-zone) → `up`/`down`/`left`/`right`: fires once, repeats after 380 ms, then every 110 ms.
-- `stepPad(prev, next, repeat, now)` — the pure per-frame reducer behind the poller; `IDLE_REPEAT`, `PAD_ACTIONS`, `STANDARD_BUTTON`.
-
-## License
-
-MIT
+# @dloizides/game-input
+
+Framework-agnostic game input primitives. **v1 ships safe, player-toggleable haptics** — a thin wrapper
+over the Web Vibration API that no-ops silently when disabled, unsupported, or blocked, so call sites can
+fire haptics unconditionally alongside their SFX/visual feedback.
+
+Zero runtime dependencies. Isomorphic (no DOM lib required — `navigator` and storage are structural and
+injectable), so it works in browser games, React Native shells, and tests alike.
+
+> **Scope note:** keyboard/gamepad normalization is intentionally *not* in v1. The games that were audited
+> (Aurora, Morphe) implemented input with fundamentally different designs — there is no shared logic to
+> extract yet. It will be added when a genuine 2nd same-stack consumer appears (extract-on-2nd-use).
+
+## Install
+
+```bash
+npm install @dloizides/game-input
+```
+
+## Usage
+
+```ts
+import { createHaptics, HAPTIC_PATTERNS } from '@dloizides/game-input';
+
+// One controller per game; the storage key namespaces the player's preference.
+const haptics = createHaptics({ storageKey: 'aurora.haptics' });
+
+// Fire unconditionally — disabled/unsupported just no-ops.
+haptics.vibrate(HAPTIC_PATTERNS.tap);      // menu navigation / selection
+haptics.vibrate(HAPTIC_PATTERNS.success);  // level cleared
+haptics.vibrate([0, 14, 24, 14]);          // or your own pattern
+
+// Settings toggle — returns the new state, fires a confirming tick when enabling.
+function onHapticsToggle(): boolean {
+  return haptics.toggle();
+}
+haptics.isEnabled();
+```
+
+### Semantic pattern vocabulary
+
+`HAPTIC_PATTERNS` is a shared set of tuned vibration patterns keyed by intent, so every game uses the same
+feel instead of re-picking magic durations:
+
+| Intent | Pattern | Use |
+|---|---|---|
+| `tap` | `10` | menu nav / select / undo / restart |
+| `select` | `12` | pick up a tool/charm/item |
+| `lock` | `18` | something locks into place |
+| `bump` | `24` | action blocked |
+| `navigate` | `16` | portal / page turn |
+| `success` | `[0,40,50,90]` | level/chamber cleared |
+| `error` | `[0,14,24,14]` | fatal/destructive event |
+| `loss` | `[0,40,50,40]` | player loses / falls |
+| `reveal` | `[0,14,20,18,26,24]` | puzzle resolves / exit opens |
+
+## API
+
+- `createHaptics(options?)` → `Haptics` — `{ isEnabled, setEnabled, toggle, vibrate }`. Nothing vibrates
+  before a user gesture: `navigator.userActivation.hasBeenActive` where present, else the first
+  `pointerdown` / `keydown` / `touchstart` on `options.activationTarget` (default `globalThis`).
+  - `options.storageKey` (default `game.haptics`) — localStorage key for the on/off preference.
+  - `options.enableConfirmation` (default a `15`ms tick; pass `null` to disable) — fired when turning ON.
+  - `options.navigator` / `options.storage` — inject for tests/RN; default to `globalThis`.
+- `HAPTIC_PATTERNS`, `DEFAULT_HAPTICS_STORAGE_KEY`, `DEFAULT_ENABLE_CONFIRMATION`.
+- `createGamepadPoller({ getPads, requestFrame, cancelFrame, onAction })` → `{ start, stop }` — polls the
+  first connected W3C Standard Gamepad each frame and calls `onAction(PadAction)`. Pass
+  `() => navigator.getGamepads()`, `requestAnimationFrame`, `cancelAnimationFrame` in the browser.
+  - Buttons by POSITION: south → `confirm`, east → `back`, west → `view`, north → `mood`,
+    L/R shoulder → `pagePrev`/`pageNext` (rising edge only).
+  - D-pad or left stick (0.5 dead-zone) → `up`/`down`/`left`/`right`: fires once, repeats after 380 ms, then every 110 ms.
+- `stepPad(prev, next, repeat, now)` — the pure per-frame reducer behind the poller; `IDLE_REPEAT`, `PAD_ACTIONS`, `STANDARD_BUTTON`.
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -70,6 +70,63 @@ declare function stepPad(prev: PadSnapshot | null, next: PadSnapshot, repeat: Re
     repeat: RepeatState;
 };
 
+interface MenuNavOptions {
+    /** The game's base menu root when no dialog is open; null = no menu (e.g. during play). */
+    baseRoot: () => HTMLElement | null;
+    /** True while input must not move focus (e.g. a remap capture). Default: never. */
+    suspended?: () => boolean;
+    /** Where focus goes when a root opens. Default: [data-menu-default], else the first control. */
+    initialFocus?: (root: HTMLElement) => HTMLElement | null;
+}
+interface MenuNav {
+    /** Feed one pad action from stepPad (the game keeps its own poller). */
+    pad(action: PadAction): void;
+    /** Re-evaluate the root and place focus (call after the game opens a screen). */
+    refresh(): void;
+    dispose(): void;
+}
+/** One focus engine for every game menu: arrow keys (capture phase), pad actions, dialogs on top, sliders and text fields. */
+declare function createMenuNav(options: MenuNavOptions): MenuNav;
+
+/** Every control a menu walker must be able to reach (shared with @dloizides/game-e2e). */
+declare const MENU_FOCUSABLE_SELECTOR: string;
+declare const DIALOG_SELECTOR = "[role=\"dialog\"]";
+declare const MENU_DEFAULT_ATTR = "data-menu-default";
+declare const NAV_INPUT_ATTR = "data-nav-input";
+declare const NAV_INPUT: {
+    readonly key: "key";
+    readonly pad: "pad";
+};
+type NavInput = (typeof NAV_INPUT)[keyof typeof NAV_INPUT];
+
+/** True when the element has a layout box and no hidden, inert or aria-hidden ancestor. */
+declare function isShown(el: Element): boolean;
+/** The visible, enabled controls inside root, in DOM order. */
+declare function focusables(root: HTMLElement): HTMLElement[];
+/** The [data-menu-default] control, else the first control, else null. */
+declare function defaultInitialFocus(root: HTMLElement): HTMLElement | null;
+
+/** Top-most visible dialog (aria-modal preferred, last in DOM wins), else the visible base root, else null. */
+declare function menuRoot(baseRoot: () => HTMLElement | null): HTMLElement | null;
+
+interface Box {
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+}
+declare const NAV_DIRS: {
+    readonly up: "arrowup";
+    readonly down: "arrowdown";
+    readonly left: "arrowleft";
+    readonly right: "arrowright";
+};
+type NavDir = (typeof NAV_DIRS)[keyof typeof NAV_DIRS];
+/** The direction an arrow key names (case-insensitive), or null for any other key. */
+declare const navDir: (key: string) => NavDir | null;
+/** Index of the nearest box from `from` in `dir`; wraps in list order when none lies that way; -1 for no boxes. */
+declare function pickTarget(boxes: readonly Box[], from: number, dir: NavDir): number;
+
 /**
  * A vibration pattern: a single duration in ms, or an on/off pattern
  * (`[wait, on, off, on, ...]`) exactly as the Web Vibration API expects.
@@ -81,6 +138,14 @@ type VibrationPattern = number | number[];
  */
 interface VibrationCapable {
     vibrate?: (pattern: VibrationPattern) => boolean;
+    userActivation?: {
+        readonly hasBeenActive: boolean;
+    };
+}
+/** Event source whose first pointer/key/touch gesture unlocks haptics. Defaults to `globalThis`. */
+interface ActivationTarget {
+    addEventListener(type: string, listener: () => void, capture?: boolean): void;
+    removeEventListener(type: string, listener: () => void, capture?: boolean): void;
 }
 /**
  * The slice of `localStorage` haptics needs to persist the player's toggle.
@@ -103,6 +168,8 @@ interface HapticsOptions {
     navigator?: VibrationCapable;
     /** Preference store. Defaults to `globalThis.localStorage`. Inject for tests. */
     storage?: HapticsStorage;
+    /** Gesture source used when `navigator.userActivation` is unavailable. Defaults to `globalThis`. */
+    activationTarget?: ActivationTarget;
 }
 /**
  * A player-toggleable, always-safe haptics controller. Every call no-ops silently
@@ -121,11 +188,8 @@ interface Haptics {
 }
 
 /**
- * Create a player-toggleable, always-safe haptics controller.
- *
- * The on/off preference is read from (and persisted to) the configured storage key
- * so it survives reloads. Every vibration routes through one gated call that no-ops
- * when disabled, when no Vibration API is present, or if the platform blocks it.
+ * Create a player-toggleable, always-safe haptics controller: it never vibrates before a
+ * user gesture, while disabled, or when the Vibration API is missing or blocked.
  */
 declare function createHaptics(options?: HapticsOptions): Haptics;
 
@@ -133,6 +197,8 @@ declare function createHaptics(options?: HapticsOptions): Haptics;
 declare const DEFAULT_HAPTICS_STORAGE_KEY = "game.haptics";
 /** Default confirmation tick fired when haptics are turned ON (ms). */
 declare const DEFAULT_ENABLE_CONFIRMATION = 15;
+/** DOM events that count as a user activation before `navigator.userActivation` is available. */
+declare const USER_ACTIVATION_EVENTS: readonly ["pointerdown", "keydown", "touchstart"];
 /** The semantic intents games map their events onto. */
 type HapticIntent = 'tap' | 'select' | 'lock' | 'bump' | 'navigate' | 'success' | 'error' | 'loss' | 'reveal';
 /**
@@ -142,4 +208,4 @@ type HapticIntent = 'tap' | 'select' | 'lock' | 'bump' | 'navigate' | 'success'
  */
 declare const HAPTIC_PATTERNS: Record<HapticIntent, VibrationPattern>;
 
-export { DEFAULT_ENABLE_CONFIRMATION, DEFAULT_HAPTICS_STORAGE_KEY, type GamepadPollerOptions, HAPTIC_PATTERNS, type HapticIntent, type Haptics, type HapticsOptions, type HapticsStorage, IDLE_REPEAT, PAD_ACTIONS, type PadAction, type PadLike, type PadSnapshot, type RepeatState, STANDARD_BUTTON, type VibrationCapable, type VibrationPattern, createGamepadPoller, createHaptics, stepPad };
+export { type ActivationTarget, DEFAULT_ENABLE_CONFIRMATION, DEFAULT_HAPTICS_STORAGE_KEY, DIALOG_SELECTOR, type GamepadPollerOptions, HAPTIC_PATTERNS, type HapticIntent, type Haptics, type HapticsOptions, type HapticsStorage, IDLE_REPEAT, MENU_DEFAULT_ATTR, MENU_FOCUSABLE_SELECTOR, type MenuNav, type MenuNavOptions, NAV_DIRS, NAV_INPUT, NAV_INPUT_ATTR, type Box as NavBox, type NavDir, type NavInput, PAD_ACTIONS, type PadAction, type PadLike, type PadSnapshot, type RepeatState, STANDARD_BUTTON, USER_ACTIVATION_EVENTS, type VibrationCapable, type VibrationPattern, createGamepadPoller, createHaptics, createMenuNav, defaultInitialFocus, focusables, isShown, menuRoot, navDir, pickTarget, stepPad };

package/dist/index.d.ts

@@ -70,6 +70,63 @@ declare function stepPad(prev: PadSnapshot | null, next: PadSnapshot, repeat: Re
     repeat: RepeatState;
 };
 
+interface MenuNavOptions {
+    /** The game's base menu root when no dialog is open; null = no menu (e.g. during play). */
+    baseRoot: () => HTMLElement | null;
+    /** True while input must not move focus (e.g. a remap capture). Default: never. */
+    suspended?: () => boolean;
+    /** Where focus goes when a root opens. Default: [data-menu-default], else the first control. */
+    initialFocus?: (root: HTMLElement) => HTMLElement | null;
+}
+interface MenuNav {
+    /** Feed one pad action from stepPad (the game keeps its own poller). */
+    pad(action: PadAction): void;
+    /** Re-evaluate the root and place focus (call after the game opens a screen). */
+    refresh(): void;
+    dispose(): void;
+}
+/** One focus engine for every game menu: arrow keys (capture phase), pad actions, dialogs on top, sliders and text fields. */
+declare function createMenuNav(options: MenuNavOptions): MenuNav;
+
+/** Every control a menu walker must be able to reach (shared with @dloizides/game-e2e). */
+declare const MENU_FOCUSABLE_SELECTOR: string;
+declare const DIALOG_SELECTOR = "[role=\"dialog\"]";
+declare const MENU_DEFAULT_ATTR = "data-menu-default";
+declare const NAV_INPUT_ATTR = "data-nav-input";
+declare const NAV_INPUT: {
+    readonly key: "key";
+    readonly pad: "pad";
+};
+type NavInput = (typeof NAV_INPUT)[keyof typeof NAV_INPUT];
+
+/** True when the element has a layout box and no hidden, inert or aria-hidden ancestor. */
+declare function isShown(el: Element): boolean;
+/** The visible, enabled controls inside root, in DOM order. */
+declare function focusables(root: HTMLElement): HTMLElement[];
+/** The [data-menu-default] control, else the first control, else null. */
+declare function defaultInitialFocus(root: HTMLElement): HTMLElement | null;
+
+/** Top-most visible dialog (aria-modal preferred, last in DOM wins), else the visible base root, else null. */
+declare function menuRoot(baseRoot: () => HTMLElement | null): HTMLElement | null;
+
+interface Box {
+    readonly x: number;
+    readonly y: number;
+    readonly w: number;
+    readonly h: number;
+}
+declare const NAV_DIRS: {
+    readonly up: "arrowup";
+    readonly down: "arrowdown";
+    readonly left: "arrowleft";
+    readonly right: "arrowright";
+};
+type NavDir = (typeof NAV_DIRS)[keyof typeof NAV_DIRS];
+/** The direction an arrow key names (case-insensitive), or null for any other key. */
+declare const navDir: (key: string) => NavDir | null;
+/** Index of the nearest box from `from` in `dir`; wraps in list order when none lies that way; -1 for no boxes. */
+declare function pickTarget(boxes: readonly Box[], from: number, dir: NavDir): number;
+
 /**
  * A vibration pattern: a single duration in ms, or an on/off pattern
  * (`[wait, on, off, on, ...]`) exactly as the Web Vibration API expects.
@@ -81,6 +138,14 @@ type VibrationPattern = number | number[];
  */
 interface VibrationCapable {
     vibrate?: (pattern: VibrationPattern) => boolean;
+    userActivation?: {
+        readonly hasBeenActive: boolean;
+    };
+}
+/** Event source whose first pointer/key/touch gesture unlocks haptics. Defaults to `globalThis`. */
+interface ActivationTarget {
+    addEventListener(type: string, listener: () => void, capture?: boolean): void;
+    removeEventListener(type: string, listener: () => void, capture?: boolean): void;
 }
 /**
  * The slice of `localStorage` haptics needs to persist the player's toggle.
@@ -103,6 +168,8 @@ interface HapticsOptions {
     navigator?: VibrationCapable;
     /** Preference store. Defaults to `globalThis.localStorage`. Inject for tests. */
     storage?: HapticsStorage;
+    /** Gesture source used when `navigator.userActivation` is unavailable. Defaults to `globalThis`. */
+    activationTarget?: ActivationTarget;
 }
 /**
  * A player-toggleable, always-safe haptics controller. Every call no-ops silently
@@ -121,11 +188,8 @@ interface Haptics {
 }
 
 /**
- * Create a player-toggleable, always-safe haptics controller.
- *
- * The on/off preference is read from (and persisted to) the configured storage key
- * so it survives reloads. Every vibration routes through one gated call that no-ops
- * when disabled, when no Vibration API is present, or if the platform blocks it.
+ * Create a player-toggleable, always-safe haptics controller: it never vibrates before a
+ * user gesture, while disabled, or when the Vibration API is missing or blocked.
  */
 declare function createHaptics(options?: HapticsOptions): Haptics;
 
@@ -133,6 +197,8 @@ declare function createHaptics(options?: HapticsOptions): Haptics;
 declare const DEFAULT_HAPTICS_STORAGE_KEY = "game.haptics";
 /** Default confirmation tick fired when haptics are turned ON (ms). */
 declare const DEFAULT_ENABLE_CONFIRMATION = 15;
+/** DOM events that count as a user activation before `navigator.userActivation` is available. */
+declare const USER_ACTIVATION_EVENTS: readonly ["pointerdown", "keydown", "touchstart"];
 /** The semantic intents games map their events onto. */
 type HapticIntent = 'tap' | 'select' | 'lock' | 'bump' | 'navigate' | 'success' | 'error' | 'loss' | 'reveal';
 /**
@@ -142,4 +208,4 @@ type HapticIntent = 'tap' | 'select' | 'lock' | 'bump' | 'navigate' | 'success'
  */
 declare const HAPTIC_PATTERNS: Record<HapticIntent, VibrationPattern>;
 
-export { DEFAULT_ENABLE_CONFIRMATION, DEFAULT_HAPTICS_STORAGE_KEY, type GamepadPollerOptions, HAPTIC_PATTERNS, type HapticIntent, type Haptics, type HapticsOptions, type HapticsStorage, IDLE_REPEAT, PAD_ACTIONS, type PadAction, type PadLike, type PadSnapshot, type RepeatState, STANDARD_BUTTON, type VibrationCapable, type VibrationPattern, createGamepadPoller, createHaptics, stepPad };
+export { type ActivationTarget, DEFAULT_ENABLE_CONFIRMATION, DEFAULT_HAPTICS_STORAGE_KEY, DIALOG_SELECTOR, type GamepadPollerOptions, HAPTIC_PATTERNS, type HapticIntent, type Haptics, type HapticsOptions, type HapticsStorage, IDLE_REPEAT, MENU_DEFAULT_ATTR, MENU_FOCUSABLE_SELECTOR, type MenuNav, type MenuNavOptions, NAV_DIRS, NAV_INPUT, NAV_INPUT_ATTR, type Box as NavBox, type NavDir, type NavInput, PAD_ACTIONS, type PadAction, type PadLike, type PadSnapshot, type RepeatState, STANDARD_BUTTON, USER_ACTIVATION_EVENTS, type VibrationCapable, type VibrationPattern, createGamepadPoller, createHaptics, createMenuNav, defaultInitialFocus, focusables, isShown, menuRoot, navDir, pickTarget, stepPad };