@aura3d/controls 1.0.6

package/dist/TrackballControls.js

@@ -0,0 +1,99 @@
+import { OrbitControls } from "./OrbitControls.js";
+export class TrackballControls extends OrbitControls {
+    enableDamping = false;
+    dampingFactor = 0.08;
+    keyPanSpeed = 0.12;
+    keyRollSpeed = 0.06;
+    rotationVelocity = { x: 0, y: 0, z: 0 };
+    panVelocity = { x: 0, y: 0 };
+    dollyVelocity = 0;
+    roll(delta) {
+        if (!this.state.enabled || !this.enableRotate)
+            return;
+        this.state.rotation.z += delta;
+        this.rotationVelocity.z += delta;
+    }
+    rotate(deltaX, deltaY) {
+        if (!this.state.enabled || !this.enableRotate)
+            return;
+        super.rotate(deltaX, deltaY);
+        this.rotationVelocity.x += deltaY;
+        this.rotationVelocity.y += deltaX;
+    }
+    pan(deltaX, deltaY) {
+        if (!this.state.enabled || !this.enablePan)
+            return;
+        super.pan(deltaX, deltaY);
+        this.panVelocity.x += deltaX;
+        this.panVelocity.y += deltaY;
+    }
+    dolly(scale) {
+        if (!this.state.enabled || !this.enableZoom)
+            return;
+        super.dolly(scale);
+        this.dollyVelocity += scale - 1;
+    }
+    handleKey(code) {
+        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) {
+        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;
+    }
+}
+//# sourceMappingURL=TrackballControls.js.map

package/dist/TrackballControls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrackballControls.js","sourceRoot":"","sources":["../../../../packages/controls/src/TrackballControls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAgBhD,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAClD,aAAa,GAAG,KAAK,CAAC;IACtB,aAAa,GAAG,IAAI,CAAC;IACrB,WAAW,GAAG,IAAI,CAAC;IACnB,YAAY,GAAG,IAAI,CAAC;IAEZ,gBAAgB,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IACxC,WAAW,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAC7B,aAAa,GAAG,CAAC,CAAC;IAE1B,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,OAAO;QACtD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,KAAK,CAAC;QAC/B,IAAI,CAAC,gBAAgB,CAAC,CAAC,IAAI,KAAK,CAAC;IACnC,CAAC;IAEQ,MAAM,CAAC,MAAc,EAAE,MAAc;QAC5C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,OAAO;QACtD,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7B,IAAI,CAAC,gBAAgB,CAAC,CAAC,IAAI,MAAM,CAAC;QAClC,IAAI,CAAC,gBAAgB,CAAC,CAAC,IAAI,MAAM,CAAC;IACpC,CAAC;IAEQ,GAAG,CAAC,MAAc,EAAE,MAAc;QACzC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QACnD,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1B,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,MAAM,CAAC;QAC7B,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,MAAM,CAAC;IAC/B,CAAC;IAEQ,KAAK,CAAC,KAAa;QAC1B,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,OAAO;QACpD,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACnB,IAAI,CAAC,aAAa,IAAI,KAAK,GAAG,CAAC,CAAC;IAClC,CAAC;IAED,SAAS,CAAC,IAAkB;QAC1B,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,SAAS;gBACZ,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;gBAC9B,MAAM;YACR,KAAK,WAAW;gBACd,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBAC/B,MAAM;YACR,KAAK,WAAW;gBACd,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;gBAC/B,MAAM;YACR,KAAK,YAAY;gBACf,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;gBAC9B,MAAM;YACR,KAAK,MAAM;gBACT,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAC9B,MAAM;YACR,KAAK,MAAM;gBACT,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAC7B,MAAM;YACR,KAAK,WAAW,CAAC;YACjB,KAAK,GAAG,CAAC;YACT,KAAK,GAAG;gBACN,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACjB,MAAM;YACR,KAAK,gBAAgB,CAAC;YACtB,KAAK,GAAG,CAAC;YACT,KAAK,GAAG;gBACN,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACjB,MAAM;QACV,CAAC;IACH,CAAC;IAED,MAAM,CAAC,YAAY,GAAG,CAAC,GAAG,EAAE;QAC1B,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,aAAa,GAAG,YAAY,GAAG,EAAE,CAAC,CAAC,CAAC;QACjF,MAAM,YAAY,GAAG;YACnB,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC,GAAG,OAAO;YACpC,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC,GAAG,OAAO;YACpC,CAAC,EAAE,IAAI,CAAC,gBAAgB,CAAC,CAAC,GAAG,OAAO;SACrC,CAAC;QACF,MAAM,OAAO,GAAG;YACd,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,OAAO;YAC/B,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,OAAO;SAChC,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;QAC/C,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;QACvC,IAAI,CAAC,gBAAgB,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,gBAAgB,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,gBAAgB,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,aAAa,IAAI,SAAS,CAAC;QAChC,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;YAC9G,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC;IACtG,CAAC;CACF"}

package/dist/TransformControls.d.ts

