@aura3d/engine 3.0.0 → 4.0.0

package/dist/engine/contracts/camera.d.ts

@@ -0,0 +1,195 @@
+/**
+ * C-22 — CameraRig live API (CONTRACTS.md). Provider: PRD 08. Flag: A3D_QR_CAMERA.
+ */
+import type { AuraVec3, AuraRuntimeNodeHandle } from "../agent-api/index.js";
+export interface AuraCameraPose {
+    readonly position: AuraVec3;
+    readonly target: AuraVec3;
+    readonly up: AuraVec3;
+    readonly roll: number;
+    readonly fov: number;
+    readonly near: number;
+    readonly far: number;
+    readonly orthographicSize?: number;
+}
+export type AuraEaseName = "linear" | "inQuad" | "outQuad" | "inOutQuad" | "inCubic" | "outCubic" | "inOutCubic" | "outBack" | "outElastic" | "inOutSine" | "outExpo";
+export interface AuraCameraSubject {
+    readonly position: AuraVec3;
+    readonly velocity: AuraVec3;
+    readonly forward: AuraVec3;
+    readonly bounds: {
+        readonly min: AuraVec3;
+        readonly max: AuraVec3;
+    };
+    /**
+     * V-6 (additive): model telemetry a rig may prefer over kinematic
+     * estimates — bicycle-model subjects publish `lateralG` (bank input) and
+     * `vLong` (perSpeed FOV input); rigs fall back to `yawRate·speed` /
+     * `|velocity|` when absent.
+     */
+    readonly telemetry?: {
+        readonly lateralG?: number;
+        readonly vLong?: number;
+    };
+}
+export interface AuraCameraProbe {
+    sphereCast(from: AuraVec3, to: AuraVec3, radius: number): {
+        readonly hit: boolean;
+        readonly distance: number;
+        readonly node?: string;
+    };
+    occluders(from: AuraVec3, to: AuraVec3): readonly string[];
+}
+export interface AuraCameraRigContext {
+    readonly dt: number;
+    readonly time: number;
+    readonly aspect: number;
+    readonly previous: AuraCameraPose;
+    subject(ref: string | AuraRuntimeNodeHandle): AuraCameraSubject | undefined;
+    readonly probe: AuraCameraProbe;
+}
+export interface AuraCameraRig {
+    readonly id: string;
+    /**
+     * `true` when the rig resamples external state (a tracked subject, pointer,
+     * vehicle telemetry) every frame — its output can change without any API
+     * call, so the frame driver must keep ticking it. Fixed-pose rigs (static,
+     * spec shots without a target) omit this and may idle out once settled.
+     */
+    readonly continuous?: boolean;
+    update(ctx: AuraCameraRigContext): AuraCameraPose;
+    reset?(pose?: AuraCameraPose): void;
+}
+export interface AuraCameraLayer {
+    readonly id: string;
+    readonly timeDomain?: "real" | "sim";
+    apply(pose: AuraCameraPose, ctx: {
+        readonly dt: number;
+        readonly reducedMotion: boolean;
+    }): AuraCameraPose;
+    readonly energy?: () => number;
+}
+export interface AuraTraumaLayer extends AuraCameraLayer {
+    add(amount: number): void;
+    configure(o: {
+        maxAngleDeg?: number;
+        maxOffset?: number;
+        frequency?: number;
+        decayPerSecond?: number;
+    }): void;
+}
+export interface AuraPunchLayer extends AuraCameraLayer {
+    trigger(o: {
+        fov?: number;
+        dolly?: number;
+        attack?: number;
+        hold?: number;
+        release?: number;
+    }): void;
+}
+export interface AuraFovKickLayer extends AuraCameraLayer {
+    set(channel: string, offsetDeg: number, halflife?: number): void;
+}
+export interface AuraCameraShot {
+    readonly rig: AuraCameraRig;
+    readonly duration: number;
+    readonly blendIn?: number;
+    readonly bars?: boolean;
+}
+export interface AuraCameraSequence {
+    readonly id: string;
+    readonly shots: readonly AuraCameraShot[];
+    readonly onEnd?: "hold" | "return";
+}
+export interface AuraCameraSequencePlayback {
+    readonly done: Promise<void>;
+    skip(): void;
+    readonly progress: number;
+}
+export interface AuraCameraEvidence {
+    readonly kind: "aura-camera-presented";
+    readonly rig: string;
+    readonly pose: AuraCameraPose;
+    readonly viewProjection: readonly number[];
+    readonly layers: readonly {
+        readonly id: string;
+        readonly energy: number;
+    }[];
+    readonly subjectScreenHeightFraction?: number;
+    readonly cutThisFrame: boolean;
+}
+export interface AuraCameraController {
+    presented(): AuraCameraPose;
+    setPose(p: Partial<AuraCameraPose>, o?: {
+        cut?: boolean;
+    }): void;
+    setFov(fov: number, o?: {
+        halflife?: number;
+    }): void;
+    setRoll(roll: number, o?: {
+        halflife?: number;
+    }): void;
+    use(rig: AuraCameraRig, o?: {
+        blend?: number;
+        ease?: AuraEaseName;
+    }): void;
+    readonly rig: AuraCameraRig;
+    addLayer(l: AuraCameraLayer, order?: number): () => void;
+    readonly shake: AuraTraumaLayer;
+    readonly punch: AuraPunchLayer;
+    readonly fovKick: AuraFovKickLayer;
+    play(s: AuraCameraSequence): AuraCameraSequencePlayback;
+    cut(): void;
+    evidence(): AuraCameraEvidence;
+}
+export interface AuraCameraRailOptions {
+    readonly points: readonly AuraVec3[];
+    readonly lookAt: string | AuraVec3 | readonly AuraVec3[];
+    readonly fov?: number | readonly number[];
+    readonly duration: number;
+    readonly ease?: AuraEaseName;
+    readonly loop?: "none" | "loop" | "pingpong";
+    readonly alpha?: number;
+}
+export interface AuraCameraRigFactories {
+    chase(o: Readonly<Record<string, unknown>> & {
+        target: string;
+    }): AuraCameraRig;
+    flight(o: Readonly<Record<string, unknown>> & {
+        target: string;
+        horizonLock?: number;
+        followPitch?: number;
+    }): AuraCameraRig;
+    follow2d(o: Readonly<Record<string, unknown>> & {
+        target: string;
+    }): AuraCameraRig;
+    fighting(o: Readonly<Record<string, unknown>> & {
+        fighters: readonly [string, string];
+    }): AuraCameraRig;
+    shoulder(o: Readonly<Record<string, unknown>> & {
+        target: string;
+    }): AuraCameraRig;
+    orbit(o: Readonly<Record<string, unknown>>): AuraCameraRig;
+    topDown(o: Readonly<Record<string, unknown>> & {
+        target?: string;
+        pitchDeg?: number;
+    }): AuraCameraRig;
+    altitude(o: Readonly<Record<string, unknown>> & {
+        target: string;
+    }): AuraCameraRig;
+    rail(o: AuraCameraRailOptions): AuraCameraRig;
+    static(pose: Partial<AuraCameraPose>): AuraCameraRig;
+    fromSpec(spec: unknown): AuraCameraRig;
+}
+export interface AuraCameraOption {
+    readonly legacy?: boolean;
+    readonly freezeSpecs?: boolean;
+}
+/**
+ * PR 0a stub factories: `static` and `fromSpec` are real; the others return a
+ * static rig at the subject's bounds plus the spec offset (with a
+ * `capability-degraded` degradation recorded by the host).
+ */
+export declare const stubCameraRigFactories: AuraCameraRigFactories;
+export { resolveCameraFrame } from "../agent-api/compiler/camera.js";
+//# sourceMappingURL=camera.d.ts.map

