three-gamepad-controls 0.10.3 → 0.10.5

package/dist/gamepad-arcball-controls.js

@@ -1,4 +1,5 @@
 import { GAMEPAD_AXIS, GAMEPAD_BUTTON } from "./core.js";
+import { applyGamepadDeadzone, getGamepadButtonPressed, getGamepadButtonValue } from "./utils.js";
 import { GamepadControls } from "./gamepad-controls.js";
 import { Vector2, Vector3 } from "three";
 //#region src/gamepad-arcball-controls.ts
@@ -76,12 +77,12 @@ var GamepadArcballControls = class extends GamepadControls {
 			this.#endInteraction();
 			return;
 		}
-		const rotateX = controls.enableRotate ? this.#applyDeadzone(gamepad.axes[axisRotateX] ?? 0, deadzone) : 0;
-		const rotateY = controls.enableRotate ? this.#applyDeadzone(gamepad.axes[axisRotateY] ?? 0, deadzone) : 0;
-		const panX = controls.enablePan ? this.#applyDeadzone(gamepad.axes[axisPanX] ?? 0, deadzone) : 0;
-		const panY = controls.enablePan ? this.#applyDeadzone(gamepad.axes[axisPanY] ?? 0, deadzone) : 0;
-		const zoom = controls.enableZoom ? this.#getButtonValue(gamepad, buttonZoomIn) - this.#getButtonValue(gamepad, buttonZoomOut) : 0;
-		const zRotation = controls.enableRotate ? this.#getButtonValue(gamepad, buttonZRotateLeft) - this.#getButtonValue(gamepad, buttonZRotateRight) : 0;
+		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 activeInput = rotateX !== 0 || rotateY !== 0 || panX !== 0 || panY !== 0 || Math.abs(zoom) > deadzone || Math.abs(zRotation) > deadzone;
 		if (!activeInput && focusPoint === null) {
 			this.#endInteraction();
@@ -171,7 +172,7 @@ var GamepadArcballControls = class extends GamepadControls {
 	}
 	#consumeFocusPoint(gamepad, buttonFocus) {
 		const controls = this.#controls;
-		const focusPressed = this.#getButtonPressed(gamepad, buttonFocus);
+		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;
@@ -182,24 +183,6 @@ var GamepadArcballControls = class extends GamepadControls {
 		this.#controls.dispatchEvent({ type: "end" });
 		this.#wasInteracting = false;
 	}
-	#getButtonValue(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;
-	}
-	#getButtonPressed(gamepad, button) {
-		return gamepad.buttons[button]?.pressed ?? false;
-	}
-	/**
-	* 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.
-	*/
-	#applyDeadzone(value, threshold) {
-		return Math.abs(value) < threshold ? 0 : value;
-	}
 };
 //#endregion
 export { GamepadArcballControls };

package/dist/gamepad-controls.js

