@aura3d/input 1.4.0 → 1.4.1

package/src/PointerDevice.ts

@@ -1,102 +0,0 @@
-import type { PointerTouch } from "./InputSnapshot";
-
-export interface PointerEventLike {
-  readonly clientX: number;
-  readonly clientY: number;
-  readonly button?: number;
-  readonly buttons?: number;
-  readonly pointerId?: number;
-  preventDefault?(): void;
-}
-
-export interface WheelEventLike {
-  readonly deltaX: number;
-  readonly deltaY: number;
-  preventDefault?(): void;
-}
-
-export class PointerDevice {
-  x = 0;
-  y = 0;
-  deltaX = 0;
-  deltaY = 0;
-  wheelX = 0;
-  wheelY = 0;
-
-  private readonly buttons = new Set<number>();
-  private previousButtons = new Set<number>();
-  private readonly touches = new Map<number, PointerTouch>();
-  private pixelRatio = 1;
-
-  setDevicePixelRatio(value: number): void {
-    if (!Number.isFinite(value) || value <= 0) {
-      throw new Error("Device pixel ratio must be positive");
-    }
-    this.pixelRatio = value;
-  }
-
-  move(event: PointerEventLike): void {
-    const nextX = event.clientX * this.pixelRatio;
-    const nextY = event.clientY * this.pixelRatio;
-    this.deltaX += nextX - this.x;
-    this.deltaY += nextY - this.y;
-    this.x = nextX;
-    this.y = nextY;
-
-    if (event.pointerId !== undefined) {
-      this.touches.set(event.pointerId, { id: event.pointerId, x: this.x, y: this.y });
-    }
-  }
-
-  down(event: PointerEventLike): void {
-    this.move(event);
-    this.buttons.add(event.button ?? 0);
-  }
-
-  up(event: PointerEventLike): void {
-    this.move(event);
-    this.buttons.delete(event.button ?? 0);
-    if (event.pointerId !== undefined) {
-      this.touches.delete(event.pointerId);
-    }
-  }
-
-  wheel(event: WheelEventLike): void {
-    this.wheelX += event.deltaX;
-    this.wheelY += event.deltaY;
-  }
-
-  blur(): void {
-    this.buttons.clear();
-    this.touches.clear();
-  }
-
-  snapshotData() {
-    const buttonMap = new Map<number, { down: boolean; pressed: boolean; released: boolean }>();
-    for (const button of this.buttons) {
-      buttonMap.set(button, { down: true, pressed: false, released: false });
-    }
-
-    return {
-      pointer: {
-        x: this.x,
-        y: this.y,
-        deltaX: this.deltaX,
-        deltaY: this.deltaY,
-        wheelX: this.wheelX,
-        wheelY: this.wheelY,
-        buttons: buttonMap,
-        touches: [...this.touches.values()]
-      },
-      previousPointerButtons: new Set(this.previousButtons)
-    };
-  }
-
-  endFrame(): void {
-    this.previousButtons = new Set(this.buttons);
-    this.deltaX = 0;
-    this.deltaY = 0;
-    this.wheelX = 0;
-    this.wheelY = 0;
-  }
-}

package/src/VirtualTouchControls.ts