package/dist/engine/contracts/camera.d.ts.map

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

package/dist/engine/contracts/camera.js

@@ -0,0 +1,42 @@
+/**
+ * C-22 — CameraRig live API (CONTRACTS.md). Provider: PRD 08. Flag: A3D_QR_CAMERA.
+ */
+const DEFAULT_POSE = {
+    position: [0, 1.6, 5],
+    target: [0, 1, 0],
+    up: [0, 1, 0],
+    roll: 0,
+    fov: 50,
+    near: 0.1,
+    far: 1000
+};
+/**
+ * PR 0a stub factories: `static` and `fromSpec` are real; the others return a
+ * static rig at the subject's bounds plus the spec offset (with a
+ * `capability-degraded` degradation recorded by the host).
+ */
+export const stubCameraRigFactories = {
+    chase: (o) => staticRig({ target: [0, 0, 0], position: [0, 2, 6] }, `chase:${o.target}`),
+    flight: (o) => staticRig({ target: [0, 0, 0], position: [0, 4, 8] }, `flight:${o.target}`),
+    follow2d: (o) => staticRig({ target: [0, 0, 0], position: [0, 0, 8] }, `follow2d:${o.target}`),
+    fighting: (o) => staticRig({ target: [0, 1, 0], position: [0, 2, 6] }, `fighting:${o.fighters.join(",")}`),
+    shoulder: (o) => staticRig({ target: [0, 1, 0], position: [0, 2, 2] }, `shoulder:${o.target}`),
+    orbit: (_o) => staticRig({ target: [0, 0, 0], position: [3, 2, 3] }, "orbit"),
+    topDown: (o) => staticRig({ target: [0, 0, 0], position: [0, 10, 0.001], up: [0, 0, -1] }, `topDown:${o.target ?? ""}`),
+    altitude: (o) => staticRig({ target: [0, 0, 0], position: [0, 6, 6] }, `altitude:${o.target}`),
+    rail: (o) => staticRig({ target: o.lookAt ?? [0, 0, 0], position: o.points[0] ?? [0, 1, 5] }, "rail"),
+    static: (pose) => staticRig(pose, "static"),
+    fromSpec: (spec) => staticRig(spec, "fromSpec")
+};
+function staticRig(pose, id) {
+    const full = { ...DEFAULT_POSE, ...pose };
+    return {
+        id,
+        update: () => full,
+        reset: () => { }
+    };
+}
+// T0-32: bf1789b0 dropped `resolveCameraFrame` from "." — re-export under C-22
+// (camera contract surface) so scaffold's inContracts rule keeps it live.
+export { resolveCameraFrame } from "../agent-api/compiler/camera.js";
+//# sourceMappingURL=camera.js.map

