@aura3d/controls 1.3.3 → 1.4.1

package/README.md

@@ -0,0 +1,26 @@
+# @aura3d/controls
+
+`@aura3d/controls` owns camera controls, transform controls, picking,
+selection, annotations, hotspots, and interaction helpers for Aura3D and
+Three.js-compatibility workflows.
+
+## Public API
+
+- `OrbitControls`, `TrackballControls`, `FlyControls`, `FirstPersonControls`,
+  `MapControls`, and `PointerLockControls`: camera/navigation controls.
+- `DragControls`, `TransformControls`: object manipulation controls.
+- `SelectionManager`: selection ownership for interactive scenes.
+- `InteractionControls`: interaction modes, rays, listeners, and hotspot
+  handling.
+- `Picking`: picking reports and diagnostics.
+- Picking annotation helpers such as `createRobotPickingAnnotations`,
+  `createDistrictPickingAnnotations`, `pickAnnotation`, and
+  `pickScreenSpaceAnnotation`.
+- Shared control state and native control type helpers.
+
+## Package Boundary
+
+This package provides control and picking primitives. It does not claim that a
+public root `createAuraApp` route has a particular interaction unless that route
+imports the controls or root interaction helpers and verifies the behavior in a
+browser test.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aura3d/controls",
-  "version": "1.3.3",
+  "version": "1.4.1",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -11,6 +11,38 @@
     }
   },
   "dependencies": {
-    "@aura3d/input": "1.3.3"
-  }
+    "@aura3d/input": "1.4.1"
+  },
+  "description": "Orbit, trackball, fly, first-person, map, pointer-lock, drag, transform, picking, hotspot, and selection controls for Aura3D.",
+  "keywords": [
+    "aura3d",
+    "3d",
+    "browser-3d",
+    "web-3d",
+    "typescript",
+    "controls",
+    "orbit-controls",
+    "camera-controls",
+    "transform-controls",
+    "picking",
+    "hotspots",
+    "interaction"
+  ],
+  "homepage": "https://aura3d.auraone.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/auraoneai/aura3d.git",
+    "directory": "packages/controls"
+  },
+  "bugs": {
+    "url": "https://github.com/auraoneai/aura3d/issues"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "README.md",
+    "dist"
+  ]
 }

package/src/ControlState.ts

@@ -1,24 +0,0 @@
-import { ControlVector3 } from "./NativeControlTypes";
-
-export interface ThreeCompatControlEvent {
-  readonly type: string;
-  readonly delta?: ControlVector3;
-}
-
-export interface ThreeCompatControlState {
-  readonly target: ControlVector3;
-  readonly position: ControlVector3;
-  readonly rotation: ControlVector3;
-  readonly zoom: number;
-  readonly enabled: boolean;
-}
-
-export function createDefaultControlState(): ThreeCompatControlState {
-  return {
-    target: new ControlVector3(),
-    position: new ControlVector3(0, 0, 5),
-    rotation: new ControlVector3(),
-    zoom: 1,
-    enabled: true
-  };
-}

package/src/DragControls.ts

@@ -1,17 +0,0 @@
-import { addVector3, type ControlObject3DLike, type Vector3Like } from "./NativeControlTypes";
-
-export class DragControls {
-  dragging: ControlObject3DLike | null = null;
-
-  start(object: ControlObject3DLike): void {
-    this.dragging = object;
-  }
-
-  drag(delta: Vector3Like): void {
-    addVector3(this.dragging?.position, delta);
-  }
-
-  end(): void {
-    this.dragging = null;
-  }
-}

package/src/FirstPersonControls.ts

@@ -1,8 +0,0 @@
-import { FlyControls } from "./FlyControls";
-
-export class FirstPersonControls extends FlyControls {
-  look(deltaX: number, deltaY: number): void {
-    this.state.rotation.y += deltaX;
-    this.state.rotation.x += deltaY;
-  }
-}

package/src/FlyControls.ts

@@ -1,14 +0,0 @@
-import { createDefaultControlState, type ThreeCompatControlState } from "./ControlState";
-
-export class FlyControls {
-  readonly state: ThreeCompatControlState = createDefaultControlState();
-  movementSpeed = 1;
-
-  moveForward(distance: number): void {
-    this.state.position.z -= distance * this.movementSpeed;
-  }
-
-  strafe(distance: number): void {
-    this.state.position.x += distance * this.movementSpeed;
-  }
-}

package/src/InteractionControls.ts

