@codexo/exojs 0.7.11 → 0.7.13

package/dist/esm/input/GamepadAxis.js

@@ -0,0 +1,106 @@
+import { clamp } from '../math/utils.js';
+import { ChannelOffset } from './types.js';
+
+/**
+ * Single mappable analog axis on a physical gamepad. Holds the raw browser
+ * `Gamepad.axes[]` index, the canonical channel the value is written to, and
+ * the transform pipeline applied each frame by {@link transformValue}.
+ *
+ * Direction-split axis channels (e.g. `LeftStickLeft`, `LeftStickRight`)
+ * live in the 0..1 range — set `invert: true` on the negative half so it
+ * reads positive when pushed in its direction.
+ *
+ * Aggregate channels (e.g. `LeftStickX`, `LeftStickY`) live in the full
+ * -1..1 range — set `bipolar: true` to preserve sign through the pipeline.
+ *
+ * The static namespace exports (`GamepadAxis.LeftStickLeft`,
+ * `.LeftStickX`, ...) carry the canonical channel offsets used to address
+ * each axis.
+ */
+class GamepadAxis {
+    index;
+    channel;
+    invert;
+    normalize;
+    threshold;
+    bipolar;
+    constructor(index, channel, options = {}) {
+        this.index = index;
+        this.channel = channel;
+        this.invert = options.invert ?? false;
+        this.normalize = options.normalize ?? false;
+        this.threshold = clamp(options.threshold ?? 0.2, 0, 1);
+        this.bipolar = options.bipolar ?? false;
+    }
+    /**
+     * Apply the axis transform pipeline to a raw browser axis value
+     * (typically `Gamepad.axes[i]`, in -1..1).
+     *
+     * Pipeline: clamp to [-1, 1] → optional invert → optional normalize to
+     * [0, 1] → bipolar passthrough OR deadzone (returns 0 when the absolute
+     * value is at or below `threshold`).
+     */
+    transformValue(value) {
+        let result = clamp(value, -1, 1);
+        if (this.invert) {
+            result *= -1;
+        }
+        if (this.normalize) {
+            result = (result + 1) / 2;
+        }
+        if (this.bipolar) {
+            return Math.abs(result) > this.threshold ? result : 0;
+        }
+        return result > this.threshold ? result : 0;
+    }
+}
+const axis = (offset) => (ChannelOffset.Gamepads + offset);
+/* eslint-disable @typescript-eslint/no-namespace, @typescript-eslint/naming-convention */
+/**
+ * Channel-identifier constants. The axis section starts after the 32-slot
+ * button block: 24 named axes (offsets 32..55) plus 8 reserved slots
+ * (offsets 56..63).
+ */
+(function (GamepadAxis) {
+    // Direction-split (0..1, "buttons-style").
+    GamepadAxis.LeftStickLeft = axis(32);
+    GamepadAxis.LeftStickRight = axis(33);
+    GamepadAxis.LeftStickUp = axis(34);
+    GamepadAxis.LeftStickDown = axis(35);
+    GamepadAxis.RightStickLeft = axis(36);
+    GamepadAxis.RightStickRight = axis(37);
+    GamepadAxis.RightStickUp = axis(38);
+    GamepadAxis.RightStickDown = axis(39);
+    // Aggregate (-1..1, "stick-style").
+    /** Signed left-stick X axis (-1..1). Negative = left, positive = right. */
+    GamepadAxis.LeftStickX = axis(40);
+    /** Signed left-stick Y axis (-1..1). Negative = up (screen-up), positive = down. */
+    GamepadAxis.LeftStickY = axis(41);
+    /** Signed right-stick X axis (-1..1). */
+    GamepadAxis.RightStickX = axis(42);
+    /** Signed right-stick Y axis (-1..1). */
+    GamepadAxis.RightStickY = axis(43);
+    // Touchpad XY (PlayStation 4/5, Steam Deck, dual-touchpad Steam-class hardware).
+    /** Primary touchpad X (0..1, left to right). PlayStation, Steam Deck (left pad), Steam Controller. */
+    GamepadAxis.TouchpadX = axis(44);
+    /** Primary touchpad Y (0..1, top to bottom). */
+    GamepadAxis.TouchpadY = axis(45);
+    /** Secondary touchpad X (0..1). Steam Deck (right pad), other dual-touchpad hardware. */
+    GamepadAxis.Touchpad2X = axis(46);
+    /** Secondary touchpad Y (0..1). */
+    GamepadAxis.Touchpad2Y = axis(47);
+    // Auxiliary axes (4 bipolar axes split into 8 non-negative channels).
+    GamepadAxis.AuxiliaryAxis0Negative = axis(48);
+    GamepadAxis.AuxiliaryAxis0Positive = axis(49);
+    GamepadAxis.AuxiliaryAxis1Negative = axis(50);
+    GamepadAxis.AuxiliaryAxis1Positive = axis(51);
+    GamepadAxis.AuxiliaryAxis2Negative = axis(52);
+    GamepadAxis.AuxiliaryAxis2Positive = axis(53);
+    GamepadAxis.AuxiliaryAxis3Negative = axis(54);
+    GamepadAxis.AuxiliaryAxis3Positive = axis(55);
+    // Offsets 56..63 reserved for future named axes / custom mapping use.
+})(GamepadAxis || (GamepadAxis = {}));
+/* eslint-enable @typescript-eslint/no-namespace, @typescript-eslint/naming-convention */
+
+export { GamepadAxis };
+//# sourceMappingURL=GamepadAxis.js.map

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

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

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

