@aura3d/engine 1.0.0

package/dist/controls/InteractionControls.d.ts

@@ -0,0 +1,83 @@
+import { InputSnapshot } from "@aura3d/input";
+import { FlyControls } from "./FlyControls";
+import { OrbitControls } from "./OrbitControls";
+import { Picking, type PickingOptions, type PickingReport, type ThreeCompatPickResult } from "./Picking";
+import { 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 declare class InteractionControls {
+    readonly orbit: OrbitControls;
+    readonly fly: FlyControls;
+    readonly picking: Picking;
+    enabled: boolean;
+    private controlMode;
+    private rootRef?;
+    private rayProvider?;
+    private pickOptions;
+    private readonly listeners;
+    private readonly hotspotHandlers;
+    private hoverHit;
+    private disposed;
+    private readonly rotateButton;
+    private readonly panButton;
+    private readonly rotateSpeed;
+    private readonly panSpeed;
+    private readonly dollySpeed;
+    private readonly flyMoveSpeed;
+    constructor(options?: InteractionControlsOptions);
+    get mode(): InteractionControlMode;
+    setMode(mode: InteractionControlMode, snapshot?: InputSnapshot): void;
+    setRoot(root: ControlObject3DLike | InteractionRootProvider | undefined): void;
+    setRayProvider(provider: InteractionRayProvider | undefined): void;
+    setPickOptions(options: PickingOptions): void;
+    subscribe(listener: InteractionControlsListener): () => void;
+    onHotspot(id: string, handler: HotspotHandler): () => void;
+    update(snapshot: InputSnapshot): InteractionControlsUpdate;
+    pick(snapshot: InputSnapshot): PickingReport | undefined;
+    dispose(): void;
+    private updateOrbit;
+    private updateFly;
+    private updatePicking;
+    private emitHotspot;
+    private emit;
+    private resolveRoot;
+    private resolveRay;
+}
+//# sourceMappingURL=InteractionControls.d.ts.map

package/dist/controls/InteractionControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InteractionControls.d.ts","sourceRoot":"","sources":["../../../../packages/controls/src/InteractionControls.ts"],"names":[],"mappings":"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"}

package/dist/controls/InteractionControls.js

@@ -0,0 +1,163 @@
+import { InputSnapshot } from "../input/index.js";
+import { FlyControls } from "./FlyControls.js";
+import { OrbitControls } from "./OrbitControls.js";
+import { Picking } from "./Picking.js";
+import { ControlVector3 } from "./NativeControlTypes.js";
+export class InteractionControls {
+    orbit;
+    fly;
+    picking;
+    enabled = true;
+    controlMode;
+    rootRef;
+    rayProvider;
+    pickOptions;
+    listeners = new Set();
+    hotspotHandlers = new Map();
+    hoverHit = null;
+    disposed = false;
+    rotateButton;
+    panButton;
+    rotateSpeed;
+    panSpeed;
+    dollySpeed;
+    flyMoveSpeed;
+    constructor(options = {}) {
+        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() {
+        return this.controlMode;
+    }
+    setMode(mode, snapshot = new InputSnapshot()) {
+        if (this.controlMode === mode)
+            return;
+        this.controlMode = mode;
+        this.emit({ type: "mode-change", mode, snapshot });
+    }
+    setRoot(root) {
+        this.rootRef = root;
+        this.hoverHit = null;
+    }
+    setRayProvider(provider) {
+        this.rayProvider = provider;
+    }
+    setPickOptions(options) {
+        this.pickOptions = options;
+    }
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    onHotspot(id, handler) {
+        const handlers = this.hotspotHandlers.get(id) ?? new Set();
+        handlers.add(handler);
+        this.hotspotHandlers.set(id, handlers);
+        return () => {
+            handlers.delete(handler);
+            if (handlers.size === 0)
+                this.hotspotHandlers.delete(id);
+        };
+    }
+    update(snapshot) {
+        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) {
+        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() {
+        this.disposed = true;
+        this.listeners.clear();
+        this.hotspotHandlers.clear();
+        this.hoverHit = null;
+    }
+    updateOrbit(snapshot) {
+        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));
+        }
+    }
+    updateFly(snapshot) {
+        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);
+    }
+    updatePicking(snapshot) {
+        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", mode: this.controlMode, snapshot, hit, previousHit: previousHit ?? undefined };
+            this.emit(event);
+            this.emitHotspot(event);
+        }
+        return pickReport;
+    }
+    emitHotspot(event) {
+        const id = event.hit.metadata?.id ?? event.hit.object.name;
+        if (!id)
+            return;
+        const hotspotEvent = { ...event, type: "hotspot-click" };
+        this.emit(hotspotEvent);
+        for (const handler of [...(this.hotspotHandlers.get(id) ?? [])]) {
+            handler(hotspotEvent);
+        }
+    }
+    emit(event) {
+        for (const listener of [...this.listeners])
+            listener(event);
+    }
+    resolveRoot() {
+        return typeof this.rootRef === "function" ? this.rootRef() : this.rootRef;
+    }
+    resolveRay(snapshot) {
+        return this.rayProvider?.(snapshot) ?? {
+            origin: new ControlVector3(),
+            direction: new ControlVector3(0, 0, -1)
+        };
+    }
+}
+//# sourceMappingURL=InteractionControls.js.map