@@ -1,224 +0,0 @@
-import { InputSnapshot } from "@aura3d/input";
-import { FlyControls } from "./FlyControls";
-import { OrbitControls } from "./OrbitControls";
-import { Picking, type PickingOptions, type PickingReport, type ThreeCompatPickResult } from "./Picking";
-import { ControlVector3, type ControlObject3DLike, type Vector3Like } from "./NativeControlTypes";
-
-export type InteractionControlMode = "orbit" | "fly";
-export type InteractionControlsEventType =
-  | "mode-change"
-  | "hover-enter"
-  | "hover-exit"
-  | "pick"
-  | "hotspot-click";
-
-export interface InteractionRay {
-  readonly origin: Vector3Like;
-  readonly direction: Vector3Like;
-}
-
-export type InteractionRayProvider = (snapshot: InputSnapshot) => InteractionRay;
-export type InteractionRootProvider = () => ControlObject3DLike | undefined;
-export type InteractionControlsListener = (event: InteractionControlsEvent) => void;
-export type HotspotHandler = (event: InteractionControlsEvent & { readonly hit: ThreeCompatPickResult }) => void;
-
-export interface InteractionControlsOptions {
-  readonly mode?: InteractionControlMode;
-  readonly orbit?: OrbitControls;
-  readonly fly?: FlyControls;
-  readonly picking?: Picking;
-  readonly root?: ControlObject3DLike | InteractionRootProvider;
-  readonly rayProvider?: InteractionRayProvider;
-  readonly pickOptions?: PickingOptions;
-  readonly rotateButton?: number;
-  readonly panButton?: number;
-  readonly rotateSpeed?: number;
-  readonly panSpeed?: number;
-  readonly dollySpeed?: number;
-  readonly flyMoveSpeed?: number;
-}
-
-export interface InteractionControlsEvent {
-  readonly type: InteractionControlsEventType;
-  readonly mode: InteractionControlMode;
-  readonly snapshot: InputSnapshot;
-  readonly hit?: ThreeCompatPickResult;
-  readonly previousHit?: ThreeCompatPickResult;
-}
-
-export interface InteractionControlsUpdate {
-  readonly mode: InteractionControlMode;
-  readonly pickReport?: PickingReport;
-  readonly hit: ThreeCompatPickResult | null;
-}
-
-export class InteractionControls {
-  readonly orbit: OrbitControls;
-  readonly fly: FlyControls;
-  readonly picking: Picking;
-
-  enabled = true;
-
-  private controlMode: InteractionControlMode;
-  private rootRef?: ControlObject3DLike | InteractionRootProvider;
-  private rayProvider?: InteractionRayProvider;
-  private pickOptions: PickingOptions;
-  private readonly listeners = new Set<InteractionControlsListener>();
-  private readonly hotspotHandlers = new Map<string, Set<HotspotHandler>>();
-  private hoverHit: ThreeCompatPickResult | null = null;
-  private disposed = false;
-
-  private readonly rotateButton: number;
-  private readonly panButton: number;
-  private readonly rotateSpeed: number;
-  private readonly panSpeed: number;
-  private readonly dollySpeed: number;
-  private readonly flyMoveSpeed: number;
-
-  constructor(options: InteractionControlsOptions = {}) {
-    this.orbit = options.orbit ?? new OrbitControls();
-    this.fly = options.fly ?? new FlyControls();
-    this.picking = options.picking ?? new Picking();
-    this.controlMode = options.mode ?? "orbit";
-    this.rootRef = options.root;
-    this.rayProvider = options.rayProvider;
-    this.pickOptions = options.pickOptions ?? {};
-    this.rotateButton = options.rotateButton ?? 0;
-    this.panButton = options.panButton ?? 1;
-    this.rotateSpeed = options.rotateSpeed ?? 0.005;
-    this.panSpeed = options.panSpeed ?? 0.01;
-    this.dollySpeed = options.dollySpeed ?? 0.001;
-    this.flyMoveSpeed = options.flyMoveSpeed ?? 1;
-  }
-
-  get mode(): InteractionControlMode {
-    return this.controlMode;
-  }
-
-  setMode(mode: InteractionControlMode, snapshot = new InputSnapshot()): void {
-    if (this.controlMode === mode) return;
-    this.controlMode = mode;
-    this.emit({ type: "mode-change", mode, snapshot });
-  }
-
-  setRoot(root: ControlObject3DLike | InteractionRootProvider | undefined): void {
-    this.rootRef = root;
-    this.hoverHit = null;
-  }
-
-  setRayProvider(provider: InteractionRayProvider | undefined): void {
-    this.rayProvider = provider;
-  }
-
-  setPickOptions(options: PickingOptions): void {
-    this.pickOptions = options;
-  }
-
-  subscribe(listener: InteractionControlsListener): () => void {
-    this.listeners.add(listener);
-    return () => this.listeners.delete(listener);
-  }
-
-  onHotspot(id: string, handler: HotspotHandler): () => void {
-    const handlers = this.hotspotHandlers.get(id) ?? new Set<HotspotHandler>();
-    handlers.add(handler);
-    this.hotspotHandlers.set(id, handlers);
-    return () => {
-      handlers.delete(handler);
-      if (handlers.size === 0) this.hotspotHandlers.delete(id);
-    };
-  }
-
-  update(snapshot: InputSnapshot): InteractionControlsUpdate {
-    if (this.disposed || !this.enabled) {
-      return { mode: this.controlMode, hit: this.hoverHit };
-    }
-
-    if (this.controlMode === "orbit") {
-      this.updateOrbit(snapshot);
-    } else {
-      this.updateFly(snapshot);
-    }
-
-    const pickReport = this.updatePicking(snapshot);
-    return { mode: this.controlMode, pickReport, hit: pickReport?.hit ?? null };
-  }
-
-  pick(snapshot: InputSnapshot): PickingReport | undefined {
-    const root = this.resolveRoot();
-    if (!root) return undefined;
-    const ray = this.resolveRay(snapshot);
-    return this.picking.report(root, ray.origin, ray.direction, this.pickOptions);
-  }
-
-  dispose(): void {
-    this.disposed = true;
-    this.listeners.clear();
-    this.hotspotHandlers.clear();
-    this.hoverHit = null;
-  }
-
-  private updateOrbit(snapshot: InputSnapshot): void {
-    if (snapshot.button(this.rotateButton).down) {
-      this.orbit.rotate(snapshot.pointer.deltaX * this.rotateSpeed, snapshot.pointer.deltaY * this.rotateSpeed);
-    }
-    if (snapshot.button(this.panButton).down) {
-      this.orbit.pan(snapshot.pointer.deltaX * this.panSpeed, -snapshot.pointer.deltaY * this.panSpeed);
-    }
-    if (snapshot.pointer.wheelY !== 0) {
-      this.orbit.dolly(Math.max(0.01, 1 + snapshot.pointer.wheelY * this.dollySpeed));
-    }
-  }
-
-  private updateFly(snapshot: InputSnapshot): void {
-    const distance = this.flyMoveSpeed;
-    if (snapshot.key("KeyW").down || snapshot.key("ArrowUp").down) this.fly.moveForward(distance);
-    if (snapshot.key("KeyS").down || snapshot.key("ArrowDown").down) this.fly.moveForward(-distance);
-    if (snapshot.key("KeyA").down || snapshot.key("ArrowLeft").down) this.fly.strafe(-distance);
-    if (snapshot.key("KeyD").down || snapshot.key("ArrowRight").down) this.fly.strafe(distance);
-  }
-
-  private updatePicking(snapshot: InputSnapshot): PickingReport | undefined {
-    const pickReport = this.pick(snapshot);
-    const hit = pickReport?.hit ?? null;
-    const previousHit = this.hoverHit;
-    if (previousHit?.object !== hit?.object) {
-      if (previousHit) this.emit({ type: "hover-exit", mode: this.controlMode, snapshot, previousHit });
-      if (hit) this.emit({ type: "hover-enter", mode: this.controlMode, snapshot, hit, previousHit: previousHit ?? undefined });
-      this.hoverHit = hit;
-    }
-
-    if (hit && snapshot.button(0).released) {
-      const event = { type: "pick" as const, mode: this.controlMode, snapshot, hit, previousHit: previousHit ?? undefined };
-      this.emit(event);
-      this.emitHotspot(event);
-    }
-
-    return pickReport;
-  }
-
-  private emitHotspot(event: InteractionControlsEvent & { readonly hit: ThreeCompatPickResult }): void {
-    const id = event.hit.metadata?.id ?? event.hit.object.name;
-    if (!id) return;
-    const hotspotEvent = { ...event, type: "hotspot-click" as const };
-    this.emit(hotspotEvent);
-    for (const handler of [...(this.hotspotHandlers.get(id) ?? [])]) {
-      handler(hotspotEvent);
-    }
-  }
-
-  private emit(event: InteractionControlsEvent): void {
-    for (const listener of [...this.listeners]) listener(event);
-  }
-
-  private resolveRoot(): ControlObject3DLike | undefined {
-    return typeof this.rootRef === "function" ? this.rootRef() : this.rootRef;
-  }
-
-  private resolveRay(snapshot: InputSnapshot): InteractionRay {
-    return this.rayProvider?.(snapshot) ?? {
-      origin: new ControlVector3(),
-      direction: new ControlVector3(0, 0, -1)
-    };
-  }
-}

