@aura3d/engine 3.0.0 → 4.0.0

package/dist/engine/agent-api/camera/ease.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Easing table for C-22 `AuraEaseName` (lane-08 export; PRD 09 tweens import
+ * this same module). Names are frozen in contracts/camera.ts.
+ */
+import type { AuraEaseName } from "../../contracts/camera.js";
+export declare const ease: Record<AuraEaseName, (t: number) => number>;
+//# sourceMappingURL=ease.d.ts.map

package/dist/engine/agent-api/camera/ease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ease.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/camera/ease.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAM9D,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,MAAM,CAa5D,CAAC"}

package/dist/engine/agent-api/camera/ease.js

@@ -0,0 +1,17 @@
+const c1 = 1.70158;
+const c2 = c1 * 1.525;
+const c4 = (2 * Math.PI) / 3;
+export const ease = {
+    linear: (t) => t,
+    inQuad: (t) => t * t,
+    outQuad: (t) => 1 - (1 - t) * (1 - t),
+    inOutQuad: (t) => (t < 0.5 ? 2 * t * t : 1 - Math.pow(-2 * t + 2, 2) / 2),
+    inCubic: (t) => t * t * t,
+    outCubic: (t) => 1 - Math.pow(1 - t, 3),
+    inOutCubic: (t) => (t < 0.5 ? 4 * t * t * t : 1 - Math.pow(-2 * t + 2, 3) / 2),
+    outBack: (t) => 1 + (c1 + 1) * Math.pow(t - 1, 3) + c1 * Math.pow(t - 1, 2),
+    outElastic: (t) => t === 0 ? 0 : t === 1 ? 1 : Math.pow(2, -10 * t) * Math.sin((t * 10 - 0.75) * c4) + 1,
+    inOutSine: (t) => -(Math.cos(Math.PI * t) - 1) / 2,
+    outExpo: (t) => (t === 1 ? 1 : 1 - Math.pow(2, -10 * t))
+};
+//# sourceMappingURL=ease.js.map

package/dist/engine/agent-api/camera/ease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ease.js","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/camera/ease.ts"],"names":[],"mappings":"AAMA,MAAM,EAAE,GAAG,OAAO,CAAC;AACnB,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;AACtB,MAAM,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;AAE7B,MAAM,CAAC,MAAM,IAAI,GAAgD;IAC/D,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC;IACpB,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IACrC,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;IACzE,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACzB,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACvC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;IAC9E,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC3E,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAChB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC;IACvF,SAAS,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC;IAClD,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;CACzD,CAAC"}

package/dist/engine/agent-api/camera/extension.d.ts

@@ -0,0 +1,54 @@
+/**
+ * `prd08.camera` — the C-38 app extension behind `A3D_QR_CAMERA`.
+ *
+ * Flag on: real CameraController (C-22) driven once per frame from `app.onFrame`
+ * (the `runRuntimeFrame` tick — real dt), subjects resolved through `app.nodes`
+ * (runtime) then the flattened scene snapshot (legacy fallback order),
+ * `presented()` written back through `app.scene.camera` as a plain
+ * `perspective`/`orthographic` spec so the existing resolution path renders
+ * exactly the presented pose, and `cut()` → `app.cutCamera()` (C-14).
+ *
+ * Flag off: a stub controller — same surface, legacy resolution, inert layers —
+ * so `app.camera` is defined (C-38) but nothing changes behaviour.
+ *
+ * Driving note: `app.onRender` (C-23) is the once-per-tick real-dt hook; until
+ * the loop option reaches createAuraApp (Q-09-5, PR 0b-1), the extension also
+ * accepts `app.onFrame`, which fires per substep under FixedStepDriver — the
+ * controller still presents every call, and ramp/layer dt is per call.
+ */
+import type { AuraCameraController, AuraCameraPose, AuraCameraRigFactories } from "../../contracts/camera.js";
+import type { AuraApp } from "../index.js";
+import { type AuraCameraControllerImpl } from "./CameraController.js";
+import { type AuraBudgetedCameraProbe } from "./Probe.js";
+interface CameraSpecMutable {
+    mode?: string;
+    position?: readonly number[];
+    target?: readonly number[];
+    fov?: number;
+    near?: number;
+    far?: number;
+    orthographicSize?: number;
+    [key: string]: unknown;
+}
+/** Stub `app.camera` for flag-off — same C-22 surface, no behaviour change. */
+export declare function createStubCameraController(specOf: () => CameraSpecMutable | undefined): AuraCameraController & {
+    readonly rigs: AuraCameraRigFactories;
+};
+export interface AuraCameraExtensionOptions {
+    readonly freezeSpecs?: boolean;
+}
+/** The present-driver seam a fixed-step loop calls once per presented tick. */
+export interface AuraCameraPresentDriverTarget {
+    present(realDt: number, timeMs: number, subjectPosition?: (id: string) => readonly number[] | undefined): AuraCameraPose;
+}
+/** The tier-budgeted collision probe the controller casts through (§17). */
+export interface AuraCameraProbeTarget {
+    readonly probe: AuraBudgetedCameraProbe;
+}
+/**
+ * Build the real controller against an app — exported for tests/harnesses that
+ * want the controller without the full createAuraApp mount.
+ */
+export declare function createAuraCameraController(app: AuraApp, options?: AuraCameraExtensionOptions): AuraCameraControllerImpl & AuraCameraPresentDriverTarget & AuraCameraProbeTarget;
+export {};
+//# sourceMappingURL=extension.d.ts.map

