@woosh/meep-engine 3.35.0 → 3.37.0

package/src/engine/input/ecs/ism/coordinate/InputCoordinateDevice.d.ts

@@ -1,3 +1,8 @@
+/**
+ * @typedef {import('../InputSourceTable.js').InputSourceTable} InputSourceTable
+ * @typedef {import('../device/InputDeviceAdapter.js').InputDeviceAdapter} InputDeviceAdapter
+ * @typedef {import('../../../../../core/binary/BitSet.js').BitSet} BitSet
+ */
 /**
  * A channel read straight from a device.
  *
@@ -23,6 +28,15 @@ export class InputCoordinateDevice extends InputCoordinateChannel {
      * @returns {InputCoordinateDevice}
      */
     static fromGamepad(code: number): InputCoordinateDevice;
+    /**
+     * Select/squeeze and raw buttons/axes are scalar; thumbstick/touchpad have two components.
+     * Missing hardware reads zero. Named sticks require xr-standard; raw axes retain native ordering.
+     *
+     * @param {'left'|'right'|'none'} handedness
+     * @param {number} code A value from XRInputCoordinates, xr_input_button_coordinate or xr_input_axis_coordinate.
+     * @returns {InputCoordinateDevice}
+     */
+    static fromXR(handedness: 'left' | 'right' | 'none', code: number): InputCoordinateDevice;
     /**
      * A pointer channel. `position` is 2-D absolute; `move` is 2-D and `wheel` is 3-D, both relative and
      * both LATCHED once per frame - a reader sees the total that arrived since the previous frame, and sees
@@ -36,16 +50,15 @@ export class InputCoordinateDevice extends InputCoordinateChannel {
      * @type {InputCoordinateSource}
      */
     source: InputCoordinateSource;
-    /**
-     * @returns {InputCoordinateChannelType}
-     */
-    get type(): number;
     /**
      * @returns {InputCoordinateDevice}
      */
     clone(): InputCoordinateDevice;
     #private;
 }
+export type InputSourceTable = import('../InputSourceTable.js').InputSourceTable;
+export type InputDeviceAdapter = import('../device/InputDeviceAdapter.js').InputDeviceAdapter;
+export type BitSet = import('../../../../../core/binary/BitSet.js').BitSet;
 import { InputCoordinateChannel } from "./InputCoordinateChannel.js";
 import { InputCoordinateSource } from "../InputCoordinateSource.js";
 //# sourceMappingURL=InputCoordinateDevice.d.ts.map

package/src/engine/input/ecs/ism/coordinate/InputCoordinateDevice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InputCoordinateDevice.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/coordinate/InputCoordinateDevice.js"],"names":[],"mappings":"AAWA;;;;;;;;;;;GAWG;AACH;IA2BI;;;OAGG;IACH,0BAHW,qBAAqB,GACnB,qBAAqB,CAUjC;IAED;;;;;OAKG;IACH,yBAHW,MAAM,GACJ,qBAAqB,CAQjC;IAED;;;;;;;OAOG;IACH,yBAHW,MAAM,GACJ,qBAAqB,CAajC;IAxED;;OAEG;IACH,QAFU,qBAAqB,CAEM;IAQrC;;OAEG;IACH,mBAEC;IAyFD;;OAEG;IACH,SAFa,qBAAqB,CAIjC;;CAiBJ;uCAjJsC,6BAA6B;sCAD9B,6BAA6B"}
+{"version":3,"file":"InputCoordinateDevice.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/coordinate/InputCoordinateDevice.js"],"names":[],"mappings":"AAaA;;;;GAIG;AAEH;;;;;;;;;;;GAWG;AACH;IA2BI;;;OAGG;IACH,0BAHW,qBAAqB,GACnB,qBAAqB,CAUjC;IAED;;;;;OAKG;IACH,yBAHW,MAAM,GACJ,qBAAqB,CAQjC;IAED;;;;;;;OAOG;IACH,0BAJW,MAAM,GAAC,OAAO,GAAC,MAAM,QACrB,MAAM,GACJ,qBAAqB,CAUjC;IAED;;;;;;;OAOG;IACH,yBAHW,MAAM,GACJ,qBAAqB,CAajC;IA1FD;;OAEG;IACH,QAFU,qBAAqB,CAEM;IAwHrC;;OAEG;IACH,SAFa,qBAAqB,CAIjC;;CAiBJ;+BApKY,OAAO,wBAAwB,EAAE,gBAAgB;iCACjD,OAAO,iCAAiC,EAAE,kBAAkB;qBAC5D,OAAO,sCAAsC,EAAE,MAAM;uCAP3B,6BAA6B;sCAD9B,6BAA6B"}

package/src/engine/input/ecs/ism/coordinate/InputCoordinateDevice.js

@@ -3,12 +3,20 @@ import { GamepadCoordinates } from "../../../devices/gamepad/GamepadCoordinates.
 import { PointerCoordinates } from "../../../devices/PointerCoordinates.js";
 import { GAMEPAD_INPUT_DEVICE_ID } from "../device/GAMEPAD_INPUT_DEVICE_ID.js";
 import { POINTER_INPUT_DEVICE_ID } from "../device/POINTER_INPUT_DEVICE_ID.js";
