@realitycollective/iwsdk-interactions 0.1.0-preview.1 → 0.1.0-preview.2

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # 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.
+Change log for the Reality Collective WebXR Interaction Extensions packages. All five 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.
 
@@ -13,15 +13,23 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
 - `@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.
+- `@realitycollective/webxr-interactions` - per-source velocity. `VelocityTracker` differentiates the grip poses the runtime already samples into linear and angular velocity, and the runtime runs one by default (`velocity: false` turns it off, `{ smoothing }` averages it). A source on its first frame, or one that reappears after dropping out, reports no velocity rather than a jump from its last known pose, and a provider that supplies its own velocity keeps it. Read it from `runtime.onSample(...)` or `runtime.getSource(id)`. `poseVelocity` and `clampDeadzone` join the math helpers.
+- `@realitycollective/webxr-interactions` - `routeAudioToSink`, the audio counterpart to `routeHapticsToProvider`: an opt-in that plays the cues named in a map through a client-supplied sink. Cues absent from the map are ignored, so an app sonifies only the moments it has sounds for.
+- `@realitycollective/iwsdk-interactions` and `@realitycollective/threejs-interactions` - presence control. `setPresenceVisible(target, visible)` shows and hides the hand and controller visuals per side; the IWSDK adapter adds `setPresenceModality(mode)` to force hands or controllers over the automatic choice, and the three.js adapter takes the app's own models through `registerVisual(handedness, root)`. Each provider reports `supportsPresence`; the XR Blocks adapter reports false, since XR Blocks exposes no way to hide its visuals.
+- `@realitycollective/threejs-interactions` - native WebXR pose velocity. Where the browser reports `linearVelocity` or `angularVelocity` with a grip pose (or with the wrist joint a hand falls back to), the provider passes it through on the snapshot and the core's tracker leaves it alone; where it does not, the tracker derives velocity from consecutive poses as before. The desktop mouse source synthesises nothing: its grip rides the camera ray, so the derived velocity is camera motion, and hand mechanics should be gated on `handedness !== "none"`.
+- `@realitycollective/babylon-interactions` - a Babylon.js adapter, the fourth engine. It reads a `WebXRDefaultExperience` (controllers, motion controller trigger and squeeze, hand-tracking joints, session manager) for input, with `scene.onPointerObservable` as the desktop fallback, haptics through the motion controller's `pulse`, and presence over the visuals Babylon builds - motion controller root meshes and hand meshes. Babylon picks the visual per input source, so there is no modality switch. Hit-testing is a sphere test over registered nodes, with an optional `pickWithRay` hook for mesh-accurate targeting; the transform port moves, rotates and scales Babylon nodes from rest. Structurally typed against the Babylon API rather than importing `@babylonjs/core`, as the XR Blocks adapter is, so an upstream release cannot break the install - and so the whole adapter is covered headlessly by structural fakes. Written against the documented Babylon 7 API and not yet exercised against a real Babylon runtime.
+- Tests for `@realitycollective/iwsdk-interactions`, which had none. `@iwsdk/core` imports headlessly in node, so the provider is covered against a structural fake world with no module mocking, and a parity suite instantiates all three providers and checks each one implements the whole `InputProvider` contract. The package's coverage ratchet moves off zero, and the other three ratchets rise to the floor they now measure.
 
 ### Changed
 
+- `@realitycollective/iwsdk-interactions` - `pulse` resolves the side from the handedness recorded while sampling, rather than parsing the source id. Parsing the id remains the fallback for an id the provider did not produce.
+
 - `@realitycollective/iwsdk-interactions` targets **IWSDK 0.5.x**. Its peer range is now `>=0.5.0 <0.6.0` and it is developed and tested against `@iwsdk/core` 0.5.3. The adapter is source-compatible with 0.4.x and needed no code change, but 0.5 is the only line exercised, so it is the only line supported. Every symbol and runtime member the provider uses is present in both, and it already reads `world.input.xr.gamepads` rather than the accessor 0.5 deprecates.
 - `demos/playground` no longer compiles UIKitML at build time. `@iwsdk/vite-plugin-uikitml` was discontinued at 0.4.2 and only ever did `JSON.stringify(parse(source))`, so the panel is served as `.uikitml` from `public/ui/` and parsed on load. The demo drops that plugin, and its station markup uses `rgba()` rather than `background-opacity`, which the 0.5 parser removed.
 
 ### 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.
+- All five 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.
 - The interaction packages themselves carry no IWSDK coupling beyond the adapter: `webxr-interactions` is engine-free, and `threejs-interactions` and `xrblocks-interactions` peer only on three.js.
 
 [0.1.0]: https://github.com/realitycollective/WebXR-Interactions/commits/main

package/dist/provider.d.ts

@@ -23,7 +23,20 @@ export interface IWSDKProviderOptions {
     nativeGrab?: boolean;
 }
 type Side = "left" | "right";
+/** Which side's visuals a presence call targets. `"all"` is both. */
+export type PresenceTarget = "left" | "right" | "none" | "all";
+/**
+ * Which family of visuals presence shows. `"auto"` follows the engine:
+ * hand visuals while hand tracking is live, controller visuals otherwise.
+ */
+export type PresenceModality = "hands" | "controllers" | "auto";
 export declare class IWSDKInputProvider implements InputProvider {
+    /**
+     * This provider can show and hide the controller/hand visuals.
+     * Becomes `capabilities.presence` at
+     * `@realitycollective/webxr-input` 0.1.1.
+     */
+    readonly supportsPresence = true;
     private readonly world;
     private readonly nativeGrab;
     private capabilities;
@@ -31,6 +44,12 @@ export declare class IWSDKInputProvider implements InputProvider {
     private readonly sourceListeners;
     private hints;
     private readonly nativeGrabbing;
+    /** Snapshot id -> side, filled by `sample()` so `pulse` need not parse ids. */
+    private readonly sideBySourceId;
+    private readonly presenceVisible;
+    private presenceModality;
+    /** Presence is only re-applied once a client has actually asked for it. */
+    private presenceRequested;
     private readonly disposers;
     private boundSession;
     private readonly onSourcesChange;
@@ -47,6 +66,24 @@ export declare class IWSDKInputProvider implements InputProvider {
     /** Bridge-system input: a side is currently native-grabbing. */
     setNativeGrabbing(side: Side, grabbing: boolean): void;
     sample(): readonly InputSourceSnapshot[];
+    /**
+     * Show or hide this session's controller/hand visuals. Returns false when
+     * IWSDK has published no visual adapters, which is the case outside a
+     * session. The request is remembered and re-applied on every sample, so
+     * a call made before the adapters exist still lands.
+     *
+     * `"none"` targets no side - the handedness value that has no visual
+     * here - so the call reports availability without changing anything.
+     */
+    setPresenceVisible(target: PresenceTarget, visible: boolean): boolean;
+    /**
+     * Choose which family of visuals is shown. `"hands"` and `"controllers"`
+     * force one family and hide the other; `"auto"` follows the engine's own
+     * modality (hand visuals while hand tracking is live).
+     */
+    setPresenceModality(mode: PresenceModality): boolean;
+    private visualAdapters;
+    private applyPresence;
     getHeadPose(): HeadPose;
     pulse(sourceId: string, intensity: number, durationMs: number): boolean;
     dispose(): void;

package/dist/provider.js

@@ -16,7 +16,37 @@
 import { InputComponent, VisibilityState } from "@iwsdk/core";
 import { NO_CAPABILITIES, } from "@realitycollective/webxr-input";
 const SIDES = ["left", "right"];
+/**
+ * Show or hide a visual by walking its DESCENDANTS rather than setting
+ * `visible` on the root.
+ *
+ * Verified against `@iwsdk/xr-input` 0.5.3 (`dist/xr-input-manager.js`, the
+ * per-frame update): IWSDK writes `visualAdapter.visual.model.visible =
+ * inputSourceData.isPrimary` every frame, so a root-level write is undone
+ * before it is drawn. The engine never touches the descendants, so hiding
+ * them is the write that sticks, independent of system ordering.
+ */
+function setDescendantsVisible(adapter, visible) {
+    const model = adapter?.visual?.model;
+    if (!model)
+        return;
+    const stack = [...(model.children ?? [])];
+    while (stack.length > 0) {
+        const node = stack.pop();
+        if (!node)
+            continue;
+        node.visible = visible;
+        for (const child of node.children ?? [])
+            stack.push(child);
+    }
+}
 export class IWSDKInputProvider {
+    /**
+     * This provider can show and hide the controller/hand visuals.
+     * Becomes `capabilities.presence` at
+     * `@realitycollective/webxr-input` 0.1.1.
+     */
+    supportsPresence = true;
     world;
     nativeGrab;
     capabilities;
@@ -24,6 +54,12 @@ export class IWSDKInputProvider {
     sourceListeners = new Set();
     hints = [];
     nativeGrabbing = { left: false, right: false };
+    /** Snapshot id -> side, filled by `sample()` so `pulse` need not parse ids. */
+    sideBySourceId = new Map();
+    presenceVisible = { left: true, right: true };
+    presenceModality = "auto";
+    /** Presence is only re-applied once a client has actually asked for it. */
+    presenceRequested = false;
     disposers = [];
     boundSession = null;
     onSourcesChange = () => {
@@ -117,6 +153,11 @@ export class IWSDKInputProvider {
         this.nativeGrabbing[side] = grabbing;
     }
     sample() {
+        this.sideBySourceId.clear();
+        // Adapters are created as input sources connect, which can be after the
+        // client set its presence, so the desired state is re-applied here.
+        if (this.presenceRequested)
+            this.applyPresence();
         if (!this.world.session)
             return [];
         if (this.world.visibilityState.peek() !== VisibilityState.Visible)
@@ -167,10 +208,58 @@ export class IWSDKInputProvider {
             if ((gamepad?.gamepad?.hapticActuators?.length ?? 0) > 0) {
                 snapshot.hapticsAvailable = true;
             }
+            this.sideBySourceId.set(snapshot.id, side);
             snapshots.push(snapshot);
         }
         return snapshots;
     }
+    // -- presence ---------------------------------------------------------------
+    /**
+     * Show or hide this session's controller/hand visuals. Returns false when
+     * IWSDK has published no visual adapters, which is the case outside a
+     * session. The request is remembered and re-applied on every sample, so
+     * a call made before the adapters exist still lands.
+     *
+     * `"none"` targets no side - the handedness value that has no visual
+     * here - so the call reports availability without changing anything.
+     */
+    setPresenceVisible(target, visible) {
+        this.presenceRequested = true;
+        for (const side of SIDES) {
+            if (target === "all" || target === side)
+                this.presenceVisible[side] = visible;
+        }
+        return this.applyPresence();
+    }
+    /**
+     * Choose which family of visuals is shown. `"hands"` and `"controllers"`
+     * force one family and hide the other; `"auto"` follows the engine's own
+     * modality (hand visuals while hand tracking is live).
+     */
+    setPresenceModality(mode) {
+        this.presenceRequested = true;
+        this.presenceModality = mode;
+        return this.applyPresence();
+    }
+    visualAdapters() {
+        const xr = this.world.input?.xr;
+        return xr?.visualAdapters ?? null;
+    }
+    applyPresence() {
+        const adapters = this.visualAdapters();
+        if (!adapters)
+            return false;
+        const hands = this.presenceModality === "hands" ||
+            (this.presenceModality === "auto" && this.capabilities.handJoints);
+        const controllers = this.presenceModality === "controllers" ||
+            (this.presenceModality === "auto" && !this.capabilities.handJoints);
+        for (const side of SIDES) {
+            const wanted = this.presenceVisible[side];
+            setDescendantsVisible(adapters.hand?.[side], wanted && hands);
+            setDescendantsVisible(adapters.controller?.[side], wanted && controllers);
+        }
+        return true;
+    }
     getHeadPose() {
         const head = this.world.playerSpaceEntities.head.object3D;
         if (!head)
@@ -183,7 +272,11 @@ export class IWSDKInputProvider {
         };
     }
     pulse(sourceId, intensity, durationMs) {
-        const side = sourceId.startsWith("left") ? "left" : sourceId.startsWith("right") ? "right" : null;
+        // The side comes from the handedness recorded when the snapshot was
+        // built. Parsing the id is the fallback for an id this provider did not
+        // produce (a caller's own naming, or a pulse before the first sample).
+        const side = this.sideBySourceId.get(sourceId) ??
+            (sourceId.startsWith("left") ? "left" : sourceId.startsWith("right") ? "right" : null);
         if (!side)
             return false;
         const actuator = this.world.input.xr.gamepads[side]?.gamepad?.hapticActuators?.[0];
@@ -196,6 +289,8 @@ export class IWSDKInputProvider {
         this.boundSession?.removeEventListener("inputsourceschange", this.onSourcesChange);
         for (const dispose of this.disposers)
             dispose();
+        this.disposers.length = 0;
+        this.sideBySourceId.clear();
     }
 }
 // Shared scratch objects (single-threaded frame sampling).

package/dist/provider.js.map

@@ -1 +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"]}
+{"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\n/** Which side's visuals a presence call targets. `\"all\"` is both. */\nexport type PresenceTarget = \"left\" | \"right\" | \"none\" | \"all\";\n\n/**\n * Which family of visuals presence shows. `\"auto\"` follows the engine:\n * hand visuals while hand tracking is live, controller visuals otherwise.\n */\nexport type PresenceModality = \"hands\" | \"controllers\" | \"auto\";\n\n/**\n * Structural slice of `world.input.xr.visualAdapters`. Only two fields are\n * needed and the real typings drag the whole `@iwsdk/xr-input` visual\n * stack in for them, so the shape is declared here. A per-side adapter,\n * and its `visual`, are both absent until that input source connects.\n */\ninterface PresenceObjectLike {\n  visible: boolean;\n  children?: readonly PresenceObjectLike[];\n}\n\ninterface PresenceAdapterLike {\n  visual?: { model?: PresenceObjectLike } | undefined;\n}\n\ninterface PresenceAdaptersLike {\n  controller?: Partial<Record<Side, PresenceAdapterLike | undefined>> | undefined;\n  hand?: Partial<Record<Side, PresenceAdapterLike | undefined>> | undefined;\n}\n\n/**\n * Show or hide a visual by walking its DESCENDANTS rather than setting\n * `visible` on the root.\n *\n * Verified against `@iwsdk/xr-input` 0.5.3 (`dist/xr-input-manager.js`, the\n * per-frame update): IWSDK writes `visualAdapter.visual.model.visible =\n * inputSourceData.isPrimary` every frame, so a root-level write is undone\n * before it is drawn. The engine never touches the descendants, so hiding\n * them is the write that sticks, independent of system ordering.\n */\nfunction setDescendantsVisible(adapter: PresenceAdapterLike | undefined, visible: boolean): void {\n  const model = adapter?.visual?.model;\n  if (!model) return;\n  const stack: PresenceObjectLike[] = [...(model.children ?? [])];\n  while (stack.length > 0) {\n    const node = stack.pop();\n    if (!node) continue;\n    node.visible = visible;\n    for (const child of node.children ?? []) stack.push(child);\n  }\n}\n\nexport class IWSDKInputProvider implements InputProvider {\n  /**\n   * This provider can show and hide the controller/hand visuals.\n   * Becomes `capabilities.presence` at\n   * `@realitycollective/webxr-input` 0.1.1.\n   */\n  readonly supportsPresence = true;\n\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  /** Snapshot id -> side, filled by `sample()` so `pulse` need not parse ids. */\n  private readonly sideBySourceId = new Map<string, Side>();\n  private readonly presenceVisible: Record<Side, boolean> = { left: true, right: true };\n  private presenceModality: PresenceModality = \"auto\";\n  /** Presence is only re-applied once a client has actually asked for it. */\n  private presenceRequested = 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    this.sideBySourceId.clear();\n    // Adapters are created as input sources connect, which can be after the\n    // client set its presence, so the desired state is re-applied here.\n    if (this.presenceRequested) this.applyPresence();\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      this.sideBySourceId.set(snapshot.id, side);\n      snapshots.push(snapshot);\n    }\n    return snapshots;\n  }\n\n  // -- presence ---------------------------------------------------------------\n\n  /**\n   * Show or hide this session's controller/hand visuals. Returns false when\n   * IWSDK has published no visual adapters, which is the case outside a\n   * session. The request is remembered and re-applied on every sample, so\n   * a call made before the adapters exist still lands.\n   *\n   * `\"none\"` targets no side - the handedness value that has no visual\n   * here - so the call reports availability without changing anything.\n   */\n  setPresenceVisible(target: PresenceTarget, visible: boolean): boolean {\n    this.presenceRequested = true;\n    for (const side of SIDES) {\n      if (target === \"all\" || target === side) this.presenceVisible[side] = visible;\n    }\n    return this.applyPresence();\n  }\n\n  /**\n   * Choose which family of visuals is shown. `\"hands\"` and `\"controllers\"`\n   * force one family and hide the other; `\"auto\"` follows the engine's own\n   * modality (hand visuals while hand tracking is live).\n   */\n  setPresenceModality(mode: PresenceModality): boolean {\n    this.presenceRequested = true;\n    this.presenceModality = mode;\n    return this.applyPresence();\n  }\n\n  private visualAdapters(): PresenceAdaptersLike | null {\n    const xr = this.world.input?.xr as unknown as\n      | { visualAdapters?: PresenceAdaptersLike }\n      | undefined;\n    return xr?.visualAdapters ?? null;\n  }\n\n  private applyPresence(): boolean {\n    const adapters = this.visualAdapters();\n    if (!adapters) return false;\n    const hands =\n      this.presenceModality === \"hands\" ||\n      (this.presenceModality === \"auto\" && this.capabilities.handJoints);\n    const controllers =\n      this.presenceModality === \"controllers\" ||\n      (this.presenceModality === \"auto\" && !this.capabilities.handJoints);\n    for (const side of SIDES) {\n      const wanted = this.presenceVisible[side];\n      setDescendantsVisible(adapters.hand?.[side], wanted && hands);\n      setDescendantsVisible(adapters.controller?.[side], wanted && controllers);\n    }\n    return true;\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    // The side comes from the handedness recorded when the snapshot was\n    // built. Parsing the id is the fallback for an id this provider did not\n    // produce (a caller's own naming, or a pulse before the first sample).\n    const side =\n      this.sideBySourceId.get(sourceId) ??\n      (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    this.disposers.length = 0;\n    this.sideBySourceId.clear();\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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@realitycollective/iwsdk-interactions",
-  "version": "0.1.0-preview.1",
+  "version": "0.1.0-preview.2",
   "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",
@@ -33,7 +33,7 @@
   },
   "dependencies": {
     "@realitycollective/webxr-input": "^0.1.0",
-    "@realitycollective/webxr-interactions": "^0.1.0-preview.1"
+    "@realitycollective/webxr-interactions": "^0.1.0-preview.2"
   },
   "peerDependencies": {
     "@iwsdk/core": ">=0.5.0 <0.6.0"