package/dist/engine/agent-api/camera/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/camera/extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EACV,oBAAoB,EAGpB,cAAc,EAKd,sBAAsB,EAKvB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,OAAO,EAAY,MAAM,aAAa,CAAC;AACrD,OAAO,EAA0B,KAAK,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,EAA+C,KAAK,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAqBvG,UAAU,iBAAiB;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAYD,+EAA+E;AAC/E,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,iBAAiB,GAAG,SAAS,GAC1C,oBAAoB,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAA;CAAE,CA2DlE;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,+EAA+E;AAC/E,MAAM,WAAW,6BAA6B;IAC5C,OAAO,CACL,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,eAAe,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,SAAS,MAAM,EAAE,GAAG,SAAS,GAC9D,cAAc,CAAC;CACnB;AAED,4EAA4E;AAC5E,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,KAAK,EAAE,uBAAuB,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,OAAO,EACZ,OAAO,GAAE,0BAA+B,GACvC,wBAAwB,GAAG,6BAA6B,GAAG,qBAAqB,CA8WlF"}

package/dist/engine/agent-api/camera/extension.js

@@ -0,0 +1,439 @@
+import { stubCameraRigFactories } from "../../contracts/camera.js";
+import { createCameraController } from "./CameraController.js";
+import { cameraProbeBudgetForTier, createCameraProbe } from "./Probe.js";
+import { createCinematicBarsLayer } from "./layers/cinematicBars.js";
+import { DEFAULT_POSE, createFromSpecRig } from "./rigs/fromSpec.js";
+import { findRuntimeTarget, findSceneNodeTarget, subjectFromHandle, subjectRotationY } from "./subject.js";
+import { flattenSceneNodes } from "./sceneNodes.js";
+import { createStaticProbeBoxSource } from "./staticBounds.js";
+function isHandleLike(ref) {
+    return (typeof ref === "object" &&
+        ref !== null &&
+        "position" in ref &&
+        "rotation" in ref &&
+        typeof ref.bounds === "function");
+}
+/** Stub `app.camera` for flag-off — same C-22 surface, no behaviour change. */
+export function createStubCameraController(specOf) {
+    const rig = () => stubCameraRigFactories.static({});
+    const noopLayer = (id) => ({
+        id,
+        apply: (p) => p,
+        energy: () => 0
+    });
+    const traumaStub = {
+        ...noopLayer("trauma"),
+        add: () => { },
+        configure: () => { }
+    };
+    const punchStub = { ...noopLayer("punch"), trigger: () => { } };
+    const kickStub = { ...noopLayer("fovKick"), set: () => { } };
+    return {
+        presented() {
+            const spec = specOf();
+            return {
+                position: spec?.position ?? DEFAULT_POSE.position,
+                target: spec?.target ?? DEFAULT_POSE.target,
+                up: DEFAULT_POSE.up,
+                roll: 0,
+                fov: spec?.fov ?? DEFAULT_POSE.fov,
+                near: spec?.near ?? DEFAULT_POSE.near,
+                far: spec?.far ?? DEFAULT_POSE.far,
+                orthographicSize: spec?.orthographicSize
+            };
+        },
+        setPose: () => { },
+        setFov: () => { },
+        setRoll: () => { },
+        use: () => { },
+        rig: rig(),
+        rigs: stubCameraRigFactories,
+        addLayer: () => () => { },
+        shake: traumaStub,
+        punch: punchStub,
+        fovKick: kickStub,
+        play(seq) {
+            return {
+                done: Promise.resolve(),
+                skip: () => { },
+                get progress() {
+                    return 1;
+                }
+            };
+        },
+        cut: () => { },
+        evidence() {
+            return {
+                kind: "aura-camera-presented",
+                rig: "stub",
+                pose: this.presented(),
+                viewProjection: [],
+                layers: [],
+                cutThisFrame: false
+            };
+        }
+    };
+}
+/**
+ * Build the real controller against an app — exported for tests/harnesses that
+ * want the controller without the full createAuraApp mount.
+ */
+export function createAuraCameraController(app, options = {}) {
+    const registry = app.nodes;
+    /*
+     * S6: runtime handles carry no velocity, so a speed-aware rig (chase
+     * `distance.perSpeed`, `fov.perSpeed`, look-ahead) saw speed 0 for every
+     * game subject and never left its base distance. Estimate it from the
+     * handle's sim-time position delta between controller updates. Presented
+     * frames (`step(0)` → dt 0, same sim time) reuse the last estimate.
+     */
+    let subjectClock = 0;
+    /**
+     * Presented (interpolated) subject positions, supplied per presented frame
+     * by a present driver (`present()`, FixedStepDriver). PRD-08 §6.1: the
+     * camera reads interpolated subject transforms — raw sim transforms
+     * reintroduce 60/120/144 Hz judder.
+     */
+    let subjectSource;
+    const velocityTracks = new WeakMap();
+    const velocityOf = (handle, p) => {
+        const track = velocityTracks.get(handle);
+        if (!track) {
+            velocityTracks.set(handle, { p: [p[0], p[1], p[2]], t: subjectClock, v: [0, 0, 0] });
+            return [0, 0, 0];
+        }
+        const span = subjectClock - track.t;
+        if (span > 1e-9) {
+            track.v = [(p[0] - track.p[0]) / span, (p[1] - track.p[1]) / span, (p[2] - track.p[2]) / span];
+            track.p = [p[0], p[1], p[2]];
+            track.t = subjectClock;
+        }
+        return track.v;
+    };
+    const subjectOf = (handle) => {
+        const presentedAt = subjectSource?.(handle.id);
+        const p = presentedAt ?? handle.position;
+        const subject = subjectFromHandle(handle, velocityOf(handle, p));
+        if (!presentedAt)
+            return subject;
+        const d = [p[0] - handle.position[0], p[1] - handle.position[1], p[2] - handle.position[2]];
+        const shift = (v) => [v[0] + d[0], v[1] + d[1], v[2] + d[2]];
+        return {
+            ...subject,
+            position: [p[0], p[1], p[2]],
+            bounds: { min: shift(subject.bounds.min), max: shift(subject.bounds.max) }
+        };
+    };
+    const resolveSubject = (ref) => {
+        if (isHandleLike(ref))
+            return subjectOf(ref);
+        if (typeof ref !== "string")
+            return undefined;
+        const runtime = findRuntimeTarget(registry, ref);
+        if (runtime) {
+            const handle = registry?.get(ref) ?? registry?.all().find((h) => h.visible !== false && (h.name === ref || h.tags.includes(ref)));
+            return handle ? subjectOf(handle) : { position: runtime.position, velocity: [0, 0, 0], forward: [0, 0, 1], bounds: { min: runtime.position, max: runtime.position } };
+        }
+        const flat = flattenSceneNodes((app.scene?.nodes ?? []));
+        const sceneNode = findSceneNodeTarget(flat, ref);
+        if (!sceneNode)
+            return undefined;
+        return {
+            position: sceneNode.position,
+            velocity: [0, 0, 0],
+            forward: [0, 0, 1],
+            bounds: { min: sceneNode.position, max: sceneNode.position }
+        };
+    };
+    /**
+     * Rig deps close over the rig's OWN spec — after applyPose replaces
+     * `app.scene.camera` with the presented pose spec, resolving targetNode from
+     * the live spec would kill follow/subject resolution, so deps always read
+     * the spec the rig was bound with.
+     */
+    const specDepsFor = (spec) => ({
+        runtimeTarget: () => {
+            const src = findRuntimeTarget(registry, spec.targetNode);
+            return src ? { position: src.position, rotationY: src.rotation[1] } : undefined;
+        },
+        sceneTarget: () => {
+            const flat = flattenSceneNodes((app.scene?.nodes ?? []));
+            const node = findSceneNodeTarget(flat, spec.targetNode);
+            return node?.position;
+        }
+    });
+    let boundSpec;
+    let writeSpec;
+    const liveSpec = () => app.scene?.camera;
+    const currentSpec = () => (liveSpec() && liveSpec() !== writeSpec ? liveSpec() : boundSpec) ??
+        boundSpec;
+    /*
+     * Pixels, not evidence. The production renderer reads the camera from its
+     * render snapshot, a shallow copy made at mount (`{ ...snapshot, nodes }`)
+     * that keeps a reference to the authored camera object. Replacing
+     * `app.scene.camera` never reached the GPU (promote run 38151983512:
+     * byte-identical PNGs, NO-EFFECT; fixed in #1202). Until the Q-15-9 renderer
+     * camera-override seam (#645) exists, the presented pose is written into
+     * that renderer-held object (`renderCamera`):
+     * - only pose fields are written (mode, position, target, up, roll, fov,
+     *   near, far, orthographicSize). Authored fields such as `targetNode`,
+     *   `offset` and `smoothing` stay; in perspective/orthographic mode the
+     *   renderer's camera resolver ignores them, so 08-POSE's "targetNode
+     *   survives applyPose" holds. `up`/`roll` are recorded but not yet drawn
+     *   (the renderer has no up/roll consumer; #645 / Q-15-1 #222);
+     * - the authored pose values are backed up at bind and restored when the
+     *   scene's camera changes (setScene / rebind), so a reused builder or spec
+     *   gets its own values back (Codex review on #1202);
+     * - `freezeSpecs` still exposes a frozen copy on `app.scene.camera`, but the
+     *   writes keep going to `renderCamera`, so pixels stay live (Codex review
+     *   on #1202).
+     * Rig inputs and spec deps take copies, so nothing feeds back.
+     */
+    const POSE_KEYS = ["mode", "position", "target", "up", "roll", "fov", "near", "far", "orthographicSize"];
+    let renderCamera;
+    let renderCameraBackup;
+    const restoreRenderCamera = () => {
+        if (!renderCamera || !renderCameraBackup || Object.isFrozen(renderCamera))
+            return;
+        const target = renderCamera;
+        for (const key of POSE_KEYS) {
+            if (key in renderCameraBackup)
+                target[key] = renderCameraBackup[key];
+            else
+                delete target[key];
+        }
+    };
+    const adoptRenderCamera = (spec) => {
+        if (spec === renderCamera)
+            return;
+        restoreRenderCamera();
+        renderCamera = spec && !Object.isFrozen(spec) ? spec : undefined;
+        renderCameraBackup = undefined;
+        if (renderCamera) {
+            const backup = {};
+            for (const key of POSE_KEYS)
+                if (key in renderCamera)
+                    backup[key] = renderCamera[key];
+            renderCameraBackup = backup;
+        }
+    };
+    const applyPose = (pose) => {
+        const scene = app.scene;
+        if (!scene)
+            return;
+        const mode = pose.orthographicSize !== undefined ? "orthographic" : "perspective";
+        const fields = {
+            mode,
+            position: pose.position,
+            target: pose.target,
+            up: pose.up,
+            roll: pose.roll,
+            fov: pose.fov,
+            near: pose.near,
+            far: pose.far
+        };
+        if (pose.orthographicSize !== undefined)
+            fields.orthographicSize = pose.orthographicSize;
+        if (renderCamera) {
+            Object.assign(renderCamera, fields);
+            if (pose.orthographicSize === undefined)
+                delete renderCamera.orthographicSize;
+        }
+        if (renderCamera && scene.camera === renderCamera && !options.freezeSpecs) {
+            writeSpec = renderCamera;
+            return;
+        }
+        const next = { ...(renderCamera ?? {}), ...fields };
+        scene.camera = options.freezeSpecs ? Object.freeze(next) : next;
+        writeSpec = next;
+    };
+    // S8 / C-9: collision rigs (`collision: true` on chase/orbit/shoulder/
+    // flight) cast against the app's visible runtime-node bounds AND the static
+    // scene nodes (primitives, dimensioned models) — static walls were missed
+    // before (Codex review on #911). Without a
+    // probe the controller's default never hits and a mounted orbit swings
+    // straight through walls. §17/§19: the cast count per presented frame is
+    // capped by the live C-27 tier (`app.quality.tier`, re-read every frame
+    // so `app.quality.set` applies on the next present).
+    const staticBoxes = createStaticProbeBoxSource();
+    const probe = createCameraProbe({
+        budget: () => cameraProbeBudgetForTier(app.quality?.tier),
+        bounds: () => [
+            ...(registry?.all() ?? [])
+                .filter((h) => h.visible !== false)
+                .map((h) => {
+                const b = h.bounds();
+                return { id: h.id, min: b.min, max: b.max };
+            }),
+            ...staticBoxes(app.scene?.nodes)
+        ]
+    });
+    const controller = createCameraController({
+        resolveSubject,
+        probe,
+        // Copy: applyPose writes the presented pose into the authored object.
+        specDeps: specDepsFor({ ...(app.scene?.camera ?? {}) }),
+        aspect: () => {
+            const canvas = app.canvas;
+            return canvas && canvas.height > 0 ? canvas.width / canvas.height : 16 / 9;
+        },
+        applyPose,
+        onCut: () => app.cutCamera?.(),
+        reducedMotion: () => {
+            try {
+                return (typeof matchMedia === "function" &&
+                    matchMedia("(prefers-reduced-motion: reduce)").matches);
+            }
+            catch {
+                return false;
+            }
+        },
+        barsLayer: () => createCinematicBarsLayer({
+            canvasAspect: (() => {
+                const canvas = app.canvas;
+                return canvas && canvas.height > 0 ? canvas.width / canvas.height : 16 / 9;
+            })()
+        }),
+        initial: { spec: (() => { const s = currentSpec(); return s ? { ...s } : undefined; })() }
+    });
+    // Rebind when the scene's camera spec object changes (setScene / new spec).
+    const rebindIfNeeded = () => {
+        const spec = liveSpec();
+        if (spec && spec !== boundSpec && spec !== writeSpec) {
+            boundSpec = spec;
+            adoptRenderCamera(spec);
+            // Snapshot the authored spec: applyPose later writes pose fields into this object.
+            const authored = { ...spec };
+            const rig = createFromSpecRig(authored, specDepsFor(authored));
+            controller.use(rig);
+        }
+    };
+    rebindIfNeeded();
+    /*
+     * 08-LOOP: drive the controller only while it has work — `app.onFrame`
+     * callbacks keep `requiresFrames()` true (createAuraApp.ts), which re-arms
+     * rAF forever and renders every static scene every frame. We subscribe on
+     * any mutating camera call (arm) and unsubscribe when `isActive()` reports
+     * idle (settled pose, no sequence/blend/ramp/layer energy, non-continuous
+     * rig). Rigs marked `continuous` (subject/pointer tracking) never idle —
+     * their output can change without an API call.
+     */
+    const onFrame = app.onFrame;
+    let unframe;
+    /** Set once a present driver calls `present()`; the onFrame tick then yields. */
+    let presentDriven = false;
+    const arm = () => {
+        if (!presentDriven && !unframe && typeof onFrame === "function") {
+            unframe = onFrame.call(app, (f) => {
+                rebindIfNeeded();
+                subjectClock = f.time;
+                probe.beginFrame();
+                controller.update(Math.max(f.dt, 1e-6), f.time * 1000);
+                // A zero-dt frame (FixedStepDriver's present-only `step(0)`) cannot
+                // move a time-driven rig, so its zero pose delta says nothing about
+                // idleness — deciding there unsubscribed a non-continuous rig (rail,
+                // sequences) after its first present and froze it (S11).
+                if (f.dt > 0 && !controller.isActive()) {
+                    unframe?.();
+                    unframe = undefined;
+                }
+            });
+        }
+    };
+    arm();
+    /* Every mutating C-22 call re-arms the tick. `Object.create` keeps the
+     * prototype getters (`rig`, `presented`, `evidence`…) live while method
+     * overrides shadow the raw controller's. */
+    const armed = Object.create(controller);
+    Object.defineProperty(armed, "probe", { value: probe, enumerable: false });
+    /*
+     * §6.1 present path: a fixed-step loop (FixedStepDriver) calls this ONCE per
+     * presented tick, after interpolation resolve, with REAL dt and the
+     * interpolated subject positions. From the first call on, the app.onFrame
+     * tick stops updating the controller — otherwise it would also run on sim
+     * substeps (sim dt: shake stalls in hit-stop, a 0-substep tick leaves the
+     * rail parked and the next 2-substep tick doubles its step) and on the
+     * present `step(0)`.
+     */
+    armed.present = (realDt, timeMs, subjectPosition) => {
+        if (!presentDriven) {
+            presentDriven = true;
+            unframe?.();
+            unframe = undefined;
+        }
+        subjectSource = subjectPosition;
+        rebindIfNeeded();
+        subjectClock = timeMs / 1000;
+        probe.beginFrame();
+        try {
+            return controller.update(Math.max(realDt, 1e-6), timeMs);
+        }
+        finally {
+            subjectSource = undefined;
+        }
+    };
+    armed.use = (rig, o) => { arm(); controller.use(rig, o); };
+    armed.setPose = (p, o) => { arm(); controller.setPose(p, o); };
+    armed.setFov = (fov, o) => { arm(); controller.setFov(fov, o); };
+    armed.setRoll = (roll, o) => { arm(); controller.setRoll(roll, o); };
+    armed.addLayer = (layer, order) => { arm(); return controller.addLayer(layer, order); };
+    armed.play = (seq) => { arm(); return controller.play(seq); };
+    armed.cut = () => { arm(); controller.cut(); };
+    armed.update = (realDt, timeMs) => { arm(); probe.beginFrame(); return controller.update(realDt, timeMs); };
+    armed.shake = Object.create(controller.shake);
+    armed.shake.add = (amount) => { arm(); controller.shake.add(amount); };
+    armed.shake.configure = (o) => { arm(); controller.shake.configure(o); };
+    armed.punch = Object.create(controller.punch);
+    armed.punch.trigger = (o) => { arm(); controller.punch.trigger(o); };
+    armed.fovKick = Object.create(controller.fovKick);
+    armed.fovKick.set = (channel, offsetDeg, halflife) => { arm(); controller.fovKick.set(channel, offsetDeg, halflife); };
+    armed.lookAt = controller.lookAt;
+    armed.presented = () => { rebindIfNeeded(); return controller.presented(); };
+    // freezeSpecs (C-22 option): route-held spec objects throw on cast-mutation.
+    if (options.freezeSpecs) {
+        const spec = liveSpec();
+        const scene = app.scene;
+        if (spec && scene && !Object.isFrozen(spec)) {
+            // Route-facing frozen copy; renderCamera keeps receiving the pose.
+            const frozen = Object.freeze({ ...spec });
+            scene.camera = frozen;
+            writeSpec = frozen;
+        }
+    }
+    /*
+     * Scene swaps restore the outgoing authored camera immediately. An idle
+     * camera (static rig settled → onFrame unsubscribed, no present driver)
+     * never reaches `rebindIfNeeded`, so without this hook the previous
+     * builder/spec kept the last presented pose after `app.setScene()` and a
+     * later reuse rendered the mutated camera (Codex review on #1209). The app
+     * method is wrapped on this app instance only; flag-off apps never install
+     * the real controller, so they are untouched.
+     */
+    const appWithSetScene = app;
+    if (typeof appWithSetScene.setScene === "function") {
+        const originalSetScene = appWithSetScene.setScene.bind(app);
+        appWithSetScene.setScene = (next) => {
+            const previous = renderCamera;
+            restoreRenderCamera();
+            // If this throws, the scene did not change: renderCamera stays bound and
+            // the next update writes the pose into it again.
+            const result = originalSetScene(next);
+            if (previous && liveSpec() === previous) {
+                // Same camera object kept across the swap: the runtime-node remount
+                // (`app.nodes.add/remove` → setScene({ ...scene, nodes }),
+                // runtimeNodes.ts) or a repeated AuraSceneBuilder.toJSON(). Keep the
+                // binding: do NOT rebind (controller.use would drop setPose/FOV/roll
+                // overrides and any custom rig; Codex review on #1215). Re-write the
+                // current presented pose so the remounted renderer draws it (#1213).
+                applyPose(controller.presented());
+                arm();
+                return result;
+            }
+            rebindIfNeeded();
+            arm();
+            return result;
+        };
+    }
+    return armed;
+}
+//# sourceMappingURL=extension.js.map

