@realitycollective/iwsdk-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,48 @@
+# @realitycollective/iwsdk-interactions
+
+The Meta IWSDK adapter for the Reality Collective Interaction Extensions. It connects the [`@realitycollective/webxr-interactions`](https://www.npmjs.com/package/@realitycollective/webxr-interactions) core to Meta's [Immersive Web SDK](https://iwsdk.dev).
+
+```sh
+npm install @realitycollective/iwsdk-interactions @iwsdk/core
+```
+
+It re-exports everything from the core, so this is the only interaction package your app needs.
+
+## What it binds
+
+| Layer | Detail |
+| --- | --- |
+| **Input** | IWSDK's player rig, controller state and hand joints |
+| **Targeting** | IWSDK already knows what is being pressed or grabbed, through its `Pressed` and `Grabbed` tags. The adapter passes that answer straight through instead of working it out again with rays |
+| **Grab** | Where the app has IWSDK grabbing or physics turned on, IWSDK performs the grab itself |
+| **Setup** | One call: `registerInteractions(world)` |
+
+## Usage
+
+```ts
+import { registerInteractions } from "@realitycollective/iwsdk-interactions";
+
+const interactions = registerInteractions(world);
+
+interactions.register({ id: "handle", behaviours: [{ kind: "grab" }] }, entity);
+
+interactions.runtime.onEvent((event) => console.log(event.type));
+```
+
+`registerInteractions` is idempotent per world and registers the bridge system for you; the render loop is driven by IWSDK, so there is no `update` call to make.
+
+## Peer dependency
+
+`@iwsdk/core >=0.4.0 <0.6.0`.
+
+## 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).
+
+## License
+
+MIT - see [LICENSE](./LICENSE).

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @realitycollective/iwsdk-interactions - the Meta IWSDK adapter.
+ * Re-exports the engine-free core wholesale; apps depend on exactly this
+ * package.
+ */
+export * from "@realitycollective/webxr-interactions";
+export * from "./provider.js";
+export * from "./transform-port.js";
+export * from "./register.js";

package/dist/index.js

@@ -0,0 +1,10 @@
+/**
+ * @realitycollective/iwsdk-interactions - the Meta IWSDK adapter.
+ * Re-exports the engine-free core wholesale; apps depend on exactly this
+ * package.
+ */
+export * from "@realitycollective/webxr-interactions";
+export * from "./provider.js";
+export * from "./transform-port.js";
+export * from "./register.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,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC","sourcesContent":["/**\n * @realitycollective/iwsdk-interactions - the Meta IWSDK adapter.\n * Re-exports the engine-free core wholesale; apps depend on exactly this\n * package.\n */\nexport * from \"@realitycollective/webxr-interactions\";\n\nexport * from \"./provider.js\";\nexport * from \"./transform-port.js\";\nexport * from \"./register.js\";\n"]}

package/dist/provider.d.ts

@@ -0,0 +1,54 @@
+/**
+ * IWSDKInputProvider - feeds Meta IWSDK's input machinery into the shared
+ * input contracts, in place of the standalone WebXR provider.
+ *
+ * Poses come from the IWSDK player rig (`world.playerSpaceEntities`:
+ * ray/grip/index-tip spaces, head), signals from the stateful XR gamepads
+ * (`world.input.xr.gamepads` - analog trigger/squeeze with `getSelecting`
+ * fallback, which also covers hand pinch). Capabilities derive from the
+ * LIVE session and re-publish on visibility/input-source changes.
+ *
+ * Provider power: IWSDK resolves its own targeting (BVH raycasts →
+ * `Pressed`/`Grabbed` tags). The bridge system turns those tags into
+ * pre-resolved hints (`setHints`) and flags native grabbing, which the
+ * core consumes IN PLACE of its own hit-testing.
+ */
+import { type World } from "@iwsdk/core";
+import { type HeadPose, type InputCapabilities, type InputHitHint, type InputProvider, type InputSourceSnapshot, type Unsubscribe } from "@realitycollective/webxr-input";
+export interface IWSDKProviderOptions {
+    /**
+     * The app enabled IWSDK's `features.grabbing` (+ physics where needed),
+     * so grab behaviours are fulfilled NATIVELY by the engine.
+     */
+    nativeGrab?: boolean;
+}
+type Side = "left" | "right";
+export declare class IWSDKInputProvider implements InputProvider {
+    private readonly world;
+    private readonly nativeGrab;
+    private capabilities;
+    private readonly capsListeners;
+    private readonly sourceListeners;
+    private hints;
+    private readonly nativeGrabbing;
+    private readonly disposers;
+    private boundSession;
+    private readonly onSourcesChange;
+    constructor(world: World, options?: IWSDKProviderOptions);
+    private bindSession;
+    private hasTrackedHand;
+    private refreshCapabilities;
+    getCapabilities(): InputCapabilities;
+    onCapabilitiesChanged(listener: (c: InputCapabilities) => void): Unsubscribe;
+    onSourcesChanged(listener: () => void): Unsubscribe;
+    /** Bridge-system input: this frame's pre-resolved tag hints. */
+    setHints(hints: InputHitHint[]): void;
+    sampleHints(): readonly InputHitHint[];
+    /** Bridge-system input: a side is currently native-grabbing. */
+    setNativeGrabbing(side: Side, grabbing: boolean): void;
+    sample(): readonly InputSourceSnapshot[];
+    getHeadPose(): HeadPose;
+    pulse(sourceId: string, intensity: number, durationMs: number): boolean;
+    dispose(): void;
+}
+export {};

package/dist/provider.js

