@aura3d/controls 2.0.3 → 3.0.0

package/dist/ArcballControls.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Arcball controls (muse3jsparity-PRD N2).
+ *
+ * The r185 addon baseline ships `ArcballControls` alongside
+ * Orbit/Map/Trackball/Fly/FirstPerson; Aura3D had every neighbor but not
+ * this one. Like its siblings in this package it owns no DOM listeners —
+ * input arrives through `rotate`/`pan`/`dolly`/`applyPointer` calls (or the
+ * input-system snapshots the route already forwards) — so `dispose()` means
+ * detach + disable + drain velocities, idempotent, with no leaked listeners
+ * by construction (F1 hygiene standard).
+ *
+ * ## Parity vs three.js `ArcballControls` (r185)
+ *
+ * | Option / behavior              | three.js ArcballControls | This implementation |
+ * |--------------------------------|--------------------------|---------------------|
+ * | Free rotation (no polar clamp) | yes                      | yes (`rotate`)      |
+ * | Pan (screen-space truck)       | yes (`mouseActions.PAN`) | yes (`pan`)         |
+ * | Dolly with min/max distance    | yes                      | yes (`dolly`)       |
+ * | Damping (`enableDamping`)      | yes                      | yes (`update(dt)`)  |
+ * | Roll about the view axis       | via touch gestures       | yes (`roll`)        |
+ * | `cursorZoom` (zoom to cursor)  | yes                      | GAP — listed, not claimed (needs a projecting camera; the `OrbitCameraLike` surface here carries position only) |
+ * | Touch two-finger gestures      | yes                      | GAP — routes forward snapshots; pinch maps to `dolly`, two-finger drag to `pan` |
+ * | `adjustNearPlane`              | yes                      | GAP — near-plane ownership stays with the scene camera |
+ *
+ * No `three` imports: all vector math below is local.
+ */
+import { type ThreeCompatControlState } from "./ControlState.js";
+import type { Vector3Like } from "./NativeControlTypes.js";
+export interface ArcballCameraLike {
+    position: Vector3Like;
+    lookAt?(target: Vector3Like): void;
+}
+export interface ArcballControlsOptions {
+    readonly minDistance?: number;
+    readonly maxDistance?: number;
+    readonly enableDamping?: boolean;
+    readonly dampingFactor?: number;
+    readonly rotateSpeed?: number;
+    readonly panSpeed?: number;
+    readonly zoomSpeed?: number;
+}
+/**
+ * Camera-attached operation is the supported path: rotation orbits a real
+ * camera around `state.target` with no polar clamp (the Arcball distinction
+ * from Orbit). Detached operation (`new ArcballControls()`) accumulates
+ * yaw/pitch/roll bookkeeping on `state.rotation` and dolly on
+ * `state.position.z`, matching the sibling detached convention.
+ */
+export declare class ArcballControls {
+    readonly state: ThreeCompatControlState;
+    enableDamping: boolean;
+    dampingFactor: number;
+    rotateSpeed: number;
+    panSpeed: number;
+    zoomSpeed: number;
+    minDistance: number;
+    maxDistance: number;
+    private camera;
+    private yawVelocity;
+    private pitchVelocity;
+    private rollVelocity;
+    private panVelocity;
+    private dollyVelocity;
+    private disposed;
+    constructor(camera?: ArcballCameraLike, options?: ArcballControlsOptions);
+    /** True when a camera is attached and motion moves a real pose. */
+    get isCameraAttached(): boolean;
+    /** True after `dispose()`; every mutator is a no-op past this point. */
+    get isDisposed(): boolean;
+    getDistance(): number;
+    rotate(deltaX: number, deltaY: number): void;
+    roll(delta: number): void;
+    pan(deltaX: number, deltaY: number): void;
+    dolly(scale: number): void;
+    /**
+     * Damping tick. Returns true while velocity remains. With damping off this
+     * is a no-op returning false (mirrors the `TrackballControls` contract).
+     */
+    update(deltaSeconds?: number): boolean;
+    /**
+     * F1-standard disposal: disables the instance, detaches the camera so no
+     * further mutation is possible, drains pending velocity, and owns zero DOM
+     * listeners (input arrives via method calls), so nothing can leak.
+     * Idempotent.
+     */
+    dispose(): void;
+    private applyRotation;
+    private applyDolly;
+    private clampOffset;
+    private panShift;
+}
+//# sourceMappingURL=ArcballControls.d.ts.map

package/dist/ArcballControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArcballControls.d.ts","sourceRoot":"","sources":["../../../../packages/controls/src/ArcballControls.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAA6B,KAAK,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;CACpC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAyCD;;;;;;GAMG;AACH,qBAAa,eAAe;IAC1B,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAA+B;IACtE,aAAa,EAAE,OAAO,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IAEpB,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,CAAC,EAAE,iBAAiB,EAAE,OAAO,GAAE,sBAA2B;IAkB5E,mEAAmE;IACnE,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED,wEAAwE;IACxE,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,WAAW,IAAI,MAAM;IAWrB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAW5C,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAOzB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAkBzC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ1B;;;OAGG;IACH,MAAM,CAAC,YAAY,SAAS,GAAG,OAAO;IA8BtC;;;;;OAKG;IACH,OAAO,IAAI,IAAI;IAYf,OAAO,CAAC,aAAa;IA8BrB,OAAO,CAAC,UAAU;IAuBlB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,QAAQ;CAejB"}

