@realitycollective/webxr-interactions 0.1.0-preview.0

package/dist/behaviours/press.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Press - a mechanical button. `driven`: the behaviour owns the transform,
+ * integrating an underdamped spring toward the logical target so the button
+ * visibly depresses, overshoots and settles (the pale-signal bounce).
+ * Supports momentary (default) and latching modes - latching is finally
+ * reachable from data, unlike the research prototype.
+ */
+import type { Vec3Tuple } from "@realitycollective/webxr-input";
+import type { Behaviour, BehaviourContext, InteractorInfo } from "./behaviour.js";
+export interface PressConfig {
+    kind: "press";
+    /** Local press axis; the button depresses along −axis. */
+    axis?: Vec3Tuple;
+    /** Full travel in meters. */
+    travel?: number;
+    /** Fraction of travel reached at full press. */
+    depthFraction?: number;
+    stiffness?: number;
+    damping?: number;
+    /** Latching: press toggles and holds; release is a no-op. */
+    latching?: boolean;
+}
+export declare class PressBehaviour implements Behaviour {
+    readonly kind = "press";
+    readonly ownership: "driven";
+    readonly requires: readonly [];
+    readonly requiresAnyOf: readonly [readonly ["rays", "pokes", "pointer2d", "gaze"]];
+    readonly grabbable = false;
+    private readonly axis;
+    private travel;
+    private depthFraction;
+    private stiffness;
+    private damping;
+    private readonly latching;
+    private target;
+    private latched;
+    private progress;
+    private velocity;
+    private lastEmitted;
+    private readonly spring;
+    constructor(config?: Omit<PressConfig, "kind">);
+    onPressStart(ctx: BehaviourContext, interactor: InteractorInfo): void;
+    onPressEnd(ctx: BehaviourContext, interactor: InteractorInfo): void;
+    update(ctx: BehaviourContext): void;
+    getValue(): number;
+    /** Latched state (latching mode). */
+    get isLatched(): boolean;
+    getTravel(): number;
+    setTravel(travel: number): void;
+    getDepthFraction(): number;
+    setDepthFraction(fraction: number): void;
+    getSpring(): {
+        stiffness: number;
+        damping: number;
+    };
+    setSpring(stiffness: number, damping: number): void;
+}

package/dist/behaviours/press.js

@@ -0,0 +1,109 @@
+import { springStep, vScale } from "../math.js";
+const VALUE_EPSILON = 1e-3;
+export class PressBehaviour {
+    kind = "press";
+    ownership = "driven";
+    requires = [];
+    requiresAnyOf = [["rays", "pokes", "pointer2d", "gaze"]];
+    grabbable = false;
+    axis;
+    travel;
+    depthFraction;
+    stiffness;
+    damping;
+    latching;
+    target = 0; // logical 0/1
+    latched = false;
+    progress = 0; // spring output 0..1
+    velocity = 0;
+    lastEmitted = -1;
+    spring = new Float32Array(2);
+    constructor(config = {}) {
+        this.axis = config.axis ?? [0, 1, 0];
+        this.travel = config.travel ?? 0.04;
+        this.depthFraction = config.depthFraction ?? 0.5;
+        this.stiffness = config.stiffness ?? 220;
+        this.damping = config.damping ?? 12;
+        this.latching = config.latching ?? false;
+    }
+    onPressStart(ctx, interactor) {
+        if (this.latching) {
+            this.latched = !this.latched;
+            this.target = this.latched ? 1 : 0;
+            ctx.emit({
+                type: this.latched ? "actuated" : "released",
+                behaviourKind: this.kind,
+                interactorId: interactor.id,
+                value: this.target,
+            });
+            ctx.feedback({
+                cue: this.latched ? "actuate" : "release",
+                behaviourKind: this.kind,
+                sourceId: interactor.id,
+                intensity: 0.8,
+                durationMs: 40,
+            });
+            return;
+        }
+        this.target = 1;
+        ctx.emit({ type: "actuated", behaviourKind: this.kind, interactorId: interactor.id, value: 1 });
+        ctx.feedback({
+            cue: "actuate",
+            behaviourKind: this.kind,
+            sourceId: interactor.id,
+            intensity: 0.8,
+            durationMs: 40,
+        });
+    }
+    onPressEnd(ctx, interactor) {
+        if (this.latching)
+            return;
+        this.target = 0;
+        ctx.emit({ type: "released", behaviourKind: this.kind, interactorId: interactor.id, value: 0 });
+        ctx.feedback({
+            cue: "release",
+            behaviourKind: this.kind,
+            sourceId: interactor.id,
+            intensity: 0.3,
+            durationMs: 20,
+        });
+    }
+    update(ctx) {
+        springStep(this.progress, this.velocity, this.target, this.stiffness, this.damping, ctx.dt, this.spring);
+        this.progress = this.spring[0] ?? 0;
+        this.velocity = this.spring[1] ?? 0;
+        ctx.transform?.setLocalOffset(vScale(this.axis, -this.travel * this.depthFraction * this.progress));
+        if (Math.abs(this.progress - this.lastEmitted) > VALUE_EPSILON) {
+            this.lastEmitted = this.progress;
+            ctx.emit({ type: "valueChanged", behaviourKind: this.kind, value: this.getValue() });
+        }
+    }
+    getValue() {
+        return this.target;
+    }
+    /** Latched state (latching mode). */
+    get isLatched() {
+        return this.latched;
+    }
+    // Live-tuning accessors (playground steppers).
+    getTravel() {
+        return this.travel;
+    }
+    setTravel(travel) {
+        this.travel = travel;
+    }
+    getDepthFraction() {
+        return this.depthFraction;
+    }
+    setDepthFraction(fraction) {
+        this.depthFraction = fraction;
+    }
+    getSpring() {
+        return { stiffness: this.stiffness, damping: this.damping };
+    }
+    setSpring(stiffness, damping) {
+        this.stiffness = stiffness;
+        this.damping = damping;
+    }
+}
+//# sourceMappingURL=press.js.map