@@ -0,0 +1,204 @@
+/**
+ * IWSDKInputProvider - feeds Meta IWSDK's input machinery into the shared
+ * input contracts, in place of the standalone WebXR provider.
+ *
+ * Poses come from the IWSDK player rig (`world.playerSpaceEntities`:
+ * ray/grip/index-tip spaces, head), signals from the stateful XR gamepads
+ * (`world.input.xr.gamepads` - analog trigger/squeeze with `getSelecting`
+ * fallback, which also covers hand pinch). Capabilities derive from the
+ * LIVE session and re-publish on visibility/input-source changes.
+ *
+ * Provider power: IWSDK resolves its own targeting (BVH raycasts →
+ * `Pressed`/`Grabbed` tags). The bridge system turns those tags into
+ * pre-resolved hints (`setHints`) and flags native grabbing, which the
+ * core consumes IN PLACE of its own hit-testing.
+ */
+import { InputComponent, VisibilityState } from "@iwsdk/core";
+import { NO_CAPABILITIES, } from "@realitycollective/webxr-input";
+const SIDES = ["left", "right"];
+export class IWSDKInputProvider {
+    world;
+    nativeGrab;
+    capabilities;
+    capsListeners = new Set();
+    sourceListeners = new Set();
+    hints = [];
+    nativeGrabbing = { left: false, right: false };
+    disposers = [];
+    boundSession = null;
+    onSourcesChange = () => {
+        this.refreshCapabilities();
+        for (const listener of [...this.sourceListeners])
+            listener();
+    };
+    constructor(world, options = {}) {
+        this.world = world;
+        this.nativeGrab = options.nativeGrab ?? false;
+        this.capabilities = { ...NO_CAPABILITIES };
+        const unsubscribe = world.visibilityState.subscribe(() => {
+            this.bindSession();
+            this.refreshCapabilities();
+        });
+        this.disposers.push(unsubscribe);
+        this.bindSession();
+        this.refreshCapabilities();
+    }
+    bindSession() {
+        const session = this.world.session ?? null;
+        if (session === this.boundSession)
+            return;
+        this.boundSession?.removeEventListener("inputsourceschange", this.onSourcesChange);
+        this.boundSession = session;
+        session?.addEventListener("inputsourceschange", this.onSourcesChange);
+    }
+    hasTrackedHand() {
+        const session = this.world.session;
+        if (!session)
+            return false;
+        for (const source of session.inputSources) {
+            if (source.hand)
+                return true;
+        }
+        return false;
+    }
+    refreshCapabilities() {
+        const session = this.world.session;
+        const immersive = !!session;
+        const handTracking = immersive &&
+            ((session?.enabledFeatures?.includes("hand-tracking") ?? false) || this.hasTrackedHand());
+        let buttonsAxes = false;
+        let haptics = false;
+        for (const side of SIDES) {
+            const gamepad = this.world.input.xr.gamepads[side];
+            if (gamepad?.gamepad)
+                buttonsAxes = true;
+            if ((gamepad?.gamepad?.hapticActuators?.length ?? 0) > 0)
+                haptics = true;
+        }
+        const next = {
+            ...NO_CAPABILITIES,
+            rays: immersive,
+            // Index-tip spaces exist for controllers too (fall back to ray pose).
+            pokes: immersive,
+            grabs: immersive ? (this.nativeGrab ? "native" : "poseOnly") : "none",
+            handJoints: handTracking,
+            pinch: handTracking,
+            buttonsAxes,
+            gaze: true,
+            headPose: true,
+            haptics,
+        };
+        if (JSON.stringify(next) !== JSON.stringify(this.capabilities)) {
+            this.capabilities = next;
+            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);
+    }
+    /** Bridge-system input: this frame's pre-resolved tag hints. */
+    setHints(hints) {
+        this.hints = hints;
+    }
+    sampleHints() {
+        return this.hints;
+    }
+    /** Bridge-system input: a side is currently native-grabbing. */
+    setNativeGrabbing(side, grabbing) {
+        this.nativeGrabbing[side] = grabbing;
+    }
+    sample() {
+        if (!this.world.session)
+            return [];
+        if (this.world.visibilityState.peek() !== VisibilityState.Visible)
+            return [];
+        const spaces = this.world.playerSpaceEntities;
+        const snapshots = [];
+        for (const side of SIDES) {
+            const rayObject = spaces.raySpaces[side].object3D;
+            if (!rayObject)
+                continue;
+            const gamepad = this.world.input.xr.gamepads[side];
+            const hand = this.capabilities.handJoints;
+            rayObject.updateWorldMatrix(true, false);
+            const rayPos = rayObject.getWorldPosition(TEMP.v1);
+            const rayQuat = rayObject.getWorldQuaternion(TEMP.q1);
+            const forward = TEMP.v2.set(0, 0, -1).applyQuaternion(rayQuat);
+            const select = gamepad
+                ? Math.max(gamepad.getButtonValue(InputComponent.Trigger), gamepad.getSelecting() ? 1 : 0)
+                : 0;
+            const squeeze = gamepad ? gamepad.getButtonValue(InputComponent.Squeeze) : 0;
+            const snapshot = {
+                id: `${side}-input`,
+                kind: hand ? "hand" : "controller",
+                handedness: side,
+                ray: {
+                    origin: [rayPos.x, rayPos.y, rayPos.z],
+                    direction: [forward.x, forward.y, forward.z],
+                },
+                select,
+                squeeze,
+            };
+            const gripObject = spaces.gripSpaces[side].object3D;
+            if (gripObject) {
+                const gripPos = gripObject.getWorldPosition(TEMP.v1);
+                const gripQuat = gripObject.getWorldQuaternion(TEMP.q1);
+                snapshot.gripPose = {
+                    position: [gripPos.x, gripPos.y, gripPos.z],
+                    quaternion: [gripQuat.x, gripQuat.y, gripQuat.z, gripQuat.w],
+                };
+            }
+            const tipObject = spaces.indexTipSpaces[side].object3D;
+            if (tipObject) {
+                const tipPos = tipObject.getWorldPosition(TEMP.v1);
+                snapshot.indexTip = [tipPos.x, tipPos.y, tipPos.z];
+            }
+            if (this.nativeGrabbing[side])
+                snapshot.nativeGrabbing = true;
+            if ((gamepad?.gamepad?.hapticActuators?.length ?? 0) > 0) {
+                snapshot.hapticsAvailable = true;
+            }
+            snapshots.push(snapshot);
+        }
+        return snapshots;
+    }
+    getHeadPose() {
+        const head = this.world.playerSpaceEntities.head.object3D;
+        if (!head)
+            return { position: [0, 0, 0], quaternion: [0, 0, 0, 1] };
+        const position = head.getWorldPosition(TEMP.v1);
+        const quaternion = head.getWorldQuaternion(TEMP.q1);
+        return {
+            position: [position.x, position.y, position.z],
+            quaternion: [quaternion.x, quaternion.y, quaternion.z, quaternion.w],
+        };
+    }
+    pulse(sourceId, intensity, durationMs) {
+        const side = sourceId.startsWith("left") ? "left" : sourceId.startsWith("right") ? "right" : null;
+        if (!side)
+            return false;
+        const actuator = this.world.input.xr.gamepads[side]?.gamepad?.hapticActuators?.[0];
+        if (!actuator)
+            return false;
+        void actuator.pulse?.(Math.min(1, Math.max(0, intensity)), durationMs);
+        return true;
+    }
+    dispose() {
+        this.boundSession?.removeEventListener("inputsourceschange", this.onSourcesChange);
+        for (const dispose of this.disposers)
+            dispose();
+    }
+}
+// Shared scratch objects (single-threaded frame sampling).
+import { Quaternion, Vector3 } from "@iwsdk/core";
+const TEMP = { v1: new Vector3(), v2: new Vector3(), q1: new Quaternion() };
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * IWSDKInputProvider - feeds Meta IWSDK's input machinery into the shared\n * input contracts, in place of the standalone WebXR provider.\n *\n * Poses come from the IWSDK player rig (`world.playerSpaceEntities`:\n * ray/grip/index-tip spaces, head), signals from the stateful XR gamepads\n * (`world.input.xr.gamepads` - analog trigger/squeeze with `getSelecting`\n * fallback, which also covers hand pinch). Capabilities derive from the\n * LIVE session and re-publish on visibility/input-source changes.\n *\n * Provider power: IWSDK resolves its own targeting (BVH raycasts →\n * `Pressed`/`Grabbed` tags). The bridge system turns those tags into\n * pre-resolved hints (`setHints`) and flags native grabbing, which the\n * core consumes IN PLACE of its own hit-testing.\n */\nimport { InputComponent, VisibilityState, type World } from \"@iwsdk/core\";\nimport {\n  NO_CAPABILITIES,\n  type HeadPose,\n  type InputCapabilities,\n  type InputHitHint,\n  type InputProvider,\n  type InputSourceSnapshot,\n  type Unsubscribe,\n} from \"@realitycollective/webxr-input\";\n\nexport interface IWSDKProviderOptions {\n  /**\n   * The app enabled IWSDK's `features.grabbing` (+ physics where needed),\n   * so grab behaviours are fulfilled NATIVELY by the engine.\n   */\n  nativeGrab?: boolean;\n}\n\ntype Side = \"left\" | \"right\";\nconst SIDES: readonly Side[] = [\"left\", \"right\"];\n\nexport class IWSDKInputProvider implements InputProvider {\n  private readonly world: World;\n  private readonly nativeGrab: boolean;\n  private capabilities: InputCapabilities;\n  private readonly capsListeners = new Set<(c: InputCapabilities) => void>();\n  private readonly sourceListeners = new Set<() => void>();\n  private hints: InputHitHint[] = [];\n  private readonly nativeGrabbing: Record<Side, boolean> = { left: false, right: false };\n  private readonly disposers: Unsubscribe[] = [];\n  private boundSession: XRSession | null = null;\n  private readonly onSourcesChange = () => {\n    this.refreshCapabilities();\n    for (const listener of [...this.sourceListeners]) listener();\n  };\n\n  constructor(world: World, options: IWSDKProviderOptions = {}) {\n    this.world = world;\n    this.nativeGrab = options.nativeGrab ?? false;\n    this.capabilities = { ...NO_CAPABILITIES };\n    const unsubscribe = world.visibilityState.subscribe(() => {\n      this.bindSession();\n      this.refreshCapabilities();\n    });\n    this.disposers.push(unsubscribe);\n    this.bindSession();\n    this.refreshCapabilities();\n  }\n\n  private bindSession(): void {\n    const session = this.world.session ?? null;\n    if (session === this.boundSession) return;\n    this.boundSession?.removeEventListener(\"inputsourceschange\", this.onSourcesChange);\n    this.boundSession = session;\n    session?.addEventListener(\"inputsourceschange\", this.onSourcesChange);\n  }\n\n  private hasTrackedHand(): boolean {\n    const session = this.world.session;\n    if (!session) return false;\n    for (const source of session.inputSources) {\n      if (source.hand) return true;\n    }\n    return false;\n  }\n\n  private refreshCapabilities(): void {\n    const session = this.world.session;\n    const immersive = !!session;\n    const handTracking =\n      immersive &&\n      ((session?.enabledFeatures?.includes(\"hand-tracking\") ?? false) || this.hasTrackedHand());\n    let buttonsAxes = false;\n    let haptics = false;\n    for (const side of SIDES) {\n      const gamepad = this.world.input.xr.gamepads[side];\n      if (gamepad?.gamepad) buttonsAxes = true;\n      if ((gamepad?.gamepad?.hapticActuators?.length ?? 0) > 0) haptics = true;\n    }\n    const next: InputCapabilities = {\n      ...NO_CAPABILITIES,\n      rays: immersive,\n      // Index-tip spaces exist for controllers too (fall back to ray pose).\n      pokes: immersive,\n      grabs: immersive ? (this.nativeGrab ? \"native\" : \"poseOnly\") : \"none\",\n      handJoints: handTracking,\n      pinch: handTracking,\n      buttonsAxes,\n      gaze: true,\n      headPose: true,\n      haptics,\n    };\n    if (JSON.stringify(next) !== JSON.stringify(this.capabilities)) {\n      this.capabilities = next;\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  /** Bridge-system input: this frame's pre-resolved tag hints. */\n  setHints(hints: InputHitHint[]): void {\n    this.hints = hints;\n  }\n\n  sampleHints(): readonly InputHitHint[] {\n    return this.hints;\n  }\n\n  /** Bridge-system input: a side is currently native-grabbing. */\n  setNativeGrabbing(side: Side, grabbing: boolean): void {\n    this.nativeGrabbing[side] = grabbing;\n  }\n\n  sample(): readonly InputSourceSnapshot[] {\n    if (!this.world.session) return [];\n    if (this.world.visibilityState.peek() !== VisibilityState.Visible) return [];\n\n    const spaces = this.world.playerSpaceEntities;\n    const snapshots: InputSourceSnapshot[] = [];\n    for (const side of SIDES) {\n      const rayObject = spaces.raySpaces[side].object3D;\n      if (!rayObject) continue;\n      const gamepad = this.world.input.xr.gamepads[side];\n      const hand = this.capabilities.handJoints;\n\n      rayObject.updateWorldMatrix(true, false);\n      const rayPos = rayObject.getWorldPosition(TEMP.v1);\n      const rayQuat = rayObject.getWorldQuaternion(TEMP.q1);\n      const forward = TEMP.v2.set(0, 0, -1).applyQuaternion(rayQuat);\n\n      const select = gamepad\n        ? Math.max(gamepad.getButtonValue(InputComponent.Trigger), gamepad.getSelecting() ? 1 : 0)\n        : 0;\n      const squeeze = gamepad ? gamepad.getButtonValue(InputComponent.Squeeze) : 0;\n\n      const snapshot: InputSourceSnapshot = {\n        id: `${side}-input`,\n        kind: hand ? \"hand\" : \"controller\",\n        handedness: side,\n        ray: {\n          origin: [rayPos.x, rayPos.y, rayPos.z],\n          direction: [forward.x, forward.y, forward.z],\n        },\n        select,\n        squeeze,\n      };\n\n      const gripObject = spaces.gripSpaces[side].object3D;\n      if (gripObject) {\n        const gripPos = gripObject.getWorldPosition(TEMP.v1);\n        const gripQuat = gripObject.getWorldQuaternion(TEMP.q1);\n        snapshot.gripPose = {\n          position: [gripPos.x, gripPos.y, gripPos.z],\n          quaternion: [gripQuat.x, gripQuat.y, gripQuat.z, gripQuat.w],\n        };\n      }\n      const tipObject = spaces.indexTipSpaces[side].object3D;\n      if (tipObject) {\n        const tipPos = tipObject.getWorldPosition(TEMP.v1);\n        snapshot.indexTip = [tipPos.x, tipPos.y, tipPos.z];\n      }\n      if (this.nativeGrabbing[side]) snapshot.nativeGrabbing = true;\n      if ((gamepad?.gamepad?.hapticActuators?.length ?? 0) > 0) {\n        snapshot.hapticsAvailable = true;\n      }\n      snapshots.push(snapshot);\n    }\n    return snapshots;\n  }\n\n  getHeadPose(): HeadPose {\n    const head = this.world.playerSpaceEntities.head.object3D;\n    if (!head) return { position: [0, 0, 0], quaternion: [0, 0, 0, 1] };\n    const position = head.getWorldPosition(TEMP.v1);\n    const quaternion = head.getWorldQuaternion(TEMP.q1);\n    return {\n      position: [position.x, position.y, position.z],\n      quaternion: [quaternion.x, quaternion.y, quaternion.z, quaternion.w],\n    };\n  }\n\n  pulse(sourceId: string, intensity: number, durationMs: number): boolean {\n    const side = sourceId.startsWith(\"left\") ? \"left\" : sourceId.startsWith(\"right\") ? \"right\" : null;\n    if (!side) return false;\n    const actuator = this.world.input.xr.gamepads[side]?.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\n  dispose(): void {\n    this.boundSession?.removeEventListener(\"inputsourceschange\", this.onSourcesChange);\n    for (const dispose of this.disposers) dispose();\n  }\n}\n\n// Shared scratch objects (single-threaded frame sampling).\nimport { Quaternion, Vector3 } from \"@iwsdk/core\";\nconst TEMP = { v1: new Vector3(), v2: new Vector3(), q1: new Quaternion() };\n"]}