package/dist/ArcballControls.js

@@ -0,0 +1,286 @@
+/**
+ * Arcball controls (muse3jsparity-PRD N2).
+ *
+ * The r185 addon baseline ships `ArcballControls` alongside
+ * Orbit/Map/Trackball/Fly/FirstPerson; Aura3D had every neighbor but not
+ * this one. Like its siblings in this package it owns no DOM listeners —
+ * input arrives through `rotate`/`pan`/`dolly`/`applyPointer` calls (or the
+ * input-system snapshots the route already forwards) — so `dispose()` means
+ * detach + disable + drain velocities, idempotent, with no leaked listeners
+ * by construction (F1 hygiene standard).
+ *
+ * ## Parity vs three.js `ArcballControls` (r185)
+ *
+ * | Option / behavior              | three.js ArcballControls | This implementation |
+ * |--------------------------------|--------------------------|---------------------|
+ * | Free rotation (no polar clamp) | yes                      | yes (`rotate`)      |
+ * | Pan (screen-space truck)       | yes (`mouseActions.PAN`) | yes (`pan`)         |
+ * | Dolly with min/max distance    | yes                      | yes (`dolly`)       |
+ * | Damping (`enableDamping`)      | yes                      | yes (`update(dt)`)  |
+ * | Roll about the view axis       | via touch gestures       | yes (`roll`)        |
+ * | `cursorZoom` (zoom to cursor)  | yes                      | GAP — listed, not claimed (needs a projecting camera; the `OrbitCameraLike` surface here carries position only) |
+ * | Touch two-finger gestures      | yes                      | GAP — routes forward snapshots; pinch maps to `dolly`, two-finger drag to `pan` |
+ * | `adjustNearPlane`              | yes                      | GAP — near-plane ownership stays with the scene camera |
+ *
+ * No `three` imports: all vector math below is local.
+ */
+import { createDefaultControlState } from "./ControlState.js";
+const UP = { x: 0, y: 1, z: 0 };
+function assertFinite(value, field) {
+    if (!Number.isFinite(value)) {
+        throw new RangeError(`ArcballControls ${field} must be finite (received ${String(value)}).`);
+    }
+}
+function sub(a, b) {
+    return { x: a.x - b.x, y: a.y - b.y, z: a.z - b.z };
+}
+function cross(a, b) {
+    return {
+        x: a.y * b.z - a.z * b.y,
+        y: a.z * b.x - a.x * b.z,
+        z: a.x * b.y - a.y * b.x
+    };
+}
+function normalize(v) {
+    const length = Math.hypot(v.x, v.y, v.z);
+    if (!(length > 1e-12))
+        return { x: 0, y: 0, z: 0 };
+    return { x: v.x / length, y: v.y / length, z: v.z / length };
+}
+/** Rodrigues rotation of `v` about unit axis `k` by `angle` radians. */
+function rotateAboutAxis(v, k, angle) {
+    const cos = Math.cos(angle);
+    const sin = Math.sin(angle);
+    const dot = v.x * k.x + v.y * k.y + v.z * k.z;
+    const crossed = cross(k, v);
+    return {
+        x: v.x * cos + crossed.x * sin + k.x * dot * (1 - cos),
+        y: v.y * cos + crossed.y * sin + k.y * dot * (1 - cos),
+        z: v.z * cos + crossed.z * sin + k.z * dot * (1 - cos)
+    };
+}
+/**
+ * Camera-attached operation is the supported path: rotation orbits a real
+ * camera around `state.target` with no polar clamp (the Arcball distinction
+ * from Orbit). Detached operation (`new ArcballControls()`) accumulates
+ * yaw/pitch/roll bookkeeping on `state.rotation` and dolly on
+ * `state.position.z`, matching the sibling detached convention.
+ */
+export class ArcballControls {
+    state = createDefaultControlState();
+    enableDamping;
+    dampingFactor;
+    rotateSpeed;
+    panSpeed;
+    zoomSpeed;
+    minDistance;
+    maxDistance;
+    camera;
+    yawVelocity = 0;
+    pitchVelocity = 0;
+    rollVelocity = 0;
+    panVelocity = { x: 0, y: 0 };
+    dollyVelocity = 0;
+    disposed = false;
+    constructor(camera, options = {}) {
+        this.minDistance = options.minDistance ?? 0.5;
+        this.maxDistance = options.maxDistance ?? 60;
+        this.enableDamping = options.enableDamping ?? false;
+        this.dampingFactor = options.dampingFactor ?? 0.08;
+        this.rotateSpeed = options.rotateSpeed ?? 0.005;
+        this.panSpeed = options.panSpeed ?? 0.01;
+        this.zoomSpeed = options.zoomSpeed ?? 1;
+        if (this.minDistance < 0)
+            throw new RangeError("ArcballControls minDistance must be >= 0.");
+        if (this.maxDistance < this.minDistance) {
+            throw new RangeError("ArcballControls maxDistance must be >= minDistance.");
+        }
+        if (camera) {
+            this.camera = camera;
+            this.state.position.set(camera.position.x, camera.position.y, camera.position.z);
+        }
+    }
+    /** True when a camera is attached and motion moves a real pose. */
+    get isCameraAttached() {
+        return this.camera !== undefined;
+    }
+    /** True after `dispose()`; every mutator is a no-op past this point. */
+    get isDisposed() {
+        return this.disposed;
+    }
+    getDistance() {
+        if (this.camera) {
+            return Math.hypot(this.camera.position.x - this.state.target.x, this.camera.position.y - this.state.target.y, this.camera.position.z - this.state.target.z);
+        }
+        return this.state.position.z;
+    }
+    rotate(deltaX, deltaY) {
+        assertFinite(deltaX, "deltaX");
+        assertFinite(deltaY, "deltaY");
+        if (this.disposed || !this.state.enabled)
+            return;
+        const yaw = -deltaX * this.rotateSpeed;
+        const pitch = -deltaY * this.rotateSpeed;
+        this.applyRotation(yaw, pitch, 0);
+        this.yawVelocity += yaw;
+        this.pitchVelocity += pitch;
+    }
+    roll(delta) {
+        assertFinite(delta, "roll delta");
+        if (this.disposed || !this.state.enabled)
+            return;
+        this.applyRotation(0, 0, delta);
+        this.rollVelocity += delta;
+    }
+    pan(deltaX, deltaY) {
+        assertFinite(deltaX, "pan deltaX");
+        assertFinite(deltaY, "pan deltaY");
+        if (this.disposed || !this.state.enabled)
+            return;
+        const shift = this.panShift(deltaX, deltaY);
+        this.state.target.x += shift.x;
+        this.state.target.y += shift.y;
+        this.state.target.z += shift.z;
+        if (this.camera) {
+            this.camera.position.x += shift.x;
+            this.camera.position.y += shift.y;
+            this.camera.position.z += shift.z;
+            this.camera.lookAt?.(this.state.target);
+        }
+        this.panVelocity.x += deltaX;
+        this.panVelocity.y += deltaY;
+    }
+    dolly(scale) {
+        assertFinite(scale, "dolly scale");
+        if (this.disposed || !this.state.enabled)
+            return;
+        if (scale <= 0)
+            throw new RangeError("ArcballControls dolly scale must be > 0.");
+        this.applyDolly(scale);
+        this.dollyVelocity += scale - 1;
+    }
+    /**
+     * Damping tick. Returns true while velocity remains. With damping off this
+     * is a no-op returning false (mirrors the `TrackballControls` contract).
+     */
+    update(deltaSeconds = 1 / 60) {
+        if (this.disposed || !this.enableDamping)
+            return false;
+        assertFinite(deltaSeconds, "deltaSeconds");
+        const damping = Math.max(0, Math.min(1, this.dampingFactor * deltaSeconds * 60));
+        this.applyRotation(this.yawVelocity * damping, this.pitchVelocity * damping, this.rollVelocity * damping);
+        const pan = this.panShift(this.panVelocity.x * damping, this.panVelocity.y * damping);
+        this.state.target.x += pan.x;
+        this.state.target.y += pan.y;
+        this.state.target.z += pan.z;
+        if (this.camera) {
+            this.camera.position.x += pan.x;
+            this.camera.position.y += pan.y;
+            this.camera.position.z += pan.z;
+        }
+        this.applyDolly(1 + this.dollyVelocity * damping);
+        this.yawVelocity -= this.yawVelocity * damping;
+        this.pitchVelocity -= this.pitchVelocity * damping;
+        this.rollVelocity -= this.rollVelocity * damping;
+        this.panVelocity.x -= this.panVelocity.x * damping;
+        this.panVelocity.y -= this.panVelocity.y * damping;
+        this.dollyVelocity -= this.dollyVelocity * damping;
+        if (this.camera)
+            this.camera.lookAt?.(this.state.target);
+        return Math.abs(this.yawVelocity) + Math.abs(this.pitchVelocity) + Math.abs(this.rollVelocity) +
+            Math.abs(this.panVelocity.x) + Math.abs(this.panVelocity.y) + Math.abs(this.dollyVelocity) > 1e-6;
+    }
+    /**
+     * F1-standard disposal: disables the instance, detaches the camera so no
+     * further mutation is possible, drains pending velocity, and owns zero DOM
+     * listeners (input arrives via method calls), so nothing can leak.
+     * Idempotent.
+     */
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.state.enabled = false;
+        this.camera = undefined;
+        this.yawVelocity = 0;
+        this.pitchVelocity = 0;
+        this.rollVelocity = 0;
+        this.panVelocity = { x: 0, y: 0 };
+        this.dollyVelocity = 0;
+    }
+    applyRotation(yaw, pitch, roll) {
+        if (yaw === 0 && pitch === 0 && roll === 0)
+            return;
+        const camera = this.camera;
+        if (!camera) {
+            this.state.rotation.y += yaw;
+            this.state.rotation.x += pitch;
+            this.state.rotation.z += roll;
+            return;
+        }
+        let offset = sub(camera.position, this.state.target);
+        if (yaw !== 0)
+            offset = rotateAboutAxis(offset, UP, yaw);
+        if (pitch !== 0 || roll !== 0) {
+            const viewDir = normalize({ x: -offset.x, y: -offset.y, z: -offset.z });
+            const right = normalize(cross(viewDir, UP));
+            if (pitch !== 0 && (right.x !== 0 || right.y !== 0 || right.z !== 0)) {
+                offset = rotateAboutAxis(offset, right, pitch);
+            }
+            if (roll !== 0)
+                offset = rotateAboutAxis(offset, viewDir, roll);
+        }
+        offset = this.clampOffset(offset);
+        camera.position.x = this.state.target.x + offset.x;
+        camera.position.y = this.state.target.y + offset.y;
+        camera.position.z = this.state.target.z + offset.z;
+        this.state.position.set(camera.position.x, camera.position.y, camera.position.z);
+        this.state.rotation.y += yaw;
+        this.state.rotation.x += pitch;
+        this.state.rotation.z += roll;
+        camera.lookAt?.(this.state.target);
+    }
+    applyDolly(scale) {
+        const camera = this.camera;
+        if (!camera) {
+            this.state.position.z = Math.min(this.maxDistance, Math.max(this.minDistance, this.state.position.z * scale));
+            return;
+        }
+        const offset = this.clampOffset(sub(camera.position, this.state.target));
+        const scaled = {
+            x: offset.x * scale,
+            y: offset.y * scale,
+            z: offset.z * scale
+        };
+        const clamped = this.clampOffset(scaled);
+        camera.position.x = this.state.target.x + clamped.x;
+        camera.position.y = this.state.target.y + clamped.y;
+        camera.position.z = this.state.target.z + clamped.z;
+        this.state.position.set(camera.position.x, camera.position.y, camera.position.z);
+        camera.lookAt?.(this.state.target);
+    }
+    clampOffset(offset) {
+        const length = Math.hypot(offset.x, offset.y, offset.z);
+        if (!(length > 1e-12))
+            return { x: 0, y: 0, z: this.minDistance };
+        const clamped = Math.min(this.maxDistance, Math.max(this.minDistance, length));
+        return { x: offset.x / length * clamped, y: offset.y / length * clamped, z: offset.z / length * clamped };
+    }
+    panShift(deltaX, deltaY) {
+        const distance = Math.max(this.minDistance, this.getDistance());
+        const scale = this.panSpeed * distance * 0.12;
+        const camera = this.camera;
+        if (!camera)
+            return { x: deltaX * scale, y: -deltaY * scale, z: 0 };
+        const offset = sub(camera.position, this.state.target);
+        const viewDir = normalize({ x: -offset.x, y: -offset.y, z: -offset.z });
+        const right = normalize(cross(viewDir, UP));
+        const up = normalize(cross(right, viewDir));
+        return {
+            x: (right.x * -deltaX + up.x * deltaY) * scale,
+            y: (right.y * -deltaX + up.y * deltaY) * scale,
+            z: (right.z * -deltaX + up.z * deltaY) * scale
+        };
+    }
+}
+//# sourceMappingURL=ArcballControls.js.map