@@ -0,0 +1,110 @@
+declare const gamepadButtonChannelBrand: unique symbol;
+/**
+ * Branded literal-union type identifying a canonical button-style gamepad
+ * input channel. Members are absolute offsets into the engine's shared
+ * {@link Float32Array} input channel buffer (relative to slot 0): the 32
+ * slots reserved for a gamepad slot's button section, computed as
+ * `ChannelOffset.Gamepads + 0..31` (512..543 with the default layout —
+ * `ChannelSize.Category = 256`, `Gamepads = 2 * Category = 512`).
+ *
+ * The 24 named buttons (`South`-`Paddle4`) cover offsets 0..23; offsets
+ * 24..31 are reserved for forward-compat / custom-mapping use and remain
+ * part of this type so custom `GamepadMapping` subclasses can address them
+ * without casting.
+ *
+ * The brand keeps the type system from confusing button channels with
+ * {@link GamepadAxisChannel} or raw `number`s during mapping authoring.
+ * User code does not construct values of this type directly — read them
+ * from the {@link GamepadButton} namespace (`GamepadButton.South`, ...).
+ *
+ * @internal
+ */
+export type GamepadButtonChannel = (512 | 513 | 514 | 515 | 516 | 517 | 518 | 519 | 520 | 521 | 522 | 523 | 524 | 525 | 526 | 527 | 528 | 529 | 530 | 531 | 532 | 533 | 534 | 535 | 536 | 537 | 538 | 539 | 540 | 541 | 542 | 543) & {
+    readonly [gamepadButtonChannelBrand]: void;
+};
+/** Construction options for a {@link GamepadButton}. */
+export interface GamepadButtonOptions {
+    /** Negate the raw value before threshold comparison. Default `false`. */
+    invert?: boolean;
+    /** Activation threshold in 0..1 — values at or below this read as 0 (deadzone). Default 0.2. */
+    threshold?: number;
+}
+/**
+ * Single mappable button on a physical gamepad. Holds the raw browser
+ * `Gamepad.buttons[]` index, the canonical channel the value is written to,
+ * and the deadzone/inversion transform applied each frame by
+ * {@link transformValue}.
+ *
+ * Used by concrete {@link GamepadMapping} subclasses to declare a device's
+ * button layout. User code typically constructs these via
+ * `new GamepadButton(rawIndex, GamepadButton.South)` only when authoring a
+ * custom mapping.
+ *
+ * The static namespace exports (`GamepadButton.South`, `.East`, ...) carry
+ * the canonical channel offsets used to address each button.
+ */
+export declare class GamepadButton {
+    readonly index: number;
+    readonly channel: GamepadButtonChannel;
+    readonly invert: boolean;
+    readonly threshold: number;
+    constructor(index: number, channel: GamepadButtonChannel, options?: GamepadButtonOptions);
+    /**
+     * Apply the button's transform pipeline to a raw browser button value
+     * (typically `Gamepad.buttons[i].value`, in 0..1).
+     *
+     * Pipeline: clamp to [0, 1] → optional invert → deadzone (returns 0 when
+     * the result is at or below `threshold`).
+     */
+    transformValue(value: number): number;
+}
+/**
+ * Channel-identifier constants — same convention as `Pointer.X` /
+ * `Keyboard.Space`. The first 32 slots of each gamepad sub-buffer are
+ * reserved for buttons (24 named, 8 buffer for future / custom mappings).
+ */
+export declare namespace GamepadButton {
+    /** Bottom face button. Xbox=A, PlayStation=✕, Switch (horizontal Joy-Con)=B. Conventional usage: confirm / primary action / jump. */
+    const South: GamepadButtonChannel;
+    /** Right face button. Xbox=B, PlayStation=○, Switch=A. Conventional usage: cancel / back / secondary. */
+    const East: GamepadButtonChannel;
+    /** Left face button. Xbox=X, PlayStation=□, Switch=Y. Conventional usage: tertiary action. */
+    const West: GamepadButtonChannel;
+    /** Top face button. Xbox=Y, PlayStation=△, Switch=X. Conventional usage: quaternary action. */
+    const North: GamepadButtonChannel;
+    const LeftShoulder: GamepadButtonChannel;
+    const RightShoulder: GamepadButtonChannel;
+    /** Left trigger as a button (analog 0..1 reported through the same channel). */
+    const LeftTrigger: GamepadButtonChannel;
+    /** Right trigger as a button. */
+    const RightTrigger: GamepadButtonChannel;
+    /** Select / Back / Minus button. */
+    const Select: GamepadButtonChannel;
+    /** Start / Options / Plus button. */
+    const Start: GamepadButtonChannel;
+    /** Left analog stick click (L3). */
+    const LeftStick: GamepadButtonChannel;
+    /** Right analog stick click (R3). */
+    const RightStick: GamepadButtonChannel;
+    const DPadUp: GamepadButtonChannel;
+    const DPadDown: GamepadButtonChannel;
+    const DPadLeft: GamepadButtonChannel;
+    const DPadRight: GamepadButtonChannel;
+    /** Home / Guide / PS button. */
+    const Guide: GamepadButtonChannel;
+    /** Share / Create button (PS4/PS5, Xbox Series). */
+    const Share: GamepadButtonChannel;
+    /** Capture / Screenshot button (Switch, Xbox Series). */
+    const Capture: GamepadButtonChannel;
+    /** Touchpad click (PlayStation). */
+    const Touchpad: GamepadButtonChannel;
+    /** First paddle / extra button (Xbox Elite, Steam Controller, PS5 Edge, Steam Deck L4). */
+    const Paddle1: GamepadButtonChannel;
+    /** Second paddle / extra button (Xbox Elite, Steam Deck R4, PS5 Edge). */
+    const Paddle2: GamepadButtonChannel;
+    /** Third paddle / extra button (Xbox Elite, Steam Deck L5). */
+    const Paddle3: GamepadButtonChannel;
+    /** Fourth paddle / extra button (Xbox Elite, Steam Deck R5). */
+    const Paddle4: GamepadButtonChannel;
+}
+export {};