package/src/MapControls.ts

@@ -1,10 +0,0 @@
-import { OrbitControls } from "./OrbitControls";
-
-export class MapControls extends OrbitControls {
-  readonly screenSpacePanning = false;
-
-  truck(deltaX: number, deltaZ: number): void {
-    this.state.target.x += deltaX;
-    this.state.target.z += deltaZ;
-  }
-}

package/src/NativeControlTypes.ts

@@ -1,93 +0,0 @@
-export interface Vector3Like {
-  x: number;
-  y: number;
-  z: number;
-}
-
-export interface ControlPickMetadata {
-  readonly id?: string;
-  readonly label?: string;
-  readonly kind?: string;
-  readonly group?: string;
-  readonly routeId?: string;
-  readonly source?: string;
-  readonly targetId?: string;
-  readonly selectable?: boolean;
-  readonly highlightable?: boolean;
-  readonly pickRadius?: number;
-  readonly priority?: number;
-  readonly payload?: unknown;
-}
-
-export class ControlVector3 implements Vector3Like {
-  constructor(public x = 0, public y = 0, public z = 0) {}
-
-  set(x: number, y: number, z: number): this {
-    this.x = x;
-    this.y = y;
-    this.z = z;
-    return this;
-  }
-
-  copy(value: Vector3Like): this {
-    return this.set(value.x, value.y, value.z);
-  }
-
-  clone(): ControlVector3 {
-    return new ControlVector3(this.x, this.y, this.z);
-  }
-
-  add(value: Vector3Like): this {
-    this.x += value.x;
-    this.y += value.y;
-    this.z += value.z;
-    return this;
-  }
-
-  sub(value: Vector3Like): this {
-    this.x -= value.x;
-    this.y -= value.y;
-    this.z -= value.z;
-    return this;
-  }
-
-  length(): number {
-    return Math.hypot(this.x, this.y, this.z);
-  }
-
-  normalize(): this {
-    const length = this.length();
-    return length > 0 ? this.set(this.x / length, this.y / length, this.z / length) : this;
-  }
-}
-
-export interface ControlObject3DLike {
-  readonly name?: string;
-  readonly type?: string;
-  readonly children?: readonly ControlObject3DLike[];
-  readonly position: Vector3Like;
-  readonly rotation?: Vector3Like;
-  readonly scale?: Vector3Like;
-  readonly visible?: boolean;
-  readonly pickRadius?: number;
-  readonly pickPriority?: number;
-  readonly picking?: ControlPickMetadata;
-  readonly userData?: Record<string, unknown>;
-  traverse?(callback: (object: ControlObject3DLike) => void): void;
-}
-
-export function addVector3(target: Vector3Like | undefined, delta: Vector3Like): void {
-  if (!target) return;
-  target.x += delta.x;
-  target.y += delta.y;
-  target.z += delta.z;
-}
-
-export function traverseControlObject(root: ControlObject3DLike, callback: (object: ControlObject3DLike) => void): void {
-  if (typeof root.traverse === "function") {
-    root.traverse(callback);
-    return;
-  }
-  callback(root);
-  for (const child of root.children ?? []) traverseControlObject(child, callback);
-}

package/src/OrbitControls.ts

@@ -1,25 +0,0 @@
-import { createDefaultControlState, type ThreeCompatControlState } from "./ControlState";
-
-export class OrbitControls {
-  readonly state: ThreeCompatControlState = createDefaultControlState();
-  enablePan = true;
-  enableZoom = true;
-  enableRotate = true;
-
-  rotate(deltaX: number, deltaY: number): void {
-    if (!this.enableRotate) return;
-    this.state.rotation.x += deltaY;
-    this.state.rotation.y += deltaX;
-  }
-
-  pan(deltaX: number, deltaY: number): void {
-    if (!this.enablePan) return;
-    this.state.target.x += deltaX;
-    this.state.target.y += deltaY;
-  }
-
-  dolly(scale: number): void {
-    if (!this.enableZoom) return;
-    this.state.position.z *= scale;
-  }
-}

package/src/Picking.ts