package/dist/register.d.ts

@@ -0,0 +1,71 @@
+/**
+ * One-call setup: bind the interaction runtime onto an IWSDK world.
+ *
+ * ```ts
+ * const interactions = registerInteractions(world, { nativeGrab: false });
+ * interactions.register(
+ *   { id: "beacon", behaviours: [{ kind: "press" }, { kind: "pulse" }] },
+ *   beaconEntity,
+ * );
+ * ```
+ *
+ * The bridge system runs once per frame: it turns IWSDK's own targeting
+ * (`Pressed`/`Grabbed` tags on registered entities) into provider hints -
+ * provider power wins over the core's approximate hit-testing - then
+ * ticks the runtime. A light proximity/ray hit-tester still serves gaze
+ * (dwell) and anything IWSDK's pipeline does not cover.
+ */
+import { type Entity, type World } from "@iwsdk/core";
+import { InteractionRuntime, type DwellConfig, type InteractableDescriptor } from "@realitycollective/webxr-interactions";
+import { IWSDKInputProvider, type IWSDKProviderOptions } from "./provider.js";
+import { IWSDKTransformPort } from "./transform-port.js";
+export interface IWSDKRegisterOptions extends IWSDKProviderOptions {
+    dwellDefaults?: DwellConfig;
+}
+export interface IWSDKRegisterEntityOptions {
+    /** Add `PokeInteractable`/`RayInteractable` for pressable targets (default true). */
+    addInteractables?: boolean;
+    /** Targeting radius for the approximate gaze/poke hit-tester (default 0.1 m). */
+    targetRadius?: number;
+}
+export declare class IWSDKInteractions {
+    readonly runtime: InteractionRuntime;
+    readonly provider: IWSDKInputProvider;
+    private readonly hitTester;
+    private readonly world;
+    private readonly entities;
+    private readonly ports;
+    constructor(world: World, options?: IWSDKRegisterOptions);
+    register(descriptor: InteractableDescriptor, entity: Entity, options?: IWSDKRegisterEntityOptions): IWSDKTransformPort | undefined;
+    unregister(id: string): void;
+    getPort(id: string): IWSDKTransformPort | undefined;
+    getEntity(id: string): Entity | undefined;
+    /** Called by the bridge system once per frame. */
+    tick(delta: number, pressedEntities: Iterable<Entity>, grabbedEntities: Iterable<Entity>): void;
+    /** Attribute an engine tag to the nearest input side. */
+    private attributeSide;
+    dispose(): void;
+}
+export declare function interactionsFor(world: World): IWSDKInteractions | undefined;
+declare const InteractionBridgeSystem_base: import("elics").SystemConstructor<import("elics").SystemSchema, {
+    pressed: {
+        required: import("elics").Component<{}>[];
+    };
+    grabbed: {
+        required: import("elics").Component<{}>[];
+    };
+}, World, import("@iwsdk/core").System<import("elics").SystemSchema, {
+    pressed: {
+        required: import("elics").Component<{}>[];
+    };
+    grabbed: {
+        required: import("elics").Component<{}>[];
+    };
+}>>;
+/** The per-frame bridge: IWSDK tags → provider hints → runtime tick. */
+export declare class InteractionBridgeSystem extends InteractionBridgeSystem_base {
+    update(delta: number): void;
+}
+/** Register the Interaction Extensions on an IWSDK world (one call). */
+export declare function registerInteractions(world: World, options?: IWSDKRegisterOptions): IWSDKInteractions;
+export {};