@@ -1,3 +1,4 @@
+import { getFirstConnectedGamepad, getGamepadByIndex } from "./utils.js";
 import { EventDispatcher } from "three";
 //#region src/gamepad-controls.ts
 /**
@@ -36,9 +37,17 @@ var GamepadControls = class extends EventDispatcher {
 	*/
 	update(deltaTime) {
 		if (!this.enabled) return;
-		if (this.gamepad !== null) {
-			const gamepads = navigator.getGamepads();
-			this.gamepad = gamepads[this.gamepad.index] ?? null;
+		if (this.gamepad === null) {
+			const connectedGamepad = getFirstConnectedGamepad();
+			if (connectedGamepad !== null) this.onGamepadConnected(connectedGamepad);
+		} else {
+			const previousGamepad = this.gamepad;
+			const nextGamepad = getGamepadByIndex(previousGamepad.index);
+			if (nextGamepad === null) {
+				this.onGamepadDisconnected(previousGamepad);
+				return;
+			}
+			this.gamepad = nextGamepad;
 		}
 		if (this.gamepad === null) return;
 		this.onUpdate(deltaTime, this.gamepad);

package/dist/gamepad-drag-controls.js

@@ -1,4 +1,5 @@
 import { GAMEPAD_AXIS, GAMEPAD_BUTTON } from "./core.js";
+import { applyGamepadDeadzone, getGamepadButtonPressed } from "./utils.js";
 import { GamepadControls } from "./gamepad-controls.js";
 import { Matrix4, Vector2, Vector3 } from "three";
 //#region src/gamepad-drag-controls.ts
@@ -71,7 +72,7 @@ var GamepadDragControls = class extends GamepadControls {
 	*/
 	onUpdate(deltaTime, gamepad) {
 		const controls = this.#controls;
-		const selectPressed = this.#getButtonPressed(gamepad, this.#options.buttonSelect);
+		const selectPressed = getGamepadButtonPressed(gamepad, this.#options.buttonSelect);
 		const selectStarted = selectPressed && !this.#selectButtonPressed;
 		this.#selectButtonPressed = selectPressed;
 		if (!controls.enabled) {
@@ -114,10 +115,10 @@ var GamepadDragControls = class extends GamepadControls {
 		const selected = this.#selected;
 		if (selected === null) return;
 		const { dragSpeed, rotateSpeed, deadzone, axisDragX, axisDragY, axisRotateX, axisRotateY } = this.#options;
-		const dragX = this.#applyDeadzone(gamepad.axes[axisDragX] ?? 0, deadzone);
-		const dragY = this.#applyDeadzone(gamepad.axes[axisDragY] ?? 0, deadzone);
-		const rotateX = this.#applyDeadzone(gamepad.axes[axisRotateX] ?? 0, deadzone);
-		const rotateY = this.#applyDeadzone(gamepad.axes[axisRotateY] ?? 0, deadzone);
+		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 dragged = this.#applyDrag(deltaTime, dragX, dragY, dragSpeed);
 		const rotated = this.#applyRotation(deltaTime, rotateX, rotateY, rotateSpeed);
 		if (dragged || rotated) this.#controls.dispatchEvent({
@@ -243,18 +244,6 @@ var GamepadDragControls = class extends GamepadControls {
 	#isOrthographicCamera(camera) {
 		return camera.isOrthographicCamera === true;
 	}
-	#getButtonPressed(gamepad, button) {
-		return gamepad.buttons[button]?.pressed ?? false;
-	}
-	/**
-	* Returns `value` unchanged, or `0` if below the dead zone `threshold`.
-	*
-	* @param value - Raw axis value, typically in `[-1, 1]`.
-	* @param threshold - Dead zone size; values below this magnitude are zeroed.
-	*/
-	#applyDeadzone(value, threshold) {
-		return Math.abs(value) < threshold ? 0 : value;
-	}
 };
 //#endregion
 export { GamepadDragControls };

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

@@ -1,4 +1,5 @@
 import { GAMEPAD_AXIS, GAMEPAD_BUTTON } from "./core.js";
+import { applyGamepadDeadzone, getGamepadButtonValue } from "./utils.js";
 import { GamepadControls } from "./gamepad-controls.js";
 import { MathUtils, Spherical, Vector3 } from "three";
 //#region src/gamepad-first-person-controls.ts
@@ -60,7 +61,7 @@ var GamepadFirstPersonControls = class extends GamepadControls {
 	#applyMovement(deltaTime, gamepad, moveSpeed, deadzone, axisMoveForward, axisMoveRight, buttonMoveUp, buttonMoveDown) {
 		const controls = this.#controls;
 		const moveMult = deltaTime * controls.movementSpeed * moveSpeed;
-		const forward = this.#applyDeadzone(gamepad.axes[axisMoveForward] ?? 0, deadzone);
+		const forward = applyGamepadDeadzone(gamepad.axes[axisMoveForward] ?? 0, deadzone);
 		if (forward !== 0) {
 			let distance = forward * moveMult;
 			if (forward < 0 && controls.heightSpeed) {
@@ -69,16 +70,16 @@ var GamepadFirstPersonControls = class extends GamepadControls {
 			}
 			controls.object.translateZ(distance);
 		}
-		const strafe = this.#applyDeadzone(gamepad.axes[axisMoveRight] ?? 0, deadzone);
+		const strafe = applyGamepadDeadzone(gamepad.axes[axisMoveRight] ?? 0, deadzone);
 		if (strafe !== 0) controls.object.translateX(strafe * moveMult);
-		const up = gamepad.buttons[buttonMoveUp]?.value ?? 0;
-		const down = gamepad.buttons[buttonMoveDown]?.value ?? 0;
+		const up = getGamepadButtonValue(gamepad, buttonMoveUp);
+		const down = getGamepadButtonValue(gamepad, buttonMoveDown);
 		if (up > deadzone) controls.object.translateY(up * moveMult);
 		if (down > deadzone) controls.object.translateY(-down * moveMult);
 	}
 	#applyLook(deltaTime, gamepad, lookSpeed, deadzone, axisLookX, axisLookY) {
-		const lookX = this.#applyDeadzone(gamepad.axes[axisLookX] ?? 0, deadzone);
-		const lookY = this.#applyDeadzone(gamepad.axes[axisLookY] ?? 0, deadzone);
+		const lookX = applyGamepadDeadzone(gamepad.axes[axisLookX] ?? 0, deadzone);
+		const lookY = applyGamepadDeadzone(gamepad.axes[axisLookY] ?? 0, deadzone);
 		if (lookX === 0 && lookY === 0) return;
 		const controls = this.#controls;
 		const actualLookSpeed = controls.lookSpeed * lookSpeed * deltaTime * LOOK_SPEED_SCALE;
@@ -110,15 +111,6 @@ var GamepadFirstPersonControls = class extends GamepadControls {
 			lon: MathUtils.radToDeg(this.#spherical.theta)
 		};
 	}
-	/**
-	* 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.
-	*/
-	#applyDeadzone(value, threshold) {
-		return Math.abs(value) < threshold ? 0 : value;
-	}
 };
 //#endregion
 export { GamepadFirstPersonControls };

package/dist/gamepad-fly-controls.js

@@ -1,4 +1,5 @@
 import { GAMEPAD_AXIS, GAMEPAD_BUTTON } from "./core.js";
+import { applyGamepadDeadzone, getGamepadButtonPressed, getGamepadButtonValue } from "./utils.js";
 import { GamepadControls } from "./gamepad-controls.js";
 import { Quaternion } from "three";
 //#region src/gamepad-fly-controls.ts
@@ -52,32 +53,23 @@ var GamepadFlyControls = class extends GamepadControls {
 	onUpdate(deltaTime, gamepad) {
 		const { moveSpeed, rotateSpeed, deadzone, axisMoveForward, axisMoveRight, axisLookX, axisLookY, buttonRollLeft, buttonRollRight, buttonMoveUp, buttonMoveDown } = this.#options;
 		const moveMult = deltaTime * this.#controls.movementSpeed * moveSpeed;
-		const fwd = this.#applyDeadzone(gamepad.axes[axisMoveForward] ?? 0, deadzone);
+		const fwd = applyGamepadDeadzone(gamepad.axes[axisMoveForward] ?? 0, deadzone);
 		if (fwd !== 0) this.#controls.object.translateZ(fwd * moveMult);
-		const strafe = this.#applyDeadzone(gamepad.axes[axisMoveRight] ?? 0, deadzone);
+		const strafe = applyGamepadDeadzone(gamepad.axes[axisMoveRight] ?? 0, deadzone);
 		if (strafe !== 0) this.#controls.object.translateX(strafe * moveMult);
-		const up = gamepad.buttons[buttonMoveUp]?.value ?? 0;
-		const down = gamepad.buttons[buttonMoveDown]?.value ?? 0;
+		const up = getGamepadButtonValue(gamepad, buttonMoveUp);
+		const down = getGamepadButtonValue(gamepad, 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 = -this.#applyDeadzone(gamepad.axes[axisLookY] ?? 0, deadzone);
-		const yaw = -this.#applyDeadzone(gamepad.axes[axisLookX] ?? 0, deadzone);
-		const roll = (gamepad.buttons[buttonRollLeft]?.pressed ? 1 : 0) - (gamepad.buttons[buttonRollRight]?.pressed ? 1 : 0);
+		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);
 		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);
 		}
 	}
-	/**
-	* 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.
-	*/
-	#applyDeadzone(value, threshold) {
-		return Math.abs(value) < threshold ? 0 : value;
-	}
 };
 //#endregion
 export { GamepadFlyControls };

