@realitycollective/webxr-interactions 0.1.1-preview.1 → 0.1.1-preview.3

package/dist/gaze.d.ts

@@ -11,6 +11,8 @@
  * The dwell state machine is pure and headless-tested. The runtime feeds it
  * hover booleans; it never sees the engine.
  */
+import type { RayTuple, Vec3Tuple } from "@realitycollective/webxr-input";
+import type { InteractableHit } from "./ports.js";
 export interface DwellConfig {
     /** Seconds of sustained gaze to fire. */
     holdSeconds?: number;
@@ -42,3 +44,51 @@ export declare class DwellState {
     update(hovered: boolean, dt: number, config: Required<DwellConfig>): DwellTick;
     getProgress(): number;
 }
+/** Comparer tolerance: angular distances within this are "the same", and distance decides. IWSDK `ANGLE_EPSILON`. */
+export declare const GAZE_CONE_ANGLE_EPSILON: number;
+/** A cone hit: {@link InteractableHit} plus how far off the gaze axis the target's silhouette sat, radians (0 when the ray itself hit). */
+export interface GazeConeHit extends InteractableHit {
+    angularDistance: number;
+}
+/** A sphere target, as the approximate hit testers and the native host model one. */
+export interface SphereTarget {
+    id: string;
+    center: Vec3Tuple;
+    radius: number;
+}
+/**
+ * IWSDK's `GazeConecaster.findFrameBest` over sphere targets: the best
+ * target inside a cone of `halfAngle` radians about `ray`, no farther than
+ * `maxLength`. A sphere the ray passes through is hit where the ray enters
+ * it, with an angular distance of 0. Otherwise the angle from the ray to the
+ * sphere's silhouette (the angle to its centre less the angle it subtends)
+ * must be within the cone, and the point aimed at is the point of the sphere
+ * nearest the ray. Closer by angle wins; within {@link GAZE_CONE_ANGLE_EPSILON}
+ * the nearer target wins. A sphere the origin is inside counts as on axis.
+ */
+export declare function coneHitForSpheres(ray: RayTuple, targets: Iterable<SphereTarget>, halfAngle: number, maxLength: number): GazeConeHit | null;
+/** IWSDK's default comparer: closer by angle, then closer by distance. Negative when `a` is better. */
+export declare function compareConeHits(a: GazeConeHit, b: GazeConeHit): number;
+/**
+ * IWSDK's dwell consensus (`GazeConecaster.recordDwell` / `pruneDwell` /
+ * `electDwellWinner` / `resolveDwellWinner`): each frame's best candidate is
+ * recorded with its `dt`; samples older than the window are dropped; the
+ * candidate with the largest cumulative `dt` inside the window wins. A winner
+ * that is no longer available (unregistered, disabled, hidden) is struck
+ * from the record and the next is elected. A window of 0 keeps only this
+ * frame's sample, so the frame's best wins outright.
+ */
+export declare class GazeConsensus {
+    windowSeconds: number;
+    private readonly samples;
+    private time;
+    constructor(windowSeconds?: number);
+    /** Record this frame's best (or none), advance the window and elect. */
+    update(frameBestId: string | null, dt: number, available: (id: string) => boolean): string | null;
+    /** Advance the window with nothing recorded (a frame gaze was suppressed or had no pose). */
+    skip(dt: number): void;
+    reset(): void;
+    private prune;
+    private elect;
+    private remove;
+}

package/dist/gaze.js

@@ -58,4 +58,166 @@ export class DwellState {
         return this.progress;
     }
 }