package/dist/register.js

@@ -0,0 +1,193 @@
+/**
+ * One-call setup: bind the interaction runtime onto an IWSDK world.
+ *
+ * ```ts
+ * const interactions = registerInteractions(world, { nativeGrab: false });
+ * interactions.register(
+ *   { id: "beacon", behaviours: [{ kind: "press" }, { kind: "pulse" }] },
+ *   beaconEntity,
+ * );
+ * ```
+ *
+ * The bridge system runs once per frame: it turns IWSDK's own targeting
+ * (`Pressed`/`Grabbed` tags on registered entities) into provider hints -
+ * provider power wins over the core's approximate hit-testing - then
+ * ticks the runtime. A light proximity/ray hit-tester still serves gaze
+ * (dwell) and anything IWSDK's pipeline does not cover.
+ */
+import { createSystem, Grabbed, PokeInteractable, Pressed, RayInteractable, Vector3, } from "@iwsdk/core";
+import { InteractionRuntime, rayPointDistance, } from "@realitycollective/webxr-interactions";
+import { IWSDKInputProvider } from "./provider.js";
+import { IWSDKTransformPort } from "./transform-port.js";
+const TEMP_V = new Vector3();
+/** Approximate hit-tester over registered entities (gaze/dwell targeting). */
+class EntityHitTester {
+    entries = new Map();
+    register(id, entity, radius) {
+        this.entries.set(id, { entity, radius });
+    }
+    unregister(id) {
+        this.entries.delete(id);
+    }
+    hitRay(ray) {
+        let best = null;
+        for (const [id, { entity, radius }] of this.entries) {
+            const object = entity.object3D;
+            if (!object || !object.visible)
+                continue;
+            object.getWorldPosition(TEMP_V);
+            const point = [TEMP_V.x, TEMP_V.y, TEMP_V.z];
+            const { distance, t } = rayPointDistance(ray, point);
+            if (t > 0 && distance <= radius && (best === null || t < best.distance)) {
+                best = { interactableId: id, distance: t, point };
+            }
+        }
+        return best;
+    }
+    hitProximity(point, radius) {
+        let best = null;
+        for (const [id, { entity, radius: targetRadius }] of this.entries) {
+            const object = entity.object3D;
+            if (!object || !object.visible)
+                continue;
+            object.getWorldPosition(TEMP_V);
+            const distance = Math.hypot(TEMP_V.x - point[0], TEMP_V.y - point[1], TEMP_V.z - point[2]) - targetRadius;
+            if (distance <= radius && (best === null || distance < best.distance)) {
+                best = {
+                    interactableId: id,
+                    distance: Math.max(0, distance),
+                    point: [TEMP_V.x, TEMP_V.y, TEMP_V.z],
+                };
+            }
+        }
+        return best;
+    }
+}
+export class IWSDKInteractions {
+    runtime;
+    provider;
+    hitTester = new EntityHitTester();
+    world;
+    entities = new Map();
+    ports = new Map();
+    constructor(world, options = {}) {
+        this.world = world;
+        this.provider = new IWSDKInputProvider(world, options);
+        this.runtime = new InteractionRuntime({
+            provider: this.provider,
+            hitTester: this.hitTester,
+            ...(options.dwellDefaults ? { dwellDefaults: options.dwellDefaults } : {}),
+        });
+    }
+    register(descriptor, entity, options = {}) {
+        const pressable = descriptor.behaviours.some((b) => b.kind === "press");
+        if ((options.addInteractables ?? true) && pressable) {
+            if (!entity.hasComponent(PokeInteractable))
+                entity.addComponent(PokeInteractable);
+            if (!entity.hasComponent(RayInteractable))
+                entity.addComponent(RayInteractable);
+        }
+        this.entities.set(descriptor.id, entity);
+        this.hitTester.register(descriptor.id, entity, options.targetRadius ?? 0.1);
+        const object = entity.object3D;
+        let port;
+        if (object) {
+            port = new IWSDKTransformPort(object);
+            this.ports.set(descriptor.id, port);
+        }
+        this.runtime.registerInteractable(descriptor, port ? { transform: port } : {});
+        return port;
+    }
+    unregister(id) {
+        this.runtime.unregisterInteractable(id);
+        this.hitTester.unregister(id);
+        this.entities.delete(id);
+        this.ports.delete(id);
+    }
+    getPort(id) {
+        return this.ports.get(id);
+    }
+    getEntity(id) {
+        return this.entities.get(id);
+    }
+    /** Called by the bridge system once per frame. */
+    tick(delta, pressedEntities, grabbedEntities) {
+        const hints = [];
+        const pressed = new Set(pressedEntities);
+        const grabbed = new Set(grabbedEntities);
+        let leftGrabbing = false;
+        let rightGrabbing = false;
+        for (const [id, entity] of this.entities) {
+            if (pressed.has(entity)) {
+                hints.push({ sourceId: this.attributeSide(entity), targetId: id, state: "press" });
+            }
+            if (grabbed.has(entity)) {
+                const sourceId = this.attributeSide(entity, "grip");
+                hints.push({ sourceId, targetId: id, state: "grab" });
+                if (sourceId === "left-input")
+                    leftGrabbing = true;
+                else
+                    rightGrabbing = true;
+            }
+        }
+        this.provider.setNativeGrabbing("left", leftGrabbing);
+        this.provider.setNativeGrabbing("right", rightGrabbing);
+        this.provider.setHints(hints);
+        this.runtime.update(delta);
+    }
+    /** Attribute an engine tag to the nearest input side. */
+    attributeSide(entity, space = "tip") {
+        const object = entity.object3D;
+        const spaces = this.world.playerSpaceEntities;
+        if (!object)
+            return "right-input";
+        object.getWorldPosition(TEMP_V);
+        const target = [TEMP_V.x, TEMP_V.y, TEMP_V.z];
+        let bestSide = "right";
+        let bestDistance = Number.POSITIVE_INFINITY;
+        for (const side of ["left", "right"]) {
+            const spaceEntity = space === "tip" ? spaces.indexTipSpaces[side] : spaces.gripSpaces[side];
+            const spaceObject = spaceEntity.object3D;
+            if (!spaceObject)
+                continue;
+            spaceObject.getWorldPosition(TEMP_V);
+            const distance = Math.hypot(TEMP_V.x - target[0], TEMP_V.y - target[1], TEMP_V.z - target[2]);
+            if (distance < bestDistance) {
+                bestDistance = distance;
+                bestSide = side;
+            }
+        }
+        return `${bestSide}-input`;
+    }
+    dispose() {
+        this.runtime.dispose();
+        this.provider.dispose();
+    }
+}
+const hosts = new WeakMap();
+export function interactionsFor(world) {
+    return hosts.get(world);
+}
+/** The per-frame bridge: IWSDK tags → provider hints → runtime tick. */
+export class InteractionBridgeSystem extends createSystem({
+    pressed: { required: [Pressed] },
+    grabbed: { required: [Grabbed] },
+}) {
+    update(delta) {
+        const host = hosts.get(this.world);
+        if (!host)
+            return;
+        host.tick(delta, this.queries.pressed.entities, this.queries.grabbed.entities);
+    }
+}
+/** Register the Interaction Extensions on an IWSDK world (one call). */
+export function registerInteractions(world, options = {}) {
+    const existing = hosts.get(world);
+    if (existing)
+        return existing;
+    const host = new IWSDKInteractions(world, options);
+    hosts.set(world, host);
+    world.registerSystem(InteractionBridgeSystem);
+    return host;
+}
+//# sourceMappingURL=register.js.map