package/dist/gamepad-orbit-controls.js

@@ -1,4 +1,5 @@
 import { GAMEPAD_AXIS, GAMEPAD_BUTTON } from "./core.js";
+import { applyGamepadDeadzone, getGamepadButtonValue } from "./utils.js";
 import { GamepadControls } from "./gamepad-controls.js";
 //#region src/gamepad-orbit-controls.ts
 /**
@@ -46,27 +47,18 @@ var GamepadOrbitControls = class extends GamepadControls {
 	*/
 	onUpdate(deltaTime, gamepad) {
 		const { rotateSpeed, panSpeed, zoomSpeed, deadzone, axisRotateX, axisRotateY, axisPanX, axisPanY, buttonDollyIn, buttonDollyOut } = this.#options;
-		const rotX = this.#applyDeadzone(gamepad.axes[axisRotateX] ?? 0, deadzone);
-		const rotY = this.#applyDeadzone(gamepad.axes[axisRotateY] ?? 0, deadzone);
+		const rotX = applyGamepadDeadzone(gamepad.axes[axisRotateX] ?? 0, deadzone);
+		const rotY = applyGamepadDeadzone(gamepad.axes[axisRotateY] ?? 0, 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 = this.#applyDeadzone(gamepad.axes[axisPanX] ?? 0, deadzone);
-		const panY = this.#applyDeadzone(gamepad.axes[axisPanY] ?? 0, deadzone);
+		const panX = applyGamepadDeadzone(gamepad.axes[axisPanX] ?? 0, deadzone);
+		const panY = applyGamepadDeadzone(gamepad.axes[axisPanY] ?? 0, deadzone);
 		if (panX !== 0 || panY !== 0) this.#controls.pan(panX * panSpeed * deltaTime * 500, panY * panSpeed * deltaTime * 500);
-		const triggerIn = gamepad.buttons[buttonDollyIn]?.value ?? 0;
-		const triggerOut = gamepad.buttons[buttonDollyOut]?.value ?? 0;
+		const triggerIn = getGamepadButtonValue(gamepad, buttonDollyIn);
+		const triggerOut = getGamepadButtonValue(gamepad, buttonDollyOut);
 		if (triggerIn > deadzone) this.#controls.dollyIn(1 / (1 + zoomSpeed * triggerIn * deltaTime));
 		if (triggerOut > deadzone) this.#controls.dollyOut(1 / (1 + zoomSpeed * triggerOut * deltaTime));
 	}
-	/**
-	* 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.
-	*/
-	#applyDeadzone(value, threshold) {
-		return Math.abs(value) < threshold ? 0 : value;
-	}
 };
 //#endregion
 export { GamepadOrbitControls };

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

