@realitycollective/threejs-interactions 0.1.0-preview.0

package/CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+Change log for the Reality Collective WebXR Interaction Extensions packages. All four packages are versioned and released together; the version below is the one carried by the `v<version>` release tag.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). Preview builds are not listed separately. The entry for a version accumulates while its previews are published, and is dated when that version is released.
+
+## [0.1.0]
+
+### Added
+
+- `@realitycollective/webxr-interactions` - engine-free core: interactables and interactors, the behaviour set (`press` including latching, `pulse`, `hinge`, `dial`, `slide`, `grab` in poseOnly and native modes, `tossScore`), gaze (`required` gating and dwell-to-press), the runtime/binder with hints > poke > ray targeting, hysteresis and lifecycle, capability negotiation with a visible `behaviourDisabled` outcome, events as the only outbound pathway, and feedback intents (haptics and audio remain the client's, with `routeHapticsToProvider` as an explicit opt-in).
+- `@realitycollective/threejs-interactions` - the default standalone adapter: raw WebXR (`XRSession` sources, hand joints, select/squeeze plus gamepad analog, haptic pulse), three.js hit-testing and transform ports, and a desktop mouse fallback. No framework required.
+- `@realitycollective/iwsdk-interactions` - Meta IWSDK adapter: player-rig poses and stateful gamepads as the provider, IWSDK's own targeting (`Pressed` / `Grabbed` tags) forwarded as pre-resolved hints, and native grab fulfilment when the app enables IWSDK grabbing/physics. One-call `registerInteractions(world)` setup.
+- `@realitycollective/xrblocks-interactions` - EXPERIMENTAL Google XR Blocks adapter, structurally typed against xrblocks v0.20.0 (`Input.getFrame()` ray sources and direct touches, pooled structs copied, no haptics upstream).
+- `demos/playground` - the standalone interaction playground: the full station set from one portable `InteractionDescriptor`, with client-side audio cues, opt-in controller haptics and client-side toss ballistics.
+
+### Notes
+
+- All four packages depend on `@realitycollective/webxr-input`, released independently from the [WebXR-Input](https://github.com/realitycollective/WebXR-Input) repository. That package must be published before this one.
+
+[0.1.0]: https://github.com/realitycollective/WebXR-Interactions/commits/main

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Reality Collective
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,59 @@
+# @realitycollective/threejs-interactions
+
+The three.js adapter for the Reality Collective Interaction Extensions. It reads raw WebXR directly, so no other framework is needed.
+
+```sh
+npm install @realitycollective/threejs-interactions three
+```
+
+It re-exports everything from [`@realitycollective/webxr-interactions`](https://www.npmjs.com/package/@realitycollective/webxr-interactions), so this is the only interaction package your app needs.
+
+## What it binds
+
+| Layer | Detail |
+| --- | --- |
+| **Input** | Raw WebXR, the browser's own XR API: controllers, hand joints, trigger and grip pressure, and haptic pulses |
+| **Hit-testing** | three.js raycasting against your scene graph |
+| **Movement** | Moves and rotates three.js objects for grab, hinge, dial and slide |
+| **Desktop** | A mouse fallback, so the same scene is testable without a headset |
+
+## Usage
+
+```ts
+import { createThreeInteractions } from "@realitycollective/threejs-interactions";
+
+const interactions = createThreeInteractions({
+  xr: renderer.xr,
+  camera,
+  domElement: renderer.domElement,
+});
+
+interactions.register({ id: "button", behaviours: [{ kind: "press" }] }, buttonMesh);
+
+interactions.runtime.onEvent((event) => console.log(event.type));
+
+let last = performance.now();
+renderer.setAnimationLoop(() => {
+  const now = performance.now();
+  const dt = Math.min(0.1, (now - last) / 1000);
+  last = now;
+  interactions.update(dt);
+  renderer.render(scene, camera);
+});
+```
+
+## Peer dependency
+
+`three >= 0.170.0`. The Reality Collective demos pin the `super-three@0.181` fork that Meta's IWSDK mandates; stock three.js works equally well for this adapter.
+
+## Live demo
+
+The interaction playground - the full station set, mouse-capable on desktop, VR button for headsets: **[webxr-interactions.pages.dev](https://webxr-interactions.pages.dev)**
+
+## Documentation
+
+See the [repository README](https://github.com/realitycollective/WebXR-Interactions#readme) and the `demos/playground` client for a complete working scene.
+
+## License
+
+MIT - see [LICENSE](./LICENSE).

package/dist/hit-tester.d.ts

@@ -0,0 +1,24 @@
+/**
+ * ThreeHitTester - resolves core ray/proximity queries against registered
+ * three.js objects. Ray hits use a Raycaster over the registered roots
+ * (recursive); proximity uses world-position distance minus an
+ * approximate bounding radius, good enough for poke targets.
+ */
+import { type Object3D } from "three";
+import type { RayTuple, Vec3Tuple } from "@realitycollective/webxr-input";
+import type { HitTester, InteractableHit } from "@realitycollective/webxr-interactions";
+export declare class ThreeHitTester implements HitTester {
+    private readonly roots;
+    private readonly byObject;
+    private readonly raycaster;
+    private readonly v;
+    private readonly w;
+    private readonly sphere;
+    register(id: string, object: Object3D): void;
+    unregister(id: string): void;
+    getObject(id: string): Object3D | undefined;
+    hitRay(ray: RayTuple): InteractableHit | null;
+    hitProximity(point: Vec3Tuple, radius: number): InteractableHit | null;
+    private ownerOf;
+    private boundingRadius;
+}

package/dist/hit-tester.js

@@ -0,0 +1,87 @@
+/**
+ * ThreeHitTester - resolves core ray/proximity queries against registered
+ * three.js objects. Ray hits use a Raycaster over the registered roots
+ * (recursive); proximity uses world-position distance minus an
+ * approximate bounding radius, good enough for poke targets.
+ */
+import { Raycaster, Sphere, Vector3 } from "three";
+export class ThreeHitTester {
+    roots = new Map();
+    byObject = new WeakMap();
+    raycaster = new Raycaster();
+    v = new Vector3();
+    w = new Vector3();
+    sphere = new Sphere();
+    register(id, object) {
+        this.roots.set(id, object);
+        this.byObject.set(object, id);
+    }
+    unregister(id) {
+        const object = this.roots.get(id);
+        if (object)
+            this.byObject.delete(object);
+        this.roots.delete(id);
+    }
+    getObject(id) {
+        return this.roots.get(id);
+    }
+    hitRay(ray) {
+        if (this.roots.size === 0)
+            return null;
+        this.raycaster.ray.origin.set(...ray.origin);
+        this.raycaster.ray.direction.set(...ray.direction);
+        const objects = [...this.roots.values()];
+        const intersections = this.raycaster.intersectObjects(objects, true);
+        for (const intersection of intersections) {
+            const id = this.ownerOf(intersection.object);
+            if (id !== null) {
+                return {
+                    interactableId: id,
+                    distance: intersection.distance,
+                    point: [intersection.point.x, intersection.point.y, intersection.point.z],
+                };
+            }
+        }
+        return null;
+    }
+    hitProximity(point, radius) {
+        this.v.set(...point);
+        let best = null;
+        for (const [id, object] of this.roots) {
+            object.getWorldPosition(this.w);
+            const surfaceDistance = Math.max(0, this.w.distanceTo(this.v) - this.boundingRadius(object));
+            if (surfaceDistance <= radius && (best === null || surfaceDistance < best.distance)) {
+                best = {
+                    interactableId: id,
+                    distance: surfaceDistance,
+                    point: [this.w.x, this.w.y, this.w.z],
+                };
+            }
+        }
+        return best;
+    }
+    ownerOf(object) {
+        let current = object;
+        while (current) {
+            const id = this.byObject.get(current);
+            if (id !== undefined)
+                return id;
+            current = current.parent;
+        }
+        return null;
+    }
+    boundingRadius(object) {
+        const geometry = object.geometry;
+        if (geometry) {
+            if (!geometry.boundingSphere)
+                geometry.computeBoundingSphere();
+            if (geometry.boundingSphere) {
+                this.sphere.copy(geometry.boundingSphere);
+                const scale = object.getWorldScale(this.w);
+                return this.sphere.radius * Math.max(scale.x, scale.y, scale.z);
+            }
+        }
+        return 0;
+    }
+}
+//# sourceMappingURL=hit-tester.js.map

package/dist/hit-tester.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hit-tester.js","sourceRoot":"","sources":["../src/hit-tester.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ThreeHitTester - resolves core ray/proximity queries against registered\n * three.js objects. Ray hits use a Raycaster over the registered roots\n * (recursive); proximity uses world-position distance minus an\n * approximate bounding radius, good enough for poke targets.\n */\nimport { Raycaster, Sphere, Vector3, type Object3D, type Mesh } from \"three\";\nimport type { RayTuple, Vec3Tuple } from \"@realitycollective/webxr-input\";\nimport type { HitTester, InteractableHit } from \"@realitycollective/webxr-interactions\";\n\nexport class ThreeHitTester implements HitTester {\n  private readonly roots = new Map<string, Object3D>();\n  private readonly byObject = new WeakMap<Object3D, string>();\n  private readonly raycaster = new Raycaster();\n  private readonly v = new Vector3();\n  private readonly w = new Vector3();\n  private readonly sphere = new Sphere();\n\n  register(id: string, object: Object3D): void {\n    this.roots.set(id, object);\n    this.byObject.set(object, id);\n  }\n\n  unregister(id: string): void {\n    const object = this.roots.get(id);\n    if (object) this.byObject.delete(object);\n    this.roots.delete(id);\n  }\n\n  getObject(id: string): Object3D | undefined {\n    return this.roots.get(id);\n  }\n\n  hitRay(ray: RayTuple): InteractableHit | null {\n    if (this.roots.size === 0) return null;\n    this.raycaster.ray.origin.set(...ray.origin);\n    this.raycaster.ray.direction.set(...ray.direction);\n    const objects = [...this.roots.values()];\n    const intersections = this.raycaster.intersectObjects(objects, true);\n    for (const intersection of intersections) {\n      const id = this.ownerOf(intersection.object);\n      if (id !== null) {\n        return {\n          interactableId: id,\n          distance: intersection.distance,\n          point: [intersection.point.x, intersection.point.y, intersection.point.z],\n        };\n      }\n    }\n    return null;\n  }\n\n  hitProximity(point: Vec3Tuple, radius: number): InteractableHit | null {\n    this.v.set(...point);\n    let best: InteractableHit | null = null;\n    for (const [id, object] of this.roots) {\n      object.getWorldPosition(this.w);\n      const surfaceDistance = Math.max(\n        0,\n        this.w.distanceTo(this.v) - this.boundingRadius(object),\n      );\n      if (surfaceDistance <= radius && (best === null || surfaceDistance < best.distance)) {\n        best = {\n          interactableId: id,\n          distance: surfaceDistance,\n          point: [this.w.x, this.w.y, this.w.z],\n        };\n      }\n    }\n    return best;\n  }\n\n  private ownerOf(object: Object3D): string | null {\n    let current: Object3D | null = object;\n    while (current) {\n      const id = this.byObject.get(current);\n      if (id !== undefined) return id;\n      current = current.parent;\n    }\n    return null;\n  }\n\n  private boundingRadius(object: Object3D): number {\n    const geometry = (object as Mesh).geometry;\n    if (geometry) {\n      if (!geometry.boundingSphere) geometry.computeBoundingSphere();\n      if (geometry.boundingSphere) {\n        this.sphere.copy(geometry.boundingSphere);\n        const scale = object.getWorldScale(this.w);\n        return this.sphere.radius * Math.max(scale.x, scale.y, scale.z);\n      }\n    }\n    return 0;\n  }\n}\n"]}

package/dist/host.d.ts

@@ -0,0 +1,34 @@
+/**
+ * createThreeInteractions - one-call setup for the standalone adapter.
+ *
+ * ```ts
+ * const interactions = createThreeInteractions({
+ *   xr: renderer.xr, camera, domElement: renderer.domElement,
+ * });
+ * interactions.register({ id: "button", behaviours: [{ kind: "press" }] }, buttonMesh);
+ * // in the render loop:
+ * interactions.update(dt);
+ * ```
+ */
+import type { Object3D } from "three";
+import { InteractionRuntime, type DwellConfig, type InteractableDescriptor } from "@realitycollective/webxr-interactions";
+import { ThreeHitTester } from "./hit-tester.js";
+import { ThreeTransformPort } from "./transform-port.js";
+import { WebXRInputProvider, type WebXRProviderContext } from "./webxr-provider.js";
+export interface ThreeInteractionsOptions extends WebXRProviderContext {
+    dwellDefaults?: DwellConfig;
+}
+export declare class ThreeInteractions {
+    readonly runtime: InteractionRuntime;
+    readonly provider: WebXRInputProvider;
+    readonly hitTester: ThreeHitTester;
+    private readonly ports;
+    constructor(options: ThreeInteractionsOptions);
+    /** Register an interactable with its scene object. */
+    register(descriptor: InteractableDescriptor, object: Object3D): ThreeTransformPort;
+    unregister(id: string): void;
+    getPort(id: string): ThreeTransformPort | undefined;
+    update(dt: number): void;
+    dispose(): void;
+}
+export declare function createThreeInteractions(options: ThreeInteractionsOptions): ThreeInteractions;

package/dist/host.js

@@ -0,0 +1,46 @@
+import { InteractionRuntime, } from "@realitycollective/webxr-interactions";
+import { ThreeHitTester } from "./hit-tester.js";
+import { ThreeTransformPort } from "./transform-port.js";
+import { WebXRInputProvider } from "./webxr-provider.js";
+export class ThreeInteractions {
+    runtime;
+    provider;
+    hitTester;
+    ports = new Map();
+    constructor(options) {
+        this.provider = new WebXRInputProvider(options);
+        this.hitTester = new ThreeHitTester();
+        this.runtime = new InteractionRuntime({
+            provider: this.provider,
+            hitTester: this.hitTester,
+            ...(options.dwellDefaults ? { dwellDefaults: options.dwellDefaults } : {}),
+        });
+    }
+    /** Register an interactable with its scene object. */
+    register(descriptor, object) {
+        const port = new ThreeTransformPort(object);
+        this.ports.set(descriptor.id, port);
+        this.hitTester.register(descriptor.id, object);
+        this.runtime.registerInteractable(descriptor, { transform: port });
+        return port;
+    }
+    unregister(id) {
+        this.runtime.unregisterInteractable(id);
+        this.hitTester.unregister(id);
+        this.ports.delete(id);
+    }
+    getPort(id) {
+        return this.ports.get(id);
+    }
+    update(dt) {
+        this.runtime.update(dt);
+    }
+    dispose() {
+        this.runtime.dispose();
+        this.provider.dispose();
+    }
+}
+export function createThreeInteractions(options) {
+    return new ThreeInteractions(options);
+}
+//# sourceMappingURL=host.js.map

package/dist/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../src/host.ts"],"names":[],"mappings":"AAaA,OAAO,EACL,kBAAkB,GAGnB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAA6B,MAAM,qBAAqB,CAAC;AAMpF,MAAM,OAAO,iBAAiB;IACnB,OAAO,CAAqB;IAC5B,QAAQ,CAAqB;IAC7B,SAAS,CAAiB;IAClB,KAAK,GAAG,IAAI,GAAG,EAA8B,CAAC;IAE/D,YAAY,OAAiC;QAC3C,IAAI,CAAC,QAAQ,GAAG,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS,GAAG,IAAI,cAAc,EAAE,CAAC;QACtC,IAAI,CAAC,OAAO,GAAG,IAAI,kBAAkB,CAAC;YACpC,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3E,CAAC,CAAC;IACL,CAAC;IAED,sDAAsD;IACtD,QAAQ,CAAC,UAAkC,EAAE,MAAgB;QAC3D,MAAM,IAAI,GAAG,IAAI,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,UAAU,CAAC,EAAU;QACnB,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;IAED,OAAO,CAAC,EAAU;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,EAAU;QACf,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO;QACL,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAiC;IACvE,OAAO,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC","sourcesContent":["/**\n * createThreeInteractions - one-call setup for the standalone adapter.\n *\n * ```ts\n * const interactions = createThreeInteractions({\n *   xr: renderer.xr, camera, domElement: renderer.domElement,\n * });\n * interactions.register({ id: \"button\", behaviours: [{ kind: \"press\" }] }, buttonMesh);\n * // in the render loop:\n * interactions.update(dt);\n * ```\n */\nimport type { Object3D } from \"three\";\nimport {\n  InteractionRuntime,\n  type DwellConfig,\n  type InteractableDescriptor,\n} from \"@realitycollective/webxr-interactions\";\nimport { ThreeHitTester } from \"./hit-tester.js\";\nimport { ThreeTransformPort } from \"./transform-port.js\";\nimport { WebXRInputProvider, type WebXRProviderContext } from \"./webxr-provider.js\";\n\nexport interface ThreeInteractionsOptions extends WebXRProviderContext {\n  dwellDefaults?: DwellConfig;\n}\n\nexport class ThreeInteractions {\n  readonly runtime: InteractionRuntime;\n  readonly provider: WebXRInputProvider;\n  readonly hitTester: ThreeHitTester;\n  private readonly ports = new Map<string, ThreeTransformPort>();\n\n  constructor(options: ThreeInteractionsOptions) {\n    this.provider = new WebXRInputProvider(options);\n    this.hitTester = new ThreeHitTester();\n    this.runtime = new InteractionRuntime({\n      provider: this.provider,\n      hitTester: this.hitTester,\n      ...(options.dwellDefaults ? { dwellDefaults: options.dwellDefaults } : {}),\n    });\n  }\n\n  /** Register an interactable with its scene object. */\n  register(descriptor: InteractableDescriptor, object: Object3D): ThreeTransformPort {\n    const port = new ThreeTransformPort(object);\n    this.ports.set(descriptor.id, port);\n    this.hitTester.register(descriptor.id, object);\n    this.runtime.registerInteractable(descriptor, { transform: port });\n    return port;\n  }\n\n  unregister(id: string): void {\n    this.runtime.unregisterInteractable(id);\n    this.hitTester.unregister(id);\n    this.ports.delete(id);\n  }\n\n  getPort(id: string): ThreeTransformPort | undefined {\n    return this.ports.get(id);\n  }\n\n  update(dt: number): void {\n    this.runtime.update(dt);\n  }\n\n  dispose(): void {\n    this.runtime.dispose();\n    this.provider.dispose();\n  }\n}\n\nexport function createThreeInteractions(options: ThreeInteractionsOptions): ThreeInteractions {\n  return new ThreeInteractions(options);\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @realitycollective/threejs-interactions - the default, standalone engine
+ * adapter: raw WebXR input + three.js hit-testing/transform ports. The
+ * core is re-exported wholesale, so apps depend on exactly this package.
+ */
+export * from "@realitycollective/webxr-interactions";
+export * from "./webxr-provider.js";
+export * from "./hit-tester.js";
+export * from "./transform-port.js";
+export * from "./host.js";

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * @realitycollective/threejs-interactions - the default, standalone engine
+ * adapter: raw WebXR input + three.js hit-testing/transform ports. The
+ * core is re-exported wholesale, so apps depend on exactly this package.
+ */
+export * from "@realitycollective/webxr-interactions";
+export * from "./webxr-provider.js";
+export * from "./hit-tester.js";
+export * from "./transform-port.js";
+export * from "./host.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,uCAAuC,CAAC;AAEtD,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC","sourcesContent":["/**\n * @realitycollective/threejs-interactions - the default, standalone engine\n * adapter: raw WebXR input + three.js hit-testing/transform ports. The\n * core is re-exported wholesale, so apps depend on exactly this package.\n */\nexport * from \"@realitycollective/webxr-interactions\";\n\nexport * from \"./webxr-provider.js\";\nexport * from \"./hit-tester.js\";\nexport * from \"./transform-port.js\";\nexport * from \"./host.js\";\n"]}

package/dist/transform-port.d.ts

@@ -0,0 +1,33 @@
+/**
+ * ThreeTransformPort - the write/read surface of one interactable's
+ * Object3D, honouring the core's FROM-REST semantics: the rest pose is
+ * captured at construction, offsets/rotations apply relative to it, and
+ * `getWorldPose()` reports the REST pose in world space (external movers
+ * that reposition the object should call `recaptureRest()`).
+ */
+import { type Object3D } from "three";
+import type { PoseTuple, QuatTuple, Vec3Tuple } from "@realitycollective/webxr-input";
+import type { TransformPort } from "@realitycollective/webxr-interactions";
+export declare class ThreeTransformPort implements TransformPort {
+    private readonly object;
+    private readonly restPosition;
+    private readonly restQuaternion;
+    private readonly restScale;
+    private baseEmissive;
+    private readonly v;
+    private readonly q;
+    private readonly q2;
+    private readonly m;
+    constructor(object: Object3D);
+    recaptureRest(): void;
+    getWorldPose(): PoseTuple;
+    getLocalOffset(): Vec3Tuple;
+    setLocalOffset(offset: Vec3Tuple): void;
+    setLocalRotation(quaternion: QuatTuple): void;
+    setWorldPose(pose: PoseTuple): void;
+    setEffect(effect: {
+        scale?: number;
+        emissive?: number;
+    }): void;
+    private firstEmissiveMaterial;
+}

package/dist/transform-port.js

@@ -0,0 +1,101 @@
+/**
+ * ThreeTransformPort - the write/read surface of one interactable's
+ * Object3D, honouring the core's FROM-REST semantics: the rest pose is
+ * captured at construction, offsets/rotations apply relative to it, and
+ * `getWorldPose()` reports the REST pose in world space (external movers
+ * that reposition the object should call `recaptureRest()`).
+ */
+import { Matrix4, Quaternion, Vector3, } from "three";
+export class ThreeTransformPort {
+    object;
+    restPosition = new Vector3();
+    restQuaternion = new Quaternion();
+    restScale = new Vector3();
+    baseEmissive = null;
+    // Temps.
+    v = new Vector3();
+    q = new Quaternion();
+    q2 = new Quaternion();
+    m = new Matrix4();
+    constructor(object) {
+        this.object = object;
+        this.recaptureRest();
+    }
+    recaptureRest() {
+        this.restPosition.copy(this.object.position);
+        this.restQuaternion.copy(this.object.quaternion);
+        this.restScale.copy(this.object.scale);
+    }
+    getWorldPose() {
+        const parent = this.object.parent;
+        if (parent) {
+            parent.updateWorldMatrix(true, false);
+            this.v.copy(this.restPosition).applyMatrix4(parent.matrixWorld);
+            parent.getWorldQuaternion(this.q2);
+            this.q.copy(this.q2).multiply(this.restQuaternion);
+        }
+        else {
+            this.v.copy(this.restPosition);
+            this.q.copy(this.restQuaternion);
+        }
+        return {
+            position: [this.v.x, this.v.y, this.v.z],
+            quaternion: [this.q.x, this.q.y, this.q.z, this.q.w],
+        };
+    }
+    getLocalOffset() {
+        this.v.copy(this.object.position).sub(this.restPosition);
+        this.q.copy(this.restQuaternion).invert();
+        this.v.applyQuaternion(this.q);
+        return [this.v.x, this.v.y, this.v.z];
+    }
+    setLocalOffset(offset) {
+        this.v.set(...offset).applyQuaternion(this.restQuaternion);
+        this.object.position.copy(this.restPosition).add(this.v);
+    }
+    setLocalRotation(quaternion) {
+        this.q.set(...quaternion);
+        this.object.quaternion.copy(this.restQuaternion).multiply(this.q);
+    }
+    setWorldPose(pose) {
+        const parent = this.object.parent;
+        this.v.set(...pose.position);
+        this.q.set(...pose.quaternion);
+        if (parent) {
+            parent.updateWorldMatrix(true, false);
+            this.m.copy(parent.matrixWorld).invert();
+            this.v.applyMatrix4(this.m);
+            parent.getWorldQuaternion(this.q2).invert();
+            this.q.premultiply(this.q2);
+        }
+        this.object.position.copy(this.v);
+        this.object.quaternion.copy(this.q);
+    }
+    setEffect(effect) {
+        if (effect.scale !== undefined) {
+            this.object.scale.copy(this.restScale).multiplyScalar(effect.scale);
+        }
+        if (effect.emissive !== undefined) {
+            const material = this.firstEmissiveMaterial();
+            if (material) {
+                if (this.baseEmissive === null)
+                    this.baseEmissive = material.emissiveIntensity;
+                material.emissiveIntensity = this.baseEmissive + effect.emissive;
+            }
+        }
+    }
+    firstEmissiveMaterial() {
+        let found = null;
+        this.object.traverse((child) => {
+            if (found)
+                return;
+            const material = child.material;
+            const single = Array.isArray(material) ? material[0] : material;
+            if (single && "emissiveIntensity" in single) {
+                found = single;
+            }
+        });
+        return found;
+    }
+}
+//# sourceMappingURL=transform-port.js.map

package/dist/transform-port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-port.js","sourceRoot":"","sources":["../src/transform-port.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * ThreeTransformPort - the write/read surface of one interactable's\n * Object3D, honouring the core's FROM-REST semantics: the rest pose is\n * captured at construction, offsets/rotations apply relative to it, and\n * `getWorldPose()` reports the REST pose in world space (external movers\n * that reposition the object should call `recaptureRest()`).\n */\nimport {\n  Matrix4,\n  Quaternion,\n  Vector3,\n  type Material,\n  type Mesh,\n  type MeshStandardMaterial,\n  type Object3D,\n} from \"three\";\nimport type { PoseTuple, QuatTuple, Vec3Tuple } from \"@realitycollective/webxr-input\";\nimport type { TransformPort } from \"@realitycollective/webxr-interactions\";\n\nexport class ThreeTransformPort implements TransformPort {\n  private readonly object: Object3D;\n  private readonly restPosition = new Vector3();\n  private readonly restQuaternion = new Quaternion();\n  private readonly restScale = new Vector3();\n  private baseEmissive: number | null = null;\n\n  // Temps.\n  private readonly v = new Vector3();\n  private readonly q = new Quaternion();\n  private readonly q2 = new Quaternion();\n  private readonly m = new Matrix4();\n\n  constructor(object: Object3D) {\n    this.object = object;\n    this.recaptureRest();\n  }\n\n  recaptureRest(): void {\n    this.restPosition.copy(this.object.position);\n    this.restQuaternion.copy(this.object.quaternion);\n    this.restScale.copy(this.object.scale);\n  }\n\n  getWorldPose(): PoseTuple {\n    const parent = this.object.parent;\n    if (parent) {\n      parent.updateWorldMatrix(true, false);\n      this.v.copy(this.restPosition).applyMatrix4(parent.matrixWorld);\n      parent.getWorldQuaternion(this.q2);\n      this.q.copy(this.q2).multiply(this.restQuaternion);\n    } else {\n      this.v.copy(this.restPosition);\n      this.q.copy(this.restQuaternion);\n    }\n    return {\n      position: [this.v.x, this.v.y, this.v.z],\n      quaternion: [this.q.x, this.q.y, this.q.z, this.q.w],\n    };\n  }\n\n  getLocalOffset(): Vec3Tuple {\n    this.v.copy(this.object.position).sub(this.restPosition);\n    this.q.copy(this.restQuaternion).invert();\n    this.v.applyQuaternion(this.q);\n    return [this.v.x, this.v.y, this.v.z];\n  }\n\n  setLocalOffset(offset: Vec3Tuple): void {\n    this.v.set(...offset).applyQuaternion(this.restQuaternion);\n    this.object.position.copy(this.restPosition).add(this.v);\n  }\n\n  setLocalRotation(quaternion: QuatTuple): void {\n    this.q.set(...quaternion);\n    this.object.quaternion.copy(this.restQuaternion).multiply(this.q);\n  }\n\n  setWorldPose(pose: PoseTuple): void {\n    const parent = this.object.parent;\n    this.v.set(...pose.position);\n    this.q.set(...pose.quaternion);\n    if (parent) {\n      parent.updateWorldMatrix(true, false);\n      this.m.copy(parent.matrixWorld).invert();\n      this.v.applyMatrix4(this.m);\n      parent.getWorldQuaternion(this.q2).invert();\n      this.q.premultiply(this.q2);\n    }\n    this.object.position.copy(this.v);\n    this.object.quaternion.copy(this.q);\n  }\n\n  setEffect(effect: { scale?: number; emissive?: number }): void {\n    if (effect.scale !== undefined) {\n      this.object.scale.copy(this.restScale).multiplyScalar(effect.scale);\n    }\n    if (effect.emissive !== undefined) {\n      const material = this.firstEmissiveMaterial();\n      if (material) {\n        if (this.baseEmissive === null) this.baseEmissive = material.emissiveIntensity;\n        material.emissiveIntensity = this.baseEmissive + effect.emissive;\n      }\n    }\n  }\n\n  private firstEmissiveMaterial(): MeshStandardMaterial | null {\n    let found: MeshStandardMaterial | null = null;\n    this.object.traverse((child) => {\n      if (found) return;\n      const material = (child as Mesh).material as Material | Material[] | undefined;\n      const single = Array.isArray(material) ? material[0] : material;\n      if (single && \"emissiveIntensity\" in single) {\n        found = single as MeshStandardMaterial;\n      }\n    });\n    return found;\n  }\n}\n"]}