package/dist/engine/contracts/camera.js.map

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

package/dist/engine/contracts/compiler.d.ts

@@ -0,0 +1,147 @@
+/**
+ * C-36 — SceneCompiler extension points (CONTRACTS.md). Provider: PRD 15.
+ * Seam: `agent-api/compiler/` and `agent-api/nodes/` (PR 0b). Flag: A3D_QR_COMPILER,
+ * sub-flag A3D_QR_STRICT.
+ */
+import type { PrdId, QrFlagName, QrFlags } from "../../rendering/contracts/index.js";
+import { type ContractSlot } from "../../rendering/contracts/index.js";
+import type { AuraQualityTier } from "../../rendering/contracts/index.js";
+import type { AuraSceneSnapshot, AuraRuntimeNodeHandle, AuraRuntimeNodeRegistry } from "../agent-api/index.js";
+export type AuraDegradationCode = "renderer-mount-failed" | "texture-upgrade-failed" | "sdf-text-fallback" | "pose-apply-failed" | "clip-apply-failed" | "morph-apply-failed" | "foot-planting-failed" | "extension-lobe-pending" | "capability-degraded" | "option-ignored";
+export interface AuraDegradation {
+    readonly code: AuraDegradationCode;
+    readonly nodeId?: string;
+    readonly message: string;
+    readonly cause?: unknown;
+    readonly frame: number;
+    readonly ownerPrd?: number;
+}
+export type AuraCompiledFeature = "lights.directional" | "lights.point" | "lights.spot" | "lights.ambient" | "lights.hemisphere" | "environment.ibl" | "environment.background" | "shadows.directional" | "shadows.csm" | "shadows.spot" | "shadows.point" | "fog" | "post.bloom" | "post.ao" | "post.ssr" | "post.dof" | "post.taa" | "post.smaa" | "post.fxaa" | "post.colorGrade" | "instancing" | "skinning" | "morph" | "text.sdf" | "particles" | "water" | "sky.dayNight" | "weather" | `${"world" | "vfx" | "look"}.${string}`;
+export interface SceneCompileContext {
+    readonly renderer: unknown;
+    readonly assets: unknown;
+    readonly quality: unknown & {
+        readonly tier: AuraQualityTier;
+    };
+    readonly strict: boolean;
+    readonly flags: QrFlags;
+    degrade(d: Omit<AuraDegradation, "frame">): void;
+}
+export interface CompiledActor {
+    readonly nodeId: string;
+    dispose(): void;
+}
+export interface CompiledScene {
+    readonly snapshotVersion: number;
+    readonly source: unknown;
+    readonly actors: readonly CompiledActor[];
+    readonly features: ReadonlySet<AuraCompiledFeature>;
+    readonly degradations: readonly AuraDegradation[];
+    dispose(): void;
+}
+export interface NodeHandler<N extends {
+    readonly kind: string;
+}> {
+    readonly kind: N["kind"];
+    readonly owner: PrdId;
+    readonly flag?: QrFlagName;
+    compile(node: N, ctx: SceneCompileContext, out: RenderSourceContributions): void | Promise<void>;
+    update?(node: N, handle: AuraRuntimeNodeHandle | undefined, ctx: SceneCompileContext, out: RenderSourceContributions, timeSeconds: number): void;
+    dispose?(node: N): void;
+}
+export interface RenderSourceContributions {
+    addItems(items: readonly unknown[]): void;
+    addLights(lights: readonly unknown[]): void;
+    set<K extends string>(field: K, value: unknown): void;
+    feature(f: AuraCompiledFeature): void;
+}
+/** Node kinds: open registry via declaration merging (PR 0a declares every kind in the catalog). */
+export interface AuraNodeKindMap {
+    model: unknown;
+    primitive: unknown;
+    group: unknown;
+    light: unknown;
+    effect: unknown;
+    interaction: unknown;
+    label: unknown;
+    environment: unknown;
+    sky: unknown;
+    look: unknown;
+    probe: unknown;
+    biome: unknown;
+    "time-of-day": unknown;
+    wind: unknown;
+    terrain: unknown;
+    water: unknown;
+    scatter: unknown;
+    grass: unknown;
+}
+export interface AnyNodeHandler {
+    readonly kind: string;
+    readonly owner: PrdId;
+    readonly flag?: QrFlagName;
+    compile(node: {
+        readonly kind: string;
+    }, ctx: SceneCompileContext, out: RenderSourceContributions): void | Promise<void>;
+    update?(node: {
+        readonly kind: string;
+    }, handle: AuraRuntimeNodeHandle | undefined, ctx: SceneCompileContext, out: RenderSourceContributions, timeSeconds: number): void;
+    dispose?(node: {
+        readonly kind: string;
+    }): void;
+}
+export declare function registerNodeHandler<K extends keyof AuraNodeKindMap>(handler: NodeHandler<{
+    readonly kind: K & string;
+}>): () => void;
+export declare function nodeHandlerFor(kind: string): AnyNodeHandler | undefined;
+export declare function nodeHandlersAll(): readonly AnyNodeHandler[];
+export declare const DIAGNOSTIC_ONLY_FIELDS: Readonly<Record<string, {
+    readonly reason: string;
+    readonly ownerPrd: number;
+}>>;
+export interface OptionCoverageRow {
+    readonly builder: string;
+    readonly field: string;
+    readonly probeValueA: unknown;
+    readonly probeValueB: unknown;
+    readonly ownerPrd: number;
+    readonly beforeOptions?: readonly string[];
+}
+export declare function registerOptionCoverage(rows: readonly OptionCoverageRow[]): void;
+export declare function optionCoverageRows(): readonly OptionCoverageRow[];
+export interface CompilerImpl {
+    compile(snapshot: AuraSceneSnapshot, ctx: SceneCompileContext): Promise<CompiledScene>;
+    update(compiled: CompiledScene, snapshot: AuraSceneSnapshot, runtime: AuraRuntimeNodeRegistry, timeSeconds: number): unknown;
+}
+/**
+ * C-36 slot (PRD-15 T3.11): `packages/engine/src/lanes/prd15.ts` calls
+ * `compilerSlot.provide(real)` once; `compileScene` selects real iff
+ * `ctx.flags.on("A3D_QR_COMPILER")`, else the stub. `updateCompiledScene`
+ * routes to the real impl once provided — the real impl no-ops on compiled
+ * scenes it did not produce, so flag-off mounts keep stub semantics.
+ */
+export declare const compilerSlot: ContractSlot<CompilerImpl>;
+/** PR 0b seam: `agent-api/compiler/` binds the moved createProductionRuntime* path. */
+export declare function setCompilerImpl(compile: (snapshot: AuraSceneSnapshot, ctx: SceneCompileContext) => Promise<CompiledScene>, update: (compiled: CompiledScene, snapshot: AuraSceneSnapshot, runtime: AuraRuntimeNodeRegistry, timeSeconds: number) => unknown): void;
+export declare function compileScene(snapshot: AuraSceneSnapshot, ctx: SceneCompileContext): Promise<CompiledScene>;
+export declare function updateCompiledScene(compiled: CompiledScene, snapshot: AuraSceneSnapshot, runtime: AuraRuntimeNodeRegistry, timeSeconds: number, flags?: QrFlags): unknown;
+/**
+ * The mounted state a real C-36 compiled scene carries (agent-api/compiler/compileScene.ts).
+ * Declared here so the renderer and the runtime-node registry can consume it without
+ * importing the impl — importing the impl would close an agent-api import cycle.
+ */
+export interface RuntimeCompiledSceneInternals {
+    source: unknown | null;
+    lastInput: unknown | null;
+    actorEntries: readonly unknown[];
+    primitiveEntries: readonly unknown[];
+    liveNodes: readonly import("../agent-api/nodes/types.js").AuraSceneNode[];
+    addSubtree(node: import("../agent-api/nodes/types.js").AuraSceneNode, parentId?: string): void;
+    removeSubtree(runtimeId: string): boolean;
+    dispose(): void;
+}
+/** Called by the real impl's constructor — self-binds its mounted internals. */
+export declare function bindRuntimeCompiled(scene: CompiledScene, internals: RuntimeCompiledSceneInternals): void;
+/** Runtime internals of a real-compiled scene, or null for stubs/foreign impls. */
+export declare function asRuntimeCompiled(compiled: CompiledScene): RuntimeCompiledSceneInternals | null;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/engine/contracts/compiler.d.ts.map

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