package/dist/behaviours/press.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"press.js","sourceRoot":"","sources":["../../src/behaviours/press.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Press - a mechanical button. `driven`: the behaviour owns the transform,\n * integrating an underdamped spring toward the logical target so the button\n * visibly depresses, overshoots and settles (the pale-signal bounce).\n * Supports momentary (default) and latching modes - latching is finally\n * reachable from data, unlike the research prototype.\n */\nimport type { Vec3Tuple } from \"@realitycollective/webxr-input\";\nimport { springStep, vScale } from \"../math.js\";\nimport type { Behaviour, BehaviourContext, InteractorInfo } from \"./behaviour.js\";\n\nexport interface PressConfig {\n  kind: \"press\";\n  /** Local press axis; the button depresses along −axis. */\n  axis?: Vec3Tuple;\n  /** Full travel in meters. */\n  travel?: number;\n  /** Fraction of travel reached at full press. */\n  depthFraction?: number;\n  stiffness?: number;\n  damping?: number;\n  /** Latching: press toggles and holds; release is a no-op. */\n  latching?: boolean;\n}\n\nconst VALUE_EPSILON = 1e-3;\n\nexport class PressBehaviour implements Behaviour {\n  readonly kind = \"press\";\n  readonly ownership = \"driven\" as const;\n  readonly requires = [] as const;\n  readonly requiresAnyOf = [[\"rays\", \"pokes\", \"pointer2d\", \"gaze\"]] as const;\n  readonly grabbable = false;\n\n  private readonly axis: Vec3Tuple;\n  private travel: number;\n  private depthFraction: number;\n  private stiffness: number;\n  private damping: number;\n  private readonly latching: boolean;\n\n  private target = 0; // logical 0/1\n  private latched = false;\n  private progress = 0; // spring output 0..1\n  private velocity = 0;\n  private lastEmitted = -1;\n  private readonly spring = new Float32Array(2);\n\n  constructor(config: Omit<PressConfig, \"kind\"> = {}) {\n    this.axis = config.axis ?? [0, 1, 0];\n    this.travel = config.travel ?? 0.04;\n    this.depthFraction = config.depthFraction ?? 0.5;\n    this.stiffness = config.stiffness ?? 220;\n    this.damping = config.damping ?? 12;\n    this.latching = config.latching ?? false;\n  }\n\n  onPressStart(ctx: BehaviourContext, interactor: InteractorInfo): void {\n    if (this.latching) {\n      this.latched = !this.latched;\n      this.target = this.latched ? 1 : 0;\n      ctx.emit({\n        type: this.latched ? \"actuated\" : \"released\",\n        behaviourKind: this.kind,\n        interactorId: interactor.id,\n        value: this.target,\n      });\n      ctx.feedback({\n        cue: this.latched ? \"actuate\" : \"release\",\n        behaviourKind: this.kind,\n        sourceId: interactor.id,\n        intensity: 0.8,\n        durationMs: 40,\n      });\n      return;\n    }\n    this.target = 1;\n    ctx.emit({ type: \"actuated\", behaviourKind: this.kind, interactorId: interactor.id, value: 1 });\n    ctx.feedback({\n      cue: \"actuate\",\n      behaviourKind: this.kind,\n      sourceId: interactor.id,\n      intensity: 0.8,\n      durationMs: 40,\n    });\n  }\n\n  onPressEnd(ctx: BehaviourContext, interactor: InteractorInfo): void {\n    if (this.latching) return;\n    this.target = 0;\n    ctx.emit({ type: \"released\", behaviourKind: this.kind, interactorId: interactor.id, value: 0 });\n    ctx.feedback({\n      cue: \"release\",\n      behaviourKind: this.kind,\n      sourceId: interactor.id,\n      intensity: 0.3,\n      durationMs: 20,\n    });\n  }\n\n  update(ctx: BehaviourContext): void {\n    springStep(\n      this.progress,\n      this.velocity,\n      this.target,\n      this.stiffness,\n      this.damping,\n      ctx.dt,\n      this.spring,\n    );\n    this.progress = this.spring[0] ?? 0;\n    this.velocity = this.spring[1] ?? 0;\n    ctx.transform?.setLocalOffset(\n      vScale(this.axis, -this.travel * this.depthFraction * this.progress),\n    );\n    if (Math.abs(this.progress - this.lastEmitted) > VALUE_EPSILON) {\n      this.lastEmitted = this.progress;\n      ctx.emit({ type: \"valueChanged\", behaviourKind: this.kind, value: this.getValue() });\n    }\n  }\n\n  getValue(): number {\n    return this.target;\n  }\n\n  /** Latched state (latching mode). */\n  get isLatched(): boolean {\n    return this.latched;\n  }\n\n  // Live-tuning accessors (playground steppers).\n  getTravel(): number {\n    return this.travel;\n  }\n  setTravel(travel: number): void {\n    this.travel = travel;\n  }\n  getDepthFraction(): number {\n    return this.depthFraction;\n  }\n  setDepthFraction(fraction: number): void {\n    this.depthFraction = fraction;\n  }\n  getSpring(): { stiffness: number; damping: number } {\n    return { stiffness: this.stiffness, damping: this.damping };\n  }\n  setSpring(stiffness: number, damping: number): void {\n    this.stiffness = stiffness;\n    this.damping = damping;\n  }\n}\n"]}

