three-gamepad-controls 0.24.0 → 0.24.2

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