package/dist/ArcballControls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArcballControls.js","sourceRoot":"","sources":["../../../../packages/controls/src/ArcballControls.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,yBAAyB,EAAgC,MAAM,gBAAgB,CAAC;AAkBzF,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AAEhC,SAAS,YAAY,CAAC,KAAa,EAAE,KAAa;IAChD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,UAAU,CAAC,mBAAmB,KAAK,6BAA6B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/F,CAAC;AACH,CAAC;AAED,SAAS,GAAG,CAAC,CAAc,EAAE,CAAc;IACzC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;AACtD,CAAC;AAED,SAAS,KAAK,CAAC,CAAc,EAAE,CAAc;IAC3C,OAAO;QACL,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACxB,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QACxB,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,CAAc;IAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACzC,IAAI,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IACnD,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC;AAC/D,CAAC;AAED,wEAAwE;AACxE,SAAS,eAAe,CAAC,CAAc,EAAE,CAAc,EAAE,KAAa;IACpE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,OAAO;QACL,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,OAAO,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;QACtD,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,OAAO,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;QACtD,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,OAAO,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;KACvD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,eAAe;IACjB,KAAK,GAA4B,yBAAyB,EAAE,CAAC;IACtE,aAAa,CAAU;IACvB,aAAa,CAAS;IACtB,WAAW,CAAS;IACpB,QAAQ,CAAS;IACjB,SAAS,CAAS;IAClB,WAAW,CAAS;IACpB,WAAW,CAAS;IAEZ,MAAM,CAAgC;IACtC,WAAW,GAAG,CAAC,CAAC;IAChB,aAAa,GAAG,CAAC,CAAC;IAClB,YAAY,GAAG,CAAC,CAAC;IACjB,WAAW,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IAC7B,aAAa,GAAG,CAAC,CAAC;IAClB,QAAQ,GAAG,KAAK,CAAC;IAEzB,YAAY,MAA0B,EAAE,UAAkC,EAAE;QAC1E,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,GAAG,CAAC;QAC9C,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;QAC7C,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,KAAK,CAAC;QACpD,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC;QACnD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,KAAK,CAAC;QAChD,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC;QACxC,IAAI,IAAI,CAAC,WAAW,GAAG,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,2CAA2C,CAAC,CAAC;QAC5F,IAAI,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YACxC,MAAM,IAAI,UAAU,CAAC,qDAAqD,CAAC,CAAC;QAC9E,CAAC;QACD,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YACrB,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;IAED,mEAAmE;IACnE,IAAI,gBAAgB;QAClB,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC;IACnC,CAAC;IAED,wEAAwE;IACxE,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,WAAW;QACT,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,KAAK,CACf,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAC5C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAC5C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAC7C,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,MAAc,EAAE,MAAc;QACnC,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC/B,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO;YAAE,OAAO;QACjD,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;QACvC,MAAM,KAAK,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;QACzC,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAClC,IAAI,CAAC,WAAW,IAAI,GAAG,CAAC;QACxB,IAAI,CAAC,aAAa,IAAI,KAAK,CAAC;IAC9B,CAAC;IAED,IAAI,CAAC,KAAa;QAChB,YAAY,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;QAClC,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO;YAAE,OAAO;QACjD,IAAI,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;QAChC,IAAI,CAAC,YAAY,IAAI,KAAK,CAAC;IAC7B,CAAC;IAED,GAAG,CAAC,MAAc,EAAE,MAAc;QAChC,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACnC,YAAY,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO;YAAE,OAAO;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,MAAM,CAAC;QAC7B,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,MAAM,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,KAAa;QACjB,YAAY,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QACnC,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO;YAAE,OAAO;QACjD,IAAI,KAAK,IAAI,CAAC;YAAE,MAAM,IAAI,UAAU,CAAC,0CAA0C,CAAC,CAAC;QACjF,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QACvB,IAAI,CAAC,aAAa,IAAI,KAAK,GAAG,CAAC,CAAC;IAClC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,YAAY,GAAG,CAAC,GAAG,EAAE;QAC1B,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,aAAa;YAAE,OAAO,KAAK,CAAC;QACvD,YAAY,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;QAC3C,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,IAAI,CAAC,aAAa,CAChB,IAAI,CAAC,WAAW,GAAG,OAAO,EAC1B,IAAI,CAAC,aAAa,GAAG,OAAO,EAC5B,IAAI,CAAC,YAAY,GAAG,OAAO,CAC5B,CAAC;QACF,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC;QACtF,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;QAC7B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC;QAC/C,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;QACnD,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC;QACjD,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,OAAO,CAAC;QACnD,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,OAAO,CAAC;QACnD,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC;QACnD,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACzD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC;YAC5F,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;IAED;;;;;OAKG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;QACrB,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;QACvB,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,WAAW,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QAClC,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;IACzB,CAAC;IAEO,aAAa,CAAC,GAAW,EAAE,KAAa,EAAE,IAAY;QAC5D,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC;YAAE,OAAO;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,GAAG,CAAC;YAC7B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,KAAK,CAAC;YAC/B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC;YAC9B,OAAO;QACT,CAAC;QACD,IAAI,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACrD,IAAI,GAAG,KAAK,CAAC;YAAE,MAAM,GAAG,eAAe,CAAC,MAAM,EAAE,EAAE,EAAE,GAAG,CAAC,CAAC;QACzD,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,OAAO,GAAG,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;YACxE,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;YAC5C,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;gBACrE,MAAM,GAAG,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YACjD,CAAC;YACD,IAAI,IAAI,KAAK,CAAC;gBAAE,MAAM,GAAG,eAAe,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAClE,CAAC;QACD,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;QACnD,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,GAAG,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,KAAK,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC;QAC9B,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAEO,UAAU,CAAC,KAAa;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAC9B,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,KAAK,CAAC,CAC1D,CAAC;YACF,OAAO;QACT,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG;YACb,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,KAAK;YACnB,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,KAAK;YACnB,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,KAAK;SACpB,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;QACpD,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;QACpD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACjF,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAEO,WAAW,CAAC,MAAmB;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QACxD,IAAI,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;QAClE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/E,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,GAAG,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,GAAG,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,GAAG,OAAO,EAAE,CAAC;IAC5G,CAAC;IAEO,QAAQ,CAAC,MAAc,EAAE,MAAc;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAChE,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,GAAG,QAAQ,GAAG,IAAI,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAAC,EAAE,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACpE,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACvD,MAAM,OAAO,GAAG,SAAS,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;QACxE,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5C,MAAM,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;QAC5C,OAAO;YACL,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,KAAK;YAC9C,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,KAAK;YAC9C,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,KAAK;SAC/C,CAAC;IACJ,CAAC;CACF"}