@@ -1,234 +0,0 @@
-import {
-  ControlVector3,
-  traverseControlObject,
-  type ControlObject3DLike,
-  type ControlPickMetadata,
-  type Vector3Like
-} from "./NativeControlTypes";
-
-export interface ThreeCompatPickResult {
-  readonly object: ControlObject3DLike;
-  readonly distance: number;
-  readonly distanceAlongRay: number;
-  readonly perpendicularDistance: number;
-  readonly point: ControlVector3;
-  readonly radius: number;
-  readonly metadata?: ControlPickMetadata;
-}
-
-export interface PickingOptions {
-  readonly near?: number;
-  readonly far?: number;
-  readonly tolerance?: number;
-  readonly includeInvisible?: boolean;
-  readonly includeNonRenderableMetadata?: boolean;
-  readonly metadata?: (object: ControlObject3DLike) => ControlPickMetadata | undefined;
-}
-
-export interface PickingDiagnostics {
-  readonly testedObjects: number;
-  readonly candidateObjects: number;
-  readonly hitCount: number;
-  readonly skippedInvisible: number;
-  readonly skippedNonPickable: number;
-  readonly skippedDisabled: number;
-  readonly skippedOutOfRange: number;
-  readonly skippedMissedRadius: number;
-  readonly nearestMissPerpendicularDistance: number | null;
-  readonly nearestHitLabel: string | null;
-}
-
-export interface PickingReport {
-  readonly hit: ThreeCompatPickResult | null;
-  readonly hits: readonly ThreeCompatPickResult[];
-  readonly diagnostics: PickingDiagnostics;
-}
-
-export class Picking {
-  pick(
-    root: ControlObject3DLike,
-    origin: Vector3Like = new ControlVector3(),
-    direction: Vector3Like = new ControlVector3(0, 0, -1),
-    options: PickingOptions = {}
-  ): ThreeCompatPickResult | null {
-    return this.report(root, origin, direction, options).hit;
-  }
-
-  pickAll(
-    root: ControlObject3DLike,
-    origin: Vector3Like = new ControlVector3(),
-    direction: Vector3Like = new ControlVector3(0, 0, -1),
-    options: PickingOptions = {}
-  ): readonly ThreeCompatPickResult[] {
-    return this.report(root, origin, direction, options).hits;
-  }
-
-  report(
-    root: ControlObject3DLike,
-    origin: Vector3Like = new ControlVector3(),
-    direction: Vector3Like = new ControlVector3(0, 0, -1),
-    options: PickingOptions = {}
-  ): PickingReport {
-    const normalizedDirection = normalizedRayDirection(direction);
-    const near = finiteRange(options.near ?? 0, "near", 0);
-    const far = finiteRange(options.far ?? Number.POSITIVE_INFINITY, "far", near);
-    const tolerance = finiteRange(options.tolerance ?? 0, "tolerance", 0);
-    const hits: ThreeCompatPickResult[] = [];
-    const counters = {
-      testedObjects: 0,
-      candidateObjects: 0,
-      skippedInvisible: 0,
-      skippedNonPickable: 0,
-      skippedDisabled: 0,
-      skippedOutOfRange: 0,
-      skippedMissedRadius: 0
-    };
-    let nearestMissPerpendicularDistance = Number.POSITIVE_INFINITY;
-
-    traverseControlObject(root, (object) => {
-      counters.testedObjects += 1;
-      if (object.visible === false && options.includeInvisible !== true) {
-        counters.skippedInvisible += 1;
-        return;
-      }
-      const metadata = resolvePickMetadata(object, options);
-      if (metadata?.selectable === false) {
-        counters.skippedDisabled += 1;
-        return;
-      }
-      if (!isPickableObject(object, metadata, options)) {
-        counters.skippedNonPickable += 1;
-        return;
-      }
-      counters.candidateObjects += 1;
-      const toObject = new ControlVector3(
-        object.position.x - origin.x,
-        object.position.y - origin.y,
-        object.position.z - origin.z
-      );
-      const distanceAlongRay = dot(toObject, normalizedDirection);
-      if (distanceAlongRay < near || distanceAlongRay > far) {
-        counters.skippedOutOfRange += 1;
-        return;
-      }
-      const closestPoint = pointOnRay(origin, normalizedDirection, distanceAlongRay);
-      const perpendicularDistance = new ControlVector3(
-        object.position.x - closestPoint.x,
-        object.position.y - closestPoint.y,
-        object.position.z - closestPoint.z
-      ).length();
-      const radius = resolvePickRadius(object, metadata) + tolerance;
-      if (perpendicularDistance > radius) {
-        counters.skippedMissedRadius += 1;
-        nearestMissPerpendicularDistance = Math.min(nearestMissPerpendicularDistance, perpendicularDistance);
-        return;
-      }
-      const rayEntryDistance = Math.max(near, distanceAlongRay - Math.sqrt(Math.max(0, radius * radius - perpendicularDistance * perpendicularDistance)));
-      hits.push({
-        object,
-        distance: rayEntryDistance,
-        distanceAlongRay,
-        perpendicularDistance,
-        point: pointOnRay(origin, normalizedDirection, rayEntryDistance),
-        radius,
-        metadata
-      });
-    });
-
-    hits.sort(compareHits);
-    const hit = hits[0] ?? null;
-    return {
-      hit,
-      hits,
-      diagnostics: {
-        ...counters,
-        hitCount: hits.length,
-        nearestMissPerpendicularDistance: Number.isFinite(nearestMissPerpendicularDistance) ? nearestMissPerpendicularDistance : null,
-        nearestHitLabel: hit ? pickLabel(hit.object, hit.metadata) : null
-      }
-    };
-  }
-}
-
-function normalizedRayDirection(direction: Vector3Like): ControlVector3 {
-  const normalized = new ControlVector3(direction.x, direction.y, direction.z);
-  const length = normalized.length();
-  if (!Number.isFinite(length) || length <= 1e-8) {
-    throw new RangeError("Picking ray direction must be finite and non-zero.");
-  }
-  return normalized.set(normalized.x / length, normalized.y / length, normalized.z / length);
-}
-
-function finiteRange(value: number, label: string, minimum: number): number {
-  if (value === Number.POSITIVE_INFINITY && label === "far") return value;
-  if (!Number.isFinite(value) || value < minimum) {
-    throw new RangeError(`Picking ${label} must be finite and >= ${minimum}.`);
-  }
-  return value;
-}
-
-function resolvePickMetadata(object: ControlObject3DLike, options: PickingOptions): ControlPickMetadata | undefined {
-  return options.metadata?.(object)
-    ?? object.picking
-    ?? readUserDataMetadata(object.userData);
-}
-
-function readUserDataMetadata(userData: Record<string, unknown> | undefined): ControlPickMetadata | undefined {
-  const value = userData?.a3dPicking ?? userData?.picking;
-  if (!value || typeof value !== "object") return undefined;
-  return value as ControlPickMetadata;
-}
-
-function isPickableObject(
-  object: ControlObject3DLike,
-  metadata: ControlPickMetadata | undefined,
-  options: PickingOptions
-): boolean {
-  if (metadata && options.includeNonRenderableMetadata !== false) return true;
-  return object.type === "Mesh" || object.type === "Sprite" || object.type === "Points" || object.type === "LineSegments";
-}
-
-function resolvePickRadius(object: ControlObject3DLike, metadata: ControlPickMetadata | undefined): number {
-  const explicit = metadata?.pickRadius ?? object.pickRadius ?? readUserDataRadius(object.userData);
-  if (explicit !== undefined) return positiveFinite(explicit, "pickRadius");
-  const scale = object.scale;
-  if (!scale) return 0.5;
-  const radius = Math.max(Math.abs(scale.x), Math.abs(scale.y), Math.abs(scale.z)) * 0.5;
-  return Number.isFinite(radius) && radius > 0 ? radius : 0.5;
-}
-
-function readUserDataRadius(userData: Record<string, unknown> | undefined): number | undefined {
-  const value = userData?.a3dPickRadius;
-  return typeof value === "number" ? value : undefined;
-}
-
-function positiveFinite(value: number, label: string): number {
-  if (!Number.isFinite(value) || value <= 0) throw new RangeError(`Picking ${label} must be finite and positive.`);
-  return value;
-}
-
-function dot(left: Vector3Like, right: Vector3Like): number {
-  return left.x * right.x + left.y * right.y + left.z * right.z;
-}
-
-function pointOnRay(origin: Vector3Like, direction: Vector3Like, distance: number): ControlVector3 {
-  return new ControlVector3(
-    origin.x + direction.x * distance,
-    origin.y + direction.y * distance,
-    origin.z + direction.z * distance
-  );
-}
-
-function compareHits(left: ThreeCompatPickResult, right: ThreeCompatPickResult): number {
-  const distanceDelta = left.distance - right.distance;
-  if (Math.abs(distanceDelta) > 1e-8) return distanceDelta;
-  return pickPriority(right) - pickPriority(left);
-}
-
-function pickPriority(hit: ThreeCompatPickResult): number {
-  return hit.metadata?.priority ?? hit.object.pickPriority ?? 0;
-}
-
-function pickLabel(object: ControlObject3DLike, metadata: ControlPickMetadata | undefined): string | null {
-  return metadata?.label ?? metadata?.id ?? object.name ?? null;
-}