+import { xr_input_device_id } from "../device/XR_INPUT_DEVICE_IDS.js";
+import { XRInputCoordinates } from "../../../devices/xr/XRInputCoordinates.js";
 import { InputCoordinateKind } from "../InputCoordinateKind.js";
 import { InputCoordinateSource } from "../InputCoordinateSource.js";
 import { InputCoordinateChannel } from "./InputCoordinateChannel.js";
 import { InputCoordinateChannelType } from "./InputCoordinateChannelType.js";
 import { hash_mix2 } from "../../../../../core/math/hash/hash_mix2.js";
 
+/**
+ * @typedef {import('../InputSourceTable.js').InputSourceTable} InputSourceTable
+ * @typedef {import('../device/InputDeviceAdapter.js').InputDeviceAdapter} InputDeviceAdapter
+ * @typedef {import('../../../../../core/binary/BitSet.js').BitSet} BitSet
+ */
+
 /**
  * A channel read straight from a device.
  *
@@ -76,6 +84,24 @@ export class InputCoordinateDevice extends InputCoordinateChannel {
         ));
     }
 
+    /**
+     * Select/squeeze and raw buttons/axes are scalar; thumbstick/touchpad have two components.
+     * Missing hardware reads zero. Named sticks require xr-standard; raw axes retain native ordering.
+     *
+     * @param {'left'|'right'|'none'} handedness
+     * @param {number} code A value from XRInputCoordinates, xr_input_button_coordinate or xr_input_axis_coordinate.
+     * @returns {InputCoordinateDevice}
+     */
+    static fromXR(handedness, code) {
+        assert.isNonNegativeInteger(code, 'code');
+
+        const dimensions = code === XRInputCoordinates.thumbstick || code === XRInputCoordinates.touchpad ? 2 : 1;
+
+        return InputCoordinateDevice.fromSource(InputCoordinateSource.from(
+            xr_input_device_id(handedness), code, dimensions, InputCoordinateKind.Normalized
+        ));
+    }
+
     /**
      * A pointer channel. `position` is 2-D absolute; `move` is 2-D and `wheel` is 3-D, both relative and
      * both LATCHED once per frame - a reader sees the total that arrived since the previous frame, and sees

package/src/engine/input/ecs/ism/coordinate/InputCoordinateSwitches.d.ts

@@ -29,9 +29,24 @@ export class InputCoordinateSwitches extends InputCoordinateChannel {
      */
     triggers: InputTrigger[];
     /**
-     * @returns {InputCoordinateChannelType}
+     * @param {InputSourceTable} table
+     * @param {Map<string, InputDeviceAdapter>} adapters
      */
-    get type(): number;
+    resolve(table: InputSourceTable, adapters: Map<string, InputDeviceAdapter>): void;
+    /**
+     * @param {InputSource[]} result
+     */
+    collectSources(result: InputSource[]): void;
+    /**
+     * @param {InputTrigger[]} result
+     */
+    collectStateful(result: InputTrigger[]): void;
+    /**
+     * @param {number[]|Float64Array} result
+     * @param {number} offset
+     * @param {BitSet} held
+     */
+    read(result: number[] | Float64Array, offset: number, held: BitSet): void;
     /**
      * @returns {InputCoordinateSwitches}
      */

package/src/engine/input/ecs/ism/coordinate/InputCoordinateSwitches.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InputCoordinateSwitches.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/coordinate/InputCoordinateSwitches.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;GAkBG;AACH;IAsBI;;;OAGG;IACH,sBAHW,cAAc,GACZ,uBAAuB,CAYnC;IAlCD;;;OAGG;IACH,UAFU,cAAc,CAEV;IAEd;;OAEG;IACH,mBAEC;IA4ED;;OAEG;IACH,SAFa,uBAAuB,CAInC;CAyCJ;uCA9JsC,6BAA6B"}
+{"version":3,"file":"InputCoordinateSwitches.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/coordinate/InputCoordinateSwitches.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;GAkBG;AACH;IAsBI;;;OAGG;IACH,sBAHW,cAAc,GACZ,uBAAuB,CAYnC;IAlCD;;;OAGG;IACH,UAFU,cAAc,CAEV;IAgCd;;;OAGG;IACH,2CAFW,IAAI,MAAM,qBAAqB,QAQzC;IAED;;OAEG;IACH,uBAFW,aAAa,QAQvB;IAED;;OAEG;IACH,wBAFW,cAAc,QAQxB;IAED;;;;OAIG;IACH,aAJW,MAAM,EAAE,GAAC,YAAY,UACrB,MAAM,sBAahB;IAED;;OAEG;IACH,SAFa,uBAAuB,CAInC;CAyCJ;uCA9JsC,6BAA6B"}

package/src/engine/input/ecs/ism/device/GamepadInputDeviceAdapter.d.ts

@@ -16,6 +16,11 @@ export class GamepadInputDeviceAdapter extends InputDeviceAdapter {
      * @param {GamepadDevice} device
      */
     constructor(device: GamepadDevice);
+    /**
+     * @param {number} code a {@link GamepadButtons} value
+     * @returns {InputDeviceSwitch}
+     */
+    getSwitch(code: number): InputDeviceSwitch;
     #private;
 }
 import { InputDeviceAdapter } from "./InputDeviceAdapter.js";

