three-gamepad-controls 0.11.0 → 0.12.1

package/README.md

@@ -2,42 +2,61 @@
 
 Gamepad support for [Three.js](https://threejs.org) controls, built on top of [Web Gamepad API](https://developer.mozilla.org/en-US/docs/Web/API/Gamepad_API).
 
+## Architecture
+
+<p align="center">
+  <img src="./assets/architecture-diagram.webp" width="800" alt="Architecture diagram" />
+</p>
+
 ## 📦 Installation
 
 npm:
 
 ```bash
-npm i three-gamepad-controls
+npm i three three-gamepad-controls
+npm i -D @types/three # optional: for TypeScript projects
 ```
 
 pnpm:
 
 ```bash
-pnpm add three-gamepad-controls
+pnpm add three three-gamepad-controls
+pnpm add -D @types/three # optional: for TypeScript projects
 ```
 
 Yarn:
 
 ```bash
-yarn add three-gamepad-controls
+yarn add three three-gamepad-controls
+yarn add -D @types/three # optional: for TypeScript projects
 ```
 
 Deno:
 
+When using `deno.json`, Deno stores dependencies in `imports` and does not separate `devDependencies`; `-D` only applies when writing to `package.json`.
+
+```bash
+# deno.json
+deno add three @types/three three-gamepad-controls
+```
+
 ```bash
-deno add npm:three-gamepad-controls
+# package.json
+deno add --package-json three three-gamepad-controls
+deno add --package-json -D @types/three # optional: for TypeScript projects
 ```
 
 Bun:
 
 ```bash
-bun add three-gamepad-controls
+bun add three three-gamepad-controls
+bun add -d @types/three # optional: for TypeScript projects
 ```
 
 ## 📖 Documentation
 
 - [Core](./docs/core.md) — The fundamental building blocks.
-- [GamepadInput](./docs/gamepad-input.md) - Gamepad input state reader for gameplay and menus.
+- [GamepadInput](./docs/gamepad-input.md) - Low-level reader for gamepad buttons, axes, sticks, and transitions.
 - [GamepadControls](./docs/gamepad-controls.md) — Abstract base class for custom gamepad controls.
 - [GamepadArcballControls](./docs/gamepad-arcball-controls.md) - Gamepad support for `ArcballControls`.
 - [GamepadDragControls](./docs/gamepad-drag-controls.md) - Gamepad support for `DragControls`.

package/dist/gamepad-arcball-controls.d.ts

@@ -99,9 +99,8 @@ declare class GamepadArcballControls extends GamepadControls {
    * z-rotation, and center focus.
    *
    * @param deltaTime - Seconds since the last frame.
-   * @param gamepad - Fresh gamepad snapshot provided by the base class.
    */
-  protected onUpdate(deltaTime: number, gamepad: Gamepad): void;
+  protected onUpdate(deltaTime: number): void;
 }
 //#endregion
 export { GamepadArcballControls, GamepadArcballControlsOptions };

package/dist/gamepad-arcball-controls.js

@@ -1,6 +1,5 @@
 import { GAMEPAD_AXIS, GAMEPAD_BUTTON } from "./core.js";
 import { GamepadControls } from "./gamepad-controls.js";
-import { applyGamepadDeadzone, getGamepadButtonPressed, getGamepadButtonValue } from "./utils.js";
 import { Vector2, Vector3 } from "three";
 //#region src/gamepad-arcball-controls.ts
 /**
@@ -40,7 +39,6 @@ var GamepadArcballControls = class extends GamepadControls {
 	#cameraForward;
 	#cameraRight;
 	#previousUp;
-	#focusButtonPressed = false;
 	#wasInteracting = false;
 	/**
 	* @param controls - A Three.js `ArcballControls` instance.
@@ -67,22 +65,22 @@ var GamepadArcballControls = class extends GamepadControls {
 	* z-rotation, and center focus.
 	*
 	* @param deltaTime - Seconds since the last frame.
-	* @param gamepad - Fresh gamepad snapshot provided by the base class.
 	*/
-	onUpdate(deltaTime, gamepad) {
+	onUpdate(deltaTime) {
 		const controls = this.#controls;
 		const { rotateSpeed, panSpeed, zoomSpeed, zRotateSpeed, deadzone, axisRotateX, axisRotateY, axisPanX, axisPanY, buttonZoomIn, buttonZoomOut, buttonZRotateLeft, buttonZRotateRight, buttonFocus } = this.#options;
-		const focusPoint = this.#consumeFocusPoint(gamepad, buttonFocus);
+		const input = this.gamepadInput;
+		const focusPoint = this.#consumeFocusPoint(buttonFocus);
 		if (!controls.enabled) {
 			this.#endInteraction();
 			return;
 		}
-		const rotateX = controls.enableRotate ? applyGamepadDeadzone(gamepad.axes[axisRotateX] ?? 0, deadzone) : 0;
-		const rotateY = controls.enableRotate ? applyGamepadDeadzone(gamepad.axes[axisRotateY] ?? 0, deadzone) : 0;
-		const panX = controls.enablePan ? applyGamepadDeadzone(gamepad.axes[axisPanX] ?? 0, deadzone) : 0;
-		const panY = controls.enablePan ? applyGamepadDeadzone(gamepad.axes[axisPanY] ?? 0, deadzone) : 0;
-		const zoom = controls.enableZoom ? getGamepadButtonValue(gamepad, buttonZoomIn) - getGamepadButtonValue(gamepad, buttonZoomOut) : 0;
-		const zRotation = controls.enableRotate ? getGamepadButtonValue(gamepad, buttonZRotateLeft) - getGamepadButtonValue(gamepad, buttonZRotateRight) : 0;
+		const rotateX = controls.enableRotate ? input.axis(axisRotateX, { deadzone }) : 0;
+		const rotateY = controls.enableRotate ? input.axis(axisRotateY, { deadzone }) : 0;
+		const panX = controls.enablePan ? input.axis(axisPanX, { deadzone }) : 0;
+		const panY = controls.enablePan ? input.axis(axisPanY, { deadzone }) : 0;
+		const zoom = controls.enableZoom ? input.buttonValue(buttonZoomIn) - input.buttonValue(buttonZoomOut) : 0;
+		const zRotation = controls.enableRotate ? input.buttonValue(buttonZRotateLeft) - input.buttonValue(buttonZRotateRight) : 0;
 		const activeInput = rotateX !== 0 || rotateY !== 0 || panX !== 0 || panY !== 0 || Math.abs(zoom) > deadzone || Math.abs(zRotation) > deadzone;
 		if (!activeInput && focusPoint === null) {
 			this.#endInteraction();
@@ -228,16 +226,12 @@ var GamepadArcballControls = class extends GamepadControls {
 	/**
 	* Consumes a focus-button press and resolves the viewport center hit point.
 	*
-	* @param gamepad - Fresh gamepad snapshot to read from.
 	* @param buttonFocus - Button index configured for focus.
 	* @returns The center hit point, or `null` when focus should not run.
 	*/
-	#consumeFocusPoint(gamepad, buttonFocus) {
+	#consumeFocusPoint(buttonFocus) {
 		const controls = this.#controls;
-		const focusPressed = getGamepadButtonPressed(gamepad, buttonFocus);
-		const shouldFocus = focusPressed && !this.#focusButtonPressed;
-		this.#focusButtonPressed = focusPressed;
-		if (!shouldFocus || !controls.enabled || !controls.enablePan || !controls.enableFocus || controls.scene === null) return null;
+		if (!this.gamepadInput.wasPressed(buttonFocus) || !controls.enabled || !controls.enablePan || !controls.enableFocus || controls.scene === null) return null;
 		return controls.unprojectOnObj(this.#centerNdc, controls.object);
 	}
 	/**

package/dist/gamepad-controls.d.ts

@@ -1,3 +1,4 @@
+import { GamepadInput } from "./gamepad-input.js";
 import { EventDispatcher } from "three";
 
 //#region src/gamepad-controls.d.ts
@@ -30,8 +31,8 @@ type GamepadControlsEventMap = {
 /**
  * Abstract base class for Three.js gamepad controls.
  *
- * Handles the gamepad connection lifecycle and input polling so subclasses
- * only need to implement {@link onUpdate}.
+ * Delegates gamepad connection lifecycle and input polling to {@link GamepadInput}
+ * so subclasses can focus on mapping input to the wrapped Three.js control.
  */
 declare abstract class GamepadControls extends EventDispatcher<GamepadControlsEventMap> {
   #private;
@@ -45,9 +46,15 @@ declare abstract class GamepadControls extends EventDispatcher<GamepadControlsEv
    */
   gamepad: Gamepad | null;
   /**
-   * Creates the base gamepad lifecycle manager and attaches browser listeners.
+   * Creates the base input reader and attaches lifecycle listeners.
    */
   constructor();
+  /**
+   * Low-level gamepad input reader used by subclasses.
+   *
+   * @returns The shared input reader for the active gamepad.
+   */
+  protected get gamepadInput(): GamepadInput;
   /**
    * Advances the controller by one frame. Call this inside your render loop.
    *
@@ -62,25 +69,22 @@ declare abstract class GamepadControls extends EventDispatcher<GamepadControlsEv
    * Called every frame when a gamepad is available and `enabled` is `true`.
    *
    * @param deltaTime - Seconds since the last frame.
-   * @param gamepad - A fresh snapshot of the currently active gamepad.
    */
-  protected abstract onUpdate(deltaTime: number, gamepad: Gamepad): void;
+  protected abstract onUpdate(deltaTime: number): void;
   /**
-   * Called when any gamepad fires a `gamepadconnected` event.
+   * Called when a gamepad becomes active through the shared input reader.
    *
-   * The default accepts the first gamepad that connects and dispatches `connected`.
-   * Override to customize selection behavior.
+   * The default dispatches a `connected` event.
    *
-   * @param gamepad - The gamepad that just connected.
+   * @param gamepad - The gamepad that became active.
    */
   protected onGamepadConnected(gamepad: Gamepad): void;
   /**
-   * Called when any gamepad fires a `gamepaddisconnected` event.
+   * Called when the active gamepad disconnects through the shared input reader.
    *
-   * The default clears `this.gamepad` and dispatches `disconnected` if the
-   * disconnecting gamepad was the active one. Override to add custom cleanup.
+   * The default dispatches a `disconnected` event.
    *
-   * @param gamepad - The gamepad that just disconnected.
+   * @param gamepad - The gamepad that was active before disconnection.
    */
   protected onGamepadDisconnected(gamepad: Gamepad): void;
 }

package/dist/gamepad-controls.js

@@ -1,11 +1,11 @@
-import { GamepadManager } from "./gamepad-manager.js";
+import { GamepadInput } from "./gamepad-input.js";
 import { EventDispatcher } from "three";
 //#region src/gamepad-controls.ts
 /**
 * Abstract base class for Three.js gamepad controls.
 *
-* Handles the gamepad connection lifecycle and input polling so subclasses
-* only need to implement {@link onUpdate}.
+* Delegates gamepad connection lifecycle and input polling to {@link GamepadInput}
+* so subclasses can focus on mapping input to the wrapped Three.js control.
 */
 var GamepadControls = class extends EventDispatcher {
 	/**
@@ -17,40 +17,50 @@ var GamepadControls = class extends EventDispatcher {
 	* The currently active gamepad, or `null` if no gamepad is connected.
 	*/
 	gamepad = null;
-	#manager;
+	#gamepadInput;
 	/**
-	* Bound browser connection listener kept so it can be removed in {@link dispose}.
+	* Bound input connection listener kept so it can be removed in {@link dispose}.
 	*/
 	#onGamepadConnected;
 	/**
-	* Bound browser disconnection listener kept so it can be removed in {@link dispose}.
+	* Bound input disconnection listener kept so it can be removed in {@link dispose}.
 	*/
 	#onGamepadDisconnected;
 	/**
-	* Creates the base gamepad lifecycle manager and attaches browser listeners.
+	* Creates the base input reader and attaches lifecycle listeners.
 	*/
 	constructor() {
 		super();
-		this.#manager = new GamepadManager();
-		this.#onGamepadConnected = this.#handleGamepadConnectedEvent.bind(this);
-		this.#onGamepadDisconnected = this.#handleGamepadDisconnectedEvent.bind(this);
-		window.addEventListener("gamepadconnected", this.#onGamepadConnected);
-		window.addEventListener("gamepaddisconnected", this.#onGamepadDisconnected);
+		this.#gamepadInput = new GamepadInput();
+		this.#onGamepadConnected = this.#handleGamepadConnected.bind(this);
+		this.#onGamepadDisconnected = this.#handleGamepadDisconnected.bind(this);
+		this.#gamepadInput.addEventListener("connected", this.#onGamepadConnected);
+		this.#gamepadInput.addEventListener("disconnected", this.#onGamepadDisconnected);
 	}
 	/**
-	* Forwards a browser connection event to the overridable lifecycle hook.
+	* Low-level gamepad input reader used by subclasses.
 	*
-	* @param event - Browser event containing the connected gamepad snapshot.
+	* @returns The shared input reader for the active gamepad.
 	*/
-	#handleGamepadConnectedEvent(event) {
+	get gamepadInput() {
+		return this.#gamepadInput;
+	}
+	/**
+	* Forwards an input connection event to the overridable lifecycle hook.
+	*
+	* @param event - Input event containing the connected gamepad snapshot.
+	*/
+	#handleGamepadConnected(event) {
+		this.gamepad = this.#gamepadInput.gamepad;
 		this.onGamepadConnected(event.gamepad);
 	}
 	/**
-	* Forwards a browser disconnection event to the overridable lifecycle hook.
+	* Forwards an input disconnection event to the overridable lifecycle hook.
 	*
-	* @param event - Browser event containing the disconnected gamepad snapshot.
+	* @param event - Input event containing the disconnected gamepad snapshot.
 	*/
-	#handleGamepadDisconnectedEvent(event) {
+	#handleGamepadDisconnected(event) {
+		this.gamepad = this.#gamepadInput.gamepad;
 		this.onGamepadDisconnected(event.gamepad);
 	}
 	/**
@@ -60,69 +70,45 @@ var GamepadControls = class extends EventDispatcher {
 	*/
 	update(deltaTime) {
 		if (!this.enabled) return;
-		this.#manager.activeGamepad = this.gamepad;
-		const { gamepad, connected, disconnected } = this.#manager.update();
-		if (connected !== null) {
-			this.#manager.activeGamepad = this.gamepad;
-			this.onGamepadConnected(connected);
-			this.#manager.activeGamepad = this.gamepad;
-		} else if (disconnected !== null) {
-			this.#manager.activeGamepad = this.gamepad;
-			this.onGamepadDisconnected(disconnected);
-			this.#manager.activeGamepad = this.gamepad;
-			return;
-		} else {
-			this.gamepad = gamepad;
-			this.#manager.activeGamepad = this.gamepad;
-		}
+		this.#gamepadInput.update();
+		this.gamepad = this.#gamepadInput.gamepad;
 		if (this.gamepad === null) return;
-		this.onUpdate(deltaTime, this.gamepad);
+		this.onUpdate(deltaTime);
 	}
 	/**
 	* Removes all event listeners attached by this controller. Call when no longer needed.
 	*/
 	dispose() {
-		window.removeEventListener("gamepadconnected", this.#onGamepadConnected);
-		window.removeEventListener("gamepaddisconnected", this.#onGamepadDisconnected);
+		this.#gamepadInput.removeEventListener("connected", this.#onGamepadConnected);
+		this.#gamepadInput.removeEventListener("disconnected", this.#onGamepadDisconnected);
+		this.#gamepadInput.dispose();
 		this.gamepad = null;
-		this.#manager.activeGamepad = null;
 		this.enabled = false;
 	}
 	/**
-	* Called when any gamepad fires a `gamepadconnected` event.
+	* Called when a gamepad becomes active through the shared input reader.
 	*
-	* The default accepts the first gamepad that connects and dispatches `connected`.
-	* Override to customize selection behavior.
+	* The default dispatches a `connected` event.
 	*
-	* @param gamepad - The gamepad that just connected.
+	* @param gamepad - The gamepad that became active.
 	*/
 	onGamepadConnected(gamepad) {
-		this.#manager.activeGamepad = this.gamepad;
-		if (!this.#manager.connect(gamepad)) return;
-		const connectedGamepad = this.#manager.activeGamepad;
-		if (connectedGamepad === null) return;
-		this.gamepad = connectedGamepad;
 		this.dispatchEvent({
 			type: "connected",
-			gamepad: connectedGamepad
+			gamepad
 		});
 	}
 	/**
-	* Called when any gamepad fires a `gamepaddisconnected` event.
+	* Called when the active gamepad disconnects through the shared input reader.
 	*
-	* The default clears `this.gamepad` and dispatches `disconnected` if the
-	* disconnecting gamepad was the active one. Override to add custom cleanup.
+	* The default dispatches a `disconnected` event.
 	*
-	* @param gamepad - The gamepad that just disconnected.
+	* @param gamepad - The gamepad that was active before disconnection.
 	*/
 	onGamepadDisconnected(gamepad) {
-		this.#manager.activeGamepad = this.gamepad;
-		const disconnectedGamepad = this.#manager.disconnect(gamepad);
-		if (disconnectedGamepad === null) return;
-		this.gamepad = this.#manager.activeGamepad;
 		this.dispatchEvent({
 			type: "disconnected",
-			gamepad: disconnectedGamepad
+			gamepad
 		});
 	}
 };

package/dist/gamepad-drag-controls.d.ts

@@ -68,9 +68,8 @@ declare class GamepadDragControls extends GamepadControls {
    * and rotate behavior.
    *
    * @param deltaTime - Seconds since the last frame.
-   * @param gamepad - Fresh gamepad snapshot provided by the base class.
    */
-  protected onUpdate(deltaTime: number, gamepad: Gamepad): void;
+  protected onUpdate(deltaTime: number): void;
   /**
    * Releases any selected object and removes hover state before disposing the
    * gamepad lifecycle listeners.

package/dist/gamepad-drag-controls.js

@@ -1,6 +1,5 @@
 import { GAMEPAD_AXIS, GAMEPAD_BUTTON } from "./core.js";
 import { GamepadControls } from "./gamepad-controls.js";
-import { applyGamepadDeadzone, getGamepadButtonPressed } from "./utils.js";
 import { Matrix4, Vector2, Vector3 } from "three";
 //#region src/gamepad-drag-controls.ts
 /**
@@ -38,7 +37,6 @@ var GamepadDragControls = class extends GamepadControls {
 	#viewSize;
 	#hovered = null;
 	#selected = null;
-	#selectButtonPressed = false;
 	/**
 	* @param controls - A Three.js `DragControls` instance.
 	* @param options - Optional overrides for the default behavior.
@@ -68,13 +66,10 @@ var GamepadDragControls = class extends GamepadControls {
 	* and rotate behavior.
 	*
 	* @param deltaTime - Seconds since the last frame.
-	* @param gamepad - Fresh gamepad snapshot provided by the base class.
 	*/
-	onUpdate(deltaTime, gamepad) {
+	onUpdate(deltaTime) {
 		const controls = this.#controls;
-		const selectPressed = getGamepadButtonPressed(gamepad, this.#options.buttonSelect);
-		const selectStarted = selectPressed && !this.#selectButtonPressed;
-		this.#selectButtonPressed = selectPressed;
+		const selectStarted = this.gamepadInput.wasPressed(this.#options.buttonSelect);
 		if (!controls.enabled) {
 			this.#releaseSelected();
 			this.#clearHover();
@@ -85,7 +80,7 @@ var GamepadDragControls = class extends GamepadControls {
 				this.#releaseSelected();
 				return;
 			}
-			this.#updateSelected(deltaTime, gamepad);
+			this.#updateSelected(deltaTime);
 			return;
 		}
 		const hit = this.#intersectCenter();
@@ -115,16 +110,16 @@ var GamepadDragControls = class extends GamepadControls {
 	* Updates the selected object from gamepad drag and rotation input.
 	*
 	* @param deltaTime - Seconds since the last frame.
-	* @param gamepad - Fresh gamepad snapshot to read from.
 	*/
-	#updateSelected(deltaTime, gamepad) {
+	#updateSelected(deltaTime) {
 		const selected = this.#selected;
 		if (selected === null) return;
 		const { dragSpeed, rotateSpeed, deadzone, axisDragX, axisDragY, axisRotateX, axisRotateY } = this.#options;
-		const dragX = applyGamepadDeadzone(gamepad.axes[axisDragX] ?? 0, deadzone);
-		const dragY = applyGamepadDeadzone(gamepad.axes[axisDragY] ?? 0, deadzone);
-		const rotateX = applyGamepadDeadzone(gamepad.axes[axisRotateX] ?? 0, deadzone);
-		const rotateY = applyGamepadDeadzone(gamepad.axes[axisRotateY] ?? 0, deadzone);
+		const input = this.gamepadInput;
+		const dragX = input.axis(axisDragX, { deadzone });
+		const dragY = input.axis(axisDragY, { deadzone });
+		const rotateX = input.axis(axisRotateX, { deadzone });
+		const rotateY = input.axis(axisRotateY, { deadzone });
 		const dragged = this.#applyDrag(deltaTime, dragX, dragY, dragSpeed);
 		const rotated = this.#applyRotation(deltaTime, rotateX, rotateY, rotateSpeed);
 		if (dragged || rotated) this.#controls.dispatchEvent({

package/dist/gamepad-first-person-controls.d.ts

@@ -73,9 +73,8 @@ declare class GamepadFirstPersonControls extends GamepadControls {
    * Maps the current gamepad state to `FirstPersonControls` translation and look.
    *
    * @param deltaTime - Seconds since the last frame.
-   * @param gamepad - Fresh gamepad snapshot provided by the base class.
    */
-  protected onUpdate(deltaTime: number, gamepad: Gamepad): void;
+  protected onUpdate(deltaTime: number): void;
 }
 //#endregion
 export { GamepadFirstPersonControls, GamepadFirstPersonControlsOptions };

package/dist/gamepad-first-person-controls.js

@@ -1,6 +1,5 @@
 import { GAMEPAD_AXIS, GAMEPAD_BUTTON } from "./core.js";
 import { GamepadControls } from "./gamepad-controls.js";
-import { applyGamepadDeadzone, getGamepadButtonValue } from "./utils.js";
 import { MathUtils, Spherical, Vector3 } from "three";
 //#region src/gamepad-first-person-controls.ts
 /**
@@ -51,18 +50,16 @@ var GamepadFirstPersonControls = class extends GamepadControls {
 	* Maps the current gamepad state to `FirstPersonControls` translation and look.
 	*
 	* @param deltaTime - Seconds since the last frame.
-	* @param gamepad - Fresh gamepad snapshot provided by the base class.
 	*/
-	onUpdate(deltaTime, gamepad) {
+	onUpdate(deltaTime) {
 		const { moveSpeed, lookSpeed, deadzone, axisMoveForward, axisMoveRight, axisLookX, axisLookY, buttonMoveUp, buttonMoveDown } = this.#options;
-		this.#applyMovement(deltaTime, gamepad, moveSpeed, deadzone, axisMoveForward, axisMoveRight, buttonMoveUp, buttonMoveDown);
-		this.#applyLook(deltaTime, gamepad, lookSpeed, deadzone, axisLookX, axisLookY);
+		this.#applyMovement(deltaTime, moveSpeed, deadzone, axisMoveForward, axisMoveRight, buttonMoveUp, buttonMoveDown);
+		this.#applyLook(deltaTime, lookSpeed, deadzone, axisLookX, axisLookY);
 	}
 	/**
 	* Applies local translation input to FirstPersonControls' object.
 	*
 	* @param deltaTime - Seconds since the last frame.
-	* @param gamepad - Fresh gamepad snapshot to read from.
 	* @param moveSpeed - User-configured movement speed multiplier.
 	* @param deadzone - Axis and trigger dead zone threshold.
 	* @param axisMoveForward - Axis index for forward and backward movement.
@@ -70,10 +67,11 @@ var GamepadFirstPersonControls = class extends GamepadControls {
 	* @param buttonMoveUp - Button index for upward movement.
 	* @param buttonMoveDown - Button index for downward movement.
 	*/
-	#applyMovement(deltaTime, gamepad, moveSpeed, deadzone, axisMoveForward, axisMoveRight, buttonMoveUp, buttonMoveDown) {
+	#applyMovement(deltaTime, moveSpeed, deadzone, axisMoveForward, axisMoveRight, buttonMoveUp, buttonMoveDown) {
 		const controls = this.#controls;
+		const input = this.gamepadInput;
 		const moveMult = deltaTime * controls.movementSpeed * moveSpeed;
-		const forward = applyGamepadDeadzone(gamepad.axes[axisMoveForward] ?? 0, deadzone);
+		const forward = input.axis(axisMoveForward, { deadzone });
 		if (forward !== 0) {
 			let distance = forward * moveMult;
 			if (forward < 0 && controls.heightSpeed) {
@@ -82,10 +80,10 @@ var GamepadFirstPersonControls = class extends GamepadControls {
 			}
 			controls.object.translateZ(distance);
 		}
-		const strafe = applyGamepadDeadzone(gamepad.axes[axisMoveRight] ?? 0, deadzone);
+		const strafe = input.axis(axisMoveRight, { deadzone });
 		if (strafe !== 0) controls.object.translateX(strafe * moveMult);
-		const up = getGamepadButtonValue(gamepad, buttonMoveUp);
-		const down = getGamepadButtonValue(gamepad, buttonMoveDown);
+		const up = input.buttonValue(buttonMoveUp);
+		const down = input.buttonValue(buttonMoveDown);
 		if (up > deadzone) controls.object.translateY(up * moveMult);
 		if (down > deadzone) controls.object.translateY(-down * moveMult);
 	}
@@ -93,15 +91,15 @@ var GamepadFirstPersonControls = class extends GamepadControls {
 	* Applies camera look input while keeping FirstPersonControls state in sync.
 	*
 	* @param deltaTime - Seconds since the last frame.
-	* @param gamepad - Fresh gamepad snapshot to read from.
 	* @param lookSpeed - User-configured look speed multiplier.
 	* @param deadzone - Axis dead zone threshold.
 	* @param axisLookX - Axis index for yaw input.
 	* @param axisLookY - Axis index for pitch input.
 	*/
-	#applyLook(deltaTime, gamepad, lookSpeed, deadzone, axisLookX, axisLookY) {
-		const lookX = applyGamepadDeadzone(gamepad.axes[axisLookX] ?? 0, deadzone);
-		const lookY = applyGamepadDeadzone(gamepad.axes[axisLookY] ?? 0, deadzone);
+	#applyLook(deltaTime, lookSpeed, deadzone, axisLookX, axisLookY) {
+		const input = this.gamepadInput;
+		const lookX = input.axis(axisLookX, { deadzone });
+		const lookY = input.axis(axisLookY, { deadzone });
 		if (lookX === 0 && lookY === 0) return;
 		const controls = this.#controls;
 		const actualLookSpeed = controls.lookSpeed * lookSpeed * deltaTime * LOOK_SPEED_SCALE;

package/dist/gamepad-fly-controls.d.ts

@@ -83,9 +83,8 @@ declare class GamepadFlyControls extends GamepadControls {
    * Maps the current gamepad state to `FlyControls` translation and rotation.
    *
    * @param deltaTime - Seconds since the last frame.
-   * @param gamepad - Fresh gamepad snapshot provided by the base class.
    */
-  protected onUpdate(deltaTime: number, gamepad: Gamepad): void;
+  protected onUpdate(deltaTime: number): void;
 }
 //#endregion
 export { GamepadFlyControls, GamepadFlyControlsOptions };

package/dist/gamepad-fly-controls.js

@@ -1,6 +1,5 @@
 import { GAMEPAD_AXIS, GAMEPAD_BUTTON } from "./core.js";
 import { GamepadControls } from "./gamepad-controls.js";
-import { applyGamepadDeadzone, getGamepadButtonPressed, getGamepadButtonValue } from "./utils.js";
 import { Quaternion } from "three";
 //#region src/gamepad-fly-controls.ts
 /**
@@ -48,23 +47,23 @@ var GamepadFlyControls = class extends GamepadControls {
 	* Maps the current gamepad state to `FlyControls` translation and rotation.
 	*
 	* @param deltaTime - Seconds since the last frame.
-	* @param gamepad - Fresh gamepad snapshot provided by the base class.
 	*/
-	onUpdate(deltaTime, gamepad) {
+	onUpdate(deltaTime) {
 		const { moveSpeed, rotateSpeed, deadzone, axisMoveForward, axisMoveRight, axisLookX, axisLookY, buttonRollLeft, buttonRollRight, buttonMoveUp, buttonMoveDown } = this.#options;
+		const input = this.gamepadInput;
 		const moveMult = deltaTime * this.#controls.movementSpeed * moveSpeed;
-		const fwd = applyGamepadDeadzone(gamepad.axes[axisMoveForward] ?? 0, deadzone);
+		const fwd = input.axis(axisMoveForward, { deadzone });
 		if (fwd !== 0) this.#controls.object.translateZ(fwd * moveMult);
-		const strafe = applyGamepadDeadzone(gamepad.axes[axisMoveRight] ?? 0, deadzone);
+		const strafe = input.axis(axisMoveRight, { deadzone });
 		if (strafe !== 0) this.#controls.object.translateX(strafe * moveMult);
-		const up = getGamepadButtonValue(gamepad, buttonMoveUp);
-		const down = getGamepadButtonValue(gamepad, buttonMoveDown);
+		const up = input.buttonValue(buttonMoveUp);
+		const down = input.buttonValue(buttonMoveDown);
 		if (up > deadzone) this.#controls.object.translateY(up * moveMult);
 		if (down > deadzone) this.#controls.object.translateY(-down * moveMult);
 		const rotMult = deltaTime * this.#controls.rollSpeed * rotateSpeed;
-		const pitch = -applyGamepadDeadzone(gamepad.axes[axisLookY] ?? 0, deadzone);
-		const yaw = -applyGamepadDeadzone(gamepad.axes[axisLookX] ?? 0, deadzone);
-		const roll = (getGamepadButtonPressed(gamepad, buttonRollLeft) ? 1 : 0) - (getGamepadButtonPressed(gamepad, buttonRollRight) ? 1 : 0);
+		const pitch = -input.axis(axisLookY, { deadzone });
+		const yaw = -input.axis(axisLookX, { deadzone });
+		const roll = (input.isPressed(buttonRollLeft) ? 1 : 0) - (input.isPressed(buttonRollRight) ? 1 : 0);
 		if (pitch !== 0 || yaw !== 0 || roll !== 0) {
 			this.#tmpQuaternion.set(pitch * rotMult, yaw * rotMult, roll * rotMult, 1).normalize();
 			this.#controls.object.quaternion.multiply(this.#tmpQuaternion);

package/dist/gamepad-input.js

@@ -1,9 +1,49 @@
 import { GamepadManager } from "./gamepad-manager.js";
-import { applyGamepadDeadzone, getGamepadButtonPressed, getGamepadButtonValue } from "./utils.js";
 import { EventDispatcher } from "three";
 //#region src/gamepad-input.ts
 const DEFAULT_GAMEPAD_INPUT_OPTIONS = { deadzone: .1 };
 /**
+* Returns `value` unchanged, or `0` if below the dead zone `threshold`.
+*
+* Kept private to this module because `GamepadInput` is the only public API
+* that currently exposes processed axis values.
+*
+* @param value - Raw axis or trigger value, typically in `[-1, 1]`.
+* @param threshold - Dead zone size; values below this magnitude are zeroed.
+* @returns The original value when outside the dead zone, otherwise `0`.
+*/
+const applyGamepadDeadzone = (value, threshold) => {
+	return Math.abs(value) < threshold ? 0 : value;
+};
+/**
+* Returns whether a gamepad button is currently pressed.
+*
+* Missing buttons are treated as not pressed.
+*
+* @param gamepad - Gamepad snapshot to read from.
+* @param button - Button index to inspect.
+* @returns `true` when the button exists and is pressed, otherwise `false`.
+*/
+const getGamepadButtonPressed = (gamepad, button) => {
+	return gamepad.buttons[button]?.pressed ?? false;
+};
+/**
+* Returns the analog value for a gamepad button.
+*
+* Some digital buttons may report `pressed` without a meaningful non-zero
+* `value`, so pressed buttons fall back to `1`.
+*
+* @param gamepad - Gamepad snapshot to read from.
+* @param button - Button index to inspect.
+* @returns The button value, `1` for pressed digital buttons, or `0` when unavailable.
+*/
+const getGamepadButtonValue = (gamepad, button) => {
+	const gamepadButton = gamepad.buttons[button];
+	if (gamepadButton === void 0) return 0;
+	if (gamepadButton.value !== 0) return gamepadButton.value;
+	return gamepadButton.pressed ? 1 : 0;
+};
+/**
 * Gamepad input state reader for gameplay, menus, and custom actions.
 *
 * Call {@link update} once per frame before reading button transitions or axes.

package/dist/gamepad-orbit-controls.d.ts

@@ -77,9 +77,8 @@ declare class GamepadOrbitControls extends GamepadControls {
    * Maps the current gamepad state to `OrbitControls` rotation, pan, and dolly.
    *
    * @param deltaTime - Seconds since the last frame.
-   * @param gamepad - Fresh gamepad snapshot provided by the base class.
    */
-  protected onUpdate(deltaTime: number, gamepad: Gamepad): void;
+  protected onUpdate(deltaTime: number): void;
 }
 //#endregion
 export { GamepadOrbitControls, GamepadOrbitControlsOptions };

package/dist/gamepad-orbit-controls.js

@@ -1,6 +1,5 @@
 import { GAMEPAD_AXIS, GAMEPAD_BUTTON } from "./core.js";
 import { GamepadControls } from "./gamepad-controls.js";
-import { applyGamepadDeadzone, getGamepadButtonValue } from "./utils.js";
 //#region src/gamepad-orbit-controls.ts
 /**
 * Default options merged in the constructor when no explicit configuration is provided.
@@ -43,19 +42,19 @@ var GamepadOrbitControls = class extends GamepadControls {
 	* Maps the current gamepad state to `OrbitControls` rotation, pan, and dolly.
 	*
 	* @param deltaTime - Seconds since the last frame.
-	* @param gamepad - Fresh gamepad snapshot provided by the base class.
 	*/
-	onUpdate(deltaTime, gamepad) {
+	onUpdate(deltaTime) {
 		const { rotateSpeed, panSpeed, zoomSpeed, deadzone, axisRotateX, axisRotateY, axisPanX, axisPanY, buttonDollyIn, buttonDollyOut } = this.#options;
-		const rotX = applyGamepadDeadzone(gamepad.axes[axisRotateX] ?? 0, deadzone);
-		const rotY = applyGamepadDeadzone(gamepad.axes[axisRotateY] ?? 0, deadzone);
+		const input = this.gamepadInput;
+		const rotX = input.axis(axisRotateX, { deadzone });
+		const rotY = input.axis(axisRotateY, { deadzone });
 		if (rotX !== 0) this.#controls.rotateLeft(rotX * rotateSpeed * deltaTime * Math.PI);
 		if (rotY !== 0) this.#controls.rotateUp(rotY * rotateSpeed * deltaTime * Math.PI);
-		const panX = applyGamepadDeadzone(gamepad.axes[axisPanX] ?? 0, deadzone);
-		const panY = applyGamepadDeadzone(gamepad.axes[axisPanY] ?? 0, deadzone);
+		const panX = input.axis(axisPanX, { deadzone });
+		const panY = input.axis(axisPanY, { deadzone });
 		if (panX !== 0 || panY !== 0) this.#controls.pan(panX * panSpeed * deltaTime * 500, panY * panSpeed * deltaTime * 500);
-		const triggerIn = getGamepadButtonValue(gamepad, buttonDollyIn);
-		const triggerOut = getGamepadButtonValue(gamepad, buttonDollyOut);
+		const triggerIn = input.buttonValue(buttonDollyIn);
+		const triggerOut = input.buttonValue(buttonDollyOut);
 		if (triggerIn > deadzone) this.#controls.dollyIn(1 / (1 + zoomSpeed * triggerIn * deltaTime));
 		if (triggerOut > deadzone) this.#controls.dollyOut(1 / (1 + zoomSpeed * triggerOut * deltaTime));
 	}

package/dist/gamepad-pointer-lock-controls.d.ts

@@ -63,9 +63,8 @@ declare class GamepadPointerLockControls extends GamepadControls {
    * Maps the current gamepad state to `PointerLockControls` movement and look.
    *
    * @param deltaTime - Seconds since the last frame.
-   * @param gamepad - Fresh gamepad snapshot provided by the base class.
    */
-  protected onUpdate(deltaTime: number, gamepad: Gamepad): void;
+  protected onUpdate(deltaTime: number): void;
 }
 //#endregion
 export { GamepadPointerLockControls, GamepadPointerLockControlsOptions };

package/dist/gamepad-pointer-lock-controls.js

@@ -1,6 +1,5 @@
 import { GAMEPAD_AXIS } from "./core.js";
 import { GamepadControls } from "./gamepad-controls.js";
-import { applyGamepadDeadzone } from "./utils.js";
 import { Euler } from "three";
 //#region src/gamepad-pointer-lock-controls.ts
 /**
@@ -44,16 +43,16 @@ var GamepadPointerLockControls = class extends GamepadControls {
 	* Maps the current gamepad state to `PointerLockControls` movement and look.
 	*
 	* @param deltaTime - Seconds since the last frame.
-	* @param gamepad - Fresh gamepad snapshot provided by the base class.
 	*/
-	onUpdate(deltaTime, gamepad) {
+	onUpdate(deltaTime) {
 		const { moveSpeed, lookSpeed, deadzone, axisMoveForward, axisMoveRight, axisLookX, axisLookY } = this.#options;
-		const fwd = applyGamepadDeadzone(gamepad.axes[axisMoveForward] ?? 0, deadzone);
-		const strafe = applyGamepadDeadzone(gamepad.axes[axisMoveRight] ?? 0, deadzone);
+		const input = this.gamepadInput;
+		const fwd = input.axis(axisMoveForward, { deadzone });
+		const strafe = input.axis(axisMoveRight, { deadzone });
 		if (fwd !== 0) this.#controls.moveForward(-fwd * moveSpeed * deltaTime);
 		if (strafe !== 0) this.#controls.moveRight(strafe * moveSpeed * deltaTime);
-		const lookX = applyGamepadDeadzone(gamepad.axes[axisLookX] ?? 0, deadzone);
-		const lookY = applyGamepadDeadzone(gamepad.axes[axisLookY] ?? 0, deadzone);
+		const lookX = input.axis(axisLookX, { deadzone });
+		const lookY = input.axis(axisLookY, { deadzone });
 		if (lookX !== 0 || lookY !== 0) {
 			const camera = this.#controls.object;
 			const scale = lookSpeed * this.#controls.pointerSpeed * deltaTime * Math.PI;

package/dist/gamepad-trackball-controls.d.ts

@@ -77,9 +77,8 @@ declare class GamepadTrackballControls extends GamepadControls {
    * Maps the current gamepad state to `TrackballControls` rotation, pan, and zoom.
    *
    * @param deltaTime - Seconds since the last frame.
-   * @param gamepad - Fresh gamepad snapshot provided by the base class.
    */
-  protected onUpdate(deltaTime: number, gamepad: Gamepad): void;
+  protected onUpdate(deltaTime: number): void;
 }
 //#endregion
 export { GamepadTrackballControls, GamepadTrackballControlsOptions };

package/dist/gamepad-trackball-controls.js

@@ -1,6 +1,5 @@
 import { GAMEPAD_AXIS, GAMEPAD_BUTTON } from "./core.js";
 import { GamepadControls } from "./gamepad-controls.js";
-import { applyGamepadDeadzone, getGamepadButtonValue } from "./utils.js";
 //#region src/gamepad-trackball-controls.ts
 /**
 * Default options merged in the constructor when no explicit configuration is provided.
@@ -43,33 +42,32 @@ var GamepadTrackballControls = class extends GamepadControls {
 	* Maps the current gamepad state to `TrackballControls` rotation, pan, and zoom.
 	*
 	* @param deltaTime - Seconds since the last frame.
-	* @param gamepad - Fresh gamepad snapshot provided by the base class.
 	*/
-	onUpdate(deltaTime, gamepad) {
+	onUpdate(deltaTime) {
 		const { rotateSpeed, panSpeed, zoomSpeed, deadzone, axisRotateX, axisRotateY, axisPanX, axisPanY, buttonZoomIn, buttonZoomOut } = this.#options;
-		this.#queueRotation(deltaTime, gamepad, rotateSpeed, deadzone, axisRotateX, axisRotateY);
-		this.#queuePan(deltaTime, gamepad, panSpeed, deadzone, axisPanX, axisPanY);
-		this.#queueZoom(deltaTime, gamepad, zoomSpeed, deadzone, buttonZoomIn, buttonZoomOut);
+		this.#queueRotation(deltaTime, rotateSpeed, deadzone, axisRotateX, axisRotateY);
+		this.#queuePan(deltaTime, panSpeed, deadzone, axisPanX, axisPanY);
+		this.#queueZoom(deltaTime, zoomSpeed, deadzone, buttonZoomIn, buttonZoomOut);
 	}
 	/**
 	* Queues rotation input into TrackballControls' normalized move state.
 	*
 	* @param deltaTime - Seconds since the last frame.
-	* @param gamepad - Fresh gamepad snapshot to read from.
 	* @param rotateSpeed - User-configured rotation speed multiplier.
 	* @param deadzone - Axis dead zone threshold.
 	* @param axisRotateX - Axis index for horizontal rotation.
 	* @param axisRotateY - Axis index for vertical rotation.
 	*/
-	#queueRotation(deltaTime, gamepad, rotateSpeed, deadzone, axisRotateX, axisRotateY) {
+	#queueRotation(deltaTime, rotateSpeed, deadzone, axisRotateX, axisRotateY) {
 		const controls = this.#controls;
 		if (controls.noRotate) {
 			controls._movePrev.copy(controls._moveCurr);
 			controls._lastAngle = 0;
 			return;
 		}
-		const rotX = applyGamepadDeadzone(gamepad.axes[axisRotateX] ?? 0, deadzone);
-		const rotY = applyGamepadDeadzone(gamepad.axes[axisRotateY] ?? 0, deadzone);
+		const input = this.gamepadInput;
+		const rotX = input.axis(axisRotateX, { deadzone });
+		const rotY = input.axis(axisRotateY, { deadzone });
 		if (rotX === 0 && rotY === 0) return;
 		const scale = rotateSpeed * deltaTime * Math.PI;
 		controls._moveCurr.x += rotX * scale;
@@ -79,20 +77,20 @@ var GamepadTrackballControls = class extends GamepadControls {
 	* Queues pan input into TrackballControls' normalized pan state.
 	*
 	* @param deltaTime - Seconds since the last frame.
-	* @param gamepad - Fresh gamepad snapshot to read from.
 	* @param panSpeed - User-configured pan speed multiplier.
 	* @param deadzone - Axis dead zone threshold.
 	* @param axisPanX - Axis index for horizontal panning.
 	* @param axisPanY - Axis index for vertical panning.
 	*/
-	#queuePan(deltaTime, gamepad, panSpeed, deadzone, axisPanX, axisPanY) {
+	#queuePan(deltaTime, panSpeed, deadzone, axisPanX, axisPanY) {
 		const controls = this.#controls;
 		if (controls.noPan) {
 			controls._panStart.copy(controls._panEnd);
 			return;
 		}
-		const panX = applyGamepadDeadzone(gamepad.axes[axisPanX] ?? 0, deadzone);
-		const panY = applyGamepadDeadzone(gamepad.axes[axisPanY] ?? 0, deadzone);
+		const input = this.gamepadInput;
+		const panX = input.axis(axisPanX, { deadzone });
+		const panY = input.axis(axisPanY, { deadzone });
 		if (panX === 0 && panY === 0) return;
 		const scale = panSpeed * deltaTime * this.#getInputDampingFactor();
 		controls._panEnd.x += panX * scale;
@@ -102,20 +100,20 @@ var GamepadTrackballControls = class extends GamepadControls {
 	* Queues trigger zoom input into TrackballControls' normalized zoom state.
 	*
 	* @param deltaTime - Seconds since the last frame.
-	* @param gamepad - Fresh gamepad snapshot to read from.
 	* @param zoomSpeed - User-configured zoom speed multiplier.
 	* @param deadzone - Trigger dead zone threshold.
 	* @param buttonZoomIn - Button index for zooming in.
 	* @param buttonZoomOut - Button index for zooming out.
 	*/
-	#queueZoom(deltaTime, gamepad, zoomSpeed, deadzone, buttonZoomIn, buttonZoomOut) {
+	#queueZoom(deltaTime, zoomSpeed, deadzone, buttonZoomIn, buttonZoomOut) {
 		const controls = this.#controls;
 		if (controls.noZoom) {
 			controls._zoomStart.copy(controls._zoomEnd);
 			return;
 		}
-		const triggerIn = getGamepadButtonValue(gamepad, buttonZoomIn);
-		const triggerOut = getGamepadButtonValue(gamepad, buttonZoomOut);
+		const input = this.gamepadInput;
+		const triggerIn = input.buttonValue(buttonZoomIn);
+		const triggerOut = input.buttonValue(buttonZoomOut);
 		if (triggerIn <= deadzone && triggerOut <= deadzone) return;
 		controls._zoomEnd.y += (triggerOut - triggerIn) * zoomSpeed * deltaTime * this.#getInputDampingFactor();
 	}

package/dist/gamepad-transform-controls.d.ts

@@ -114,9 +114,8 @@ declare class GamepadTransformControls extends GamepadControls {
    * translate, rotate, scale, and reset behavior.
    *
    * @param deltaTime - Seconds since the last frame.
-   * @param gamepad - Fresh gamepad snapshot provided by the base class.
    */
-  protected onUpdate(deltaTime: number, gamepad: Gamepad): void;
+  protected onUpdate(deltaTime: number): void;
   /**
    * Ends any active transform before disposing the gamepad lifecycle listeners.
    */

package/dist/gamepad-transform-controls.js

@@ -1,6 +1,5 @@
 import { GAMEPAD_AXIS, GAMEPAD_BUTTON } from "./core.js";
 import { GamepadControls } from "./gamepad-controls.js";
-import { applyGamepadDeadzone, getGamepadButtonPressed } from "./utils.js";
 import { Matrix4, Quaternion, Vector2, Vector3 } from "three";
 //#region src/gamepad-transform-controls.ts
 /**
@@ -70,7 +69,6 @@ const PROJECTED_AXIS_EPSILON = .001;
 var GamepadTransformControls = class extends GamepadControls {
 	#controls;
 	#options;
-	#pressedButtons;
 	#activeAxisByMode;
 	#viewSize;
 	#parentInverse;
@@ -117,7 +115,6 @@ var GamepadTransformControls = class extends GamepadControls {
 			...DEFAULT_TRANSFORM_OPTIONS,
 			...options
 		};
-		this.#pressedButtons = /* @__PURE__ */ new Set();
 		this.#activeAxisByMode = {
 			translate: "X",
 			rotate: "X",
@@ -158,10 +155,9 @@ var GamepadTransformControls = class extends GamepadControls {
 	* translate, rotate, scale, and reset behavior.
 	*
 	* @param deltaTime - Seconds since the last frame.
-	* @param gamepad - Fresh gamepad snapshot provided by the base class.
 	*/
-	onUpdate(deltaTime, gamepad) {
-		const startedButtons = this.#getStartedButtons(gamepad);
+	onUpdate(deltaTime) {
+		const startedButtons = this.#getStartedButtons();
 		this.#handleModeAndAxisButtons(startedButtons);
 		if (startedButtons.has(this.#options.buttonReset)) this.#resetActiveTransform();
 		const controls = this.#controls;
@@ -173,8 +169,8 @@ var GamepadTransformControls = class extends GamepadControls {
 			this.#endTransform(true);
 			return;
 		}
-		const transformX = applyGamepadDeadzone(gamepad.axes[this.#options.axisTransformX] ?? 0, this.#options.deadzone);
-		const transformY = applyGamepadDeadzone(gamepad.axes[this.#options.axisTransformY] ?? 0, this.#options.deadzone);
+		const transformX = this.gamepadInput.axis(this.#options.axisTransformX, { deadzone: this.#options.deadzone });
+		const transformY = this.gamepadInput.axis(this.#options.axisTransformY, { deadzone: this.#options.deadzone });
 		if (transformX === 0 && transformY === 0) {
 			this.#endTransform(false);
 			return;
@@ -190,7 +186,6 @@ var GamepadTransformControls = class extends GamepadControls {
 	*/
 	dispose() {
 		this.#endTransform(true);
-		this.#pressedButtons.clear();
 		super.dispose();
 	}
 	/**
@@ -200,7 +195,6 @@ var GamepadTransformControls = class extends GamepadControls {
 	*/
 	onGamepadDisconnected(gamepad) {
 		this.#endTransform(true);
-		this.#pressedButtons.clear();
 		super.onGamepadDisconnected(gamepad);
 	}
 	/**
@@ -882,21 +876,27 @@ var GamepadTransformControls = class extends GamepadControls {
 		return Math.abs(inputX) >= Math.abs(inputY) ? inputX : inputY;
 	}
 	/**
-	* Tracks pressed buttons and returns those newly pressed this frame.
+	* Returns configured button indices that were newly pressed this frame.
 	*
-	* @param gamepad - Fresh gamepad snapshot to read from.
 	* @returns Button indices that transitioned to pressed.
 	*/
-	#getStartedButtons(gamepad) {
+	#getStartedButtons() {
 		const startedButtons = /* @__PURE__ */ new Set();
-		for (let index = 0; index < gamepad.buttons.length; index += 1) {
-			const pressed = getGamepadButtonPressed(gamepad, index);
-			const wasPressed = this.#pressedButtons.has(index);
-			if (pressed) {
-				this.#pressedButtons.add(index);
-				if (!wasPressed) startedButtons.add(index);
-			} else this.#pressedButtons.delete(index);
-		}
+		const input = this.gamepadInput;
+		const buttons = [
+			this.#options.buttonTranslate,
+			this.#options.buttonRotate,
+			this.#options.buttonScale,
+			this.#options.buttonToggleSpace,
+			this.#options.buttonAxisX,
+			this.#options.buttonAxisY,
+			this.#options.buttonAxisZ,
+			this.#options.buttonAxisComposite,
+			this.#options.buttonAxisPrevious,
+			this.#options.buttonAxisNext,
+			this.#options.buttonReset
+		];
+		for (const button of buttons) if (input.wasPressed(button)) startedButtons.add(button);
 		return startedButtons;
 	}
 	/**

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 import { GAMEPAD_AXIS, GAMEPAD_BUTTON, GamepadAxisKey, GamepadAxisValue, GamepadButtonKey, GamepadButtonValue } from "./core.js";
+import { GamepadAxisOptions, GamepadInput, GamepadInputEventMap, GamepadInputOptions, GamepadStick } from "./gamepad-input.js";
 import { GamepadControls, GamepadControlsEventMap } from "./gamepad-controls.js";
 import { GamepadArcballControls, GamepadArcballControlsOptions } from "./gamepad-arcball-controls.js";
 import { GamepadDragControls, GamepadDragControlsOptions } from "./gamepad-drag-controls.js";
 import { GamepadFirstPersonControls, GamepadFirstPersonControlsOptions } from "./gamepad-first-person-controls.js";
 import { GamepadFlyControls, GamepadFlyControlsOptions } from "./gamepad-fly-controls.js";
-import { GamepadAxisOptions, GamepadInput, GamepadInputEventMap, GamepadInputOptions, GamepadStick } from "./gamepad-input.js";
 import { GamepadOrbitControls, GamepadOrbitControlsOptions } from "./gamepad-orbit-controls.js";
 import { GamepadMapControls } from "./gamepad-map-controls.js";
 import { GamepadPointerLockControls, GamepadPointerLockControlsOptions } from "./gamepad-pointer-lock-controls.js";

package/dist/index.js

@@ -1,10 +1,10 @@
 import { GAMEPAD_AXIS, GAMEPAD_BUTTON } from "./core.js";
+import { GamepadInput } from "./gamepad-input.js";
 import { GamepadControls } from "./gamepad-controls.js";
 import { GamepadArcballControls } from "./gamepad-arcball-controls.js";
 import { GamepadDragControls } from "./gamepad-drag-controls.js";
 import { GamepadFirstPersonControls } from "./gamepad-first-person-controls.js";
 import { GamepadFlyControls } from "./gamepad-fly-controls.js";
-import { GamepadInput } from "./gamepad-input.js";
 import { GamepadOrbitControls } from "./gamepad-orbit-controls.js";
 import { GamepadMapControls } from "./gamepad-map-controls.js";
 import { GamepadPointerLockControls } from "./gamepad-pointer-lock-controls.js";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "three-gamepad-controls",
   "description": "Gamepad support for Three.js controls.",
-  "version": "0.11.0",
+  "version": "0.12.1",
   "homepage": "https://github.com/luckasnix/three-gamepad-controls#readme",
   "author": {
     "name": "Kasnix",
@@ -51,14 +51,14 @@
     "@commitlint/config-conventional": "21.0.2",
     "@commitlint/types": "21.0.1",
     "@types/node": "24.13.2",
-    "@types/three": "0.184.1",
+    "@types/three": "0.184.0",
     "husky": "9.1.7",
     "three": "0.184.0",
     "tsdown": "0.22.2",
     "typescript": "6.0.3"
   },
   "peerDependencies": {
-    "@types/three": ">=0.184.1",
+    "@types/three": ">=0.184.0",
     "three": ">=0.184.0"
   },
   "scripts": {

package/dist/utils.js

@@ -1,41 +0,0 @@
-//#region src/utils.ts
-/**
-* Returns `value` unchanged, or `0` if below the dead zone `threshold`.
-*
-* @param value - Raw axis or trigger value, typically in `[-1, 1]`.
-* @param threshold - Dead zone size; values below this magnitude are zeroed.
-* @returns The original value when outside the dead zone, otherwise `0`.
-*/
-const applyGamepadDeadzone = (value, threshold) => {
-	return Math.abs(value) < threshold ? 0 : value;
-};
-/**
-* Returns whether a gamepad button is currently pressed.
-*
-* Missing buttons are treated as not pressed.
-*
-* @param gamepad - Gamepad snapshot to read from.
-* @param button - Button index to inspect.
-* @returns `true` when the button exists and is pressed, otherwise `false`.
-*/
-const getGamepadButtonPressed = (gamepad, button) => {
-	return gamepad.buttons[button]?.pressed ?? false;
-};
-/**
-* Returns the analog value for a gamepad button.
-*
-* Some digital buttons may report `pressed` without a meaningful non-zero
-* `value`, so pressed buttons fall back to `1`.
-*
-* @param gamepad - Gamepad snapshot to read from.
-* @param button - Button index to inspect.
-* @returns The button value, `1` for pressed digital buttons, or `0` when unavailable.
-*/
-const getGamepadButtonValue = (gamepad, button) => {
-	const gamepadButton = gamepad.buttons[button];
-	if (gamepadButton === void 0) return 0;
-	if (gamepadButton.value !== 0) return gamepadButton.value;
-	return gamepadButton.pressed ? 1 : 0;
-};
-//#endregion
-export { applyGamepadDeadzone, getGamepadButtonPressed, getGamepadButtonValue };