@@ -1,4 +1,5 @@
 import { GAMEPAD_AXIS } from "./core.js";
+import { applyGamepadDeadzone } from "./utils.js";
 import { GamepadControls } from "./gamepad-controls.js";
 import { Euler } from "three";
 //#region src/gamepad-pointer-lock-controls.ts
@@ -47,12 +48,12 @@ var GamepadPointerLockControls = class extends GamepadControls {
 	*/
 	onUpdate(deltaTime, gamepad) {
 		const { moveSpeed, lookSpeed, deadzone, axisMoveForward, axisMoveRight, axisLookX, axisLookY } = this.#options;
-		const fwd = this.#applyDeadzone(gamepad.axes[axisMoveForward] ?? 0, deadzone);
-		const strafe = this.#applyDeadzone(gamepad.axes[axisMoveRight] ?? 0, deadzone);
+		const fwd = applyGamepadDeadzone(gamepad.axes[axisMoveForward] ?? 0, deadzone);
+		const strafe = applyGamepadDeadzone(gamepad.axes[axisMoveRight] ?? 0, deadzone);
 		if (fwd !== 0) this.#controls.moveForward(-fwd * moveSpeed * deltaTime);
 		if (strafe !== 0) this.#controls.moveRight(strafe * moveSpeed * deltaTime);
-		const lookX = this.#applyDeadzone(gamepad.axes[axisLookX] ?? 0, deadzone);
-		const lookY = this.#applyDeadzone(gamepad.axes[axisLookY] ?? 0, deadzone);
+		const lookX = applyGamepadDeadzone(gamepad.axes[axisLookX] ?? 0, deadzone);
+		const lookY = applyGamepadDeadzone(gamepad.axes[axisLookY] ?? 0, deadzone);
 		if (lookX !== 0 || lookY !== 0) {
 			const camera = this.#controls.object;
 			const scale = lookSpeed * this.#controls.pointerSpeed * deltaTime * Math.PI;
@@ -63,15 +64,6 @@ var GamepadPointerLockControls = class extends GamepadControls {
 			camera.quaternion.setFromEuler(this.#euler);
 		}
 	}
-	/**
-	* Returns `value` unchanged, or `0` if below the dead zone `threshold`.
-	*
-	* @param value - Raw axis value, typically in `[-1, 1]`.
-	* @param threshold - Dead zone size; values below this magnitude are zeroed.
-	*/
-	#applyDeadzone(value, threshold) {
-		return Math.abs(value) < threshold ? 0 : value;
-	}
 };
 //#endregion
 export { GamepadPointerLockControls };

package/dist/gamepad-trackball-controls.js

@@ -1,4 +1,5 @@
 import { GAMEPAD_AXIS, GAMEPAD_BUTTON } from "./core.js";
+import { applyGamepadDeadzone, getGamepadButtonValue } from "./utils.js";
 import { GamepadControls } from "./gamepad-controls.js";
 //#region src/gamepad-trackball-controls.ts
 /**
@@ -57,8 +58,8 @@ var GamepadTrackballControls = class extends GamepadControls {
 			controls._lastAngle = 0;
 			return;
 		}
-		const rotX = this.#applyDeadzone(gamepad.axes[axisRotateX] ?? 0, deadzone);
-		const rotY = this.#applyDeadzone(gamepad.axes[axisRotateY] ?? 0, deadzone);
+		const rotX = applyGamepadDeadzone(gamepad.axes[axisRotateX] ?? 0, deadzone);
+		const rotY = applyGamepadDeadzone(gamepad.axes[axisRotateY] ?? 0, deadzone);
 		if (rotX === 0 && rotY === 0) return;
 		const scale = rotateSpeed * deltaTime * Math.PI;
 		controls._moveCurr.x += rotX * scale;
@@ -70,10 +71,10 @@ var GamepadTrackballControls = class extends GamepadControls {
 			controls._panStart.copy(controls._panEnd);
 			return;
 		}
-		const panX = this.#applyDeadzone(gamepad.axes[axisPanX] ?? 0, deadzone);
-		const panY = this.#applyDeadzone(gamepad.axes[axisPanY] ?? 0, deadzone);
+		const panX = applyGamepadDeadzone(gamepad.axes[axisPanX] ?? 0, deadzone);
+		const panY = applyGamepadDeadzone(gamepad.axes[axisPanY] ?? 0, deadzone);
 		if (panX === 0 && panY === 0) return;
-		const scale = panSpeed * deltaTime;
+		const scale = panSpeed * deltaTime * this.#getInputDampingFactor();
 		controls._panEnd.x += panX * scale;
 		controls._panEnd.y += panY * scale;
 	}
@@ -83,19 +84,18 @@ var GamepadTrackballControls = class extends GamepadControls {
 			controls._zoomStart.copy(controls._zoomEnd);
 			return;
 		}
-		const triggerIn = gamepad.buttons[buttonZoomIn]?.value ?? 0;
-		const triggerOut = gamepad.buttons[buttonZoomOut]?.value ?? 0;
+		const triggerIn = getGamepadButtonValue(gamepad, buttonZoomIn);
+		const triggerOut = getGamepadButtonValue(gamepad, buttonZoomOut);
 		if (triggerIn <= deadzone && triggerOut <= deadzone) return;
-		controls._zoomEnd.y += (triggerOut - triggerIn) * zoomSpeed * deltaTime;
+		controls._zoomEnd.y += (triggerOut - triggerIn) * zoomSpeed * deltaTime * this.#getInputDampingFactor();
 	}
 	/**
-	* 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.
+	* Compensates for TrackballControls reapplying queued pan and zoom deltas
+	* while their input state catches up through damping.
 	*/
-	#applyDeadzone(value, threshold) {
-		return Math.abs(value) < threshold ? 0 : value;
+	#getInputDampingFactor() {
+		const controls = this.#controls;
+		return controls.staticMoving ? 1 : controls.dynamicDampingFactor;
 	}
 };
 //#endregion