@@ -1,169 +0,0 @@
-export interface VirtualJoystickConfig {
-  readonly center: readonly [number, number];
-  readonly radius: number;
-  readonly deadZone?: number;
-  readonly maxDistance?: number;
-  readonly fixed?: boolean;
-  readonly returnToCenter?: boolean;
-}
-
-export interface VirtualTouchPoint {
-  readonly id: number;
-  readonly x: number;
-  readonly y: number;
-}
-
-export interface VirtualTouchJoystickSnapshot {
-  readonly source: "origin-master-touch-joystick-virtual-input-adapted";
-  readonly active: boolean;
-  readonly activeTouchId: number | null;
-  readonly center: readonly [number, number];
-  readonly stick: readonly [number, number];
-  readonly value: readonly [number, number];
-  readonly magnitude: number;
-  readonly deadZone: number;
-  readonly consumedTouches: number;
-  readonly evidence: {
-    readonly oldCodebasePort: true;
-    readonly virtualJoystick: boolean;
-    readonly deadZone: boolean;
-    readonly clampedMagnitude: boolean;
-    readonly returnToCenter: boolean;
-    readonly floatingCenter: boolean;
-  };
-}
-
-export class VirtualTouchJoystick {
-  private readonly initialCenter: readonly [number, number];
-  private readonly radius: number;
-  private readonly deadZone: number;
-  private readonly maxDistance: number;
-  private readonly fixed: boolean;
-  private readonly returnToCenter: boolean;
-  private centerRef: readonly [number, number];
-  private stickRef: readonly [number, number];
-  private valueRef: readonly [number, number] = [0, 0];
-  private activeTouchId: number | null = null;
-  private active = false;
-  private consumedTouches = 0;
-
-  constructor(config: VirtualJoystickConfig) {
-    this.initialCenter = config.center;
-    this.centerRef = config.center;
-    this.stickRef = config.center;
-    this.radius = positive(config.radius, 64);
-    this.deadZone = clamp(config.deadZone ?? 0.15, 0, 0.95);
-    this.maxDistance = positive(config.maxDistance, this.radius * 0.8);
-    this.fixed = config.fixed ?? true;
-    this.returnToCenter = config.returnToCenter ?? true;
-  }
-
-  touchStart(touch: VirtualTouchPoint): boolean {
-    if (this.activeTouchId !== null) return false;
-    if (distance([touch.x, touch.y], this.centerRef) > this.radius) return false;
-    this.activeTouchId = touch.id;
-    this.active = true;
-    this.consumedTouches += 1;
-    if (!this.fixed) this.centerRef = [touch.x, touch.y];
-    this.updateStick([touch.x, touch.y]);
-    return true;
-  }
-
-  touchMove(touch: VirtualTouchPoint): boolean {
-    if (touch.id !== this.activeTouchId) return false;
-    this.updateStick([touch.x, touch.y]);
-    return true;
-  }
-
-  touchEnd(touch: VirtualTouchPoint): boolean {
-    if (touch.id !== this.activeTouchId) return false;
-    this.activeTouchId = null;
-    this.active = false;
-    if (this.returnToCenter) {
-      this.stickRef = this.centerRef;
-      this.valueRef = [0, 0];
-    }
-    if (!this.fixed) this.centerRef = this.initialCenter;
-    return true;
-  }
-
-  snapshot(): VirtualTouchJoystickSnapshot {
-    return {
-      source: "origin-master-touch-joystick-virtual-input-adapted",
-      active: this.active,
-      activeTouchId: this.activeTouchId,
-      center: [round(this.centerRef[0]), round(this.centerRef[1])],
-      stick: [round(this.stickRef[0]), round(this.stickRef[1])],
-      value: [round(this.valueRef[0]), round(this.valueRef[1])],
-      magnitude: round(Math.hypot(this.valueRef[0], this.valueRef[1])),
-      deadZone: this.deadZone,
-      consumedTouches: this.consumedTouches,
-      evidence: {
-        oldCodebasePort: true,
-        virtualJoystick: true,
-        deadZone: true,
-        clampedMagnitude: Math.hypot(this.valueRef[0], this.valueRef[1]) <= 1.0001,
-        returnToCenter: this.returnToCenter,
-        floatingCenter: !this.fixed
-      }
-    };
-  }
-
-  private updateStick(touch: readonly [number, number]): void {
-    const dx = touch[0] - this.centerRef[0];
-    const dy = touch[1] - this.centerRef[1];
-    const rawDistance = Math.hypot(dx, dy);
-    if (rawDistance === 0) {
-      this.stickRef = this.centerRef;
-      this.valueRef = [0, 0];
-      return;
-    }
-    const clampedDistance = Math.min(rawDistance, this.maxDistance);
-    const nx = dx / rawDistance;
-    const ny = dy / rawDistance;
-    this.stickRef = [this.centerRef[0] + nx * clampedDistance, this.centerRef[1] + ny * clampedDistance];
-    const normalized = clampedDistance / this.maxDistance;
-    if (normalized < this.deadZone) {
-      this.valueRef = [0, 0];
-      return;
-    }
-    const remapped = Math.min(1, (normalized - this.deadZone) / (1 - this.deadZone));
-    this.valueRef = [nx * remapped, ny * remapped];
-  }
-}
-
-export function sampleVirtualTouchJoystickFixture(): {
-  readonly active: VirtualTouchJoystickSnapshot;
-  readonly released: VirtualTouchJoystickSnapshot;
-} {
-  const joystick = new VirtualTouchJoystick({
-    center: [96, 420],
-    radius: 72,
-    deadZone: 0.2,
-    maxDistance: 56,
-    fixed: false,
-    returnToCenter: true
-  });
-  joystick.touchStart({ id: 7, x: 90, y: 416 });
-  joystick.touchMove({ id: 7, x: 154, y: 376 });
-  const active = joystick.snapshot();
-  joystick.touchEnd({ id: 7, x: 154, y: 376 });
-  return { active, released: joystick.snapshot() };
-}
-
-function positive(value: unknown, fallback: number): number {
-  const number = Number(value);
-  return Number.isFinite(number) && number > 0 ? number : fallback;
-}
-
-function distance(a: readonly [number, number], b: readonly [number, number]): number {
-  return Math.hypot(a[0] - b[0], a[1] - b[1]);
-}
-
-function clamp(value: number, min: number, max: number): number {
-  return Math.max(min, Math.min(max, value));
-}
-
-function round(value: number): number {
-  return Number(value.toFixed(4));
-}