package/dist/engine/contracts/compiler.js

@@ -0,0 +1,110 @@
+/**
+ * C-36 — SceneCompiler extension points (CONTRACTS.md). Provider: PRD 15.
+ * Seam: `agent-api/compiler/` and `agent-api/nodes/` (PR 0b). Flag: A3D_QR_COMPILER,
+ * sub-flag A3D_QR_STRICT.
+ */
+import { defineContractSlot } from "../../rendering/contracts/index.js";
+import { resolveQrFlags } from "./flags.js";
+const nodeHandlers = new Map();
+export function registerNodeHandler(handler) {
+    const kind = String(handler.kind);
+    const existing = nodeHandlers.get(kind);
+    if (existing && existing.flag === handler.flag) {
+        throw new Error(`NODE_HANDLER_DUPLICATE:${kind}`);
+    }
+    nodeHandlers.set(kind, handler);
+    return () => {
+        if (nodeHandlers.get(kind) === handler)
+            nodeHandlers.delete(kind);
+    };
+}
+export function nodeHandlerFor(kind) {
+    return nodeHandlers.get(kind);
+}
+export function nodeHandlersAll() {
+    return [...nodeHandlers.values()];
+}
+export const DIAGNOSTIC_ONLY_FIELDS = {
+    // Merged from `agent-api/compiler/diagnosticOnly.prdNN.ts`; lanes clear their
+    // entries as they wire them. PR 0a seeds the known-unconsumed additions.
+    "transform.rotationOrder": { reason: "C-06: composeWorldMatrix stub lowers to ZYX", ownerPrd: 1 },
+    "transform.quaternion": { reason: "C-06: composeWorldMatrix stub lowers to euler", ownerPrd: 1 },
+    "light.power": { reason: "C-10: lumen conversion is PRD 02's", ownerPrd: 2 },
+    "material.alphaToCoverage": { reason: "C-15: MSAA alpha-to-coverage is PRD 04's", ownerPrd: 4 },
+    "material.doubleSided": { reason: "C-15: double-sided pipeline variant is PRD 04's", ownerPrd: 4 },
+    "material.unlit": { reason: "C-15: unlit lobe is PRD 04's", ownerPrd: 4 },
+    "model.materialOverrides": { reason: "C-15: override seam is PRD 04's", ownerPrd: 4 },
+    "model.variant": { reason: "C-15: variant seam is PRD 04's", ownerPrd: 4 },
+    "model.lod": { reason: "C-17: LOD resolution is PRD 05's", ownerPrd: 5 },
+    "model.collider": { reason: "C-17: collider resolution is PRD 05's", ownerPrd: 5 },
+    "animation.fallback": { reason: "C-19: fallback semantics are PRD 06's", ownerPrd: 6 },
+    "animation.layer": { reason: "C-19: layered mixer is PRD 06's", ownerPrd: 6 },
+    "animation.blendMode": { reason: "C-19: blend modes are PRD 06's", ownerPrd: 6 },
+    "animation.additiveReference": { reason: "C-19: additive reference is PRD 06's", ownerPrd: 6 },
+    "animation.mask": { reason: "C-19: bone masks are PRD 06's", ownerPrd: 6 },
+    "animation.weight": { reason: "C-19: layer weights are PRD 06's", ownerPrd: 6 },
+    "animation.restPoseReset": { reason: "C-19: rest-pose reset is PRD 06's", ownerPrd: 6 }
+};
+const optionCoverage = new Map();
+export function registerOptionCoverage(rows) {
+    for (const row of rows) {
+        optionCoverage.set(`${row.builder}.${row.field}`, row);
+    }
+}
+export function optionCoverageRows() {
+    return [...optionCoverage.values()];
+}
+const stubCompiledScene = () => ({
+    snapshotVersion: 0,
+    source: null,
+    actors: [],
+    features: new Set(),
+    degradations: [{ code: "capability-degraded", message: "compiler stub: no impl bound", frame: 0 }],
+    dispose() { }
+});
+const stubCompilerImpl = {
+    compile: async () => stubCompiledScene(),
+    update: (compiled) => compiled.source
+};
+/**
+ * C-36 slot (PRD-15 T3.11): `packages/engine/src/lanes/prd15.ts` calls
+ * `compilerSlot.provide(real)` once; `compileScene` selects real iff
+ * `ctx.flags.on("A3D_QR_COMPILER")`, else the stub. `updateCompiledScene`
+ * routes to the real impl once provided — the real impl no-ops on compiled
+ * scenes it did not produce, so flag-off mounts keep stub semantics.
+ */
+export const compilerSlot = defineContractSlot("C-36", "prd15", "A3D_QR_COMPILER", stubCompilerImpl);
+let compileSceneImpl = null;
+/** PR 0b seam: `agent-api/compiler/` binds the moved createProductionRuntime* path. */
+export function setCompilerImpl(compile, update) {
+    compileSceneImpl = compile;
+    void update; // superseded by compilerSlot; retained for export-surface parity
+}
+export async function compileScene(snapshot, ctx) {
+    const flags = ctx?.flags ?? resolveQrFlags({});
+    const impl = compilerSlot.get(flags);
+    if (impl !== stubCompilerImpl && Array.isArray(snapshot?.nodes))
+        return impl.compile(snapshot, ctx);
+    if (compileSceneImpl && Array.isArray(snapshot?.nodes))
+        return compileSceneImpl(snapshot, ctx);
+    return stubCompilerImpl.compile(snapshot, ctx);
+}
+export function updateCompiledScene(compiled, snapshot, runtime, timeSeconds, flags) {
+    if (compilerSlot.provided) {
+        // T0-28: the mounting app's flags select the impl (the same flags that
+        // picked it in compileScene); `all` stays the fallback for app-less callers.
+        const impl = compilerSlot.get(flags ?? resolveQrFlags({ options: "all" }));
+        return impl.update(compiled, snapshot, runtime, timeSeconds);
+    }
+    return compiled.source;
+}
+const runtimeCompiledInternals = new WeakMap();
+/** Called by the real impl's constructor — self-binds its mounted internals. */
+export function bindRuntimeCompiled(scene, internals) {
+    runtimeCompiledInternals.set(scene, internals);
+}
+/** Runtime internals of a real-compiled scene, or null for stubs/foreign impls. */
+export function asRuntimeCompiled(compiled) {
+    return runtimeCompiledInternals.get(compiled) ?? null;
+}
+//# sourceMappingURL=compiler.js.map

