@hapticjs/gamepad 0.1.0

package/dist/index.cjs

@@ -0,0 +1,164 @@
+'use strict';
+
+// src/utils/gamepad-manager.ts
+var GamepadManager = class {
+  constructor() {
+    this._listening = false;
+    this._handleConnect = (e) => {
+      this._onConnect?.(e.gamepad);
+    };
+    this._handleDisconnect = (e) => {
+      this._onDisconnect?.(e.gamepad);
+    };
+  }
+  /** Start listening for gamepad connections */
+  listen() {
+    if (this._listening || typeof window === "undefined") return;
+    this._listening = true;
+    window.addEventListener("gamepadconnected", this._handleConnect);
+    window.addEventListener("gamepaddisconnected", this._handleDisconnect);
+  }
+  /** Stop listening */
+  unlisten() {
+    if (!this._listening || typeof window === "undefined") return;
+    this._listening = false;
+    window.removeEventListener("gamepadconnected", this._handleConnect);
+    window.removeEventListener("gamepaddisconnected", this._handleDisconnect);
+  }
+  /** Get all currently connected gamepads */
+  getGamepads() {
+    if (typeof navigator === "undefined" || !("getGamepads" in navigator)) {
+      return [];
+    }
+    return Array.from(navigator.getGamepads()).filter(
+      (gp) => gp !== null
+    );
+  }
+  /** Get the first connected gamepad, or null */
+  getFirstGamepad() {
+    const gamepads = this.getGamepads();
+    return gamepads[0] ?? null;
+  }
+  /** Set connection callback */
+  onConnect(fn) {
+    this._onConnect = fn;
+  }
+  /** Set disconnection callback */
+  onDisconnect(fn) {
+    this._onDisconnect = fn;
+  }
+  /** Check if any gamepad with haptic support is connected */
+  hasHapticGamepad() {
+    return this.getGamepads().some(
+      (gp) => gp.vibrationActuator != null
+    );
+  }
+  dispose() {
+    this.unlisten();
+    this._onConnect = void 0;
+    this._onDisconnect = void 0;
+  }
+};
+
+// src/utils/dual-motor.ts
+var defaultMotorMapping = (intensity) => {
+  return {
+    weakMagnitude: Math.min(intensity * 1.5, 1),
+    strongMagnitude: Math.max(intensity - 0.3, 0)
+  };
+};
+var equalMotorMapping = (intensity) => {
+  return {
+    weakMagnitude: intensity,
+    strongMagnitude: intensity
+  };
+};
+var heavyMotorMapping = (intensity) => {
+  return {
+    weakMagnitude: intensity * 0.3,
+    strongMagnitude: intensity
+  };
+};
+
+// src/adapters/gamepad-haptic.adapter.ts
+var GamepadHapticAdapter = class {
+  constructor(options = {}) {
+    this.name = "gamepad";
+    this._cancelled = false;
+    this.manager = new GamepadManager();
+    this.motorMapping = options.motorMapping ?? defaultMotorMapping;
+    this.gamepadIndex = options.gamepadIndex;
+    if (options.autoListen !== false) {
+      this.manager.listen();
+    }
+  }
+  get supported() {
+    return this.manager.hasHapticGamepad();
+  }
+  capabilities() {
+    return {
+      maxIntensityLevels: 100,
+      minDuration: 1,
+      maxDuration: 5e3,
+      supportsPattern: false,
+      supportsIntensity: true,
+      dualMotor: true
+    };
+  }
+  async pulse(intensity, duration) {
+    const gamepad = this._getGamepad();
+    if (!gamepad?.vibrationActuator) return;
+    const { weakMagnitude, strongMagnitude } = this.motorMapping(intensity);
+    await gamepad.vibrationActuator.playEffect("dual-rumble", {
+      startDelay: 0,
+      duration,
+      weakMagnitude,
+      strongMagnitude
+    });
+  }
+  async playSequence(steps) {
+    this._cancelled = false;
+    for (const step of steps) {
+      if (this._cancelled) break;
+      if (step.type === "vibrate" && step.intensity > 0) {
+        await this.pulse(step.intensity, step.duration);
+        await this._delay(step.duration);
+      } else {
+        await this._delay(step.duration);
+      }
+    }
+  }
+  cancel() {
+    this._cancelled = true;
+    const gamepad = this._getGamepad();
+    if (gamepad?.vibrationActuator) {
+      gamepad.vibrationActuator.reset();
+    }
+  }
+  dispose() {
+    this.cancel();
+    this.manager.dispose();
+  }
+  /** Get the gamepad manager for advanced usage */
+  getManager() {
+    return this.manager;
+  }
+  _getGamepad() {
+    if (this.gamepadIndex !== void 0) {
+      const gamepads = this.manager.getGamepads();
+      return gamepads.find((gp) => gp.index === this.gamepadIndex) ?? null;
+    }
+    return this.manager.getFirstGamepad();
+  }
+  _delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+};
+
+exports.GamepadHapticAdapter = GamepadHapticAdapter;
+exports.GamepadManager = GamepadManager;
+exports.defaultMotorMapping = defaultMotorMapping;
+exports.equalMotorMapping = equalMotorMapping;
+exports.heavyMotorMapping = heavyMotorMapping;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/gamepad-manager.ts","../src/utils/dual-motor.ts","../src/adapters/gamepad-haptic.adapter.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/** Manages gamepad connection state and provides access to connected gamepads */\nexport class GamepadManager {\n  private _onConnect?: (gamepad: Gamepad) => void;\n  private _onDisconnect?: (gamepad: Gamepad) => void;\n  private _listening = false;\n\n  /** Start listening for gamepad connections */\n  listen(): void {\n    if (this._listening || typeof window === 'undefined') return;\n    this._listening = true;\n\n    window.addEventListener('gamepadconnected', this._handleConnect);\n    window.addEventListener('gamepaddisconnected', this._handleDisconnect);\n  }\n\n  /** Stop listening */\n  unlisten(): void {\n    if (!this._listening || typeof window === 'undefined') return;\n    this._listening = false;\n\n    window.removeEventListener('gamepadconnected', this._handleConnect);\n    window.removeEventListener('gamepaddisconnected', this._handleDisconnect);\n  }\n\n  /** Get all currently connected gamepads */\n  getGamepads(): Gamepad[] {\n    if (typeof navigator === 'undefined' || !('getGamepads' in navigator)) {\n      return [];\n    }\n    return Array.from(navigator.getGamepads()).filter(\n      (gp): gp is Gamepad => gp !== null\n    );\n  }\n\n  /** Get the first connected gamepad, or null */\n  getFirstGamepad(): Gamepad | null {\n    const gamepads = this.getGamepads();\n    return gamepads[0] ?? null;\n  }\n\n  /** Set connection callback */\n  onConnect(fn: (gamepad: Gamepad) => void): void {\n    this._onConnect = fn;\n  }\n\n  /** Set disconnection callback */\n  onDisconnect(fn: (gamepad: Gamepad) => void): void {\n    this._onDisconnect = fn;\n  }\n\n  /** Check if any gamepad with haptic support is connected */\n  hasHapticGamepad(): boolean {\n    return this.getGamepads().some(\n      (gp) => gp.vibrationActuator != null\n    );\n  }\n\n  dispose(): void {\n    this.unlisten();\n    this._onConnect = undefined;\n    this._onDisconnect = undefined;\n  }\n\n  private _handleConnect = (e: GamepadEvent) => {\n    this._onConnect?.(e.gamepad);\n  };\n\n  private _handleDisconnect = (e: GamepadEvent) => {\n    this._onDisconnect?.(e.gamepad);\n  };\n}\n","/** Dual motor parameters for gamepad haptics */\nexport interface DualMotorParams {\n  /** Weak (high-frequency) motor magnitude 0-1 */\n  weakMagnitude: number;\n  /** Strong (low-frequency) motor magnitude 0-1 */\n  strongMagnitude: number;\n}\n\nexport type MotorMappingFn = (intensity: number) => DualMotorParams;\n\n/**\n * Default motor mapping: light effects use weak motor, heavy use strong, medium uses both.\n */\nexport const defaultMotorMapping: MotorMappingFn = (intensity: number): DualMotorParams => {\n  return {\n    weakMagnitude: Math.min(intensity * 1.5, 1.0),\n    strongMagnitude: Math.max(intensity - 0.3, 0),\n  };\n};\n\n/**\n * Equal mapping: both motors at same intensity.\n */\nexport const equalMotorMapping: MotorMappingFn = (intensity: number): DualMotorParams => {\n  return {\n    weakMagnitude: intensity,\n    strongMagnitude: intensity,\n  };\n};\n\n/**\n * Heavy mapping: emphasizes the strong (low-frequency) motor.\n */\nexport const heavyMotorMapping: MotorMappingFn = (intensity: number): DualMotorParams => {\n  return {\n    weakMagnitude: intensity * 0.3,\n    strongMagnitude: intensity,\n  };\n};\n","import type { HapticAdapter, AdapterCapabilities, HapticStep } from '@hapticjs/core';\nimport { GamepadManager } from '../utils/gamepad-manager';\nimport { defaultMotorMapping } from '../utils/dual-motor';\nimport type { MotorMappingFn } from '../utils/dual-motor';\n\nexport interface GamepadAdapterOptions {\n  /** Which gamepad index to use (default: first connected) */\n  gamepadIndex?: number;\n  /** Custom motor mapping function */\n  motorMapping?: MotorMappingFn;\n  /** Auto-listen for gamepad connections (default: true) */\n  autoListen?: boolean;\n}\n\n/**\n * Gamepad haptics adapter using the GamepadHapticActuator API.\n * Supports dual-motor (weak/strong) vibration on modern controllers.\n */\nexport class GamepadHapticAdapter implements HapticAdapter {\n  readonly name = 'gamepad';\n  private manager: GamepadManager;\n  private motorMapping: MotorMappingFn;\n  private gamepadIndex?: number;\n  private _cancelled = false;\n\n  constructor(options: GamepadAdapterOptions = {}) {\n    this.manager = new GamepadManager();\n    this.motorMapping = options.motorMapping ?? defaultMotorMapping;\n    this.gamepadIndex = options.gamepadIndex;\n\n    if (options.autoListen !== false) {\n      this.manager.listen();\n    }\n  }\n\n  get supported(): boolean {\n    return this.manager.hasHapticGamepad();\n  }\n\n  capabilities(): AdapterCapabilities {\n    return {\n      maxIntensityLevels: 100,\n      minDuration: 1,\n      maxDuration: 5000,\n      supportsPattern: false,\n      supportsIntensity: true,\n      dualMotor: true,\n    };\n  }\n\n  async pulse(intensity: number, duration: number): Promise<void> {\n    const gamepad = this._getGamepad();\n    if (!gamepad?.vibrationActuator) return;\n\n    const { weakMagnitude, strongMagnitude } = this.motorMapping(intensity);\n\n    await gamepad.vibrationActuator.playEffect('dual-rumble', {\n      startDelay: 0,\n      duration,\n      weakMagnitude,\n      strongMagnitude,\n    });\n  }\n\n  async playSequence(steps: HapticStep[]): Promise<void> {\n    this._cancelled = false;\n\n    for (const step of steps) {\n      if (this._cancelled) break;\n\n      if (step.type === 'vibrate' && step.intensity > 0) {\n        await this.pulse(step.intensity, step.duration);\n        await this._delay(step.duration);\n      } else {\n        await this._delay(step.duration);\n      }\n    }\n  }\n\n  cancel(): void {\n    this._cancelled = true;\n    const gamepad = this._getGamepad();\n    if (gamepad?.vibrationActuator) {\n      gamepad.vibrationActuator.reset();\n    }\n  }\n\n  dispose(): void {\n    this.cancel();\n    this.manager.dispose();\n  }\n\n  /** Get the gamepad manager for advanced usage */\n  getManager(): GamepadManager {\n    return this.manager;\n  }\n\n  private _getGamepad(): Gamepad | null {\n    if (this.gamepadIndex !== undefined) {\n      const gamepads = this.manager.getGamepads();\n      return gamepads.find((gp) => gp.index === this.gamepadIndex) ?? null;\n    }\n    return this.manager.getFirstGamepad();\n  }\n\n  private _delay(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,79 @@
+import { HapticAdapter, AdapterCapabilities, HapticStep } from '@hapticjs/core';
+
+/** Manages gamepad connection state and provides access to connected gamepads */
+declare class GamepadManager {
+    private _onConnect?;
+    private _onDisconnect?;
+    private _listening;
+    /** Start listening for gamepad connections */
+    listen(): void;
+    /** Stop listening */
+    unlisten(): void;
+    /** Get all currently connected gamepads */
+    getGamepads(): Gamepad[];
+    /** Get the first connected gamepad, or null */
+    getFirstGamepad(): Gamepad | null;
+    /** Set connection callback */
+    onConnect(fn: (gamepad: Gamepad) => void): void;
+    /** Set disconnection callback */
+    onDisconnect(fn: (gamepad: Gamepad) => void): void;
+    /** Check if any gamepad with haptic support is connected */
+    hasHapticGamepad(): boolean;
+    dispose(): void;
+    private _handleConnect;
+    private _handleDisconnect;
+}
+
+/** Dual motor parameters for gamepad haptics */
+interface DualMotorParams {
+    /** Weak (high-frequency) motor magnitude 0-1 */
+    weakMagnitude: number;
+    /** Strong (low-frequency) motor magnitude 0-1 */
+    strongMagnitude: number;
+}
+type MotorMappingFn = (intensity: number) => DualMotorParams;
+/**
+ * Default motor mapping: light effects use weak motor, heavy use strong, medium uses both.
+ */
+declare const defaultMotorMapping: MotorMappingFn;
+/**
+ * Equal mapping: both motors at same intensity.
+ */
+declare const equalMotorMapping: MotorMappingFn;
+/**
+ * Heavy mapping: emphasizes the strong (low-frequency) motor.
+ */
+declare const heavyMotorMapping: MotorMappingFn;
+
+interface GamepadAdapterOptions {
+    /** Which gamepad index to use (default: first connected) */
+    gamepadIndex?: number;
+    /** Custom motor mapping function */
+    motorMapping?: MotorMappingFn;
+    /** Auto-listen for gamepad connections (default: true) */
+    autoListen?: boolean;
+}
+/**
+ * Gamepad haptics adapter using the GamepadHapticActuator API.
+ * Supports dual-motor (weak/strong) vibration on modern controllers.
+ */
+declare class GamepadHapticAdapter implements HapticAdapter {
+    readonly name = "gamepad";
+    private manager;
+    private motorMapping;
+    private gamepadIndex?;
+    private _cancelled;
+    constructor(options?: GamepadAdapterOptions);
+    get supported(): boolean;
+    capabilities(): AdapterCapabilities;
+    pulse(intensity: number, duration: number): Promise<void>;
+    playSequence(steps: HapticStep[]): Promise<void>;
+    cancel(): void;
+    dispose(): void;
+    /** Get the gamepad manager for advanced usage */
+    getManager(): GamepadManager;
+    private _getGamepad;
+    private _delay;
+}
+
+export { type DualMotorParams, type GamepadAdapterOptions, GamepadHapticAdapter, GamepadManager, type MotorMappingFn, defaultMotorMapping, equalMotorMapping, heavyMotorMapping };

package/dist/index.d.ts

@@ -0,0 +1,79 @@
+import { HapticAdapter, AdapterCapabilities, HapticStep } from '@hapticjs/core';
+
+/** Manages gamepad connection state and provides access to connected gamepads */
+declare class GamepadManager {
+    private _onConnect?;
+    private _onDisconnect?;
+    private _listening;
+    /** Start listening for gamepad connections */
+    listen(): void;
+    /** Stop listening */
+    unlisten(): void;
+    /** Get all currently connected gamepads */
+    getGamepads(): Gamepad[];
+    /** Get the first connected gamepad, or null */
+    getFirstGamepad(): Gamepad | null;
+    /** Set connection callback */
+    onConnect(fn: (gamepad: Gamepad) => void): void;
+    /** Set disconnection callback */
+    onDisconnect(fn: (gamepad: Gamepad) => void): void;
+    /** Check if any gamepad with haptic support is connected */
+    hasHapticGamepad(): boolean;
+    dispose(): void;
+    private _handleConnect;
+    private _handleDisconnect;
+}
+
+/** Dual motor parameters for gamepad haptics */
+interface DualMotorParams {
+    /** Weak (high-frequency) motor magnitude 0-1 */
+    weakMagnitude: number;
+    /** Strong (low-frequency) motor magnitude 0-1 */
+    strongMagnitude: number;
+}
+type MotorMappingFn = (intensity: number) => DualMotorParams;
+/**
+ * Default motor mapping: light effects use weak motor, heavy use strong, medium uses both.
+ */
+declare const defaultMotorMapping: MotorMappingFn;
+/**
+ * Equal mapping: both motors at same intensity.
+ */
+declare const equalMotorMapping: MotorMappingFn;
+/**
+ * Heavy mapping: emphasizes the strong (low-frequency) motor.
+ */
+declare const heavyMotorMapping: MotorMappingFn;
+
+interface GamepadAdapterOptions {
+    /** Which gamepad index to use (default: first connected) */
+    gamepadIndex?: number;
+    /** Custom motor mapping function */
+    motorMapping?: MotorMappingFn;
+    /** Auto-listen for gamepad connections (default: true) */
+    autoListen?: boolean;
+}
+/**
+ * Gamepad haptics adapter using the GamepadHapticActuator API.
+ * Supports dual-motor (weak/strong) vibration on modern controllers.
+ */
+declare class GamepadHapticAdapter implements HapticAdapter {
+    readonly name = "gamepad";
+    private manager;
+    private motorMapping;
+    private gamepadIndex?;
+    private _cancelled;
+    constructor(options?: GamepadAdapterOptions);
+    get supported(): boolean;
+    capabilities(): AdapterCapabilities;
+    pulse(intensity: number, duration: number): Promise<void>;
+    playSequence(steps: HapticStep[]): Promise<void>;
+    cancel(): void;
+    dispose(): void;
+    /** Get the gamepad manager for advanced usage */
+    getManager(): GamepadManager;
+    private _getGamepad;
+    private _delay;
+}
+
+export { type DualMotorParams, type GamepadAdapterOptions, GamepadHapticAdapter, GamepadManager, type MotorMappingFn, defaultMotorMapping, equalMotorMapping, heavyMotorMapping };

package/dist/index.js

@@ -0,0 +1,158 @@
+// src/utils/gamepad-manager.ts
+var GamepadManager = class {
+  constructor() {
+    this._listening = false;
+    this._handleConnect = (e) => {
+      this._onConnect?.(e.gamepad);
+    };
+    this._handleDisconnect = (e) => {
+      this._onDisconnect?.(e.gamepad);
+    };
+  }
+  /** Start listening for gamepad connections */
+  listen() {
+    if (this._listening || typeof window === "undefined") return;
+    this._listening = true;
+    window.addEventListener("gamepadconnected", this._handleConnect);
+    window.addEventListener("gamepaddisconnected", this._handleDisconnect);
+  }
+  /** Stop listening */
+  unlisten() {
+    if (!this._listening || typeof window === "undefined") return;
+    this._listening = false;
+    window.removeEventListener("gamepadconnected", this._handleConnect);
+    window.removeEventListener("gamepaddisconnected", this._handleDisconnect);
+  }
+  /** Get all currently connected gamepads */
+  getGamepads() {
+    if (typeof navigator === "undefined" || !("getGamepads" in navigator)) {
+      return [];
+    }
+    return Array.from(navigator.getGamepads()).filter(
+      (gp) => gp !== null
+    );
+  }
+  /** Get the first connected gamepad, or null */
+  getFirstGamepad() {
+    const gamepads = this.getGamepads();
+    return gamepads[0] ?? null;
+  }
+  /** Set connection callback */
+  onConnect(fn) {
+    this._onConnect = fn;
+  }
+  /** Set disconnection callback */
+  onDisconnect(fn) {
+    this._onDisconnect = fn;
+  }
+  /** Check if any gamepad with haptic support is connected */
+  hasHapticGamepad() {
+    return this.getGamepads().some(
+      (gp) => gp.vibrationActuator != null
+    );
+  }
+  dispose() {
+    this.unlisten();
+    this._onConnect = void 0;
+    this._onDisconnect = void 0;
+  }
+};
+
+// src/utils/dual-motor.ts
+var defaultMotorMapping = (intensity) => {
+  return {
+    weakMagnitude: Math.min(intensity * 1.5, 1),
+    strongMagnitude: Math.max(intensity - 0.3, 0)
+  };
+};
+var equalMotorMapping = (intensity) => {
+  return {
+    weakMagnitude: intensity,
+    strongMagnitude: intensity
+  };
+};
+var heavyMotorMapping = (intensity) => {
+  return {
+    weakMagnitude: intensity * 0.3,
+    strongMagnitude: intensity
+  };
+};
+
+// src/adapters/gamepad-haptic.adapter.ts
+var GamepadHapticAdapter = class {
+  constructor(options = {}) {
+    this.name = "gamepad";
+    this._cancelled = false;
+    this.manager = new GamepadManager();
+    this.motorMapping = options.motorMapping ?? defaultMotorMapping;
+    this.gamepadIndex = options.gamepadIndex;
+    if (options.autoListen !== false) {
+      this.manager.listen();
+    }
+  }
+  get supported() {
+    return this.manager.hasHapticGamepad();
+  }
+  capabilities() {
+    return {
+      maxIntensityLevels: 100,
+      minDuration: 1,
+      maxDuration: 5e3,
+      supportsPattern: false,
+      supportsIntensity: true,
+      dualMotor: true
+    };
+  }
+  async pulse(intensity, duration) {
+    const gamepad = this._getGamepad();
+    if (!gamepad?.vibrationActuator) return;
+    const { weakMagnitude, strongMagnitude } = this.motorMapping(intensity);
+    await gamepad.vibrationActuator.playEffect("dual-rumble", {
+      startDelay: 0,
+      duration,
+      weakMagnitude,
+      strongMagnitude
+    });
+  }
+  async playSequence(steps) {
+    this._cancelled = false;
+    for (const step of steps) {
+      if (this._cancelled) break;
+      if (step.type === "vibrate" && step.intensity > 0) {
+        await this.pulse(step.intensity, step.duration);
+        await this._delay(step.duration);
+      } else {
+        await this._delay(step.duration);
+      }
+    }
+  }
+  cancel() {
+    this._cancelled = true;
+    const gamepad = this._getGamepad();
+    if (gamepad?.vibrationActuator) {
+      gamepad.vibrationActuator.reset();
+    }
+  }
+  dispose() {
+    this.cancel();
+    this.manager.dispose();
+  }
+  /** Get the gamepad manager for advanced usage */
+  getManager() {
+    return this.manager;
+  }
+  _getGamepad() {
+    if (this.gamepadIndex !== void 0) {
+      const gamepads = this.manager.getGamepads();
+      return gamepads.find((gp) => gp.index === this.gamepadIndex) ?? null;
+    }
+    return this.manager.getFirstGamepad();
+  }
+  _delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+};
+
+export { GamepadHapticAdapter, GamepadManager, defaultMotorMapping, equalMotorMapping, heavyMotorMapping };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/gamepad-manager.ts","../src/utils/dual-motor.ts","../src/adapters/gamepad-haptic.adapter.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/** Manages gamepad connection state and provides access to connected gamepads */\nexport class GamepadManager {\n  private _onConnect?: (gamepad: Gamepad) => void;\n  private _onDisconnect?: (gamepad: Gamepad) => void;\n  private _listening = false;\n\n  /** Start listening for gamepad connections */\n  listen(): void {\n    if (this._listening || typeof window === 'undefined') return;\n    this._listening = true;\n\n    window.addEventListener('gamepadconnected', this._handleConnect);\n    window.addEventListener('gamepaddisconnected', this._handleDisconnect);\n  }\n\n  /** Stop listening */\n  unlisten(): void {\n    if (!this._listening || typeof window === 'undefined') return;\n    this._listening = false;\n\n    window.removeEventListener('gamepadconnected', this._handleConnect);\n    window.removeEventListener('gamepaddisconnected', this._handleDisconnect);\n  }\n\n  /** Get all currently connected gamepads */\n  getGamepads(): Gamepad[] {\n    if (typeof navigator === 'undefined' || !('getGamepads' in navigator)) {\n      return [];\n    }\n    return Array.from(navigator.getGamepads()).filter(\n      (gp): gp is Gamepad => gp !== null\n    );\n  }\n\n  /** Get the first connected gamepad, or null */\n  getFirstGamepad(): Gamepad | null {\n    const gamepads = this.getGamepads();\n    return gamepads[0] ?? null;\n  }\n\n  /** Set connection callback */\n  onConnect(fn: (gamepad: Gamepad) => void): void {\n    this._onConnect = fn;\n  }\n\n  /** Set disconnection callback */\n  onDisconnect(fn: (gamepad: Gamepad) => void): void {\n    this._onDisconnect = fn;\n  }\n\n  /** Check if any gamepad with haptic support is connected */\n  hasHapticGamepad(): boolean {\n    return this.getGamepads().some(\n      (gp) => gp.vibrationActuator != null\n    );\n  }\n\n  dispose(): void {\n    this.unlisten();\n    this._onConnect = undefined;\n    this._onDisconnect = undefined;\n  }\n\n  private _handleConnect = (e: GamepadEvent) => {\n    this._onConnect?.(e.gamepad);\n  };\n\n  private _handleDisconnect = (e: GamepadEvent) => {\n    this._onDisconnect?.(e.gamepad);\n  };\n}\n","/** Dual motor parameters for gamepad haptics */\nexport interface DualMotorParams {\n  /** Weak (high-frequency) motor magnitude 0-1 */\n  weakMagnitude: number;\n  /** Strong (low-frequency) motor magnitude 0-1 */\n  strongMagnitude: number;\n}\n\nexport type MotorMappingFn = (intensity: number) => DualMotorParams;\n\n/**\n * Default motor mapping: light effects use weak motor, heavy use strong, medium uses both.\n */\nexport const defaultMotorMapping: MotorMappingFn = (intensity: number): DualMotorParams => {\n  return {\n    weakMagnitude: Math.min(intensity * 1.5, 1.0),\n    strongMagnitude: Math.max(intensity - 0.3, 0),\n  };\n};\n\n/**\n * Equal mapping: both motors at same intensity.\n */\nexport const equalMotorMapping: MotorMappingFn = (intensity: number): DualMotorParams => {\n  return {\n    weakMagnitude: intensity,\n    strongMagnitude: intensity,\n  };\n};\n\n/**\n * Heavy mapping: emphasizes the strong (low-frequency) motor.\n */\nexport const heavyMotorMapping: MotorMappingFn = (intensity: number): DualMotorParams => {\n  return {\n    weakMagnitude: intensity * 0.3,\n    strongMagnitude: intensity,\n  };\n};\n","import type { HapticAdapter, AdapterCapabilities, HapticStep } from '@hapticjs/core';\nimport { GamepadManager } from '../utils/gamepad-manager';\nimport { defaultMotorMapping } from '../utils/dual-motor';\nimport type { MotorMappingFn } from '../utils/dual-motor';\n\nexport interface GamepadAdapterOptions {\n  /** Which gamepad index to use (default: first connected) */\n  gamepadIndex?: number;\n  /** Custom motor mapping function */\n  motorMapping?: MotorMappingFn;\n  /** Auto-listen for gamepad connections (default: true) */\n  autoListen?: boolean;\n}\n\n/**\n * Gamepad haptics adapter using the GamepadHapticActuator API.\n * Supports dual-motor (weak/strong) vibration on modern controllers.\n */\nexport class GamepadHapticAdapter implements HapticAdapter {\n  readonly name = 'gamepad';\n  private manager: GamepadManager;\n  private motorMapping: MotorMappingFn;\n  private gamepadIndex?: number;\n  private _cancelled = false;\n\n  constructor(options: GamepadAdapterOptions = {}) {\n    this.manager = new GamepadManager();\n    this.motorMapping = options.motorMapping ?? defaultMotorMapping;\n    this.gamepadIndex = options.gamepadIndex;\n\n    if (options.autoListen !== false) {\n      this.manager.listen();\n    }\n  }\n\n  get supported(): boolean {\n    return this.manager.hasHapticGamepad();\n  }\n\n  capabilities(): AdapterCapabilities {\n    return {\n      maxIntensityLevels: 100,\n      minDuration: 1,\n      maxDuration: 5000,\n      supportsPattern: false,\n      supportsIntensity: true,\n      dualMotor: true,\n    };\n  }\n\n  async pulse(intensity: number, duration: number): Promise<void> {\n    const gamepad = this._getGamepad();\n    if (!gamepad?.vibrationActuator) return;\n\n    const { weakMagnitude, strongMagnitude } = this.motorMapping(intensity);\n\n    await gamepad.vibrationActuator.playEffect('dual-rumble', {\n      startDelay: 0,\n      duration,\n      weakMagnitude,\n      strongMagnitude,\n    });\n  }\n\n  async playSequence(steps: HapticStep[]): Promise<void> {\n    this._cancelled = false;\n\n    for (const step of steps) {\n      if (this._cancelled) break;\n\n      if (step.type === 'vibrate' && step.intensity > 0) {\n        await this.pulse(step.intensity, step.duration);\n        await this._delay(step.duration);\n      } else {\n        await this._delay(step.duration);\n      }\n    }\n  }\n\n  cancel(): void {\n    this._cancelled = true;\n    const gamepad = this._getGamepad();\n    if (gamepad?.vibrationActuator) {\n      gamepad.vibrationActuator.reset();\n    }\n  }\n\n  dispose(): void {\n    this.cancel();\n    this.manager.dispose();\n  }\n\n  /** Get the gamepad manager for advanced usage */\n  getManager(): GamepadManager {\n    return this.manager;\n  }\n\n  private _getGamepad(): Gamepad | null {\n    if (this.gamepadIndex !== undefined) {\n      const gamepads = this.manager.getGamepads();\n      return gamepads.find((gp) => gp.index === this.gamepadIndex) ?? null;\n    }\n    return this.manager.getFirstGamepad();\n  }\n\n  private _delay(ms: number): Promise<void> {\n    return new Promise((resolve) => setTimeout(resolve, ms));\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@hapticjs/gamepad",
+  "version": "0.1.0",
+  "description": "Gamepad haptics adapter for Feelback — dual motor support",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "peerDependencies": {
+    "@hapticjs/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@hapticjs/core": "0.1.0"
+  },
+  "keywords": [
+    "haptics",
+    "gamepad",
+    "controller",
+    "vibration",
+    "rumble",
+    "dual-motor"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}