package/dist/DragControls.d.ts

@@ -20,9 +20,22 @@ export interface DragControlsOptions {
 export declare class DragControls {
     dragging: ControlObject3DLike | null;
     readonly transforms: TransformControls;
+    private disposed;
+    private readonly ownsTransforms;
     constructor(options?: DragControlsOptions);
+    /** True after `dispose()`; `start`/`drag` are no-ops past this point. */
+    get isDisposed(): boolean;
     start(object: ControlObject3DLike): void;
     drag(delta: Vector3Like): void;
     end(): void;
+    /**
+     * F1-standard disposal: ends any active drag, detaches the object, and
+     * disposes the owned transform helper (a caller-supplied `transforms`
+     * instance is left undisposed — its owner disposes it). Idempotent. Owns
+     * zero DOM listeners, so nothing can leak.
+     */
+    dispose(options?: {
+        readonly disposeTransforms?: boolean;
+    }): void;
 }
 //# sourceMappingURL=DragControls.d.ts.map

package/dist/DragControls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DragControls.d.ts","sourceRoot":"","sources":["../../../../packages/controls/src/DragControls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,6EAA6E,CAAC;IACpG,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,yBAAyB,EAAE,uBAItC,CAAC;AAEH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;CACzC;AAED;;;;;;;GAOG;AACH,qBAAa,YAAY;IACvB,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAQ;IAC5C,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;gBAE3B,OAAO,GAAE,mBAAwB;IAI7C,KAAK,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAMxC,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAK9B,GAAG,IAAI,IAAI;CAIZ"}
+{"version":3,"file":"DragControls.d.ts","sourceRoot":"","sources":["../../../../packages/controls/src/DragControls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,6EAA6E,CAAC;IACpG,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,yBAAyB,EAAE,uBAItC,CAAC;AAEH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,CAAC,EAAE,iBAAiB,CAAC;CACzC;AAED;;;;;;;GAOG;AACH,qBAAa,YAAY;IACvB,QAAQ,EAAE,mBAAmB,GAAG,IAAI,CAAQ;IAC5C,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAU;gBAE7B,OAAO,GAAE,mBAAwB;IAK7C,yEAAyE;IACzE,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,KAAK,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI;IAOxC,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI;IAK9B,GAAG,IAAI,IAAI;IAKX;;;;;OAKG;IACH,OAAO,CAAC,OAAO,GAAE;QAAE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;CAMtE"}

package/dist/DragControls.js

@@ -15,16 +15,25 @@ export const DRAG_CONTROLS_DEPRECATION = Object.freeze({
 export class DragControls {
     dragging = null;
     transforms;
+    disposed = false;
+    ownsTransforms;
     constructor(options = {}) {
         this.transforms = options.transforms ?? new TransformControls();
+        this.ownsTransforms = options.transforms === undefined;
+    }
+    /** True after `dispose()`; `start`/`drag` are no-ops past this point. */
+    get isDisposed() {
+        return this.disposed;
     }
     start(object) {
+        if (this.disposed)
+            return;
         this.dragging = object;
         this.transforms.attach(object);
         this.transforms.setMode("translate");
     }
     drag(delta) {
-        if (!this.dragging)
+        if (this.disposed || !this.dragging)
             return;
         this.transforms.apply(delta);
     }
@@ -32,5 +41,19 @@ export class DragControls {
         this.dragging = null;
         this.transforms.detach();
     }
+    /**
+     * F1-standard disposal: ends any active drag, detaches the object, and
+     * disposes the owned transform helper (a caller-supplied `transforms`
+     * instance is left undisposed — its owner disposes it). Idempotent. Owns
+     * zero DOM listeners, so nothing can leak.
+     */
+    dispose(options = {}) {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.end();
+        if ((options.disposeTransforms ?? this.ownsTransforms))
+            this.transforms.dispose();
+    }
 }
 //# sourceMappingURL=DragControls.js.map

package/dist/DragControls.js.map

@@ -1 +1 @@
-{"version":3,"file":"DragControls.js","sourceRoot":"","sources":["../../../../packages/controls/src/DragControls.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAQxD,MAAM,CAAC,MAAM,yBAAyB,GAA4B,MAAM,CAAC,MAAM,CAAC;IAC9E,MAAM,EAAE,YAAY;IACpB,WAAW,EAAE,6EAA6E;IAC1F,UAAU,EAAE,0JAA0J;CACvK,CAAC,CAAC;AAMH;;;;;;;GAOG;AACH,MAAM,OAAO,YAAY;IACvB,QAAQ,GAA+B,IAAI,CAAC;IACnC,UAAU,CAAoB;IAEvC,YAAY,UAA+B,EAAE;QAC3C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,iBAAiB,EAAE,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,MAA2B;QAC/B,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC;QACvB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,CAAC,KAAkB;QACrB,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC3B,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;IAC3B,CAAC;CACF"}
+{"version":3,"file":"DragControls.js","sourceRoot":"","sources":["../../../../packages/controls/src/DragControls.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAQxD,MAAM,CAAC,MAAM,yBAAyB,GAA4B,MAAM,CAAC,MAAM,CAAC;IAC9E,MAAM,EAAE,YAAY;IACpB,WAAW,EAAE,6EAA6E;IAC1F,UAAU,EAAE,0JAA0J;CACvK,CAAC,CAAC;AAMH;;;;;;;GAOG;AACH,MAAM,OAAO,YAAY;IACvB,QAAQ,GAA+B,IAAI,CAAC;IACnC,UAAU,CAAoB;IAC/B,QAAQ,GAAG,KAAK,CAAC;IACR,cAAc,CAAU;IAEzC,YAAY,UAA+B,EAAE;QAC3C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,iBAAiB,EAAE,CAAC;QAChE,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,UAAU,KAAK,SAAS,CAAC;IACzD,CAAC;IAED,yEAAyE;IACzE,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,MAA2B;QAC/B,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC;QACvB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,CAAC,KAAkB;QACrB,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC5C,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC;IAC3B,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,UAAoD,EAAE;QAC5D,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,GAAG,EAAE,CAAC;QACX,IAAI,CAAC,OAAO,CAAC,iBAAiB,IAAI,IAAI,CAAC,cAAc,CAAC;YAAE,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;IACpF,CAAC;CACF"}

package/dist/FlyControls.d.ts

@@ -31,15 +31,24 @@ export declare class FlyControls {
     protected readonly controlledCamera: FlyCameraLike;
     protected pointerLookSpeed: number;
     private delegate;
+    private disposed;
     constructor(camera?: FlyCameraLike, options?: FlyControlsOptions);
     /** True for every instance: even the no-camera form owns a delegated state camera. */
     get isDelegated(): true;
+    /** True after `dispose()`; every mutator is a no-op past this point. */
+    get isDisposed(): boolean;
     get enabled(): boolean;
     set enabled(value: boolean);
     applyInput(snapshot: InputSnapshot, deltaSeconds: number): void;
     moveForward(distance: number): void;
     strafe(distance: number): void;
     lift(distance: number): void;
+    /**
+     * F1-standard disposal: disables the instance and delegates (the input
+     * engine owns zero DOM listeners — motion arrives via snapshots — so
+     * nothing can leak). Idempotent; mutators stay no-ops afterwards even if
+     * `enabled` is reassigned.
+     */
     dispose(): void;
     protected replaceDelegate(delegate: FlyControlsDelegate, pointerLookSpeed: number): void;
     protected lookByRadians(deltaYaw: number, deltaPitch: number, button: number): void;

package/dist/FlyControls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FlyControls.d.ts","sourceRoot":"","sources":["../../../../packages/controls/src/FlyControls.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EACb,KAAK,wBAAwB,EAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EAA6B,KAAK,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC;CACjC;AAED,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,wBAAwB,EAAE,WAAW,CAAC;IACrF;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,UAAU,mBAAmB;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5D,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAA+B;IACtE,aAAa,EAAE,MAAM,CAAC;IAEtB,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC;IACnD,SAAS,CAAC,gBAAgB,EAAE,MAAM,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAsB;gBAE1B,MAAM,CAAC,EAAE,aAAa,EAAE,OAAO,GAAE,kBAAuB;IAepE,sFAAsF;IACtF,IAAI,WAAW,IAAI,IAAI,CAEtB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAGzB;IAED,UAAU,CAAC,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAI/D,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAYnC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAU9B,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAU5B,OAAO,IAAI,IAAI;IAKf,SAAS,CAAC,eAAe,CAAC,QAAQ,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAQxF,SAAS,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAiBnF,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,SAAS;CAKlB"}
+{"version":3,"file":"FlyControls.d.ts","sourceRoot":"","sources":["../../../../packages/controls/src/FlyControls.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,aAAa,EACb,KAAK,wBAAwB,EAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EAA6B,KAAK,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AACzF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC;CACjC;AAED,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,wBAAwB,EAAE,WAAW,CAAC;IACrF;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,UAAU,mBAAmB;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5D,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAA+B;IACtE,aAAa,EAAE,MAAM,CAAC;IAEtB,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC;IACnD,SAAS,CAAC,gBAAgB,EAAE,MAAM,CAAC;IACnC,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,CAAC,EAAE,aAAa,EAAE,OAAO,GAAE,kBAAuB;IAepE,sFAAsF;IACtF,IAAI,WAAW,IAAI,IAAI,CAEtB;IAED,wEAAwE;IACxE,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,OAAO,CAAC,KAAK,EAAE,OAAO,EAGzB;IAED,UAAU,CAAC,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAI/D,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAYnC,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAU9B,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAU5B;;;;;OAKG;IACH,OAAO,IAAI,IAAI;IAOf,SAAS,CAAC,eAAe,CAAC,QAAQ,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAYxF,SAAS,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAiBnF,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,SAAS;CAKlB"}

package/dist/FlyControls.js

@@ -14,6 +14,7 @@ export class FlyControls {
     controlledCamera;
     pointerLookSpeed;
     delegate;
+    disposed = false;
     constructor(camera, options = {}) {
         this.movementSpeed = options.movementSpeed ?? 1;
         this.pointerLookSpeed = options.lookSpeed ?? 0.0025;
@@ -32,6 +33,10 @@ export class FlyControls {
     get isDelegated() {
         return true;
     }
+    /** True after `dispose()`; every mutator is a no-op past this point. */
+    get isDisposed() {
+        return this.disposed;
+    }
     get enabled() {
         return this.state.enabled;
     }
@@ -65,11 +70,24 @@ export class FlyControls {
             return;
         this.updateDelegate(keySnapshot(movement > 0 ? "KeyE" : "KeyQ"), Math.abs(movement));
     }
+    /**
+     * F1-standard disposal: disables the instance and delegates (the input
+     * engine owns zero DOM listeners — motion arrives via snapshots — so
+     * nothing can leak). Idempotent; mutators stay no-ops afterwards even if
+     * `enabled` is reassigned.
+     */
     dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
         this.state.enabled = false;
         this.delegate.dispose();
     }
     replaceDelegate(delegate, pointerLookSpeed) {
+        if (this.disposed) {
+            delegate.dispose();
+            return;
+        }
         this.delegate.dispose();
         this.delegate = delegate;
         this.pointerLookSpeed = pointerLookSpeed;
@@ -79,7 +97,7 @@ export class FlyControls {
     lookByRadians(deltaYaw, deltaPitch, button) {
         assertFinite(deltaYaw, "yaw delta");
         assertFinite(deltaPitch, "pitch delta");
-        if (!this.state.enabled || (deltaYaw === 0 && deltaPitch === 0))
+        if (this.disposed || !this.state.enabled || (deltaYaw === 0 && deltaPitch === 0))
             return;
         const speed = Math.abs(this.pointerLookSpeed) > Number.EPSILON ? this.pointerLookSpeed : 1;
         this.updateDelegate(new InputSnapshot({
@@ -92,7 +110,7 @@ export class FlyControls {
     }
     updateDelegate(snapshot, deltaSeconds) {
         assertFinite(deltaSeconds, "delta seconds");
-        if (!this.state.enabled)
+        if (this.disposed || !this.state.enabled)
             return;
         this.delegate.enabled = true;
         this.delegate.update(snapshot, deltaSeconds);

package/dist/FlyControls.js.map

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

package/dist/FocusFrame.d.ts

@@ -0,0 +1,34 @@
+import type { ControlObject3DLike, Vector3Like } from "./NativeControlTypes.js";
+export interface FocusFrameTarget {
+    readonly center: Vector3Like;
+    readonly radius: number;
+}
+export interface FocusFrameOptions {
+    /** Vertical field of view in degrees. */
+    readonly fovDegrees?: number;
+    /** Margin multiplier around the framing sphere (>= 1). */
+    readonly margin?: number;
+    /** Clamp for the resulting distance. */
+    readonly minDistance?: number;
+    readonly maxDistance?: number;
+}
+export interface FocusFrameResult {
+    readonly target: Vector3Like;
+    readonly distance: number;
+    readonly radius: number;
+    readonly objectCount: number;
+}
+/**
+ * Focus framing for editor/viewport selection (F4).
+ *
+ * Computes the orbit target and camera distance that frames a set of picked
+ * objects given a vertical field of view: the bounding sphere of the object
+ * centers (expanded by each object's pick radius) is placed at `target`, and
+ * `distance` fits that sphere with `margin` headroom. Pure math — a viewport
+ * applies the result to its own camera, and the browser proof asserts the
+ * framed object lands centered with the expected apparent size.
+ */
+export declare function frameSelection(objects: readonly ControlObject3DLike[], options?: FocusFrameOptions): FocusFrameResult | undefined;
+/** Builds a focus target from an explicit center/radius pair (e.g. bounds math). */
+export declare function frameTarget(target: FocusFrameTarget, options?: FocusFrameOptions): FocusFrameResult;
+//# sourceMappingURL=FocusFrame.d.ts.map

package/dist/FocusFrame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FocusFrame.d.ts","sourceRoot":"","sources":["../../../../packages/controls/src/FocusFrame.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,wCAAwC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,mBAAmB,EAAE,EACvC,OAAO,GAAE,iBAAsB,GAC9B,gBAAgB,GAAG,SAAS,CAmD9B;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,GAAE,iBAAsB,GAAG,gBAAgB,CAQvG"}