package/dist/engine/agent-api/camera/extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.js","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/camera/extension.ts"],"names":[],"mappings":"AAiCA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,OAAO,EAAE,sBAAsB,EAAiC,MAAM,uBAAuB,CAAC;AAC9F,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAgC,MAAM,YAAY,CAAC;AACvG,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAyB,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAIjB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAmB/D,SAAS,YAAY,CAAC,GAAoB;IACxC,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,UAAU,IAAI,GAAG;QACjB,UAAU,IAAI,GAAG;QACjB,OAAQ,GAAyB,CAAC,MAAM,KAAK,UAAU,CACxD,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,0BAA0B,CACxC,MAA2C;IAE3C,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC,sBAAsB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,CAAC,EAAU,EAAmB,EAAE,CAAC,CAAC;QAClD,EAAE;QACF,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACf,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;KAChB,CAAC,CAAC;IACH,MAAM,UAAU,GAAoB;QAClC,GAAG,SAAS,CAAC,QAAQ,CAAC;QACtB,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;QACb,SAAS,EAAE,GAAG,EAAE,GAAE,CAAC;KACpB,CAAC;IACF,MAAM,SAAS,GAAmB,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;IAC/E,MAAM,QAAQ,GAAqB,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;IAC9E,OAAO;QACL,SAAS;YACP,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC;YACtB,OAAO;gBACL,QAAQ,EAAG,IAAI,EAAE,QAAuC,IAAI,YAAY,CAAC,QAAQ;gBACjF,MAAM,EAAG,IAAI,EAAE,MAAmC,IAAI,YAAY,CAAC,MAAM;gBACzE,EAAE,EAAE,YAAY,CAAC,EAAE;gBACnB,IAAI,EAAE,CAAC;gBACP,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,YAAY,CAAC,GAAG;gBAClC,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,YAAY,CAAC,IAAI;gBACrC,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,YAAY,CAAC,GAAG;gBAClC,gBAAgB,EAAE,IAAI,EAAE,gBAAgB;aACzC,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;QACjB,MAAM,EAAE,GAAG,EAAE,GAAE,CAAC;QAChB,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC;QACjB,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;QACb,GAAG,EAAE,GAAG,EAAE;QACV,IAAI,EAAE,sBAAsB;QAC5B,QAAQ,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,GAAE,CAAC;QACxB,KAAK,EAAE,UAAU;QACjB,KAAK,EAAE,SAAS;QAChB,OAAO,EAAE,QAAQ;QACjB,IAAI,CAAC,GAAuB;YAC1B,OAAO;gBACL,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE;gBACvB,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC;gBACd,IAAI,QAAQ;oBACV,OAAO,CAAC,CAAC;gBACX,CAAC;aACF,CAAC;QACJ,CAAC;QACD,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;QACb,QAAQ;YACN,OAAO;gBACL,IAAI,EAAE,uBAAuB;gBAC7B,GAAG,EAAE,MAAM;gBACX,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE;gBACtB,cAAc,EAAE,EAAE;gBAClB,MAAM,EAAE,EAAE;gBACV,YAAY,EAAE,KAAK;aACpB,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAoBD;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CACxC,GAAY,EACZ,UAAsC,EAAE;IAExC,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAwC,CAAC;IAE9D;;;;;;OAMG;IACH,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB;;;;;OAKG;IACH,IAAI,aAA0E,CAAC;IAC/E,MAAM,cAAc,GAAG,IAAI,OAAO,EAA4D,CAAC;IAC/F,MAAM,UAAU,GAAG,CAAC,MAAyB,EAAE,CAAoB,EAAY,EAAE;QAC/E,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YACrF,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACnB,CAAC;QACD,MAAM,IAAI,GAAG,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC;QACpC,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;YAChB,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YAC/F,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7B,KAAK,CAAC,CAAC,GAAG,YAAY,CAAC;QACzB,CAAC;QACD,OAAO,KAAK,CAAC,CAAC,CAAC;IACjB,CAAC,CAAC;IACF,MAAM,SAAS,GAAG,CAAC,MAAyB,EAAqB,EAAE;QACjE,MAAM,WAAW,GAAG,aAAa,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC/C,MAAM,CAAC,GAAG,WAAW,IAAI,MAAM,CAAC,QAAQ,CAAC;QACzC,MAAM,OAAO,GAAG,iBAAiB,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,WAAW;YAAE,OAAO,OAAO,CAAC;QACjC,MAAM,CAAC,GAAa,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACtG,MAAM,KAAK,GAAG,CAAC,CAAW,EAAY,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjF,OAAO;YACL,GAAG,OAAO;YACV,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAC5B,MAAM,EAAE,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;SAC3E,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,cAAc,GAAG,CAAC,GAAoB,EAAiC,EAAE;QAC7E,IAAI,YAAY,CAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7C,IAAI,OAAO,GAAG,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QAC9C,MAAM,OAAO,GAAG,iBAAiB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACjD,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,QAAQ,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAClI,OAAO,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;QACxK,CAAC;QACD,MAAM,IAAI,GAAG,iBAAiB,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE,CAAmC,CAAC,CAAC;QAC3F,MAAM,SAAS,GAAG,mBAAmB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS;YAAE,OAAO,SAAS,CAAC;QACjC,OAAO;YACL,QAAQ,EAAE,SAAS,CAAC,QAAQ;YAC5B,QAAQ,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACnB,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YAClB,MAAM,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,QAAQ,EAAE,GAAG,EAAE,SAAS,CAAC,QAAQ,EAAE;SAC7D,CAAC;IACJ,CAAC,CAAC;IAEF;;;;;OAKG;IACH,MAAM,WAAW,GAAG,CAAC,IAAsB,EAAE,EAAE,CAAC,CAAC;QAC/C,aAAa,EAAE,GAAG,EAAE;YAClB,MAAM,GAAG,GAAG,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAgC,CAAC,CAAC;YAC/E,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QAClF,CAAC;QACD,WAAW,EAAE,GAAG,EAAE;YAChB,MAAM,IAAI,GAAG,iBAAiB,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,IAAI,EAAE,CAAmC,CAAC,CAAC;YAC3F,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,UAAgC,CAAC,CAAC;YAC9E,OAAO,IAAI,EAAE,QAAQ,CAAC;QACxB,CAAC;KACF,CAAC,CAAC;IAEH,IAAI,SAAuC,CAAC;IAC5C,IAAI,SAAwC,CAAC;IAE7C,MAAM,QAAQ,GAAG,GAAkC,EAAE,CAClD,GAAG,CAAC,KAA+D,EAAE,MAAM,CAAC;IAE/E,MAAM,WAAW,GAAG,GAAiC,EAAE,CACrD,CAAC,QAAQ,EAAE,IAAI,QAAQ,EAAE,KAAK,SAAS,CAAC,CAAC,CAAE,QAAQ,EAAuB,CAAC,CAAC,CAAC,SAAS,CAAC;QACvF,SAAS,CAAC;IAEZ;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,MAAM,SAAS,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,CAAU,CAAC;IAClH,IAAI,YAA2C,CAAC;IAChD,IAAI,kBAAoF,CAAC;IAEzF,MAAM,mBAAmB,GAAG,GAAG,EAAE;QAC/B,IAAI,CAAC,YAAY,IAAI,CAAC,kBAAkB,IAAI,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAC;YAAE,OAAO;QAClF,MAAM,MAAM,GAAG,YAAuC,CAAC;QACvD,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;YAC5B,IAAI,GAAG,IAAI,kBAAkB;gBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;;gBAChE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,iBAAiB,GAAG,CAAC,IAAmC,EAAE,EAAE;QAChE,IAAI,IAAI,KAAK,YAAY;YAAE,OAAO;QAClC,mBAAmB,EAAE,CAAC;QACtB,YAAY,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QACjE,kBAAkB,GAAG,SAAS,CAAC;QAC/B,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,MAAM,GAAyD,EAAE,CAAC;YACxE,KAAK,MAAM,GAAG,IAAI,SAAS;gBAAE,IAAI,GAAG,IAAI,YAAY;oBAAE,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;YACtF,kBAAkB,GAAG,MAAM,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,CAAC,IAAoB,EAAE,EAAE;QACzC,MAAM,KAAK,GAAG,GAAG,CAAC,KAA8D,CAAC;QACjF,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,MAAM,IAAI,GAAG,IAAI,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,aAAa,CAAC;QAClF,MAAM,MAAM,GAAsB;YAChC,IAAI;YACJ,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,EAAE,IAAI,CAAC,GAAG;SACd,CAAC;QACF,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS;YAAE,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC,gBAAgB,CAAC;QACzF,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YACpC,IAAI,IAAI,CAAC,gBAAgB,KAAK,SAAS;gBAAE,OAAO,YAAY,CAAC,gBAAgB,CAAC;QAChF,CAAC;QACD,IAAI,YAAY,IAAI,KAAK,CAAC,MAAM,KAAK,YAAY,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YAC1E,SAAS,GAAG,YAAY,CAAC;YACzB,OAAO;QACT,CAAC;QACD,MAAM,IAAI,GAAsB,EAAE,GAAG,CAAC,YAAY,IAAI,EAAE,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC;QACvE,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAChE,SAAS,GAAG,IAAI,CAAC;IACnB,CAAC,CAAC;IAEF,uEAAuE;IACvE,4EAA4E;IAC5E,0EAA0E;IAC1E,2CAA2C;IAC3C,uEAAuE;IACvE,yEAAyE;IACzE,wEAAwE;IACxE,qDAAqD;IACrD,MAAM,WAAW,GAAG,0BAA0B,EAAE,CAAC;IACjD,MAAM,KAAK,GAAG,iBAAiB,CAAC;QAC9B,MAAM,EAAE,GAAG,EAAE,CAAC,wBAAwB,CAAE,GAAwC,CAAC,OAAO,EAAE,IAAI,CAAC;QAC/F,MAAM,EAAE,GAAG,EAAE,CAAC;YACZ,GAAG,CAAC,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;iBACvB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC;iBAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACT,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;gBACrB,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;YAC9C,CAAC,CAAC;YACJ,GAAG,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,KAAmD,CAAC;SAC/E;KACF,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,sBAAsB,CAAC;QACxC,cAAc;QACd,KAAK;QACL,sEAAsE;QACtE,QAAQ,EAAE,WAAW,CAAC,EAAE,GAAG,CAAE,GAAG,CAAC,KAAK,EAAE,MAAuC,IAAI,EAAE,CAAC,EAAE,CAAC;QACzF,MAAM,EAAE,GAAG,EAAE;YACX,MAAM,MAAM,GAAI,GAAsD,CAAC,MAAM,CAAC;YAC9E,OAAO,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAC7E,CAAC;QACD,SAAS;QACT,KAAK,EAAE,GAAG,EAAE,CAAE,GAAkC,CAAC,SAAS,EAAE,EAAE;QAC9D,aAAa,EAAE,GAAG,EAAE;YAClB,IAAI,CAAC;gBACH,OAAO,CACL,OAAO,UAAU,KAAK,UAAU;oBAChC,UAAU,CAAC,kCAAkC,CAAC,CAAC,OAAO,CACvD,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QACD,SAAS,EAAE,GAAG,EAAE,CACd,wBAAwB,CAAC;YACvB,YAAY,EAAE,CAAC,GAAG,EAAE;gBAClB,MAAM,MAAM,GAAI,GAAsD,CAAC,MAAM,CAAC;gBAC9E,OAAO,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YAC7E,CAAC,CAAC,EAAE;SACL,CAAC;QACJ,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,GAAG,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE;KAC3F,CAAC,CAAC;IAEH,4EAA4E;IAC5E,MAAM,cAAc,GAAG,GAAG,EAAE;QAC1B,MAAM,IAAI,GAAG,QAAQ,EAAkC,CAAC;QACxD,IAAI,IAAI,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAM,SAA0C,EAAE,CAAC;YACvF,SAAS,GAAG,IAAI,CAAC;YACjB,iBAAiB,CAAC,IAAyB,CAAC,CAAC;YAC7C,mFAAmF;YACnF,MAAM,QAAQ,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,iBAAiB,CAAC,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC,CAAC;YAC/D,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACtB,CAAC;IACH,CAAC,CAAC;IACF,cAAc,EAAE,CAAC;IAEjB;;;;;;;;OAQG;IACH,MAAM,OAAO,GAAI,GAAkB,CAAC,OAAO,CAAC;IAC5C,IAAI,OAAiC,CAAC;IACtC,iFAAiF;IACjF,IAAI,aAAa,GAAG,KAAK,CAAC;IAC1B,MAAM,GAAG,GAAG,GAAG,EAAE;QACf,IAAI,CAAC,aAAa,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;YAChE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE;gBAChC,cAAc,EAAE,CAAC;gBACjB,YAAY,GAAG,CAAC,CAAC,IAAI,CAAC;gBACtB,KAAK,CAAC,UAAU,EAAE,CAAC;gBACnB,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;gBACvD,oEAAoE;gBACpE,oEAAoE;gBACpE,qEAAqE;gBACrE,yDAAyD;gBACzD,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC;oBACvC,OAAO,EAAE,EAAE,CAAC;oBACZ,OAAO,GAAG,SAAS,CAAC;gBACtB,CAAC;YACH,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;IACF,GAAG,EAAE,CAAC;IAEN;;gDAE4C;IAC5C,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAEmB,CAAC;IAC1D,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3E;;;;;;;;OAQG;IACH,KAAK,CAAC,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE;QAClD,IAAI,CAAC,aAAa,EAAE,CAAC;YACnB,aAAa,GAAG,IAAI,CAAC;YACrB,OAAO,EAAE,EAAE,CAAC;YACZ,OAAO,GAAG,SAAS,CAAC;QACtB,CAAC;QACD,aAAa,GAAG,eAAe,CAAC;QAChC,cAAc,EAAE,CAAC;QACjB,YAAY,GAAG,MAAM,GAAG,IAAI,CAAC;QAC7B,KAAK,CAAC,UAAU,EAAE,CAAC;QACnB,IAAI,CAAC;YACH,OAAO,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3D,CAAC;gBAAS,CAAC;YACT,aAAa,GAAG,SAAS,CAAC;QAC5B,CAAC;IACH,CAAC,CAAC;IACF,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,KAAK,CAAC,MAAM,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjE,KAAK,CAAC,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,KAAK,CAAC,QAAQ,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,OAAO,UAAU,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxF,KAAK,CAAC,IAAI,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,OAAO,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,KAAK,CAAC,GAAG,GAAG,GAAG,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/C,KAAK,CAAC,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5G,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC9C,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,MAAc,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/E,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAC9C,KAAK,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAClD,KAAK,CAAC,OAAO,CAAC,GAAG,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACvH,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;IACjC,KAAK,CAAC,SAAS,GAAG,GAAG,EAAE,GAAG,cAAc,EAAE,CAAC,CAAC,OAAO,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;IAE7E,6EAA6E;IAC7E,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,GAAG,CAAC,KAA8D,CAAC;QACjF,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5C,mEAAmE;YACnE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;YAC1C,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;YACtB,SAAS,GAAG,MAAM,CAAC;QACrB,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,MAAM,eAAe,GAAG,GAAgD,CAAC;IACzE,IAAI,OAAO,eAAe,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;QACnD,MAAM,gBAAgB,GAAG,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5D,eAAe,CAAC,QAAQ,GAAG,CAAC,IAAa,EAAE,EAAE;YAC3C,MAAM,QAAQ,GAAG,YAAY,CAAC;YAC9B,mBAAmB,EAAE,CAAC;YACtB,yEAAyE;YACzE,iDAAiD;YACjD,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,QAAQ,IAAI,QAAQ,EAAE,KAAK,QAAQ,EAAE,CAAC;gBACxC,oEAAoE;gBACpE,2DAA2D;gBAC3D,qEAAqE;gBACrE,qEAAqE;gBACrE,qEAAqE;gBACrE,qEAAqE;gBACrE,SAAS,CAAC,UAAU,CAAC,SAAS,EAAE,CAAC,CAAC;gBAClC,GAAG,EAAE,CAAC;gBACN,OAAO,MAAM,CAAC;YAChB,CAAC;YACD,cAAc,EAAE,CAAC;YACjB,GAAG,EAAE,CAAC;YACN,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/engine/agent-api/camera/framing.d.ts