package/dist/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../src/register.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * One-call setup: bind the interaction runtime onto an IWSDK world.\n *\n * ```ts\n * const interactions = registerInteractions(world, { nativeGrab: false });\n * interactions.register(\n *   { id: \"beacon\", behaviours: [{ kind: \"press\" }, { kind: \"pulse\" }] },\n *   beaconEntity,\n * );\n * ```\n *\n * The bridge system runs once per frame: it turns IWSDK's own targeting\n * (`Pressed`/`Grabbed` tags on registered entities) into provider hints -\n * provider power wins over the core's approximate hit-testing - then\n * ticks the runtime. A light proximity/ray hit-tester still serves gaze\n * (dwell) and anything IWSDK's pipeline does not cover.\n */\nimport {\n  createSystem,\n  Grabbed,\n  PokeInteractable,\n  Pressed,\n  RayInteractable,\n  Vector3,\n  type Entity,\n  type World,\n} from \"@iwsdk/core\";\nimport type { InputHitHint, RayTuple, Vec3Tuple } from \"@realitycollective/webxr-input\";\nimport {\n  InteractionRuntime,\n  rayPointDistance,\n  type DwellConfig,\n  type HitTester,\n  type InteractableDescriptor,\n  type InteractableHit,\n} from \"@realitycollective/webxr-interactions\";\nimport { IWSDKInputProvider, type IWSDKProviderOptions } from \"./provider.js\";\nimport { IWSDKTransformPort } from \"./transform-port.js\";\n\nconst TEMP_V = new Vector3();\n\n/** Approximate hit-tester over registered entities (gaze/dwell targeting). */\nclass EntityHitTester implements HitTester {\n  private readonly entries = new Map<string, { entity: Entity; radius: number }>();\n\n  register(id: string, entity: Entity, radius: number): void {\n    this.entries.set(id, { entity, radius });\n  }\n\n  unregister(id: string): void {\n    this.entries.delete(id);\n  }\n\n  hitRay(ray: RayTuple): InteractableHit | null {\n    let best: InteractableHit | null = null;\n    for (const [id, { entity, radius }] of this.entries) {\n      const object = entity.object3D;\n      if (!object || !object.visible) continue;\n      object.getWorldPosition(TEMP_V);\n      const point: Vec3Tuple = [TEMP_V.x, TEMP_V.y, TEMP_V.z];\n      const { distance, t } = rayPointDistance(ray, point);\n      if (t > 0 && distance <= radius && (best === null || t < best.distance)) {\n        best = { interactableId: id, distance: t, point };\n      }\n    }\n    return best;\n  }\n\n  hitProximity(point: Vec3Tuple, radius: number): InteractableHit | null {\n    let best: InteractableHit | null = null;\n    for (const [id, { entity, radius: targetRadius }] of this.entries) {\n      const object = entity.object3D;\n      if (!object || !object.visible) continue;\n      object.getWorldPosition(TEMP_V);\n      const distance =\n        Math.hypot(TEMP_V.x - point[0], TEMP_V.y - point[1], TEMP_V.z - point[2]) - targetRadius;\n      if (distance <= radius && (best === null || distance < best.distance)) {\n        best = {\n          interactableId: id,\n          distance: Math.max(0, distance),\n          point: [TEMP_V.x, TEMP_V.y, TEMP_V.z],\n        };\n      }\n    }\n    return best;\n  }\n}\n\nexport interface IWSDKRegisterOptions extends IWSDKProviderOptions {\n  dwellDefaults?: DwellConfig;\n}\n\nexport interface IWSDKRegisterEntityOptions {\n  /** Add `PokeInteractable`/`RayInteractable` for pressable targets (default true). */\n  addInteractables?: boolean;\n  /** Targeting radius for the approximate gaze/poke hit-tester (default 0.1 m). */\n  targetRadius?: number;\n}\n\nexport class IWSDKInteractions {\n  readonly runtime: InteractionRuntime;\n  readonly provider: IWSDKInputProvider;\n  private readonly hitTester = new EntityHitTester();\n  private readonly world: World;\n  private readonly entities = new Map<string, Entity>();\n  private readonly ports = new Map<string, IWSDKTransformPort>();\n\n  constructor(world: World, options: IWSDKRegisterOptions = {}) {\n    this.world = world;\n    this.provider = new IWSDKInputProvider(world, options);\n    this.runtime = new InteractionRuntime({\n      provider: this.provider,\n      hitTester: this.hitTester,\n      ...(options.dwellDefaults ? { dwellDefaults: options.dwellDefaults } : {}),\n    });\n  }\n\n  register(\n    descriptor: InteractableDescriptor,\n    entity: Entity,\n    options: IWSDKRegisterEntityOptions = {},\n  ): IWSDKTransformPort | undefined {\n    const pressable = descriptor.behaviours.some((b) => b.kind === \"press\");\n    if ((options.addInteractables ?? true) && pressable) {\n      if (!entity.hasComponent(PokeInteractable)) entity.addComponent(PokeInteractable);\n      if (!entity.hasComponent(RayInteractable)) entity.addComponent(RayInteractable);\n    }\n    this.entities.set(descriptor.id, entity);\n    this.hitTester.register(descriptor.id, entity, options.targetRadius ?? 0.1);\n    const object = entity.object3D;\n    let port: IWSDKTransformPort | undefined;\n    if (object) {\n      port = new IWSDKTransformPort(object);\n      this.ports.set(descriptor.id, port);\n    }\n    this.runtime.registerInteractable(descriptor, port ? { transform: port } : {});\n    return port;\n  }\n\n  unregister(id: string): void {\n    this.runtime.unregisterInteractable(id);\n    this.hitTester.unregister(id);\n    this.entities.delete(id);\n    this.ports.delete(id);\n  }\n\n  getPort(id: string): IWSDKTransformPort | undefined {\n    return this.ports.get(id);\n  }\n\n  getEntity(id: string): Entity | undefined {\n    return this.entities.get(id);\n  }\n\n  /** Called by the bridge system once per frame. */\n  tick(delta: number, pressedEntities: Iterable<Entity>, grabbedEntities: Iterable<Entity>): void {\n    const hints: InputHitHint[] = [];\n    const pressed = new Set(pressedEntities);\n    const grabbed = new Set(grabbedEntities);\n    let leftGrabbing = false;\n    let rightGrabbing = false;\n\n    for (const [id, entity] of this.entities) {\n      if (pressed.has(entity)) {\n        hints.push({ sourceId: this.attributeSide(entity), targetId: id, state: \"press\" });\n      }\n      if (grabbed.has(entity)) {\n        const sourceId = this.attributeSide(entity, \"grip\");\n        hints.push({ sourceId, targetId: id, state: \"grab\" });\n        if (sourceId === \"left-input\") leftGrabbing = true;\n        else rightGrabbing = true;\n      }\n    }\n    this.provider.setNativeGrabbing(\"left\", leftGrabbing);\n    this.provider.setNativeGrabbing(\"right\", rightGrabbing);\n    this.provider.setHints(hints);\n    this.runtime.update(delta);\n  }\n\n  /** Attribute an engine tag to the nearest input side. */\n  private attributeSide(entity: Entity, space: \"tip\" | \"grip\" = \"tip\"): string {\n    const object = entity.object3D;\n    const spaces = this.world.playerSpaceEntities;\n    if (!object) return \"right-input\";\n    object.getWorldPosition(TEMP_V);\n    const target: Vec3Tuple = [TEMP_V.x, TEMP_V.y, TEMP_V.z];\n    let bestSide = \"right\";\n    let bestDistance = Number.POSITIVE_INFINITY;\n    for (const side of [\"left\", \"right\"] as const) {\n      const spaceEntity =\n        space === \"tip\" ? spaces.indexTipSpaces[side] : spaces.gripSpaces[side];\n      const spaceObject = spaceEntity.object3D;\n      if (!spaceObject) continue;\n      spaceObject.getWorldPosition(TEMP_V);\n      const distance = Math.hypot(\n        TEMP_V.x - target[0],\n        TEMP_V.y - target[1],\n        TEMP_V.z - target[2],\n      );\n      if (distance < bestDistance) {\n        bestDistance = distance;\n        bestSide = side;\n      }\n    }\n    return `${bestSide}-input`;\n  }\n\n  dispose(): void {\n    this.runtime.dispose();\n    this.provider.dispose();\n  }\n}\n\nconst hosts = new WeakMap<World, IWSDKInteractions>();\n\nexport function interactionsFor(world: World): IWSDKInteractions | undefined {\n  return hosts.get(world);\n}\n\n/** The per-frame bridge: IWSDK tags → provider hints → runtime tick. */\nexport class InteractionBridgeSystem extends createSystem({\n  pressed: { required: [Pressed] },\n  grabbed: { required: [Grabbed] },\n}) {\n  override update(delta: number): void {\n    const host = hosts.get(this.world as unknown as World);\n    if (!host) return;\n    host.tick(delta, this.queries.pressed.entities, this.queries.grabbed.entities);\n  }\n}\n\n/** Register the Interaction Extensions on an IWSDK world (one call). */\nexport function registerInteractions(\n  world: World,\n  options: IWSDKRegisterOptions = {},\n): IWSDKInteractions {\n  const existing = hosts.get(world);\n  if (existing) return existing;\n  const host = new IWSDKInteractions(world, options);\n  hosts.set(world, host);\n  world.registerSystem(InteractionBridgeSystem);\n  return host;\n}\n"]}