package/dist/esm/input/GamepadButton.js

@@ -0,0 +1,99 @@
+import { clamp } from '../math/utils.js';
+import { ChannelOffset } from './types.js';
+
+/**
+ * Single mappable button on a physical gamepad. Holds the raw browser
+ * `Gamepad.buttons[]` index, the canonical channel the value is written to,
+ * and the deadzone/inversion transform applied each frame by
+ * {@link transformValue}.
+ *
+ * Used by concrete {@link GamepadMapping} subclasses to declare a device's
+ * button layout. User code typically constructs these via
+ * `new GamepadButton(rawIndex, GamepadButton.South)` only when authoring a
+ * custom mapping.
+ *
+ * The static namespace exports (`GamepadButton.South`, `.East`, ...) carry
+ * the canonical channel offsets used to address each button.
+ */
+class GamepadButton {
+    index;
+    channel;
+    invert;
+    threshold;
+    constructor(index, channel, options = {}) {
+        this.index = index;
+        this.channel = channel;
+        this.invert = options.invert ?? false;
+        this.threshold = clamp(options.threshold ?? 0.2, 0, 1);
+    }
+    /**
+     * Apply the button's transform pipeline to a raw browser button value
+     * (typically `Gamepad.buttons[i].value`, in 0..1).
+     *
+     * Pipeline: clamp to [0, 1] → optional invert → deadzone (returns 0 when
+     * the result is at or below `threshold`).
+     */
+    transformValue(value) {
+        let result = clamp(value, 0, 1);
+        if (this.invert) {
+            result = 1 - result;
+        }
+        return result > this.threshold ? result : 0;
+    }
+}
+const button = (offset) => (ChannelOffset.Gamepads + offset);
+/* eslint-disable @typescript-eslint/no-namespace, @typescript-eslint/naming-convention */
+/**
+ * Channel-identifier constants — same convention as `Pointer.X` /
+ * `Keyboard.Space`. The first 32 slots of each gamepad sub-buffer are
+ * reserved for buttons (24 named, 8 buffer for future / custom mappings).
+ */
+(function (GamepadButton) {
+    /** Bottom face button. Xbox=A, PlayStation=✕, Switch (horizontal Joy-Con)=B. Conventional usage: confirm / primary action / jump. */
+    GamepadButton.South = button(0);
+    /** Right face button. Xbox=B, PlayStation=○, Switch=A. Conventional usage: cancel / back / secondary. */
+    GamepadButton.East = button(1);
+    /** Left face button. Xbox=X, PlayStation=□, Switch=Y. Conventional usage: tertiary action. */
+    GamepadButton.West = button(2);
+    /** Top face button. Xbox=Y, PlayStation=△, Switch=X. Conventional usage: quaternary action. */
+    GamepadButton.North = button(3);
+    GamepadButton.LeftShoulder = button(4);
+    GamepadButton.RightShoulder = button(5);
+    /** Left trigger as a button (analog 0..1 reported through the same channel). */
+    GamepadButton.LeftTrigger = button(6);
+    /** Right trigger as a button. */
+    GamepadButton.RightTrigger = button(7);
+    /** Select / Back / Minus button. */
+    GamepadButton.Select = button(8);
+    /** Start / Options / Plus button. */
+    GamepadButton.Start = button(9);
+    /** Left analog stick click (L3). */
+    GamepadButton.LeftStick = button(10);
+    /** Right analog stick click (R3). */
+    GamepadButton.RightStick = button(11);
+    GamepadButton.DPadUp = button(12);
+    GamepadButton.DPadDown = button(13);
+    GamepadButton.DPadLeft = button(14);
+    GamepadButton.DPadRight = button(15);
+    /** Home / Guide / PS button. */
+    GamepadButton.Guide = button(16);
+    /** Share / Create button (PS4/PS5, Xbox Series). */
+    GamepadButton.Share = button(17);
+    /** Capture / Screenshot button (Switch, Xbox Series). */
+    GamepadButton.Capture = button(18);
+    /** Touchpad click (PlayStation). */
+    GamepadButton.Touchpad = button(19);
+    /** First paddle / extra button (Xbox Elite, Steam Controller, PS5 Edge, Steam Deck L4). */
+    GamepadButton.Paddle1 = button(20);
+    /** Second paddle / extra button (Xbox Elite, Steam Deck R4, PS5 Edge). */
+    GamepadButton.Paddle2 = button(21);
+    /** Third paddle / extra button (Xbox Elite, Steam Deck L5). */
+    GamepadButton.Paddle3 = button(22);
+    /** Fourth paddle / extra button (Xbox Elite, Steam Deck R5). */
+    GamepadButton.Paddle4 = button(23);
+    // Offsets 24..31 reserved for future named buttons / custom mapping use.
+})(GamepadButton || (GamepadButton = {}));
+/* eslint-enable @typescript-eslint/no-namespace, @typescript-eslint/naming-convention */
+
+export { GamepadButton };
+//# sourceMappingURL=GamepadButton.js.map

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

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

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