@@ -0,0 +1,11 @@
+import { type ControlObject3DLike, type Vector3Like } from "./NativeControlTypes";
+export type TransformControlMode = "translate" | "rotate" | "scale";
+export declare class TransformControls {
+    object: ControlObject3DLike | null;
+    mode: TransformControlMode;
+    attach(object: ControlObject3DLike): void;
+    detach(): void;
+    setMode(mode: TransformControlMode): void;
+    apply(delta: Vector3Like): void;
+}
+//# sourceMappingURL=TransformControls.d.ts.map

package/dist/TransformControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransformControls.d.ts","sourceRoot":"","sources":["../../../../packages/controls/src/TransformControls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,mBAAmB,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE9F,MAAM,MAAM,oBAAoB,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEpE,qBAAa,iBAAiB;IAC5B,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAQ;IAC1C,IAAI,EAAE,oBAAoB,CAAe;IAEzC,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IACzC,MAAM,IAAI,IAAI;IACd,OAAO,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI;IAEzC,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;CAMhC"}

package/dist/TransformControls.js

@@ -0,0 +1,19 @@
+import { addVector3 } from "./NativeControlTypes.js";
+export class TransformControls {
+    object = null;
+    mode = "translate";
+    attach(object) { this.object = object; }
+    detach() { this.object = null; }
+    setMode(mode) { this.mode = mode; }
+    apply(delta) {
+        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);
+    }
+}
+//# sourceMappingURL=TransformControls.js.map

package/dist/TransformControls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransformControls.js","sourceRoot":"","sources":["../../../../packages/controls/src/TransformControls.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA8C,MAAM,sBAAsB,CAAC;AAI9F,MAAM,OAAO,iBAAiB;IAC5B,MAAM,GAA+B,IAAI,CAAC;IAC1C,IAAI,GAAyB,WAAW,CAAC;IAEzC,MAAM,CAAC,MAA2B,IAAU,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IACnE,MAAM,KAAW,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IACtC,OAAO,CAAC,IAA0B,IAAU,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC;IAE/D,KAAK,CAAC,KAAkB;QACtB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;YAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACvE,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACpE,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;YAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAClE,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+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";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/controls/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EACV,cAAc,EACd,sBAAsB,EACtB,wBAAwB,EACxB,4BAA4B,EAC5B,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,cAAc,EACd,sBAAsB,EACtB,uBAAuB,EACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,YAAY,EAAE,kBAAkB,EAAE,cAAc,EAAE,aAAa,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAC1G,OAAO,EACL,qBAAqB,EACrB,gCAAgC,EAChC,8BAA8B,EAC9B,mCAAmC,EACnC,6BAA6B,EAC7B,2BAA2B,EAC3B,6BAA6B,EAC7B,cAAc,EACd,yBAAyB,EAC1B,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,yBAAyB,EACzB,yBAAyB,EACzB,uBAAuB,EACvB,4BAA4B,EAC5B,iBAAiB,EACjB,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,gBAAgB,EAChB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAClG,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,YAAY,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+export { OrbitControls } from "./OrbitControls.js";
+export { TrackballControls } from "./TrackballControls.js";
+export { FlyControls } from "./FlyControls.js";
+export { FirstPersonControls } from "./FirstPersonControls.js";
+export { MapControls } from "./MapControls.js";
+export { PointerLockControls } from "./PointerLockControls.js";
+export { DragControls } from "./DragControls.js";
+export { TransformControls } from "./TransformControls.js";
+export { SelectionManager } from "./SelectionManager.js";
+export { InteractionControls } from "./InteractionControls.js";
+export { Picking } from "./Picking.js";
+export { annotationFromPickHit, createDistrictPickingAnnotations, createEntityPickingAnnotations, createImportedGlbHotspotAnnotations, createPickingAnnotationObject, createPickingAnnotationRoot, createRobotPickingAnnotations, pickAnnotation, pickScreenSpaceAnnotation } from "./PickingAnnotations.js";
+export { ControlVector3 } from "./NativeControlTypes.js";
+export { createDefaultControlState } from "./ControlState.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/controls/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAa5D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EACL,qBAAqB,EACrB,gCAAgC,EAChC,8BAA8B,EAC9B,mCAAmC,EACnC,6BAA6B,EAC7B,2BAA2B,EAC3B,6BAA6B,EAC7B,cAAc,EACd,yBAAyB,EAC1B,MAAM,sBAAsB,CAAC;AAmB9B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC"}

package/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "@aura3d/controls",
+  "version": "1.0.6",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@aura3d/input": "1.0.6"
+  }
+}

package/src/ControlState.ts

@@ -0,0 +1,24 @@
+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

@@ -0,0 +1,17 @@
+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

@@ -0,0 +1,8 @@
+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

@@ -0,0 +1,14 @@
+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

@@ -0,0 +1,224 @@
+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

@@ -0,0 +1,10 @@
+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

@@ -0,0 +1,93 @@
+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

@@ -0,0 +1,25 @@
+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;
+  }
+}