package/src/engine/input/ecs/ism/device/GamepadInputDeviceAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GamepadInputDeviceAdapter.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/device/GamepadInputDeviceAdapter.js"],"names":[],"mappings":"AAaA;;;;;;;;;;;;GAYG;AACH;IASI;;OAEG;IACH,mCAMC;;CA2CJ;mCAlFkC,yBAAyB"}
+{"version":3,"file":"GamepadInputDeviceAdapter.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/device/GamepadInputDeviceAdapter.js"],"names":[],"mappings":"AAaA;;;;;;;;;;;;GAYG;AACH;IASI;;OAEG;IACH,mCAMC;IAED;;;OAGG;IACH,gBAHW,MAAM,qBAKhB;;CAmCJ;mCAlFkC,yBAAyB"}

package/src/engine/input/ecs/ism/device/InputDeviceAdapter.d.ts

@@ -1,3 +1,4 @@
+/** @typedef {import('../../../devices/InputDeviceSwitch.js').InputDeviceSwitch} InputDeviceSwitch */
 /**
  * Presents a concrete input device to the binding layer as switches and coordinates.
  *
@@ -54,4 +55,5 @@ export class InputDeviceAdapter {
      */
     latchDeltas(): void;
 }
+export type InputDeviceSwitch = import('../../../devices/InputDeviceSwitch.js').InputDeviceSwitch;
 //# sourceMappingURL=InputDeviceAdapter.d.ts.map

package/src/engine/input/ecs/ism/device/InputDeviceAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InputDeviceAdapter.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/device/InputDeviceAdapter.js"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH;IAEI;;;;OAIG;IACH,IAFU,MAAM,CAER;IAER;;;;;;OAMG;IACH,gBAHW,MAAM,qBAKhB;IAED;;;;;;OAMG;IACH,uBAJW,MAAM,EAAE,GAAC,YAAY,UACrB,MAAM,QACN,MAAM,QAIhB;IAED;;;OAGG;IACH,gBAEC;IAED;;OAEG;IACH,iBAEC;IAED;;;;;;;;;;OAUG;IACH,oBAEC;CACJ"}
+{"version":3,"file":"InputDeviceAdapter.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/device/InputDeviceAdapter.js"],"names":[],"mappings":"AAAA,qGAAqG;AAErG;;;;;;;;;;GAUG;AACH;IAEI;;;;OAIG;IACH,IAFU,MAAM,CAER;IAER;;;;;;OAMG;IACH,gBAHW,MAAM,GACJ,iBAAiB,CAI7B;IAED;;;;;;OAMG;IACH,uBAJW,MAAM,EAAE,GAAC,YAAY,UACrB,MAAM,QACN,MAAM,QAIhB;IAED;;;OAGG;IACH,gBAEC;IAED;;OAEG;IACH,iBAEC;IAED;;;;;;;;;;OAUG;IACH,oBAEC;CACJ;gCAzEa,OAAO,uCAAuC,EAAE,iBAAiB"}

package/src/engine/input/ecs/ism/device/InputDeviceAdapter.js

@@ -1,3 +1,5 @@
+/** @typedef {import('../../../devices/InputDeviceSwitch.js').InputDeviceSwitch} InputDeviceSwitch */
+
 /**
  * Presents a concrete input device to the binding layer as switches and coordinates.
  *

package/src/engine/input/ecs/ism/device/KeyboardInputDeviceAdapter.d.ts

@@ -16,6 +16,13 @@ export class KeyboardInputDeviceAdapter extends InputDeviceAdapter {
      * @param {KeyboardDevice} device
      */
     constructor(device: KeyboardDevice);
+    /**
+     * Precondition: `code` is a member of {@link KeyCodes}.
+     *
+     * @param {number} code
+     * @returns {InputDeviceSwitch}
+     */
+    getSwitch(code: number): InputDeviceSwitch;
     #private;
 }
 import { InputDeviceAdapter } from "./InputDeviceAdapter.js";

package/src/engine/input/ecs/ism/device/KeyboardInputDeviceAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KeyboardInputDeviceAdapter.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/device/KeyboardInputDeviceAdapter.js"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;GAYG;AACH;IASI;;OAEG;IACH,oCAMC;;CAeJ;mCA5DkC,yBAAyB"}
+{"version":3,"file":"KeyboardInputDeviceAdapter.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/device/KeyboardInputDeviceAdapter.js"],"names":[],"mappings":"AAgBA;;;;;;;;;;;;GAYG;AACH;IASI;;OAEG;IACH,oCAMC;IAED;;;;;OAKG;IACH,gBAHW,MAAM,qBAShB;;CACJ;mCA5DkC,yBAAyB"}

package/src/engine/input/ecs/ism/device/ManualInputDeviceAdapter.d.ts

@@ -18,6 +18,11 @@ export class ManualInputDeviceAdapter extends InputDeviceAdapter {
      * @param {ManualInputDevice} device
      */
     constructor(id: string, device: ManualInputDevice);
+    /**
+     * @param {number} code
+     * @returns {InputDeviceSwitch}
+     */
+    getSwitch(code: number): InputDeviceSwitch;
     #private;
 }
 import { InputDeviceAdapter } from "./InputDeviceAdapter.js";

