@codexo/exojs 0.7.11 → 0.7.13

package/dist/esm/input/GamepadMapping.js

@@ -1,5 +1,7 @@
-import { GamepadControl } from './GamepadControl.js';
-
+/**
+ * Discriminant tag identifying which device family a {@link GamepadMapping} belongs to.
+ * Used to select the correct mapping at runtime when a gamepad connects.
+ */
 var GamepadMappingFamily;
 (function (GamepadMappingFamily) {
     GamepadMappingFamily["GenericDualAnalog"] = "genericDualAnalog";
@@ -10,22 +12,61 @@ var GamepadMappingFamily;
     GamepadMappingFamily["JoyConRight"] = "joyConRight";
     GamepadMappingFamily["GameCube"] = "gameCube";
     GamepadMappingFamily["SteamController"] = "steamController";
+    GamepadMappingFamily["SteamDeck"] = "steamDeck";
     GamepadMappingFamily["ArcadeStick"] = "arcadeStick";
 })(GamepadMappingFamily || (GamepadMappingFamily = {}));
+/**
+ * Abstract translation layer between the browser's raw {@link https://developer.mozilla.org/en-US/docs/Web/API/Gamepad Gamepad API}
+ * indices and ExoJS-canonical channel buffers.
+ *
+ * Each concrete subclass encodes one device family's button/axis layout as
+ * ordered arrays of {@link GamepadButton} / {@link GamepadAxis} instances.
+ * The engine selects the appropriate mapping when a gamepad connects and
+ * uses it to route raw values to the correct input channels every frame.
+ */
 class GamepadMapping {
+    /** Ordered list of buttons, indexed by the Gamepad API button index. */
     buttons;
+    /** Ordered list of axes, indexed by the Gamepad API axis index. */
     axes;
     constructor(buttons, axes) {
         this.buttons = buttons;
         this.axes = axes;
     }
+    /**
+     * Returns `true` when this mapping declares at least one button or axis
+     * control that writes to `channel`. Use to detect device-specific
+     * capabilities at runtime — e.g. before binding an input to a
+     * right-stick channel that may not exist on a single Joy-Con.
+     *
+     * @example
+     * ```ts
+     * if (gamepad.mapping?.hasChannel(GamepadAxis.RightStickX)) {
+     *     pad.onActive(GamepadAxis.RightStickX, (v) => crosshair.x += v * 8);
+     * }
+     * ```
+     */
+    hasChannel(channel) {
+        for (const button of this.buttons) {
+            if (button.channel === channel) {
+                return true;
+            }
+        }
+        for (const axis of this.axes) {
+            if (axis.channel === channel) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Releases all button and axis control references held by this mapping.
+     * Call when the associated gamepad disconnects to allow garbage collection.
+     */
     destroy() {
         this.buttons.length = 0;
         this.axes.length = 0;
     }
-    static createControls(definitions) {
-        return definitions.map(([index, channel, options]) => new GamepadControl(index, channel, options));
-    }
 }
 
 export { GamepadMapping, GamepadMappingFamily };

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

@@ -1 +1 @@
-{"version":3,"file":"GamepadMapping.js","sources":["../../../../src/input/GamepadMapping.ts"],"sourcesContent":[null],"names":[],"mappings":";;IAKY;AAAZ,CAAA,UAAY,oBAAoB,EAAA;AAC5B,IAAA,oBAAA,CAAA,mBAAA,CAAA,GAAA,mBAAuC;AACvC,IAAA,oBAAA,CAAA,MAAA,CAAA,GAAA,MAAa;AACb,IAAA,oBAAA,CAAA,aAAA,CAAA,GAAA,aAA2B;AAC3B,IAAA,oBAAA,CAAA,WAAA,CAAA,GAAA,WAAuB;AACvB,IAAA,oBAAA,CAAA,YAAA,CAAA,GAAA,YAAyB;AACzB,IAAA,oBAAA,CAAA,aAAA,CAAA,GAAA,aAA2B;AAC3B,IAAA,oBAAA,CAAA,UAAA,CAAA,GAAA,UAAqB;AACrB,IAAA,oBAAA,CAAA,iBAAA,CAAA,GAAA,iBAAmC;AACnC,IAAA,oBAAA,CAAA,aAAA,CAAA,GAAA,aAA2B;AAC/B,CAAC,EAVW,oBAAoB,KAApB,oBAAoB,GAAA,EAAA,CAAA,CAAA;MAcV,cAAc,CAAA;AAGhB,IAAA,OAAO;AACP,IAAA,IAAI;IAEpB,WAAA,CAAsB,OAA8B,EAAE,IAA2B,EAAA;AAC7E,QAAA,IAAI,CAAC,OAAO,GAAG,OAAO;AACtB,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI;IACpB;IAEO,OAAO,GAAA;AACV,QAAA,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;AACvB,QAAA,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;IACxB;IAEO,OAAO,cAAc,CAAC,WAAoD,EAAA;QAC7E,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,IAAI,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACtG;AACH;;;;"}
+{"version":3,"file":"GamepadMapping.js","sources":["../../../../src/input/GamepadMapping.ts"],"sourcesContent":[null],"names":[],"mappings":"AAKA;;;AAGG;IACS;AAAZ,CAAA,UAAY,oBAAoB,EAAA;AAC5B,IAAA,oBAAA,CAAA,mBAAA,CAAA,GAAA,mBAAuC;AACvC,IAAA,oBAAA,CAAA,MAAA,CAAA,GAAA,MAAa;AACb,IAAA,oBAAA,CAAA,aAAA,CAAA,GAAA,aAA2B;AAC3B,IAAA,oBAAA,CAAA,WAAA,CAAA,GAAA,WAAuB;AACvB,IAAA,oBAAA,CAAA,YAAA,CAAA,GAAA,YAAyB;AACzB,IAAA,oBAAA,CAAA,aAAA,CAAA,GAAA,aAA2B;AAC3B,IAAA,oBAAA,CAAA,UAAA,CAAA,GAAA,UAAqB;AACrB,IAAA,oBAAA,CAAA,iBAAA,CAAA,GAAA,iBAAmC;AACnC,IAAA,oBAAA,CAAA,WAAA,CAAA,GAAA,WAAuB;AACvB,IAAA,oBAAA,CAAA,aAAA,CAAA,GAAA,aAA2B;AAC/B,CAAC,EAXW,oBAAoB,KAApB,oBAAoB,GAAA,EAAA,CAAA,CAAA;AAahC;;;;;;;;AAQG;MACmB,cAAc,CAAA;;AAKhB,IAAA,OAAO;;AAGP,IAAA,IAAI;IAEpB,WAAA,CAAsB,OAAqC,EAAE,IAAgC,EAAA;AACzF,QAAA,IAAI,CAAC,OAAO,GAAG,OAAO;AACtB,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI;IACpB;AAEA;;;;;;;;;;;;AAYG;AACI,IAAA,UAAU,CAAC,OAAkD,EAAA;AAChE,QAAA,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE;AAC/B,YAAA,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,EAAE;AAC5B,gBAAA,OAAO,IAAI;YACf;QACJ;AAEA,QAAA,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE;AAC1B,YAAA,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,EAAE;AAC1B,gBAAA,OAAO,IAAI;YACf;QACJ;AAEA,QAAA,OAAO,KAAK;IAChB;AAEA;;;AAGG;IACI,OAAO,GAAA;AACT,QAAA,IAAI,CAAC,OAAgC,CAAC,MAAM,GAAG,CAAC;AAChD,QAAA,IAAI,CAAC,IAA2B,CAAC,MAAM,GAAG,CAAC;IAChD;AACH;;;;"}

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

@@ -1,9 +1,42 @@
-import { GamepadChannel } from './GamepadChannels';
 import { GamepadMappingFamily } from './GamepadMapping';
+import type { GamepadButtonChannel } from './GamepadButton';
+/**
+ * Named controls that can appear in an in-game prompt or button-hint UI.
+ *
+ * Intentionally a subset of {@link GamepadButton} channels — covers the
+ * controls a typical prompt overlay needs to label, including the composite
+ * `'DPad'` token which has no single channel equivalent. The names retain
+ * a `'Button'` prefix on the face cluster for compatibility with prompt
+ * artwork file names.
+ */
 export type GamepadPromptControl = 'DPad' | 'DPadUp' | 'DPadDown' | 'DPadLeft' | 'DPadRight' | 'ButtonNorth' | 'ButtonWest' | 'ButtonEast' | 'ButtonSouth' | 'LeftShoulder' | 'RightShoulder' | 'LeftTrigger' | 'RightTrigger' | 'Select' | 'Start' | 'LeftStick' | 'RightStick';
+/**
+ * Static utility that drives in-game controller-prompt UI.
+ *
+ * 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 GamepadButton} channel values.
+ */
 export declare class GamepadPromptLayouts {
+    /** Complete ordered list of every {@link GamepadPromptControl} token. */
     static readonly controls: Array<GamepadPromptControl>;
+    /**
+     * Returns the normalised [x, y] position of `control` on a generic controller
+     * silhouette, where (0, 0) is the top-left and (1, 1) the bottom-right.
+     * Falls back to [0.5, 0.5] (centre) when the control has no registered position.
+     */
     static getControlPosition(control: GamepadPromptControl): readonly [number, number];
+    /**
+     * Returns the label map for the given device family, e.g. `{ ButtonSouth → "A" }`
+     * for Xbox or `{ ButtonSouth → "Cross" }` for PlayStation.
+     * Falls back to generic labels when `family` has no registered label set.
+     */
     static getControlLabels(family: GamepadMappingFamily): ReadonlyMap<GamepadPromptControl, string>;
-    static buildControlChannelMap(): ReadonlyMap<GamepadPromptControl, GamepadChannel>;
+    /**
+     * Returns the static mapping from each {@link GamepadPromptControl} to its
+     * corresponding {@link GamepadButton} channel. The composite `'DPad'`
+     * control has no channel entry and is absent from the returned map.
+     */
+    static getControlChannelMap(): ReadonlyMap<GamepadPromptControl, GamepadButtonChannel>;
 }

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,9 +103,19 @@ const promptLabelsByFamily = new Map([
     [GamepadMappingFamily.JoyConRight, switchLabels],
     [GamepadMappingFamily.GameCube, genericLabels],
     [GamepadMappingFamily.SteamController, genericLabels],
+    [GamepadMappingFamily.SteamDeck, genericLabels],
     [GamepadMappingFamily.ArcadeStick, genericLabels],
 ]);
+/**
+ * Static utility that drives in-game controller-prompt UI.
+ *
+ * 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 GamepadButton} channel values.
+ */
 class GamepadPromptLayouts {
+    /** Complete ordered list of every {@link GamepadPromptControl} token. */
     static controls = [
         'DPad',
         'DPadUp',
@@ -125,13 +135,28 @@ class GamepadPromptLayouts {
         'LeftStick',
         'RightStick',
     ];
+    /**
+     * Returns the normalised [x, y] position of `control` on a generic controller
+     * silhouette, where (0, 0) is the top-left and (1, 1) the bottom-right.
+     * Falls back to [0.5, 0.5] (centre) when the control has no registered position.
+     */
     static getControlPosition(control) {
         return basePositions.get(control) ?? [0.5, 0.5];
     }
+    /**
+     * Returns the label map for the given device family, e.g. `{ ButtonSouth → "A" }`
+     * for Xbox or `{ ButtonSouth → "Cross" }` for PlayStation.
+     * Falls back to generic labels when `family` has no registered label set.
+     */
     static getControlLabels(family) {
         return promptLabelsByFamily.get(family) ?? genericLabels;
     }
-    static buildControlChannelMap() {
+    /**
+     * Returns the static mapping from each {@link GamepadPromptControl} to its
+     * 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

@@ -1,4 +1,17 @@
 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 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}.
+ */
 export declare class GenericDualAnalogGamepadMapping extends GamepadMapping {
     readonly family: GamepadMappingFamily;
     constructor();

package/dist/esm/input/GenericDualAnalogGamepadMapping.js

@@ -1,51 +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 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":";;;AAKA,MAAM,kCAAkC,GAA4C;AAChF,IAAA,CAAC,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC;AAC/B,IAAA,CAAC,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC;AAC9B,IAAA,CAAC,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC;AAC9B,IAAA,CAAC,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC;AAC/B,IAAA,CAAC,CAAC,EAAE,cAAc,CAAC,YAAY,CAAC;AAChC,IAAA,CAAC,CAAC,EAAE,cAAc,CAAC,aAAa,CAAC;AACjC,IAAA,CAAC,CAAC,EAAE,cAAc,CAAC,WAAW,CAAC;AAC/B,IAAA,CAAC,CAAC,EAAE,cAAc,CAAC,YAAY,CAAC;AAChC,IAAA,CAAC,CAAC,EAAE,cAAc,CAAC,MAAM,CAAC;AAC1B,IAAA,CAAC,CAAC,EAAE,cAAc,CAAC,KAAK,CAAC;AACzB,IAAA,CAAC,EAAE,EAAE,cAAc,CAAC,SAAS,CAAC;AAC9B,IAAA,CAAC,EAAE,EAAE,cAAc,CAAC,UAAU,CAAC;AAC/B,IAAA,CAAC,EAAE,EAAE,cAAc,CAAC,MAAM,CAAC;AAC3B,IAAA,CAAC,EAAE,EAAE,cAAc,CAAC,QAAQ,CAAC;AAC7B,IAAA,CAAC,EAAE,EAAE,cAAc,CAAC,QAAQ,CAAC;AAC7B,IAAA,CAAC,EAAE,EAAE,cAAc,CAAC,SAAS,CAAC;AAC9B,IAAA,CAAC,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC;AAC1B,IAAA,CAAC,EAAE,EAAE,cAAc,CAAC,KAAK,CAAC;AAC1B,IAAA,CAAC,EAAE,EAAE,cAAc,CAAC,OAAO,CAAC;AAC5B,IAAA,CAAC,EAAE,EAAE,cAAc,CAAC,QAAQ,CAAC;AAC7B,IAAA,CAAC,EAAE,EAAE,cAAc,CAAC,OAAO,CAAC;CAC/B;AAED,MAAM,gCAAgC,GAA4C;IAC9E,CAAC,CAAC,EAAE,cAAc,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACnD,IAAA,CAAC,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC;IAClC,CAAC,CAAC,EAAE,cAAc,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACjD,IAAA,CAAC,CAAC,EAAE,cAAc,CAAC,aAAa,CAAC;IACjC,CAAC,CAAC,EAAE,cAAc,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AACpD,IAAA,CAAC,CAAC,EAAE,cAAc,CAAC,eAAe,CAAC;IACnC,CAAC,CAAC,EAAE,cAAc,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAClD,IAAA,CAAC,CAAC,EAAE,cAAc,CAAC,cAAc,CAAC;IAClC,CAAC,CAAC,EAAE,cAAc,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC5D,IAAA,CAAC,CAAC,EAAE,cAAc,CAAC,sBAAsB,CAAC;IAC1C,CAAC,CAAC,EAAE,cAAc,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC5D,IAAA,CAAC,CAAC,EAAE,cAAc,CAAC,sBAAsB,CAAC;IAC1C,CAAC,CAAC,EAAE,cAAc,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC5D,IAAA,CAAC,CAAC,EAAE,cAAc,CAAC,sBAAsB,CAAC;IAC1C,CAAC,CAAC,EAAE,cAAc,CAAC,sBAAsB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAC5D,IAAA,CAAC,CAAC,EAAE,cAAc,CAAC,sBAAsB,CAAC;CAC7C;AAEK,MAAO,+BAAgC,SAAQ,cAAc,CAAA;AAC/C,IAAA,MAAM,GAAyB,oBAAoB,CAAC,iBAAiB;AAErF,IAAA,WAAA,GAAA;AACI,QAAA,KAAK,CACD,cAAc,CAAC,cAAc,CAAC,kCAAkC,CAAC,EACjE,cAAc,CAAC,cAAc,CAAC,gCAAgC,CAAC,CAClE;IACL;AACH;;;;"}
+{"version":3,"file":"GenericDualAnalogGamepadMapping.js","sources":["../../../../src/input/GenericDualAnalogGamepadMapping.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

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

@@ -2,8 +2,17 @@ import { Vector } from '@/math/Vector';
 import type { Signal } from '@/core/Signal';
 import type { Pointer } from './Pointer';
 /**
- * Internal gesture recognizer — NOT exported publicly.
- * Receives pointer lifecycle events from InputManager and fires gesture signals.
+ * Internal multi-touch gesture recognizer used by {@link InputManager}.
+ * Tracks active touch pointers, derives pinch/rotate deltas from the two
+ * primary touches, and fires long-press signals when a single pointer is
+ * held still for {@link longPressMs} (500 ms). Long-press cancels if the
+ * pointer moves beyond `distanceThreshold` pixels from the down position.
+ *
+ * The associated Signals (`onPinch`, `onRotate`, `onLongPress`) are owned
+ * by {@link InputManager} and re-exposed there as part of the public API;
+ * the recognizer just dispatches into them.
+ *
+ * @internal
  */
 export declare class GestureRecognizer {
     readonly onPinch: Signal<[scale: number, center: Vector]>;

package/dist/esm/input/GestureRecognizer.js

@@ -3,8 +3,17 @@ import { Vector } from '../math/Vector.js';
 /** Long-press threshold in milliseconds. */
 const longPressMs = 500;
 /**
- * Internal gesture recognizer — NOT exported publicly.
- * Receives pointer lifecycle events from InputManager and fires gesture signals.
+ * Internal multi-touch gesture recognizer used by {@link InputManager}.
+ * Tracks active touch pointers, derives pinch/rotate deltas from the two
+ * primary touches, and fires long-press signals when a single pointer is
+ * held still for {@link longPressMs} (500 ms). Long-press cancels if the
+ * pointer moves beyond `distanceThreshold` pixels from the down position.
+ *
+ * The associated Signals (`onPinch`, `onRotate`, `onLongPress`) are owned
+ * by {@link InputManager} and re-exposed there as part of the public API;
+ * the recognizer just dispatches into them.
+ *
+ * @internal
  */
 class GestureRecognizer {
     onPinch;

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

@@ -1 +1 @@
-{"version":3,"file":"GestureRecognizer.js","sources":["../../../../src/input/GestureRecognizer.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"GestureRecognizer.js","sources":["../../../../src/input/GestureRecognizer.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAKA;AACA,MAAM,WAAW,GAAG,GAAG;AAUvB;;;;;;;;;;;;AAYG;MACU,iBAAiB,CAAA;AACV,IAAA,OAAO;AACP,IAAA,QAAQ;AACR,IAAA,WAAW;AAEV,IAAA,iBAAiB;;AAGjB,IAAA,aAAa,GAAyB,IAAI,GAAG,EAAE;;AAG/C,IAAA,gBAAgB,GAAgC,IAAI,GAAG,EAAE;;IAGlE,YAAY,GAAG,EAAE;IACjB,SAAS,GAAG,CAAC;;AAGJ,IAAA,SAAS,GAAG,IAAI,MAAM,EAAE;AAEzC,IAAA,WAAA,CACI,iBAAyB,EACzB,OAAgD,EAChD,QAAsD,EACtD,WAAuC,EAAA;AAEvC,QAAA,IAAI,CAAC,iBAAiB,GAAG,iBAAiB;AAC1C,QAAA,IAAI,CAAC,OAAO,GAAG,OAAO;AACtB,QAAA,IAAI,CAAC,QAAQ,GAAG,QAAQ;AACxB,QAAA,IAAI,CAAC,WAAW,GAAG,WAAW;IAClC;AAEO,IAAA,aAAa,CAAC,OAAgB,EAAA;AACjC,QAAA,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE;YAC1B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC;YAC3C,IAAI,CAAC,sBAAsB,EAAE;QACjC;;AAGA,QAAA,MAAM,OAAO,GAAG,UAAU,CAAC,MAAK;YAC5B,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;AACxC,YAAA,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC;QACtC,CAAC,EAAE,WAAW,CAAC;QAEf,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE;YAClC,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,OAAO;YACP,OAAO;YACP,MAAM,EAAE,OAAO,CAAC,CAAC;YACjB,MAAM,EAAE,OAAO,CAAC,CAAC;AACpB,SAAA,CAAC;IACN;IAEO,aAAa,CAAC,OAAgB,EAAE,iBAAyB,EAAA;;AAE5D,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAEnD,IAAI,KAAK,EAAE;YACP,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM;YACnC,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM;AAEnC,YAAA,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,GAAG,iBAAiB,EAAE;AAClD,gBAAA,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC;gBAC3B,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5C;QACJ;AAEA,QAAA,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE;YAC1B;QACJ;;;QAIA,IAAI,IAAI,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,EAAE;YAC7B;QACJ;QAEA,IAAI,CAAC,wBAAwB,EAAE;IACnC;AAEO,IAAA,WAAW,CAAC,OAAgB,EAAA;AAC/B,QAAA,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;IACrC;AAEO,IAAA,cAAc,CAAC,OAAgB,EAAA;AAClC,QAAA,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;AAEjC,QAAA,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE;YAC1B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,sBAAsB,EAAE;QACjC;IACJ;AAEO,IAAA,eAAe,CAAC,OAAgB,EAAA;AACnC,QAAA,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;AAEjC,QAAA,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,EAAE;YAC1B,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,sBAAsB,EAAE;QACjC;IACJ;IAEO,OAAO,GAAA;QACV,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,EAAE;AAChD,YAAA,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC;QAC/B;AAEA,QAAA,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE;AAC7B,QAAA,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE;AAC1B,QAAA,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE;IAC5B;AAEQ,IAAA,gBAAgB,CAAC,SAAiB,EAAA;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC;QAElD,IAAI,KAAK,EAAE;AACP,YAAA,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC;AAC3B,YAAA,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC;QAC3C;IACJ;IAEQ,sBAAsB,GAAA;AAC1B,QAAA,IAAI,CAAC,YAAY,GAAG,EAAE;AACtB,QAAA,IAAI,CAAC,SAAS,GAAG,CAAC;IACtB;IAEQ,wBAAwB,GAAA;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE;QACxC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAgB;QACvC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAgB;QAEvC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QACtB,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;AACtB,QAAA,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;QACpD,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,CAAC;AAEvC,QAAA,MAAM,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC;AACjC,QAAA,MAAM,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC;QAEjC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC;AAEpC,QAAA,IAAI,IAAI,CAAC,YAAY,GAAG,CAAC,EAAE;AACvB,YAAA,MAAM,KAAK,GAAG,eAAe,GAAG,IAAI,CAAC,YAAY;;YAGjD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE;gBAC9B,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC;YAChD;AAEA,YAAA,MAAM,UAAU,GAAG,YAAY,GAAG,IAAI,CAAC,SAAS;YAEhD,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,MAAM,EAAE;gBAC/B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC;YACtD;QACJ;AAEA,QAAA,IAAI,CAAC,YAAY,GAAG,eAAe;AACnC,QAAA,IAAI,CAAC,SAAS,GAAG,YAAY;IACjC;AACH;;;;"}

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