package/dist/engine/contracts/compiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.js","sourceRoot":"","sources":["../../../../../packages/engine/src/contracts/compiler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,kBAAkB,EAAqB,MAAM,6BAA6B,CAAC;AAGpF,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AA4B5C,MAAM,YAAY,GAAG,IAAI,GAAG,EAA0B,CAAC;AAEvD,MAAM,UAAU,mBAAmB,CAAkC,OAAmD;IACtH,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,QAAQ,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,0BAA0B,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,OAAyB,CAAC,CAAC;IAClD,OAAO,GAAG,EAAE;QACV,IAAI,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,OAAO;YAAE,YAAY,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpE,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,CAAC,MAAM,sBAAsB,GAAqF;IACtH,8EAA8E;IAC9E,yEAAyE;IACzE,yBAAyB,EAAE,EAAE,MAAM,EAAE,6CAA6C,EAAE,QAAQ,EAAE,CAAC,EAAE;IACjG,sBAAsB,EAAE,EAAE,MAAM,EAAE,+CAA+C,EAAE,QAAQ,EAAE,CAAC,EAAE;IAChG,aAAa,EAAE,EAAE,MAAM,EAAE,oCAAoC,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC5E,0BAA0B,EAAE,EAAE,MAAM,EAAE,0CAA0C,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC/F,sBAAsB,EAAE,EAAE,MAAM,EAAE,iDAAiD,EAAE,QAAQ,EAAE,CAAC,EAAE;IAClG,gBAAgB,EAAE,EAAE,MAAM,EAAE,8BAA8B,EAAE,QAAQ,EAAE,CAAC,EAAE;IACzE,yBAAyB,EAAE,EAAE,MAAM,EAAE,iCAAiC,EAAE,QAAQ,EAAE,CAAC,EAAE;IACrF,eAAe,EAAE,EAAE,MAAM,EAAE,gCAAgC,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC1E,WAAW,EAAE,EAAE,MAAM,EAAE,kCAAkC,EAAE,QAAQ,EAAE,CAAC,EAAE;IACxE,gBAAgB,EAAE,EAAE,MAAM,EAAE,uCAAuC,EAAE,QAAQ,EAAE,CAAC,EAAE;IAClF,oBAAoB,EAAE,EAAE,MAAM,EAAE,uCAAuC,EAAE,QAAQ,EAAE,CAAC,EAAE;IACtF,iBAAiB,EAAE,EAAE,MAAM,EAAE,iCAAiC,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC7E,qBAAqB,EAAE,EAAE,MAAM,EAAE,gCAAgC,EAAE,QAAQ,EAAE,CAAC,EAAE;IAChF,6BAA6B,EAAE,EAAE,MAAM,EAAE,sCAAsC,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC9F,gBAAgB,EAAE,EAAE,MAAM,EAAE,+BAA+B,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC1E,kBAAkB,EAAE,EAAE,MAAM,EAAE,kCAAkC,EAAE,QAAQ,EAAE,CAAC,EAAE;IAC/E,yBAAyB,EAAE,EAAE,MAAM,EAAE,mCAAmC,EAAE,QAAQ,EAAE,CAAC,EAAE;CACxF,CAAC;AAIF,MAAM,cAAc,GAAG,IAAI,GAAG,EAA6B,CAAC;AAE5D,MAAM,UAAU,sBAAsB,CAAC,IAAkC;IACvE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,cAAc,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,KAAK,EAAE,EAAE,GAAG,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,OAAO,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC,CAAC;AACtC,CAAC;AAOD,MAAM,iBAAiB,GAAG,GAAkB,EAAE,CAAC,CAAC;IAC9C,eAAe,EAAE,CAAC;IAClB,MAAM,EAAE,IAAI;IACZ,MAAM,EAAE,EAAE;IACV,QAAQ,EAAE,IAAI,GAAG,EAAuB;IACxC,YAAY,EAAE,CAAC,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,8BAA8B,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAClG,OAAO,KAAsB,CAAC;CAC/B,CAAC,CAAC;AAEH,MAAM,gBAAgB,GAAiB;IACrC,OAAO,EAAE,KAAK,IAAI,EAAE,CAAC,iBAAiB,EAAE;IACxC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM;CACtC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAA+B,kBAAkB,CACxE,MAAM,EAAE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,CACrD,CAAC;AAEF,IAAI,gBAAgB,GAA+F,IAAI,CAAC;AAExH,uFAAuF;AACvF,MAAM,UAAU,eAAe,CAC7B,OAA0F,EAC1F,MAAgI;IAEhI,gBAAgB,GAAG,OAAO,CAAC;IAC3B,KAAK,MAAM,CAAC,CAAC,iEAAiE;AAChF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,QAA2B,EAAE,GAAwB;IACtF,MAAM,KAAK,GAAG,GAAG,EAAE,KAAK,IAAI,cAAc,CAAC,EAAE,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,IAAI,KAAK,gBAAgB,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACpG,IAAI,gBAAgB,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC;QAAE,OAAO,gBAAgB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC/F,OAAO,gBAAgB,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,QAAuB,EAAE,QAA2B,EAAE,OAAgC,EAAE,WAAmB,EAAE,KAAe;IAC9J,IAAI,YAAY,CAAC,QAAQ,EAAE,CAAC;QAC1B,uEAAuE;QACvE,6EAA6E;QAC7E,MAAM,IAAI,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,IAAI,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QAC3E,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,QAAQ,CAAC,MAAM,CAAC;AACzB,CAAC;AAkBD,MAAM,wBAAwB,GAAG,IAAI,OAAO,EAAgD,CAAC;AAE7F,gFAAgF;AAChF,MAAM,UAAU,mBAAmB,CAAC,KAAoB,EAAE,SAAwC;IAChG,wBAAwB,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AACjD,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,iBAAiB,CAAC,QAAuB;IACvD,OAAO,wBAAwB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;AACxD,CAAC"}