+// ---------------------------------------------------------------------------
+// Eye gaze: the targeting half of the rule `@realitycollective/webxr-input`'s
+// `eye-gaze.ts` states. IWSDK's `GazeConecaster` picks the frame's best
+// in-cone candidate and then holds a time-weighted vote over the dwell
+// window, so a flick across a neighbour does not steal hover.
+// ---------------------------------------------------------------------------
+/** Comparer tolerance: angular distances within this are "the same", and distance decides. IWSDK `ANGLE_EPSILON`. */
+export const GAZE_CONE_ANGLE_EPSILON = 0.5 * (Math.PI / 180);
+/**
+ * IWSDK's `GazeConecaster.findFrameBest` over sphere targets: the best
+ * target inside a cone of `halfAngle` radians about `ray`, no farther than
+ * `maxLength`. A sphere the ray passes through is hit where the ray enters
+ * it, with an angular distance of 0. Otherwise the angle from the ray to the
+ * sphere's silhouette (the angle to its centre less the angle it subtends)
+ * must be within the cone, and the point aimed at is the point of the sphere
+ * nearest the ray. Closer by angle wins; within {@link GAZE_CONE_ANGLE_EPSILON}
+ * the nearer target wins. A sphere the origin is inside counts as on axis.
+ */
+export function coneHitForSpheres(ray, targets, halfAngle, maxLength) {
+    const [ox, oy, oz] = ray.origin;
+    const [dx, dy, dz] = ray.direction;
+    let best = null;
+    for (const target of targets) {
+        const [cx, cy, cz] = target.center;
+        const r = target.radius;
+        const vx = cx - ox;
+        const vy = cy - oy;
+        const vz = cz - oz;
+        const dist = Math.hypot(vx, vy, vz);
+        if (dist - r > maxLength)
+            continue;
+        let hit;
+        if (dist <= r) {
+            // The origin is inside the sphere: fully on axis, aimed at the centre.
+            hit = { interactableId: target.id, distance: dist, point: [cx, cy, cz], angularDistance: 0 };
+        }
+        else {
+            const t = vx * dx + vy * dy + vz * dz;
+            const missSq = Math.max(0, dist * dist - t * t);
+            const miss = Math.sqrt(missSq);
+            if (t > 0 && miss <= r) {
+                // The ray enters the sphere: the raw ray wins, at the entry point.
+                const entry = t - Math.sqrt(r * r - missSq);
+                if (entry > maxLength)
+                    continue;
+                hit = {
+                    interactableId: target.id,
+                    distance: entry,
+                    point: [ox + dx * entry, oy + dy * entry, oz + dz * entry],
+                    angularDistance: 0,
+                };
+            }
+            else {
+                const toCentre = Math.atan2(miss, t);
+                const angular = Math.max(0, toCentre - Math.asin(Math.min(1, r / dist)));
+                if (angular > halfAngle)
+                    continue;
+                // The point of the sphere nearest the ray: from the centre toward the
+                // ray's closest point (never behind the origin), out to the surface.
+                const tc = Math.max(0, t);
+                let nx = ox + dx * tc - cx;
+                let ny = oy + dy * tc - cy;
+                let nz = oz + dz * tc - cz;
+                const nl = Math.hypot(nx, ny, nz);
+                if (nl > 1e-9) {
+                    nx /= nl;
+                    ny /= nl;
+                    nz /= nl;
+                }
+                else {
+                    nx = -vx / dist;
+                    ny = -vy / dist;
+                    nz = -vz / dist;
+                }
+                const point = [cx + nx * r, cy + ny * r, cz + nz * r];
+                const distance = Math.hypot(point[0] - ox, point[1] - oy, point[2] - oz);
+                if (distance > maxLength)
+                    continue;
+                hit = { interactableId: target.id, distance, point, angularDistance: angular };
+            }
+        }
+        if (best === null || compareConeHits(hit, best) < 0)
+            best = hit;
+    }
+    return best;
+}
+/** IWSDK's default comparer: closer by angle, then closer by distance. Negative when `a` is better. */
+export function compareConeHits(a, b) {
+    const dAngle = a.angularDistance - b.angularDistance;
+    if (Math.abs(dAngle) > GAZE_CONE_ANGLE_EPSILON)
+        return dAngle;
+    return a.distance - b.distance;
+}
+/**
+ * IWSDK's dwell consensus (`GazeConecaster.recordDwell` / `pruneDwell` /
+ * `electDwellWinner` / `resolveDwellWinner`): each frame's best candidate is
+ * recorded with its `dt`; samples older than the window are dropped; the
+ * candidate with the largest cumulative `dt` inside the window wins. A winner
+ * that is no longer available (unregistered, disabled, hidden) is struck
+ * from the record and the next is elected. A window of 0 keeps only this
+ * frame's sample, so the frame's best wins outright.
+ */
+export class GazeConsensus {
+    windowSeconds;
+    samples = [];
+    time = 0;
+    constructor(windowSeconds = 0.15) {
+        this.windowSeconds = windowSeconds;
+    }
+    /** Record this frame's best (or none), advance the window and elect. */
+    update(frameBestId, dt, available) {
+        this.time += dt;
+        if (frameBestId !== null)
+            this.samples.push({ id: frameBestId, time: this.time, dt });
+        this.prune();
+        for (;;) {
+            const elected = this.elect();
+            if (elected === null)
+                return null;
+            if (available(elected))
+                return elected;
+            this.remove(elected);
+        }
+    }
+    /** Advance the window with nothing recorded (a frame gaze was suppressed or had no pose). */
+    skip(dt) {
+        this.time += dt;
+    }
+    reset() {
+        this.samples.length = 0;
+    }
+    prune() {
+        const cutoff = this.time - this.windowSeconds;
+        let drop = 0;
+        while (drop < this.samples.length && this.samples[drop].time < cutoff)
+            drop += 1;
+        if (drop > 0)
+            this.samples.splice(0, drop);
+    }
+    elect() {
+        let bestId = null;
+        let bestDt = -1;
+        const sums = new Map();
+        for (const sample of this.samples)
+            sums.set(sample.id, (sums.get(sample.id) ?? 0) + sample.dt);
+        // First recorded wins a tie, as IWSDK's scan from the ring head does.
+        for (const sample of this.samples) {
+            const sum = sums.get(sample.id);
+            if (sum > bestDt) {
+                bestDt = sum;
+                bestId = sample.id;
+            }
+        }
+        return bestId;
+    }
+    remove(id) {
+        for (let i = this.samples.length - 1; i >= 0; i--) {
+            if (this.samples[i].id === id)
+                this.samples.splice(i, 1);
+        }
+    }
+}
 //# sourceMappingURL=gaze.js.map

package/dist/gaze.js.map