@@ -1,9 +1,25 @@
 import type { GamepadMapping } from './GamepadMapping';
+/** Convenience alias for the non-null element type returned by `navigator.getGamepads()`. */
 export type BrowserGamepad = NonNullable<ReturnType<Navigator['getGamepads']>[number]>;
+/**
+ * Value a {@link GamepadDefinition.resolve} callback may return.
+ *
+ * Return a bare {@link GamepadMapping} to accept the device with the definition's
+ * default name, an object with an optional `name` override, or `null`/`undefined`
+ * to decline the device and let the next definition in the list try.
+ */
 export type GamepadDefinitionResult = GamepadMapping | {
     name?: string;
     mapping: GamepadMapping;
 } | null | undefined;
+/**
+ * Parsed metadata extracted from a browser `Gamepad.id` string.
+ *
+ * `vendorId` and `productId` are four-hex-digit strings (e.g. `"045e"`, `"028e"`).
+ * `productKey` is the colon-joined pair (`"045e:028e"`), used as a compact lookup key.
+ * `name` is the human-readable portion of the id with the vendor/product tokens removed,
+ * or `null` when the id contained only identifiers.
+ */
 export interface GamepadDescriptor {
     id: string;
     index: number;
@@ -13,19 +29,66 @@ export interface GamepadDescriptor {
     productKey: string | null;
     name: string | null;
 }
+/**
+ * A rule that matches one or more physical gamepads and produces a {@link GamepadMapping}.
+ *
+ * `ids` is an optional allow-list of vendor IDs (`"045e"`) or `vendorId:productId`
+ * pairs (`"045e:028e"`); when omitted the definition matches every device.
+ * `resolve` is called with the parsed {@link GamepadDescriptor} and must return a
+ * {@link GamepadDefinitionResult} — `null`/`undefined` to skip, a mapping otherwise.
+ */
 export interface GamepadDefinition {
     ids?: string | Array<string>;
     name?: string;
     resolve: (descriptor: GamepadDescriptor) => GamepadDefinitionResult;
 }
+/**
+ * The fully resolved product of running a {@link GamepadDefinition} against a
+ * connected gamepad — bundles the original descriptor, the resolved display name,
+ * and the chosen {@link GamepadMapping} together for use by {@link Gamepad}.
+ */
 export interface ResolvedGamepadDefinition {
     descriptor: GamepadDescriptor;
     name: string;
     mapping: GamepadMapping;
 }
-export declare const normalizeIds: (ids?: string | Array<string>) => Array<string>;
+/**
+ * Returns `true` when `descriptor` matches any entry in `ids`.
+ *
+ * A colon-containing id (e.g. `"045e:028e"`) is matched against
+ * `descriptor.productKey`; a bare four-hex id is matched against
+ * `descriptor.vendorId`. Passing no `ids` always returns `true`.
+ */
 export declare const matchesIds: (descriptor: GamepadDescriptor, ids?: string | Array<string>) => boolean;
+/**
+ * Parses the raw browser `Gamepad.id` string into a structured {@link GamepadDescriptor}.
+ *
+ * Attempts multiple vendor/product ID patterns (hex-prefixed, plain, VID/PID, bare pair)
+ * in order of specificity, then strips the matched tokens to derive a clean `name`.
+ */
 export declare const parseGamepadDescriptor: (gamepad: BrowserGamepad) => GamepadDescriptor;
+/**
+ * Runs a single {@link GamepadDefinition} against a descriptor, respecting its
+ * `ids` filter. Returns `null` when the definition declines the device.
+ */
 export declare const resolveDefinition: (definition: GamepadDefinition, descriptor: GamepadDescriptor) => ResolvedGamepadDefinition | null;
+/**
+ * Resolves the best-matching {@link ResolvedGamepadDefinition} for a connected gamepad.
+ *
+ * Iterates `definitions` in order — exact product IDs first, then vendor fallbacks,
+ * then a generic catch-all — and returns the first match. Falls back to
+ * {@link GenericDualAnalogGamepadMapping} when no definition matches.
+ *
+ * @example
+ * const resolved = resolveGamepadDefinition(navigator.getGamepads()[0]!);
+ * const gamepad = new Gamepad(browserGamepad, channels, resolved);
+ */
 export declare const resolveGamepadDefinition: (gamepadOrDescriptor: BrowserGamepad | GamepadDescriptor, definitions?: ReadonlyArray<GamepadDefinition>) => ResolvedGamepadDefinition;
+/**
+ * The default ordered list of {@link GamepadDefinition} entries used by
+ * {@link resolveGamepadDefinition} when no custom list is supplied.
+ *
+ * Ordered as: exact product-ID matches → vendor-ID fallbacks → generic catch-all.
+ * Register custom definitions by prepending to a copy and passing it explicitly.
+ */
 export declare const builtInGamepadDefinitions: Array<GamepadDefinition>;

package/dist/esm/input/GamepadDefinitions.js

@@ -5,6 +5,7 @@ import { JoyConLeftGamepadMapping } from './JoyConLeftGamepadMapping.js';
 import { JoyConRightGamepadMapping } from './JoyConRightGamepadMapping.js';
 import { PlayStationGamepadMapping } from './PlayStationGamepadMapping.js';
 import { SteamControllerGamepadMapping } from './SteamControllerGamepadMapping.js';
+import { SteamDeckGamepadMapping } from './SteamDeckGamepadMapping.js';
 import { SwitchProGamepadMapping } from './SwitchProGamepadMapping.js';
 import { XboxGamepadMapping } from './XboxGamepadMapping.js';
 
@@ -59,6 +60,10 @@ const resolveDefinitionResult = (definition, descriptor) => {
         mapping: result,
     };
 };