package/dist/engine/contracts/diagnostics.d.ts

@@ -0,0 +1,37 @@
+/**
+ * C-31 — diagnostics sections (CONTRACTS.md). Provider: PRD 15 (custodian). Flag: none.
+ * AuraDiagnostics (index.ts:10377) gains optional members for every key below in PR 0a.
+ */
+import type { RegistryEntry } from "../../rendering/contracts/index.js";
+import type { AuraApp } from "../agent-api/index.js";
+export interface AppliedLookReport {
+    readonly exposure: number;
+    readonly toneMapping: "aces-filmic" | "agx" | "neutral" | "reinhard" | "none";
+    readonly environment: {
+        readonly specularIntensity: number;
+        readonly diffuseIntensity: number;
+        readonly background: "color" | "hdri" | "sky";
+    };
+    readonly shadows: ShadowReport | null;
+    readonly fallbackLightsActive: boolean;
+    readonly renderPath: "production" | "safe-basic" | "lean" | "compat-preset";
+    readonly pixelRatio: number;
+}
+export interface ShadowReport {
+    readonly mapRendered: boolean;
+    readonly mapSampled: boolean;
+    readonly mapSize: number | null;
+    readonly strength: number | null;
+    readonly casterName: string | null;
+}
+export interface DiagnosticsSection<T = unknown> extends RegistryEntry {
+    readonly id: string;
+    readonly key: AuraDiagnosticsSectionKey;
+    collect(app: AuraApp): T;
+}
+export type AuraDiagnosticsSectionKey = "output" | "resolution" | "programs" | "frameAllocations" | "lighting" | "shadows" | "post" | "exposure" | "materials" | "assets" | "animation" | "effects" | "atmosphere" | "camera" | "loop" | "game" | "world" | "frame" | "renderer.batching" | "quality" | "appliedLook" | "frameTiming" | "look" | "degradations" | "compiledFeatures" | "qrFlags";
+export declare function registerDiagnosticsSection<T>(section: DiagnosticsSection<T>): () => void;
+/** Section keys, in declaration order — used by the C-31 stub and the ownership check. */
+export declare const DIAGNOSTICS_SECTION_KEYS: readonly AuraDiagnosticsSectionKey[];
+export declare function diagnosticsSectionsAll(): readonly DiagnosticsSection<unknown>[];
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/engine/contracts/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../../../packages/engine/src/contracts/diagnostics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAEjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAGlD,MAAM,WAAW,iBAAiB;IAAG,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,aAAa,GAAG,KAAK,GAAG,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE;QAAE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAA;KAAE,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,YAAY,GAAG,YAAY,GAAG,MAAM,GAAG,eAAe,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAAE;AACzd,MAAM,WAAW,YAAY;IAAG,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAAE;AACrM,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,aAAa;IAAG,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,yBAAyB,CAAC;IAAC,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,CAAC,CAAC;CAAE;AAClK,MAAM,MAAM,yBAAyB,GACjC,QAAQ,GAAG,YAAY,GAAG,UAAU,GAAG,kBAAkB,GACzD,UAAU,GAAG,SAAS,GACtB,MAAM,GAAG,UAAU,GACnB,WAAW,GACX,QAAQ,GACR,WAAW,GACX,SAAS,GAAG,YAAY,GACxB,QAAQ,GAAG,MAAM,GACjB,MAAM,GACN,OAAO,GACP,OAAO,GAAG,mBAAmB,GAAG,SAAS,GACzC,aAAa,GAAG,aAAa,GAC7B,MAAM,GACN,cAAc,GAAG,kBAAkB,GAAG,SAAS,CAAC;AAIpD,wBAAgB,0BAA0B,CAAC,CAAC,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAExF;AAED,0FAA0F;AAC1F,eAAO,MAAM,wBAAwB,EAAE,SAAS,yBAAyB,EAexE,CAAC;AAEF,wBAAgB,sBAAsB,IAAI,SAAS,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAE/E"}

