CameraControls rework (Input/Controller overhaul)

[kpal81xd]

Overview

This PR aims to split the camera controls down into two core components:

• Input Sources which represent a collection of deltas generated from one or more input devices. These can range from a mouse movement delta to a gamepad joystick delta.
• Input Controllers which represent the constrained transformations that are to be performed e.g. orbiting around a particular focus point or camera flying (unconstrained) .

Together the deltas from an Input can be collected into a "frame" of deltas which are then applied to the specified controller to perform the required action.

Input Sources

SingleGestureSource - Single touch or virtual joystick input
DualGestureSource - Split screen touch or virtual joystick input
MultiTouchSource - Multi touch input (includes pinch handling)
KeyboardMouseSource - Keyboard and mouse input
GamepadSource - Game pad input

Input Controllers

FlyController - Applies free-fly mechanics to a base transform
OrbitController - Applies orbiting mechanics to a base transform

Design Doc

https://docs.google.com/document/d/1r2ywuzxbte6DwlEJzWgyD-fTDNyp-7P0PKLFefrgV9Y/edit?usp=sharing

[Copilot]

Pull Request Overview

This PR refactors the camera controls system by separating input handling into distinct sources (touch, joystick, keyboard/mouse, gamepad) and controllers (fly and orbit), while updating example applications to use the new interface.

• Introduces dedicated classes for various input sources with coordinated delta‐calculation logic.
• Refactors camera controller examples to use updated API properties (e.g. using “cc” instead of “cameraControls”) and integrates joystick-based UI events.
• Updates input controller (FlyController) with damping and smoothing configurations.

Reviewed Changes

Copilot reviewed 18 out of 18 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
src/extras/input/sources/virtual-joystick.js	Implements virtual joystick input with delta clamping logic.
src/extras/input/sources/single-gesture-source.js	Adds support for single-touch/joystick input handling.
src/extras/input/sources/multi-touch-source.js	Implements multi-touch handling with pinch and pan support.
src/extras/input/sources/keyboard-mouse-source.js	Defines keyboard and mouse input with custom button state transitions.
src/extras/input/sources/gamepad-source.js	Provides gamepad input support by reading axes.
src/extras/input/sources/dual-gesture-source.js	Implements dual gesture input combining two input modes based on screen side.
src/extras/input/input.js	Defines common input delta and source base classes.
src/extras/input/controllers/fly-controller.js	Refactors fly controller with damping and smoothing transform logic.
src/extras/index.js	Updates exports to include the new input and controller modules.
examples/*	Updates various example files to integrate the refactored camera and input system APIs.

Comments suppressed due to low confidence (1)

src/extras/input/sources/keyboard-mouse-source.js:154

• [nitpick] Consider adding a comment explaining why a released button state is represented by -1 (as opposed to 0), to clarify the intended semantics of the _button array for future maintainers.

if (this._button[i] === 1) { this._button[i] = -1; continue; }