package/dist/gamepad-transform-controls.js

@@ -1,4 +1,5 @@
 import { GAMEPAD_AXIS, GAMEPAD_BUTTON } from "./core.js";
+import { applyGamepadDeadzone, getGamepadButtonPressed } from "./utils.js";
 import { GamepadControls } from "./gamepad-controls.js";
 import { Matrix4, Quaternion, Vector2, Vector3 } from "three";
 //#region src/gamepad-transform-controls.ts
@@ -172,8 +173,8 @@ var GamepadTransformControls = class extends GamepadControls {
 			this.#endTransform(true);
 			return;
 		}
-		const transformX = this.#applyDeadzone(gamepad.axes[this.#options.axisTransformX] ?? 0, this.#options.deadzone);
-		const transformY = this.#applyDeadzone(gamepad.axes[this.#options.axisTransformY] ?? 0, this.#options.deadzone);
+		const transformX = applyGamepadDeadzone(gamepad.axes[this.#options.axisTransformX] ?? 0, this.#options.deadzone);
+		const transformY = applyGamepadDeadzone(gamepad.axes[this.#options.axisTransformY] ?? 0, this.#options.deadzone);
 		if (transformX === 0 && transformY === 0) {
 			this.#endTransform(false);
 			return;
@@ -605,7 +606,7 @@ var GamepadTransformControls = class extends GamepadControls {
 	#getStartedButtons(gamepad) {
 		const startedButtons = /* @__PURE__ */ new Set();
 		for (let index = 0; index < gamepad.buttons.length; index += 1) {
-			const pressed = gamepad.buttons[index]?.pressed ?? false;
+			const pressed = getGamepadButtonPressed(gamepad, index);
 			const wasPressed = this.#pressedButtons.has(index);
 			if (pressed) {
 				this.#pressedButtons.add(index);
@@ -620,15 +621,6 @@ var GamepadTransformControls = class extends GamepadControls {
 	#isOrthographicCamera(camera) {
 		return camera.isOrthographicCamera === true;
 	}
-	/**
-	* Returns `value` unchanged, or `0` if below the dead zone `threshold`.
-	*
-	* @param value - Raw axis value, typically in `[-1, 1]`.
-	* @param threshold - Dead zone size; values below this magnitude are zeroed.
-	*/
-	#applyDeadzone(value, threshold) {
-		return Math.abs(value) < threshold ? 0 : value;
-	}
 };
 //#endregion
 export { GamepadTransformControls };

package/dist/utils.js

@@ -0,0 +1,60 @@
+//#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;
+};
+/**
+* Returns a fresh connected gamepad snapshot by index.
+*
+* @param index - Gamepad index to look up.
+* @returns The connected gamepad snapshot at the index, or `null` when unavailable.
+*/
+const getGamepadByIndex = (index) => {
+	const gamepad = navigator.getGamepads()[index] ?? null;
+	return gamepad?.connected === true ? gamepad : null;
+};
+/**
+* Returns the first currently connected gamepad snapshot.
+*
+* @returns The first connected gamepad snapshot, or `null` when none are connected.
+*/
+const getFirstConnectedGamepad = () => {
+	for (const gamepad of navigator.getGamepads()) if (gamepad?.connected === true) return gamepad;
+	return null;
+};
+//#endregion
+export { applyGamepadDeadzone, getFirstConnectedGamepad, getGamepadButtonPressed, getGamepadButtonValue, getGamepadByIndex };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "three-gamepad-controls",
   "description": "Gamepad support for Three.js controls.",
-  "version": "0.10.3",
+  "version": "0.10.5",
   "homepage": "https://github.com/luckasnix/three-gamepad-controls#readme",
   "author": {
     "name": "Kasnix",
@@ -46,11 +46,11 @@
     }
   },
   "devDependencies": {
-    "@biomejs/biome": "2.4.16",
+    "@biomejs/biome": "2.5.0",
     "@commitlint/cli": "21.0.2",
     "@commitlint/config-conventional": "21.0.2",
     "@commitlint/types": "21.0.1",
-    "@types/node": "24.12.4",
+    "@types/node": "24.13.2",
     "@types/three": "0.184.1",
     "husky": "9.1.7",
     "three": "0.184.0",