package/dist/transform-port.d.ts

@@ -0,0 +1,33 @@
+/**
+ * IWSDKTransformPort - the core's TransformPort over an IWSDK entity's
+ * `object3D`, honouring FROM-REST semantics (rest captured at
+ * construction; `getWorldPose()` reports the rest pose in world space).
+ * Same math as the three.js adapter's port, expressed against IWSDK's
+ * re-exported three types so there is exactly one three instance.
+ */
+import { type Object3D } from "@iwsdk/core";
+import type { PoseTuple, QuatTuple, Vec3Tuple } from "@realitycollective/webxr-input";
+import type { TransformPort } from "@realitycollective/webxr-interactions";
+export declare class IWSDKTransformPort 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,100 @@
+/**
+ * IWSDKTransformPort - the core's TransformPort over an IWSDK entity's
+ * `object3D`, honouring FROM-REST semantics (rest captured at
+ * construction; `getWorldPose()` reports the rest pose in world space).
+ * Same math as the three.js adapter's port, expressed against IWSDK's
+ * re-exported three types so there is exactly one three instance.
+ */
+import { Matrix4, Quaternion, Vector3, } from "@iwsdk/core";
+export class IWSDKTransformPort {
+    object;
+    restPosition = new Vector3();
+    restQuaternion = new Quaternion();
+    restScale = new Vector3();
+    baseEmissive = null;
+    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[0], offset[1], offset[2]).applyQuaternion(this.restQuaternion);
+        this.object.position.copy(this.restPosition).add(this.v);
+    }
+    setLocalRotation(quaternion) {
+        this.q.set(quaternion[0], quaternion[1], quaternion[2], quaternion[3]);
+        this.object.quaternion.copy(this.restQuaternion).multiply(this.q);
+    }
+    setWorldPose(pose) {
+        const parent = this.object.parent;
+        this.v.set(pose.position[0], pose.position[1], pose.position[2]);
+        this.q.set(pose.quaternion[0], pose.quaternion[1], pose.quaternion[2], pose.quaternion[3]);
+        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 * IWSDKTransformPort - the core's TransformPort over an IWSDK entity's\n * `object3D`, honouring FROM-REST semantics (rest captured at\n * construction; `getWorldPose()` reports the rest pose in world space).\n * Same math as the three.js adapter's port, expressed against IWSDK's\n * re-exported three types so there is exactly one three instance.\n */\nimport {\n  Matrix4,\n  Quaternion,\n  Vector3,\n  type Material,\n  type Mesh,\n  type MeshStandardMaterial,\n  type Object3D,\n} from \"@iwsdk/core\";\nimport type { PoseTuple, QuatTuple, Vec3Tuple } from \"@realitycollective/webxr-input\";\nimport type { TransformPort } from \"@realitycollective/webxr-interactions\";\n\nexport class IWSDKTransformPort 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  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[0], offset[1], offset[2]).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[0], quaternion[1], quaternion[2], quaternion[3]);\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[0], pose.position[1], pose.position[2]);\n    this.q.set(pose.quaternion[0], pose.quaternion[1], pose.quaternion[2], pose.quaternion[3]);\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/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@realitycollective/iwsdk-interactions",
+  "version": "0.1.0-preview.0",
+  "description": "Meta IWSDK adapter for the Reality Collective Interaction Extensions - feeds IWSDK's input machinery (Pressed/Grabbed tags, poke/ray interactables, grabbables, XR gamepads, hand joints) into the engine-free @realitycollective/webxr-interactions core, with native grab fulfilment. Re-exports the core.",
+  "keywords": [
+    "realitycollective",
+    "iwsdk",
+    "webxr",
+    "xr",
+    "interaction",
+    "input",
+    "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": {
+    "@iwsdk/core": ">=0.4.0 <0.6.0"
+  },
+  "devDependencies": {
+    "@iwsdk/core": "0.4.2",
+    "three": "npm:super-three@0.181.0",
+    "@types/three": "*"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/realitycollective/WebXR-Interactions.git",
+    "directory": "packages/iwsdk-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"
+  }
+}