package/dist/controls/InteractionControls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InteractionControls.js","sourceRoot":"","sources":["../../../../packages/controls/src/InteractionControls.ts"],"names":[],"mappings":"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"}

package/dist/controls/MapControls.d.ts

@@ -0,0 +1,6 @@
+import { OrbitControls } from "./OrbitControls";
+export declare class MapControls extends OrbitControls {
+    readonly screenSpacePanning = false;
+    truck(deltaX: number, deltaZ: number): void;
+}
+//# sourceMappingURL=MapControls.d.ts.map

package/dist/controls/MapControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapControls.d.ts","sourceRoot":"","sources":["../../../../packages/controls/src/MapControls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,qBAAa,WAAY,SAAQ,aAAa;IAC5C,QAAQ,CAAC,kBAAkB,SAAS;IAEpC,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CAI5C"}

package/dist/controls/MapControls.js

@@ -0,0 +1,9 @@
+import { OrbitControls } from "./OrbitControls.js";
+export class MapControls extends OrbitControls {
+    screenSpacePanning = false;
+    truck(deltaX, deltaZ) {
+        this.state.target.x += deltaX;
+        this.state.target.z += deltaZ;
+    }
+}
+//# sourceMappingURL=MapControls.js.map

package/dist/controls/MapControls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapControls.js","sourceRoot":"","sources":["../../../../packages/controls/src/MapControls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,MAAM,OAAO,WAAY,SAAQ,aAAa;IACnC,kBAAkB,GAAG,KAAK,CAAC;IAEpC,KAAK,CAAC,MAAc,EAAE,MAAc;QAClC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC;QAC9B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC;IAChC,CAAC;CACF"}

package/dist/controls/NativeControlTypes.d.ts