package/dist/engine/contracts/diagnostics.js

@@ -0,0 +1,30 @@
+/**
+ * C-31 — diagnostics sections (CONTRACTS.md). Provider: PRD 15 (custodian). Flag: none.
+ * AuraDiagnostics (index.ts:10377) gains optional members for every key below in PR 0a.
+ */
+import { createRegistry } from "../../rendering/contracts/index.js";
+const diagnosticsSections = createRegistry("diagnosticsSections");
+export function registerDiagnosticsSection(section) {
+    return diagnosticsSections.register(section);
+}
+/** Section keys, in declaration order — used by the C-31 stub and the ownership check. */
+export const DIAGNOSTICS_SECTION_KEYS = [
+    "output", "resolution", "programs", "frameAllocations",
+    "lighting", "shadows",
+    "post", "exposure",
+    "materials",
+    "assets",
+    "animation",
+    "effects", "atmosphere",
+    "camera", "loop",
+    "game",
+    "world",
+    "frame", "renderer.batching", "quality",
+    "appliedLook", "frameTiming",
+    "look",
+    "degradations", "compiledFeatures", "qrFlags"
+];
+export function diagnosticsSectionsAll() {
+    return diagnosticsSections.all();
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/engine/contracts/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../../../../packages/engine/src/contracts/diagnostics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAuB7D,MAAM,mBAAmB,GAAG,cAAc,CAAqB,qBAAqB,CAAC,CAAC;AAEtF,MAAM,UAAU,0BAA0B,CAAI,OAA8B;IAC1E,OAAO,mBAAmB,CAAC,QAAQ,CAAC,OAAsC,CAAC,CAAC;AAC9E,CAAC;AAED,0FAA0F;AAC1F,MAAM,CAAC,MAAM,wBAAwB,GAAyC;IAC5E,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,kBAAkB;IACtD,UAAU,EAAE,SAAS;IACrB,MAAM,EAAE,UAAU;IAClB,WAAW;IACX,QAAQ;IACR,WAAW;IACX,SAAS,EAAE,YAAY;IACvB,QAAQ,EAAE,MAAM;IAChB,MAAM;IACN,OAAO;IACP,OAAO,EAAE,mBAAmB,EAAE,SAAS;IACvC,aAAa,EAAE,aAAa;IAC5B,MAAM;IACN,cAAc,EAAE,kBAAkB,EAAE,SAAS;CAC9C,CAAC;AAEF,MAAM,UAAU,sBAAsB;IACpC,OAAO,mBAAmB,CAAC,GAAG,EAAE,CAAC;AACnC,CAAC"}