@codexo/exojs 0.7.12 → 0.8.0

package/dist/esm/input/Gamepad.js

@@ -1,194 +1,350 @@
 import { Signal } from '../core/Signal.js';
 import { ChannelOffset, ChannelSize } from './types.js';
+import { InputBinding } from './InputBinding.js';
 
 /**
- * Runtime wrapper for a single browser gamepad slot.
+ * One of four stable gamepad slots. Lives for the entire `Application`
+ * lifetime even when no physical pad is attached — a "mailbox" that
+ * physical hardware moves into and out of.
  *
- * Owns the slot's {@link GamepadMapping}, reads raw button and axis values from
- * the browser's Gamepad API each frame via {@link update}, and writes transformed
- * values into the shared `Float32Array` channel buffer. Emits {@link onConnect},
- * {@link onDisconnect}, and per-channel {@link onUpdate} signals so consumers can
- * react without polling.
+ * Subscribe to {@link onConnect} / {@link onDisconnect} for hardware
+ * lifecycle, {@link onButtonDown} / {@link onButtonUp} / {@link onAxisChange}
+ * for granular per-event notifications, or call {@link onTrigger} /
+ * {@link onActive} / {@link onStart} / {@link onStop} to register
+ * stateful {@link InputBinding}s pinned to this slot.
+ *
+ * Listeners survive disconnect/reconnect cycles — a binding registered when
+ * the slot was empty will automatically activate when a pad connects.
  */
 class Gamepad {
+    /** Fires when a physical pad connects to this slot. */
     onConnect = new Signal();
+    /** Fires when the physical pad in this slot disconnects. */
     onDisconnect = new Signal();
-    onUpdate = new Signal();
-    indexValue;
-    channelsValue;
-    channelOffset;
-    mappingValue;
-    browserGamepad = null;
-    info = {
-        name: 'Generic Gamepad',
-        label: 'Generic Gamepad',
-        vendorId: null,
-        productId: null,
-        productKey: null,
-    };
-    constructor(indexOrGamepad, channels, mappingOrDefinition) {
-        const isBrowserGamepad = typeof indexOrGamepad !== 'number';
-        const gamepad = isBrowserGamepad ? indexOrGamepad : null;
-        const index = isBrowserGamepad ? indexOrGamepad.index : indexOrGamepad;
-        this.indexValue = index;
-        this.channelsValue = channels;
-        this.channelOffset = ChannelOffset.Gamepads + (index * ChannelSize.Gamepad);
-        this.mappingValue = gamepad
-            ? mappingOrDefinition.mapping
-            : mappingOrDefinition;
-        if (gamepad) {
-            const definition = mappingOrDefinition;
-            this.setInfo({
-                name: definition.name,
-                label: definition.descriptor.label,
-                vendorId: definition.descriptor.vendorId,
-                productId: definition.descriptor.productId,
-                productKey: definition.descriptor.productKey,
-            });
-            this.connect(gamepad);
-        }
+    /** Fires for every button transition from inactive to active. */
+    onButtonDown = new Signal();
+    /** Fires for every button transition from active to inactive. */
+    onButtonUp = new Signal();
+    /** Fires whenever an axis crosses its activation threshold. */
+    onAxisChange = new Signal();
+    /**
+     * Fires when this slot's physical pad has been replaced by a previously
+     * higher-numbered slot's pad, after a `'compact'`-strategy disconnect.
+     * Dispatched with the source slot index the pad came from. Listeners
+     * remain attached and the channel buffer is preserved across the move.
+     */
+    onPadReassigned = new Signal();
+    _slot;
+    _channels;
+    _bindings = new Set();
+    _detacher = { detach: (binding) => { this._bindings.delete(binding); } };
+    _channelOffset;
+    _mapping = null;
+    _info = null;
+    _browserGamepad = null;
+    constructor(slot, channels) {
+        this._slot = slot;
+        this._channels = channels;
+        this._channelOffset = ChannelOffset.Gamepads + (slot * ChannelSize.Gamepad);
     }
-    get mapping() {
-        return this.mappingValue;
+    /** This pad's stable slot (0..3). */
+    get slot() {
+        return this._slot;
     }
-    set mapping(mapping) {
-        this.mappingValue = mapping;
+    /** `true` while a physical pad is attached to this slot. */
+    get connected() {
+        return this._browserGamepad !== null;
     }
-    /** The {@link GamepadMappingFamily} of the currently active mapping. */
+    /** The active mapping, or `null` when disconnected. */
+    get mapping() {
+        return this._mapping;
+    }
+    /** The {@link GamepadMappingFamily}, or `null` when disconnected. */
     get mappingFamily() {
-        return this.mappingValue.family;
+        return this._mapping?.family ?? null;
     }
-    get channels() {
-        return this.channelsValue;
+    /** Identity metadata, or `null` when disconnected. */
+    get info() {
+        return this._info;
     }
-    get gamepad() {
-        return this.browserGamepad;
+    /** The underlying browser gamepad object, or `null` when disconnected. */
+    get browserGamepad() {
+        return this._browserGamepad;
     }
-    get index() {
-        return this.indexValue;
+    /**
+     * Browser-assigned hardware index from `navigator.getGamepads()` (i.e.
+     * `Gamepad.index`), or `null` when no pad is attached. Stable for the
+     * lifetime of a single physical connection but may change across
+     * disconnect/reconnect. Low-level escape hatch for advanced consumers
+     * that need to correlate slots with the raw browser API; prefer
+     * {@link slot} for stable per-application pad identity.
+     */
+    get internalIndex() {
+        return this._browserGamepad?.index ?? null;
     }
-    /** Whether a browser gamepad is currently attached to this slot. */
-    get connected() {
-        return this.browserGamepad !== null;
+    /** `true` when the connected pad supports rumble via the Web Gamepad API. */
+    get canVibrate() {
+        return this._browserGamepad?.vibrationActuator != null;
     }
-    get name() {
-        return this.info.name;
+    /**
+     * Returns `true` when this pad's mapping declares the requested channel.
+     * Use to gate listener registration on optional hardware (e.g. Joy-Con
+     * solo lacks a right stick — `pad.hasChannel(GamepadAxis.RightStickX)`
+     * returns `false`).
+     */
+    hasChannel(channel) {
+        return this._mapping?.hasChannel(channel) ?? false;
     }
-    get label() {
-        return this.info.label;
+    /**
+     * Trigger a rumble effect on this pad. Resolves when the effect finishes.
+     * Silent no-op when the pad is disconnected or the platform does not
+     * support haptic feedback. Use {@link canVibrate} to detect support.
+     */
+    async vibrate(options) {
+        const actuator = this._browserGamepad?.vibrationActuator;
+        if (!actuator?.playEffect) {
+            return;
+        }
+        await actuator.playEffect('dual-rumble', {
+            duration: options.duration,
+            weakMagnitude: options.weakMagnitude ?? 1,
+            strongMagnitude: options.strongMagnitude ?? 1,
+            startDelay: options.startDelay ?? 0,
+        });
     }
-    get vendorId() {
-        return this.info.vendorId;
+    /** Stop any active rumble on this pad. Silent no-op when unsupported. */
+    stopVibration() {
+        this._browserGamepad?.vibrationActuator?.reset?.();
     }
-    get productId() {
-        return this.info.productId;
+    /**
+     * Register a callback fired once when any of `channels` becomes active.
+     * Listener survives disconnect/reconnect; call `.unbind()` on the
+     * returned {@link InputBinding} to detach.
+     */
+    onStart(channel, callback, options) {
+        const binding = this._createBinding(channel, options);
+        binding.onStart.add(callback);
+        return binding;
     }
-    get productKey() {
-        return this.info.productKey;
+    /**
+     * Register a callback fired every frame while any of `channels` is active.
+     * Receives the channel value (0..1 for buttons, -1..1 for bipolar axes).
+     */
+    onActive(channel, callback, options) {
+        const binding = this._createBinding(channel, options);
+        binding.onActive.add(callback);
+        return binding;
+    }
+    /** Register a callback fired once when all of `channels` become inactive. */
+    onStop(channel, callback, options) {
+        const binding = this._createBinding(channel, options);
+        binding.onStop.add(callback);
+        return binding;
     }
     /**
-     * Replaces the gamepad's identity metadata.
-     * Called automatically during construction when a {@link BrowserGamepad} is
-     * provided; exposed publicly to allow runtime overrides.
+     * Register a callback fired when the input is released within
+     * {@link InputBindingOptions.threshold} ms of activation (a "tap").
      */
-    setInfo(info) {
-        this.info = info;
-        return this;
+    onTrigger(channel, callback, options) {
+        const binding = this._createBinding(channel, options);
+        binding.onTrigger.add(callback);
+        return binding;
     }
     /**
-     * Attaches a live browser gamepad to this slot and dispatches {@link onConnect}
-     * if the slot was previously disconnected.
+     * Attach a physical browser gamepad to this slot. Called by
+     * {@link InputManager} on connect.
+     *
+     * @internal
      */
-    connect(gamepad) {
-        const wasConnected = this.connected;
-        this.browserGamepad = gamepad;
-        if (!wasConnected) {
-            this.onConnect.dispatch(this);
+    _bind(gamepad, definition) {
+        this._browserGamepad = gamepad;
+        this._mapping = definition.mapping;
+        this._info = {
+            name: definition.name,
+            label: definition.descriptor.label,
+            vendorId: definition.descriptor.vendorId,
+            productId: definition.descriptor.productId,
+            productKey: definition.descriptor.productKey,
+        };
+        this.onConnect.dispatch();
+    }
+    /**
+     * Detach the physical gamepad and clear its channels.
+     *
+     * @internal
+     */
+    _unbind() {
+        if (this._browserGamepad === null) {
+            return;
         }
-        return this;
+        this._clearMappedChannels();
+        this._browserGamepad = null;
+        this._mapping = null;
+        this._info = null;
+        this.onDisconnect.dispatch();
     }
     /**
-     * Detaches the browser gamepad, zeros all mapped channels, and dispatches
-     * {@link onDisconnect}. No-op when already disconnected.
+     * Detach the physical gamepad and clear channels without firing
+     * {@link onDisconnect}. Used by {@link InputManager} during the compact
+     * slot-shift to silently vacate a slot before another pad shifts into
+     * its place; the disconnect signal is fired separately on the slot that
+     * ends up empty after compaction.
+     *
+     * @internal
      */
-    disconnect() {
-        if (this.connected) {
-            this.browserGamepad = null;
-            this.clearMappedChannels();
-            this.onDisconnect.dispatch(this);
+    _silentUnbind() {
+        if (this._browserGamepad === null) {
+            return;
         }
-        return this;
+        this._clearMappedChannels();
+        this._browserGamepad = null;
+        this._mapping = null;
+        this._info = null;
+    }
+    /**
+     * Dispatch this slot's {@link onDisconnect} signal without altering its
+     * state. Used by {@link InputManager} after a compact-mode shift, when a
+     * slot has already been emptied by {@link _rebindFrom} and now needs to
+     * notify subscribers that its mailbox is no longer occupied.
+     *
+     * @internal
+     */
+    _dispatchDisconnect() {
+        this.onDisconnect.dispatch();
     }
     /**
-     * Samples the browser gamepad's current state and writes transformed values
-     * into the shared channel buffer, dispatching {@link onUpdate} for each channel
-     * whose value changed. Should be called once per frame by the engine's input loop.
-     * No-op when disconnected.
+     * Reassign this slot to take over another slot's physical gamepad without
+     * firing the full disconnect / connect cycle. Used by {@link InputManager}
+     * when the `'compact'` slot strategy shuffles pads after a disconnect.
+     *
+     * @internal
+     */
+    _rebindFrom(other) {
+        const gamepad = other._browserGamepad;
+        const mapping = other._mapping;
+        const info = other._info;
+        this._clearMappedChannels();
+        other._clearMappedChannels();
+        other._browserGamepad = null;
+        other._mapping = null;
+        other._info = null;
+        this._browserGamepad = gamepad;
+        this._mapping = mapping;
+        this._info = info;
+    }
+    /**
+     * Sample the browser gamepad's current state and write transformed values
+     * into the shared channel buffer, dispatching transition events when
+     * channel activity crosses thresholds. Called once per frame by the
+     * engine's input loop. No-op when disconnected.
+     *
+     * @internal
      */
     update() {
-        if (this.browserGamepad === null) {
-            return this;
+        if (this._browserGamepad === null || this._mapping === null) {
+            this._updateBindings();
+            return;
         }
-        const channels = this.channelsValue;
-        const { buttons: gamepadButtons, axes: gamepadAxes } = this.browserGamepad;
-        for (const control of this.mappingValue.buttons) {
-            const offsetChannel = this.resolveChannelOffset(control.channel);
-            if (control.index < gamepadButtons.length) {
-                const value = control.transformValue(gamepadButtons[control.index].value) || 0;
-                if (channels[offsetChannel] !== value) {
-                    channels[offsetChannel] = value;
-                    this.onUpdate.dispatch(control.channel, value, this);
-                }
+        const channels = this._channels;
+        const { buttons: rawButtons, axes: rawAxes } = this._browserGamepad;
+        for (const button of this._mapping.buttons) {
+            if (button.index >= rawButtons.length) {
+                continue;
+            }
+            const offset = this._resolveOffset(button.channel);
+            const previous = channels[offset];
+            const value = button.transformValue(rawButtons[button.index].value) || 0;
+            if (previous === value) {
+                continue;
+            }
+            channels[offset] = value;
+            if (previous === 0 && value !== 0) {
+                this.onButtonDown.dispatch(button, value);
+            }
+            else if (previous !== 0 && value === 0) {
+                this.onButtonUp.dispatch(button, value);
             }
         }
-        for (const control of this.mappingValue.axes) {
-            const offsetChannel = this.resolveChannelOffset(control.channel);
-            if (control.index < gamepadAxes.length) {
-                const value = control.transformValue(gamepadAxes[control.index]) || 0;
-                if (channels[offsetChannel] !== value) {
-                    channels[offsetChannel] = value;
-                    this.onUpdate.dispatch(control.channel, value, this);
-                }
+        for (const axis of this._mapping.axes) {
+            if (axis.index >= rawAxes.length) {
+                continue;
             }
+            const offset = this._resolveOffset(axis.channel);
+            const previous = channels[offset];
+            const value = axis.transformValue(rawAxes[axis.index]) || 0;
+            if (previous === value) {
+                continue;
+            }
+            channels[offset] = value;
+            this.onAxisChange.dispatch(axis, value);
         }
-        return this;
-    }
-    /** Zeroes all channel buffer entries that belong to this gamepad's mapping. */
-    clearChannels() {
-        this.clearMappedChannels();
-        return this;
+        this._updateBindings();
     }
     /**
-     * Disconnects the gamepad, clears its channels, and destroys all signals.
-     * The instance must not be used after this call.
+     * Tear down this gamepad slot. Called on application shutdown.
      */
     destroy() {
-        this.disconnect();
-        this.clearMappedChannels();
+        for (const binding of Array.from(this._bindings)) {
+            binding.unbind();
+        }
+        this._bindings.clear();
+        this._unbind();
         this.onConnect.destroy();
         this.onDisconnect.destroy();
-        this.onUpdate.destroy();
+        this.onButtonDown.destroy();
+        this.onButtonUp.destroy();
+        this.onAxisChange.destroy();
+        this.onPadReassigned.destroy();
     }
     /**
-     * Converts a {@link GamepadChannel} to its absolute index in the shared channel
-     * buffer for this gamepad instance.
+     * Convert a slot-relative channel value to its absolute index in the
+     * shared channel buffer for this slot.
      */
     resolveChannelOffset(channel) {
-        return this.channelOffset + (channel ^ ChannelOffset.Gamepads);
+        return this._resolveOffset(channel);
     }
     /**
-     * Converts a gamepad slot index and {@link GamepadChannel} to an absolute
-     * channel buffer offset without requiring a {@link Gamepad} instance.
+     * Static counterpart to {@link Gamepad.resolveChannelOffset} — resolves
+     * an absolute channel-buffer offset for a given slot index without
+     * requiring a Gamepad instance.
      */
-    static resolveChannelOffset(gamepadIndex, channel) {
-        return ChannelOffset.Gamepads + (gamepadIndex * ChannelSize.Gamepad) + (channel ^ ChannelOffset.Gamepads);
+    static resolveChannelOffset(slot, channel) {
+        return ChannelOffset.Gamepads + (slot * ChannelSize.Gamepad) + (channel ^ ChannelOffset.Gamepads);
+    }
+    _resolveOffset(channel) {
+        return this._channelOffset + (channel ^ ChannelOffset.Gamepads);
+    }
+    _clearMappedChannels() {
+        if (this._mapping === null) {
+            return;
+        }
+        for (const button of this._mapping.buttons) {
+            this._channels[this._resolveOffset(button.channel)] = 0;
+        }
+        for (const axis of this._mapping.axes) {
+            this._channels[this._resolveOffset(axis.channel)] = 0;
+        }
     }
-    clearMappedChannels() {
-        for (const control of this.mappingValue.buttons) {
-            this.channelsValue[this.resolveChannelOffset(control.channel)] = 0;
+    _createBinding(channel, options = {}) {
+        const list = Array.isArray(channel) ? channel : [channel];
+        const resolved = list.map((c) => this._resolveExternalChannel(c));
+        const binding = new InputBinding(resolved, options, this._detacher);
+        this._bindings.add(binding);
+        return binding;
+    }
+    _resolveExternalChannel(channel) {
+        // Keyboard channels are global (no slot offset). Gamepad channels
+        // need slot-aware translation. Any channel value within the
+        // gamepad-section maps through this pad's slot offset; others
+        // (Keyboard, Pointer) pass through as-is.
+        if (channel >= ChannelOffset.Gamepads && channel < ChannelOffset.Gamepads + ChannelSize.Category) {
+            return this._resolveOffset(channel);
         }
-        for (const control of this.mappingValue.axes) {
-            this.channelsValue[this.resolveChannelOffset(control.channel)] = 0;
+        return channel;
+    }
+    _updateBindings() {
+        for (const binding of this._bindings) {
+            binding.update(this._channels);
         }
     }
 }

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

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

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

@@ -0,0 +1,120 @@
+declare const gamepadAxisChannelBrand: unique symbol;
+/**
+ * Branded literal-union type identifying a canonical analog axis-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 axis section, computed as
+ * `ChannelOffset.Gamepads + 32..63` (544..575 with the default layout).
+ *
+ * The 24 named axes (sticks split + signed aggregates + dual touchpad XY +
+ * 4 auxiliary bipolar) cover offsets 32..55; offsets 56..63 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 axis channels with
+ * {@link GamepadButtonChannel} or raw `number`s during mapping authoring.
+ * User code does not construct values of this type directly — read them
+ * from the {@link GamepadAxis} namespace (`GamepadAxis.LeftStickLeft`, ...).
+ *
+ * @internal
+ */
+export type GamepadAxisChannel = (544 | 545 | 546 | 547 | 548 | 549 | 550 | 551 | 552 | 553 | 554 | 555 | 556 | 557 | 558 | 559 | 560 | 561 | 562 | 563 | 564 | 565 | 566 | 567 | 568 | 569 | 570 | 571 | 572 | 573 | 574 | 575) & {
+    readonly [gamepadAxisChannelBrand]: void;
+};
+/** Construction options for a {@link GamepadAxis}. */
+export interface GamepadAxisOptions {
+    /** Negate the raw value before further processing. Default `false`. */
+    invert?: boolean;
+    /**
+     * Convert from bipolar [-1, +1] to unipolar [0, 1] via `(v + 1) / 2`.
+     * Used for direction-split channels where each direction reads 0..1.
+     * Default `false`.
+     */
+    normalize?: boolean;
+    /**
+     * Activation threshold (deadzone). After the invert/normalize pipeline,
+     * any value at or below this reads as 0. Default 0.2.
+     */
+    threshold?: number;
+    /**
+     * Skip the deadzone clamp. Used for aggregate signed channels
+     * (`LeftStickX`, `LeftStickY`, ...) that need to preserve the full
+     * [-1, +1] range and apply their own deadzone client-side.
+     * Default `false`.
+     */
+    bipolar?: boolean;
+}
+/**
+ * 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.
+ */
+export declare class GamepadAxis {
+    readonly index: number;
+    readonly channel: GamepadAxisChannel;
+    readonly invert: boolean;
+    readonly normalize: boolean;
+    readonly threshold: number;
+    readonly bipolar: boolean;
+    constructor(index: number, channel: GamepadAxisChannel, options?: GamepadAxisOptions);
+    /**
+     * 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: number): number;
+}
+/**
+ * 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).
+ */
+export declare namespace GamepadAxis {
+    const LeftStickLeft: GamepadAxisChannel;
+    const LeftStickRight: GamepadAxisChannel;
+    const LeftStickUp: GamepadAxisChannel;
+    const LeftStickDown: GamepadAxisChannel;
+    const RightStickLeft: GamepadAxisChannel;
+    const RightStickRight: GamepadAxisChannel;
+    const RightStickUp: GamepadAxisChannel;
+    const RightStickDown: GamepadAxisChannel;
+    /** Signed left-stick X axis (-1..1). Negative = left, positive = right. */
+    const LeftStickX: GamepadAxisChannel;
+    /** Signed left-stick Y axis (-1..1). Negative = up (screen-up), positive = down. */
+    const LeftStickY: GamepadAxisChannel;
+    /** Signed right-stick X axis (-1..1). */
+    const RightStickX: GamepadAxisChannel;
+    /** Signed right-stick Y axis (-1..1). */
+    const RightStickY: GamepadAxisChannel;
+    /** Primary touchpad X (0..1, left to right). PlayStation, Steam Deck (left pad), Steam Controller. */
+    const TouchpadX: GamepadAxisChannel;
+    /** Primary touchpad Y (0..1, top to bottom). */
+    const TouchpadY: GamepadAxisChannel;
+    /** Secondary touchpad X (0..1). Steam Deck (right pad), other dual-touchpad hardware. */
+    const Touchpad2X: GamepadAxisChannel;
+    /** Secondary touchpad Y (0..1). */
+    const Touchpad2Y: GamepadAxisChannel;
+    const AuxiliaryAxis0Negative: GamepadAxisChannel;
+    const AuxiliaryAxis0Positive: GamepadAxisChannel;
+    const AuxiliaryAxis1Negative: GamepadAxisChannel;
+    const AuxiliaryAxis1Positive: GamepadAxisChannel;
+    const AuxiliaryAxis2Negative: GamepadAxisChannel;
+    const AuxiliaryAxis2Positive: GamepadAxisChannel;
+    const AuxiliaryAxis3Negative: GamepadAxisChannel;
+    const AuxiliaryAxis3Positive: GamepadAxisChannel;
+}
+export {};