three-gamepad-controls 0.17.0 → 0.18.0

package/dist/gamepad-input.d.ts

@@ -46,6 +46,16 @@ type GamepadInputOptions = {
    * @default false
    */
   rescale: boolean;
+  /**
+   * Whether the horizontal component of stick reads is inverted by default.
+   * @default false
+   */
+  invertX: boolean;
+  /**
+   * Whether the vertical component of stick reads is inverted by default.
+   * @default false
+   */
+  invertY: boolean;
   /**
    * Browser-assigned gamepad slot to use.
    *
@@ -83,17 +93,27 @@ type GamepadStickOptions = GamepadAxisOptions & {
    * @default false
    */
   rescale?: boolean;
+  /**
+   * Whether to invert the processed component from `xAxis`.
+   * @default false
+   */
+  invertX?: boolean;
+  /**
+   * Whether to invert the processed component from `yAxis`.
+   * @default false
+   */
+  invertY?: boolean;
 };
 /**
- * Two-dimensional stick input after dead zone processing.
+ * Two-dimensional stick input after configured stick processing.
  */
 type GamepadStick = {
   /**
-   * Horizontal stick value.
+   * Processed horizontal stick value.
    */
   x: number;
   /**
-   * Vertical stick value.
+   * Processed vertical stick value.
    */
   y: number;
 };
@@ -194,7 +214,7 @@ declare class GamepadInput extends EventDispatcher<GamepadInputEventMap> {
    */
   axis(axis: number, options?: GamepadAxisOptions): number;
   /**
-   * Returns a two-axis stick after dead zone processing.
+   * Returns a two-axis stick after dead zone, rescale, and inversion processing.
    *
    * @param xAxis - Horizontal axis index.
    * @param yAxis - Vertical axis index.

package/dist/gamepad-input.js

@@ -5,7 +5,9 @@ import { EventDispatcher } from "three";
 const DEFAULT_GAMEPAD_INPUT_OPTIONS = {
 	deadzone: .1,
 	deadzoneMode: "axial",
-	rescale: false
+	rescale: false,
+	invertX: false,
+	invertY: false
 };
 /**
 * Applies a dead zone and remaps the remaining magnitude to `[0, 1]`.
@@ -277,7 +279,7 @@ var GamepadInput = class extends EventDispatcher {
 		return applyGamepadAxialDeadzone(value, this.#getDeadzone(options), false);
 	}
 	/**
-	* Returns a two-axis stick after dead zone processing.
+	* Returns a two-axis stick after dead zone, rescale, and inversion processing.
 	*
 	* @param xAxis - Horizontal axis index.
 	* @param yAxis - Vertical axis index.
@@ -287,14 +289,20 @@ var GamepadInput = class extends EventDispatcher {
 	stick(xAxis, yAxis, options) {
 		const deadzoneMode = options?.deadzoneMode ?? this.#options.deadzoneMode;
 		const rescale = options?.rescale ?? this.#options.rescale;
+		const invertX = options?.invertX ?? this.#options.invertX;
+		const invertY = options?.invertY ?? this.#options.invertY;
 		const threshold = this.#getDeadzone(options);
 		const x = this.#gamepad?.axes[xAxis] ?? 0;
 		const y = this.#gamepad?.axes[yAxis] ?? 0;
-		if (deadzoneMode === "radial") return applyGamepadRadialDeadzone(x, y, threshold, rescale);
-		return {
+		const processed = deadzoneMode === "radial" ? applyGamepadRadialDeadzone(x, y, threshold, rescale) : {
 			x: applyGamepadAxialDeadzone(x, threshold, rescale),
 			y: applyGamepadAxialDeadzone(y, threshold, rescale)
 		};
+		if (!invertX && !invertY) return processed;
+		return {
+			x: processed.x === 0 ? 0 : invertX ? -processed.x : processed.x,
+			y: processed.y === 0 ? 0 : invertY ? -processed.y : processed.y
+		};
 	}
 	/**
 	* Plays an effect through the active gamepad's primary vibration actuator.

package/package.json

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