package/dist/webxr-provider.d.ts

@@ -0,0 +1,84 @@
+/**
+ * WebXRInputProvider - the standalone, framework-free input provider.
+ *
+ * Speaks the browser's OpenXR binding directly: `XRSession` input sources
+ * (`targetRaySpace`, `gripSpace`, `hand` joints), `selectstart/selectend`
+ * and `squeezestart/squeezeend`, gamepad analog values where present, and
+ * haptic actuators. Falls back to a desktop mouse pointer (a ray from the
+ * camera through the cursor) when no immersive session is live, so every
+ * consumer runs in a flat browser too.
+ *
+ * Capabilities are derived from the LIVE session (never the requested
+ * config) and re-published on session start/end and input-source changes.
+ */
+import { type Camera, type WebXRManager } from "three";
+import { type HeadPose, type InputCapabilities, type InputProvider, type InputSourceSnapshot, type Unsubscribe } from "@realitycollective/webxr-input";
+export interface WebXRProviderContext {
+    /** three.js `renderer.xr` (or anything with the same session surface). */
+    xr: Pick<WebXRManager, "getSession" | "getReferenceSpace" | "getFrame">;
+    /** The rendering camera - head pose in XR, pointer projection on desktop. */
+    camera: Camera;
+    /** DOM element for the desktop mouse fallback (canvas). Omit to disable. */
+    domElement?: HTMLElement;
+    /**
+     * Metres along the mouse ray at which the desktop fallback places its
+     * synthetic grip pose. Hand-driven behaviours (grab, hinge, dial, slide)
+     * track a grip position; a mouse has none, so one is projected onto the ray.
+     * Set this near the distance of the things being manipulated - too short and
+     * levers barely swing, too long and they over-swing. Default 1 metre.
+     */
+    desktopGripDistance?: number;
+    /**
+     * Which mouse button reports `squeeze` on desktop. Default `"left"`.
+     *
+     * The right button is NOT the default, because the shared desktop camera
+     * controls (`DesktopControls` in `@realitycollective/xrblocks-uiextensions`)
+     * bind right-drag to look and reserve the left button for interaction. That
+     * leaves the left button to carry both actions, which is fine as long as an
+     * interactable does not mix a select-driven behaviour (press) with a
+     * grab-driven one (grab, hinge, dial, slide) - such an interactable would
+     * receive both on a single click. Use `"right"` only in an app that does not
+     * use right-drag to look.
+     */
+    desktopSqueezeButton?: "left" | "right" | "none";
+}
+export declare class WebXRInputProvider implements InputProvider {
+    private readonly context;
+    private capabilities;
+    private readonly capsListeners;
+    private readonly sourceListeners;
+    private readonly selectStates;
+    private boundSession;
+    private readonly sessionHandlers;
+    private mouseDown;
+    private mouseRight;
+    private readonly mouseNdc;
+    private readonly raycaster;
+    private readonly detachDom;
+    private readonly gripDistance;
+    private readonly squeezeButton;
+    private readonly v;
+    private readonly q;
+    private readonly pointerNdc;
+    private readonly gripPoint;
+    private readonly gripQuaternion;
+    constructor(context: WebXRProviderContext);
+    private attachDom;
+    /** Bind/unbind session listeners as the session comes and goes. */
+    private syncSession;
+    private selectState;
+    private refreshCapabilities;
+    getCapabilities(): InputCapabilities;
+    onCapabilitiesChanged(listener: (c: InputCapabilities) => void): Unsubscribe;
+    onSourcesChanged(listener: () => void): Unsubscribe;
+    sample(): readonly InputSourceSnapshot[];
+    /** Analog trigger where available, else the select event state. */
+    private selectValue;
+    private squeezeValue;
+    /** Is the configured squeeze button currently held? */
+    private squeezing;
+    private sampleDesktop;
+    getHeadPose(): HeadPose;
+    pulse(sourceId: string, intensity: number, durationMs: number): boolean;
+    dispose(): void;
+}

