@codexo/exojs 0.7.12 → 0.8.0

package/dist/esm/input/GamepadPromptLayouts.js

@@ -1,4 +1,4 @@
-import { GamepadChannel } from './GamepadChannels.js';
+import { GamepadButton } from './GamepadButton.js';
 import { GamepadMappingFamily } from './GamepadMapping.js';
 
 const basePositions = new Map([
@@ -21,22 +21,22 @@ const basePositions = new Map([
     ['RightStick', [0.62, 0.66]],
 ]);
 const channelMap = new Map([
-    ['ButtonNorth', GamepadChannel.ButtonNorth],
-    ['ButtonWest', GamepadChannel.ButtonWest],
-    ['ButtonEast', GamepadChannel.ButtonEast],
-    ['ButtonSouth', GamepadChannel.ButtonSouth],
-    ['LeftShoulder', GamepadChannel.LeftShoulder],
-    ['RightShoulder', GamepadChannel.RightShoulder],
-    ['LeftTrigger', GamepadChannel.LeftTrigger],
-    ['RightTrigger', GamepadChannel.RightTrigger],
-    ['Select', GamepadChannel.Select],
-    ['Start', GamepadChannel.Start],
-    ['LeftStick', GamepadChannel.LeftStick],
-    ['RightStick', GamepadChannel.RightStick],
-    ['DPadUp', GamepadChannel.DPadUp],
-    ['DPadDown', GamepadChannel.DPadDown],
-    ['DPadLeft', GamepadChannel.DPadLeft],
-    ['DPadRight', GamepadChannel.DPadRight],
+    ['ButtonNorth', GamepadButton.North],
+    ['ButtonWest', GamepadButton.West],
+    ['ButtonEast', GamepadButton.East],
+    ['ButtonSouth', GamepadButton.South],
+    ['LeftShoulder', GamepadButton.LeftShoulder],
+    ['RightShoulder', GamepadButton.RightShoulder],
+    ['LeftTrigger', GamepadButton.LeftTrigger],
+    ['RightTrigger', GamepadButton.RightTrigger],
+    ['Select', GamepadButton.Select],
+    ['Start', GamepadButton.Start],
+    ['LeftStick', GamepadButton.LeftStick],
+    ['RightStick', GamepadButton.RightStick],
+    ['DPadUp', GamepadButton.DPadUp],
+    ['DPadDown', GamepadButton.DPadDown],
+    ['DPadLeft', GamepadButton.DPadLeft],
+    ['DPadRight', GamepadButton.DPadRight],
 ]);
 const genericLabels = new Map([
     ['ButtonNorth', 'North'],
@@ -103,6 +103,7 @@ const promptLabelsByFamily = new Map([
     [GamepadMappingFamily.JoyConRight, switchLabels],
     [GamepadMappingFamily.GameCube, genericLabels],
     [GamepadMappingFamily.SteamController, genericLabels],
+    [GamepadMappingFamily.SteamDeck, genericLabels],
     [GamepadMappingFamily.ArcadeStick, genericLabels],
 ]);
 /**
@@ -111,7 +112,7 @@ const promptLabelsByFamily = new Map([
  * Provides the canonical set of prompt controls, their normalised [x, y] positions
  * on a generic controller silhouette, device-family label strings (e.g. "A" for
  * Xbox, "Cross" for PlayStation, "B" for Switch), and the mapping from prompt
- * control names to {@link GamepadChannel} values.
+ * control names to {@link GamepadButton} channel values.
  */
 class GamepadPromptLayouts {
     /** Complete ordered list of every {@link GamepadPromptControl} token. */
@@ -152,8 +153,8 @@ class GamepadPromptLayouts {
     }
     /**
      * Returns the static mapping from each {@link GamepadPromptControl} to its
-     * corresponding {@link GamepadChannel}. The composite `'DPad'` control has no
-     * channel entry and is absent from the returned map.
+     * corresponding {@link GamepadButton} channel. The composite `'DPad'`
+     * control has no channel entry and is absent from the returned map.
      */
     static getControlChannelMap() {
         return channelMap;

package/dist/esm/input/GamepadPromptLayouts.js.map

@@ -1 +1 @@
-{"version":3,"file":"GamepadPromptLayouts.js","sources":["../../../../src/input/GamepadPromptLayouts.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"GamepadPromptLayouts.js","sources":["../../../../src/input/GamepadPromptLayouts.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/input/GenericDualAnalogGamepadMapping.d.ts

@@ -3,9 +3,12 @@ import { GamepadMapping, GamepadMappingFamily } from './GamepadMapping';
  * Baseline mapping for dual-analog controllers that follow the standard
  * W3C Gamepad API layout (axes 0–3 for both sticks, axes 4–7 auxiliary).
  *
- * Each signed axis is split into two directional channels — one for the
- * negative half and one for the positive half — with the negative channel
- * inverted so all channel values are non-negative during normal use.
+ * Each signed stick axis is exposed three ways for ergonomic binding:
+ *  - Two direction-split, non-negative channels (e.g. `LeftStickLeft` /
+ *    `LeftStickRight`) for "buttons-style" subscriptions.
+ *  - One signed aggregate channel (e.g. `LeftStickX`) for direct -1..1
+ *    consumption — useful for movement or aiming.
+ *
  * Device-specific subclasses (Xbox, PlayStation, Switch Pro, etc.) inherit
  * this layout and override only {@link GamepadMapping.family}.
  */

package/dist/esm/input/GenericDualAnalogGamepadMapping.js

@@ -1,61 +1,70 @@
-import { GamepadChannel } from './GamepadChannels.js';
+import { GamepadAxis } from './GamepadAxis.js';
+import { GamepadButton } from './GamepadButton.js';
 import { GamepadMapping, GamepadMappingFamily } from './GamepadMapping.js';
 
-const genericDualAnalogButtonDefinitions = [
-    [0, GamepadChannel.ButtonSouth],
-    [1, GamepadChannel.ButtonEast],
-    [2, GamepadChannel.ButtonWest],
-    [3, GamepadChannel.ButtonNorth],
-    [4, GamepadChannel.LeftShoulder],
-    [5, GamepadChannel.RightShoulder],
-    [6, GamepadChannel.LeftTrigger],
-    [7, GamepadChannel.RightTrigger],
-    [8, GamepadChannel.Select],
-    [9, GamepadChannel.Start],
-    [10, GamepadChannel.LeftStick],
-    [11, GamepadChannel.RightStick],
-    [12, GamepadChannel.DPadUp],
-    [13, GamepadChannel.DPadDown],
-    [14, GamepadChannel.DPadLeft],
-    [15, GamepadChannel.DPadRight],
-    [16, GamepadChannel.Guide],
-    [17, GamepadChannel.Share],
-    [18, GamepadChannel.Capture],
-    [19, GamepadChannel.Touchpad],
-    [20, GamepadChannel.Paddle1],
-];
-const genericDualAnalogAxisDefinitions = [
-    [0, GamepadChannel.LeftStickLeft, { invert: true }],
-    [0, GamepadChannel.LeftStickRight],
-    [1, GamepadChannel.LeftStickUp, { invert: true }],
-    [1, GamepadChannel.LeftStickDown],
-    [2, GamepadChannel.RightStickLeft, { invert: true }],
-    [2, GamepadChannel.RightStickRight],
-    [3, GamepadChannel.RightStickUp, { invert: true }],
-    [3, GamepadChannel.RightStickDown],
-    [4, GamepadChannel.AuxiliaryAxis0Negative, { invert: true }],
-    [4, GamepadChannel.AuxiliaryAxis0Positive],
-    [5, GamepadChannel.AuxiliaryAxis1Negative, { invert: true }],
-    [5, GamepadChannel.AuxiliaryAxis1Positive],
-    [6, GamepadChannel.AuxiliaryAxis2Negative, { invert: true }],
-    [6, GamepadChannel.AuxiliaryAxis2Positive],
-    [7, GamepadChannel.AuxiliaryAxis3Negative, { invert: true }],
-    [7, GamepadChannel.AuxiliaryAxis3Positive],
-];
 /**
  * Baseline mapping for dual-analog controllers that follow the standard
  * W3C Gamepad API layout (axes 0–3 for both sticks, axes 4–7 auxiliary).
  *
- * Each signed axis is split into two directional channels — one for the
- * negative half and one for the positive half — with the negative channel
- * inverted so all channel values are non-negative during normal use.
+ * Each signed stick axis is exposed three ways for ergonomic binding:
+ *  - Two direction-split, non-negative channels (e.g. `LeftStickLeft` /
+ *    `LeftStickRight`) for "buttons-style" subscriptions.
+ *  - One signed aggregate channel (e.g. `LeftStickX`) for direct -1..1
+ *    consumption — useful for movement or aiming.
+ *
  * Device-specific subclasses (Xbox, PlayStation, Switch Pro, etc.) inherit
  * this layout and override only {@link GamepadMapping.family}.
  */
 class GenericDualAnalogGamepadMapping extends GamepadMapping {
     family = GamepadMappingFamily.GenericDualAnalog;
     constructor() {
-        super(GamepadMapping.createControls(genericDualAnalogButtonDefinitions), GamepadMapping.createControls(genericDualAnalogAxisDefinitions));
+        super([
+            new GamepadButton(0, GamepadButton.South),
+            new GamepadButton(1, GamepadButton.East),
+            new GamepadButton(2, GamepadButton.West),
+            new GamepadButton(3, GamepadButton.North),
+            new GamepadButton(4, GamepadButton.LeftShoulder),
+            new GamepadButton(5, GamepadButton.RightShoulder),
+            new GamepadButton(6, GamepadButton.LeftTrigger),
+            new GamepadButton(7, GamepadButton.RightTrigger),
+            new GamepadButton(8, GamepadButton.Select),
+            new GamepadButton(9, GamepadButton.Start),
+            new GamepadButton(10, GamepadButton.LeftStick),
+            new GamepadButton(11, GamepadButton.RightStick),
+            new GamepadButton(12, GamepadButton.DPadUp),
+            new GamepadButton(13, GamepadButton.DPadDown),
+            new GamepadButton(14, GamepadButton.DPadLeft),
+            new GamepadButton(15, GamepadButton.DPadRight),
+            new GamepadButton(16, GamepadButton.Guide),
+            new GamepadButton(17, GamepadButton.Share),
+            new GamepadButton(18, GamepadButton.Capture),
+            new GamepadButton(19, GamepadButton.Touchpad),
+            new GamepadButton(20, GamepadButton.Paddle1),
+        ], [
+            // Direction-split (0..1).
+            new GamepadAxis(0, GamepadAxis.LeftStickLeft, { invert: true }),
+            new GamepadAxis(0, GamepadAxis.LeftStickRight),
+            new GamepadAxis(1, GamepadAxis.LeftStickUp, { invert: true }),
+            new GamepadAxis(1, GamepadAxis.LeftStickDown),
+            new GamepadAxis(2, GamepadAxis.RightStickLeft, { invert: true }),
+            new GamepadAxis(2, GamepadAxis.RightStickRight),
+            new GamepadAxis(3, GamepadAxis.RightStickUp, { invert: true }),
+            new GamepadAxis(3, GamepadAxis.RightStickDown),
+            // Aggregate signed channels (-1..1).
+            new GamepadAxis(0, GamepadAxis.LeftStickX, { bipolar: true }),
+            new GamepadAxis(1, GamepadAxis.LeftStickY, { bipolar: true }),
+            new GamepadAxis(2, GamepadAxis.RightStickX, { bipolar: true }),
+            new GamepadAxis(3, GamepadAxis.RightStickY, { bipolar: true }),
+            // Auxiliary axes (4 bipolar physical axes split into 8 half-channels).
+            new GamepadAxis(4, GamepadAxis.AuxiliaryAxis0Negative, { invert: true }),
+            new GamepadAxis(4, GamepadAxis.AuxiliaryAxis0Positive),
+            new GamepadAxis(5, GamepadAxis.AuxiliaryAxis1Negative, { invert: true }),
+            new GamepadAxis(5, GamepadAxis.AuxiliaryAxis1Positive),
+            new GamepadAxis(6, GamepadAxis.AuxiliaryAxis2Negative, { invert: true }),
+            new GamepadAxis(6, GamepadAxis.AuxiliaryAxis2Positive),
+            new GamepadAxis(7, GamepadAxis.AuxiliaryAxis3Negative, { invert: true }),
+            new GamepadAxis(7, GamepadAxis.AuxiliaryAxis3Positive),
+        ]);
     }
 }
 

package/dist/esm/input/GenericDualAnalogGamepadMapping.js.map

@@ -1 +1 @@
-{"version":3,"file":"GenericDualAnalogGamepadMapping.js","sources":["../../../../src/input/GenericDualAnalogGamepadMapping.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"GenericDualAnalogGamepadMapping.js","sources":["../../../../src/input/GenericDualAnalogGamepadMapping.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/input/InputBinding.d.ts

@@ -0,0 +1,74 @@
+import { Signal } from '@/core/Signal';
+import type { Keyboard } from '@/input/types';
+import type { GamepadButtonChannel } from './GamepadButton';
+import type { GamepadAxisChannel } from './GamepadAxis';
+/** Channel a single {@link InputBinding} can subscribe to. */
+export type InputChannel = GamepadButtonChannel | GamepadAxisChannel | Keyboard;
+/** Construction options shared by every binding factory method. */
+export interface InputBindingOptions {
+    /**
+     * Tap-window for {@link InputBinding.onTrigger} in milliseconds. The
+     * trigger fires when the input is released within this window after
+     * activation. Defaults to {@link InputBinding.defaultTriggerThreshold}
+     * (300 ms).
+     */
+    threshold?: number;
+    /**
+     * Pin this binding to a specific gamepad slot (0..3). Channel offsets
+     * are resolved at construction time. When unset, gamepad channels read
+     * from slot 0 (the primary pad).
+     */
+    gamepadSlot?: 0 | 1 | 2 | 3;
+}
+interface InternalChannelDetacher {
+    detach(binding: InputBinding): void;
+}
+/**
+ * One subscription to one or more input channels. Tracks active state, fires
+ * the {@link onStart} / {@link onActive} / {@link onStop} / {@link onTrigger}
+ * Signals each frame, and registers itself with whichever owner created it
+ * (typically an {@link InputManager}, {@link Gamepad}, or scene-bound
+ * proxy).
+ *
+ * Construct via the owner's `onStart` / `onActive` / `onStop` /
+ * `onTrigger` factory methods rather than `new InputBinding(...)` directly.
+ *
+ * Lifecycle: a binding lives until {@link unbind} is called, the owner
+ * disposes it, or — for scene-bound bindings — the scene unloads.
+ *
+ * @internal
+ */
+export declare class InputBinding {
+    /**
+     * Default tap-window for `onTrigger`. Override per binding via the
+     * `threshold` option. Mutating this static affects only newly created
+     * bindings.
+     */
+    static defaultTriggerThreshold: number;
+    readonly channels: ReadonlyArray<number>;
+    readonly onStart: Signal<[number]>;
+    readonly onActive: Signal<[number]>;
+    readonly onStop: Signal<[number]>;
+    readonly onTrigger: Signal<[number]>;
+    private readonly _triggerTimer;
+    private readonly _detacher;
+    private _value;
+    private _unbound;
+    constructor(channels: ReadonlyArray<number>, options?: InputBindingOptions, detacher?: InternalChannelDetacher | null);
+    /** Last value sampled this frame. 0 when inactive. */
+    get value(): number;
+    /** `true` when the last sampled value exceeded the channel's threshold. */
+    get active(): boolean;
+    /**
+     * Read the latest values from the unified channel buffer and dispatch
+     * the appropriate Signals. Called once per frame by the owning manager.
+     *
+     * @internal
+     */
+    update(channels: Float32Array): void;
+    /**
+     * Detach this binding from its owner and release its Signals. Idempotent.
+     */
+    unbind(): void;
+}
+export {};

package/dist/esm/input/InputBinding.js

@@ -0,0 +1,100 @@
+import { Signal } from '../core/Signal.js';
+import { Timer } from '../core/Timer.js';
+import { milliseconds } from '../core/utils.js';
+
+/**
+ * One subscription to one or more input channels. Tracks active state, fires
+ * the {@link onStart} / {@link onActive} / {@link onStop} / {@link onTrigger}
+ * Signals each frame, and registers itself with whichever owner created it
+ * (typically an {@link InputManager}, {@link Gamepad}, or scene-bound
+ * proxy).
+ *
+ * Construct via the owner's `onStart` / `onActive` / `onStop` /
+ * `onTrigger` factory methods rather than `new InputBinding(...)` directly.
+ *
+ * Lifecycle: a binding lives until {@link unbind} is called, the owner
+ * disposes it, or — for scene-bound bindings — the scene unloads.
+ *
+ * @internal
+ */
+class InputBinding {
+    /**
+     * Default tap-window for `onTrigger`. Override per binding via the
+     * `threshold` option. Mutating this static affects only newly created
+     * bindings.
+     */
+    static defaultTriggerThreshold = 300;
+    channels;
+    onStart = new Signal();
+    onActive = new Signal();
+    onStop = new Signal();
+    onTrigger = new Signal();
+    _triggerTimer;
+    _detacher;
+    _value = 0;
+    _unbound = false;
+    constructor(channels, options = {}, detacher = null) {
+        this.channels = channels;
+        this._triggerTimer = new Timer(milliseconds(options.threshold ?? InputBinding.defaultTriggerThreshold));
+        this._detacher = detacher;
+    }
+    /** Last value sampled this frame. 0 when inactive. */
+    get value() {
+        return this._value;
+    }
+    /** `true` when the last sampled value exceeded the channel's threshold. */
+    get active() {
+        return this._value > 0;
+    }
+    /**
+     * Read the latest values from the unified channel buffer and dispatch
+     * the appropriate Signals. Called once per frame by the owning manager.
+     *
+     * @internal
+     */
+    update(channels) {
+        if (this._unbound) {
+            return;
+        }
+        let value = 0;
+        for (const channel of this.channels) {
+            const sample = channels[channel];
+            if (Math.abs(sample) > Math.abs(value)) {
+                value = sample;
+            }
+        }
+        this._value = value;
+        if (value !== 0) {
+            if (!this._triggerTimer.running) {
+                this._triggerTimer.restart();
+                this.onStart.dispatch(value);
+            }
+            this.onActive.dispatch(value);
+        }
+        else if (this._triggerTimer.running) {
+            this.onStop.dispatch(0);
+            if (!this._triggerTimer.expired) {
+                this.onTrigger.dispatch(0);
+            }
+            this._triggerTimer.stop();
+        }
+    }
+    /**
+     * Detach this binding from its owner and release its Signals. Idempotent.
+     */
+    unbind() {
+        if (this._unbound) {
+            return;
+        }
+        this._unbound = true;
+        this._detacher?.detach(this);
+        this._triggerTimer.destroy();
+        this.onStart.destroy();
+        this.onActive.destroy();
+        this.onStop.destroy();
+        this.onTrigger.destroy();
+    }
+}
+
+export { InputBinding };
+//# sourceMappingURL=InputBinding.js.map

package/dist/esm/input/InputBinding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputBinding.js","sources":["../../../../src/input/InputBinding.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAgCA;;;;;;;;;;;;;;AAcG;MACU,YAAY,CAAA;AACrB;;;;AAIG;AACI,IAAA,OAAO,uBAAuB,GAAG,GAAG;AAE3B,IAAA,QAAQ;AAER,IAAA,OAAO,GAAK,IAAI,MAAM,EAAY;AAClC,IAAA,QAAQ,GAAI,IAAI,MAAM,EAAY;AAClC,IAAA,MAAM,GAAM,IAAI,MAAM,EAAY;AAClC,IAAA,SAAS,GAAG,IAAI,MAAM,EAAY;AAEjC,IAAA,aAAa;AACb,IAAA,SAAS;IAClB,MAAM,GAAG,CAAC;IACV,QAAQ,GAAG,KAAK;AAExB,IAAA,WAAA,CACI,QAA+B,EAC/B,OAAA,GAA+B,EAAE,EACjC,WAA2C,IAAI,EAAA;AAE/C,QAAA,IAAI,CAAC,QAAQ,GAAG,QAAQ;AACxB,QAAA,IAAI,CAAC,aAAa,GAAG,IAAI,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,IAAI,YAAY,CAAC,uBAAuB,CAAC,CAAC;AACvG,QAAA,IAAI,CAAC,SAAS,GAAG,QAAQ;IAC7B;;AAGA,IAAA,IAAW,KAAK,GAAA;QACZ,OAAO,IAAI,CAAC,MAAM;IACtB;;AAGA,IAAA,IAAW,MAAM,GAAA;AACb,QAAA,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC;IAC1B;AAEA;;;;;AAKG;AACI,IAAA,MAAM,CAAC,QAAsB,EAAA;AAChC,QAAA,IAAI,IAAI,CAAC,QAAQ,EAAE;YACf;QACJ;QAEA,IAAI,KAAK,GAAG,CAAC;AAEb,QAAA,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE;AACjC,YAAA,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC;AAEhC,YAAA,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;gBACpC,KAAK,GAAG,MAAM;YAClB;QACJ;AAEA,QAAA,IAAI,CAAC,MAAM,GAAG,KAAK;AAEnB,QAAA,IAAI,KAAK,KAAK,CAAC,EAAE;AACb,YAAA,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE;AAC7B,gBAAA,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE;AAC5B,gBAAA,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;YAChC;AAEA,YAAA,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;QACjC;AAAO,aAAA,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE;AACnC,YAAA,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEvB,YAAA,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE;AAC7B,gBAAA,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC9B;AAEA,YAAA,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE;QAC7B;IACJ;AAEA;;AAEG;IACI,MAAM,GAAA;AACT,QAAA,IAAI,IAAI,CAAC,QAAQ,EAAE;YACf;QACJ;AAEA,QAAA,IAAI,CAAC,QAAQ,GAAG,IAAI;AACpB,QAAA,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC;AAC5B,QAAA,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE;AAC5B,QAAA,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE;AACtB,QAAA,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE;AACvB,QAAA,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE;AACrB,QAAA,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE;IAC5B;;;;;"}

package/dist/esm/input/InputManager.d.ts

@@ -2,8 +2,23 @@ import { Vector } from '@/math/Vector';
 import { Signal } from '@/core/Signal';
 import { Gamepad } from './Gamepad';
 import { Pointer } from './Pointer';
+import { InputBinding } from './InputBinding';
 import type { Application } from '@/core/Application';
-import type { Input } from './Input';
+import type { GamepadAxis } from './GamepadAxis';
+import type { GamepadButton } from './GamepadButton';
+import type { InputBindingOptions, InputChannel } from './InputBinding';
+/**
+ * Strategy used by {@link InputManager} when assigning physical gamepads to
+ * slot indices in {@link InputManager.gamepads}.
+ *
+ * - `'sticky'` (default): each physical pad keeps its slot until a new pad
+ *   fills an empty slot. A disconnect leaves a gap; reconnect later fills
+ *   the lowest empty slot. Best for player-stable-binding semantics.
+ * - `'compact'`: on disconnect, higher-numbered slots shift down to keep
+ *   `gamepads[0..N-1]` densely populated. Good for "the first N pads are
+ *   the N players" workflows.
+ */
+export type GamepadSlotStrategy = 'sticky' | 'compact';
 /**
  * Owns the unified input pipeline for an {@link Application}: keyboard
  * events, pointer (mouse/touch/pen) events with multi-touch slot
@@ -12,10 +27,11 @@ import type { Input } from './Input';
  * rotate / long-press).
  *
  * All raw inputs are written into a shared `Float32Array` channel buffer.
- * Bind {@link Input} instances to channel indices to react to specific
- * keys, gamepad controls, or pointer slots without rolling your own event
- * routing. Direct subscribers can use the per-event Signals
- * (`onKeyDown`, `onPointerDown`, `onGamepadConnected`, `onPinch`, …).
+ * Bind input listeners via the {@link onTrigger} / {@link onActive} /
+ * {@link onStart} / {@link onStop} factory methods (or via
+ * {@link Gamepad.onTrigger}-style methods on individual pads), or
+ * subscribe to the signal-style notifications
+ * (`onKeyDown`, `onPointerDown`, `onGamepadConnected`, `onAnyGamepadButtonDown`, …).
  *
  * Driven each frame by {@link Application.update}; constructed
  * automatically — you do not instantiate this class yourself.
@@ -23,16 +39,17 @@ import type { Input } from './Input';
 export declare class InputManager {
     private readonly canvas;
     private readonly channels;
-    private readonly inputs;
     private readonly pointers;
-    private readonly gamepadsValue;
-    private readonly gamepadsByIndex;
-    private readonly gamepadSlotsActive;
+    private readonly _gamepads;
+    private readonly gamepadsByBrowserIndex;
+    private readonly bindings;
+    private readonly bindingDetacher;
     private readonly wheelOffset;
     private readonly flags;
     private readonly channelsPressed;
     private readonly channelsReleased;
     private readonly gamepadDefinitions;
+    private readonly slotStrategy;
     private readonly pointerSlots;
     private readonly freeSlots;
     private readonly gestureRecognizer;
@@ -62,9 +79,22 @@ export declare class InputManager {
     readonly onMouseWheel: Signal<[Vector]>;
     readonly onKeyDown: Signal<[number]>;
     readonly onKeyUp: Signal<[number]>;
-    readonly onGamepadConnected: Signal<[Gamepad, Gamepad[]]>;
-    readonly onGamepadDisconnected: Signal<[Gamepad, Gamepad[]]>;
-    readonly onGamepadUpdated: Signal<[Gamepad, Gamepad[]]>;
+    /** Fires when a physical pad connects to any slot. */
+    readonly onGamepadConnected: Signal<[Gamepad]>;
+    /** Fires when a physical pad disconnects from any slot. */
+    readonly onGamepadDisconnected: Signal<[Gamepad]>;
+    /**
+     * Fires when a `'compact'`-strategy disconnect shifts a higher-numbered
+     * slot's pad into a lower one. Dispatched once per moved pad with the
+     * destination slot and the slot index it came from.
+     */
+    readonly onAnyGamepadReassigned: Signal<[Gamepad, fromSlot: 0 | 1 | 2 | 3]>;
+    /** Fires whenever any pad reports a button press transition. */
+    readonly onAnyGamepadButtonDown: Signal<[Gamepad, GamepadButton, number]>;
+    /** Fires whenever any pad reports a button release transition. */
+    readonly onAnyGamepadButtonUp: Signal<[Gamepad, GamepadButton, number]>;
+    /** Fires whenever any pad reports an axis value change. */
+    readonly onAnyGamepadAxisChange: Signal<[Gamepad, GamepadAxis, number]>;
     /** Fires on every two-touch-pointer move where the distance between them changed. `scale` > 1 = spreading, < 1 = pinching. */
     readonly onPinch: Signal<[scale: number, center: Vector]>;
     /** Fires on every two-touch-pointer move where the angle between them changed. `angleDelta` is in radians. */
@@ -83,30 +113,52 @@ export declare class InputManager {
     } | null;
     get pointersInCanvas(): boolean;
     get canvasFocused(): boolean;
-    get gamepads(): Array<Gamepad>;
-    getGamepad(index: number): Gamepad | null;
     /**
-     * Register one or more {@link Input} bindings so they participate in the
-     * per-frame channel-buffer reads. Idempotent for already-registered
-     * inputs; chainable.
+     * Always-4 array of {@link Gamepad} slot mailboxes. Each entry exists for
+     * the application's full lifetime; check `pad.connected` for hardware
+     * presence. Listeners attached to a slot survive disconnect/reconnect.
      */
-    add(inputs: Input | Array<Input>): this;
-    /** Unregister one or more {@link Input} bindings. */
-    remove(inputs: Input | Array<Input>): this;
+    get gamepads(): readonly [Gamepad, Gamepad, Gamepad, Gamepad];
+    /** The slot strategy active for this `InputManager`. */
+    get gamepadSlotStrategy(): GamepadSlotStrategy;
     /**
-     * Drop every registered {@link Input}. Pass `destroyInputs = true` to
-     * also call `.destroy()` on each one (releases its Signals); default
-     * `false` leaves them intact for re-registration.
+     * Direct accessor for a single gamepad slot. Equivalent to
+     * `app.input.gamepads[slot]` but reads more clearly at call sites.
      */
-    clear(destroyInputs?: boolean): this;
+    getGamepad(slot: 0 | 1 | 2 | 3): Gamepad;
+    /** Subset of {@link gamepads} containing only currently connected pads, in slot order. */
+    get connectedGamepads(): ReadonlyArray<Gamepad>;
+    /** Number of slots currently occupied by a physical gamepad. */
+    get connectedGamepadCount(): number;
+    /** First connected gamepad in slot order, or `null` when no pads are attached. */
+    get firstConnectedGamepad(): Gamepad | null;
+    /** `true` when at least one slot is occupied by a physical gamepad. */
+    get hasGamepad(): boolean;
+    /**
+     * Register a callback fired once when any of `channels` becomes active.
+     * Manual lifecycle — call `.unbind()` on the returned binding to detach.
+     */
+    onStart(channel: InputChannel | ReadonlyArray<InputChannel>, callback: (value: number) => void, options?: InputBindingOptions): InputBinding;
+    /** Register a callback fired every frame while any of `channels` is active. */
+    onActive(channel: InputChannel | ReadonlyArray<InputChannel>, callback: (value: number) => void, options?: InputBindingOptions): InputBinding;
+    /** Register a callback fired once when all of `channels` become inactive. */
+    onStop(channel: InputChannel | ReadonlyArray<InputChannel>, callback: (value: number) => void, options?: InputBindingOptions): InputBinding;
+    /**
+     * Register a callback fired when the input is released within
+     * {@link InputBindingOptions.threshold} ms of activation (a "tap").
+     */
+    onTrigger(channel: InputChannel | ReadonlyArray<InputChannel>, callback: (value: number) => void, options?: InputBindingOptions): InputBinding;
     /**
      * Per-frame entry point invoked by {@link Application.update}. Polls
      * the gamepad API, drains queued keyboard/pointer/wheel deltas into
      * the channel buffer, fires the corresponding Signals, then evaluates
-     * each registered {@link Input}.
+     * each registered binding.
      */
     update(): this;
     destroy(): void;
+    private createBinding;
+    private resolveExternalChannel;
+    private wireGamepadEvents;
     private _assignSlot;
     private _releaseSlot;
     private handleKeyDown;
@@ -121,18 +173,12 @@ export declare class InputManager {
     private handleCanvasFocus;
     private handleCanvasBlur;
     private handleWindowBlur;
-    /**
-     * Force every currently-held keyboard channel back to zero and emit
-     * onKeyUp for each. Called on canvas/window blur so keys held when
-     * focus leaves don't stay stuck "down" forever — without this, a user
-     * who alt-tabs while pressing W would have W register as held until
-     * they manually release while focus is back.
-     */
     private releaseAllKeyboardChannels;
     private addEventListeners;
     private removeEventListeners;
     private updateGamepads;
-    private insertGamepadByIndex;
+    private assignSlotForNewPad;
+    private handleGamepadDisconnect;
     private updateEvents;
     private updatePointerEvents;
 }