package/src/PickingAnnotations.ts

@@ -1,391 +0,0 @@
-import { Picking, type PickingOptions, type PickingReport, type ThreeCompatPickResult } from "./Picking";
-import { ControlVector3, type ControlObject3DLike, type ControlPickMetadata, type Vector3Like } from "./NativeControlTypes";
-
-export type PickingAnnotationKind = "hotspot" | "label" | "district" | "building" | "robot" | "entity";
-export type PickingAnnotationSource = "imported-gltf" | "procedural" | "screen-space";
-export type PickingAnnotationHitPolicy = "nearest" | "priority";
-
-export interface PickingAnnotation<TPayload = unknown> {
-  readonly id: string;
-  readonly label: string;
-  readonly kind: PickingAnnotationKind;
-  readonly position: Vector3Like | readonly [number, number, number];
-  readonly radius: number;
-  readonly priority?: number;
-  readonly group?: string;
-  readonly routeId?: string;
-  readonly source?: PickingAnnotationSource;
-  readonly selectable?: boolean;
-  readonly highlightable?: boolean;
-  readonly targetId?: string;
-  readonly payload?: TPayload;
-}
-
-export interface PickingAnnotationRoot<TPayload = unknown> extends ControlObject3DLike {
-  readonly type: "PickingAnnotationRoot";
-  readonly name: string;
-  readonly children: readonly PickingAnnotationObject<TPayload>[];
-}
-
-export interface PickingAnnotationObject<TPayload = unknown> extends ControlObject3DLike {
-  readonly type: "PickingAnnotation";
-  readonly name: string;
-  readonly picking: ControlPickMetadata;
-  readonly userData: {
-    readonly a3dPicking: ControlPickMetadata;
-    readonly a3dPickingAnnotation: PickingAnnotation<TPayload>;
-  };
-}
-
-export interface PickingAnnotationReport<TPayload = unknown> extends PickingReport {
-  readonly annotation: PickingAnnotation<TPayload> | null;
-  readonly annotations: readonly PickingAnnotation<TPayload>[];
-}
-
-export interface PickingAnnotationOptions extends PickingOptions {
-  readonly hitPolicy?: PickingAnnotationHitPolicy;
-}
-
-export interface ImportedGlbHotspotDescriptor<TPayload = unknown> {
-  readonly id?: string;
-  readonly nodeName?: string;
-  readonly label?: string;
-  readonly focusId?: string;
-  readonly position: Vector3Like | readonly [number, number, number];
-  readonly radius?: number;
-  readonly priority?: number;
-  readonly selectable?: boolean;
-  readonly highlightable?: boolean;
-  readonly payload?: TPayload;
-}
-
-export interface DistrictPickingDescriptor<TPayload = unknown> {
-  readonly id: string;
-  readonly label?: string;
-  readonly center: Vector3Like | readonly [number, number, number];
-  readonly radius: number;
-  readonly priority?: number;
-  readonly routeId?: string;
-  readonly payload?: TPayload;
-  readonly buildings?: readonly BuildingPickingDescriptor<TPayload>[];
-}
-
-export interface BuildingPickingDescriptor<TPayload = unknown> {
-  readonly id: string;
-  readonly label?: string;
-  readonly position: Vector3Like | readonly [number, number, number];
-  readonly radius: number;
-  readonly priority?: number;
-  readonly payload?: TPayload;
-}
-
-export interface EntityPickingDescriptor<TPayload = unknown> {
-  readonly id: string;
-  readonly label?: string;
-  readonly kind?: "robot" | "entity";
-  readonly position: Vector3Like | readonly [number, number, number];
-  readonly radius: number;
-  readonly priority?: number;
-  readonly group?: string;
-  readonly routeId?: string;
-  readonly payload?: TPayload;
-}
-
-export interface ScreenPickingAnnotation<TPayload = unknown> {
-  readonly id: string;
-  readonly label: string;
-  readonly kind: PickingAnnotationKind;
-  readonly x: number;
-  readonly y: number;
-  readonly radius: number;
-  readonly priority?: number;
-  readonly group?: string;
-  readonly routeId?: string;
-  readonly source?: PickingAnnotationSource;
-  readonly selectable?: boolean;
-  readonly highlightable?: boolean;
-  readonly targetId?: string;
-  readonly payload?: TPayload;
-}
-
-export interface ScreenPickingHit<TPayload = unknown> {
-  readonly annotation: ScreenPickingAnnotation<TPayload>;
-  readonly distance: number;
-}
-
-export interface ScreenPickingReport<TPayload = unknown> {
-  readonly hit: ScreenPickingHit<TPayload> | null;
-  readonly hits: readonly ScreenPickingHit<TPayload>[];
-  readonly diagnostics: {
-    readonly testedAnnotations: number;
-    readonly candidateAnnotations: number;
-    readonly hitCount: number;
-    readonly skippedDisabled: number;
-    readonly skippedOutOfRadius: number;
-    readonly nearestHitLabel: string | null;
-  };
-}
-
-export interface ScreenPickingOptions {
-  readonly tolerance?: number;
-  readonly hitPolicy?: PickingAnnotationHitPolicy;
-}
-
-export function createPickingAnnotationRoot<TPayload = unknown>(
-  name: string,
-  annotations: readonly PickingAnnotation<TPayload>[]
-): PickingAnnotationRoot<TPayload> {
-  return {
-    type: "PickingAnnotationRoot",
-    name,
-    position: new ControlVector3(),
-    children: annotations.map(createPickingAnnotationObject)
-  };
-}
-
-export function createPickingAnnotationObject<TPayload = unknown>(
-  annotation: PickingAnnotation<TPayload>
-): PickingAnnotationObject<TPayload> {
-  const radius = positiveFinite(annotation.radius, "annotation radius");
-  const metadata: ControlPickMetadata = {
-    id: annotation.id,
-    label: annotation.label,
-    kind: annotation.kind,
-    group: annotation.group,
-    selectable: annotation.selectable,
-    highlightable: annotation.highlightable,
-    pickRadius: radius,
-    priority: annotation.priority,
-    routeId: annotation.routeId,
-    source: annotation.source,
-    targetId: annotation.targetId,
-    payload: annotation.payload
-  };
-  return {
-    type: "PickingAnnotation",
-    name: annotation.label,
-    position: toVector3(annotation.position),
-    scale: new ControlVector3(radius * 2, radius * 2, radius * 2),
-    visible: annotation.selectable === false ? false : true,
-    pickRadius: radius,
-    pickPriority: annotation.priority,
-    picking: metadata,
-    userData: {
-      a3dPicking: metadata,
-      a3dPickingAnnotation: annotation
-    }
-  };
-}
-
-export function pickAnnotation<TPayload = unknown>(
-  root: ControlObject3DLike,
-  origin: Vector3Like = new ControlVector3(),
-  direction: Vector3Like = new ControlVector3(0, 0, -1),
-  options: PickingAnnotationOptions = {}
-): PickingAnnotationReport<TPayload> {
-  const report = new Picking().report(root, origin, direction, options);
-  const hits = options.hitPolicy === "priority"
-    ? [...report.hits].sort(compareAnnotationHitsByPriority)
-    : report.hits;
-  const hit = hits[0] ?? null;
-  return {
-    ...report,
-    hit,
-    hits,
-    annotation: hit ? annotationFromPickHit<TPayload>(hit) : null,
-    annotations: hits.map((candidate) => annotationFromPickHit<TPayload>(candidate)).filter((annotation): annotation is PickingAnnotation<TPayload> => Boolean(annotation))
-  };
-}
-
-export function annotationFromPickHit<TPayload = unknown>(
-  hit: ThreeCompatPickResult | null | undefined
-): PickingAnnotation<TPayload> | null {
-  const value = hit?.object.userData?.a3dPickingAnnotation;
-  return isPickingAnnotation(value) ? value as PickingAnnotation<TPayload> : null;
-}
-
-export function createImportedGlbHotspotAnnotations<TPayload = unknown>(
-  assetId: string,
-  hotspots: readonly ImportedGlbHotspotDescriptor<TPayload>[],
-  routeId?: string
-): readonly PickingAnnotation<TPayload>[] {
-  return hotspots.map((hotspot, index) => {
-    const targetId = hotspot.focusId ?? hotspot.nodeName ?? hotspot.id ?? `hotspot-${index}`;
-    return {
-      id: hotspot.id ?? `${assetId}:${targetId}`,
-      label: hotspot.label ?? readableLabel(targetId),
-      kind: "hotspot",
-      position: hotspot.position,
-      radius: hotspot.radius ?? 0.18,
-      priority: hotspot.priority ?? 100,
-      group: assetId,
-      routeId,
-      source: "imported-gltf",
-      selectable: hotspot.selectable,
-      highlightable: hotspot.highlightable ?? true,
-      targetId,
-      payload: hotspot.payload
-    };
-  });
-}
-
-export function createDistrictPickingAnnotations<TPayload = unknown>(
-  districts: readonly DistrictPickingDescriptor<TPayload>[]
-): readonly PickingAnnotation<TPayload>[] {
-  const annotations: PickingAnnotation<TPayload>[] = [];
-  for (const district of districts) {
-    annotations.push({
-      id: district.id,
-      label: district.label ?? readableLabel(district.id),
-      kind: "district",
-      position: district.center,
-      radius: district.radius,
-      priority: district.priority ?? 10,
-      group: "district",
-      routeId: district.routeId,
-      source: "procedural",
-      highlightable: true,
-      payload: district.payload
-    });
-    for (const building of district.buildings ?? []) {
-      annotations.push({
-        id: building.id,
-        label: building.label ?? readableLabel(building.id),
-        kind: "building",
-        position: building.position,
-        radius: building.radius,
-        priority: building.priority ?? 40,
-        group: district.id,
-        routeId: district.routeId,
-        source: "procedural",
-        highlightable: true,
-        payload: building.payload
-      });
-    }
-  }
-  return annotations;
-}
-
-export function createRobotPickingAnnotations<TPayload = unknown>(
-  robots: readonly EntityPickingDescriptor<TPayload>[]
-): readonly PickingAnnotation<TPayload>[] {
-  return createEntityPickingAnnotations(robots.map((robot) => ({ ...robot, kind: "robot" as const })), {
-    defaultGroup: "robot",
-    defaultPriority: 70
-  });
-}
-
-export function createEntityPickingAnnotations<TPayload = unknown>(
-  entities: readonly EntityPickingDescriptor<TPayload>[],
-  options: { readonly defaultGroup?: string; readonly defaultPriority?: number } = {}
-): readonly PickingAnnotation<TPayload>[] {
-  return entities.map((entity) => ({
-    id: entity.id,
-    label: entity.label ?? readableLabel(entity.id),
-    kind: entity.kind ?? "entity",
-    position: entity.position,
-    radius: entity.radius,
-    priority: entity.priority ?? options.defaultPriority ?? 50,
-    group: entity.group ?? options.defaultGroup,
-    routeId: entity.routeId,
-    source: "procedural",
-    highlightable: true,
-    targetId: entity.id,
-    payload: entity.payload
-  }));
-}
-
-export function pickScreenSpaceAnnotation<TPayload = unknown>(
-  pointer: { readonly x: number; readonly y: number },
-  annotations: readonly ScreenPickingAnnotation<TPayload>[],
-  options: ScreenPickingOptions = {}
-): ScreenPickingReport<TPayload> {
-  validateScreenPoint(pointer, "pointer");
-  const tolerance = options.tolerance ?? 0;
-  if (!Number.isFinite(tolerance) || tolerance < 0) throw new RangeError("Screen picking tolerance must be finite and non-negative.");
-  const hits: ScreenPickingHit<TPayload>[] = [];
-  let skippedDisabled = 0;
-  let skippedOutOfRadius = 0;
-
-  for (const annotation of annotations) {
-    if (annotation.selectable === false) {
-      skippedDisabled += 1;
-      continue;
-    }
-    validateScreenPoint(annotation, annotation.id);
-    const radius = positiveFinite(annotation.radius, `${annotation.id} screen radius`) + tolerance;
-    const distance = Math.hypot(pointer.x - annotation.x, pointer.y - annotation.y);
-    if (distance > radius) {
-      skippedOutOfRadius += 1;
-      continue;
-    }
-    hits.push({ annotation, distance });
-  }
-
-  hits.sort(options.hitPolicy === "priority" ? compareScreenHitsByPriority : compareScreenHitsByDistance);
-  const hit = hits[0] ?? null;
-  return {
-    hit,
-    hits,
-    diagnostics: {
-      testedAnnotations: annotations.length,
-      candidateAnnotations: annotations.length - skippedDisabled,
-      hitCount: hits.length,
-      skippedDisabled,
-      skippedOutOfRadius,
-      nearestHitLabel: hit?.annotation.label ?? null
-    }
-  };
-}
-
-function toVector3(value: Vector3Like | readonly [number, number, number]): ControlVector3 {
-  const tuple = value as readonly number[];
-  const vector = value as Vector3Like;
-  const x = Array.isArray(value) ? tuple[0] : vector.x;
-  const y = Array.isArray(value) ? tuple[1] : vector.y;
-  const z = Array.isArray(value) ? tuple[2] : vector.z;
-  if (!Number.isFinite(x) || !Number.isFinite(y) || !Number.isFinite(z)) {
-    throw new RangeError("Picking annotation position must contain three finite values.");
-  }
-  return new ControlVector3(x, y, z);
-}
-
-function positiveFinite(value: number, label: string): number {
-  if (!Number.isFinite(value) || value <= 0) throw new RangeError(`Picking ${label} must be finite and positive.`);
-  return value;
-}
-
-function readableLabel(value: string): string {
-  return value.replace(/[_:-]+/g, " ").replace(/\s+/g, " ").trim() || "Picking target";
-}
-
-function compareAnnotationHitsByPriority(left: ThreeCompatPickResult, right: ThreeCompatPickResult): number {
-  const priorityDelta = (right.metadata?.priority ?? 0) - (left.metadata?.priority ?? 0);
-  if (Math.abs(priorityDelta) > 1e-8) return priorityDelta;
-  return left.distance - right.distance;
-}
-
-function isPickingAnnotation(value: unknown): value is PickingAnnotation {
-  return Boolean(value)
-    && typeof value === "object"
-    && typeof (value as { readonly id?: unknown }).id === "string"
-    && typeof (value as { readonly label?: unknown }).label === "string";
-}
-
-function validateScreenPoint(point: { readonly x: number; readonly y: number }, label: string): void {
-  if (!Number.isFinite(point.x) || !Number.isFinite(point.y)) {
-    throw new RangeError(`Screen picking ${label} must contain finite x/y values.`);
-  }
-}
-
-function compareScreenHitsByDistance(left: ScreenPickingHit, right: ScreenPickingHit): number {
-  const distanceDelta = left.distance - right.distance;
-  if (Math.abs(distanceDelta) > 1e-8) return distanceDelta;
-  return (right.annotation.priority ?? 0) - (left.annotation.priority ?? 0);
-}
-
-function compareScreenHitsByPriority(left: ScreenPickingHit, right: ScreenPickingHit): number {
-  const priorityDelta = (right.annotation.priority ?? 0) - (left.annotation.priority ?? 0);
-  if (Math.abs(priorityDelta) > 1e-8) return priorityDelta;
-  return left.distance - right.distance;
-}