package/dist/webxr-provider.js

@@ -0,0 +1,366 @@
+/**
+ * WebXRInputProvider - the standalone, framework-free input provider.
+ *
+ * Speaks the browser's OpenXR binding directly: `XRSession` input sources
+ * (`targetRaySpace`, `gripSpace`, `hand` joints), `selectstart/selectend`
+ * and `squeezestart/squeezeend`, gamepad analog values where present, and
+ * haptic actuators. Falls back to a desktop mouse pointer (a ray from the
+ * camera through the cursor) when no immersive session is live, so every
+ * consumer runs in a flat browser too.
+ *
+ * Capabilities are derived from the LIVE session (never the requested
+ * config) and re-published on session start/end and input-source changes.
+ */
+import { Raycaster, Vector2, Vector3, Quaternion } from "three";
+import { NO_CAPABILITIES, } from "@realitycollective/webxr-input";
+/** Where the desktop fallback puts its synthetic grip along the mouse ray. */
+const DEFAULT_DESKTOP_GRIP_DISTANCE = 1;
+/** Centre of the viewport, used while the pointer is locked. */
+const ZERO_NDC = new Vector2(0, 0);
+export class WebXRInputProvider {
+    context;
+    capabilities;
+    capsListeners = new Set();
+    sourceListeners = new Set();
+    selectStates = new Map();
+    boundSession = null;
+    sessionHandlers = [];
+    // Desktop pointer state.
+    mouseDown = false;
+    mouseRight = false;
+    mouseNdc = new Vector2();
+    raycaster = new Raycaster();
+    detachDom;
+    gripDistance;
+    squeezeButton;
+    // Temps.
+    v = new Vector3();
+    q = new Quaternion();
+    pointerNdc = new Vector2();
+    gripPoint = new Vector3();
+    gripQuaternion = new Quaternion();
+    constructor(context) {
+        this.context = context;
+        this.gripDistance = context.desktopGripDistance ?? DEFAULT_DESKTOP_GRIP_DISTANCE;
+        // Read before attachDom - it decides whether to claim the context menu.
+        this.squeezeButton = context.desktopSqueezeButton ?? "left";
+        this.capabilities = { ...NO_CAPABILITIES, headPose: true, gaze: true };
+        this.detachDom = this.attachDom(context.domElement);
+        this.refreshCapabilities();
+    }
+    attachDom(element) {
+        if (!element)
+            return () => undefined;
+        const onMove = (event) => {
+            const rect = element.getBoundingClientRect();
+            this.mouseNdc.set(((event.clientX - rect.left) / rect.width) * 2 - 1, -((event.clientY - rect.top) / rect.height) * 2 + 1);
+        };
+        const onDown = (event) => {
+            if (event.button === 0)
+                this.mouseDown = true;
+            if (event.button === 2)
+                this.mouseRight = true;
+            onMove(event);
+        };
+        const onUp = (event) => {
+            if (event.button === 0)
+                this.mouseDown = false;
+            if (event.button === 2)
+                this.mouseRight = false;
+        };
+        element.addEventListener("pointermove", onMove);
+        element.addEventListener("pointerdown", onDown);
+        // Only when the right button carries squeeze. Otherwise the menu belongs to
+        // whoever else is listening - the shared camera controls suppress it there.
+        // Without this, a right press opens the menu, the matching pointerup never
+        // arrives, and the squeeze latches on.
+        const onContextMenu = this.squeezeButton === "right" ? (event) => event.preventDefault() : undefined;
+        if (onContextMenu)
+            element.addEventListener("contextmenu", onContextMenu);
+        window.addEventListener("pointerup", onUp);
+        return () => {
+            element.removeEventListener("pointermove", onMove);
+            element.removeEventListener("pointerdown", onDown);
+            if (onContextMenu)
+                element.removeEventListener("contextmenu", onContextMenu);
+            window.removeEventListener("pointerup", onUp);
+        };
+    }
+    /** Bind/unbind session listeners as the session comes and goes. */
+    syncSession() {
+        const session = this.context.xr.getSession();
+        if (session === this.boundSession)
+            return session;
+        if (this.boundSession) {
+            for (const [type, handler] of this.sessionHandlers) {
+                this.boundSession.removeEventListener(type, handler);
+            }
+            this.sessionHandlers.length = 0;
+            this.selectStates.clear();
+        }
+        this.boundSession = session;
+        if (session) {
+            const setSelect = (selecting) => (event) => {
+                const source = event.inputSource;
+                const state = this.selectState(source);
+                state.selecting = selecting;
+            };
+            const setSqueeze = (squeezing) => (event) => {
+                const source = event.inputSource;
+                const state = this.selectState(source);
+                state.squeezing = squeezing;
+            };
+            const onSourcesChange = () => {
+                this.refreshCapabilities();
+                for (const listener of [...this.sourceListeners])
+                    listener();
+            };
+            const onEnd = () => {
+                this.boundSession = null;
+                this.sessionHandlers.length = 0;
+                this.selectStates.clear();
+                this.refreshCapabilities();
+            };
+            const pairs = [
+                ["selectstart", setSelect(true)],
+                ["selectend", setSelect(false)],
+                ["squeezestart", setSqueeze(true)],
+                ["squeezeend", setSqueeze(false)],
+                ["inputsourceschange", onSourcesChange],
+                ["end", onEnd],
+            ];
+            for (const [type, handler] of pairs) {
+                session.addEventListener(type, handler);
+                this.sessionHandlers.push([type, handler]);
+            }
+            this.refreshCapabilities();
+        }
+        return session;
+    }
+    selectState(source) {
+        let state = this.selectStates.get(source);
+        if (!state) {
+            state = { selecting: false, squeezing: false };
+            this.selectStates.set(source, state);
+        }
+        return state;
+    }
+    refreshCapabilities() {
+        const session = this.boundSession ?? this.context.xr.getSession();
+        const desktop = this.context.domElement !== undefined && session === null;
+        const next = {
+            ...NO_CAPABILITIES,
+            headPose: true,
+            gaze: true,
+            pointer2d: desktop,
+            // NOTE: `rays` stays false on desktop on purpose. sample() uses it as the
+            // "a session just ended" sentinel, so setting it here would re-derive
+            // capabilities on every frame for the whole life of the page.
+            // The desktop fallback synthesises a grip on the mouse ray, so hand-driven
+            // behaviours (grab, hinge, dial, slide) negotiate successfully. Without
+            // this `grabs` stays "none" off-headset and capability negotiation
+            // disables every one of them, leaving press as the only usable behaviour.
+            grabs: desktop ? "poseOnly" : NO_CAPABILITIES.grabs,
+        };
+        if (session) {
+            for (const source of session.inputSources) {
+                if (source.targetRaySpace)
+                    next.rays = true;
+                if (source.gripSpace || source.hand)
+                    next.grabs = "poseOnly";
+                if (source.hand) {
+                    next.handJoints = true;
+                    next.pokes = true;
+                    next.pinch = true;
+                }
+                if (source.gamepad) {
+                    next.buttonsAxes = true;
+                    if ((source.gamepad.hapticActuators?.length ?? 0) > 0)
+                        next.haptics = true;
+                }
+            }
+        }
+        const changed = JSON.stringify(next) !== JSON.stringify(this.capabilities);
+        this.capabilities = next;
+        if (changed) {
+            for (const listener of [...this.capsListeners])
+                listener(next);
+        }
+    }
+    getCapabilities() {
+        return this.capabilities;
+    }
+    onCapabilitiesChanged(listener) {
+        this.capsListeners.add(listener);
+        return () => this.capsListeners.delete(listener);
+    }
+    onSourcesChanged(listener) {
+        this.sourceListeners.add(listener);
+        return () => this.sourceListeners.delete(listener);
+    }
+    sample() {
+        const session = this.syncSession();
+        // The session-null path also re-derives capabilities when a session
+        // just ended between frames.
+        if (!session) {
+            if (this.capabilities.rays)
+                this.refreshCapabilities();
+            return this.sampleDesktop();
+        }
+        const frame = this.context.xr.getFrame();
+        const referenceSpace = this.context.xr.getReferenceSpace();
+        if (!frame || !referenceSpace)
+            return [];
+        const snapshots = [];
+        let index = 0;
+        for (const source of session.inputSources) {
+            const state = this.selectState(source);
+            const id = `${source.handedness}-${source.hand ? "hand" : "controller"}-${index++}`;
+            const snapshot = {
+                id,
+                kind: source.hand ? "hand" : "controller",
+                handedness: source.handedness === "left" || source.handedness === "right"
+                    ? source.handedness
+                    : "none",
+                select: this.selectValue(source, state),
+                squeeze: this.squeezeValue(source, state),
+            };
+            const rayPose = frame.getPose(source.targetRaySpace, referenceSpace);
+            if (rayPose) {
+                const p = rayPose.transform.position;
+                const o = rayPose.transform.orientation;
+                this.q.set(o.x, o.y, o.z, o.w);
+                this.v.set(0, 0, -1).applyQuaternion(this.q);
+                snapshot.ray = {
+                    origin: [p.x, p.y, p.z],
+                    direction: [this.v.x, this.v.y, this.v.z],
+                };
+            }
+            if (source.gripSpace) {
+                const gripPose = frame.getPose(source.gripSpace, referenceSpace);
+                if (gripPose)
+                    snapshot.gripPose = xrPoseToTuple(gripPose);
+            }
+            if (source.hand) {
+                const joint = source.hand.get("index-finger-tip");
+                const jointPose = joint ? frame.getJointPose?.(joint, referenceSpace) : undefined;
+                if (jointPose) {
+                    const p = jointPose.transform.position;
+                    snapshot.indexTip = [p.x, p.y, p.z];
+                }
+                // Hands without a gripSpace still need a carry pose: use the wrist.
+                if (!snapshot.gripPose) {
+                    const wrist = source.hand.get("wrist");
+                    const wristPose = wrist ? frame.getJointPose?.(wrist, referenceSpace) : undefined;
+                    if (wristPose)
+                        snapshot.gripPose = xrPoseToTuple(wristPose);
+                }
+            }
+            if ((source.gamepad?.hapticActuators?.length ?? 0) > 0) {
+                snapshot.hapticsAvailable = true;
+            }
+            snapshots.push(snapshot);
+        }
+        return snapshots;
+    }
+    /** Analog trigger where available, else the select event state. */
+    selectValue(source, state) {
+        const analog = source.gamepad?.buttons[0]?.value;
+        if (analog !== undefined && analog > 0)
+            return analog;
+        return state.selecting ? 1 : 0;
+    }
+    squeezeValue(source, state) {
+        const analog = source.gamepad?.buttons[1]?.value;
+        if (analog !== undefined && analog > 0)
+            return analog;
+        return state.squeezing ? 1 : 0;
+    }
+    /** Is the configured squeeze button currently held? */
+    squeezing() {
+        if (this.squeezeButton === "left")
+            return this.mouseDown;
+        if (this.squeezeButton === "right")
+            return this.mouseRight;
+        return false;
+    }
+    sampleDesktop() {
+        const element = this.context.domElement;
+        if (!element)
+            return [];
+        // Under pointer lock the cursor stops moving and clientX/clientY freeze, so
+        // the tracked NDC would stick wherever the pointer was when it locked. A
+        // locked pointer aims from the centre of the viewport instead.
+        const locked = typeof document !== "undefined" && document.pointerLockElement === element;
+        this.pointerNdc.copy(locked ? ZERO_NDC : this.mouseNdc);
+        this.raycaster.setFromCamera(this.pointerNdc, this.context.camera);
+        const { origin, direction } = this.raycaster.ray;
+        // A mouse has no grip. Hand-driven behaviours read `gripPose.position` (or
+        // fall back to `ray.origin`, which is the camera and barely moves), so
+        // project a grip onto the ray to give them something that tracks the
+        // pointer.
+        this.gripPoint.copy(direction).multiplyScalar(this.gripDistance).add(origin);
+        this.context.camera.getWorldQuaternion(this.gripQuaternion);
+        return [
+            {
+                id: "mouse",
+                kind: "pointer2d",
+                handedness: "none",
+                ray: {
+                    origin: [origin.x, origin.y, origin.z],
+                    direction: [direction.x, direction.y, direction.z],
+                },
+                gripPose: {
+                    position: [this.gripPoint.x, this.gripPoint.y, this.gripPoint.z],
+                    quaternion: [
+                        this.gripQuaternion.x,
+                        this.gripQuaternion.y,
+                        this.gripQuaternion.z,
+                        this.gripQuaternion.w,
+                    ],
+                },
+                select: this.mouseDown ? 1 : 0,
+                squeeze: this.squeezing() ? 1 : 0,
+            },
+        ];
+    }
+    getHeadPose() {
+        this.context.camera.getWorldPosition(this.v);
+        this.context.camera.getWorldQuaternion(this.q);
+        return {
+            position: [this.v.x, this.v.y, this.v.z],
+            quaternion: [this.q.x, this.q.y, this.q.z, this.q.w],
+        };
+    }
+    pulse(sourceId, intensity, durationMs) {
+        const session = this.boundSession;
+        if (!session)
+            return false;
+        let index = 0;
+        for (const source of session.inputSources) {
+            const id = `${source.handedness}-${source.hand ? "hand" : "controller"}-${index++}`;
+            if (id !== sourceId)
+                continue;
+            const actuator = source.gamepad?.hapticActuators?.[0];
+            if (!actuator)
+                return false;
+            void actuator.pulse?.(Math.min(1, Math.max(0, intensity)), durationMs);
+            return true;
+        }
+        return false;
+    }
+    dispose() {
+        this.detachDom();
+        if (this.boundSession) {
+            for (const [type, handler] of this.sessionHandlers) {
+                this.boundSession.removeEventListener(type, handler);
+            }
+        }
+    }
+}
+function xrPoseToTuple(pose) {
+    const p = pose.transform.position;
+    const o = pose.transform.orientation;
+    return { position: [p.x, p.y, p.z], quaternion: [o.x, o.y, o.z, o.w] };
+}
+//# sourceMappingURL=webxr-provider.js.map