package/dist/behaviours/pulse.d.ts

@@ -0,0 +1,21 @@
+import type { Behaviour, BehaviourContext, InteractorInfo } from "./behaviour.js";
+export interface PulseConfig {
+    kind: "pulse";
+    scaleAmount?: number;
+    emissiveAmount?: number;
+    decayRate?: number;
+}
+export declare class PulseBehaviour implements Behaviour {
+    readonly kind = "pulse";
+    readonly ownership: "driven";
+    readonly requires: readonly [];
+    readonly grabbable = false;
+    private readonly scaleAmount;
+    private readonly emissiveAmount;
+    private readonly decayRate;
+    private level;
+    constructor(config?: Omit<PulseConfig, "kind">);
+    onPressStart(_ctx: BehaviourContext, _interactor: InteractorInfo): void;
+    update(ctx: BehaviourContext): void;
+    getValue(): number;
+}

package/dist/behaviours/pulse.js

@@ -0,0 +1,37 @@
+/**
+ * Pulse - an additive press effect: a decaying scale + emissive flash on
+ * actuation. Composes with any motion behaviour on the same interactable
+ * (multiple behaviours per object, the pale-signal beacon pattern).
+ */
+import { decay } from "../math.js";
+export class PulseBehaviour {
+    kind = "pulse";
+    ownership = "driven";
+    requires = [];
+    grabbable = false;
+    scaleAmount;
+    emissiveAmount;
+    decayRate;
+    level = 0;
+    constructor(config = {}) {
+        this.scaleAmount = config.scaleAmount ?? 0.25;
+        this.emissiveAmount = config.emissiveAmount ?? 1.5;
+        this.decayRate = config.decayRate ?? 6;
+    }
+    onPressStart(_ctx, _interactor) {
+        this.level = 1;
+    }
+    update(ctx) {
+        if (this.level === 0)
+            return;
+        this.level = decay(this.level, this.decayRate, ctx.dt);
+        ctx.transform?.setEffect?.({
+            scale: 1 + this.scaleAmount * this.level,
+            emissive: this.emissiveAmount * this.level,
+        });
+    }
+    getValue() {
+        return this.level;
+    }
+}
+//# sourceMappingURL=pulse.js.map

package/dist/behaviours/pulse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulse.js","sourceRoot":"","sources":["../../src/behaviours/pulse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAUnC,MAAM,OAAO,cAAc;IAChB,IAAI,GAAG,OAAO,CAAC;IACf,SAAS,GAAG,QAAiB,CAAC;IAC9B,QAAQ,GAAG,EAAW,CAAC;IACvB,SAAS,GAAG,KAAK,CAAC;IAEV,WAAW,CAAS;IACpB,cAAc,CAAS;IACvB,SAAS,CAAS;IAC3B,KAAK,GAAG,CAAC,CAAC;IAElB,YAAY,SAAoC,EAAE;QAChD,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,IAAI,CAAC;QAC9C,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,GAAG,CAAC;QACnD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,YAAY,CAAC,IAAsB,EAAE,WAA2B;QAC9D,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,GAAqB;QAC1B,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC;YAAE,OAAO;QAC7B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACvD,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,CAAC;YACzB,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK;YACxC,QAAQ,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,KAAK;SAC3C,CAAC,CAAC;IACL,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF","sourcesContent":["/**\n * Pulse - an additive press effect: a decaying scale + emissive flash on\n * actuation. Composes with any motion behaviour on the same interactable\n * (multiple behaviours per object, the pale-signal beacon pattern).\n */\nimport { decay } from \"../math.js\";\nimport type { Behaviour, BehaviourContext, InteractorInfo } from \"./behaviour.js\";\n\nexport interface PulseConfig {\n  kind: \"pulse\";\n  scaleAmount?: number;\n  emissiveAmount?: number;\n  decayRate?: number;\n}\n\nexport class PulseBehaviour implements Behaviour {\n  readonly kind = \"pulse\";\n  readonly ownership = \"driven\" as const;\n  readonly requires = [] as const;\n  readonly grabbable = false;\n\n  private readonly scaleAmount: number;\n  private readonly emissiveAmount: number;\n  private readonly decayRate: number;\n  private level = 0;\n\n  constructor(config: Omit<PulseConfig, \"kind\"> = {}) {\n    this.scaleAmount = config.scaleAmount ?? 0.25;\n    this.emissiveAmount = config.emissiveAmount ?? 1.5;\n    this.decayRate = config.decayRate ?? 6;\n  }\n\n  onPressStart(_ctx: BehaviourContext, _interactor: InteractorInfo): void {\n    this.level = 1;\n  }\n\n  update(ctx: BehaviourContext): void {\n    if (this.level === 0) return;\n    this.level = decay(this.level, this.decayRate, ctx.dt);\n    ctx.transform?.setEffect?.({\n      scale: 1 + this.scaleAmount * this.level,\n      emissive: this.emissiveAmount * this.level,\n    });\n  }\n\n  getValue(): number {\n    return this.level;\n  }\n}\n"]}