package/src/engine/input/ecs/ism/device/ManualInputDeviceAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ManualInputDeviceAdapter.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/device/ManualInputDeviceAdapter.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AACH;IAOI;;;OAGG;IACH,gBAHW,MAAM,6BAWhB;;CAkBJ;mCArDkC,yBAAyB"}
+{"version":3,"file":"ManualInputDeviceAdapter.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/device/ManualInputDeviceAdapter.js"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AACH;IAOI;;;OAGG;IACH,gBAHW,MAAM,6BAWhB;IAED;;;OAGG;IACH,gBAHW,MAAM,qBAKhB;;CAUJ;mCArDkC,yBAAyB"}

package/src/engine/input/ecs/ism/device/PointerInputDeviceAdapter.d.ts

@@ -24,6 +24,11 @@ export class PointerInputDeviceAdapter extends InputDeviceAdapter {
      * @param {PointerDevice} device
      */
     constructor(device: PointerDevice);
+    /**
+     * @param {number} code a {@link MouseButtons} value
+     * @returns {InputDeviceSwitch}
+     */
+    getSwitch(code: number): InputDeviceSwitch;
     #private;
 }
 import { InputDeviceAdapter } from "./InputDeviceAdapter.js";

package/src/engine/input/ecs/ism/device/PointerInputDeviceAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PointerInputDeviceAdapter.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/device/PointerInputDeviceAdapter.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH;IAiCI;;OAEG;IACH,mCAMC;;CA2FJ;mCA7JkC,yBAAyB"}
+{"version":3,"file":"PointerInputDeviceAdapter.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/device/PointerInputDeviceAdapter.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH;IAiCI;;OAEG;IACH,mCAMC;IA+CD;;;OAGG;IACH,gBAHW,MAAM,qBAShB;;CAkCJ;mCA7JkC,yBAAyB"}

package/src/engine/input/ecs/ism/device/XRInputDeviceAdapter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Exposes one persistent XR handedness slot to {@link InputMapSystem}, including before hardware exists.
+ * Use {@link InputTriggerXRButton} for native pressed/touched switches and
+ * {@link InputCoordinateDevice.fromXR} for amounts, sticks and axes.
+ *
+ * Subscribe to select/squeeze completion directly through XRInputAction.completed or an InputController
+ * path such as 'xr/right/select/completed'. Button press triggers and action completion are independent.
+ *
+ * @example
+ *   // With a running engine and an active scene:
+ *   const system = new InputMapSystem([new XRInputDeviceAdapter(engine.devices.xr, 'right')]);
+ *   await engine.entityManager.addSystem(system);
+ *   const map = new InputMap();
+ *   map.bindCoordinate('pressure', InputCoordinateDevice.fromXR('right', XRInputCoordinates.select));
+ *   const entity = engine.entityManager.dataset.createEntity();
+ *   engine.entityManager.dataset.addComponentToEntity(entity, map);
+ *   // Read after XRInputDevice.poll in the application's frame callback.
+ *   const pressure = new Vector1();
+ *   map.axis1(pressure, 'pressure');
+ */
+export class XRInputDeviceAdapter extends InputDeviceAdapter {
+    /**
+     * @param {import('../../../devices/XRInputDevice.js').XRInputDevice} device
+     * @param {'left'|'right'|'none'} handedness
+     */
+    constructor(device: import('../../../devices/XRInputDevice.js').XRInputDevice, handedness: 'left' | 'right' | 'none');
+    #private;
+}
+import { InputDeviceAdapter } from "./InputDeviceAdapter.js";
+//# sourceMappingURL=XRInputDeviceAdapter.d.ts.map

package/src/engine/input/ecs/ism/device/XRInputDeviceAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XRInputDeviceAdapter.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/device/XRInputDeviceAdapter.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;GAmBG;AACH;IAII;;;OAGG;IACH,oBAHW,OAAO,mCAAmC,EAAE,aAAa,cACzD,MAAM,GAAC,OAAO,GAAC,MAAM,EAU/B;;CA6CJ;mCApFkC,yBAAyB"}

package/src/engine/input/ecs/ism/device/XRInputDeviceAdapter.js

@@ -0,0 +1,87 @@
+import { assert } from "../../../../../core/assert.js";
+import { XRInputCoordinates } from "../../../devices/xr/XRInputCoordinates.js";
+import { InputDeviceAdapter } from "./InputDeviceAdapter.js";
+import { xr_input_device_id } from "./XR_INPUT_DEVICE_IDS.js";
+
+/**
+ * Exposes one persistent XR handedness slot to {@link InputMapSystem}, including before hardware exists.
+ * Use {@link InputTriggerXRButton} for native pressed/touched switches and
+ * {@link InputCoordinateDevice.fromXR} for amounts, sticks and axes.
+ *
+ * Subscribe to select/squeeze completion directly through XRInputAction.completed or an InputController
+ * path such as 'xr/right/select/completed'. Button press triggers and action completion are independent.
+ *
+ * @example
+ *   // With a running engine and an active scene:
+ *   const system = new InputMapSystem([new XRInputDeviceAdapter(engine.devices.xr, 'right')]);
+ *   await engine.entityManager.addSystem(system);
+ *   const map = new InputMap();
+ *   map.bindCoordinate('pressure', InputCoordinateDevice.fromXR('right', XRInputCoordinates.select));
+ *   const entity = engine.entityManager.dataset.createEntity();
+ *   engine.entityManager.dataset.addComponentToEntity(entity, map);
+ *   // Read after XRInputDevice.poll in the application's frame callback.
+ *   const pressure = new Vector1();
+ *   map.axis1(pressure, 'pressure');
+ */
+export class XRInputDeviceAdapter extends InputDeviceAdapter {
+    /** @type {import('../../../devices/xr/XRInputHandle.js').XRInputHandle} */
+    #handle;
+
+    /**
+     * @param {import('../../../devices/XRInputDevice.js').XRInputDevice} device
+     * @param {'left'|'right'|'none'} handedness
+     */
+    constructor(device, handedness) {
+        super();
+
+        assert.defined(device, 'device');
+        assert.notNull(device, 'device');
+
+        this.id = xr_input_device_id(handedness);
+        this.#handle = device[handedness];
+    }
+
+    /**
+     * @param {number} code Even codes are pressed, odd codes touched; button index is floor(code/2).
+     * @returns {import('../../../devices/InputDeviceSwitch.js').InputDeviceSwitch}
+     */
+    getSwitch(code) {
+        assert.isNonNegativeInteger(code, 'code');
+
+        const button = this.#handle.getButton(Math.floor(code / 2));
+        return code % 2 === 0 ? button.pressed : button.touched;
+    }
+
+    /**
+     * @param {number[]|Float64Array} result
+     * @param {number} offset
+     * @param {number} code
+     */
+    readCoordinate(result, offset, code) {
+        assert.isArrayLike(result, 'result');
+        assert.isNonNegativeInteger(offset, 'offset');
+        assert.isNonNegativeInteger(code, 'code');
+
+        const handle = this.#handle;
+        switch (code) {
+            case XRInputCoordinates.select:
+                result[offset] = handle.select.x;
+                return;
+            case XRInputCoordinates.squeeze:
+                result[offset] = handle.squeeze.x;
+                return;
+            case XRInputCoordinates.thumbstick:
+                result[offset] = handle.thumbstick.value.x;
+                result[offset + 1] = handle.thumbstick.value.y;
+                return;
+            case XRInputCoordinates.touchpad:
+                result[offset] = handle.touchpad.x;
+                result[offset + 1] = handle.touchpad.y;
+                return;
+            default: {
+                const index = Math.floor((code - 4) / 2);
+                result[offset] = code % 2 === 0 ? handle.getButton(index).x : handle.getAxis(index).x;
+            }
+        }
+    }
+}

package/src/engine/input/ecs/ism/device/XR_INPUT_DEVICE_IDS.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @param {'left'|'right'|'none'} handedness
+ * @returns {string}
+ */
+export function xr_input_device_id(handedness: 'left' | 'right' | 'none'): string;
+/**
+ * Stable IDs used in serialized input maps.
+ * @readonly
+ */
+export const XR_INPUT_DEVICE_IDS: Readonly<{
+    left: "xr-left";
+    right: "xr-right";
+    none: "xr-none";
+}>;
+//# sourceMappingURL=XR_INPUT_DEVICE_IDS.d.ts.map

package/src/engine/input/ecs/ism/device/XR_INPUT_DEVICE_IDS.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"XR_INPUT_DEVICE_IDS.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/device/XR_INPUT_DEVICE_IDS.js"],"names":[],"mappings":"AAaA;;;GAGG;AACH,+CAHW,MAAM,GAAC,OAAO,GAAC,MAAM,GACnB,MAAM,CAMlB;AAlBD;;;GAGG;AACH;;;;GAIG"}