package/dist/webxr-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webxr-provider.js","sourceRoot":"","sources":["../src/webxr-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAkC,MAAM,OAAO,CAAC;AAChG,OAAO,EACL,eAAe,GAOhB,MAAM,gCAAgC,CAAC;AAqCxC,8EAA8E;AAC9E,MAAM,6BAA6B,GAAG,CAAC,CAAC;AAExC,gEAAgE;AAChE,MAAM,QAAQ,GAAG,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAEnC,MAAM,OAAO,kBAAkB;IACZ,OAAO,CAAuB;IACvC,YAAY,CAAoB;IACvB,aAAa,GAAG,IAAI,GAAG,EAAkC,CAAC;IAC1D,eAAe,GAAG,IAAI,GAAG,EAAc,CAAC;IACxC,YAAY,GAAG,IAAI,GAAG,EAA8B,CAAC;IAC9D,YAAY,GAAqB,IAAI,CAAC;IAC7B,eAAe,GAAmC,EAAE,CAAC;IAEtE,yBAAyB;IACjB,SAAS,GAAG,KAAK,CAAC;IAClB,UAAU,GAAG,KAAK,CAAC;IACV,QAAQ,GAAG,IAAI,OAAO,EAAE,CAAC;IACzB,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;IAC5B,SAAS,CAAc;IACvB,YAAY,CAAS;IACrB,aAAa,CAA4B;IAE1D,SAAS;IACQ,CAAC,GAAG,IAAI,OAAO,EAAE,CAAC;IAClB,CAAC,GAAG,IAAI,UAAU,EAAE,CAAC;IACrB,UAAU,GAAG,IAAI,OAAO,EAAE,CAAC;IAC3B,SAAS,GAAG,IAAI,OAAO,EAAE,CAAC;IAC1B,cAAc,GAAG,IAAI,UAAU,EAAE,CAAC;IAEnD,YAAY,OAA6B;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,mBAAmB,IAAI,6BAA6B,CAAC;QACjF,wEAAwE;QACxE,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,oBAAoB,IAAI,MAAM,CAAC;QAC5D,IAAI,CAAC,YAAY,GAAG,EAAE,GAAG,eAAe,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACvE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACpD,IAAI,CAAC,mBAAmB,EAAE,CAAC;IAC7B,CAAC;IAEO,SAAS,CAAC,OAAgC;QAChD,IAAI,CAAC,OAAO;YAAE,OAAO,GAAG,EAAE,CAAC,SAAS,CAAC;QACrC,MAAM,MAAM,GAAG,CAAC,KAAmB,EAAE,EAAE;YACrC,MAAM,IAAI,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;YAC7C,IAAI,CAAC,QAAQ,CAAC,GAAG,CACf,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAClD,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CACpD,CAAC;QACJ,CAAC,CAAC;QACF,MAAM,MAAM,GAAG,CAAC,KAAmB,EAAE,EAAE;YACrC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;YAC9C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YAC/C,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC;QACF,MAAM,IAAI,GAAG,CAAC,KAAmB,EAAE,EAAE;YACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;YAC/C,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QAClD,CAAC,CAAC;QACF,OAAO,CAAC,gBAAgB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAChD,OAAO,CAAC,gBAAgB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;QAChD,4EAA4E;QAC5E,4EAA4E;QAC5E,2EAA2E;QAC3E,uCAAuC;QACvC,MAAM,aAAa,GACjB,IAAI,CAAC,aAAa,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,KAAY,EAAE,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACxF,IAAI,aAAa;YAAE,OAAO,CAAC,gBAAgB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;QAC1E,MAAM,CAAC,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAC3C,OAAO,GAAG,EAAE;YACV,OAAO,CAAC,mBAAmB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;YACnD,OAAO,CAAC,mBAAmB,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;YACnD,IAAI,aAAa;gBAAE,OAAO,CAAC,mBAAmB,CAAC,aAAa,EAAE,aAAa,CAAC,CAAC;YAC7E,MAAM,CAAC,mBAAmB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAChD,CAAC,CAAC;IACJ,CAAC;IAED,mEAAmE;IAC3D,WAAW;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC;QAC7C,IAAI,OAAO,KAAK,IAAI,CAAC,YAAY;YAAE,OAAO,OAAO,CAAC;QAElD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBACnD,IAAI,CAAC,YAAY,CAAC,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACvD,CAAC;YACD,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC;YAChC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC5B,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;QAC5B,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,SAAS,GAAG,CAAC,SAAkB,EAAE,EAAE,CAAC,CAAC,KAAY,EAAE,EAAE;gBACzD,MAAM,MAAM,GAAI,KAA4B,CAAC,WAAW,CAAC;gBACzD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;gBACvC,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;YAC9B,CAAC,CAAC;YACF,MAAM,UAAU,GAAG,CAAC,SAAkB,EAAE,EAAE,CAAC,CAAC,KAAY,EAAE,EAAE;gBAC1D,MAAM,MAAM,GAAI,KAA4B,CAAC,WAAW,CAAC;gBACzD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;gBACvC,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;YAC9B,CAAC,CAAC;YACF,MAAM,eAAe,GAAG,GAAG,EAAE;gBAC3B,IAAI,CAAC,mBAAmB,EAAE,CAAC;gBAC3B,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC;oBAAE,QAAQ,EAAE,CAAC;YAC/D,CAAC,CAAC;YACF,MAAM,KAAK,GAAG,GAAG,EAAE;gBACjB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;gBACzB,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC;gBAChC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;gBAC1B,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC7B,CAAC,CAAC;YACF,MAAM,KAAK,GAAmC;gBAC5C,CAAC,aAAa,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;gBAChC,CAAC,WAAW,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC,cAAc,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;gBAClC,CAAC,YAAY,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;gBACjC,CAAC,oBAAoB,EAAE,eAAe,CAAC;gBACvC,CAAC,KAAK,EAAE,KAAK,CAAC;aACf,CAAC;YACF,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK,EAAE,CAAC;gBACpC,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;gBACxC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;YAC7C,CAAC;YACD,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC7B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAEO,WAAW,CAAC,MAAqB;QACvC,IAAI,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,KAAK,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;YAC/C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QACvC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,mBAAmB;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC;QAClE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,CAAC;QAC1E,MAAM,IAAI,GAAsB;YAC9B,GAAG,eAAe;YAClB,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,IAAI;YACV,SAAS,EAAE,OAAO;YAClB,0EAA0E;YAC1E,sEAAsE;YACtE,8DAA8D;YAC9D,2EAA2E;YAC3E,wEAAwE;YACxE,mEAAmE;YACnE,0EAA0E;YAC1E,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK;SACpD,CAAC;QACF,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;gBAC1C,IAAI,MAAM,CAAC,cAAc;oBAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;gBAC5C,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI;oBAAE,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC;gBAC7D,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;oBAChB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;oBACvB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;oBAClB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;gBACpB,CAAC;gBACD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACnB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;oBACxB,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;wBAAE,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;gBAC7E,CAAC;YACH,CAAC;QACH,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QAC3E,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,OAAO,EAAE,CAAC;YACZ,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED,qBAAqB,CAAC,QAAwC;QAC5D,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACjC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,gBAAgB,CAAC,QAAoB;QACnC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrD,CAAC;IAED,MAAM;QACJ,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACnC,oEAAoE;QACpE,6BAA6B;QAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI;gBAAE,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACvD,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC;QAC9B,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC;QACzC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC;QAC3D,IAAI,CAAC,KAAK,IAAI,CAAC,cAAc;YAAE,OAAO,EAAE,CAAC;QAEzC,MAAM,SAAS,GAA0B,EAAE,CAAC;QAC5C,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACvC,MAAM,EAAE,GAAG,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,IAAI,KAAK,EAAE,EAAE,CAAC;YACpF,MAAM,QAAQ,GAAwB;gBACpC,EAAE;gBACF,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY;gBACzC,UAAU,EACR,MAAM,CAAC,UAAU,KAAK,MAAM,IAAI,MAAM,CAAC,UAAU,KAAK,OAAO;oBAC3D,CAAC,CAAC,MAAM,CAAC,UAAU;oBACnB,CAAC,CAAC,MAAM;gBACZ,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC;gBACvC,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC;aAC1C,CAAC;YAEF,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;YACrE,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC;gBACrC,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC;gBACxC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC/B,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAC7C,QAAQ,CAAC,GAAG,GAAG;oBACb,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;oBACvB,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;iBAC1C,CAAC;YACJ,CAAC;YACD,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;gBACrB,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;gBACjE,IAAI,QAAQ;oBAAE,QAAQ,CAAC,QAAQ,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;YAC5D,CAAC;YACD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAChB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;gBAClD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAClF,IAAI,SAAS,EAAE,CAAC;oBACd,MAAM,CAAC,GAAG,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC;oBACvC,QAAQ,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;gBACtC,CAAC;gBACD,oEAAoE;gBACpE,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;oBACvB,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBACvC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;oBAClF,IAAI,SAAS;wBAAE,QAAQ,CAAC,QAAQ,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;gBAC9D,CAAC;YACH,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvD,QAAQ,CAAC,gBAAgB,GAAG,IAAI,CAAC;YACnC,CAAC;YACD,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,mEAAmE;IAC3D,WAAW,CAAC,MAAqB,EAAE,KAAkB;QAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;QACjD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,GAAG,CAAC;YAAE,OAAO,MAAM,CAAC;QACtD,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IAEO,YAAY,CAAC,MAAqB,EAAE,KAAkB;QAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC;QACjD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,GAAG,CAAC;YAAE,OAAO,MAAM,CAAC;QACtD,OAAO,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,uDAAuD;IAC/C,SAAS;QACf,IAAI,IAAI,CAAC,aAAa,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC;QACzD,IAAI,IAAI,CAAC,aAAa,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC,UAAU,CAAC;QAC3D,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,aAAa;QACnB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;QACxC,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAExB,4EAA4E;QAC5E,yEAAyE;QACzE,+DAA+D;QAC/D,MAAM,MAAM,GACV,OAAO,QAAQ,KAAK,WAAW,IAAI,QAAQ,CAAC,kBAAkB,KAAK,OAAO,CAAC;QAC7E,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxD,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAEnE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC;QACjD,2EAA2E;QAC3E,uEAAuE;QACvE,qEAAqE;QACrE,WAAW;QACX,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC7E,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAE5D,OAAO;YACL;gBACE,EAAE,EAAE,OAAO;gBACX,IAAI,EAAE,WAAW;gBACjB,UAAU,EAAE,MAAM;gBAClB,GAAG,EAAE;oBACH,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;oBACtC,SAAS,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;iBACnD;gBACD,QAAQ,EAAE;oBACR,QAAQ,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;oBAChE,UAAU,EAAE;wBACV,IAAI,CAAC,cAAc,CAAC,CAAC;wBACrB,IAAI,CAAC,cAAc,CAAC,CAAC;wBACrB,IAAI,CAAC,cAAc,CAAC,CAAC;wBACrB,IAAI,CAAC,cAAc,CAAC,CAAC;qBACtB;iBACF;gBACD,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC9B,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;aAClC;SACF,CAAC;IACJ,CAAC;IAED,WAAW;QACT,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/C,OAAO;YACL,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YACxC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;SACrD,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAgB,EAAE,SAAiB,EAAE,UAAkB;QAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC;QAClC,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC3B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YAC1C,MAAM,EAAE,GAAG,GAAG,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,IAAI,KAAK,EAAE,EAAE,CAAC;YACpF,IAAI,EAAE,KAAK,QAAQ;gBAAE,SAAS;YAC9B,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC,CAAC,CAAC;YACtD,IAAI,CAAC,QAAQ;gBAAE,OAAO,KAAK,CAAC;YAC5B,KAAM,QAAmE,CAAC,KAAK,EAAE,CAC/E,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,EACnC,UAAU,CACX,CAAC;YACF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO;QACL,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;gBACnD,IAAI,CAAC,YAAY,CAAC,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED,SAAS,aAAa,CAAC,IAAY;IACjC,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;IAClC,MAAM,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;IACrC,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACzE,CAAC","sourcesContent":["/**\n * WebXRInputProvider - the standalone, framework-free input provider.\n *\n * Speaks the browser's OpenXR binding directly: `XRSession` input sources\n * (`targetRaySpace`, `gripSpace`, `hand` joints), `selectstart/selectend`\n * and `squeezestart/squeezeend`, gamepad analog values where present, and\n * haptic actuators. Falls back to a desktop mouse pointer (a ray from the\n * camera through the cursor) when no immersive session is live, so every\n * consumer runs in a flat browser too.\n *\n * Capabilities are derived from the LIVE session (never the requested\n * config) and re-published on session start/end and input-source changes.\n */\nimport { Raycaster, Vector2, Vector3, Quaternion, type Camera, type WebXRManager } from \"three\";\nimport {\n  NO_CAPABILITIES,\n  type HeadPose,\n  type InputCapabilities,\n  type InputProvider,\n  type InputSourceSnapshot,\n  type PoseTuple,\n  type Unsubscribe,\n} from \"@realitycollective/webxr-input\";\n\nexport interface WebXRProviderContext {\n  /** three.js `renderer.xr` (or anything with the same session surface). */\n  xr: Pick<WebXRManager, \"getSession\" | \"getReferenceSpace\" | \"getFrame\">;\n  /** The rendering camera - head pose in XR, pointer projection on desktop. */\n  camera: Camera;\n  /** DOM element for the desktop mouse fallback (canvas). Omit to disable. */\n  domElement?: HTMLElement;\n  /**\n   * Metres along the mouse ray at which the desktop fallback places its\n   * synthetic grip pose. Hand-driven behaviours (grab, hinge, dial, slide)\n   * track a grip position; a mouse has none, so one is projected onto the ray.\n   * Set this near the distance of the things being manipulated - too short and\n   * levers barely swing, too long and they over-swing. Default 1 metre.\n   */\n  desktopGripDistance?: number;\n  /**\n   * Which mouse button reports `squeeze` on desktop. Default `\"left\"`.\n   *\n   * The right button is NOT the default, because the shared desktop camera\n   * controls (`DesktopControls` in `@realitycollective/xrblocks-uiextensions`)\n   * bind right-drag to look and reserve the left button for interaction. That\n   * leaves the left button to carry both actions, which is fine as long as an\n   * interactable does not mix a select-driven behaviour (press) with a\n   * grab-driven one (grab, hinge, dial, slide) - such an interactable would\n   * receive both on a single click. Use `\"right\"` only in an app that does not\n   * use right-drag to look.\n   */\n  desktopSqueezeButton?: \"left\" | \"right\" | \"none\";\n}\n\ninterface SelectState {\n  selecting: boolean;\n  squeezing: boolean;\n}\n\n/** Where the desktop fallback puts its synthetic grip along the mouse ray. */\nconst DEFAULT_DESKTOP_GRIP_DISTANCE = 1;\n\n/** Centre of the viewport, used while the pointer is locked. */\nconst ZERO_NDC = new Vector2(0, 0);\n\nexport class WebXRInputProvider implements InputProvider {\n  private readonly context: WebXRProviderContext;\n  private capabilities: InputCapabilities;\n  private readonly capsListeners = new Set<(c: InputCapabilities) => void>();\n  private readonly sourceListeners = new Set<() => void>();\n  private readonly selectStates = new Map<XRInputSource, SelectState>();\n  private boundSession: XRSession | null = null;\n  private readonly sessionHandlers: Array<[string, EventListener]> = [];\n\n  // Desktop pointer state.\n  private mouseDown = false;\n  private mouseRight = false;\n  private readonly mouseNdc = new Vector2();\n  private readonly raycaster = new Raycaster();\n  private readonly detachDom: Unsubscribe;\n  private readonly gripDistance: number;\n  private readonly squeezeButton: \"left\" | \"right\" | \"none\";\n\n  // Temps.\n  private readonly v = new Vector3();\n  private readonly q = new Quaternion();\n  private readonly pointerNdc = new Vector2();\n  private readonly gripPoint = new Vector3();\n  private readonly gripQuaternion = new Quaternion();\n\n  constructor(context: WebXRProviderContext) {\n    this.context = context;\n    this.gripDistance = context.desktopGripDistance ?? DEFAULT_DESKTOP_GRIP_DISTANCE;\n    // Read before attachDom - it decides whether to claim the context menu.\n    this.squeezeButton = context.desktopSqueezeButton ?? \"left\";\n    this.capabilities = { ...NO_CAPABILITIES, headPose: true, gaze: true };\n    this.detachDom = this.attachDom(context.domElement);\n    this.refreshCapabilities();\n  }\n\n  private attachDom(element: HTMLElement | undefined): Unsubscribe {\n    if (!element) return () => undefined;\n    const onMove = (event: PointerEvent) => {\n      const rect = element.getBoundingClientRect();\n      this.mouseNdc.set(\n        ((event.clientX - rect.left) / rect.width) * 2 - 1,\n        -((event.clientY - rect.top) / rect.height) * 2 + 1,\n      );\n    };\n    const onDown = (event: PointerEvent) => {\n      if (event.button === 0) this.mouseDown = true;\n      if (event.button === 2) this.mouseRight = true;\n      onMove(event);\n    };\n    const onUp = (event: PointerEvent) => {\n      if (event.button === 0) this.mouseDown = false;\n      if (event.button === 2) this.mouseRight = false;\n    };\n    element.addEventListener(\"pointermove\", onMove);\n    element.addEventListener(\"pointerdown\", onDown);\n    // Only when the right button carries squeeze. Otherwise the menu belongs to\n    // whoever else is listening - the shared camera controls suppress it there.\n    // Without this, a right press opens the menu, the matching pointerup never\n    // arrives, and the squeeze latches on.\n    const onContextMenu =\n      this.squeezeButton === \"right\" ? (event: Event) => event.preventDefault() : undefined;\n    if (onContextMenu) element.addEventListener(\"contextmenu\", onContextMenu);\n    window.addEventListener(\"pointerup\", onUp);\n    return () => {\n      element.removeEventListener(\"pointermove\", onMove);\n      element.removeEventListener(\"pointerdown\", onDown);\n      if (onContextMenu) element.removeEventListener(\"contextmenu\", onContextMenu);\n      window.removeEventListener(\"pointerup\", onUp);\n    };\n  }\n\n  /** Bind/unbind session listeners as the session comes and goes. */\n  private syncSession(): XRSession | null {\n    const session = this.context.xr.getSession();\n    if (session === this.boundSession) return session;\n\n    if (this.boundSession) {\n      for (const [type, handler] of this.sessionHandlers) {\n        this.boundSession.removeEventListener(type, handler);\n      }\n      this.sessionHandlers.length = 0;\n      this.selectStates.clear();\n    }\n    this.boundSession = session;\n    if (session) {\n      const setSelect = (selecting: boolean) => (event: Event) => {\n        const source = (event as XRInputSourceEvent).inputSource;\n        const state = this.selectState(source);\n        state.selecting = selecting;\n      };\n      const setSqueeze = (squeezing: boolean) => (event: Event) => {\n        const source = (event as XRInputSourceEvent).inputSource;\n        const state = this.selectState(source);\n        state.squeezing = squeezing;\n      };\n      const onSourcesChange = () => {\n        this.refreshCapabilities();\n        for (const listener of [...this.sourceListeners]) listener();\n      };\n      const onEnd = () => {\n        this.boundSession = null;\n        this.sessionHandlers.length = 0;\n        this.selectStates.clear();\n        this.refreshCapabilities();\n      };\n      const pairs: Array<[string, EventListener]> = [\n        [\"selectstart\", setSelect(true)],\n        [\"selectend\", setSelect(false)],\n        [\"squeezestart\", setSqueeze(true)],\n        [\"squeezeend\", setSqueeze(false)],\n        [\"inputsourceschange\", onSourcesChange],\n        [\"end\", onEnd],\n      ];\n      for (const [type, handler] of pairs) {\n        session.addEventListener(type, handler);\n        this.sessionHandlers.push([type, handler]);\n      }\n      this.refreshCapabilities();\n    }\n    return session;\n  }\n\n  private selectState(source: XRInputSource): SelectState {\n    let state = this.selectStates.get(source);\n    if (!state) {\n      state = { selecting: false, squeezing: false };\n      this.selectStates.set(source, state);\n    }\n    return state;\n  }\n\n  private refreshCapabilities(): void {\n    const session = this.boundSession ?? this.context.xr.getSession();\n    const desktop = this.context.domElement !== undefined && session === null;\n    const next: InputCapabilities = {\n      ...NO_CAPABILITIES,\n      headPose: true,\n      gaze: true,\n      pointer2d: desktop,\n      // NOTE: `rays` stays false on desktop on purpose. sample() uses it as the\n      // \"a session just ended\" sentinel, so setting it here would re-derive\n      // capabilities on every frame for the whole life of the page.\n      // The desktop fallback synthesises a grip on the mouse ray, so hand-driven\n      // behaviours (grab, hinge, dial, slide) negotiate successfully. Without\n      // this `grabs` stays \"none\" off-headset and capability negotiation\n      // disables every one of them, leaving press as the only usable behaviour.\n      grabs: desktop ? \"poseOnly\" : NO_CAPABILITIES.grabs,\n    };\n    if (session) {\n      for (const source of session.inputSources) {\n        if (source.targetRaySpace) next.rays = true;\n        if (source.gripSpace || source.hand) next.grabs = \"poseOnly\";\n        if (source.hand) {\n          next.handJoints = true;\n          next.pokes = true;\n          next.pinch = true;\n        }\n        if (source.gamepad) {\n          next.buttonsAxes = true;\n          if ((source.gamepad.hapticActuators?.length ?? 0) > 0) next.haptics = true;\n        }\n      }\n    }\n    const changed = JSON.stringify(next) !== JSON.stringify(this.capabilities);\n    this.capabilities = next;\n    if (changed) {\n      for (const listener of [...this.capsListeners]) listener(next);\n    }\n  }\n\n  getCapabilities(): InputCapabilities {\n    return this.capabilities;\n  }\n\n  onCapabilitiesChanged(listener: (c: InputCapabilities) => void): Unsubscribe {\n    this.capsListeners.add(listener);\n    return () => this.capsListeners.delete(listener);\n  }\n\n  onSourcesChanged(listener: () => void): Unsubscribe {\n    this.sourceListeners.add(listener);\n    return () => this.sourceListeners.delete(listener);\n  }\n\n  sample(): readonly InputSourceSnapshot[] {\n    const session = this.syncSession();\n    // The session-null path also re-derives capabilities when a session\n    // just ended between frames.\n    if (!session) {\n      if (this.capabilities.rays) this.refreshCapabilities();\n      return this.sampleDesktop();\n    }\n\n    const frame = this.context.xr.getFrame();\n    const referenceSpace = this.context.xr.getReferenceSpace();\n    if (!frame || !referenceSpace) return [];\n\n    const snapshots: InputSourceSnapshot[] = [];\n    let index = 0;\n    for (const source of session.inputSources) {\n      const state = this.selectState(source);\n      const id = `${source.handedness}-${source.hand ? \"hand\" : \"controller\"}-${index++}`;\n      const snapshot: InputSourceSnapshot = {\n        id,\n        kind: source.hand ? \"hand\" : \"controller\",\n        handedness:\n          source.handedness === \"left\" || source.handedness === \"right\"\n            ? source.handedness\n            : \"none\",\n        select: this.selectValue(source, state),\n        squeeze: this.squeezeValue(source, state),\n      };\n\n      const rayPose = frame.getPose(source.targetRaySpace, referenceSpace);\n      if (rayPose) {\n        const p = rayPose.transform.position;\n        const o = rayPose.transform.orientation;\n        this.q.set(o.x, o.y, o.z, o.w);\n        this.v.set(0, 0, -1).applyQuaternion(this.q);\n        snapshot.ray = {\n          origin: [p.x, p.y, p.z],\n          direction: [this.v.x, this.v.y, this.v.z],\n        };\n      }\n      if (source.gripSpace) {\n        const gripPose = frame.getPose(source.gripSpace, referenceSpace);\n        if (gripPose) snapshot.gripPose = xrPoseToTuple(gripPose);\n      }\n      if (source.hand) {\n        const joint = source.hand.get(\"index-finger-tip\");\n        const jointPose = joint ? frame.getJointPose?.(joint, referenceSpace) : undefined;\n        if (jointPose) {\n          const p = jointPose.transform.position;\n          snapshot.indexTip = [p.x, p.y, p.z];\n        }\n        // Hands without a gripSpace still need a carry pose: use the wrist.\n        if (!snapshot.gripPose) {\n          const wrist = source.hand.get(\"wrist\");\n          const wristPose = wrist ? frame.getJointPose?.(wrist, referenceSpace) : undefined;\n          if (wristPose) snapshot.gripPose = xrPoseToTuple(wristPose);\n        }\n      }\n      if ((source.gamepad?.hapticActuators?.length ?? 0) > 0) {\n        snapshot.hapticsAvailable = true;\n      }\n      snapshots.push(snapshot);\n    }\n    return snapshots;\n  }\n\n  /** Analog trigger where available, else the select event state. */\n  private selectValue(source: XRInputSource, state: SelectState): number {\n    const analog = source.gamepad?.buttons[0]?.value;\n    if (analog !== undefined && analog > 0) return analog;\n    return state.selecting ? 1 : 0;\n  }\n\n  private squeezeValue(source: XRInputSource, state: SelectState): number {\n    const analog = source.gamepad?.buttons[1]?.value;\n    if (analog !== undefined && analog > 0) return analog;\n    return state.squeezing ? 1 : 0;\n  }\n\n  /** Is the configured squeeze button currently held? */\n  private squeezing(): boolean {\n    if (this.squeezeButton === \"left\") return this.mouseDown;\n    if (this.squeezeButton === \"right\") return this.mouseRight;\n    return false;\n  }\n\n  private sampleDesktop(): readonly InputSourceSnapshot[] {\n    const element = this.context.domElement;\n    if (!element) return [];\n\n    // Under pointer lock the cursor stops moving and clientX/clientY freeze, so\n    // the tracked NDC would stick wherever the pointer was when it locked. A\n    // locked pointer aims from the centre of the viewport instead.\n    const locked =\n      typeof document !== \"undefined\" && document.pointerLockElement === element;\n    this.pointerNdc.copy(locked ? ZERO_NDC : this.mouseNdc);\n    this.raycaster.setFromCamera(this.pointerNdc, this.context.camera);\n\n    const { origin, direction } = this.raycaster.ray;\n    // A mouse has no grip. Hand-driven behaviours read `gripPose.position` (or\n    // fall back to `ray.origin`, which is the camera and barely moves), so\n    // project a grip onto the ray to give them something that tracks the\n    // pointer.\n    this.gripPoint.copy(direction).multiplyScalar(this.gripDistance).add(origin);\n    this.context.camera.getWorldQuaternion(this.gripQuaternion);\n\n    return [\n      {\n        id: \"mouse\",\n        kind: \"pointer2d\",\n        handedness: \"none\",\n        ray: {\n          origin: [origin.x, origin.y, origin.z],\n          direction: [direction.x, direction.y, direction.z],\n        },\n        gripPose: {\n          position: [this.gripPoint.x, this.gripPoint.y, this.gripPoint.z],\n          quaternion: [\n            this.gripQuaternion.x,\n            this.gripQuaternion.y,\n            this.gripQuaternion.z,\n            this.gripQuaternion.w,\n          ],\n        },\n        select: this.mouseDown ? 1 : 0,\n        squeeze: this.squeezing() ? 1 : 0,\n      },\n    ];\n  }\n\n  getHeadPose(): HeadPose {\n    this.context.camera.getWorldPosition(this.v);\n    this.context.camera.getWorldQuaternion(this.q);\n    return {\n      position: [this.v.x, this.v.y, this.v.z],\n      quaternion: [this.q.x, this.q.y, this.q.z, this.q.w],\n    };\n  }\n\n  pulse(sourceId: string, intensity: number, durationMs: number): boolean {\n    const session = this.boundSession;\n    if (!session) return false;\n    let index = 0;\n    for (const source of session.inputSources) {\n      const id = `${source.handedness}-${source.hand ? \"hand\" : \"controller\"}-${index++}`;\n      if (id !== sourceId) continue;\n      const actuator = source.gamepad?.hapticActuators?.[0];\n      if (!actuator) return false;\n      void (actuator as { pulse?: (i: number, d: number) => Promise<boolean> }).pulse?.(\n        Math.min(1, Math.max(0, intensity)),\n        durationMs,\n      );\n      return true;\n    }\n    return false;\n  }\n\n  dispose(): void {\n    this.detachDom();\n    if (this.boundSession) {\n      for (const [type, handler] of this.sessionHandlers) {\n        this.boundSession.removeEventListener(type, handler);\n      }\n    }\n  }\n}\n\nfunction xrPoseToTuple(pose: XRPose): PoseTuple {\n  const p = pose.transform.position;\n  const o = pose.transform.orientation;\n  return { position: [p.x, p.y, p.z], quaternion: [o.x, o.y, o.z, o.w] };\n}\n"]}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@realitycollective/threejs-interactions",
+  "version": "0.1.0-preview.0",
+  "description": "The default, standalone engine adapter for the Reality Collective Interaction Extensions: raw WebXR (the browser's OpenXR binding - XRSession, XRInputSource, select/squeeze, hand joints) plus three.js hit-testing and transform ports, with a desktop mouse fallback. No framework required. Re-exports the @realitycollective/webxr-interactions core.",
+  "keywords": [
+    "realitycollective",
+    "webxr",
+    "threejs",
+    "xr",
+    "interaction",
+    "input",
+    "openxr",
+    "typescript"
+  ],
+  "license": "MIT",
+  "author": "Reality Collective",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  },
+  "dependencies": {
+    "@realitycollective/webxr-input": "^0.1.0",
+    "@realitycollective/webxr-interactions": "^0.1.0-preview.0"
+  },
+  "peerDependencies": {
+    "three": ">=0.170.0"
+  },
+  "devDependencies": {
+    "three": "npm:super-three@0.181.0",
+    "@types/three": "*"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/realitycollective/WebXR-Interactions.git",
+    "directory": "packages/threejs-interactions"
+  },
+  "homepage": "https://github.com/realitycollective/WebXR-Interactions#readme",
+  "bugs": {
+    "url": "https://github.com/realitycollective/WebXR-Interactions/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.19.0 <21.0.0-0 || >=22.12.0 <23.0.0-0 || >=24.0.0"
+  }
+}