package/dist/behaviours/slide.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Slide - a pulley/handle pulled along one local axis. `handDriven` while
+ * held (the pull follows the hand's displacement along −axis), `driven`
+ * on release: a spring returns the handle home while the value keeps
+ * publishing. Value = pull / travel.
+ */
+import type { Vec3Tuple } from "@realitycollective/webxr-input";
+import { type Behaviour, type BehaviourContext, type InteractorInfo } from "./behaviour.js";
+export interface SlideConfig {
+    kind: "slide";
+    /** Local rail axis; the handle is pulled along −axis. */
+    axis?: Vec3Tuple;
+    /** Full pull travel in meters. */
+    travel?: number;
+    stiffness?: number;
+    damping?: number;
+}
+export declare class SlideBehaviour implements Behaviour {
+    readonly kind = "slide";
+    readonly ownership: "handDriven";
+    readonly requires: readonly ["grabs"];
+    readonly grabbable = true;
+    private readonly axis;
+    private travel;
+    private stiffness;
+    private damping;
+    private pull;
+    private velocity;
+    private pullAtGrab;
+    private handAlongAtGrab;
+    private held;
+    private lastEmitted;
+    private readonly spring;
+    constructor(config?: Omit<SlideConfig, "kind">);
+    private handAlong;
+    onGrabStart(ctx: BehaviourContext, interactor: InteractorInfo): void;
+    onGrabEnd(ctx: BehaviourContext, interactor: InteractorInfo): void;
+    update(ctx: BehaviourContext, holder?: InteractorInfo): void;
+    getValue(): number;
+    setTravel(travel: number): void;
+    getTravel(): number;
+    setSpring(stiffness: number, damping: number): void;
+    getSpring(): {
+        stiffness: number;
+        damping: number;
+    };
+}

package/dist/behaviours/slide.js

@@ -0,0 +1,104 @@
+import { springStep, vDot, vScale, worldToLocal } from "../math.js";
+import { holderPoint } from "./behaviour.js";
+const VALUE_EPSILON = 1e-3;
+export class SlideBehaviour {
+    kind = "slide";
+    ownership = "handDriven";
+    requires = ["grabs"];
+    grabbable = true;
+    axis;
+    travel;
+    stiffness;
+    damping;
+    pull = 0; // meters along −axis, 0..travel
+    velocity = 0;
+    pullAtGrab = 0;
+    handAlongAtGrab = 0;
+    held = false;
+    lastEmitted = -1;
+    spring = new Float32Array(2);
+    constructor(config = {}) {
+        this.axis = config.axis ?? [0, 1, 0];
+        this.travel = config.travel ?? 0.3;
+        this.stiffness = config.stiffness ?? 180;
+        this.damping = config.damping ?? 14;
+    }
+    handAlong(ctx, holder) {
+        const hand = holderPoint(holder);
+        const transform = ctx.transform;
+        if (!hand || !transform)
+            return null;
+        const rest = transform.getWorldPose();
+        const local = worldToLocal(hand, rest.position, rest.quaternion);
+        // Pull is measured along −axis.
+        return -vDot(local, this.axis);
+    }
+    onGrabStart(ctx, interactor) {
+        this.held = true;
+        this.pullAtGrab = this.pull;
+        this.handAlongAtGrab = this.handAlong(ctx, interactor) ?? 0;
+        this.velocity = 0;
+        ctx.emit({ type: "grabStart", behaviourKind: this.kind, interactorId: interactor.id });
+        ctx.feedback({
+            cue: "grab",
+            behaviourKind: this.kind,
+            sourceId: interactor.id,
+            intensity: 0.4,
+            durationMs: 25,
+        });
+    }
+    onGrabEnd(ctx, interactor) {
+        this.held = false;
+        ctx.emit({ type: "grabEnd", behaviourKind: this.kind, interactorId: interactor.id });
+        ctx.feedback({
+            cue: "drop",
+            behaviourKind: this.kind,
+            sourceId: interactor.id,
+            intensity: 0.2,
+            durationMs: 15,
+        });
+    }
+    update(ctx, holder) {
+        if (this.held && holder) {
+            const along = this.handAlong(ctx, holder);
+            if (along !== null) {
+                const next = this.pullAtGrab + (along - this.handAlongAtGrab);
+                this.pull = Math.min(this.travel, Math.max(0, next));
+            }
+        }
+        else if (this.pull > 0 || Math.abs(this.velocity) > 1e-4) {
+            springStep(this.pull, this.velocity, 0, this.stiffness, this.damping, ctx.dt, this.spring);
+            this.pull = Math.max(0, this.spring[0] ?? 0);
+            this.velocity = this.spring[1] ?? 0;
+            if (this.pull < 1e-4 && Math.abs(this.velocity) < 1e-3) {
+                this.pull = 0;
+                this.velocity = 0;
+            }
+        }
+        ctx.transform?.setLocalOffset(vScale(this.axis, -this.pull));
+        const value = this.getValue();
+        if (Math.abs(value - this.lastEmitted) > VALUE_EPSILON) {
+            this.lastEmitted = value;
+            ctx.emit({ type: "valueChanged", behaviourKind: this.kind, value });
+        }
+    }
+    getValue() {
+        return this.travel < 1e-9 ? 0 : Math.min(1, this.pull / this.travel);
+    }
+    setTravel(travel) {
+        this.travel = travel;
+        if (this.pull > travel)
+            this.pull = travel;
+    }
+    getTravel() {
+        return this.travel;
+    }
+    setSpring(stiffness, damping) {
+        this.stiffness = stiffness;
+        this.damping = damping;
+    }
+    getSpring() {
+        return { stiffness: this.stiffness, damping: this.damping };
+    }
+}
+//# sourceMappingURL=slide.js.map

package/dist/behaviours/slide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slide.js","sourceRoot":"","sources":["../../src/behaviours/slide.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Slide - a pulley/handle pulled along one local axis. `handDriven` while\n * held (the pull follows the hand's displacement along −axis), `driven`\n * on release: a spring returns the handle home while the value keeps\n * publishing. Value = pull / travel.\n */\nimport type { Vec3Tuple } from \"@realitycollective/webxr-input\";\nimport { springStep, vDot, vScale, worldToLocal } from \"../math.js\";\nimport { holderPoint, type Behaviour, type BehaviourContext, type InteractorInfo } from \"./behaviour.js\";\n\nexport interface SlideConfig {\n  kind: \"slide\";\n  /** Local rail axis; the handle is pulled along −axis. */\n  axis?: Vec3Tuple;\n  /** Full pull travel in meters. */\n  travel?: number;\n  stiffness?: number;\n  damping?: number;\n}\n\nconst VALUE_EPSILON = 1e-3;\n\nexport class SlideBehaviour implements Behaviour {\n  readonly kind = \"slide\";\n  readonly ownership = \"handDriven\" as const;\n  readonly requires = [\"grabs\"] as const;\n  readonly grabbable = true;\n\n  private readonly axis: Vec3Tuple;\n  private travel: number;\n  private stiffness: number;\n  private damping: number;\n\n  private pull = 0; // meters along −axis, 0..travel\n  private velocity = 0;\n  private pullAtGrab = 0;\n  private handAlongAtGrab = 0;\n  private held = false;\n  private lastEmitted = -1;\n  private readonly spring = new Float32Array(2);\n\n  constructor(config: Omit<SlideConfig, \"kind\"> = {}) {\n    this.axis = config.axis ?? [0, 1, 0];\n    this.travel = config.travel ?? 0.3;\n    this.stiffness = config.stiffness ?? 180;\n    this.damping = config.damping ?? 14;\n  }\n\n  private handAlong(ctx: BehaviourContext, holder: InteractorInfo): number | null {\n    const hand = holderPoint(holder);\n    const transform = ctx.transform;\n    if (!hand || !transform) return null;\n    const rest = transform.getWorldPose();\n    const local = worldToLocal(hand, rest.position, rest.quaternion);\n    // Pull is measured along −axis.\n    return -vDot(local, this.axis);\n  }\n\n  onGrabStart(ctx: BehaviourContext, interactor: InteractorInfo): void {\n    this.held = true;\n    this.pullAtGrab = this.pull;\n    this.handAlongAtGrab = this.handAlong(ctx, interactor) ?? 0;\n    this.velocity = 0;\n    ctx.emit({ type: \"grabStart\", behaviourKind: this.kind, interactorId: interactor.id });\n    ctx.feedback({\n      cue: \"grab\",\n      behaviourKind: this.kind,\n      sourceId: interactor.id,\n      intensity: 0.4,\n      durationMs: 25,\n    });\n  }\n\n  onGrabEnd(ctx: BehaviourContext, interactor: InteractorInfo): void {\n    this.held = false;\n    ctx.emit({ type: \"grabEnd\", behaviourKind: this.kind, interactorId: interactor.id });\n    ctx.feedback({\n      cue: \"drop\",\n      behaviourKind: this.kind,\n      sourceId: interactor.id,\n      intensity: 0.2,\n      durationMs: 15,\n    });\n  }\n\n  update(ctx: BehaviourContext, holder?: InteractorInfo): void {\n    if (this.held && holder) {\n      const along = this.handAlong(ctx, holder);\n      if (along !== null) {\n        const next = this.pullAtGrab + (along - this.handAlongAtGrab);\n        this.pull = Math.min(this.travel, Math.max(0, next));\n      }\n    } else if (this.pull > 0 || Math.abs(this.velocity) > 1e-4) {\n      springStep(this.pull, this.velocity, 0, this.stiffness, this.damping, ctx.dt, this.spring);\n      this.pull = Math.max(0, this.spring[0] ?? 0);\n      this.velocity = this.spring[1] ?? 0;\n      if (this.pull < 1e-4 && Math.abs(this.velocity) < 1e-3) {\n        this.pull = 0;\n        this.velocity = 0;\n      }\n    }\n    ctx.transform?.setLocalOffset(vScale(this.axis, -this.pull));\n    const value = this.getValue();\n    if (Math.abs(value - this.lastEmitted) > VALUE_EPSILON) {\n      this.lastEmitted = value;\n      ctx.emit({ type: \"valueChanged\", behaviourKind: this.kind, value });\n    }\n  }\n\n  getValue(): number {\n    return this.travel < 1e-9 ? 0 : Math.min(1, this.pull / this.travel);\n  }\n\n  setTravel(travel: number): void {\n    this.travel = travel;\n    if (this.pull > travel) this.pull = travel;\n  }\n\n  getTravel(): number {\n    return this.travel;\n  }\n\n  setSpring(stiffness: number, damping: number): void {\n    this.stiffness = stiffness;\n    this.damping = damping;\n  }\n\n  getSpring(): { stiffness: number; damping: number } {\n    return { stiffness: this.stiffness, damping: this.damping };\n  }\n}\n"]}

package/dist/behaviours/toss-score.d.ts

@@ -0,0 +1,33 @@
+/**
+ * TossScore - attach to a hoop/goal; scores registered target objects that
+ * pass through its plane in the scoring direction. Scoring is geometric
+ * and engine-free; how the object gets thrown (native physics, poseOnly
+ * carry + client ballistics) is not this behaviour's concern.
+ */
+import type { Vec3Tuple } from "@realitycollective/webxr-input";
+import type { Behaviour, BehaviourContext } from "./behaviour.js";
+export interface TossScoreConfig {
+    kind: "tossScore";
+    /** Interactable ids of the objects that can score. */
+    targetIds: string[];
+    /** Ring radius in meters. */
+    radius?: number;
+    /** Hoop plane normal (local "up" of the ring). */
+    axis?: Vec3Tuple;
+}
+export declare class TossScoreBehaviour implements Behaviour {
+    readonly kind = "tossScore";
+    readonly ownership: "driven";
+    readonly requires: readonly [];
+    readonly grabbable = false;
+    private readonly targetIds;
+    private radius;
+    private readonly axis;
+    private readonly prevAlong;
+    private scoredCount;
+    constructor(config: Omit<TossScoreConfig, "kind">);
+    update(ctx: BehaviourContext): void;
+    getValue(): number;
+    setRadius(radius: number): void;
+    getRadius(): number;
+}

package/dist/behaviours/toss-score.js

@@ -0,0 +1,58 @@
+import { passedThroughHoop, vDot, vSub } from "../math.js";
+export class TossScoreBehaviour {
+    kind = "tossScore";
+    ownership = "driven";
+    requires = [];
+    grabbable = false;
+    targetIds;
+    radius;
+    axis;
+    prevAlong = new Map();
+    scoredCount = 0;
+    constructor(config) {
+        this.targetIds = [...config.targetIds];
+        this.radius = config.radius ?? 0.2;
+        this.axis = config.axis ?? [0, 1, 0];
+    }
+    update(ctx) {
+        const transform = ctx.transform;
+        if (!transform)
+            return;
+        const hoop = transform.getWorldPose();
+        for (const targetId of this.targetIds) {
+            const target = ctx.getWorldPose(targetId);
+            if (!target)
+                continue;
+            const offset = vSub(target.position, hoop.position);
+            const along = vDot(offset, this.axis);
+            const radialVec = vSub(offset, [
+                this.axis[0] * along,
+                this.axis[1] * along,
+                this.axis[2] * along,
+            ]);
+            const radial = Math.hypot(radialVec[0], radialVec[1], radialVec[2]);
+            const prev = this.prevAlong.get(targetId);
+            if (prev !== undefined && passedThroughHoop(prev, along, 0, radial, this.radius)) {
+                this.scoredCount += 1;
+                ctx.emit({ type: "scored", behaviourKind: this.kind, value: this.scoredCount });
+                ctx.feedback({
+                    cue: "score",
+                    behaviourKind: this.kind,
+                    intensity: 1,
+                    durationMs: 60,
+                });
+            }
+            this.prevAlong.set(targetId, along);
+        }
+    }
+    getValue() {
+        return this.scoredCount;
+    }
+    setRadius(radius) {
+        this.radius = radius;
+    }
+    getRadius() {
+        return this.radius;
+    }
+}
+//# sourceMappingURL=toss-score.js.map

package/dist/behaviours/toss-score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toss-score.js","sourceRoot":"","sources":["../../src/behaviours/toss-score.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * TossScore - attach to a hoop/goal; scores registered target objects that\n * pass through its plane in the scoring direction. Scoring is geometric\n * and engine-free; how the object gets thrown (native physics, poseOnly\n * carry + client ballistics) is not this behaviour's concern.\n */\nimport type { Vec3Tuple } from \"@realitycollective/webxr-input\";\nimport { passedThroughHoop, vDot, vSub } from \"../math.js\";\nimport type { Behaviour, BehaviourContext } from \"./behaviour.js\";\n\nexport interface TossScoreConfig {\n  kind: \"tossScore\";\n  /** Interactable ids of the objects that can score. */\n  targetIds: string[];\n  /** Ring radius in meters. */\n  radius?: number;\n  /** Hoop plane normal (local \"up\" of the ring). */\n  axis?: Vec3Tuple;\n}\n\nexport class TossScoreBehaviour implements Behaviour {\n  readonly kind = \"tossScore\";\n  readonly ownership = \"driven\" as const;\n  readonly requires = [] as const;\n  readonly grabbable = false;\n\n  private readonly targetIds: string[];\n  private radius: number;\n  private readonly axis: Vec3Tuple;\n  private readonly prevAlong = new Map<string, number>();\n  private scoredCount = 0;\n\n  constructor(config: Omit<TossScoreConfig, \"kind\">) {\n    this.targetIds = [...config.targetIds];\n    this.radius = config.radius ?? 0.2;\n    this.axis = config.axis ?? [0, 1, 0];\n  }\n\n  update(ctx: BehaviourContext): void {\n    const transform = ctx.transform;\n    if (!transform) return;\n    const hoop = transform.getWorldPose();\n    for (const targetId of this.targetIds) {\n      const target = ctx.getWorldPose(targetId);\n      if (!target) continue;\n      const offset = vSub(target.position, hoop.position);\n      const along = vDot(offset, this.axis);\n      const radialVec = vSub(offset, [\n        this.axis[0] * along,\n        this.axis[1] * along,\n        this.axis[2] * along,\n      ]);\n      const radial = Math.hypot(radialVec[0], radialVec[1], radialVec[2]);\n      const prev = this.prevAlong.get(targetId);\n      if (prev !== undefined && passedThroughHoop(prev, along, 0, radial, this.radius)) {\n        this.scoredCount += 1;\n        ctx.emit({ type: \"scored\", behaviourKind: this.kind, value: this.scoredCount });\n        ctx.feedback({\n          cue: \"score\",\n          behaviourKind: this.kind,\n          intensity: 1,\n          durationMs: 60,\n        });\n      }\n      this.prevAlong.set(targetId, along);\n    }\n  }\n\n  getValue(): number {\n    return this.scoredCount;\n  }\n\n  setRadius(radius: number): void {\n    this.radius = radius;\n  }\n\n  getRadius(): number {\n    return this.radius;\n  }\n}\n"]}

package/dist/descriptor.d.ts

@@ -0,0 +1,21 @@
+/**
+ * InteractionDescriptor - the portable scene-interaction format. Plain
+ * JSON-able data: which interactables exist, which behaviours they carry
+ * (with tuning), and their gaze policy. Every adapter builds the SAME
+ * playground from the same descriptor - the portability proof inherited
+ * from the UI Extensions' SceneDescriptor.
+ */
+import type { BehaviourConfig } from "./behaviours/factory.js";
+import type { GazeConfig } from "./gaze.js";
+export interface InteractableDescriptor {
+    id: string;
+    behaviours: BehaviourConfig[];
+    gaze?: GazeConfig;
+    /** Registered disabled when false (enable later via the runtime). */
+    enabled?: boolean;
+    /** Poke/proximity trigger radius in meters (default 0.05). */
+    pokeRadius?: number;
+}
+export interface InteractionDescriptor {
+    interactables: InteractableDescriptor[];
+}

package/dist/descriptor.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=descriptor.js.map

package/dist/descriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.js","sourceRoot":"","sources":["../src/descriptor.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * InteractionDescriptor - the portable scene-interaction format. Plain\n * JSON-able data: which interactables exist, which behaviours they carry\n * (with tuning), and their gaze policy. Every adapter builds the SAME\n * playground from the same descriptor - the portability proof inherited\n * from the UI Extensions' SceneDescriptor.\n */\nimport type { BehaviourConfig } from \"./behaviours/factory.js\";\nimport type { GazeConfig } from \"./gaze.js\";\n\nexport interface InteractableDescriptor {\n  id: string;\n  behaviours: BehaviourConfig[];\n  gaze?: GazeConfig;\n  /** Registered disabled when false (enable later via the runtime). */\n  enabled?: boolean;\n  /** Poke/proximity trigger radius in meters (default 0.05). */\n  pokeRadius?: number;\n}\n\nexport interface InteractionDescriptor {\n  interactables: InteractableDescriptor[];\n}\n"]}

package/dist/events.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Interaction events - THE only outbound pathway from the interaction core.
+ *
+ * The Pale Signal research showed what happens when events are optional:
+ * consumers bypass them and subscribe to raw engine tags, and the same
+ * input ends up with two independent listeners. Here, adapters feed input
+ * IN through `@realitycollective/webxr-input`, and everything downstream
+ * (gameplay, UI, feedback) subscribes to these events OUT. No side doors.
+ */
+import type { Unsubscribe } from "@realitycollective/webxr-input";
+export type InteractionEventType = "hoverEnter" | "hoverExit" | "dwellProgress" | "pressStart" | "pressEnd" | "actuated" | "released" | "valueChanged" | "grabStart" | "grabEnd" | "scored" | "behaviourEnabled" | "behaviourDisabled" | "interactableEnabled" | "interactableDisabled";
+export interface InteractionEvent {
+    type: InteractionEventType;
+    /** The target interactable. */
+    interactableId: string;
+    /** The behaviour that produced the event, when behaviour-scoped. */
+    behaviourKind?: string;
+    /** The input source/interactor involved, when input-scoped. */
+    interactorId?: string;
+    /** Analog payload (valueChanged, dwellProgress) or 1/0 for digital. */
+    value?: number;
+    /** Why a behaviour was disabled (unmet capability requirements). */
+    reason?: string;
+}
+export type InteractionEventListener = (event: InteractionEvent) => void;
+/** Minimal synchronous emitter (insertion-ordered, unsubscribe-safe). */
+export declare class Emitter<T> {
+    private listeners;
+    subscribe(listener: (value: T) => void): Unsubscribe;
+    emit(value: T): void;
+    get size(): number;
+}

package/dist/events.js

@@ -0,0 +1,16 @@
+/** Minimal synchronous emitter (insertion-ordered, unsubscribe-safe). */
+export class Emitter {
+    listeners = new Set();
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    emit(value) {
+        for (const listener of [...this.listeners])
+            listener(value);
+    }
+    get size() {
+        return this.listeners.size;
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AA4CA,yEAAyE;AACzE,MAAM,OAAO,OAAO;IACV,SAAS,GAAG,IAAI,GAAG,EAAsB,CAAC;IAElD,SAAS,CAAC,QAA4B;QACpC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC,KAAQ;QACX,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC;YAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,CAAC;CACF","sourcesContent":["/**\n * Interaction events - THE only outbound pathway from the interaction core.\n *\n * The Pale Signal research showed what happens when events are optional:\n * consumers bypass them and subscribe to raw engine tags, and the same\n * input ends up with two independent listeners. Here, adapters feed input\n * IN through `@realitycollective/webxr-input`, and everything downstream\n * (gameplay, UI, feedback) subscribes to these events OUT. No side doors.\n */\nimport type { Unsubscribe } from \"@realitycollective/webxr-input\";\n\nexport type InteractionEventType =\n  | \"hoverEnter\"\n  | \"hoverExit\"\n  | \"dwellProgress\" // gaze-dwell fill 0..1 (value); 1 fires the press\n  | \"pressStart\"\n  | \"pressEnd\"\n  | \"actuated\" // logical value crossed into the actuated state\n  | \"released\"\n  | \"valueChanged\" // analog 0..1 (dead-banded)\n  | \"grabStart\"\n  | \"grabEnd\"\n  | \"scored\" // toss passed through a hoop\n  | \"behaviourEnabled\"\n  | \"behaviourDisabled\"\n  | \"interactableEnabled\"\n  | \"interactableDisabled\";\n\nexport interface InteractionEvent {\n  type: InteractionEventType;\n  /** The target interactable. */\n  interactableId: string;\n  /** The behaviour that produced the event, when behaviour-scoped. */\n  behaviourKind?: string;\n  /** The input source/interactor involved, when input-scoped. */\n  interactorId?: string;\n  /** Analog payload (valueChanged, dwellProgress) or 1/0 for digital. */\n  value?: number;\n  /** Why a behaviour was disabled (unmet capability requirements). */\n  reason?: string;\n}\n\nexport type InteractionEventListener = (event: InteractionEvent) => void;\n\n/** Minimal synchronous emitter (insertion-ordered, unsubscribe-safe). */\nexport class Emitter<T> {\n  private listeners = new Set<(value: T) => void>();\n\n  subscribe(listener: (value: T) => void): Unsubscribe {\n    this.listeners.add(listener);\n    return () => this.listeners.delete(listener);\n  }\n\n  emit(value: T): void {\n    for (const listener of [...this.listeners]) listener(value);\n  }\n\n  get size(): number {\n    return this.listeners.size;\n  }\n}\n"]}

package/dist/feedback.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Feedback hooks - haptics/audio stay OUT of the framework; the client
+ * implements them. Behaviours emit *intents* describing the physical
+ * moment ("this press just actuated, a short strong pulse would fit");
+ * the client subscribes and realises them however it likes (haptic pulse
+ * on controllers, an audio cue, both, neither).
+ *
+ * `routeHapticsToProvider` is the one convenience the framework offers -
+ * an explicit opt-in the client calls, never an automatic behaviour.
+ */
+import type { InputProvider, Unsubscribe } from "@realitycollective/webxr-input";
+/** A named moment a client may want to sonify/hapticise. */
+export type FeedbackCue = "hover" | "press" | "actuate" | "release" | "grab" | "drop" | "score" | "dwellComplete" | "valueTick";
+export interface FeedbackIntent {
+    cue: FeedbackCue;
+    interactableId: string;
+    behaviourKind?: string;
+    /** The input source that caused the moment - haptics target this. */
+    sourceId?: string;
+    /** Suggested haptic intensity 0..1 (clients may remap freely). */
+    intensity: number;
+    /** Suggested haptic duration in ms. */
+    durationMs: number;
+}
+export type FeedbackListener = (intent: FeedbackIntent) => void;
+/**
+ * Client opt-in: forward the haptic half of feedback intents to the input
+ * provider's `pulse` (which no-ops on sources without actuators - hands).
+ * Returns the unsubscribe. Audio remains entirely the client's concern.
+ */
+export declare function routeHapticsToProvider(onFeedback: (listener: FeedbackListener) => Unsubscribe, provider: InputProvider, scale?: number): Unsubscribe;