three-gamepad-controls 0.16.0 → 0.17.0

package/dist/gamepad-input.d.ts

@@ -23,6 +23,10 @@ type GamepadInputEventMap = {
     gamepad: Gamepad;
   };
 };
+/**
+ * Dead zone processing mode for two-dimensional stick reads.
+ */
+type GamepadDeadzoneMode = "axial" | "radial";
 /**
  * Configuration for {@link GamepadInput}.
  */
@@ -32,6 +36,16 @@ type GamepadInputOptions = {
    * @default 0.1
    */
   deadzone: number;
+  /**
+   * Default dead zone mode for stick reads.
+   * @default "axial"
+   */
+  deadzoneMode: GamepadDeadzoneMode;
+  /**
+   * Whether stick reads rescale values outside the dead zone by default.
+   * @default false
+   */
+  rescale: boolean;
   /**
    * Browser-assigned gamepad slot to use.
    *
@@ -63,7 +77,7 @@ type GamepadStickOptions = GamepadAxisOptions & {
    * the stick magnitude.
    * @default "axial"
    */
-  deadzoneMode?: "axial" | "radial";
+  deadzoneMode?: GamepadDeadzoneMode;
   /**
    * Whether to remap values outside the dead zone to the full output range.
    * @default false
@@ -211,4 +225,4 @@ declare class GamepadInput extends EventDispatcher<GamepadInputEventMap> {
   resetVibration(): Promise<GamepadHapticsResult | null>;
 }
 //#endregion
-export { GamepadAxisOptions, GamepadInput, GamepadInputEventMap, GamepadInputOptions, GamepadStick, GamepadStickOptions };
+export { GamepadAxisOptions, GamepadDeadzoneMode, GamepadInput, GamepadInputEventMap, GamepadInputOptions, GamepadStick, GamepadStickOptions };

package/dist/gamepad-input.js

@@ -2,7 +2,11 @@ import { isGamepadVibrationSupported, playGamepadVibrationEffect, resetGamepadVi
 import { GamepadManager } from "./gamepad-manager.js";
 import { EventDispatcher } from "three";
 //#region src/gamepad-input.ts
-const DEFAULT_GAMEPAD_INPUT_OPTIONS = { deadzone: .1 };
+const DEFAULT_GAMEPAD_INPUT_OPTIONS = {
+	deadzone: .1,
+	deadzoneMode: "axial",
+	rescale: false
+};
 /**
 * Applies a dead zone and remaps the remaining magnitude to `[0, 1]`.
 *
@@ -281,11 +285,12 @@ var GamepadInput = class extends EventDispatcher {
 	* @returns Object containing processed `x` and `y` values.
 	*/
 	stick(xAxis, yAxis, options) {
-		const rescale = options?.rescale ?? false;
+		const deadzoneMode = options?.deadzoneMode ?? this.#options.deadzoneMode;
+		const rescale = options?.rescale ?? this.#options.rescale;
 		const threshold = this.#getDeadzone(options);
 		const x = this.#gamepad?.axes[xAxis] ?? 0;
 		const y = this.#gamepad?.axes[yAxis] ?? 0;
-		if (options?.deadzoneMode === "radial") return applyGamepadRadialDeadzone(x, y, threshold, rescale);
+		if (deadzoneMode === "radial") return applyGamepadRadialDeadzone(x, y, threshold, rescale);
 		return {
 			x: applyGamepadAxialDeadzone(x, threshold, rescale),
 			y: applyGamepadAxialDeadzone(y, threshold, rescale)

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { GAMEPAD_AXIS, GAMEPAD_BUTTON, GamepadAxisKey, GamepadAxisValue, GamepadButtonKey, GamepadButtonValue, MAX_GAMEPAD_INDEX, MIN_GAMEPAD_INDEX } from "./core.js";
-import { GamepadAxisOptions, GamepadInput, GamepadInputEventMap, GamepadInputOptions, GamepadStick, GamepadStickOptions } from "./gamepad-input.js";
+import { GamepadAxisOptions, GamepadDeadzoneMode, GamepadInput, GamepadInputEventMap, GamepadInputOptions, GamepadStick, GamepadStickOptions } from "./gamepad-input.js";
 import { GamepadControls, GamepadControlsEventMap, GamepadControlsOptions } from "./gamepad-controls.js";
 import { GamepadArcballControls, GamepadArcballControlsOptions } from "./gamepad-arcball-controls.js";
 import { GamepadDragControls, GamepadDragControlsOptions } from "./gamepad-drag-controls.js";
@@ -10,4 +10,4 @@ import { GamepadMapControls } from "./gamepad-map-controls.js";
 import { GamepadPointerLockControls, GamepadPointerLockControlsOptions } from "./gamepad-pointer-lock-controls.js";
 import { GamepadTrackballControls, GamepadTrackballControlsOptions } from "./gamepad-trackball-controls.js";
 import { GamepadTransformControls, GamepadTransformControlsOptions } from "./gamepad-transform-controls.js";
-export { GAMEPAD_AXIS, GAMEPAD_BUTTON, GamepadArcballControls, GamepadArcballControlsOptions, GamepadAxisKey, GamepadAxisOptions, GamepadAxisValue, GamepadButtonKey, GamepadButtonValue, GamepadControls, GamepadControlsEventMap, GamepadControlsOptions, GamepadDragControls, GamepadDragControlsOptions, GamepadFirstPersonControls, GamepadFirstPersonControlsOptions, GamepadFlyControls, GamepadFlyControlsOptions, GamepadInput, GamepadInputEventMap, GamepadInputOptions, GamepadMapControls, GamepadOrbitControls, GamepadOrbitControlsOptions, GamepadPointerLockControls, GamepadPointerLockControlsOptions, GamepadStick, GamepadStickOptions, GamepadTrackballControls, GamepadTrackballControlsOptions, GamepadTransformControls, GamepadTransformControlsOptions, MAX_GAMEPAD_INDEX, MIN_GAMEPAD_INDEX };
+export { GAMEPAD_AXIS, GAMEPAD_BUTTON, GamepadArcballControls, GamepadArcballControlsOptions, GamepadAxisKey, GamepadAxisOptions, GamepadAxisValue, GamepadButtonKey, GamepadButtonValue, GamepadControls, GamepadControlsEventMap, GamepadControlsOptions, GamepadDeadzoneMode, GamepadDragControls, GamepadDragControlsOptions, GamepadFirstPersonControls, GamepadFirstPersonControlsOptions, GamepadFlyControls, GamepadFlyControlsOptions, GamepadInput, GamepadInputEventMap, GamepadInputOptions, GamepadMapControls, GamepadOrbitControls, GamepadOrbitControlsOptions, GamepadPointerLockControls, GamepadPointerLockControlsOptions, GamepadStick, GamepadStickOptions, GamepadTrackballControls, GamepadTrackballControlsOptions, GamepadTransformControls, GamepadTransformControlsOptions, MAX_GAMEPAD_INDEX, MIN_GAMEPAD_INDEX };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "three-gamepad-controls",
   "description": "Gamepad support for Three.js controls.",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "homepage": "https://github.com/luckasnix/three-gamepad-controls#readme",
   "author": {
     "name": "Kasnix",