package/src/PointerLockControls.ts

@@ -1,15 +0,0 @@
-import { createDefaultControlState, type ThreeCompatControlState } from "./ControlState";
-
-export class PointerLockControls {
-  readonly state: ThreeCompatControlState = createDefaultControlState();
-  locked = false;
-
-  lock(): void { this.locked = true; }
-  unlock(): void { this.locked = false; }
-
-  look(deltaX: number, deltaY: number): void {
-    if (!this.locked) return;
-    this.state.rotation.y += deltaX;
-    this.state.rotation.x += deltaY;
-  }
-}

package/src/SelectionManager.ts

@@ -1,18 +0,0 @@
-import type { ControlObject3DLike } from "./NativeControlTypes";
-
-export class SelectionManager {
-  readonly selected = new Set<ControlObject3DLike>();
-
-  select(object: ControlObject3DLike, additive = false): void {
-    if (!additive) this.clear();
-    this.selected.add(object);
-  }
-
-  deselect(object: ControlObject3DLike): void {
-    this.selected.delete(object);
-  }
-
-  clear(): void {
-    this.selected.clear();
-  }
-}

package/src/TrackballControls.ts

@@ -1,116 +0,0 @@
-import { OrbitControls } from "./OrbitControls";
-
-export type TrackballKey =
-  | "ArrowUp"
-  | "ArrowDown"
-  | "ArrowLeft"
-  | "ArrowRight"
-  | "KeyQ"
-  | "KeyE"
-  | "NumpadAdd"
-  | "NumpadSubtract"
-  | "+"
-  | "-"
-  | "="
-  | "_";
-
-export class TrackballControls extends OrbitControls {
-  enableDamping = false;
-  dampingFactor = 0.08;
-  keyPanSpeed = 0.12;
-  keyRollSpeed = 0.06;
-
-  private rotationVelocity = { x: 0, y: 0, z: 0 };
-  private panVelocity = { x: 0, y: 0 };
-  private dollyVelocity = 0;
-
-  roll(delta: number): void {
-    if (!this.state.enabled || !this.enableRotate) return;
-    this.state.rotation.z += delta;
-    this.rotationVelocity.z += delta;
-  }
-
-  override rotate(deltaX: number, deltaY: number): void {
-    if (!this.state.enabled || !this.enableRotate) return;
-    super.rotate(deltaX, deltaY);
-    this.rotationVelocity.x += deltaY;
-    this.rotationVelocity.y += deltaX;
-  }
-
-  override pan(deltaX: number, deltaY: number): void {
-    if (!this.state.enabled || !this.enablePan) return;
-    super.pan(deltaX, deltaY);
-    this.panVelocity.x += deltaX;
-    this.panVelocity.y += deltaY;
-  }
-
-  override dolly(scale: number): void {
-    if (!this.state.enabled || !this.enableZoom) return;
-    super.dolly(scale);
-    this.dollyVelocity += scale - 1;
-  }
-
-  handleKey(code: TrackballKey): void {
-    switch (code) {
-      case "ArrowUp":
-        this.pan(0, this.keyPanSpeed);
-        break;
-      case "ArrowDown":
-        this.pan(0, -this.keyPanSpeed);
-        break;
-      case "ArrowLeft":
-        this.pan(-this.keyPanSpeed, 0);
-        break;
-      case "ArrowRight":
-        this.pan(this.keyPanSpeed, 0);
-        break;
-      case "KeyQ":
-        this.roll(-this.keyRollSpeed);
-        break;
-      case "KeyE":
-        this.roll(this.keyRollSpeed);
-        break;
-      case "NumpadAdd":
-      case "+":
-      case "=":
-        this.dolly(0.95);
-        break;
-      case "NumpadSubtract":
-      case "-":
-      case "_":
-        this.dolly(1.05);
-        break;
-    }
-  }
-
-  update(deltaSeconds = 1 / 60): boolean {
-    if (!this.enableDamping) {
-      return false;
-    }
-    const damping = Math.max(0, Math.min(1, this.dampingFactor * deltaSeconds * 60));
-    const rotationStep = {
-      x: this.rotationVelocity.x * damping,
-      y: this.rotationVelocity.y * damping,
-      z: this.rotationVelocity.z * damping
-    };
-    const panStep = {
-      x: this.panVelocity.x * damping,
-      y: this.panVelocity.y * damping
-    };
-    const dollyStep = this.dollyVelocity * damping;
-    this.state.rotation.x += rotationStep.x;
-    this.state.rotation.y += rotationStep.y;
-    this.state.rotation.z += rotationStep.z;
-    this.state.target.x += panStep.x;
-    this.state.target.y += panStep.y;
-    this.state.position.z *= 1 + dollyStep;
-    this.rotationVelocity.x -= rotationStep.x;
-    this.rotationVelocity.y -= rotationStep.y;
-    this.rotationVelocity.z -= rotationStep.z;
-    this.panVelocity.x -= panStep.x;
-    this.panVelocity.y -= panStep.y;
-    this.dollyVelocity -= dollyStep;
-    return Math.abs(this.rotationVelocity.x) + Math.abs(this.rotationVelocity.y) + Math.abs(this.rotationVelocity.z) +
-      Math.abs(this.panVelocity.x) + Math.abs(this.panVelocity.y) + Math.abs(this.dollyVelocity) > 1e-6;
-  }
-}