@@ -0,0 +1,31 @@
+/**
+ * R-10 framing solver (PRD-08) — pure math for "subject fills fraction p of
+ * the frame".
+ *
+ * `distanceForFraction(h, fovDeg, p) = h / (2·tan(fov/2)·p)` and the exact
+ * inverse `fractionForDistance(d, h, fovDeg)`. For portrait aspects the
+ * binding constraint is the narrower horizontal axis — `solveForAspect`
+ * converts a vertical-fov spec into the effective axis fov via the aspect
+ * ratio, so a subject framed at e.g. 1/8 frame height on a 390×844 screen
+ * stays framed the same way on 844×390.
+ */
+export interface AuraFramingContext {
+    /** Viewport aspect (width / height); 1 when unknown. */
+    readonly aspect?: number;
+}
+/** Distance so a subject of height `h` fills fraction `p` of the frame. */
+export declare function distanceForFraction(h: number, fovDeg: number, p: number): number;
+/** Inverse: fraction of the frame a subject of height `h` fills at `d`. */
+export declare function fractionForDistance(d: number, h: number, fovDeg: number): number;
+/**
+ * Effective fov for the binding axis. On landscape viewports the subject
+ * height is constrained by the vertical fov; on portrait viewports by the
+ * horizontal fov `2·atan(tan(fovV/2)·aspect)`. Returns the fov (degrees) to
+ * feed `distanceForFraction`/`fractionForDistance`.
+ */
+export declare function effectiveAxisFov(fovDeg: number, aspect?: number): number;
+/** Distance that frames a subject of height `h` at fraction `p` under `aspect`. */
+export declare function distanceForFractionInContext(h: number, fovDeg: number, p: number, context?: AuraFramingContext): number;
+/** Fraction `h` fills at distance `d` under `aspect`. */
+export declare function fractionForDistanceInContext(d: number, h: number, fovDeg: number, context?: AuraFramingContext): number;
+//# sourceMappingURL=framing.d.ts.map