package/src/WebXRSessionController.ts

@@ -1,248 +0,0 @@
-export type A3DXRSessionMode = "inline" | "immersive-vr" | "immersive-ar";
-export type A3DXRReferenceSpaceType = "viewer" | "local" | "local-floor" | "bounded-floor" | "unbounded";
-export type A3DXRHandedness = "none" | "left" | "right";
-
-export interface A3DXRSystemLike {
-  isSessionSupported?(mode: A3DXRSessionMode): Promise<boolean>;
-  requestSession(mode: A3DXRSessionMode, options?: A3DXRSessionInit): Promise<A3DXRSessionLike>;
-}
-
-export interface A3DXRSessionInit {
-  readonly requiredFeatures?: readonly string[];
-  readonly optionalFeatures?: readonly string[];
-}
-
-export interface A3DXRSessionLike {
-  readonly inputSources?: readonly A3DXRInputSourceLike[];
-  requestReferenceSpace?(type: A3DXRReferenceSpaceType): Promise<A3DXRReferenceSpaceLike>;
-  requestAnimationFrame?(callback: (time: number, frame: A3DXRFrameLike) => void): number;
-  end?(): Promise<void>;
-}
-
-export interface A3DXRInputSourceLike {
-  readonly handedness?: A3DXRHandedness;
-  readonly targetRayMode?: "gaze" | "tracked-pointer" | "screen";
-  readonly profiles?: readonly string[];
-  readonly targetRaySpace?: unknown;
-  readonly gripSpace?: unknown;
-  readonly gamepad?: {
-    readonly buttons?: readonly { readonly pressed?: boolean; readonly touched?: boolean; readonly value?: number }[];
-    readonly axes?: readonly number[];
-    readonly hapticActuators?: readonly { pulse?(intensity: number, duration: number): Promise<boolean> | boolean }[];
-  };
-}
-
-export interface A3DXRFrameLike {
-  getHitTestResults?(source: unknown): readonly A3DXRHitTestResultLike[];
-  getPose?(space: unknown, baseSpace: A3DXRReferenceSpaceLike): A3DXRPoseLike | undefined;
-}
-
-export interface A3DXRReferenceSpaceLike {
-  readonly type?: A3DXRReferenceSpaceType;
-}
-
-export interface A3DXRHitTestResultLike {
-  readonly position?: readonly [number, number, number];
-  readonly normal?: readonly [number, number, number];
-}
-
-export interface A3DXRPoseLike {
-  readonly transform?: {
-    readonly matrix?: readonly number[];
-    readonly position?: readonly [number, number, number];
-    readonly orientation?: readonly [number, number, number, number];
-  };
-}
-
-export interface WebXRSessionControllerOptions {
-  readonly xr?: A3DXRSystemLike;
-  readonly mode?: A3DXRSessionMode;
-  readonly requiredFeatures?: readonly string[];
-  readonly optionalFeatures?: readonly string[];
-  readonly referenceSpace?: A3DXRReferenceSpaceType;
-}
-
-export interface WebXRControllerSample {
-  readonly handedness: A3DXRHandedness;
-  readonly targetRayMode: "gaze" | "tracked-pointer" | "screen";
-  readonly profiles: readonly string[];
-  readonly triggerPressed: boolean;
-  readonly squeezePressed: boolean;
-  readonly primaryValue: number;
-  readonly axes: readonly number[];
-  readonly targetRayMatrix: readonly number[] | null;
-  readonly gripMatrix: readonly number[] | null;
-  readonly hapticActuatorCount: number;
-}
-
-export interface WebXRHitTestSample {
-  readonly position: readonly [number, number, number];
-  readonly normal: readonly [number, number, number];
-}
-
-export interface WebXRFrameSample {
-  readonly mode: A3DXRSessionMode;
-  readonly referenceSpace: A3DXRReferenceSpaceType;
-  readonly active: boolean;
-  readonly controllerCount: number;
-  readonly controllers: readonly WebXRControllerSample[];
-  readonly hitTestCount: number;
-  readonly hitTests: readonly WebXRHitTestSample[];
-}
-
-export interface WebXRSessionStartResult {
-  readonly mode: A3DXRSessionMode;
-  readonly referenceSpace: A3DXRReferenceSpaceType;
-  readonly supported: boolean;
-  readonly started: boolean;
-}
-
-export class WebXRSessionController {
-  readonly mode: A3DXRSessionMode;
-  readonly requiredFeatures: readonly string[];
-  readonly optionalFeatures: readonly string[];
-  readonly referenceSpaceType: A3DXRReferenceSpaceType;
-
-  private readonly xr?: A3DXRSystemLike;
-  private session: A3DXRSessionLike | null = null;
-  private referenceSpace: A3DXRReferenceSpaceLike | null = null;
-
-  constructor(options: WebXRSessionControllerOptions = {}) {
-    this.xr = options.xr ?? readNavigatorXR();
-    this.mode = options.mode ?? "immersive-vr";
-    this.requiredFeatures = options.requiredFeatures ?? [];
-    this.optionalFeatures = options.optionalFeatures ?? [];
-    this.referenceSpaceType = options.referenceSpace ?? (this.mode === "immersive-ar" ? "viewer" : "local-floor");
-  }
-
-  get active(): boolean {
-    return this.session !== null;
-  }
-
-  async isSupported(): Promise<boolean> {
-    if (!this.xr) return false;
-    if (!this.xr.isSessionSupported) return true;
-    return this.xr.isSessionSupported(this.mode);
-  }
-
-  async start(): Promise<WebXRSessionStartResult> {
-    if (!this.xr) {
-      return {
-        mode: this.mode,
-        referenceSpace: this.referenceSpaceType,
-        supported: false,
-        started: false
-      };
-    }
-    const supported = await this.isSupported();
-    if (!supported) {
-      return {
-        mode: this.mode,
-        referenceSpace: this.referenceSpaceType,
-        supported: false,
-        started: false
-      };
-    }
-    this.session = await this.xr.requestSession(this.mode, {
-      requiredFeatures: this.requiredFeatures,
-      optionalFeatures: this.optionalFeatures
-    });
-    this.referenceSpace = await this.session.requestReferenceSpace?.(this.referenceSpaceType) ?? { type: this.referenceSpaceType };
-    return {
-      mode: this.mode,
-      referenceSpace: this.referenceSpace?.type ?? this.referenceSpaceType,
-      supported: true,
-      started: true
-    };
-  }
-
-  sampleFrame(frame?: A3DXRFrameLike, hitTestSource?: unknown): WebXRFrameSample {
-    const referenceSpace = this.referenceSpace ?? { type: this.referenceSpaceType };
-    const controllers = Array.from(this.session?.inputSources ?? []).map((source) => sampleInputSource(source, frame, referenceSpace));
-    const hitTests = frame?.getHitTestResults && hitTestSource
-      ? frame.getHitTestResults(hitTestSource).map(sampleHitTest)
-      : [];
-    return {
-      mode: this.mode,
-      referenceSpace: this.referenceSpace?.type ?? this.referenceSpaceType,
-      active: this.active,
-      controllerCount: controllers.length,
-      controllers,
-      hitTestCount: hitTests.length,
-      hitTests
-    };
-  }
-
-  async end(): Promise<void> {
-    const session = this.session;
-    this.session = null;
-    this.referenceSpace = null;
-    await session?.end?.();
-  }
-
-  async pulseHaptics(intensity = 0.5, duration = 35): Promise<number> {
-    if (!Number.isFinite(intensity) || intensity < 0 || intensity > 1) throw new RangeError("WebXR haptic intensity must be in [0, 1].");
-    if (!Number.isFinite(duration) || duration < 0) throw new RangeError("WebXR haptic duration must be finite and non-negative.");
-    let pulses = 0;
-    for (const source of this.session?.inputSources ?? []) {
-      for (const actuator of source.gamepad?.hapticActuators ?? []) {
-        const accepted = await actuator.pulse?.(intensity, duration);
-        if (accepted !== false) pulses += 1;
-      }
-    }
-    return pulses;
-  }
-}
-
-function sampleInputSource(source: A3DXRInputSourceLike, frame: A3DXRFrameLike | undefined, referenceSpace: A3DXRReferenceSpaceLike): WebXRControllerSample {
-  const buttons = source.gamepad?.buttons ?? [];
-  const axes = source.gamepad?.axes ?? [];
-  const trigger = buttons[0];
-  const squeeze = buttons[1];
-  return {
-    handedness: source.handedness ?? "none",
-    targetRayMode: source.targetRayMode ?? "tracked-pointer",
-    profiles: source.profiles ?? [],
-    triggerPressed: Boolean(trigger?.pressed),
-    squeezePressed: Boolean(squeeze?.pressed),
-    primaryValue: finiteOrZero(trigger?.value),
-    axes: axes.map(finiteOrZero),
-    targetRayMatrix: samplePoseMatrix(frame, source.targetRaySpace, referenceSpace),
-    gripMatrix: samplePoseMatrix(frame, source.gripSpace, referenceSpace),
-    hapticActuatorCount: source.gamepad?.hapticActuators?.length ?? 0
-  };
-}
-
-function samplePoseMatrix(frame: A3DXRFrameLike | undefined, space: unknown, referenceSpace: A3DXRReferenceSpaceLike): readonly number[] | null {
-  if (!frame?.getPose || !space) return null;
-  return sanitizeMatrix4(frame.getPose(space, referenceSpace)?.transform?.matrix);
-}
-
-function sampleHitTest(result: A3DXRHitTestResultLike): WebXRHitTestSample {
-  return {
-    position: sanitizeVec3(result.position, [0, 0, 0]),
-    normal: sanitizeVec3(result.normal, [0, 1, 0])
-  };
-}
-
-function sanitizeVec3(value: readonly number[] | undefined, fallback: readonly [number, number, number]): readonly [number, number, number] {
-  if (!value || value.length < 3) return fallback;
-  const x = finiteOrZero(value[0]);
-  const y = finiteOrZero(value[1]);
-  const z = finiteOrZero(value[2]);
-  return [x, y, z];
-}
-
-function finiteOrZero(value: unknown): number {
-  return typeof value === "number" && Number.isFinite(value) ? value : 0;
-}
-
-function sanitizeMatrix4(value: readonly number[] | undefined): readonly number[] | null {
-  if (!value || value.length < 16) return null;
-  const matrix = Array.from(value.slice(0, 16), finiteOrZero);
-  return matrix;
-}
-
-function readNavigatorXR(): A3DXRSystemLike | undefined {
-  return (globalThis.navigator as Navigator & { xr?: A3DXRSystemLike } | undefined)?.xr;
-}