three-gamepad-controls 0.23.0 → 0.24.1

package/dist/gamepad-input.js

@@ -52,7 +52,9 @@ const getGamepadButtonValue = (gamepad, button) => {
 */
 var GamepadInput = class extends EventDispatcher {
 	/**
-	* When `false`, input polling is paused.
+	* When `false`, polling through `update()` is paused and the last observed
+	* state, including button transitions, is retained. Browser listeners remain
+	* active and may adopt or disconnect a gamepad; connection events may poll.
 	* @default true
 	*/
 	enabled = true;
@@ -144,6 +146,9 @@ var GamepadInput = class extends EventDispatcher {
 	}
 	/**
 	* Polls the gamepad and refreshes current and previous button state.
+	*
+	* Resuming compares against the last observed state, without replaying clicks
+	* completed during the pause. Adoption seeds held buttons without transitions.
 	*/
 	update() {
 		if (!this.enabled) return;
@@ -170,7 +175,9 @@ var GamepadInput = class extends EventDispatcher {
 		this.#syncButtonState({ seedPrevious: false });
 	}
 	/**
-	* Removes all window-level event listeners attached by this input reader.
+	* Removes this reader's window listeners, clears its state, and disables it.
+	* Does not dispatch a synthetic disconnection or affect other input readers.
+	* Reusing a disposed reader is unsupported; create a new instance instead.
 	*/
 	dispose() {
 		window.removeEventListener("gamepadconnected", this.#onGamepadConnected);
@@ -190,19 +197,21 @@ var GamepadInput = class extends EventDispatcher {
 		return this.#pressedButtons.has(button);
 	}
 	/**
-	* Returns whether a button was pressed during the latest update.
+	* Returns whether a button changed to pressed in the latest observed state.
+	* Paused updates retain this result until the next observation or cleanup.
 	*
 	* @param button - Button index to inspect.
-	* @returns `true` only on the frame where the button transitions to pressed.
+	* @returns Whether the latest observed button state transitioned to pressed.
 	*/
 	wasPressed(button) {
 		return this.#pressedButtons.has(button) && !this.#previousPressedButtons.has(button);
 	}
 	/**
-	* Returns whether a button was released during the latest update.
+	* Returns whether a button changed to released in the latest observed state.
+	* Paused updates retain this result until the next observation or cleanup.
 	*
 	* @param button - Button index to inspect.
-	* @returns `true` only on the frame where the button transitions to released.
+	* @returns Whether the latest observed button state transitioned to released.
 	*/
 	wasReleased(button) {
 		return !this.#pressedButtons.has(button) && this.#previousPressedButtons.has(button);

package/dist/gamepad-manager.js

@@ -68,8 +68,10 @@ var GamepadManager = class {
 	/**
 	* Polls the Gamepad API and refreshes the active gamepad snapshot.
 	*
-	* Polling re-resolves the browser slot so a disconnected device, a reused
-	* index, or an updated active device is observed before consumers read input.
+	* Polling refreshes the active slot without treating changes in object
+	* reference, `id`, or `timestamp` as reconnections. A missing or disconnected
+	* slot reports only a disconnection; adoption waits until the next update.
+	* Physical replacements without an observed loss cannot be distinguished.
 	*
 	* @returns The active gamepad and any connect/disconnect transition found.
 	*/

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

@@ -9,7 +9,7 @@ import { MapControls } from "three/addons/controls/MapControls.js";
  *
  * Call `update()` inside the render loop **before** `MapControls.update()`.
  */
-declare class GamepadMapControls extends GamepadOrbitControls {
+export declare class GamepadMapControls extends GamepadOrbitControls {
   /**
    * @param controls - A Three.js `MapControls` instance.
    * @param options - Optional overrides for the default behavior.
@@ -17,5 +17,4 @@ declare class GamepadMapControls extends GamepadOrbitControls {
    */
   constructor(controls: MapControls, options?: Partial<GamepadOrbitControlsOptions>);
 }
-//#endregion
-export { GamepadMapControls };
+//#endregion

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

@@ -7,7 +7,7 @@ import { OrbitControls } from "three/addons/controls/OrbitControls.js";
  *
  * Every property has a sensible default, so you only need to pass the properties you want to override.
  */
-type GamepadOrbitControlsOptions = GamepadControlsOptions & {
+export type GamepadOrbitControlsOptions = GamepadControlsOptions & {
   /**
    * Multiplier on orbit rotation speed.
    * @default 1.0
@@ -55,7 +55,7 @@ type GamepadOrbitControlsOptions = GamepadControlsOptions & {
  * Call `update()` inside the render loop **before** `OrbitControls.update()`.
  * Bindings and speeds are configurable via {@link GamepadOrbitControlsOptions}.
  */
-declare class GamepadOrbitControls extends GamepadControls {
+export declare class GamepadOrbitControls extends GamepadControls {
   #private;
   /**
    * @param controls - A Three.js `OrbitControls` instance.
@@ -70,5 +70,4 @@ declare class GamepadOrbitControls extends GamepadControls {
    */
   protected onUpdate(deltaTime: number): void;
 }
-//#endregion
-export { GamepadOrbitControls, GamepadOrbitControlsOptions };
+//#endregion

package/dist/gamepad-orbit-controls.js

@@ -50,17 +50,34 @@ var GamepadOrbitControls = class extends GamepadControls {
 	* @param deltaTime - Seconds since the last frame.
 	*/
 	onUpdate(deltaTime) {
+		if (!this.#canApplyInput()) return;
+		const controls = this.#controls;
 		const { rotateSpeed, panSpeed, zoomSpeed, rotateStick, panStick, buttonDeadzone, buttonDollyIn, buttonDollyOut } = this.#options;
 		const input = this.gamepadInput;
 		const rotate = input.stick(rotateStick.xAxis, rotateStick.yAxis, rotateStick.pipeline);
-		if (rotate.x !== 0) this.#controls.rotateLeft(rotate.x * rotateSpeed * deltaTime * Math.PI);
-		if (rotate.y !== 0) this.#controls.rotateUp(rotate.y * rotateSpeed * deltaTime * Math.PI);
+		if (controls.enableRotate && rotate.x !== 0) {
+			controls.rotateLeft(rotate.x * rotateSpeed * deltaTime * Math.PI);
+			if (!this.#canApplyInput()) return;
+		}
+		if (controls.enableRotate && rotate.y !== 0) {
+			controls.rotateUp(rotate.y * rotateSpeed * deltaTime * Math.PI);
+			if (!this.#canApplyInput()) return;
+		}
 		const pan = input.stick(panStick.xAxis, panStick.yAxis, panStick.pipeline);
-		if (pan.x !== 0 || pan.y !== 0) this.#controls.pan(pan.x * panSpeed * deltaTime * 500, pan.y * panSpeed * deltaTime * 500);
+		if (controls.enablePan && (pan.x !== 0 || pan.y !== 0)) {
+			controls.pan(pan.x * panSpeed * deltaTime * 500, pan.y * panSpeed * deltaTime * 500);
+			if (!this.#canApplyInput()) return;
+		}
 		const triggerIn = input.buttonValue(buttonDollyIn);
 		const triggerOut = input.buttonValue(buttonDollyOut);
-		if (triggerIn > buttonDeadzone) this.#controls.dollyIn(1 / (1 + zoomSpeed * triggerIn * deltaTime));
-		if (triggerOut > buttonDeadzone) this.#controls.dollyOut(1 / (1 + zoomSpeed * triggerOut * deltaTime));
+		if (controls.enableZoom && triggerIn > buttonDeadzone) {
+			controls.dollyIn(1 / (1 + zoomSpeed * triggerIn * deltaTime));
+			if (!this.#canApplyInput()) return;
+		}
+		if (controls.enableZoom && triggerOut > buttonDeadzone) controls.dollyOut(1 / (1 + zoomSpeed * triggerOut * deltaTime));
+	}
+	#canApplyInput() {
+		return this.enabled && this.#controls.enabled && this.gamepad !== null;
 	}
 };
 //#endregion

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

@@ -7,7 +7,7 @@ import { PointerLockControls } from "three/addons/controls/PointerLockControls.j
  *
  * Every property has a sensible default, so you only need to pass the properties you want to override.
  */
-type GamepadPointerLockControlsOptions = GamepadControlsOptions & {
+export type GamepadPointerLockControlsOptions = GamepadControlsOptions & {
   /**
    * Camera movement speed in world units per second at full stick deflection.
    * @default 5.0
@@ -36,7 +36,7 @@ type GamepadPointerLockControlsOptions = GamepadControlsOptions & {
  * IS locked, mouse and gamepad look inputs are additive.
  * Bindings and speeds are configurable via {@link GamepadPointerLockControlsOptions}.
  */
-declare class GamepadPointerLockControls extends GamepadControls {
+export declare class GamepadPointerLockControls extends GamepadControls {
   #private;
   /**
    * @param controls - A Three.js `PointerLockControls` instance.
@@ -51,5 +51,4 @@ declare class GamepadPointerLockControls extends GamepadControls {
    */
   protected onUpdate(deltaTime: number): void;
 }
-//#endregion
-export { GamepadPointerLockControls, GamepadPointerLockControlsOptions };
+//#endregion

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

@@ -50,6 +50,7 @@ var GamepadPointerLockControls = class extends GamepadControls {
 	* @param deltaTime - Seconds since the last frame.
 	*/
 	onUpdate(deltaTime) {
+		if (!this.#controls.enabled) return;
 		const { moveSpeed, lookSpeed, moveStick, lookStick } = this.#options;
 		const input = this.gamepadInput;
 		const move = input.stick(moveStick.xAxis, moveStick.yAxis, moveStick.pipeline);

package/dist/gamepad-stick-processing.d.ts

@@ -5,19 +5,19 @@
  * Axial processing transforms each component independently. Radial processing
  * transforms vector magnitude while preserving direction.
  */
-type GamepadStickProcessingMode = "axial" | "radial";
+export type GamepadStickProcessingMode = "axial" | "radial";
 /**
  * Built-in response curve applied to stick components or magnitude.
  */
-type GamepadResponseCurve = "linear" | "quadratic" | "cubic";
+export type GamepadResponseCurve = "linear" | "quadratic" | "cubic";
 /**
  * Stick component selection used by inversion processing.
  */
-type GamepadStickInversionAxis = "x" | "y" | "both";
+export type GamepadStickInversionAxis = "x" | "y" | "both";
 /**
  * Two-dimensional gamepad stick value.
  */
-type GamepadStick = {
+export type GamepadStick = {
   /**
    * Horizontal stick component.
    */
@@ -30,14 +30,14 @@ type GamepadStick = {
 /**
  * Pure custom transformation applied to a gamepad stick.
  */
-type GamepadStickTransform = (value: Readonly<GamepadStick>) => GamepadStick;
+export type GamepadStickTransform = (value: Readonly<GamepadStick>) => GamepadStick;
 /**
  * Pure, stateless transformation applied to a gamepad stick.
  *
  * Implementations must not mutate `value`. Stateful processing such as
  * smoothing belongs in a separate lifecycle-aware abstraction.
  */
-type GamepadStickProcessor = {
+export type GamepadStickProcessor = {
   /**
    * Transforms one stick value.
    *
@@ -49,7 +49,7 @@ type GamepadStickProcessor = {
 /**
  * Options for {@link gamepadStickPipeline}.
  */
-type GamepadStickPipelineOptions = {
+export type GamepadStickPipelineOptions = {
   /**
    * Default geometry for processing methods that support axial and radial modes.
    * @default "axial"
@@ -59,7 +59,7 @@ type GamepadStickPipelineOptions = {
 /**
  * Options for {@link GamepadStickPipeline.deadzone}.
  */
-type GamepadDeadzoneOptions = {
+export type GamepadDeadzoneOptions = {
   /**
    * Geometry for this dead zone, overriding the pipeline default.
    */
@@ -73,7 +73,7 @@ type GamepadDeadzoneOptions = {
 /**
  * Options for {@link GamepadStickPipeline.responseCurve}.
  */
-type GamepadResponseCurveOptions = {
+export type GamepadResponseCurveOptions = {
   /**
    * Geometry for this response curve, overriding the pipeline default.
    */
@@ -85,7 +85,7 @@ type GamepadResponseCurveOptions = {
  * Every configuration method returns a new frozen pipeline and leaves the
  * current pipeline unchanged.
  */
-type GamepadStickPipeline = GamepadStickProcessor & {
+export type GamepadStickPipeline = GamepadStickProcessor & {
   /**
    * Appends an axial or radial dead zone.
    *
@@ -129,7 +129,7 @@ type GamepadStickPipeline = GamepadStickProcessor & {
  *
  * Omitted fields inherit the action-specific defaults.
  */
-type GamepadStickBindingOptions = {
+export type GamepadStickBindingOptions = {
   /**
    * Axis index used as the horizontal component.
    */
@@ -146,7 +146,7 @@ type GamepadStickBindingOptions = {
 /**
  * Fully resolved binding used when reading a two-dimensional stick action.
  */
-type GamepadStickBinding = Required<GamepadStickBindingOptions>;
+export type GamepadStickBinding = Required<GamepadStickBindingOptions>;
 /**
  * Creates an immutable, fluent stick processing pipeline.
  *
@@ -157,11 +157,11 @@ type GamepadStickBinding = Required<GamepadStickBindingOptions>;
  * @param options - Optional pipeline defaults.
  * @returns Frozen stick pipeline.
  */
-declare const gamepadStickPipeline: (options?: GamepadStickPipelineOptions) => GamepadStickPipeline;
+export declare const gamepadStickPipeline: (options?: GamepadStickPipelineOptions) => GamepadStickPipeline;
 /**
  * Historical stick processing used when no custom pipeline is supplied.
  */
-declare const DEFAULT_GAMEPAD_STICK_PIPELINE: GamepadStickPipeline;
+export declare const DEFAULT_GAMEPAD_STICK_PIPELINE: GamepadStickPipeline;
 /**
  * Resolves a partial stick binding over an action-specific default.
  *
@@ -169,6 +169,5 @@ declare const DEFAULT_GAMEPAD_STICK_PIPELINE: GamepadStickPipeline;
  * @param options - Optional binding overrides.
  * @returns Complete resolved binding.
  */
-declare const resolveGamepadStickBinding: (defaults: GamepadStickBinding, options?: GamepadStickBindingOptions) => GamepadStickBinding;
-//#endregion
-export { DEFAULT_GAMEPAD_STICK_PIPELINE, GamepadDeadzoneOptions, GamepadResponseCurve, GamepadResponseCurveOptions, GamepadStick, GamepadStickBinding, GamepadStickBindingOptions, GamepadStickInversionAxis, GamepadStickPipeline, GamepadStickPipelineOptions, GamepadStickProcessingMode, GamepadStickProcessor, GamepadStickTransform, gamepadStickPipeline, resolveGamepadStickBinding };
+export declare const resolveGamepadStickBinding: (defaults: GamepadStickBinding, options?: GamepadStickBindingOptions) => GamepadStickBinding;
+//#endregion

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

@@ -7,7 +7,7 @@ import { TrackballControls } from "three/addons/controls/TrackballControls.js";
  *
  * Every property has a sensible default, so you only need to pass the properties you want to override.
  */
-type GamepadTrackballControlsOptions = GamepadControlsOptions & {
+export type GamepadTrackballControlsOptions = GamepadControlsOptions & {
   /**
    * Multiplier on `TrackballControls.rotateSpeed` for rotation.
    * @default 1.0
@@ -55,7 +55,7 @@ type GamepadTrackballControlsOptions = GamepadControlsOptions & {
  * Call `update()` inside the render loop **before** `TrackballControls.update()`.
  * Bindings and speed multipliers are configurable via {@link GamepadTrackballControlsOptions}.
  */
-declare class GamepadTrackballControls extends GamepadControls {
+export declare class GamepadTrackballControls extends GamepadControls {
   #private;
   /**
    * @param controls - A Three.js `TrackballControls` instance.
@@ -70,5 +70,4 @@ declare class GamepadTrackballControls extends GamepadControls {
    */
   protected onUpdate(deltaTime: number): void;
 }
-//#endregion
-export { GamepadTrackballControls, GamepadTrackballControlsOptions };
+//#endregion

package/dist/gamepad-trackball-controls.js

@@ -50,6 +50,7 @@ var GamepadTrackballControls = class extends GamepadControls {
 	* @param deltaTime - Seconds since the last frame.
 	*/
 	onUpdate(deltaTime) {
+		if (!this.#controls.enabled) return;
 		const { rotateSpeed, panSpeed, zoomSpeed, rotateStick, panStick, buttonDeadzone, buttonZoomIn, buttonZoomOut } = this.#options;
 		this.#queueRotation(deltaTime, rotateSpeed, rotateStick);
 		this.#queuePan(deltaTime, panSpeed, panStick);
@@ -64,11 +65,7 @@ var GamepadTrackballControls = class extends GamepadControls {
 	*/
 	#queueRotation(deltaTime, rotateSpeed, rotateStick) {
 		const controls = this.#controls;
-		if (controls.noRotate) {
-			controls._movePrev.copy(controls._moveCurr);
-			controls._lastAngle = 0;
-			return;
-		}
+		if (controls.noRotate) return;
 		const rotate = this.gamepadInput.stick(rotateStick.xAxis, rotateStick.yAxis, rotateStick.pipeline);
 		if (rotate.x === 0 && rotate.y === 0) return;
 		const scale = rotateSpeed * deltaTime * Math.PI;
@@ -84,10 +81,7 @@ var GamepadTrackballControls = class extends GamepadControls {
 	*/
 	#queuePan(deltaTime, panSpeed, panStick) {
 		const controls = this.#controls;
-		if (controls.noPan) {
-			controls._panStart.copy(controls._panEnd);
-			return;
-		}
+		if (controls.noPan) return;
 		const pan = this.gamepadInput.stick(panStick.xAxis, panStick.yAxis, panStick.pipeline);
 		if (pan.x === 0 && pan.y === 0) return;
 		const scale = panSpeed * deltaTime * this.#getInputDampingFactor();
@@ -105,10 +99,7 @@ var GamepadTrackballControls = class extends GamepadControls {
 	*/
 	#queueZoom(deltaTime, zoomSpeed, buttonDeadzone, buttonZoomIn, buttonZoomOut) {
 		const controls = this.#controls;
-		if (controls.noZoom) {
-			controls._zoomStart.copy(controls._zoomEnd);
-			return;
-		}
+		if (controls.noZoom) return;
 		const input = this.gamepadInput;
 		const triggerIn = input.buttonValue(buttonZoomIn);
 		const triggerOut = input.buttonValue(buttonZoomOut);

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

@@ -7,7 +7,7 @@ import { TransformControls } from "three/addons/controls/TransformControls.js";
  *
  * Every property has a sensible default, so you only need to pass the properties you want to override.
  */
-type GamepadTransformControlsOptions = GamepadControlsOptions & {
+export type GamepadTransformControlsOptions = GamepadControlsOptions & {
   /**
    * Screen-relative translation speed multiplier.
    * @default 1.0
@@ -91,7 +91,7 @@ type GamepadTransformControlsOptions = GamepadControlsOptions & {
  * stick starts a native-style transform interaction, and releasing it ends
  * the interaction while keeping the active axis highlighted.
  */
-declare class GamepadTransformControls extends GamepadControls {
+export declare class GamepadTransformControls extends GamepadControls {
   #private;
   /**
    * @param controls - A Three.js `TransformControls` instance.
@@ -107,7 +107,7 @@ declare class GamepadTransformControls extends GamepadControls {
    */
   protected onUpdate(deltaTime: number): void;
   /**
-   * Ends any active transform before disposing the gamepad lifecycle listeners.
+   * Disables gamepad updates and ends only this wrapper's active transform.
    */
   dispose(): void;
   /**
@@ -117,5 +117,4 @@ declare class GamepadTransformControls extends GamepadControls {
    */
   protected onGamepadDisconnected(gamepad: Gamepad): void;
 }
-//#endregion
-export { GamepadTransformControls, GamepadTransformControlsOptions };
+//#endregion

package/dist/gamepad-transform-controls.js

@@ -100,6 +100,7 @@ var GamepadTransformControls = class extends GamepadControls {
 	#rotationQuaternion2;
 	#tempQuaternion;
 	#isTransforming = false;
+	#transformStarted = false;
 	#rotationAmount = 0;
 	#freeRotationX = 0;
 	#freeRotationY = 0;
@@ -158,16 +159,21 @@ var GamepadTransformControls = class extends GamepadControls {
 	* @param deltaTime - Seconds since the last frame.
 	*/
 	onUpdate(deltaTime) {
+		const controls = this.#controls;
+		if (!this.#canApplyInput()) return;
+		if (controls.dragging && !this.#isTransforming) return;
 		const startedButtons = this.#getStartedButtons();
 		this.#handleModeAndAxisButtons(startedButtons);
+		if (!this.#canApplyInput()) return;
 		if (startedButtons.has(this.#options.buttonReset)) this.#resetActiveTransform();
-		const controls = this.#controls;
+		if (!this.#canApplyInput()) return;
 		const object = controls.object;
-		if (!controls.enabled || object === void 0) {
+		if (object === void 0) {
 			this.#endTransform(true);
 			return;
 		}
 		const axis = this.#ensureValidAxis();
+		if (!this.#canApplyInput()) return;
 		if (axis === null) {
 			this.#endTransform(true);
 			return;
@@ -179,17 +185,26 @@ var GamepadTransformControls = class extends GamepadControls {
 			return;
 		}
 		if (!this.#isTransforming) this.#startTransform(object);
+		if (!this.#canApplyInput()) return;
+		if (!this.#transformStarted) {
+			this.#transformStarted = true;
+			controls.dispatchEvent({
+				type: "mouseDown",
+				mode: controls.mode
+			});
+		}
+		if (!this.#canApplyInput()) return;
 		if (this.#applyCurrentTransform(object, axis, deltaTime, transform.x, transform.y)) {
 			controls.dispatchEvent({ type: "change" });
 			controls.dispatchEvent({ type: "objectChange" });
 		}
 	}
 	/**
-	* Ends any active transform before disposing the gamepad lifecycle listeners.
+	* Disables gamepad updates and ends only this wrapper's active transform.
 	*/
 	dispose() {
-		this.#endTransform(true);
 		super.dispose();
+		this.#endTransform(true);
 	}
 	/**
 	* Ends any active transform if the active gamepad disconnects mid-drag.
@@ -200,6 +215,13 @@ var GamepadTransformControls = class extends GamepadControls {
 		this.#endTransform(true);
 		super.onGamepadDisconnected(gamepad);
 	}
+	#canApplyInput() {
+		if (!this.#controls.enabled) {
+			this.#endTransform(true);
+			return false;
+		}
+		return this.enabled && this.gamepad !== null;
+	}
 	/**
 	* Applies mode, space, and axis button transitions from the current frame.
 	*
@@ -207,16 +229,16 @@ var GamepadTransformControls = class extends GamepadControls {
 	*/
 	#handleModeAndAxisButtons(startedButtons) {
 		const { buttonTranslate, buttonRotate, buttonScale, buttonToggleSpace, buttonAxisX, buttonAxisY, buttonAxisZ, buttonAxisComposite, buttonAxisPrevious, buttonAxisNext } = this.#options;
-		if (startedButtons.has(buttonTranslate)) this.#setMode("translate");
-		if (startedButtons.has(buttonRotate)) this.#setMode("rotate");
-		if (startedButtons.has(buttonScale)) this.#setMode("scale");
-		if (startedButtons.has(buttonToggleSpace)) this.#toggleSpace();
-		if (startedButtons.has(buttonAxisX)) this.#selectAxis("X");
-		if (startedButtons.has(buttonAxisY)) this.#selectAxis("Y");
-		if (startedButtons.has(buttonAxisZ)) this.#selectAxis("Z");
-		if (startedButtons.has(buttonAxisComposite)) this.#cycleCompositeAxis();
-		if (startedButtons.has(buttonAxisPrevious)) this.#cycleAxis(-1);
-		if (startedButtons.has(buttonAxisNext)) this.#cycleAxis(1);
+		if (startedButtons.has(buttonTranslate) && this.#canApplyInput()) this.#setMode("translate");
+		if (startedButtons.has(buttonRotate) && this.#canApplyInput()) this.#setMode("rotate");
+		if (startedButtons.has(buttonScale) && this.#canApplyInput()) this.#setMode("scale");
+		if (startedButtons.has(buttonToggleSpace) && this.#canApplyInput()) this.#toggleSpace();
+		if (startedButtons.has(buttonAxisX) && this.#canApplyInput()) this.#selectAxis("X");
+		if (startedButtons.has(buttonAxisY) && this.#canApplyInput()) this.#selectAxis("Y");
+		if (startedButtons.has(buttonAxisZ) && this.#canApplyInput()) this.#selectAxis("Z");
+		if (startedButtons.has(buttonAxisComposite) && this.#canApplyInput()) this.#cycleCompositeAxis();
+		if (startedButtons.has(buttonAxisPrevious) && this.#canApplyInput()) this.#cycleAxis(-1);
+		if (startedButtons.has(buttonAxisNext) && this.#canApplyInput()) this.#cycleAxis(1);
 	}
 	/**
 	* Switches TransformControls mode and refreshes the active axis.
@@ -226,12 +248,14 @@ var GamepadTransformControls = class extends GamepadControls {
 	#setMode(mode) {
 		if (this.#controls.mode === mode) return;
 		this.#endTransform(false);
+		if (!this.#canApplyInput()) return;
 		this.#controls.setMode(mode);
-		this.#ensureValidAxis();
+		if (this.#canApplyInput()) this.#ensureValidAxis();
 	}
 	#toggleSpace() {
 		const nextSpace = this.#controls.space === "world" ? "local" : "world";
 		this.#endTransform(false);
+		if (!this.#canApplyInput()) return;
 		this.#controls.setSpace(nextSpace);
 	}
 	/**
@@ -242,6 +266,7 @@ var GamepadTransformControls = class extends GamepadControls {
 	#selectAxis(axis) {
 		if (!this.#isAxisAllowed(this.#controls.mode, axis)) return;
 		this.#endTransform(false);
+		if (!this.#canApplyInput()) return;
 		this.#activeAxisByMode[this.#controls.mode] = axis;
 		this.#ensureValidAxis();
 	}
@@ -269,6 +294,7 @@ var GamepadTransformControls = class extends GamepadControls {
 			return;
 		}
 		this.#endTransform(false);
+		if (!this.#canApplyInput()) return;
 		const current = this.#activeAxisByMode[this.#controls.mode];
 		const currentIndex = current === null ? -1 : axes.indexOf(current);
 		const nextIndex = currentIndex === -1 ? 0 : (currentIndex + direction + axes.length) % axes.length;
@@ -356,12 +382,8 @@ var GamepadTransformControls = class extends GamepadControls {
 	#startTransform(object) {
 		const controls = this.#controls;
 		this.#captureTransformStart(object);
-		controls.dragging = true;
 		this.#isTransforming = true;
-		controls.dispatchEvent({
-			type: "mouseDown",
-			mode: controls.mode
-		});
+		controls.dragging = true;
 	}
 	/**
 	* Ends an active TransformControls drag interaction.
@@ -369,15 +391,17 @@ var GamepadTransformControls = class extends GamepadControls {
 	* @param clearAxis - Whether to clear the highlighted axis after ending.
 	*/
 	#endTransform(clearAxis) {
+		if (!this.#isTransforming) return;
 		const controls = this.#controls;
-		if (this.#isTransforming) {
-			this.#isTransforming = false;
-			controls.dispatchEvent({
-				type: "mouseUp",
-				mode: controls.mode
-			});
-			controls.dragging = false;
-		}
+		const started = this.#transformStarted;
+		const mode = controls.mode;
+		this.#isTransforming = false;
+		this.#transformStarted = false;
+		if (started) controls.dispatchEvent({
+			type: "mouseUp",
+			mode
+		});
+		controls.dragging = false;
 		if (clearAxis) this.#setActiveAxis(null);
 	}
 	#resetActiveTransform() {

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "three-gamepad-controls",
   "description": "Gamepad support for Three.js controls.",
-  "version": "0.23.0",
+  "version": "0.24.1",
+  "license": "MIT",
   "homepage": "https://github.com/luckasnix/three-gamepad-controls#readme",
   "author": {
     "name": "Kasnix",
@@ -34,7 +35,6 @@
     "controls",
     "gamepad"
   ],
-  "license": "MIT",
   "publishConfig": {
     "access": "public"
   },
@@ -46,23 +46,24 @@
     }
   },
   "devDependencies": {
-    "@biomejs/biome": "2.5.11",
-    "@commitlint/cli": "21.2.2",
-    "@commitlint/config-conventional": "21.2.2",
-    "@commitlint/types": "21.2.0",
+    "@biomejs/biome": "2.5.14",
+    "@commitlint/cli": "21.2.3",
+    "@commitlint/config-conventional": "21.2.3",
+    "@commitlint/types": "21.2.3",
     "@types/node": "24.13.3",
-    "@types/three": "0.185.0",
-    "@vitest/coverage-v8": "5.0.0",
+    "@types/three": "0.186.0",
+    "@vitest/browser-playwright": "5.0.2",
+    "@vitest/coverage-v8": "5.0.2",
     "husky": "9.1.7",
-    "jsdom": "29.1.1",
-    "three": "0.185.0",
-    "tsdown": "0.22.14",
+    "playwright": "1.63.0",
+    "three": "0.186.0",
+    "tsdown": "0.23.0",
     "typescript": "7.0.2",
-    "vitest": "5.0.0"
+    "vitest": "5.0.2"
   },
   "peerDependencies": {
-    "@types/three": "~0.185.0",
-    "three": "~0.185.0"
+    "@types/three": "~0.186.0",
+    "three": "~0.186.0"
   },
   "scripts": {
     "build": "tsc && tsdown",

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Lucas Alves Costa
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.