@woosh/meep-engine 3.34.0 → 3.36.0

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,20 @@ export class InputCoordinateDevice extends InputCoordinateChannel {
         ));
     }
 
+    /**
+     * Select/squeeze and raw buttons/axes are scalar; thumbstick/touchpad have two components.
+     * @param {'left'|'right'|'none'} handedness
+     * @param {number} code XRInputCoordinates or xr_input_button_coordinate/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,16 @@
+/**
+ * A persistent XR handedness slot, usable before hardware exists and across source swaps.
+ * Native pressed/touched switches are independent of semantic select/squeeze completion. Subscribe to
+ * those outcomes directly through their Signals (or InputController paths such as xr/right/select/completed).
+ *
+ * @example
+ *   new InputMapSystem([new XRInputDeviceAdapter(engine.devices.xr, 'right')]);
+ *   map.bindCoordinate('pressure', InputCoordinateDevice.fromXR('right', XRInputCoordinates.select));
+ */
+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;;;;;;;;GAQG;AACH;IAII,0HAA0H;IAC1H,oBADY,OAAO,mCAAmC,EAAE,aAAa,cAAiB,MAAM,GAAC,OAAO,GAAC,MAAM,EAK1G;;CA8BJ;mCAnDkC,yBAAyB"}

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

@@ -0,0 +1,54 @@
+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";
+
+/**
+ * A persistent XR handedness slot, usable before hardware exists and across source swaps.
+ * Native pressed/touched switches are independent of semantic select/squeeze completion. Subscribe to
+ * those outcomes directly through their Signals (or InputController paths such as xr/right/select/completed).
+ *
+ * @example
+ *   new InputMapSystem([new XRInputDeviceAdapter(engine.devices.xr, 'right')]);
+ *   map.bindCoordinate('pressure', InputCoordinateDevice.fromXR('right', XRInputCoordinates.select));
+ */
+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();
+        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). */
+    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.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,9 @@
+/** @param {'left'|'right'|'none'} handedness @returns {string} */
+export function xr_input_device_id(handedness: 'left' | 'right' | 'none'): string;
+/** @readonly Stable IDs used in serialized input maps. */
+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":"AAGA,kEAAkE;AAClE,+CADY,MAAM,GAAC,OAAO,GAAC,MAAM,GAAuB,MAAM,CAQ7D;AAXD,0DAA0D;AAC1D;;;;GAA0G"}

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

@@ -0,0 +1,12 @@
+/** @readonly Stable IDs used in serialized input maps. */
+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) {
+    switch (handedness) {
+        case 'left': return XR_INPUT_DEVICE_IDS.left;
+        case 'right': return XR_INPUT_DEVICE_IDS.right;
+        case 'none': return XR_INPUT_DEVICE_IDS.none;
+        default: throw new Error(`Invalid XR handedness: ${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"}

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

@@ -3,6 +3,11 @@ import { InputSource } from "../InputSource.js";
 import { InputTrigger } from "./InputTrigger.js";
 import { InputTriggerType } from "./InputTriggerType.js";
 
+/**
+ * @typedef {import('../InputSourceTable.js').InputSourceTable} InputSourceTable
+ * @typedef {import('../../../../../core/binary/BitSet.js').BitSet} BitSet
+ */
+
 /**
  * True while one switch is held.
  *

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

@@ -0,0 +1,7 @@
+/** Native button facts only. No pressure threshold or semantic action lifecycle is inferred. */
+export class InputTriggerXRButton extends InputTriggerSwitch {
+    /** @param {'left'|'right'|'none'} handedness @param {number} index @param {boolean} [touched=false] */
+    static from(handedness: 'left' | 'right' | 'none', index: number, touched?: boolean): InputTriggerXRButton;
+}
+import { InputTriggerSwitch } from "./InputTriggerSwitch.js";
+//# sourceMappingURL=InputTriggerXRButton.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InputTriggerXRButton.d.ts","sourceRoot":"","sources":["../../../../../../../src/engine/input/ecs/ism/trigger/InputTriggerXRButton.js"],"names":[],"mappings":"AAKA,gGAAgG;AAChG;IACI,uGAAuG;IACvG,wBADY,MAAM,GAAC,OAAO,GAAC,MAAM,SAAqB,MAAM,YAAgB,OAAO,wBAMlF;CACJ;mCAXkC,yBAAyB"}

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

@@ -0,0 +1,15 @@
+import { assert } from "../../../../../core/assert.js";
+import { xr_input_device_id } from "../device/XR_INPUT_DEVICE_IDS.js";
+import { InputSource } from "../InputSource.js";
+import { InputTriggerSwitch } from "./InputTriggerSwitch.js";
+
+/** Native button facts only. No pressure threshold or semantic action lifecycle is inferred. */
+export class InputTriggerXRButton extends InputTriggerSwitch {
+    /** @param {'left'|'right'|'none'} handedness @param {number} index @param {boolean} [touched=false] */
+    static from(handedness, index, touched = false) {
+        assert.isNonNegativeInteger(index, 'index');
+        const result = new InputTriggerXRButton();
+        result.source = InputSource.from(xr_input_device_id(handedness), index * 2 + (touched ? 1 : 0));
+        return result;
+    }
+}

package/src/engine/physics/fluid/ecs/FluidObstacleSystem.d.ts

@@ -64,11 +64,11 @@ export class FluidObstacleSystem extends System<any> {
     /**
      * @param {FluidComponent} fluid
      */
-    static "__#413@#refresh_masks"(fluid: FluidComponent): void;
+    static "__#418@#refresh_masks"(fluid: FluidComponent): void;
     /**
      * @param {FluidComponent} fluid
      */
-    static "__#413@#clear_field"(fluid: FluidComponent): void;
+    static "__#418@#clear_field"(fluid: FluidComponent): void;
     /**
      * Mark every cell of `fluid` whose centre lies within `inflation` of the
      * posed shape as solid. Iteration is clipped to the shape's world AABB
@@ -80,7 +80,7 @@ export class FluidObstacleSystem extends System<any> {
      * @param {number} inflation       world-units SDF threshold
      * @param {Float64Array} point     length-3 scratch
      */
-    static "__#413@#voxelize"(fluid: FluidComponent, posed: PosedShape3D, aabb: Float64Array, inflation: number, point: Float64Array): void;
+    static "__#418@#voxelize"(fluid: FluidComponent, posed: PosedShape3D, aabb: Float64Array, inflation: number, point: Float64Array): void;
     /**
      * Write the obstacle's translation velocity onto every face of every cell
      * it voxelized — the moving-wall boundary condition. Runs AFTER the mask
@@ -100,7 +100,7 @@ export class FluidObstacleSystem extends System<any> {
      * @param {number} wvy
      * @param {number} wvz
      */
-    static "__#413@#stamp_wall_velocity"(fluid: FluidComponent, posed: PosedShape3D, aabb: Float64Array, inflation: number, point: Float64Array, wvx: number, wvy: number, wvz: number): void;
+    static "__#418@#stamp_wall_velocity"(fluid: FluidComponent, posed: PosedShape3D, aabb: Float64Array, inflation: number, point: Float64Array, wvx: number, wvy: number, wvz: number): void;
     constructor();
     dependencies: (typeof FluidObstacle)[];
     components_used: (ResourceAccessSpecification<typeof Transform64> | ResourceAccessSpecification<typeof RigidBody> | ResourceAccessSpecification<typeof Collider> | ResourceAccessSpecification<typeof FluidComponent> | ResourceAccessSpecification<typeof FluidObstacle>)[];