@dloizides/game-input 1.0.0 → 1.3.0

package/CHANGELOG.md

@@ -2,6 +2,18 @@
 
 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.

package/README.md

@@ -61,6 +61,13 @@ feel instead of re-picking magic durations:
   - `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
 

package/dist/index.d.mts

@@ -1,3 +1,75 @@
+/** The semantic actions a Standard Gamepad produces, independent of the device's labels. */
+declare const PAD_ACTIONS: {
+    readonly up: "up";
+    readonly down: "down";
+    readonly left: "left";
+    readonly right: "right";
+    readonly confirm: "confirm";
+    readonly back: "back";
+    readonly mood: "mood";
+    readonly view: "view";
+    readonly pagePrev: "pagePrev";
+    readonly pageNext: "pageNext";
+};
+type PadAction = (typeof PAD_ACTIONS)[keyof typeof PAD_ACTIONS];
+/** W3C Standard Gamepad button indices, named by POSITION (Nintendo swaps A/B labels). */
+declare const STANDARD_BUTTON: {
+    readonly south: 0;
+    readonly east: 1;
+    readonly west: 2;
+    readonly north: 3;
+    readonly leftShoulder: 4;
+    readonly rightShoulder: 5;
+    readonly dpadUp: 12;
+    readonly dpadDown: 13;
+    readonly dpadLeft: 14;
+    readonly dpadRight: 15;
+};
+
+/** The structural subset of the DOM `Gamepad` the poller reads. */
+interface PadLike {
+    connected: boolean;
+    buttons: ReadonlyArray<{
+        pressed: boolean;
+    }>;
+    axes: readonly number[];
+}
+interface GamepadPollerOptions {
+    /** Usually `() => navigator.getGamepads()`. */
+    getPads: () => ReadonlyArray<PadLike | null>;
+    /** Usually `requestAnimationFrame`. */
+    requestFrame: (cb: (now: number) => void) => number;
+    /** Usually `cancelAnimationFrame`. */
+    cancelFrame: (id: number) => void;
+    onAction: (action: PadAction) => void;
+}
+/**
+ * rAF-driven poller over the first connected pad. Starts idle; call start().
+ * Safe to stop() (or stop() then start()) from inside `onAction`.
+ */
+declare function createGamepadPoller(opts: GamepadPollerOptions): {
+    start: () => void;
+    stop: () => void;
+};
+
+/** One frame of pad state: pressed flags by Standard button index, and raw axes. */
+interface PadSnapshot {
+    buttons: readonly boolean[];
+    axes: readonly number[];
+}
+/** Which direction is held, when it started, and when it last fired. */
+interface RepeatState {
+    held: PadAction | null;
+    since: number;
+    lastFire: number;
+}
+declare const IDLE_REPEAT: RepeatState;
+/** One poll frame → the actions to dispatch and the next repeat state. Pure. */
+declare function stepPad(prev: PadSnapshot | null, next: PadSnapshot, repeat: RepeatState, now: number): {
+    actions: PadAction[];
+    repeat: RepeatState;
+};
+
 /**
  * A vibration pattern: a single duration in ms, or an on/off pattern
  * (`[wait, on, off, on, ...]`) exactly as the Web Vibration API expects.
@@ -70,4 +142,4 @@ type HapticIntent = 'tap' | 'select' | 'lock' | 'bump' | 'navigate' | 'success'
  */
 declare const HAPTIC_PATTERNS: Record<HapticIntent, VibrationPattern>;
 
-export { DEFAULT_ENABLE_CONFIRMATION, DEFAULT_HAPTICS_STORAGE_KEY, HAPTIC_PATTERNS, type HapticIntent, type Haptics, type HapticsOptions, type HapticsStorage, type VibrationCapable, type VibrationPattern, createHaptics };
+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 };

package/dist/index.d.ts

@@ -1,3 +1,75 @@
+/** The semantic actions a Standard Gamepad produces, independent of the device's labels. */
+declare const PAD_ACTIONS: {
+    readonly up: "up";
+    readonly down: "down";
+    readonly left: "left";
+    readonly right: "right";
+    readonly confirm: "confirm";
+    readonly back: "back";
+    readonly mood: "mood";
+    readonly view: "view";
+    readonly pagePrev: "pagePrev";
+    readonly pageNext: "pageNext";
+};
+type PadAction = (typeof PAD_ACTIONS)[keyof typeof PAD_ACTIONS];
+/** W3C Standard Gamepad button indices, named by POSITION (Nintendo swaps A/B labels). */
+declare const STANDARD_BUTTON: {
+    readonly south: 0;
+    readonly east: 1;
+    readonly west: 2;
+    readonly north: 3;
+    readonly leftShoulder: 4;
+    readonly rightShoulder: 5;
+    readonly dpadUp: 12;
+    readonly dpadDown: 13;
+    readonly dpadLeft: 14;
+    readonly dpadRight: 15;
+};
+
+/** The structural subset of the DOM `Gamepad` the poller reads. */
+interface PadLike {
+    connected: boolean;
+    buttons: ReadonlyArray<{
+        pressed: boolean;
+    }>;
+    axes: readonly number[];
+}
+interface GamepadPollerOptions {
+    /** Usually `() => navigator.getGamepads()`. */
+    getPads: () => ReadonlyArray<PadLike | null>;
+    /** Usually `requestAnimationFrame`. */
+    requestFrame: (cb: (now: number) => void) => number;
+    /** Usually `cancelAnimationFrame`. */
+    cancelFrame: (id: number) => void;
+    onAction: (action: PadAction) => void;
+}
+/**
+ * rAF-driven poller over the first connected pad. Starts idle; call start().
+ * Safe to stop() (or stop() then start()) from inside `onAction`.
+ */
+declare function createGamepadPoller(opts: GamepadPollerOptions): {
+    start: () => void;
+    stop: () => void;
+};
+
+/** One frame of pad state: pressed flags by Standard button index, and raw axes. */
+interface PadSnapshot {
+    buttons: readonly boolean[];
+    axes: readonly number[];
+}
+/** Which direction is held, when it started, and when it last fired. */
+interface RepeatState {
+    held: PadAction | null;
+    since: number;
+    lastFire: number;
+}
+declare const IDLE_REPEAT: RepeatState;
+/** One poll frame → the actions to dispatch and the next repeat state. Pure. */
+declare function stepPad(prev: PadSnapshot | null, next: PadSnapshot, repeat: RepeatState, now: number): {
+    actions: PadAction[];
+    repeat: RepeatState;
+};
+
 /**
  * A vibration pattern: a single duration in ms, or an on/off pattern
  * (`[wait, on, off, on, ...]`) exactly as the Web Vibration API expects.
@@ -70,4 +142,4 @@ type HapticIntent = 'tap' | 'select' | 'lock' | 'bump' | 'navigate' | 'success'
  */
 declare const HAPTIC_PATTERNS: Record<HapticIntent, VibrationPattern>;
 
-export { DEFAULT_ENABLE_CONFIRMATION, DEFAULT_HAPTICS_STORAGE_KEY, HAPTIC_PATTERNS, type HapticIntent, type Haptics, type HapticsOptions, type HapticsStorage, type VibrationCapable, type VibrationPattern, createHaptics };
+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 };

package/dist/index.js

@@ -1,5 +1,127 @@
 'use strict';
 
+// src/gamepad/padMap.ts
+var PAD_ACTIONS = {
+  up: "up",
+  down: "down",
+  left: "left",
+  right: "right",
+  confirm: "confirm",
+  back: "back",
+  mood: "mood",
+  view: "view",
+  pagePrev: "pagePrev",
+  pageNext: "pageNext"
+};
+var STANDARD_BUTTON = {
+  south: 0,
+  east: 1,
+  west: 2,
+  north: 3,
+  leftShoulder: 4,
+  rightShoulder: 5,
+  dpadUp: 12,
+  dpadDown: 13,
+  dpadLeft: 14,
+  dpadRight: 15
+};
+var FACE_BUTTON_ACTIONS = [
+  [STANDARD_BUTTON.south, PAD_ACTIONS.confirm],
+  [STANDARD_BUTTON.east, PAD_ACTIONS.back],
+  [STANDARD_BUTTON.west, PAD_ACTIONS.view],
+  [STANDARD_BUTTON.north, PAD_ACTIONS.mood],
+  [STANDARD_BUTTON.leftShoulder, PAD_ACTIONS.pagePrev],
+  [STANDARD_BUTTON.rightShoulder, PAD_ACTIONS.pageNext]
+];
+var DPAD_ACTIONS = [
+  [STANDARD_BUTTON.dpadUp, PAD_ACTIONS.up],
+  [STANDARD_BUTTON.dpadDown, PAD_ACTIONS.down],
+  [STANDARD_BUTTON.dpadLeft, PAD_ACTIONS.left],
+  [STANDARD_BUTTON.dpadRight, PAD_ACTIONS.right]
+];
+var STICK_DEAD_ZONE = 0.5;
+var REPEAT_DELAY_MS = 380;
+var REPEAT_INTERVAL_MS = 110;
+
+// src/gamepad/stepPad.ts
+var IDLE_REPEAT = { held: null, since: 0, lastFire: 0 };
+var STICK_X = 0;
+var STICK_Y = 1;
+function stickDirection(axes) {
+  const x = axes[STICK_X] ?? 0;
+  const y = axes[STICK_Y] ?? 0;
+  if (Math.max(Math.abs(x), Math.abs(y)) < STICK_DEAD_ZONE) {
+    return null;
+  }
+  if (Math.abs(x) > Math.abs(y)) {
+    return x > 0 ? PAD_ACTIONS.right : PAD_ACTIONS.left;
+  }
+  return y > 0 ? PAD_ACTIONS.down : PAD_ACTIONS.up;
+}
+function heldDirection(snapshot) {
+  const dpad = DPAD_ACTIONS.find(([index]) => snapshot.buttons[index] === true);
+  return dpad === void 0 ? stickDirection(snapshot.axes) : dpad[1];
+}
+function stepPad(prev, next, repeat, now) {
+  const actions = FACE_BUTTON_ACTIONS.filter(([index]) => next.buttons[index] === true && prev?.buttons[index] !== true).map(([, action]) => action);
+  const direction = heldDirection(next);
+  if (direction === null) {
+    return { actions, repeat: IDLE_REPEAT };
+  }
+  if (direction !== repeat.held) {
+    return { actions: [...actions, direction], repeat: { held: direction, since: now, lastFire: now } };
+  }
+  const firstRepeat = repeat.lastFire === repeat.since;
+  const wait = firstRepeat ? REPEAT_DELAY_MS : REPEAT_INTERVAL_MS;
+  if (now - repeat.lastFire < wait) {
+    return { actions, repeat };
+  }
+  return { actions: [...actions, direction], repeat: { ...repeat, lastFire: now } };
+}
+
+// src/gamepad/createGamepadPoller.ts
+function createGamepadPoller(opts) {
+  let prev = null;
+  let repeat = IDLE_REPEAT;
+  let running = false;
+  let frame = null;
+  const tick = (now) => {
+    frame = null;
+    const pad = opts.getPads().find((p) => p !== null && p.connected);
+    if (pad === void 0) {
+      prev = null;
+      repeat = IDLE_REPEAT;
+    } else {
+      const snapshot = { buttons: pad.buttons.map((b) => b.pressed), axes: pad.axes };
+      const step = stepPad(prev, snapshot, repeat, now);
+      prev = snapshot;
+      repeat = step.repeat;
+      step.actions.forEach((action) => opts.onAction(action));
+    }
+    if (running && frame === null) {
+      frame = opts.requestFrame(tick);
+    }
+  };
+  return {
+    start: () => {
+      if (running) {
+        return;
+      }
+      running = true;
+      if (frame === null) {
+        frame = opts.requestFrame(tick);
+      }
+    },
+    stop: () => {
+      running = false;
+      if (frame !== null) {
+        opts.cancelFrame(frame);
+        frame = null;
+      }
+    }
+  };
+}
+
 // src/constants.ts
 var DEFAULT_HAPTICS_STORAGE_KEY = "game.haptics";
 var DEFAULT_ENABLE_CONFIRMATION = 15;
@@ -86,6 +208,11 @@ function createHaptics(options = {}) {
 exports.DEFAULT_ENABLE_CONFIRMATION = DEFAULT_ENABLE_CONFIRMATION;
 exports.DEFAULT_HAPTICS_STORAGE_KEY = DEFAULT_HAPTICS_STORAGE_KEY;
 exports.HAPTIC_PATTERNS = HAPTIC_PATTERNS;
+exports.IDLE_REPEAT = IDLE_REPEAT;
+exports.PAD_ACTIONS = PAD_ACTIONS;
+exports.STANDARD_BUTTON = STANDARD_BUTTON;
+exports.createGamepadPoller = createGamepadPoller;
 exports.createHaptics = createHaptics;
+exports.stepPad = stepPad;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/constants.ts","../src/haptics.ts"],"names":[],"mappings":";;;AAGO,IAAM,2BAAA,GAA8B;AAGpC,IAAM,2BAAA,GAA8B;AAGpC,IAAM,cAAA,GAAiB,GAAA;AAGvB,IAAM,aAAA,GAAgB,GAAA;AAmBtB,IAAM,eAAA,GAA0D;AAAA;AAAA,EAErE,GAAA,EAAK,EAAA;AAAA;AAAA,EAEL,MAAA,EAAQ,EAAA;AAAA;AAAA,EAER,IAAA,EAAM,EAAA;AAAA;AAAA,EAEN,IAAA,EAAM,EAAA;AAAA;AAAA,EAEN,QAAA,EAAU,EAAA;AAAA;AAAA,EAEV,OAAA,EAAS,CAAC,CAAA,EAAG,EAAA,EAAI,IAAI,EAAE,CAAA;AAAA;AAAA,EAEvB,KAAA,EAAO,CAAC,CAAA,EAAG,EAAA,EAAI,IAAI,EAAE,CAAA;AAAA;AAAA,EAErB,IAAA,EAAM,CAAC,CAAA,EAAG,EAAA,EAAI,IAAI,EAAE,CAAA;AAAA;AAAA,EAEpB,QAAQ,CAAC,CAAA,EAAG,IAAI,EAAA,EAAI,EAAA,EAAI,IAAI,EAAE;AAChC;;;AC1CA,SAAS,iBAAiB,QAAA,EAA2D;AACnF,EAAA,IAAI,QAAA,EAAU;AACZ,IAAA,OAAO,QAAA;AAAA,EACT;AACA,EAAA,OAAQ,UAAA,CAAgD,SAAA;AAC1D;AAEA,SAAS,eAAe,QAAA,EAAuD;AAC7E,EAAA,IAAI,QAAA,EAAU;AACZ,IAAA,OAAO,QAAA;AAAA,EACT;AACA,EAAA,OAAQ,UAAA,CAAiD,YAAA;AAC3D;AASO,SAAS,aAAA,CAAc,OAAA,GAA0B,EAAC,EAAY;AACnE,EAAA,MAAM,UAAA,GAAa,QAAQ,UAAA,IAAc,2BAAA;AACzC,EAAA,MAAM,YAAA,GACJ,OAAA,CAAQ,kBAAA,KAAuB,MAAA,GAAY,8BAA8B,OAAA,CAAQ,kBAAA;AACnF,EAAA,MAAM,SAAA,GAAY,gBAAA,CAAiB,OAAA,CAAQ,SAAS,CAAA;AACpD,EAAA,MAAM,OAAA,GAAU,cAAA,CAAe,OAAA,CAAQ,OAAO,CAAA;AAE9C,EAAA,MAAM,WAAW,MAAe;AAC9B,IAAA,IAAI;AACF,MAAA,OAAO,OAAA,EAAS,OAAA,CAAQ,UAAU,CAAA,KAAM,cAAA;AAAA,IAC1C,CAAA,CAAA,MAAQ;AAEN,MAAA,OAAO,IAAA;AAAA,IACT;AAAA,EACF,CAAA;AAEA,EAAA,IAAI,UAAU,QAAA,EAAS;AAEvB,EAAA,MAAM,OAAA,GAAU,CAAC,OAAA,KAAoC;AACnD,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA;AAAA,IACF;AACA,IAAA,IAAI;AACF,MAAA,SAAA,EAAW,UAAU,OAAO,CAAA;AAAA,IAC9B,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,UAAU,MAAY;AAC1B,IAAA,IAAI;AACF,MAAA,OAAA,EAAS,OAAA,CAAQ,UAAA,EAAY,OAAA,GAAU,aAAA,GAAgB,cAAc,CAAA;AAAA,IACvE,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,UAAA,GAAa,CAAC,IAAA,KAA2B;AAC7C,IAAA,OAAA,GAAU,IAAA;AACV,IAAA,OAAA,EAAQ;AAER,IAAA,IAAI,OAAA,IAAW,iBAAiB,IAAA,EAAM;AACpC,MAAA,OAAA,CAAQ,YAAY,CAAA;AAAA,IACtB;AACA,IAAA,OAAO,OAAA;AAAA,EACT,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,WAAW,MAAe,OAAA;AAAA,IAC1B,UAAA;AAAA,IACA,MAAA,EAAQ,MAAe,UAAA,CAAW,CAAC,OAAO,CAAA;AAAA,IAC1C;AAAA,GACF;AACF","file":"index.js","sourcesContent":["import type { VibrationPattern } from './types';\n\n/** Default localStorage key for the haptics on/off preference. */\nexport const DEFAULT_HAPTICS_STORAGE_KEY = 'game.haptics';\n\n/** Default confirmation tick fired when haptics are turned ON (ms). */\nexport const DEFAULT_ENABLE_CONFIRMATION = 15;\n\n/** Stored value meaning \"disabled\". Any other value (or absent) means enabled. */\nexport const DISABLED_VALUE = '0';\n\n/** Stored value meaning \"enabled\". */\nexport const ENABLED_VALUE = '1';\n\n/** The semantic intents games map their events onto. */\nexport type HapticIntent =\n  | 'tap'\n  | 'select'\n  | 'lock'\n  | 'bump'\n  | 'navigate'\n  | 'success'\n  | 'error'\n  | 'loss'\n  | 'reveal';\n\n/**\n * A shared vocabulary of vibration patterns keyed by intent, so every game uses\n * the same tuned feel instead of re-picking magic durations. Pass any of these to\n * {@link Haptics.vibrate} (or supply your own pattern).\n */\nexport const HAPTIC_PATTERNS: Record<HapticIntent, VibrationPattern> = {\n  /** Light tick for menu navigation / selection / undo / restart. */\n  tap: 10,\n  /** Light pulse when a tool/charm/item is picked up or selected. */\n  select: 12,\n  /** Short pulse when something locks into place. */\n  lock: 18,\n  /** Dull buzz when an action is blocked. */\n  bump: 24,\n  /** Quick pulse when stepping through a portal / page turn. */\n  navigate: 16,\n  /** Celebratory pattern when a level/chamber is cleared. */\n  success: [0, 40, 50, 90],\n  /** Sharp double crack for a fatal/destructive event. */\n  error: [0, 14, 24, 14],\n  /** Heavier buzz when the player loses / falls. */\n  loss: [0, 40, 50, 40],\n  /** Rising triple pulse the instant a puzzle resolves / an exit opens. */\n  reveal: [0, 14, 20, 18, 26, 24],\n};\n","import {\n  DEFAULT_ENABLE_CONFIRMATION,\n  DEFAULT_HAPTICS_STORAGE_KEY,\n  DISABLED_VALUE,\n  ENABLED_VALUE,\n} from './constants';\nimport type { Haptics, HapticsOptions, HapticsStorage, VibrationCapable, VibrationPattern } from './types';\n\nfunction resolveNavigator(explicit?: VibrationCapable): VibrationCapable | undefined {\n  if (explicit) {\n    return explicit;\n  }\n  return (globalThis as { navigator?: VibrationCapable }).navigator;\n}\n\nfunction resolveStorage(explicit?: HapticsStorage): HapticsStorage | undefined {\n  if (explicit) {\n    return explicit;\n  }\n  return (globalThis as { localStorage?: HapticsStorage }).localStorage;\n}\n\n/**\n * Create a player-toggleable, always-safe haptics controller.\n *\n * The on/off preference is read from (and persisted to) the configured storage key\n * so it survives reloads. Every vibration routes through one gated call that no-ops\n * when disabled, when no Vibration API is present, or if the platform blocks it.\n */\nexport function createHaptics(options: HapticsOptions = {}): Haptics {\n  const storageKey = options.storageKey ?? DEFAULT_HAPTICS_STORAGE_KEY;\n  const confirmation =\n    options.enableConfirmation === undefined ? DEFAULT_ENABLE_CONFIRMATION : options.enableConfirmation;\n  const navigator = resolveNavigator(options.navigator);\n  const storage = resolveStorage(options.storage);\n\n  const readPref = (): boolean => {\n    try {\n      return storage?.getItem(storageKey) !== DISABLED_VALUE;\n    } catch {\n      // Reading storage can throw (blocked cookies / sandboxed iframe) — default ON.\n      return true;\n    }\n  };\n\n  let enabled = readPref();\n\n  const vibrate = (pattern: VibrationPattern): void => {\n    if (!enabled) {\n      return;\n    }\n    try {\n      navigator?.vibrate?.(pattern);\n    } catch {\n      // Vibration can throw if blocked by the platform — never let it break a move.\n    }\n  };\n\n  const persist = (): void => {\n    try {\n      storage?.setItem(storageKey, enabled ? ENABLED_VALUE : DISABLED_VALUE);\n    } catch {\n      // Writing storage can throw (private mode / quota) — ignore.\n    }\n  };\n\n  const setEnabled = (next: boolean): boolean => {\n    enabled = next;\n    persist();\n    // A confirming tick when turning ON so the player feels it engage.\n    if (enabled && confirmation !== null) {\n      vibrate(confirmation);\n    }\n    return enabled;\n  };\n\n  return {\n    isEnabled: (): boolean => enabled,\n    setEnabled,\n    toggle: (): boolean => setEnabled(!enabled),\n    vibrate,\n  };\n}\n"]}
+{"version":3,"sources":["../src/gamepad/padMap.ts","../src/gamepad/stepPad.ts","../src/gamepad/createGamepadPoller.ts","../src/constants.ts","../src/haptics.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/** The semantic actions a Standard Gamepad produces, independent of the device's labels. */\nexport const PAD_ACTIONS = {\n  up: 'up',\n  down: 'down',\n  left: 'left',\n  right: 'right',\n  confirm: 'confirm',\n  back: 'back',\n  mood: 'mood',\n  view: 'view',\n  pagePrev: 'pagePrev',\n  pageNext: 'pageNext',\n} as const;\nexport type PadAction = (typeof PAD_ACTIONS)[keyof typeof PAD_ACTIONS];\n\n/** W3C Standard Gamepad button indices, named by POSITION (Nintendo swaps A/B labels). */\nexport const STANDARD_BUTTON = {\n  south: 0,\n  east: 1,\n  west: 2,\n  north: 3,\n  leftShoulder: 4,\n  rightShoulder: 5,\n  dpadUp: 12,\n  dpadDown: 13,\n  dpadLeft: 14,\n  dpadRight: 15,\n} as const;\n\n/** Edge-triggered buttons, in dispatch order. */\nexport const FACE_BUTTON_ACTIONS: ReadonlyArray<readonly [number, PadAction]> = [\n  [STANDARD_BUTTON.south, PAD_ACTIONS.confirm],\n  [STANDARD_BUTTON.east, PAD_ACTIONS.back],\n  [STANDARD_BUTTON.west, PAD_ACTIONS.view],\n  [STANDARD_BUTTON.north, PAD_ACTIONS.mood],\n  [STANDARD_BUTTON.leftShoulder, PAD_ACTIONS.pagePrev],\n  [STANDARD_BUTTON.rightShoulder, PAD_ACTIONS.pageNext],\n];\n\n/** Held (auto-repeating) buttons; the first pressed one wins. */\nexport const DPAD_ACTIONS: ReadonlyArray<readonly [number, PadAction]> = [\n  [STANDARD_BUTTON.dpadUp, PAD_ACTIONS.up],\n  [STANDARD_BUTTON.dpadDown, PAD_ACTIONS.down],\n  [STANDARD_BUTTON.dpadLeft, PAD_ACTIONS.left],\n  [STANDARD_BUTTON.dpadRight, PAD_ACTIONS.right],\n];\n\n/** Left-stick magnitude below which the stick counts as centred. */\nexport const STICK_DEAD_ZONE = 0.5;\n/** Delay before a held direction starts repeating (ms). */\nexport const REPEAT_DELAY_MS = 380;\n/** Interval between repeats once repeating (ms). */\nexport const REPEAT_INTERVAL_MS = 110;\n","import {\n  DPAD_ACTIONS,\n  FACE_BUTTON_ACTIONS,\n  PAD_ACTIONS,\n  REPEAT_DELAY_MS,\n  REPEAT_INTERVAL_MS,\n  STICK_DEAD_ZONE,\n  type PadAction,\n} from './padMap';\n\n/** One frame of pad state: pressed flags by Standard button index, and raw axes. */\nexport interface PadSnapshot {\n  buttons: readonly boolean[];\n  axes: readonly number[];\n}\n\n/** Which direction is held, when it started, and when it last fired. */\nexport interface RepeatState {\n  held: PadAction | null;\n  since: number;\n  lastFire: number;\n}\n\nexport const IDLE_REPEAT: RepeatState = { held: null, since: 0, lastFire: 0 };\n\nconst STICK_X = 0;\nconst STICK_Y = 1;\n\nfunction stickDirection(axes: readonly number[]): PadAction | null {\n  const x = axes[STICK_X] ?? 0;\n  const y = axes[STICK_Y] ?? 0;\n  if (Math.max(Math.abs(x), Math.abs(y)) < STICK_DEAD_ZONE) {\n    return null;\n  }\n  if (Math.abs(x) > Math.abs(y)) {\n    return x > 0 ? PAD_ACTIONS.right : PAD_ACTIONS.left;\n  }\n  return y > 0 ? PAD_ACTIONS.down : PAD_ACTIONS.up;\n}\n\nfunction heldDirection(snapshot: PadSnapshot): PadAction | null {\n  const dpad = DPAD_ACTIONS.find(([index]) => snapshot.buttons[index] === true);\n  return dpad === undefined ? stickDirection(snapshot.axes) : dpad[1];\n}\n\n/** One poll frame → the actions to dispatch and the next repeat state. Pure. */\nexport function stepPad(\n  prev: PadSnapshot | null,\n  next: PadSnapshot,\n  repeat: RepeatState,\n  now: number,\n): { actions: PadAction[]; repeat: RepeatState } {\n  const actions: PadAction[] = FACE_BUTTON_ACTIONS\n    .filter(([index]) => next.buttons[index] === true && prev?.buttons[index] !== true)\n    .map(([, action]) => action);\n  const direction = heldDirection(next);\n  if (direction === null) {\n    return { actions, repeat: IDLE_REPEAT };\n  }\n  if (direction !== repeat.held) {\n    return { actions: [...actions, direction], repeat: { held: direction, since: now, lastFire: now } };\n  }\n  const firstRepeat = repeat.lastFire === repeat.since;\n  const wait = firstRepeat ? REPEAT_DELAY_MS : REPEAT_INTERVAL_MS;\n  if (now - repeat.lastFire < wait) {\n    return { actions, repeat };\n  }\n  return { actions: [...actions, direction], repeat: { ...repeat, lastFire: now } };\n}\n","import type { PadAction } from './padMap';\nimport { IDLE_REPEAT, stepPad, type PadSnapshot, type RepeatState } from './stepPad';\n\n/** The structural subset of the DOM `Gamepad` the poller reads. */\nexport interface PadLike {\n  connected: boolean;\n  buttons: ReadonlyArray<{ pressed: boolean }>;\n  axes: readonly number[];\n}\n\nexport interface GamepadPollerOptions {\n  /** Usually `() => navigator.getGamepads()`. */\n  getPads: () => ReadonlyArray<PadLike | null>;\n  /** Usually `requestAnimationFrame`. */\n  requestFrame: (cb: (now: number) => void) => number;\n  /** Usually `cancelAnimationFrame`. */\n  cancelFrame: (id: number) => void;\n  onAction: (action: PadAction) => void;\n}\n\n/**\n * rAF-driven poller over the first connected pad. Starts idle; call start().\n * Safe to stop() (or stop() then start()) from inside `onAction`.\n */\nexport function createGamepadPoller(opts: GamepadPollerOptions): { start: () => void; stop: () => void } {\n  let prev: PadSnapshot | null = null;\n  let repeat: RepeatState = IDLE_REPEAT;\n  let running = false;\n  let frame: number | null = null;\n\n  const tick = (now: number): void => {\n    frame = null;\n    const pad = opts.getPads().find((p): p is PadLike => p !== null && p.connected);\n    if (pad === undefined) {\n      prev = null;\n      repeat = IDLE_REPEAT;\n    } else {\n      const snapshot: PadSnapshot = { buttons: pad.buttons.map((b) => b.pressed), axes: pad.axes };\n      const step = stepPad(prev, snapshot, repeat, now);\n      prev = snapshot;\n      repeat = step.repeat;\n      step.actions.forEach((action) => opts.onAction(action));\n    }\n    if (running && frame === null) {\n      frame = opts.requestFrame(tick);\n    }\n  };\n\n  return {\n    start: (): void => {\n      if (running) {\n        return;\n      }\n      running = true;\n      if (frame === null) {\n        frame = opts.requestFrame(tick);\n      }\n    },\n    stop: (): void => {\n      running = false;\n      if (frame !== null) {\n        opts.cancelFrame(frame);\n        frame = null;\n      }\n    },\n  };\n}\n","import type { VibrationPattern } from './types';\n\n/** Default localStorage key for the haptics on/off preference. */\nexport const DEFAULT_HAPTICS_STORAGE_KEY = 'game.haptics';\n\n/** Default confirmation tick fired when haptics are turned ON (ms). */\nexport const DEFAULT_ENABLE_CONFIRMATION = 15;\n\n/** Stored value meaning \"disabled\". Any other value (or absent) means enabled. */\nexport const DISABLED_VALUE = '0';\n\n/** Stored value meaning \"enabled\". */\nexport const ENABLED_VALUE = '1';\n\n/** The semantic intents games map their events onto. */\nexport type HapticIntent =\n  | 'tap'\n  | 'select'\n  | 'lock'\n  | 'bump'\n  | 'navigate'\n  | 'success'\n  | 'error'\n  | 'loss'\n  | 'reveal';\n\n/**\n * A shared vocabulary of vibration patterns keyed by intent, so every game uses\n * the same tuned feel instead of re-picking magic durations. Pass any of these to\n * {@link Haptics.vibrate} (or supply your own pattern).\n */\nexport const HAPTIC_PATTERNS: Record<HapticIntent, VibrationPattern> = {\n  /** Light tick for menu navigation / selection / undo / restart. */\n  tap: 10,\n  /** Light pulse when a tool/charm/item is picked up or selected. */\n  select: 12,\n  /** Short pulse when something locks into place. */\n  lock: 18,\n  /** Dull buzz when an action is blocked. */\n  bump: 24,\n  /** Quick pulse when stepping through a portal / page turn. */\n  navigate: 16,\n  /** Celebratory pattern when a level/chamber is cleared. */\n  success: [0, 40, 50, 90],\n  /** Sharp double crack for a fatal/destructive event. */\n  error: [0, 14, 24, 14],\n  /** Heavier buzz when the player loses / falls. */\n  loss: [0, 40, 50, 40],\n  /** Rising triple pulse the instant a puzzle resolves / an exit opens. */\n  reveal: [0, 14, 20, 18, 26, 24],\n};\n","import {\n  DEFAULT_ENABLE_CONFIRMATION,\n  DEFAULT_HAPTICS_STORAGE_KEY,\n  DISABLED_VALUE,\n  ENABLED_VALUE,\n} from './constants';\nimport type { Haptics, HapticsOptions, HapticsStorage, VibrationCapable, VibrationPattern } from './types';\n\nfunction resolveNavigator(explicit?: VibrationCapable): VibrationCapable | undefined {\n  if (explicit) {\n    return explicit;\n  }\n  return (globalThis as { navigator?: VibrationCapable }).navigator;\n}\n\nfunction resolveStorage(explicit?: HapticsStorage): HapticsStorage | undefined {\n  if (explicit) {\n    return explicit;\n  }\n  return (globalThis as { localStorage?: HapticsStorage }).localStorage;\n}\n\n/**\n * Create a player-toggleable, always-safe haptics controller.\n *\n * The on/off preference is read from (and persisted to) the configured storage key\n * so it survives reloads. Every vibration routes through one gated call that no-ops\n * when disabled, when no Vibration API is present, or if the platform blocks it.\n */\nexport function createHaptics(options: HapticsOptions = {}): Haptics {\n  const storageKey = options.storageKey ?? DEFAULT_HAPTICS_STORAGE_KEY;\n  const confirmation =\n    options.enableConfirmation === undefined ? DEFAULT_ENABLE_CONFIRMATION : options.enableConfirmation;\n  const navigator = resolveNavigator(options.navigator);\n  const storage = resolveStorage(options.storage);\n\n  const readPref = (): boolean => {\n    try {\n      return storage?.getItem(storageKey) !== DISABLED_VALUE;\n    } catch {\n      // Reading storage can throw (blocked cookies / sandboxed iframe) — default ON.\n      return true;\n    }\n  };\n\n  let enabled = readPref();\n\n  const vibrate = (pattern: VibrationPattern): void => {\n    if (!enabled) {\n      return;\n    }\n    try {\n      navigator?.vibrate?.(pattern);\n    } catch {\n      // Vibration can throw if blocked by the platform — never let it break a move.\n    }\n  };\n\n  const persist = (): void => {\n    try {\n      storage?.setItem(storageKey, enabled ? ENABLED_VALUE : DISABLED_VALUE);\n    } catch {\n      // Writing storage can throw (private mode / quota) — ignore.\n    }\n  };\n\n  const setEnabled = (next: boolean): boolean => {\n    enabled = next;\n    persist();\n    // A confirming tick when turning ON so the player feels it engage.\n    if (enabled && confirmation !== null) {\n      vibrate(confirmation);\n    }\n    return enabled;\n  };\n\n  return {\n    isEnabled: (): boolean => enabled,\n    setEnabled,\n    toggle: (): boolean => setEnabled(!enabled),\n    vibrate,\n  };\n}\n"]}

package/dist/index.mjs

@@ -1,3 +1,125 @@
+// src/gamepad/padMap.ts
+var PAD_ACTIONS = {
+  up: "up",
+  down: "down",
+  left: "left",
+  right: "right",
+  confirm: "confirm",
+  back: "back",
+  mood: "mood",
+  view: "view",
+  pagePrev: "pagePrev",
+  pageNext: "pageNext"
+};
+var STANDARD_BUTTON = {
+  south: 0,
+  east: 1,
+  west: 2,
+  north: 3,
+  leftShoulder: 4,
+  rightShoulder: 5,
+  dpadUp: 12,
+  dpadDown: 13,
+  dpadLeft: 14,
+  dpadRight: 15
+};
+var FACE_BUTTON_ACTIONS = [
+  [STANDARD_BUTTON.south, PAD_ACTIONS.confirm],
+  [STANDARD_BUTTON.east, PAD_ACTIONS.back],
+  [STANDARD_BUTTON.west, PAD_ACTIONS.view],
+  [STANDARD_BUTTON.north, PAD_ACTIONS.mood],
+  [STANDARD_BUTTON.leftShoulder, PAD_ACTIONS.pagePrev],
+  [STANDARD_BUTTON.rightShoulder, PAD_ACTIONS.pageNext]
+];
+var DPAD_ACTIONS = [
+  [STANDARD_BUTTON.dpadUp, PAD_ACTIONS.up],
+  [STANDARD_BUTTON.dpadDown, PAD_ACTIONS.down],
+  [STANDARD_BUTTON.dpadLeft, PAD_ACTIONS.left],
+  [STANDARD_BUTTON.dpadRight, PAD_ACTIONS.right]
+];
+var STICK_DEAD_ZONE = 0.5;
+var REPEAT_DELAY_MS = 380;
+var REPEAT_INTERVAL_MS = 110;
+
+// src/gamepad/stepPad.ts
+var IDLE_REPEAT = { held: null, since: 0, lastFire: 0 };
+var STICK_X = 0;
+var STICK_Y = 1;
+function stickDirection(axes) {
+  const x = axes[STICK_X] ?? 0;
+  const y = axes[STICK_Y] ?? 0;
+  if (Math.max(Math.abs(x), Math.abs(y)) < STICK_DEAD_ZONE) {
+    return null;
+  }
+  if (Math.abs(x) > Math.abs(y)) {
+    return x > 0 ? PAD_ACTIONS.right : PAD_ACTIONS.left;
+  }
+  return y > 0 ? PAD_ACTIONS.down : PAD_ACTIONS.up;
+}
+function heldDirection(snapshot) {
+  const dpad = DPAD_ACTIONS.find(([index]) => snapshot.buttons[index] === true);
+  return dpad === void 0 ? stickDirection(snapshot.axes) : dpad[1];
+}
+function stepPad(prev, next, repeat, now) {
+  const actions = FACE_BUTTON_ACTIONS.filter(([index]) => next.buttons[index] === true && prev?.buttons[index] !== true).map(([, action]) => action);
+  const direction = heldDirection(next);
+  if (direction === null) {
+    return { actions, repeat: IDLE_REPEAT };
+  }
+  if (direction !== repeat.held) {
+    return { actions: [...actions, direction], repeat: { held: direction, since: now, lastFire: now } };
+  }
+  const firstRepeat = repeat.lastFire === repeat.since;
+  const wait = firstRepeat ? REPEAT_DELAY_MS : REPEAT_INTERVAL_MS;
+  if (now - repeat.lastFire < wait) {
+    return { actions, repeat };
+  }
+  return { actions: [...actions, direction], repeat: { ...repeat, lastFire: now } };
+}
+
+// src/gamepad/createGamepadPoller.ts
+function createGamepadPoller(opts) {
+  let prev = null;
+  let repeat = IDLE_REPEAT;
+  let running = false;
+  let frame = null;
+  const tick = (now) => {
+    frame = null;
+    const pad = opts.getPads().find((p) => p !== null && p.connected);
+    if (pad === void 0) {
+      prev = null;
+      repeat = IDLE_REPEAT;
+    } else {
+      const snapshot = { buttons: pad.buttons.map((b) => b.pressed), axes: pad.axes };
+      const step = stepPad(prev, snapshot, repeat, now);
+      prev = snapshot;
+      repeat = step.repeat;
+      step.actions.forEach((action) => opts.onAction(action));
+    }
+    if (running && frame === null) {
+      frame = opts.requestFrame(tick);
+    }
+  };
+  return {
+    start: () => {
+      if (running) {
+        return;
+      }
+      running = true;
+      if (frame === null) {
+        frame = opts.requestFrame(tick);
+      }
+    },
+    stop: () => {
+      running = false;
+      if (frame !== null) {
+        opts.cancelFrame(frame);
+        frame = null;
+      }
+    }
+  };
+}
+
 // src/constants.ts
 var DEFAULT_HAPTICS_STORAGE_KEY = "game.haptics";
 var DEFAULT_ENABLE_CONFIRMATION = 15;
@@ -81,6 +203,6 @@ function createHaptics(options = {}) {
   };
 }
 
-export { DEFAULT_ENABLE_CONFIRMATION, DEFAULT_HAPTICS_STORAGE_KEY, HAPTIC_PATTERNS, createHaptics };
+export { DEFAULT_ENABLE_CONFIRMATION, DEFAULT_HAPTICS_STORAGE_KEY, HAPTIC_PATTERNS, IDLE_REPEAT, PAD_ACTIONS, STANDARD_BUTTON, createGamepadPoller, createHaptics, stepPad };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/constants.ts","../src/haptics.ts"],"names":[],"mappings":";AAGO,IAAM,2BAAA,GAA8B;AAGpC,IAAM,2BAAA,GAA8B;AAGpC,IAAM,cAAA,GAAiB,GAAA;AAGvB,IAAM,aAAA,GAAgB,GAAA;AAmBtB,IAAM,eAAA,GAA0D;AAAA;AAAA,EAErE,GAAA,EAAK,EAAA;AAAA;AAAA,EAEL,MAAA,EAAQ,EAAA;AAAA;AAAA,EAER,IAAA,EAAM,EAAA;AAAA;AAAA,EAEN,IAAA,EAAM,EAAA;AAAA;AAAA,EAEN,QAAA,EAAU,EAAA;AAAA;AAAA,EAEV,OAAA,EAAS,CAAC,CAAA,EAAG,EAAA,EAAI,IAAI,EAAE,CAAA;AAAA;AAAA,EAEvB,KAAA,EAAO,CAAC,CAAA,EAAG,EAAA,EAAI,IAAI,EAAE,CAAA;AAAA;AAAA,EAErB,IAAA,EAAM,CAAC,CAAA,EAAG,EAAA,EAAI,IAAI,EAAE,CAAA;AAAA;AAAA,EAEpB,QAAQ,CAAC,CAAA,EAAG,IAAI,EAAA,EAAI,EAAA,EAAI,IAAI,EAAE;AAChC;;;AC1CA,SAAS,iBAAiB,QAAA,EAA2D;AACnF,EAAA,IAAI,QAAA,EAAU;AACZ,IAAA,OAAO,QAAA;AAAA,EACT;AACA,EAAA,OAAQ,UAAA,CAAgD,SAAA;AAC1D;AAEA,SAAS,eAAe,QAAA,EAAuD;AAC7E,EAAA,IAAI,QAAA,EAAU;AACZ,IAAA,OAAO,QAAA;AAAA,EACT;AACA,EAAA,OAAQ,UAAA,CAAiD,YAAA;AAC3D;AASO,SAAS,aAAA,CAAc,OAAA,GAA0B,EAAC,EAAY;AACnE,EAAA,MAAM,UAAA,GAAa,QAAQ,UAAA,IAAc,2BAAA;AACzC,EAAA,MAAM,YAAA,GACJ,OAAA,CAAQ,kBAAA,KAAuB,MAAA,GAAY,8BAA8B,OAAA,CAAQ,kBAAA;AACnF,EAAA,MAAM,SAAA,GAAY,gBAAA,CAAiB,OAAA,CAAQ,SAAS,CAAA;AACpD,EAAA,MAAM,OAAA,GAAU,cAAA,CAAe,OAAA,CAAQ,OAAO,CAAA;AAE9C,EAAA,MAAM,WAAW,MAAe;AAC9B,IAAA,IAAI;AACF,MAAA,OAAO,OAAA,EAAS,OAAA,CAAQ,UAAU,CAAA,KAAM,cAAA;AAAA,IAC1C,CAAA,CAAA,MAAQ;AAEN,MAAA,OAAO,IAAA;AAAA,IACT;AAAA,EACF,CAAA;AAEA,EAAA,IAAI,UAAU,QAAA,EAAS;AAEvB,EAAA,MAAM,OAAA,GAAU,CAAC,OAAA,KAAoC;AACnD,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA;AAAA,IACF;AACA,IAAA,IAAI;AACF,MAAA,SAAA,EAAW,UAAU,OAAO,CAAA;AAAA,IAC9B,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,UAAU,MAAY;AAC1B,IAAA,IAAI;AACF,MAAA,OAAA,EAAS,OAAA,CAAQ,UAAA,EAAY,OAAA,GAAU,aAAA,GAAgB,cAAc,CAAA;AAAA,IACvE,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF,CAAA;AAEA,EAAA,MAAM,UAAA,GAAa,CAAC,IAAA,KAA2B;AAC7C,IAAA,OAAA,GAAU,IAAA;AACV,IAAA,OAAA,EAAQ;AAER,IAAA,IAAI,OAAA,IAAW,iBAAiB,IAAA,EAAM;AACpC,MAAA,OAAA,CAAQ,YAAY,CAAA;AAAA,IACtB;AACA,IAAA,OAAO,OAAA;AAAA,EACT,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,WAAW,MAAe,OAAA;AAAA,IAC1B,UAAA;AAAA,IACA,MAAA,EAAQ,MAAe,UAAA,CAAW,CAAC,OAAO,CAAA;AAAA,IAC1C;AAAA,GACF;AACF","file":"index.mjs","sourcesContent":["import type { VibrationPattern } from './types';\n\n/** Default localStorage key for the haptics on/off preference. */\nexport const DEFAULT_HAPTICS_STORAGE_KEY = 'game.haptics';\n\n/** Default confirmation tick fired when haptics are turned ON (ms). */\nexport const DEFAULT_ENABLE_CONFIRMATION = 15;\n\n/** Stored value meaning \"disabled\". Any other value (or absent) means enabled. */\nexport const DISABLED_VALUE = '0';\n\n/** Stored value meaning \"enabled\". */\nexport const ENABLED_VALUE = '1';\n\n/** The semantic intents games map their events onto. */\nexport type HapticIntent =\n  | 'tap'\n  | 'select'\n  | 'lock'\n  | 'bump'\n  | 'navigate'\n  | 'success'\n  | 'error'\n  | 'loss'\n  | 'reveal';\n\n/**\n * A shared vocabulary of vibration patterns keyed by intent, so every game uses\n * the same tuned feel instead of re-picking magic durations. Pass any of these to\n * {@link Haptics.vibrate} (or supply your own pattern).\n */\nexport const HAPTIC_PATTERNS: Record<HapticIntent, VibrationPattern> = {\n  /** Light tick for menu navigation / selection / undo / restart. */\n  tap: 10,\n  /** Light pulse when a tool/charm/item is picked up or selected. */\n  select: 12,\n  /** Short pulse when something locks into place. */\n  lock: 18,\n  /** Dull buzz when an action is blocked. */\n  bump: 24,\n  /** Quick pulse when stepping through a portal / page turn. */\n  navigate: 16,\n  /** Celebratory pattern when a level/chamber is cleared. */\n  success: [0, 40, 50, 90],\n  /** Sharp double crack for a fatal/destructive event. */\n  error: [0, 14, 24, 14],\n  /** Heavier buzz when the player loses / falls. */\n  loss: [0, 40, 50, 40],\n  /** Rising triple pulse the instant a puzzle resolves / an exit opens. */\n  reveal: [0, 14, 20, 18, 26, 24],\n};\n","import {\n  DEFAULT_ENABLE_CONFIRMATION,\n  DEFAULT_HAPTICS_STORAGE_KEY,\n  DISABLED_VALUE,\n  ENABLED_VALUE,\n} from './constants';\nimport type { Haptics, HapticsOptions, HapticsStorage, VibrationCapable, VibrationPattern } from './types';\n\nfunction resolveNavigator(explicit?: VibrationCapable): VibrationCapable | undefined {\n  if (explicit) {\n    return explicit;\n  }\n  return (globalThis as { navigator?: VibrationCapable }).navigator;\n}\n\nfunction resolveStorage(explicit?: HapticsStorage): HapticsStorage | undefined {\n  if (explicit) {\n    return explicit;\n  }\n  return (globalThis as { localStorage?: HapticsStorage }).localStorage;\n}\n\n/**\n * Create a player-toggleable, always-safe haptics controller.\n *\n * The on/off preference is read from (and persisted to) the configured storage key\n * so it survives reloads. Every vibration routes through one gated call that no-ops\n * when disabled, when no Vibration API is present, or if the platform blocks it.\n */\nexport function createHaptics(options: HapticsOptions = {}): Haptics {\n  const storageKey = options.storageKey ?? DEFAULT_HAPTICS_STORAGE_KEY;\n  const confirmation =\n    options.enableConfirmation === undefined ? DEFAULT_ENABLE_CONFIRMATION : options.enableConfirmation;\n  const navigator = resolveNavigator(options.navigator);\n  const storage = resolveStorage(options.storage);\n\n  const readPref = (): boolean => {\n    try {\n      return storage?.getItem(storageKey) !== DISABLED_VALUE;\n    } catch {\n      // Reading storage can throw (blocked cookies / sandboxed iframe) — default ON.\n      return true;\n    }\n  };\n\n  let enabled = readPref();\n\n  const vibrate = (pattern: VibrationPattern): void => {\n    if (!enabled) {\n      return;\n    }\n    try {\n      navigator?.vibrate?.(pattern);\n    } catch {\n      // Vibration can throw if blocked by the platform — never let it break a move.\n    }\n  };\n\n  const persist = (): void => {\n    try {\n      storage?.setItem(storageKey, enabled ? ENABLED_VALUE : DISABLED_VALUE);\n    } catch {\n      // Writing storage can throw (private mode / quota) — ignore.\n    }\n  };\n\n  const setEnabled = (next: boolean): boolean => {\n    enabled = next;\n    persist();\n    // A confirming tick when turning ON so the player feels it engage.\n    if (enabled && confirmation !== null) {\n      vibrate(confirmation);\n    }\n    return enabled;\n  };\n\n  return {\n    isEnabled: (): boolean => enabled,\n    setEnabled,\n    toggle: (): boolean => setEnabled(!enabled),\n    vibrate,\n  };\n}\n"]}
+{"version":3,"sources":["../src/gamepad/padMap.ts","../src/gamepad/stepPad.ts","../src/gamepad/createGamepadPoller.ts","../src/constants.ts","../src/haptics.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/** The semantic actions a Standard Gamepad produces, independent of the device's labels. */\nexport const PAD_ACTIONS = {\n  up: 'up',\n  down: 'down',\n  left: 'left',\n  right: 'right',\n  confirm: 'confirm',\n  back: 'back',\n  mood: 'mood',\n  view: 'view',\n  pagePrev: 'pagePrev',\n  pageNext: 'pageNext',\n} as const;\nexport type PadAction = (typeof PAD_ACTIONS)[keyof typeof PAD_ACTIONS];\n\n/** W3C Standard Gamepad button indices, named by POSITION (Nintendo swaps A/B labels). */\nexport const STANDARD_BUTTON = {\n  south: 0,\n  east: 1,\n  west: 2,\n  north: 3,\n  leftShoulder: 4,\n  rightShoulder: 5,\n  dpadUp: 12,\n  dpadDown: 13,\n  dpadLeft: 14,\n  dpadRight: 15,\n} as const;\n\n/** Edge-triggered buttons, in dispatch order. */\nexport const FACE_BUTTON_ACTIONS: ReadonlyArray<readonly [number, PadAction]> = [\n  [STANDARD_BUTTON.south, PAD_ACTIONS.confirm],\n  [STANDARD_BUTTON.east, PAD_ACTIONS.back],\n  [STANDARD_BUTTON.west, PAD_ACTIONS.view],\n  [STANDARD_BUTTON.north, PAD_ACTIONS.mood],\n  [STANDARD_BUTTON.leftShoulder, PAD_ACTIONS.pagePrev],\n  [STANDARD_BUTTON.rightShoulder, PAD_ACTIONS.pageNext],\n];\n\n/** Held (auto-repeating) buttons; the first pressed one wins. */\nexport const DPAD_ACTIONS: ReadonlyArray<readonly [number, PadAction]> = [\n  [STANDARD_BUTTON.dpadUp, PAD_ACTIONS.up],\n  [STANDARD_BUTTON.dpadDown, PAD_ACTIONS.down],\n  [STANDARD_BUTTON.dpadLeft, PAD_ACTIONS.left],\n  [STANDARD_BUTTON.dpadRight, PAD_ACTIONS.right],\n];\n\n/** Left-stick magnitude below which the stick counts as centred. */\nexport const STICK_DEAD_ZONE = 0.5;\n/** Delay before a held direction starts repeating (ms). */\nexport const REPEAT_DELAY_MS = 380;\n/** Interval between repeats once repeating (ms). */\nexport const REPEAT_INTERVAL_MS = 110;\n","import {\n  DPAD_ACTIONS,\n  FACE_BUTTON_ACTIONS,\n  PAD_ACTIONS,\n  REPEAT_DELAY_MS,\n  REPEAT_INTERVAL_MS,\n  STICK_DEAD_ZONE,\n  type PadAction,\n} from './padMap';\n\n/** One frame of pad state: pressed flags by Standard button index, and raw axes. */\nexport interface PadSnapshot {\n  buttons: readonly boolean[];\n  axes: readonly number[];\n}\n\n/** Which direction is held, when it started, and when it last fired. */\nexport interface RepeatState {\n  held: PadAction | null;\n  since: number;\n  lastFire: number;\n}\n\nexport const IDLE_REPEAT: RepeatState = { held: null, since: 0, lastFire: 0 };\n\nconst STICK_X = 0;\nconst STICK_Y = 1;\n\nfunction stickDirection(axes: readonly number[]): PadAction | null {\n  const x = axes[STICK_X] ?? 0;\n  const y = axes[STICK_Y] ?? 0;\n  if (Math.max(Math.abs(x), Math.abs(y)) < STICK_DEAD_ZONE) {\n    return null;\n  }\n  if (Math.abs(x) > Math.abs(y)) {\n    return x > 0 ? PAD_ACTIONS.right : PAD_ACTIONS.left;\n  }\n  return y > 0 ? PAD_ACTIONS.down : PAD_ACTIONS.up;\n}\n\nfunction heldDirection(snapshot: PadSnapshot): PadAction | null {\n  const dpad = DPAD_ACTIONS.find(([index]) => snapshot.buttons[index] === true);\n  return dpad === undefined ? stickDirection(snapshot.axes) : dpad[1];\n}\n\n/** One poll frame → the actions to dispatch and the next repeat state. Pure. */\nexport function stepPad(\n  prev: PadSnapshot | null,\n  next: PadSnapshot,\n  repeat: RepeatState,\n  now: number,\n): { actions: PadAction[]; repeat: RepeatState } {\n  const actions: PadAction[] = FACE_BUTTON_ACTIONS\n    .filter(([index]) => next.buttons[index] === true && prev?.buttons[index] !== true)\n    .map(([, action]) => action);\n  const direction = heldDirection(next);\n  if (direction === null) {\n    return { actions, repeat: IDLE_REPEAT };\n  }\n  if (direction !== repeat.held) {\n    return { actions: [...actions, direction], repeat: { held: direction, since: now, lastFire: now } };\n  }\n  const firstRepeat = repeat.lastFire === repeat.since;\n  const wait = firstRepeat ? REPEAT_DELAY_MS : REPEAT_INTERVAL_MS;\n  if (now - repeat.lastFire < wait) {\n    return { actions, repeat };\n  }\n  return { actions: [...actions, direction], repeat: { ...repeat, lastFire: now } };\n}\n","import type { PadAction } from './padMap';\nimport { IDLE_REPEAT, stepPad, type PadSnapshot, type RepeatState } from './stepPad';\n\n/** The structural subset of the DOM `Gamepad` the poller reads. */\nexport interface PadLike {\n  connected: boolean;\n  buttons: ReadonlyArray<{ pressed: boolean }>;\n  axes: readonly number[];\n}\n\nexport interface GamepadPollerOptions {\n  /** Usually `() => navigator.getGamepads()`. */\n  getPads: () => ReadonlyArray<PadLike | null>;\n  /** Usually `requestAnimationFrame`. */\n  requestFrame: (cb: (now: number) => void) => number;\n  /** Usually `cancelAnimationFrame`. */\n  cancelFrame: (id: number) => void;\n  onAction: (action: PadAction) => void;\n}\n\n/**\n * rAF-driven poller over the first connected pad. Starts idle; call start().\n * Safe to stop() (or stop() then start()) from inside `onAction`.\n */\nexport function createGamepadPoller(opts: GamepadPollerOptions): { start: () => void; stop: () => void } {\n  let prev: PadSnapshot | null = null;\n  let repeat: RepeatState = IDLE_REPEAT;\n  let running = false;\n  let frame: number | null = null;\n\n  const tick = (now: number): void => {\n    frame = null;\n    const pad = opts.getPads().find((p): p is PadLike => p !== null && p.connected);\n    if (pad === undefined) {\n      prev = null;\n      repeat = IDLE_REPEAT;\n    } else {\n      const snapshot: PadSnapshot = { buttons: pad.buttons.map((b) => b.pressed), axes: pad.axes };\n      const step = stepPad(prev, snapshot, repeat, now);\n      prev = snapshot;\n      repeat = step.repeat;\n      step.actions.forEach((action) => opts.onAction(action));\n    }\n    if (running && frame === null) {\n      frame = opts.requestFrame(tick);\n    }\n  };\n\n  return {\n    start: (): void => {\n      if (running) {\n        return;\n      }\n      running = true;\n      if (frame === null) {\n        frame = opts.requestFrame(tick);\n      }\n    },\n    stop: (): void => {\n      running = false;\n      if (frame !== null) {\n        opts.cancelFrame(frame);\n        frame = null;\n      }\n    },\n  };\n}\n","import type { VibrationPattern } from './types';\n\n/** Default localStorage key for the haptics on/off preference. */\nexport const DEFAULT_HAPTICS_STORAGE_KEY = 'game.haptics';\n\n/** Default confirmation tick fired when haptics are turned ON (ms). */\nexport const DEFAULT_ENABLE_CONFIRMATION = 15;\n\n/** Stored value meaning \"disabled\". Any other value (or absent) means enabled. */\nexport const DISABLED_VALUE = '0';\n\n/** Stored value meaning \"enabled\". */\nexport const ENABLED_VALUE = '1';\n\n/** The semantic intents games map their events onto. */\nexport type HapticIntent =\n  | 'tap'\n  | 'select'\n  | 'lock'\n  | 'bump'\n  | 'navigate'\n  | 'success'\n  | 'error'\n  | 'loss'\n  | 'reveal';\n\n/**\n * A shared vocabulary of vibration patterns keyed by intent, so every game uses\n * the same tuned feel instead of re-picking magic durations. Pass any of these to\n * {@link Haptics.vibrate} (or supply your own pattern).\n */\nexport const HAPTIC_PATTERNS: Record<HapticIntent, VibrationPattern> = {\n  /** Light tick for menu navigation / selection / undo / restart. */\n  tap: 10,\n  /** Light pulse when a tool/charm/item is picked up or selected. */\n  select: 12,\n  /** Short pulse when something locks into place. */\n  lock: 18,\n  /** Dull buzz when an action is blocked. */\n  bump: 24,\n  /** Quick pulse when stepping through a portal / page turn. */\n  navigate: 16,\n  /** Celebratory pattern when a level/chamber is cleared. */\n  success: [0, 40, 50, 90],\n  /** Sharp double crack for a fatal/destructive event. */\n  error: [0, 14, 24, 14],\n  /** Heavier buzz when the player loses / falls. */\n  loss: [0, 40, 50, 40],\n  /** Rising triple pulse the instant a puzzle resolves / an exit opens. */\n  reveal: [0, 14, 20, 18, 26, 24],\n};\n","import {\n  DEFAULT_ENABLE_CONFIRMATION,\n  DEFAULT_HAPTICS_STORAGE_KEY,\n  DISABLED_VALUE,\n  ENABLED_VALUE,\n} from './constants';\nimport type { Haptics, HapticsOptions, HapticsStorage, VibrationCapable, VibrationPattern } from './types';\n\nfunction resolveNavigator(explicit?: VibrationCapable): VibrationCapable | undefined {\n  if (explicit) {\n    return explicit;\n  }\n  return (globalThis as { navigator?: VibrationCapable }).navigator;\n}\n\nfunction resolveStorage(explicit?: HapticsStorage): HapticsStorage | undefined {\n  if (explicit) {\n    return explicit;\n  }\n  return (globalThis as { localStorage?: HapticsStorage }).localStorage;\n}\n\n/**\n * Create a player-toggleable, always-safe haptics controller.\n *\n * The on/off preference is read from (and persisted to) the configured storage key\n * so it survives reloads. Every vibration routes through one gated call that no-ops\n * when disabled, when no Vibration API is present, or if the platform blocks it.\n */\nexport function createHaptics(options: HapticsOptions = {}): Haptics {\n  const storageKey = options.storageKey ?? DEFAULT_HAPTICS_STORAGE_KEY;\n  const confirmation =\n    options.enableConfirmation === undefined ? DEFAULT_ENABLE_CONFIRMATION : options.enableConfirmation;\n  const navigator = resolveNavigator(options.navigator);\n  const storage = resolveStorage(options.storage);\n\n  const readPref = (): boolean => {\n    try {\n      return storage?.getItem(storageKey) !== DISABLED_VALUE;\n    } catch {\n      // Reading storage can throw (blocked cookies / sandboxed iframe) — default ON.\n      return true;\n    }\n  };\n\n  let enabled = readPref();\n\n  const vibrate = (pattern: VibrationPattern): void => {\n    if (!enabled) {\n      return;\n    }\n    try {\n      navigator?.vibrate?.(pattern);\n    } catch {\n      // Vibration can throw if blocked by the platform — never let it break a move.\n    }\n  };\n\n  const persist = (): void => {\n    try {\n      storage?.setItem(storageKey, enabled ? ENABLED_VALUE : DISABLED_VALUE);\n    } catch {\n      // Writing storage can throw (private mode / quota) — ignore.\n    }\n  };\n\n  const setEnabled = (next: boolean): boolean => {\n    enabled = next;\n    persist();\n    // A confirming tick when turning ON so the player feels it engage.\n    if (enabled && confirmation !== null) {\n      vibrate(confirmation);\n    }\n    return enabled;\n  };\n\n  return {\n    isEnabled: (): boolean => enabled,\n    setEnabled,\n    toggle: (): boolean => setEnabled(!enabled),\n    vibrate,\n  };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dloizides/game-input",
-  "version": "1.0.0",
+  "version": "1.3.0",
   "description": "Framework-agnostic game input primitives. v1 ships safe, player-toggleable haptics (Vibration API wrapper, localStorage-gated, zero deps). Extracted from Aurora; consumed across EisaiPollis games.",
   "keywords": [
     "haptics",