+/**
+ * Normalises an `ids` value into a trimmed, lower-case string array ready for
+ * comparison against a {@link GamepadDescriptor}.
+ */
 const normalizeIds = (ids) => {
     if (!ids) {
         return [];
@@ -66,6 +71,13 @@ const normalizeIds = (ids) => {
     const values = Array.isArray(ids) ? ids : [ids];
     return values.map(normalizeId);
 };
+/**
+ * Returns `true` when `descriptor` matches any entry in `ids`.
+ *
+ * A colon-containing id (e.g. `"045e:028e"`) is matched against
+ * `descriptor.productKey`; a bare four-hex id is matched against
+ * `descriptor.vendorId`. Passing no `ids` always returns `true`.
+ */
 const matchesIds = (descriptor, ids) => {
     if (!ids) {
         return true;
@@ -83,6 +95,12 @@ const matchesIds = (descriptor, ids) => {
     }
     return false;
 };
+/**
+ * Parses the raw browser `Gamepad.id` string into a structured {@link GamepadDescriptor}.
+ *
+ * Attempts multiple vendor/product ID patterns (hex-prefixed, plain, VID/PID, bare pair)
+ * in order of specificity, then strips the matched tokens to derive a clean `name`.
+ */
 const parseGamepadDescriptor = (gamepad) => {
     const label = gamepad.id.trim() || `Gamepad ${gamepad.index}`;
     const productKey = parseProductKey(label);
@@ -98,12 +116,27 @@ const parseGamepadDescriptor = (gamepad) => {
         name: parseName(label),
     };
 };
+/**
+ * Runs a single {@link GamepadDefinition} against a descriptor, respecting its
+ * `ids` filter. Returns `null` when the definition declines the device.
+ */
 const resolveDefinition = (definition, descriptor) => {
     if (!matchesIds(descriptor, definition.ids)) {
         return null;
     }
     return resolveDefinitionResult(definition, descriptor);
 };
+/**
+ * Resolves the best-matching {@link ResolvedGamepadDefinition} for a connected gamepad.
+ *
+ * Iterates `definitions` in order — exact product IDs first, then vendor fallbacks,
+ * then a generic catch-all — and returns the first match. Falls back to
+ * {@link GenericDualAnalogGamepadMapping} when no definition matches.
+ *
+ * @example
+ * const resolved = resolveGamepadDefinition(navigator.getGamepads()[0]!);
+ * const gamepad = new Gamepad(browserGamepad, channels, resolved);
+ */
 const resolveGamepadDefinition = (gamepadOrDescriptor, definitions = builtInGamepadDefinitions) => {
     const descriptor = 'connected' in gamepadOrDescriptor
         ? parseGamepadDescriptor(gamepadOrDescriptor)
@@ -141,6 +174,8 @@ const exactDeviceDefinitions = [
     createStaticGamepadDefinition('Switch 2 Pro Controller', () => new SwitchProGamepadMapping(), '057e:2069'),
     createStaticGamepadDefinition('Switch 2 GameCube Controller', () => new GameCubeGamepadMapping(), '057e:2073'),
     createStaticGamepadDefinition('Steam Controller', () => new SteamControllerGamepadMapping(), ['28de:1102', '28de:1142']),
+    createStaticGamepadDefinition('Steam Virtual Gamepad', () => new GenericDualAnalogGamepadMapping(), '28de:11ff'),
+    createStaticGamepadDefinition('Steam Deck', () => new SteamDeckGamepadMapping(), '28de:1205'),
     createStaticGamepadDefinition('F310 Gamepad', () => new GenericDualAnalogGamepadMapping(), '046d:c216'),
     createStaticGamepadDefinition('F710 Gamepad', () => new GenericDualAnalogGamepadMapping(), ['046d:c219', '046d:c21f']),
     createStaticGamepadDefinition('8BitDo P30 Controller', () => new GenericDualAnalogGamepadMapping(), ['2dc8:5107', '2dc8:5108']),
@@ -163,13 +198,21 @@ const exactDeviceDefinitions = [
 const vendorFallbackDefinitions = [
     createStaticGamepadDefinition('Microsoft Controller', () => new XboxGamepadMapping(), '045e'),
     createStaticGamepadDefinition('Sony Controller', () => new PlayStationGamepadMapping(), '054c'),
+    createStaticGamepadDefinition('Valve Controller', () => new SteamDeckGamepadMapping(), '28de'),
 ];
 const genericFallbackDefinition = createStaticGamepadDefinition('Generic Gamepad', () => new GenericDualAnalogGamepadMapping());
+/**
+ * The default ordered list of {@link GamepadDefinition} entries used by
+ * {@link resolveGamepadDefinition} when no custom list is supplied.
+ *
+ * Ordered as: exact product-ID matches → vendor-ID fallbacks → generic catch-all.
+ * Register custom definitions by prepending to a copy and passing it explicitly.
+ */
 const builtInGamepadDefinitions = [
     ...exactDeviceDefinitions,
     ...vendorFallbackDefinitions,
     genericFallbackDefinition,
 ];
 
-export { builtInGamepadDefinitions, matchesIds, normalizeIds, parseGamepadDescriptor, resolveDefinition, resolveGamepadDefinition };
+export { builtInGamepadDefinitions, matchesIds, parseGamepadDescriptor, resolveDefinition, resolveGamepadDefinition };
 //# sourceMappingURL=GamepadDefinitions.js.map

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

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

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

@@ -1,6 +1,11 @@
-import { GamepadControl } from './GamepadControl';
-import type { GamepadControlOptions } from './GamepadControl';
-import type { GamepadChannel } from './GamepadChannels';
+import type { GamepadButton } from './GamepadButton';
+import type { GamepadAxis } from './GamepadAxis';
+import type { GamepadButtonChannel } from './GamepadButton';
+import type { GamepadAxisChannel } from './GamepadAxis';
+/**
+ * Discriminant tag identifying which device family a {@link GamepadMapping} belongs to.
+ * Used to select the correct mapping at runtime when a gamepad connects.
+ */
 export declare enum GamepadMappingFamily {
     GenericDualAnalog = "genericDualAnalog",
     Xbox = "xbox",
@@ -10,14 +15,43 @@ export declare enum GamepadMappingFamily {
     JoyConRight = "joyConRight",
     GameCube = "gameCube",
     SteamController = "steamController",
+    SteamDeck = "steamDeck",
     ArcadeStick = "arcadeStick"
 }
-export type GamepadControlDefinition = readonly [number, GamepadChannel, GamepadControlOptions?];
+/**
+ * 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.
+ */
 export declare abstract class GamepadMapping {
+    /** Identifies the device family this mapping targets. */
     abstract readonly family: GamepadMappingFamily;
-    readonly buttons: Array<GamepadControl>;
-    readonly axes: Array<GamepadControl>;
-    protected constructor(buttons: Array<GamepadControl>, axes: Array<GamepadControl>);
+    /** Ordered list of buttons, indexed by the Gamepad API button index. */
+    readonly buttons: ReadonlyArray<GamepadButton>;
+    /** Ordered list of axes, indexed by the Gamepad API axis index. */
+    readonly axes: ReadonlyArray<GamepadAxis>;
+    protected constructor(buttons: ReadonlyArray<GamepadButton>, axes: ReadonlyArray<GamepadAxis>);
+    /**
+     * 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: GamepadButtonChannel | GamepadAxisChannel): boolean;
+    /**
+     * Releases all button and axis control references held by this mapping.
+     * Call when the associated gamepad disconnects to allow garbage collection.
+     */
     destroy(): void;
-    static createControls(definitions: ReadonlyArray<GamepadControlDefinition>): Array<GamepadControl>;
 }