@@ -1 +1 @@
-{"version":3,"file":"gaze.js","sourceRoot":"","sources":["../src/gaze.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAkBH,MAAM,CAAC,MAAM,cAAc,GAA0B;IACnD,WAAW,EAAE,GAAG;IAChB,WAAW,EAAE,GAAG;IAChB,UAAU,EAAE,GAAG;CAChB,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAChC,MAAyC,EACzC,WAAkC,cAAc;IAEhD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAC;IACrC,OAAO;QACL,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW;QACvD,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW;QACvD,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,QAAQ,CAAC,UAAU;KACrD,CAAC;AACJ,CAAC;AAWD,MAAM,OAAO,UAAU;IACb,QAAQ,GAAG,CAAC,CAAC;IACb,YAAY,GAAG,CAAC,CAAC;IACjB,KAAK,GAAG,IAAI,CAAC;IAErB,MAAM,CAAC,OAAgB,EAAE,EAAU,EAAE,MAA6B;QAChE,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC7B,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,GAAG,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CACtB,CAAC,EACD,IAAI,CAAC,QAAQ,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,WAAW,CAAC,GAAG,MAAM,CAAC,WAAW,CAC/D,CAAC;QACJ,CAAC;QAED,IAAI,KAAK,GAAG,KAAK,CAAC;QAClB,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;YACrC,KAAK,GAAG,IAAI,CAAC;YACb,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YACnB,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC;QACpB,CAAC;aAAM,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YAC7D,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACpB,CAAC;QAED,MAAM,OAAO,GACX,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI;YACnD,CAAC,IAAI,CAAC,QAAQ,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,CAAC;QACxC,IAAI,OAAO;YAAE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC/C,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACrD,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF","sourcesContent":["/**\n * Gaze support - first-class, per the design decision that gaze serves two\n * roles:\n *\n * 1. **Combination gating** (`gaze.required`): input on an interactable only\n *    counts while the viewer is looking at it.\n * 2. **Accessibility** (`gaze.dwell`): looking at an interactable fills a\n *    dwell meter; a full meter fires a synthesized press - no hands needed.\n *    Consumers render the meter from `dwellProgress` events.\n *\n * The dwell state machine is pure and headless-tested. The runtime feeds it\n * hover booleans; it never sees the engine.\n */\n\nexport interface DwellConfig {\n  /** Seconds of sustained gaze to fire. */\n  holdSeconds?: number;\n  /** Drain speed multiplier when looking away. */\n  decayFactor?: number;\n  /** After firing, progress must fall below this before it can re-arm. */\n  rearmBelow?: number;\n}\n\nexport interface GazeConfig {\n  /** Non-gaze input on this interactable only counts while gazed at. */\n  required?: boolean;\n  /** Enable dwell-to-press. `true` uses defaults. */\n  dwell?: boolean | DwellConfig;\n}\n\nexport const DWELL_DEFAULTS: Required<DwellConfig> = {\n  holdSeconds: 1.8,\n  decayFactor: 2.5,\n  rearmBelow: 0.1,\n};\n\nexport function resolveDwellConfig(\n  config: boolean | DwellConfig | undefined,\n  defaults: Required<DwellConfig> = DWELL_DEFAULTS,\n): Required<DwellConfig> | null {\n  if (!config) return null;\n  if (config === true) return defaults;\n  return {\n    holdSeconds: config.holdSeconds ?? defaults.holdSeconds,\n    decayFactor: config.decayFactor ?? defaults.decayFactor,\n    rearmBelow: config.rearmBelow ?? defaults.rearmBelow,\n  };\n}\n\nexport interface DwellTick {\n  /** Dwell meter 0..1. */\n  progress: number;\n  /** Progress moved enough to be worth re-rendering (≥ 1%). */\n  changed: boolean;\n  /** The meter just completed - fire the synthesized press. */\n  fired: boolean;\n}\n\nexport class DwellState {\n  private progress = 0;\n  private lastReported = 0;\n  private armed = true;\n\n  update(hovered: boolean, dt: number, config: Required<DwellConfig>): DwellTick {\n    const before = this.progress;\n    if (hovered) {\n      this.progress = Math.min(1, this.progress + dt / config.holdSeconds);\n    } else {\n      this.progress = Math.max(\n        0,\n        this.progress - (dt * config.decayFactor) / config.holdSeconds,\n      );\n    }\n\n    let fired = false;\n    if (this.armed && this.progress >= 1) {\n      fired = true;\n      this.armed = false;\n      this.progress = 0;\n    } else if (!this.armed && this.progress <= config.rearmBelow) {\n      this.armed = true;\n    }\n\n    const changed =\n      Math.abs(this.progress - this.lastReported) >= 0.01 ||\n      (this.progress === 0 && before !== 0);\n    if (changed) this.lastReported = this.progress;\n    return { progress: this.progress, changed, fired };\n  }\n\n  getProgress(): number {\n    return this.progress;\n  }\n}\n"]}
+{"version":3,"file":"gaze.js","sourceRoot":"","sources":["../src/gaze.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Gaze support - first-class, per the design decision that gaze serves two\n * roles:\n *\n * 1. **Combination gating** (`gaze.required`): input on an interactable only\n *    counts while the viewer is looking at it.\n * 2. **Accessibility** (`gaze.dwell`): looking at an interactable fills a\n *    dwell meter; a full meter fires a synthesized press - no hands needed.\n *    Consumers render the meter from `dwellProgress` events.\n *\n * The dwell state machine is pure and headless-tested. The runtime feeds it\n * hover booleans; it never sees the engine.\n */\n\nimport type { RayTuple, Vec3Tuple } from \"@realitycollective/webxr-input\";\nimport type { InteractableHit } from \"./ports.js\";\n\nexport interface DwellConfig {\n  /** Seconds of sustained gaze to fire. */\n  holdSeconds?: number;\n  /** Drain speed multiplier when looking away. */\n  decayFactor?: number;\n  /** After firing, progress must fall below this before it can re-arm. */\n  rearmBelow?: number;\n}\n\nexport interface GazeConfig {\n  /** Non-gaze input on this interactable only counts while gazed at. */\n  required?: boolean;\n  /** Enable dwell-to-press. `true` uses defaults. */\n  dwell?: boolean | DwellConfig;\n}\n\nexport const DWELL_DEFAULTS: Required<DwellConfig> = {\n  holdSeconds: 1.8,\n  decayFactor: 2.5,\n  rearmBelow: 0.1,\n};\n\nexport function resolveDwellConfig(\n  config: boolean | DwellConfig | undefined,\n  defaults: Required<DwellConfig> = DWELL_DEFAULTS,\n): Required<DwellConfig> | null {\n  if (!config) return null;\n  if (config === true) return defaults;\n  return {\n    holdSeconds: config.holdSeconds ?? defaults.holdSeconds,\n    decayFactor: config.decayFactor ?? defaults.decayFactor,\n    rearmBelow: config.rearmBelow ?? defaults.rearmBelow,\n  };\n}\n\nexport interface DwellTick {\n  /** Dwell meter 0..1. */\n  progress: number;\n  /** Progress moved enough to be worth re-rendering (≥ 1%). */\n  changed: boolean;\n  /** The meter just completed - fire the synthesized press. */\n  fired: boolean;\n}\n\nexport class DwellState {\n  private progress = 0;\n  private lastReported = 0;\n  private armed = true;\n\n  update(hovered: boolean, dt: number, config: Required<DwellConfig>): DwellTick {\n    const before = this.progress;\n    if (hovered) {\n      this.progress = Math.min(1, this.progress + dt / config.holdSeconds);\n    } else {\n      this.progress = Math.max(\n        0,\n        this.progress - (dt * config.decayFactor) / config.holdSeconds,\n      );\n    }\n\n    let fired = false;\n    if (this.armed && this.progress >= 1) {\n      fired = true;\n      this.armed = false;\n      this.progress = 0;\n    } else if (!this.armed && this.progress <= config.rearmBelow) {\n      this.armed = true;\n    }\n\n    const changed =\n      Math.abs(this.progress - this.lastReported) >= 0.01 ||\n      (this.progress === 0 && before !== 0);\n    if (changed) this.lastReported = this.progress;\n    return { progress: this.progress, changed, fired };\n  }\n\n  getProgress(): number {\n    return this.progress;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Eye gaze: the targeting half of the rule `@realitycollective/webxr-input`'s\n// `eye-gaze.ts` states. IWSDK's `GazeConecaster` picks the frame's best\n// in-cone candidate and then holds a time-weighted vote over the dwell\n// window, so a flick across a neighbour does not steal hover.\n// ---------------------------------------------------------------------------\n\n\n/** Comparer tolerance: angular distances within this are \"the same\", and distance decides. IWSDK `ANGLE_EPSILON`. */\nexport const GAZE_CONE_ANGLE_EPSILON = 0.5 * (Math.PI / 180);\n\n/** A cone hit: {@link InteractableHit} plus how far off the gaze axis the target's silhouette sat, radians (0 when the ray itself hit). */\nexport interface GazeConeHit extends InteractableHit {\n  angularDistance: number;\n}\n\n/** A sphere target, as the approximate hit testers and the native host model one. */\nexport interface SphereTarget {\n  id: string;\n  center: Vec3Tuple;\n  radius: number;\n}\n\n/**\n * IWSDK's `GazeConecaster.findFrameBest` over sphere targets: the best\n * target inside a cone of `halfAngle` radians about `ray`, no farther than\n * `maxLength`. A sphere the ray passes through is hit where the ray enters\n * it, with an angular distance of 0. Otherwise the angle from the ray to the\n * sphere's silhouette (the angle to its centre less the angle it subtends)\n * must be within the cone, and the point aimed at is the point of the sphere\n * nearest the ray. Closer by angle wins; within {@link GAZE_CONE_ANGLE_EPSILON}\n * the nearer target wins. A sphere the origin is inside counts as on axis.\n */\nexport function coneHitForSpheres(\n  ray: RayTuple,\n  targets: Iterable<SphereTarget>,\n  halfAngle: number,\n  maxLength: number,\n): GazeConeHit | null {\n  const [ox, oy, oz] = ray.origin;\n  const [dx, dy, dz] = ray.direction;\n  let best: GazeConeHit | null = null;\n  for (const target of targets) {\n    const [cx, cy, cz] = target.center;\n    const r = target.radius;\n    const vx = cx - ox;\n    const vy = cy - oy;\n    const vz = cz - oz;\n    const dist = Math.hypot(vx, vy, vz);\n    if (dist - r > maxLength) continue;\n    let hit: GazeConeHit;\n    if (dist <= r) {\n      // The origin is inside the sphere: fully on axis, aimed at the centre.\n      hit = { interactableId: target.id, distance: dist, point: [cx, cy, cz], angularDistance: 0 };\n    } else {\n      const t = vx * dx + vy * dy + vz * dz;\n      const missSq = Math.max(0, dist * dist - t * t);\n      const miss = Math.sqrt(missSq);\n      if (t > 0 && miss <= r) {\n        // The ray enters the sphere: the raw ray wins, at the entry point.\n        const entry = t - Math.sqrt(r * r - missSq);\n        if (entry > maxLength) continue;\n        hit = {\n          interactableId: target.id,\n          distance: entry,\n          point: [ox + dx * entry, oy + dy * entry, oz + dz * entry],\n          angularDistance: 0,\n        };\n      } else {\n        const toCentre = Math.atan2(miss, t);\n        const angular = Math.max(0, toCentre - Math.asin(Math.min(1, r / dist)));\n        if (angular > halfAngle) continue;\n        // The point of the sphere nearest the ray: from the centre toward the\n        // ray's closest point (never behind the origin), out to the surface.\n        const tc = Math.max(0, t);\n        let nx = ox + dx * tc - cx;\n        let ny = oy + dy * tc - cy;\n        let nz = oz + dz * tc - cz;\n        const nl = Math.hypot(nx, ny, nz);\n        if (nl > 1e-9) {\n          nx /= nl;\n          ny /= nl;\n          nz /= nl;\n        } else {\n          nx = -vx / dist;\n          ny = -vy / dist;\n          nz = -vz / dist;\n        }\n        const point: Vec3Tuple = [cx + nx * r, cy + ny * r, cz + nz * r];\n        const distance = Math.hypot(point[0] - ox, point[1] - oy, point[2] - oz);\n        if (distance > maxLength) continue;\n        hit = { interactableId: target.id, distance, point, angularDistance: angular };\n      }\n    }\n    if (best === null || compareConeHits(hit, best) < 0) best = hit;\n  }\n  return best;\n}\n\n/** IWSDK's default comparer: closer by angle, then closer by distance. Negative when `a` is better. */\nexport function compareConeHits(a: GazeConeHit, b: GazeConeHit): number {\n  const dAngle = a.angularDistance - b.angularDistance;\n  if (Math.abs(dAngle) > GAZE_CONE_ANGLE_EPSILON) return dAngle;\n  return a.distance - b.distance;\n}\n\n/**\n * IWSDK's dwell consensus (`GazeConecaster.recordDwell` / `pruneDwell` /\n * `electDwellWinner` / `resolveDwellWinner`): each frame's best candidate is\n * recorded with its `dt`; samples older than the window are dropped; the\n * candidate with the largest cumulative `dt` inside the window wins. A winner\n * that is no longer available (unregistered, disabled, hidden) is struck\n * from the record and the next is elected. A window of 0 keeps only this\n * frame's sample, so the frame's best wins outright.\n */\nexport class GazeConsensus {\n  private readonly samples: Array<{ id: string; time: number; dt: number }> = [];\n  private time = 0;\n\n  constructor(public windowSeconds: number = 0.15) {}\n\n  /** Record this frame's best (or none), advance the window and elect. */\n  update(frameBestId: string | null, dt: number, available: (id: string) => boolean): string | null {\n    this.time += dt;\n    if (frameBestId !== null) this.samples.push({ id: frameBestId, time: this.time, dt });\n    this.prune();\n    for (;;) {\n      const elected = this.elect();\n      if (elected === null) return null;\n      if (available(elected)) return elected;\n      this.remove(elected);\n    }\n  }\n\n  /** Advance the window with nothing recorded (a frame gaze was suppressed or had no pose). */\n  skip(dt: number): void {\n    this.time += dt;\n  }\n\n  reset(): void {\n    this.samples.length = 0;\n  }\n\n  private prune(): void {\n    const cutoff = this.time - this.windowSeconds;\n    let drop = 0;\n    while (drop < this.samples.length && this.samples[drop]!.time < cutoff) drop += 1;\n    if (drop > 0) this.samples.splice(0, drop);\n  }\n\n  private elect(): string | null {\n    let bestId: string | null = null;\n    let bestDt = -1;\n    const sums = new Map<string, number>();\n    for (const sample of this.samples) sums.set(sample.id, (sums.get(sample.id) ?? 0) + sample.dt);\n    // First recorded wins a tie, as IWSDK's scan from the ring head does.\n    for (const sample of this.samples) {\n      const sum = sums.get(sample.id)!;\n      if (sum > bestDt) {\n        bestDt = sum;\n        bestId = sample.id;\n      }\n    }\n    return bestId;\n  }\n\n  private remove(id: string): void {\n    for (let i = this.samples.length - 1; i >= 0; i--) {\n      if (this.samples[i]!.id === id) this.samples.splice(i, 1);\n    }\n  }\n}\n"]}

package/dist/index.d.ts

@@ -25,6 +25,11 @@ export * from "./descriptor.js";
 export * from "./velocity-tracker.js";
 export * from "./runtime.js";
 export * from "./pointer-bridge.js";
+export * from "./near-pointer.js";
+export * from "./near-pointer-contract-cases.js";
+export * from "./physics.js";
+export * from "./physics-contract-cases.js";
+export * from "./memory-physics.js";
 export * from "./behaviours/behaviour.js";
 export * from "./behaviours/press.js";
 export * from "./behaviours/pulse.js";

package/dist/index.js

@@ -25,6 +25,11 @@ export * from "./descriptor.js";
 export * from "./velocity-tracker.js";
 export * from "./runtime.js";
 export * from "./pointer-bridge.js";
+export * from "./near-pointer.js";
+export * from "./near-pointer-contract-cases.js";
+export * from "./physics.js";
+export * from "./physics-contract-cases.js";
+export * from "./memory-physics.js";
 export * from "./behaviours/behaviour.js";
 export * from "./behaviours/press.js";
 export * from "./behaviours/pulse.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,cAAc,gCAAgC,CAAC;AAE/C,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AAEpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC","sourcesContent":["/**\n * @realitycollective/webxr-interactions - the engine-free interaction core.\n *\n * Layers (each strictly on the one below):\n *  - behaviours (press, pulse, hinge, dial, slide, grab, tossScore) -\n *    pure state machines driven by `update(dt)`;\n *  - the runtime/binder - targeting, press/grab transitions, gaze gating\n *    + dwell, capability negotiation, events, feedback intents;\n *  - the shared input contracts, re-exported from\n *    `@realitycollective/webxr-input`.\n *\n * Pair with an engine adapter: `@realitycollective/threejs-interactions`\n * (standalone WebXR + three.js), `@realitycollective/iwsdk-interactions`\n * (Meta IWSDK) or `@realitycollective/xrblocks-interactions` (Google XR\n * Blocks, experimental).\n */\nexport * from \"@realitycollective/webxr-input\";\n\nexport * from \"./math.js\";\nexport * from \"./events.js\";\nexport * from \"./feedback.js\";\nexport * from \"./ports.js\";\nexport * from \"./contract-cases.js\";\nexport * from \"./gaze.js\";\nexport * from \"./descriptor.js\";\nexport * from \"./velocity-tracker.js\";\nexport * from \"./runtime.js\";\nexport * from \"./pointer-bridge.js\";\n\nexport * from \"./behaviours/behaviour.js\";\nexport * from \"./behaviours/press.js\";\nexport * from \"./behaviours/pulse.js\";\nexport * from \"./behaviours/hinge.js\";\nexport * from \"./behaviours/dial.js\";\nexport * from \"./behaviours/slide.js\";\nexport * from \"./behaviours/grab.js\";\nexport * from \"./behaviours/toss-score.js\";\nexport * from \"./behaviours/factory.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,cAAc,gCAAgC,CAAC;AAE/C,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,kCAAkC,CAAC;AACjD,cAAc,cAAc,CAAC;AAC7B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AAEpC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC","sourcesContent":["/**\n * @realitycollective/webxr-interactions - the engine-free interaction core.\n *\n * Layers (each strictly on the one below):\n *  - behaviours (press, pulse, hinge, dial, slide, grab, tossScore) -\n *    pure state machines driven by `update(dt)`;\n *  - the runtime/binder - targeting, press/grab transitions, gaze gating\n *    + dwell, capability negotiation, events, feedback intents;\n *  - the shared input contracts, re-exported from\n *    `@realitycollective/webxr-input`.\n *\n * Pair with an engine adapter: `@realitycollective/threejs-interactions`\n * (standalone WebXR + three.js), `@realitycollective/iwsdk-interactions`\n * (Meta IWSDK) or `@realitycollective/xrblocks-interactions` (Google XR\n * Blocks, experimental).\n */\nexport * from \"@realitycollective/webxr-input\";\n\nexport * from \"./math.js\";\nexport * from \"./events.js\";\nexport * from \"./feedback.js\";\nexport * from \"./ports.js\";\nexport * from \"./contract-cases.js\";\nexport * from \"./gaze.js\";\nexport * from \"./descriptor.js\";\nexport * from \"./velocity-tracker.js\";\nexport * from \"./runtime.js\";\nexport * from \"./pointer-bridge.js\";\nexport * from \"./near-pointer.js\";\nexport * from \"./near-pointer-contract-cases.js\";\nexport * from \"./physics.js\";\nexport * from \"./physics-contract-cases.js\";\nexport * from \"./memory-physics.js\";\n\nexport * from \"./behaviours/behaviour.js\";\nexport * from \"./behaviours/press.js\";\nexport * from \"./behaviours/pulse.js\";\nexport * from \"./behaviours/hinge.js\";\nexport * from \"./behaviours/dial.js\";\nexport * from \"./behaviours/slide.js\";\nexport * from \"./behaviours/grab.js\";\nexport * from \"./behaviours/toss-score.js\";\nexport * from \"./behaviours/factory.js\";\n"]}

package/dist/memory-physics.d.ts

@@ -0,0 +1,41 @@
+/**
+ * MemoryPhysicsFacility - the family's in-memory reference physics: an
+ * engine-free `PhysicsFacility` that runs headlessly with the core defaults,
+ * so the contract suite has a correct subject to prove itself against and a
+ * new binding has a reference to compare with (the same idea as
+ * `MemoryInputProvider` in `@realitycollective/webxr-input`).
+ *
+ * It simulates exactly what the contract cases need and states its limits:
+ * gravity (with per-body factor and damping) integrated per step, spheres
+ * against axis-aligned static or kinematic boxes with restitution combined
+ * as the average of the two bodies (Rapier's default rule), and nothing
+ * else: no sphere-to-sphere contact, no friction dynamics, no rotation of
+ * boxes. It is not a game engine; a platform binding names a real one.
+ */
+import type { PoseTuple, Vec3Tuple } from "@realitycollective/webxr-input";
+import type { HoldRelease } from "./ports.js";
+import { type PhysicsBodySpec, type PhysicsBodyState, type PhysicsFacility, type PhysicsShapeSpec, type PhysicsVelocity } from "./physics.js";
+export declare class MemoryPhysicsFacility implements PhysicsFacility {
+    readonly engine: string;
+    private gravity;
+    private readonly bodies;
+    getGravity(): Vec3Tuple;
+    setGravity(gravity: Vec3Tuple): void;
+    addBody(id: string, pose: PoseTuple, body?: PhysicsBodySpec, shape?: PhysicsShapeSpec): void;
+    removeBody(id: string): void;
+    hasBody(id: string): boolean;
+    setBodyState(id: string, state: PhysicsBodyState): void;
+    getBodyState(id: string): PhysicsBodyState;
+    getBodyPose(id: string): PoseTuple;
+    setBodyPose(id: string, pose: PoseTuple): void;
+    getVelocity(id: string): PhysicsVelocity;
+    setVelocity(id: string, velocity: PhysicsVelocity): void;
+    suspend(id: string): void;
+    resume(id: string, release: HoldRelease): void;
+    isSuspended(id: string): boolean;
+    step(dtSeconds: number): void;
+    dispose(): void;
+    private body;
+    /** A moving sphere against every non-dynamic axis-aligned box: push out along the least-penetrated axis and reflect the normal velocity. */
+    private collideSphere;
+}

package/dist/memory-physics.js

@@ -0,0 +1,168 @@
+import { PHYSICS_DEFAULTS, missingBody, resolvePhysicsBody, resolvePhysicsShape, } from "./physics.js";
+function copy3(v) {
+    return [v[0], v[1], v[2]];
+}
+export class MemoryPhysicsFacility {
+    engine = "memory";
+    gravity = copy3(PHYSICS_DEFAULTS.gravity);
+    bodies = new Map();
+    getGravity() {
+        return copy3(this.gravity);
+    }
+    setGravity(gravity) {
+        this.gravity = copy3(gravity);
+    }
+    addBody(id, pose, body = {}, shape = {}) {
+        const spec = resolvePhysicsBody(body);
+        this.bodies.set(id, {
+            state: spec.state,
+            spec,
+            shape: resolvePhysicsShape(shape),
+            position: copy3(pose.position),
+            quaternion: [pose.quaternion[0], pose.quaternion[1], pose.quaternion[2], pose.quaternion[3]],
+            linear: [0, 0, 0],
+            angular: [0, 0, 0],
+            suspended: false,
+        });
+    }
+    removeBody(id) {
+        this.bodies.delete(id);
+    }
+    hasBody(id) {
+        return this.bodies.has(id);
+    }
+    setBodyState(id, state) {
+        const body = this.body(id);
+        body.state = state;
+        if (state !== "dynamic") {
+            body.linear = [0, 0, 0];
+            body.angular = [0, 0, 0];
+        }
+    }
+    getBodyState(id) {
+        return this.body(id).state;
+    }
+    getBodyPose(id) {
+        const body = this.body(id);
+        return { position: copy3(body.position), quaternion: [...body.quaternion] };
+    }
+    setBodyPose(id, pose) {
+        const body = this.body(id);
+        body.position = copy3(pose.position);
+        body.quaternion = [pose.quaternion[0], pose.quaternion[1], pose.quaternion[2], pose.quaternion[3]];
+        // A teleport rests the body; a write while held carries nothing either.
+        body.linear = [0, 0, 0];
+        body.angular = [0, 0, 0];
+    }
+    getVelocity(id) {
+        const body = this.body(id);
+        return { linear: copy3(body.linear), angular: copy3(body.angular) };
+    }
+    setVelocity(id, velocity) {
+        const body = this.body(id);
+        body.linear = copy3(velocity.linear);
+        body.angular = copy3(velocity.angular);
+    }
+    suspend(id) {
+        const body = this.body(id);
+        if (body.suspended)
+            return;
+        body.suspended = true;
+        body.linear = [0, 0, 0];
+        body.angular = [0, 0, 0];
+    }
+    resume(id, release) {
+        const body = this.body(id);
+        if (!body.suspended)
+            return;
+        body.suspended = false;
+        body.linear = copy3(release.linearVelocity);
+        body.angular = copy3(release.angularVelocity);
+    }
+    isSuspended(id) {
+        return this.body(id).suspended;
+    }
+    step(dtSeconds) {
+        if (dtSeconds <= 0)
+            return;
+        for (const body of this.bodies.values()) {
+            if (body.state !== "dynamic" || body.suspended)
+                continue;
+            const g = body.spec.gravityFactor;
+            body.linear[0] += this.gravity[0] * g * dtSeconds;
+            body.linear[1] += this.gravity[1] * g * dtSeconds;
+            body.linear[2] += this.gravity[2] * g * dtSeconds;
+            const linearKeep = Math.max(0, 1 - body.spec.linearDamping * dtSeconds);
+            const angularKeep = Math.max(0, 1 - body.spec.angularDamping * dtSeconds);
+            body.linear = [body.linear[0] * linearKeep, body.linear[1] * linearKeep, body.linear[2] * linearKeep];
+            body.angular = [body.angular[0] * angularKeep, body.angular[1] * angularKeep, body.angular[2] * angularKeep];
+            body.position = [
+                body.position[0] + body.linear[0] * dtSeconds,
+                body.position[1] + body.linear[1] * dtSeconds,
+                body.position[2] + body.linear[2] * dtSeconds,
+            ];
+            body.quaternion = integrateRotation(body.quaternion, body.angular, dtSeconds);
+            if (body.shape.kind === "sphere")
+                this.collideSphere(body);
+        }
+    }
+    dispose() {
+        this.bodies.clear();
+    }
+    body(id) {
+        const body = this.bodies.get(id);
+        if (!body)
+            throw missingBody(id);
+        return body;
+    }
+    /** A moving sphere against every non-dynamic axis-aligned box: push out along the least-penetrated axis and reflect the normal velocity. */
+    collideSphere(sphere) {
+        const radius = sphere.shape.dimensions[0];
+        for (const other of this.bodies.values()) {
+            if (other === sphere || other.shape.kind !== "box" || other.state === "dynamic")
+                continue;
+            const half = [other.shape.dimensions[0] / 2, other.shape.dimensions[1] / 2, other.shape.dimensions[2] / 2];
+            let bestAxis = -1;
+            let bestDepth = Number.POSITIVE_INFINITY;
+            let bestSign = 1;
+            for (let axis = 0; axis < 3; axis++) {
+                const delta = sphere.position[axis] - other.position[axis];
+                const depth = half[axis] + radius - Math.abs(delta);
+                if (depth <= 0) {
+                    bestAxis = -1;
+                    break;
+                }
+                if (depth < bestDepth) {
+                    bestDepth = depth;
+                    bestAxis = axis;
+                    bestSign = delta >= 0 ? 1 : -1;
+                }
+            }
+            if (bestAxis < 0)
+                continue;
+            sphere.position[bestAxis] = sphere.position[bestAxis] + bestSign * bestDepth;
+            const normalVelocity = sphere.linear[bestAxis] * bestSign;
+            if (normalVelocity < 0) {
+                const restitution = (sphere.shape.restitution + other.shape.restitution) / 2;
+                sphere.linear[bestAxis] = -normalVelocity * restitution * bestSign;
+            }
+        }
+    }
+}
+/** Advance a quaternion by an angular velocity (axis scaled by rad/s) over dt, first order. */
+function integrateRotation(q, angular, dt) {
+    const angle = Math.hypot(angular[0], angular[1], angular[2]) * dt;
+    if (angle < 1e-9)
+        return q;
+    const half = angle / 2;
+    const s = Math.sin(half) / (angle / dt) * dt;
+    const d = [angular[0] * s, angular[1] * s, angular[2] * s, Math.cos(half)];
+    // d * q
+    return [
+        d[3] * q[0] + d[0] * q[3] + d[1] * q[2] - d[2] * q[1],
+        d[3] * q[1] - d[0] * q[2] + d[1] * q[3] + d[2] * q[0],
+        d[3] * q[2] + d[0] * q[1] - d[1] * q[0] + d[2] * q[3],
+        d[3] * q[3] - d[0] * q[0] - d[1] * q[1] - d[2] * q[2],
+    ];
+}
+//# sourceMappingURL=memory-physics.js.map

package/dist/memory-physics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-physics.js","sourceRoot":"","sources":["../src/memory-physics.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * MemoryPhysicsFacility - the family's in-memory reference physics: an\n * engine-free `PhysicsFacility` that runs headlessly with the core defaults,\n * so the contract suite has a correct subject to prove itself against and a\n * new binding has a reference to compare with (the same idea as\n * `MemoryInputProvider` in `@realitycollective/webxr-input`).\n *\n * It simulates exactly what the contract cases need and states its limits:\n * gravity (with per-body factor and damping) integrated per step, spheres\n * against axis-aligned static or kinematic boxes with restitution combined\n * as the average of the two bodies (Rapier's default rule), and nothing\n * else: no sphere-to-sphere contact, no friction dynamics, no rotation of\n * boxes. It is not a game engine; a platform binding names a real one.\n */\nimport type { PoseTuple, QuatTuple, Vec3Tuple } from \"@realitycollective/webxr-input\";\nimport type { HoldRelease } from \"./ports.js\";\nimport {\n  PHYSICS_DEFAULTS,\n  missingBody,\n  resolvePhysicsBody,\n  resolvePhysicsShape,\n  type PhysicsBodySpec,\n  type PhysicsBodyState,\n  type PhysicsFacility,\n  type PhysicsShapeSpec,\n  type PhysicsVelocity,\n} from \"./physics.js\";\n\ninterface Body {\n  state: PhysicsBodyState;\n  spec: Required<PhysicsBodySpec>;\n  shape: Required<PhysicsShapeSpec>;\n  position: Vec3Tuple;\n  quaternion: QuatTuple;\n  linear: Vec3Tuple;\n  angular: Vec3Tuple;\n  suspended: boolean;\n}\n\nfunction copy3(v: Readonly<Vec3Tuple>): Vec3Tuple {\n  return [v[0], v[1], v[2]];\n}\n\nexport class MemoryPhysicsFacility implements PhysicsFacility {\n  readonly engine: string = \"memory\";\n  private gravity: Vec3Tuple = copy3(PHYSICS_DEFAULTS.gravity);\n  private readonly bodies = new Map<string, Body>();\n\n  getGravity(): Vec3Tuple {\n    return copy3(this.gravity);\n  }\n\n  setGravity(gravity: Vec3Tuple): void {\n    this.gravity = copy3(gravity);\n  }\n\n  addBody(id: string, pose: PoseTuple, body: PhysicsBodySpec = {}, shape: PhysicsShapeSpec = {}): void {\n    const spec = resolvePhysicsBody(body);\n    this.bodies.set(id, {\n      state: spec.state,\n      spec,\n      shape: resolvePhysicsShape(shape),\n      position: copy3(pose.position),\n      quaternion: [pose.quaternion[0], pose.quaternion[1], pose.quaternion[2], pose.quaternion[3]],\n      linear: [0, 0, 0],\n      angular: [0, 0, 0],\n      suspended: false,\n    });\n  }\n\n  removeBody(id: string): void {\n    this.bodies.delete(id);\n  }\n\n  hasBody(id: string): boolean {\n    return this.bodies.has(id);\n  }\n\n  setBodyState(id: string, state: PhysicsBodyState): void {\n    const body = this.body(id);\n    body.state = state;\n    if (state !== \"dynamic\") {\n      body.linear = [0, 0, 0];\n      body.angular = [0, 0, 0];\n    }\n  }\n\n  getBodyState(id: string): PhysicsBodyState {\n    return this.body(id).state;\n  }\n\n  getBodyPose(id: string): PoseTuple {\n    const body = this.body(id);\n    return { position: copy3(body.position), quaternion: [...body.quaternion] as QuatTuple };\n  }\n\n  setBodyPose(id: string, pose: PoseTuple): void {\n    const body = this.body(id);\n    body.position = copy3(pose.position);\n    body.quaternion = [pose.quaternion[0], pose.quaternion[1], pose.quaternion[2], pose.quaternion[3]];\n    // A teleport rests the body; a write while held carries nothing either.\n    body.linear = [0, 0, 0];\n    body.angular = [0, 0, 0];\n  }\n\n  getVelocity(id: string): PhysicsVelocity {\n    const body = this.body(id);\n    return { linear: copy3(body.linear), angular: copy3(body.angular) };\n  }\n\n  setVelocity(id: string, velocity: PhysicsVelocity): void {\n    const body = this.body(id);\n    body.linear = copy3(velocity.linear);\n    body.angular = copy3(velocity.angular);\n  }\n\n  suspend(id: string): void {\n    const body = this.body(id);\n    if (body.suspended) return;\n    body.suspended = true;\n    body.linear = [0, 0, 0];\n    body.angular = [0, 0, 0];\n  }\n\n  resume(id: string, release: HoldRelease): void {\n    const body = this.body(id);\n    if (!body.suspended) return;\n    body.suspended = false;\n    body.linear = copy3(release.linearVelocity);\n    body.angular = copy3(release.angularVelocity);\n  }\n\n  isSuspended(id: string): boolean {\n    return this.body(id).suspended;\n  }\n\n  step(dtSeconds: number): void {\n    if (dtSeconds <= 0) return;\n    for (const body of this.bodies.values()) {\n      if (body.state !== \"dynamic\" || body.suspended) continue;\n      const g = body.spec.gravityFactor;\n      body.linear[0] += this.gravity[0] * g * dtSeconds;\n      body.linear[1] += this.gravity[1] * g * dtSeconds;\n      body.linear[2] += this.gravity[2] * g * dtSeconds;\n      const linearKeep = Math.max(0, 1 - body.spec.linearDamping * dtSeconds);\n      const angularKeep = Math.max(0, 1 - body.spec.angularDamping * dtSeconds);\n      body.linear = [body.linear[0] * linearKeep, body.linear[1] * linearKeep, body.linear[2] * linearKeep];\n      body.angular = [body.angular[0] * angularKeep, body.angular[1] * angularKeep, body.angular[2] * angularKeep];\n      body.position = [\n        body.position[0] + body.linear[0] * dtSeconds,\n        body.position[1] + body.linear[1] * dtSeconds,\n        body.position[2] + body.linear[2] * dtSeconds,\n      ];\n      body.quaternion = integrateRotation(body.quaternion, body.angular, dtSeconds);\n      if (body.shape.kind === \"sphere\") this.collideSphere(body);\n    }\n  }\n\n  dispose(): void {\n    this.bodies.clear();\n  }\n\n  private body(id: string): Body {\n    const body = this.bodies.get(id);\n    if (!body) throw missingBody(id);\n    return body;\n  }\n\n  /** A moving sphere against every non-dynamic axis-aligned box: push out along the least-penetrated axis and reflect the normal velocity. */\n  private collideSphere(sphere: Body): void {\n    const radius = sphere.shape.dimensions[0];\n    for (const other of this.bodies.values()) {\n      if (other === sphere || other.shape.kind !== \"box\" || other.state === \"dynamic\") continue;\n      const half: Vec3Tuple = [other.shape.dimensions[0] / 2, other.shape.dimensions[1] / 2, other.shape.dimensions[2] / 2];\n      let bestAxis = -1;\n      let bestDepth = Number.POSITIVE_INFINITY;\n      let bestSign = 1;\n      for (let axis = 0; axis < 3; axis++) {\n        const delta = sphere.position[axis]! - other.position[axis]!;\n        const depth = half[axis]! + radius - Math.abs(delta);\n        if (depth <= 0) {\n          bestAxis = -1;\n          break;\n        }\n        if (depth < bestDepth) {\n          bestDepth = depth;\n          bestAxis = axis;\n          bestSign = delta >= 0 ? 1 : -1;\n        }\n      }\n      if (bestAxis < 0) continue;\n      sphere.position[bestAxis] = sphere.position[bestAxis]! + bestSign * bestDepth;\n      const normalVelocity = sphere.linear[bestAxis]! * bestSign;\n      if (normalVelocity < 0) {\n        const restitution = (sphere.shape.restitution + other.shape.restitution) / 2;\n        sphere.linear[bestAxis] = -normalVelocity * restitution * bestSign;\n      }\n    }\n  }\n}\n\n/** Advance a quaternion by an angular velocity (axis scaled by rad/s) over dt, first order. */\nfunction integrateRotation(q: QuatTuple, angular: Vec3Tuple, dt: number): QuatTuple {\n  const angle = Math.hypot(angular[0], angular[1], angular[2]) * dt;\n  if (angle < 1e-9) return q;\n  const half = angle / 2;\n  const s = Math.sin(half) / (angle / dt) * dt;\n  const d: QuatTuple = [angular[0] * s, angular[1] * s, angular[2] * s, Math.cos(half)];\n  // d * q\n  return [\n    d[3] * q[0] + d[0] * q[3] + d[1] * q[2] - d[2] * q[1],\n    d[3] * q[1] - d[0] * q[2] + d[1] * q[3] + d[2] * q[0],\n    d[3] * q[2] + d[0] * q[1] - d[1] * q[0] + d[2] * q[3],\n    d[3] * q[3] - d[0] * q[0] - d[1] * q[1] - d[2] * q[2],\n  ];\n}\n"]}

package/dist/near-pointer-contract-cases.d.ts

@@ -0,0 +1,16 @@
+import type { HitTesterContractSubject } from "./contract-cases.js";
+/** One check a binding's hit tester must pass under the near-pointer rule. */
+export interface NearPointerContractCase {
+    name: string;
+    run(subject: HitTesterContractSubject): void;
+}
+/**
+ * The shared near-pointer conformance suite. An adapter's test file:
+ *
+ * ```ts
+ * for (const contractCase of nearPointerContractCases()) {
+ *   it(contractCase.name, () => contractCase.run(makeSubject()));
+ * }
+ * ```
+ */
+export declare function nearPointerContractCases(): readonly NearPointerContractCase[];