package/src/engine/input/ecs/ism/device/XR_INPUT_DEVICE_IDS.js

@@ -0,0 +1,22 @@
+import { assert } from "../../../../../core/assert.js";
+import { XRHandedness } from "../../../devices/xr/XRHandedness.js";
+
+/**
+ * Stable IDs used in serialized input maps.
+ * @readonly
+ */
+export const XR_INPUT_DEVICE_IDS = Object.freeze({
+    left: 'xr-left',
+    right: 'xr-right',
+    none: 'xr-none'
+});
+
+/**
+ * @param {'left'|'right'|'none'} handedness
+ * @returns {string}
+ */
+export function xr_input_device_id(handedness) {
+    assert.enum(handedness, XRHandedness, 'handedness');
+
+    return XR_INPUT_DEVICE_IDS[handedness];
+}

package/src/engine/input/ecs/ism/trigger/InputTrigger.d.ts

@@ -1,3 +1,9 @@
+/**
+ * @typedef {import('./InputTriggerType.js').InputTriggerType} InputTriggerType
+ * @typedef {import('../InputSourceTable.js').InputSourceTable} InputSourceTable
+ * @typedef {import('../InputSource.js').InputSource} InputSource
+ * @typedef {import('../../../../../core/binary/BitSet.js').BitSet} BitSet
+ */
 /**
  * A predicate over the set of currently held switches, plus - for the two stateful kinds - its own state.
  *
@@ -26,7 +32,7 @@ export class InputTrigger {
     /**
      * @returns {InputTriggerType}
      */
-    get type(): InputTriggerType;
+    get type(): number;
     /**
      * Number of switches that must be held simultaneously for this to be true. Used for specificity ordering,
      * where a wider chord beats a narrower one so Ctrl+Z wins over a bare Z.
@@ -106,4 +112,8 @@ export class InputTrigger {
      */
     hash(): number;
 }
+export type InputTriggerType = import('./InputTriggerType.js').InputTriggerType;
+export type InputSourceTable = import('../InputSourceTable.js').InputSourceTable;
+export type InputSource = import('../InputSource.js').InputSource;
+export type BitSet = import('../../../../../core/binary/BitSet.js').BitSet;
 //# sourceMappingURL=InputTrigger.d.ts.map