package/src/TransformControls.ts

@@ -1,19 +0,0 @@
-import { addVector3, type ControlObject3DLike, type Vector3Like } from "./NativeControlTypes";
-
-export type TransformControlMode = "translate" | "rotate" | "scale";
-
-export class TransformControls {
-  object: ControlObject3DLike | null = null;
-  mode: TransformControlMode = "translate";
-
-  attach(object: ControlObject3DLike): void { this.object = object; }
-  detach(): void { this.object = null; }
-  setMode(mode: TransformControlMode): void { this.mode = mode; }
-
-  apply(delta: Vector3Like): void {
-    if (!this.object) return;
-    if (this.mode === "translate") addVector3(this.object.position, delta);
-    if (this.mode === "rotate") addVector3(this.object.rotation, delta);
-    if (this.mode === "scale") addVector3(this.object.scale, delta);
-  }
-}

package/src/index.ts

@@ -1,58 +0,0 @@
-export { OrbitControls } from "./OrbitControls";
-export { TrackballControls } from "./TrackballControls";
-export { FlyControls } from "./FlyControls";
-export { FirstPersonControls } from "./FirstPersonControls";
-export { MapControls } from "./MapControls";
-export { PointerLockControls } from "./PointerLockControls";
-export { DragControls } from "./DragControls";
-export { TransformControls } from "./TransformControls";
-export type { TransformControlMode } from "./TransformControls";
-export { SelectionManager } from "./SelectionManager";
-export { InteractionControls } from "./InteractionControls";
-export type {
-  HotspotHandler,
-  InteractionControlMode,
-  InteractionControlsEvent,
-  InteractionControlsEventType,
-  InteractionControlsListener,
-  InteractionControlsOptions,
-  InteractionControlsUpdate,
-  InteractionRay,
-  InteractionRayProvider,
-  InteractionRootProvider
-} from "./InteractionControls";
-export { Picking } from "./Picking";
-export type { PickingDiagnostics, PickingOptions, PickingReport, ThreeCompatPickResult } from "./Picking";
-export {
-  annotationFromPickHit,
-  createDistrictPickingAnnotations,
-  createEntityPickingAnnotations,
-  createImportedGlbHotspotAnnotations,
-  createPickingAnnotationObject,
-  createPickingAnnotationRoot,
-  createRobotPickingAnnotations,
-  pickAnnotation,
-  pickScreenSpaceAnnotation
-} from "./PickingAnnotations";
-export type {
-  BuildingPickingDescriptor,
-  DistrictPickingDescriptor,
-  EntityPickingDescriptor,
-  ImportedGlbHotspotDescriptor,
-  PickingAnnotation,
-  PickingAnnotationHitPolicy,
-  PickingAnnotationKind,
-  PickingAnnotationObject,
-  PickingAnnotationOptions,
-  PickingAnnotationReport,
-  PickingAnnotationRoot,
-  PickingAnnotationSource,
-  ScreenPickingAnnotation,
-  ScreenPickingHit,
-  ScreenPickingOptions,
-  ScreenPickingReport
-} from "./PickingAnnotations";
-export { ControlVector3 } from "./NativeControlTypes";
-export type { ControlObject3DLike, ControlPickMetadata, Vector3Like } from "./NativeControlTypes";
-export { createDefaultControlState } from "./ControlState";
-export type { ThreeCompatControlEvent, ThreeCompatControlState } from "./ControlState";