package/dist/engine/agent-api/camera/framing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framing.d.ts","sourceRoot":"","sources":["../../../../../../packages/engine/src/agent-api/camera/framing.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,kBAAkB;IACjC,wDAAwD;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAIhF;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIhF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,SAAI,GAAG,MAAM,CAInE;AAID,mFAAmF;AACnF,wBAAgB,4BAA4B,CAC1C,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,MAAM,EACd,CAAC,EAAE,MAAM,EACT,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAER;AAED,yDAAyD;AACzD,wBAAgB,4BAA4B,CAC1C,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAER"}

package/dist/engine/agent-api/camera/framing.js

@@ -0,0 +1,50 @@
+/**
+ * R-10 framing solver (PRD-08) — pure math for "subject fills fraction p of
+ * the frame".
+ *
+ * `distanceForFraction(h, fovDeg, p) = h / (2·tan(fov/2)·p)` and the exact
+ * inverse `fractionForDistance(d, h, fovDeg)`. For portrait aspects the
+ * binding constraint is the narrower horizontal axis — `solveForAspect`
+ * converts a vertical-fov spec into the effective axis fov via the aspect
+ * ratio, so a subject framed at e.g. 1/8 frame height on a 390×844 screen
+ * stays framed the same way on 844×390.
+ */
+function toRadians(deg) {
+    return (deg * Math.PI) / 180;
+}
+/** Distance so a subject of height `h` fills fraction `p` of the frame. */
+export function distanceForFraction(h, fovDeg, p) {
+    const half = Math.tan(toRadians(fovDeg) / 2);
+    if (h <= 0 || half <= 0 || p <= 0)
+        return Number.POSITIVE_INFINITY;
+    return h / (2 * half * p);
+}
+/** Inverse: fraction of the frame a subject of height `h` fills at `d`. */
+export function fractionForDistance(d, h, fovDeg) {
+    const half = Math.tan(toRadians(fovDeg) / 2);
+    if (d <= 0 || h <= 0 || half <= 0)
+        return 0;
+    return h / (2 * d * half);
+}
+/**
+ * Effective fov for the binding axis. On landscape viewports the subject
+ * height is constrained by the vertical fov; on portrait viewports by the
+ * horizontal fov `2·atan(tan(fovV/2)·aspect)`. Returns the fov (degrees) to
+ * feed `distanceForFraction`/`fractionForDistance`.
+ */
+export function effectiveAxisFov(fovDeg, aspect = 1) {
+    if (aspect >= 1)
+        return fovDeg;
+    const vertical = Math.tan(toRadians(fovDeg) / 2) * Math.max(EPSILON_ASPECT, aspect);
+    return (2 * Math.atan(vertical) * 180) / Math.PI;
+}
+const EPSILON_ASPECT = 1e-6;
+/** Distance that frames a subject of height `h` at fraction `p` under `aspect`. */
+export function distanceForFractionInContext(h, fovDeg, p, context = {}) {
+    return distanceForFraction(h, effectiveAxisFov(fovDeg, context.aspect ?? 1), p);
+}
+/** Fraction `h` fills at distance `d` under `aspect`. */
+export function fractionForDistanceInContext(d, h, fovDeg, context = {}) {
+    return fractionForDistance(d, h, effectiveAxisFov(fovDeg, context.aspect ?? 1));
+}
+//# sourceMappingURL=framing.js.map