package/src/engine/input/ecs/ism/trigger/InputTrigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InputTrigger.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/trigger/InputTrigger.js"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH;IAEI;;;;OAIG;IACH,WAFU,OAAO,CAEC;IAElB;;OAEG;IACH,6BAEC;IAED;;;;OAIG;IACH,oBAEC;IAED;;;;OAIG;IACH,wBAEC;IAED;;;;OAIG;IACH,wBAEC;IAED;;;;;OAKG;IACH,uCAEC;IAED;;;;OAIG;IACH,uBAFW,aAAa,QAIvB;IAED;;;;;OAKG;IACH,wBAFW,YAAY,EAAE,QAIxB;IAED;;;;;;;OAOG;IACH,6BAHW,MAAM,aACN,MAAM,QAIhB;IAED;;;;;;;;;;OAUG;IACH,0BAFW,MAAM,QAIhB;IAED;;;OAGG;IACH,oBAFa,OAAO,CAInB;IAED;;;OAGG;IACH,SAFa,YAAY,CAIxB;IAED;;;OAGG;IACH,cAHW,YAAY,GACV,OAAO,CAInB;IAED;;OAEG;IACH,QAFa,MAAM,CAIlB;CACJ"}
+{"version":3,"file":"InputTrigger.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/trigger/InputTrigger.js"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH;IAEI;;;;OAIG;IACH,WAFU,OAAO,CAEC;IAElB;;OAEG;IACH,mBAEC;IAED;;;;OAIG;IACH,oBAEC;IAED;;;;OAIG;IACH,wBAEC;IAED;;;;OAIG;IACH,wBAEC;IAED;;;;;OAKG;IACH,eAFW,gBAAgB,QAI1B;IAED;;;;OAIG;IACH,uBAFW,WAAW,EAAE,QAIvB;IAED;;;;;OAKG;IACH,wBAFW,YAAY,EAAE,QAIxB;IAED;;;;;;;OAOG;IACH,eAJW,MAAM,QACN,MAAM,aACN,MAAM,QAIhB;IAED;;;;;;;;;;OAUG;IACH,YAHW,MAAM,QACN,MAAM,QAIhB;IAED;;;OAGG;IACH,WAHW,MAAM,GACJ,OAAO,CAInB;IAED;;;OAGG;IACH,SAFa,YAAY,CAIxB;IAED;;;OAGG;IACH,cAHW,YAAY,GACV,OAAO,CAInB;IAED;;OAEG;IACH,QAFa,MAAM,CAIlB;CACJ;+BAzJY,OAAO,uBAAuB,EAAE,gBAAgB;+BAChD,OAAO,wBAAwB,EAAE,gBAAgB;0BACjD,OAAO,mBAAmB,EAAE,WAAW;qBACvC,OAAO,sCAAsC,EAAE,MAAM"}

package/src/engine/input/ecs/ism/trigger/InputTrigger.js

@@ -1,3 +1,10 @@
+/**
+ * @typedef {import('./InputTriggerType.js').InputTriggerType} InputTriggerType
+ * @typedef {import('../InputSourceTable.js').InputSourceTable} InputSourceTable
+ * @typedef {import('../InputSource.js').InputSource} InputSource
+ * @typedef {import('../../../../../core/binary/BitSet.js').BitSet} BitSet
+ */
+
 /**
  * A predicate over the set of currently held switches, plus - for the two stateful kinds - its own state.
  *

package/src/engine/input/ecs/ism/trigger/InputTriggerChord.d.ts

@@ -21,9 +21,23 @@ export class InputTriggerChord extends InputTrigger {
      */
     children: InputTrigger[];
     /**
-     * @returns {InputTriggerType}
+     * @param {InputSourceTable} table
      */
-    get type(): number;
+    resolve(table: InputSourceTable): void;
+    /**
+     * @param {InputSource[]} result
+     */
+    collectSources(result: InputSource[]): void;
+    /**
+     * @param {BitSet} held
+     * @param {number} time
+     */
+    reset(held: BitSet, time: number): void;
+    /**
+     * @param {BitSet} held
+     * @returns {boolean}
+     */
+    test(held: BitSet): boolean;
     /**
      * @returns {InputTriggerChord}
      */

package/src/engine/input/ecs/ism/trigger/InputTriggerChord.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InputTriggerChord.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/trigger/InputTriggerChord.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;GAWG;AACH;IA+BI;;;OAGG;IACH,yBAHc,YAAY,KACb,iBAAiB,CAU7B;IAzCD;;OAEG;IACH,UAFU,YAAY,EAAE,CAEV;IAEd;;OAEG;IACH,mBAEC;IAiGD;;OAEG;IACH,SAFa,iBAAiB,CAI7B;CAyCJ;6BA3K4B,mBAAmB"}
+{"version":3,"file":"InputTriggerChord.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/trigger/InputTriggerChord.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;GAWG;AACH;IA+BI;;;OAGG;IACH,yBAHc,YAAY,KACb,iBAAiB,CAU7B;IAzCD;;OAEG;IACH,UAFU,YAAY,EAAE,CAEV;IAwCd;;OAEG;IACH,uCAMC;IAED;;OAEG;IACH,uBAFW,aAAa,QAQvB;IAaD;;;OAGG;IACH,0BAFW,MAAM,QAUhB;IAED;;;OAGG;IACH,oBAFa,OAAO,CAanB;IAED;;OAEG;IACH,SAFa,iBAAiB,CAI7B;CAyCJ;6BA3K4B,mBAAmB"}

package/src/engine/input/ecs/ism/trigger/InputTriggerHold.d.ts

@@ -33,9 +33,29 @@ export class InputTriggerHold extends InputTrigger {
      */
     duration: number;
     /**
-     * @returns {InputTriggerType}
+     * @param {InputSourceTable} table
      */
-    get type(): number;
+    resolve(table: InputSourceTable): void;
+    /**
+     * @param {InputSource[]} result
+     */
+    collectSources(result: InputSource[]): void;
+    /**
+     * @param {BitSet} held
+     * @param {number} time
+     */
+    reset(held: BitSet, time: number): void;
+    /**
+     * @param {BitSet} held
+     * @param {number} time
+     * @param {number} timeDelta
+     */
+    evaluate(held: BitSet, time: number, timeDelta: number): void;
+    /**
+     * @param {BitSet} held
+     * @returns {boolean}
+     */
+    test(held: BitSet): boolean;
     /**
      * @returns {InputTriggerHold}
      */

package/src/engine/input/ecs/ism/trigger/InputTriggerHold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InputTriggerHold.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/trigger/InputTriggerHold.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;GAiBG;AACH;IA8CI;;;;OAIG;IACH,mBAJW,YAAY,YACZ,MAAM,GACJ,gBAAgB,CAa5B;IA5DD;;OAEG;IACH,OAFU,YAAY,CAET;IAEb;;;OAGG;IACH,UAFU,MAAM,CAEH;IAab;;OAEG;IACH,mBAEC;IAmGD;;OAEG;IACH,SAFa,gBAAgB,CAI5B;;CAkBJ;6BA9K4B,mBAAmB"}
+{"version":3,"file":"InputTriggerHold.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/trigger/InputTriggerHold.js"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;GAiBG;AACH;IA8CI;;;;OAIG;IACH,mBAJW,YAAY,YACZ,MAAM,GACJ,gBAAgB,CAa5B;IA5DD;;OAEG;IACH,OAFU,YAAY,CAET;IAEb;;;OAGG;IACH,UAFU,MAAM,CAEH;IAqDb;;OAEG;IACH,uCAEC;IAED;;OAEG;IACH,uBAFW,aAAa,QAIvB;IAYD;;;OAGG;IACH,0BAFW,MAAM,QAYhB;IAED;;;;OAIG;IACH,6BAHW,MAAM,aACN,MAAM,QAWhB;IAED;;;OAGG;IACH,oBAFa,OAAO,CAInB;IAED;;OAEG;IACH,SAFa,gBAAgB,CAI5B;;CAkBJ;6BA9K4B,mBAAmB"}

package/src/engine/input/ecs/ism/trigger/InputTriggerRelease.d.ts

@@ -26,9 +26,23 @@ export class InputTriggerRelease extends InputTrigger {
      */
     child: InputTrigger;
     /**
-     * @returns {InputTriggerType}
+     * @param {InputSourceTable} table
      */
-    get type(): number;
+    resolve(table: InputSourceTable): void;
+    /**
+     * @param {InputSource[]} result
+     */
+    collectSources(result: InputSource[]): void;
+    /**
+     * @param {BitSet} held
+     * @param {number} time
+     */
+    reset(held: BitSet, time: number): void;
+    /**
+     * @param {BitSet} held
+     * @returns {boolean}
+     */
+    test(held: BitSet): boolean;
     /**
      * @returns {InputTriggerRelease}
      */

package/src/engine/input/ecs/ism/trigger/InputTriggerRelease.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InputTriggerRelease.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/trigger/InputTriggerRelease.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;GAgBG;AACH;IAsBI;;;OAGG;IACH,mBAHW,YAAY,GACV,mBAAmB,CAU/B;IAhCD;;OAEG;IACH,OAFU,YAAY,CAET;IAEb;;OAEG;IACH,mBAEC;IA+DD;;OAEG;IACH,SAFa,mBAAmB,CAI/B;CAiBJ;6BAtH4B,mBAAmB"}
+{"version":3,"file":"InputTriggerRelease.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/trigger/InputTriggerRelease.js"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;GAgBG;AACH;IAsBI;;;OAGG;IACH,mBAHW,YAAY,GACV,mBAAmB,CAU/B;IAhCD;;OAEG;IACH,OAFU,YAAY,CAET;IA+Bb;;OAEG;IACH,uCAEC;IAED;;OAEG;IACH,uBAFW,aAAa,QAIvB;IASD;;;OAGG;IACH,0BAFW,MAAM,QAMhB;IAED;;;OAGG;IACH,oBAFa,OAAO,CAInB;IAED;;OAEG;IACH,SAFa,mBAAmB,CAI/B;CAiBJ;6BAtH4B,mBAAmB"}

package/src/engine/input/ecs/ism/trigger/InputTriggerSequence.d.ts

@@ -51,15 +51,35 @@ export class InputTriggerSequence extends InputTrigger {
      * @type {number}
      */
     stepTimeout: number;
-    /**
-     * @returns {InputTriggerType}
-     */
-    get type(): number;
     /**
      * @param {number} seconds
      * @returns {InputTriggerSequence} this
      */
     withStepTimeout(seconds: number): InputTriggerSequence;
+    /**
+     * @param {InputSourceTable} table
+     */
+    resolve(table: InputSourceTable): void;
+    /**
+     * @param {InputSource[]} result
+     */
+    collectSources(result: InputSource[]): void;
+    /**
+     * @param {BitSet} held
+     * @param {number} time
+     */
+    reset(held: BitSet, time: number): void;
+    /**
+     * @param {BitSet} held
+     * @param {number} time
+     * @param {number} timeDelta
+     */
+    evaluate(held: BitSet, time: number, timeDelta: number): void;
+    /**
+     * @param {BitSet} held
+     * @returns {boolean}
+     */
+    test(held: BitSet): boolean;
     /**
      * @returns {InputTriggerSequence}
      */

package/src/engine/input/ecs/ism/trigger/InputTriggerSequence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InputTriggerSequence.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/trigger/InputTriggerSequence.js"],"names":[],"mappings":"AAMA;;;;;;;;;GASG;AACH,kDAFU,MAAM,CAEqC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH;IAyEI;;;OAGG;IACH,sBAHc,YAAY,KACb,oBAAoB,CAUhC;IAnFD;;OAEG;IACH,OAFU,YAAY,EAAE,CAEb;IAEX;;;OAGG;IACH,aAFU,MAAM,CAEkC;IA0BlD;;OAEG;IACH,mBAEC;IA6CD;;;OAGG;IACH,yBAHW,MAAM,GACJ,oBAAoB,CAShC;IAqHD;;OAEG;IACH,SAFa,oBAAoB,CAQhC;;CA6CJ;6BAzT4B,mBAAmB"}
+{"version":3,"file":"InputTriggerSequence.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/trigger/InputTriggerSequence.js"],"names":[],"mappings":"AAMA;;;;;;;;;GASG;AACH,kDAFU,MAAM,CAEqC;AAErD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH;IAyEI;;;OAGG;IACH,sBAHc,YAAY,KACb,oBAAoB,CAUhC;IAnFD;;OAEG;IACH,OAFU,YAAY,EAAE,CAEb;IAEX;;;OAGG;IACH,aAFU,MAAM,CAEkC;IA4ElD;;;OAGG;IACH,yBAHW,MAAM,GACJ,oBAAoB,CAShC;IAED;;OAEG;IACH,uCAMC;IAED;;OAEG;IACH,uBAFW,aAAa,QAQvB;IAkCD;;;OAGG;IACH,0BAFW,MAAM,QAchB;IAED;;;;OAIG;IACH,6BAHW,MAAM,aACN,MAAM,QA8BhB;IAED;;;OAGG;IACH,oBAFa,OAAO,CAInB;IAED;;OAEG;IACH,SAFa,oBAAoB,CAQhC;;CA6CJ;6BAzT4B,mBAAmB"}

package/src/engine/input/ecs/ism/trigger/InputTriggerSwitch.d.ts

@@ -1,3 +1,7 @@
+/**
+ * @typedef {import('../InputSourceTable.js').InputSourceTable} InputSourceTable
+ * @typedef {import('../../../../../core/binary/BitSet.js').BitSet} BitSet
+ */
 /**
  * True while one switch is held.
  *
@@ -19,20 +23,14 @@ export class InputTriggerSwitch extends InputTrigger {
      * @type {InputSource}
      */
     source: InputSource;
-    /**
-     * @returns {InputTriggerType}
-     */
-    get type(): number;
-    /**
-     * @param {InputSource[]} result
-     */
-    collectSources(result: InputSource[]): void;
     /**
      * @returns {InputTriggerSwitch}
      */
     clone(): InputTriggerSwitch;
     #private;
 }
+export type InputSourceTable = import('../InputSourceTable.js').InputSourceTable;
+export type BitSet = import('../../../../../core/binary/BitSet.js').BitSet;
 import { InputTrigger } from "./InputTrigger.js";
 import { InputSource } from "../InputSource.js";
 //# sourceMappingURL=InputTriggerSwitch.d.ts.map

package/src/engine/input/ecs/ism/trigger/InputTriggerSwitch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"InputTriggerSwitch.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/trigger/InputTriggerSwitch.js"],"names":[],"mappings":"AAKA;;;;;;;;;;GAUG;AACH;IAwBI;;;OAGG;IACH,0BAHW,WAAW,GACT,kBAAkB,CAU9B;IAlCD;;OAEG;IACH,QAFU,WAAW,CAEM;IAY3B;;OAEG;IACH,mBAEC;IAuBD;;OAEG;IACH,uBAFW,WAAW,EAAE,QAIvB;IAgBD;;OAEG;IACH,SAFa,kBAAkB,CAI9B;;CAiBJ;6BAtG4B,mBAAmB;4BADpB,mBAAmB"}
+{"version":3,"file":"InputTriggerSwitch.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/trigger/InputTriggerSwitch.js"],"names":[],"mappings":"AAKA;;;GAGG;AAEH;;;;;;;;;;GAUG;AACH;IAwBI;;;OAGG;IACH,0BAHW,WAAW,GACT,kBAAkB,CAU9B;IAlCD;;OAEG;IACH,QAFU,WAAW,CAEM;IA6D3B;;OAEG;IACH,SAFa,kBAAkB,CAI9B;;CAiBJ;+BAvGY,OAAO,wBAAwB,EAAE,gBAAgB;qBACjD,OAAO,sCAAsC,EAAE,MAAM;6BALrC,mBAAmB;4BADpB,mBAAmB"}