@@ -0,0 +1,49 @@
+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 declare class ControlVector3 implements Vector3Like {
+    x: number;
+    y: number;
+    z: number;
+    constructor(x?: number, y?: number, z?: number);
+    set(x: number, y: number, z: number): this;
+    copy(value: Vector3Like): this;
+    clone(): ControlVector3;
+    add(value: Vector3Like): this;
+    sub(value: Vector3Like): this;
+    length(): number;
+    normalize(): 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 declare function addVector3(target: Vector3Like | undefined, delta: Vector3Like): void;
+export declare function traverseControlObject(root: ControlObject3DLike, callback: (object: ControlObject3DLike) => void): void;
+//# sourceMappingURL=NativeControlTypes.d.ts.map

package/dist/controls/NativeControlTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeControlTypes.d.ts","sourceRoot":"","sources":["../../../../packages/controls/src/NativeControlTypes.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,qBAAa,cAAe,YAAW,WAAW;IAC7B,CAAC;IAAa,CAAC;IAAa,CAAC;gBAA7B,CAAC,SAAI,EAAS,CAAC,SAAI,EAAS,CAAC,SAAI;IAEpD,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAO1C,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAI9B,KAAK,IAAI,cAAc;IAIvB,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAO7B,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAO7B,MAAM,IAAI,MAAM;IAIhB,SAAS,IAAI,IAAI;CAIlB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,GAAG,IAAI,CAAC;CAClE;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAKpF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,EAAE,QAAQ,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,GAAG,IAAI,CAOtH"}

package/dist/controls/NativeControlTypes.js

@@ -0,0 +1,58 @@
+export class ControlVector3 {
+    x;
+    y;
+    z;
+    constructor(x = 0, y = 0, z = 0) {
+        this.x = x;
+        this.y = y;
+        this.z = z;
+    }
+    set(x, y, z) {
+        this.x = x;
+        this.y = y;
+        this.z = z;
+        return this;
+    }
+    copy(value) {
+        return this.set(value.x, value.y, value.z);
+    }
+    clone() {
+        return new ControlVector3(this.x, this.y, this.z);
+    }
+    add(value) {
+        this.x += value.x;
+        this.y += value.y;
+        this.z += value.z;
+        return this;
+    }
+    sub(value) {
+        this.x -= value.x;
+        this.y -= value.y;
+        this.z -= value.z;
+        return this;
+    }
+    length() {
+        return Math.hypot(this.x, this.y, this.z);
+    }
+    normalize() {
+        const length = this.length();
+        return length > 0 ? this.set(this.x / length, this.y / length, this.z / length) : this;
+    }
+}
+export function addVector3(target, delta) {
+    if (!target)
+        return;
+    target.x += delta.x;
+    target.y += delta.y;
+    target.z += delta.z;
+}
+export function traverseControlObject(root, callback) {
+    if (typeof root.traverse === "function") {
+        root.traverse(callback);
+        return;
+    }
+    callback(root);
+    for (const child of root.children ?? [])
+        traverseControlObject(child, callback);
+}
+//# sourceMappingURL=NativeControlTypes.js.map

package/dist/controls/NativeControlTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeControlTypes.js","sourceRoot":"","sources":["../../../../packages/controls/src/NativeControlTypes.ts"],"names":[],"mappings":"AAqBA,MAAM,OAAO,cAAc;IACN;IAAc;IAAc;IAA/C,YAAmB,IAAI,CAAC,EAAS,IAAI,CAAC,EAAS,IAAI,CAAC;QAAjC,MAAC,GAAD,CAAC,CAAI;QAAS,MAAC,GAAD,CAAC,CAAI;QAAS,MAAC,GAAD,CAAC,CAAI;IAAG,CAAC;IAExD,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;QACjC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,KAAkB;QACrB,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK;QACH,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,GAAG,CAAC,KAAkB;QACpB,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAAC,KAAkB;QACpB,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,SAAS;QACP,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC7B,OAAO,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,CAAC,GAAG,MAAM,EAAE,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACzF,CAAC;CACF;AAiBD,MAAM,UAAU,UAAU,CAAC,MAA+B,EAAE,KAAkB;IAC5E,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;IACpB,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;IACpB,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAyB,EAAE,QAA+C;IAC9G,IAAI,OAAO,IAAI,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACxB,OAAO;IACT,CAAC;IACD,QAAQ,CAAC,IAAI,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE;QAAE,qBAAqB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;AAClF,CAAC"}

package/dist/controls/OrbitControls.d.ts

@@ -0,0 +1,11 @@
+import { type ThreeCompatControlState } from "./ControlState";
+export declare class OrbitControls {
+    readonly state: ThreeCompatControlState;
+    enablePan: boolean;
+    enableZoom: boolean;
+    enableRotate: boolean;
+    rotate(deltaX: number, deltaY: number): void;
+    pan(deltaX: number, deltaY: number): void;
+    dolly(scale: number): void;
+}
+//# sourceMappingURL=OrbitControls.d.ts.map

package/dist/controls/OrbitControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrbitControls.d.ts","sourceRoot":"","sources":["../../../../packages/controls/src/OrbitControls.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAEzF,qBAAa,aAAa;IACxB,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAA+B;IACtE,SAAS,UAAQ;IACjB,UAAU,UAAQ;IAClB,YAAY,UAAQ;IAEpB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAM5C,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAMzC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAI3B"}

package/dist/controls/OrbitControls.js

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

package/dist/controls/OrbitControls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OrbitControls.js","sourceRoot":"","sources":["../../../../packages/controls/src/OrbitControls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAgC,MAAM,gBAAgB,CAAC;AAEzF,MAAM,OAAO,aAAa;IACf,KAAK,GAA4B,yBAAyB,EAAE,CAAC;IACtE,SAAS,GAAG,IAAI,CAAC;IACjB,UAAU,GAAG,IAAI,CAAC;IAClB,YAAY,GAAG,IAAI,CAAC;IAEpB,MAAM,CAAC,MAAc,EAAE,MAAc;QACnC,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,OAAO;QAC/B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,MAAM,CAAC;IAClC,CAAC;IAED,GAAG,CAAC,MAAc,EAAE,MAAc;QAChC,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC;QAC9B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,KAAa;QACjB,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,OAAO;QAC7B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,KAAK,CAAC;IACjC,CAAC;CACF"}

package/dist/controls/Picking.d.ts

@@ -0,0 +1,41 @@
+import { ControlVector3, 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 declare class Picking {
+    pick(root: ControlObject3DLike, origin?: Vector3Like, direction?: Vector3Like, options?: PickingOptions): ThreeCompatPickResult | null;
+    pickAll(root: ControlObject3DLike, origin?: Vector3Like, direction?: Vector3Like, options?: PickingOptions): readonly ThreeCompatPickResult[];
+    report(root: ControlObject3DLike, origin?: Vector3Like, direction?: Vector3Like, options?: PickingOptions): PickingReport;
+}
+//# sourceMappingURL=Picking.d.ts.map

package/dist/controls/Picking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Picking.d.ts","sourceRoot":"","sources":["../../../../packages/controls/src/Picking.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EAEd,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EACjB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;CACzC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,4BAA4B,CAAC,EAAE,OAAO,CAAC;IAChD,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,mBAAmB,GAAG,SAAS,CAAC;CACtF;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,gCAAgC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzD,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CACzC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,qBAAqB,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,SAAS,qBAAqB,EAAE,CAAC;IAChD,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;CAC1C;AAED,qBAAa,OAAO;IAClB,IAAI,CACF,IAAI,EAAE,mBAAmB,EACzB,MAAM,GAAE,WAAkC,EAC1C,SAAS,GAAE,WAA0C,EACrD,OAAO,GAAE,cAAmB,GAC3B,qBAAqB,GAAG,IAAI;IAI/B,OAAO,CACL,IAAI,EAAE,mBAAmB,EACzB,MAAM,GAAE,WAAkC,EAC1C,SAAS,GAAE,WAA0C,EACrD,OAAO,GAAE,cAAmB,GAC3B,SAAS,qBAAqB,EAAE;IAInC,MAAM,CACJ,IAAI,EAAE,mBAAmB,EACzB,MAAM,GAAE,WAAkC,EAC1C,SAAS,GAAE,WAA0C,EACrD,OAAO,GAAE,cAAmB,GAC3B,aAAa;CAgFjB"}

package/dist/controls/Picking.js

@@ -0,0 +1,149 @@
+import { ControlVector3, traverseControlObject } from "./NativeControlTypes.js";
+export class Picking {
+    pick(root, origin = new ControlVector3(), direction = new ControlVector3(0, 0, -1), options = {}) {
+        return this.report(root, origin, direction, options).hit;
+    }
+    pickAll(root, origin = new ControlVector3(), direction = new ControlVector3(0, 0, -1), options = {}) {
+        return this.report(root, origin, direction, options).hits;
+    }
+    report(root, origin = new ControlVector3(), direction = new ControlVector3(0, 0, -1), options = {}) {
+        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 = [];
+        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) {
+    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, label, minimum) {
+    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, options) {
+    return options.metadata?.(object)
+        ?? object.picking
+        ?? readUserDataMetadata(object.userData);
+}
+function readUserDataMetadata(userData) {
+    const value = userData?.a3dPicking ?? userData?.picking;
+    if (!value || typeof value !== "object")
+        return undefined;
+    return value;
+}
+function isPickableObject(object, metadata, options) {
+    if (metadata && options.includeNonRenderableMetadata !== false)
+        return true;
+    return object.type === "Mesh" || object.type === "Sprite" || object.type === "Points" || object.type === "LineSegments";
+}
+function resolvePickRadius(object, metadata) {
+    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) {
+    const value = userData?.a3dPickRadius;
+    return typeof value === "number" ? value : undefined;
+}
+function positiveFinite(value, label) {
+    if (!Number.isFinite(value) || value <= 0)
+        throw new RangeError(`Picking ${label} must be finite and positive.`);
+    return value;
+}
+function dot(left, right) {
+    return left.x * right.x + left.y * right.y + left.z * right.z;
+}
+function pointOnRay(origin, direction, distance) {
+    return new ControlVector3(origin.x + direction.x * distance, origin.y + direction.y * distance, origin.z + direction.z * distance);
+}
+function compareHits(left, right) {
+    const distanceDelta = left.distance - right.distance;
+    if (Math.abs(distanceDelta) > 1e-8)
+        return distanceDelta;
+    return pickPriority(right) - pickPriority(left);
+}
+function pickPriority(hit) {
+    return hit.metadata?.priority ?? hit.object.pickPriority ?? 0;
+}
+function pickLabel(object, metadata) {
+    return metadata?.label ?? metadata?.id ?? object.name ?? null;
+}
+//# sourceMappingURL=Picking.js.map