@aura3d/engine 3.0.1 → 4.0.0

package/dist/engine/agent-api/compiler/sceneGraph.js

@@ -0,0 +1,348 @@
+/**
+ * PRD-01 §15 Phase 1 (C-06) compiler bridge: scene-graph flatten + model matrix
+ * under `A3D_QR_CORE` (v2). Lane-01 file per PRD-01 §25 / Q-15-7.
+ *
+ * Flag off: every entry point returns exactly what the legacy
+ * `sceneMath.flattenSceneNodes` / `sceneMath.createModelMatrix` return (the
+ * moved bodies run unchanged).
+ *
+ * Flag on:
+ * - Groups compose a real 4×4 world matrix, `world(child) = world(parent) ·
+ *   local(child)` with `local = T · R(q) · S` (C-06 `composeWorldMatrix`), so a
+ *   rotated or scaled parent moves its children correctly (legacy adds the
+ *   Euler angles and positions component-wise).
+ * - `rotationOrder` (six orders) and `quaternion` (wins over `rotation`) are
+ *   honoured on every node (T1.5; removed from `diagnosticOnly.prd01.ts`).
+ * - The world matrix is decomposed back to TRS. When it is not sheared,
+ *   `position`/`rotation` ("ZYX" Euler)/`scale`/`quaternion` are overwritten for
+ *   legacy consumers (physics, labels, bounds). When it is sheared the TRS
+ *   cannot carry it: the matrix is kept in a side table (`worldTransformOf`),
+ *   only `position` is overwritten, and `SCENE_GRAPH_SHEAR` is reported.
+ * - `lookAt` is applied after composition: the target is a world-space point,
+ *   never transformed by the parent (child `lookAt` wins over the parent's).
+ * - `createModelMatrixV2` writes `T · R · S(nodeScale ⊙ size ⊙ fit) ·
+ *   normalizeOffset` into a caller-supplied output; the size/fit scale is the
+ *   innermost factor. Root nodes with the default "ZYX" order and no quaternion
+ *   are bit-identical to the legacy matrix.
+ * - Per-node dirty cache: a node's world matrix recomposes only when its TRS
+ *   fields or its parent's world matrix change; `composed`/`hits` counters.
+ */
+import { SCENE_GRAPH_SHEAR, composeTRSInto, decomposeMatrix, eulerToQuaternion, localMatrixOf, multiplyMat4Into, quaternionMultiply } from "../sceneGraph.js";
+import { animatedPosition, animatedRotation, flattenSceneNodes as legacyFlattenSceneNodes, createModelMatrix as legacyCreateModelMatrix, lowerLookNode, markLookNodeLowered, primitiveSize, resolveModelFitScale } from "../sceneMath.js";
+export { SCENE_GRAPH_SHEAR };
+export function isPrd01SceneGraphOn(flag) {
+    return typeof flag === "boolean" ? flag : flag.on("A3D_QR_CORE");
+}
+/* ------------------------------------------------------------------------ */
+/* World transform side table (flattened node -> composed world transform). */
+const worldTransforms = new WeakMap();
+/** The composed world transform attached by the flag-on flatten (undefined for root or flag-off nodes). */
+export function worldTransformOf(node) {
+    return node === undefined ? undefined : worldTransforms.get(node);
+}
+/* ------------------------------------------------------------------------ */
+/* Dirty cache.                                                              */
+const ORDER_CODE = { XYZ: 1, XZY: 2, YXZ: 3, YZX: 4, ZXY: 5, ZYX: 6 };
+const FP_LEN = 14;
+function fillTransformFingerprint(out, spec) {
+    const p = spec.position ?? [0, 0, 0];
+    const r = spec.rotation ?? [0, 0, 0];
+    const s = spec.scale === undefined ? [1, 1, 1] : typeof spec.scale === "number" ? [spec.scale, spec.scale, spec.scale] : spec.scale;
+    const q = spec.quaternion;
+    out[0] = p[0];
+    out[1] = p[1];
+    out[2] = p[2];
+    out[3] = r[0];
+    out[4] = r[1];
+    out[5] = r[2];
+    out[6] = s[0];
+    out[7] = s[1];
+    out[8] = s[2];
+    out[9] = q ? q[0] : Number.NaN;
+    out[10] = q ? q[1] : 0;
+    out[11] = q ? q[2] : 0;
+    out[12] = q ? q[3] : 0;
+    out[13] = ORDER_CODE[spec.rotationOrder ?? "ZYX"];
+}
+function sameFingerprint(a, b) {
+    for (let i = 0; i < FP_LEN; i += 1) {
+        // NaN marks "no quaternion"; Object.is treats NaN === NaN.
+        if (!Object.is(a[i], b[i]))
+            return false;
+    }
+    return true;
+}
+function sameParent(entry, parentWorld) {
+    if (parentWorld === null)
+        return !entry.hasParent;
+    if (!entry.hasParent)
+        return false;
+    for (let i = 0; i < 16; i += 1) {
+        if (!Object.is(entry.parent[i], parentWorld[i]))
+            return false;
+    }
+    return true;
+}
+export function createPrd01SceneGraphCache() {
+    const entries = new WeakMap();
+    const scratchFp = new Float64Array(FP_LEN);
+    const scratchLocal = new Float32Array(16);
+    let composed = 0;
+    let hits = 0;
+    return {
+        get composed() {
+            return composed;
+        },
+        get hits() {
+            return hits;
+        },
+        beginFrame() {
+            composed = 0;
+            hits = 0;
+        },
+        invalidate(node) {
+            entries.delete(node);
+        },
+        world(node, parentWorld) {
+            fillTransformFingerprint(scratchFp, node);
+            let entry = entries.get(node);
+            if (entry !== undefined && sameFingerprint(entry.fp, scratchFp) && sameParent(entry, parentWorld)) {
+                hits += 1;
+                return entry.world;
+            }
+            if (entry === undefined) {
+                entry = { fp: new Float64Array(FP_LEN), parent: new Float32Array(16), hasParent: false, world: new Float32Array(16) };
+                entries.set(node, entry);
+            }
+            entry.fp.set(scratchFp);
+            localMatrixOf(node, scratchLocal);
+            if (parentWorld === null) {
+                entry.hasParent = false;
+                entry.world.set(scratchLocal);
+            }
+            else {
+                entry.hasParent = true;
+                entry.parent.set(parentWorld);
+                multiplyMat4Into(entry.world, parentWorld, scratchLocal);
+            }
+            composed += 1;
+            return entry.world;
+        }
+    };
+}
+/* ------------------------------------------------------------------------ */
+/* Quaternion -> "ZYX" Euler (three.js `Euler.setFromRotationMatrix` "ZYX").  */
+const SCRATCH_ROT = new Float32Array(16);
+export function quaternionToEulerZYX(q) {
+    const m = composeTRSInto(SCRATCH_ROT, [0, 0, 0], q, [1, 1, 1]);
+    const m11 = m[0], m12 = m[4], m21 = m[1], m22 = m[5], m31 = m[2], m32 = m[6], m33 = m[10];
+    const y = Math.asin(-Math.min(1, Math.max(-1, m31)));
+    if (Math.abs(m31) < 0.9999999) {
+        return [Math.atan2(m32, m33), y, Math.atan2(m21, m11)];
+    }
+    return [0, y, Math.atan2(-m12, m22)];
+}
+function isPassThrough(node) {
+    return node.kind === "effect" || node.kind === "environment" || node.kind === "interaction";
+}
+function hasTransform(spec) {
+    return Boolean(spec.position || spec.rotation || spec.scale || spec.quaternion || spec.lookAt);
+}
+function nodeIdOf(node) {
+    const named = node;
+    if (typeof named.id === "string")
+        return named.id;
+    return typeof named.name === "string" ? named.name : undefined;
+}
+function applyParentWorld(node, parentWorld, parentLookAt, cache, options) {
+    if (isPassThrough(node))
+        return node;
+    if (parentWorld === null) {
+        // Root (or transform-free ancestors): unchanged, except an inherited world-space lookAt target.
+        if (parentLookAt === undefined || node.lookAt !== undefined)
+            return node;
+        return { ...node, lookAt: parentLookAt };
+    }
+    const world = Float32Array.from(cache.world(node, parentWorld));
+    const decomposed = decomposeMatrix(world);
+    // lookAt after composition: the target is world space; the child's own wins.
+    const lookAt = node.lookAt ?? parentLookAt;
+    let result;
+    if (decomposed.sheared) {
+        result = { ...node, position: decomposed.position, ...(lookAt ? { lookAt } : {}) };
+        const nodeId = nodeIdOf(node);
+        options.onDegradation?.({
+            code: SCENE_GRAPH_SHEAR,
+            ...(nodeId !== undefined ? { nodeId } : {}),
+            message: "Group composition produced a sheared world matrix; TRS fields keep the position only and the model matrix uses the full world matrix.",
+            ownerPrd: 1
+        });
+    }
+    else {
+        result = {
+            ...node,
+            position: decomposed.position,
+            rotation: quaternionToEulerZYX(decomposed.quaternion),
+            rotationOrder: "ZYX",
+            quaternion: decomposed.quaternion,
+            scale: decomposed.scale,
+            ...(lookAt ? { lookAt } : {})
+        };
+    }
+    worldTransforms.set(result, decomposed);
+    return result;
+}
+function flattenInto(nodes, parentWorld, parentLookAt, cache, options, out) {
+    for (const node of nodes) {
+        // A3D_QR_LOOKS: v1 look node keeps its slot; its lowered children follow.
+        const lowered = lowerLookNode(node);
+        if (lowered !== undefined) {
+            out.push(markLookNodeLowered(node));
+            flattenInto(lowered, parentWorld, parentLookAt, cache, options, out);
+            continue;
+        }
+        if (node.kind === "group") {
+            const groupWorld = hasTransform(node) ? cache.world(node, parentWorld) : parentWorld;
+            flattenInto(node.children, groupWorld, node.lookAt ?? parentLookAt, cache, options, out);
+            continue;
+        }
+        out.push(applyParentWorld(node, parentWorld, parentLookAt, cache, options));
+    }
+}
+/** C-06 flag-on flatten (true hierarchical composition). */
+export function flattenSceneNodesV2(nodes, options = {}) {
+    const out = [];
+    flattenInto(nodes, null, undefined, options.cache ?? createPrd01SceneGraphCache(), options, out);
+    return out;
+}
+/** Flag-gated flatten: flag off = legacy `sceneMath.flattenSceneNodes`, verbatim. */
+export function flattenAuraSceneNodes(nodes, flag, options = {}) {
+    return isPrd01SceneGraphOn(flag) ? flattenSceneNodesV2(nodes, options) : legacyFlattenSceneNodes(nodes);
+}
+/** Flag-gated snapshot flatten: flag off = legacy `sceneMath.flattenSceneSnapshot`. */
+export function flattenAuraSceneSnapshot(snapshot, flag, options = {}) {
+    return { ...snapshot, nodes: flattenAuraSceneNodes(snapshot.nodes, flag, options) };
+}
+const M_T = new Float32Array(16);
+const M_R = new Float32Array(16);
+const M_S = new Float32Array(16);
+const M_O = new Float32Array(16);
+const M_A = new Float32Array(16);
+const M_B = new Float32Array(16);
+const M_RX = new Float32Array(16);
+const M_RY = new Float32Array(16);
+const M_RZ = new Float32Array(16);
+function setIdentity(out) {
+    out.fill(0);
+    out[0] = 1;
+    out[5] = 1;
+    out[10] = 1;
+    out[15] = 1;
+    return out;
+}
+function setTranslation(out, x, y, z) {
+    setIdentity(out);
+    out[12] = x;
+    out[13] = y;
+    out[14] = z;
+    return out;
+}
+function setScaling(out, x, y, z) {
+    out.fill(0);
+    out[0] = x;
+    out[5] = y;
+    out[10] = z;
+    out[15] = 1;
+    return out;
+}
+/** Legacy `rotationXYZ` (Rz·Ry·Rx, three.js "ZYX"), same arithmetic, no allocation. */
+function setRotationZYX(out, rotation) {
+    const [x, y, z] = rotation;
+    const cx = Math.cos(x);
+    const sx = Math.sin(x);
+    const cy = Math.cos(y);
+    const sy = Math.sin(y);
+    const cz = Math.cos(z);
+    const sz = Math.sin(z);
+    M_RX.set([1, 0, 0, 0, 0, cx, sx, 0, 0, -sx, cx, 0, 0, 0, 0, 1]);
+    M_RY.set([cy, 0, -sy, 0, 0, 1, 0, 0, sy, 0, cy, 0, 0, 0, 0, 1]);
+    M_RZ.set([cz, sz, 0, 0, -sz, cz, 0, 0, 0, 0, 1, 0, 0, 0, 0, 1]);
+    multiplyMat4Into(M_A, M_RY, M_RX);
+    multiplyMat4Into(out, M_RZ, M_A);
+    return out;
+}
+function rotationDelta(node, time) {
+    if (!node?.animation)
+        return undefined;
+    const base = node.rotation ?? [0, 0, 0];
+    const animated = animatedRotation(node, time);
+    if (animated[0] === base[0] && animated[1] === base[1] && animated[2] === base[2])
+        return undefined;
+    return [animated[0] - base[0], animated[1] - base[1], animated[2] - base[2]];
+}
+/**
+ * C-06 flag-on model matrix: `T · R · S(nodeScale ⊙ size ⊙ fit) · normalizeOffset`
+ * written into `out`. R honours `quaternion` (animation spins compose as a local
+ * "ZYX" delta) and `rotationOrder`; a sheared group world matrix (attached by
+ * `flattenSceneNodesV2`) replaces T·R·S(nodeScale).
+ */
+export function createModelMatrixV2(node, bounds, normalizeToUnit, time = 0, out = new Float32Array(16)) {
+    const extent = [
+        Math.max(0.001, bounds.max[0] - bounds.min[0]),
+        Math.max(0.001, bounds.max[1] - bounds.min[1]),
+        Math.max(0.001, bounds.max[2] - bounds.min[2])
+    ];
+    const fitScale = resolveModelFitScale(node, extent, normalizeToUnit);
+    const centerX = (bounds.min[0] + bounds.max[0]) / 2;
+    const centerZ = (bounds.min[2] + bounds.max[2]) / 2;
+    const baseSize = node?.kind === "primitive" ? primitiveSize(node) : [1, 1, 1];
+    if (normalizeToUnit)
+        setTranslation(M_O, -centerX, -bounds.min[1], -centerZ);
+    else
+        setIdentity(M_O);
+    const position = animatedPosition(node, time);
+    const world = worldTransformOf(node);
+    if (world?.sheared) {
+        // W already carries T·R·S(nodeScale) of the whole chain; size ⊙ fit stays innermost.
+        setScaling(M_S, baseSize[0] * fitScale, baseSize[1] * fitScale, baseSize[2] * fitScale);
+        multiplyMat4Into(M_B, M_S, M_O);
+        const delta = rotationDelta(node, time);
+        if (delta) {
+            setRotationZYX(M_R, delta);
+            multiplyMat4Into(M_B, M_R, M_B);
+        }
+        multiplyMat4Into(out, world.matrix, M_B);
+        const base = node?.position ?? [0, 0, 0];
+        out[12] = out[12] + (position[0] - base[0]);
+        out[13] = out[13] + (position[1] - base[1]);
+        out[14] = out[14] + (position[2] - base[2]);
+        return out;
+    }
+    const nodeScale = typeof node?.scale === "number" ? [node.scale, node.scale, node.scale] : node?.scale ?? [1, 1, 1];
+    if (node?.quaternion) {
+        const delta = rotationDelta(node, time);
+        const q = delta ? quaternionMultiply(node.quaternion, eulerToQuaternion(delta, "ZYX")) : node.quaternion;
+        composeTRSInto(M_R, [0, 0, 0], q, [1, 1, 1]);
+    }
+    else {
+        const rotation = animatedRotation(node, time);
+        const order = node?.rotationOrder ?? "ZYX";
+        if (order === "ZYX")
+            setRotationZYX(M_R, rotation);
+        else
+            composeTRSInto(M_R, [0, 0, 0], eulerToQuaternion(rotation, order), [1, 1, 1]);
+    }
+    setScaling(M_S, nodeScale[0] * baseSize[0] * fitScale, nodeScale[1] * baseSize[1] * fitScale, nodeScale[2] * baseSize[2] * fitScale);
+    setTranslation(M_T, position[0], position[1], position[2]);
+    multiplyMat4Into(M_B, M_S, M_O);
+    multiplyMat4Into(M_A, M_R, M_B);
+    multiplyMat4Into(out, M_T, M_A);
+    return out;
+}
+/** Flag-gated model matrix: flag off = legacy `sceneMath.createModelMatrix`, verbatim. */
+export function modelMatrixFor(flag) {
+    if (!isPrd01SceneGraphOn(flag))
+        return legacyCreateModelMatrix;
+    return (node, bounds, normalizeToUnit, time = 0) => createModelMatrixV2(node, bounds, normalizeToUnit, time, new Float32Array(16));
+}
+//# sourceMappingURL=sceneGraph.js.map

package/dist/engine/agent-api/compiler/sceneGraph.js.map

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

package/dist/engine/agent-api/compiler/shadows.d.ts

@@ -0,0 +1,100 @@
+import type { AuraRendererRuntimeObservation, AuraSceneSnapshot } from "../nodes/types.js";
+import { type CollectedLight, type RendererShadowOptions } from "../../../rendering/index.js";
+import { type Prd02LightingKillSwitches } from "./lights.js";
+/** PRD-02 flag path returns a RendererShadowOptions-shaped view of the
+ *  resolved `ShadowSystemConfig` plus the config itself on `prd02Shadows`
+ *  (additive member; legacy consumers ignore it). */
+export interface Prd02ShadowOptions extends RendererShadowOptions {
+    readonly prd02Shadows?: ShadowSystemConfig;
+    /** `effects.contactShadows()` opt-in consumed by the prd02.contactShadows
+     *  contributor (PRD-02 §6.5; additive member, legacy consumers ignore it). */
+    readonly prd02Contact?: {
+        readonly length?: number;
+        readonly thickness?: number;
+        readonly steps?: number;
+        readonly intensity?: number;
+        readonly lights?: "sun" | "shadowed";
+    };
+    /** `?a3dLighting=` kill switches resolved at compile (PRD-02 §6.5). */
+    readonly prd02KillSwitches?: Prd02LightingKillSwitches;
+}
+export declare function createProductionRuntimeShadowOptions(snapshot: AuraSceneSnapshot, collectedLights: readonly CollectedLight[], flags?: {
+    on(name: string): boolean;
+}): RendererShadowOptions;
+export declare function describeProductionSpotShadow(input: {
+    readonly requested: boolean;
+    readonly casterIsSpot: boolean;
+    readonly casterName?: string;
+    readonly angle?: number;
+    readonly penumbra?: number;
+    readonly range?: number;
+    readonly mapRendered: boolean;
+    readonly mapSampled: boolean;
+}): NonNullable<AuraRendererRuntimeObservation["shadow"]>["spot"];
+import type { AuraQualityTier } from "../../../rendering/contracts/index.js";
+/** Renderer-facing shadow config produced under A3D_QR_LIGHTING (PRD-02 §6.4). */
+export interface ShadowSystemConfig {
+    readonly enabled: boolean;
+    /** Per-cascade/local map size — the C-27 tier value (default) or a per-light override. */
+    readonly mapSize: 1024 | 2048 | 4096;
+    /** Cascade count: "auto" resolves to 1 when scene radius ≤ 15 m, else the tier value. */
+    readonly cascades: 1 | 2 | 3 | 4;
+    readonly maxDistance: number;
+    readonly splitLambda: number;
+    readonly blend: number;
+    readonly filter: "hard" | "pcf" | "pcss" | "castano" | "vogel";
+    /** Hard removal fraction in full shadow — 1.0 under the flag (E-category fix). */
+    readonly strength: number;
+    /** Normalized constant bias; 0 = auto. */
+    readonly bias: number;
+    /** World-space normal offset = 1.5 × texel world size. */
+    readonly normalBias: number;
+    readonly sceneRadius: number;
+}
+/**
+ * Scene-bounds radius for shadow sizing. Nodes parked at y ≤ -50 (the
+ * offstage convention) do not count — the map size must not grow because
+ * an agent parked something far below the stage (PRD-02 §6.4 test).
+ */
+export declare function sceneShadowRadius(snapshot: AuraSceneSnapshot): number;
+/**
+ * Flag-path shadow config (PRD-02 §6.4): strength 1.0 for every category,
+ * size from the C-27 tier (`QUALITY_TIERS[tier].shadow`), "auto" cascades
+ * (1 when scene radius ≤ 15 m), maxDistance = min(camera.far, 150),
+ * lambda 0.75, bias 0, normalBias = 1.5 × texelWorld.
+ */
+export declare function resolveShadowSystemConfig(snapshot: AuraSceneSnapshot, descriptors: readonly {
+    readonly shadowRequested: boolean;
+    readonly shadowDisabled?: boolean;
+    readonly shadowOptions?: {
+        readonly cascades?: number | "auto";
+        readonly maxDistance?: number;
+        readonly splitLambda?: number;
+        readonly blend?: number;
+        readonly mapSize?: number;
+        readonly filter?: "hard" | "pcf" | "pcss";
+        readonly bias?: number;
+        readonly normalBias?: number;
+    };
+}[], tier: AuraQualityTier, options?: {
+    readonly cameraFar?: number;
+}): ShadowSystemConfig;
+/**
+ * `lighting.quality: "auto"` resolves through the C-27 stub (PRD-02 §6.8):
+ * "high" on desktop, "medium" on coarse pointers. The real compile-context
+ * quality arrives via `resolveLightingTier` once C-36 ctx wiring lands.
+ */
+export declare function prd02ResolveTier(requested: AuraQualityTier | "auto" | undefined): AuraQualityTier;
+/**
+ * Flag-path shadow options (PRD-02 §6.4): `collectPrd02Lights` →
+ * `selectShadowedLights` (explicit shadow first, autoSun promotes one
+ * directional, max = 1 sun + tier localShadowLights) →
+ * `resolveShadowSystemConfig` (strength 1.0, C-27 map size, bias 0, normalBias
+ * auto). Legacy `resolveProductionShadowCasterIndex` /
+ * `resolveProductionRuntimeShadowTuning` are not consulted on this path.
+ */
+export declare function createPrd02ShadowOptions(snapshot: AuraSceneSnapshot, options?: {
+    readonly tier?: AuraQualityTier | "auto";
+    readonly cameraFar?: number;
+}): Prd02ShadowOptions;
+//# sourceMappingURL=shadows.d.ts.map

package/dist/engine/agent-api/compiler/shadows.d.ts.map

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

package/dist/engine/agent-api/compiler/shadows.js

@@ -0,0 +1,175 @@
+// PR 0b-1 carve-out (CONTRACTS.md §3.2) — verbatim move from agent-api/index.ts; 0 changed logic lines.
+import { resolveProductionRuntimeShadowTuning } from "../compiler/observations.js";
+import { groups } from "../nodes/groups.js";
+import { resolveRendererSceneCategory } from "../rendererDiagnostics.js";
+import { createSpotShadowProjection, selectSpotShadowAtlasTier } from "../../../rendering/index.js";
+import { collectPrd02Lights, prd02LightingOn, readLightingKillSwitches, resolveLightingTier, selectShadowedLights } from "./lights.js";
+export function createProductionRuntimeShadowOptions(snapshot, collectedLights, flags) {
+    // T0-28: callers with an app-resolved QrFlags pass it (see qr-request);
+    // the ambient URL/env resolution inside prd02LightingOn is the fallback.
+    if (prd02LightingOn(flags))
+        return createPrd02ShadowOptions(snapshot);
+    const nodes = groups.flatten(snapshot.nodes);
+    const names = nodes.map((node) => "name" in node ? node.name?.toLowerCase() ?? "" : "");
+    const category = resolveRendererSceneCategory(snapshot, names);
+    const sceneRadius = nodes.reduce((radius, node) => {
+        const position = "position" in node && Array.isArray(node.position)
+            ? node.position
+            : [0, 0, 0];
+        const nodeScale = "scale" in node ? node.scale : undefined;
+        const scale = typeof nodeScale === "number"
+            ? Math.abs(nodeScale)
+            : Array.isArray(nodeScale) ? Math.max(...nodeScale.map(Math.abs)) : 1;
+        return Math.max(radius, Math.hypot(...position) + scale);
+    }, 1);
+    const shadowCaster = collectedLights.find((light) => light.castsShadow);
+    const size = sceneRadius > 30 ? 4096 : sceneRadius > 10 ? 2048 : 1024;
+    const tuning = resolveProductionRuntimeShadowTuning(shadowCaster?.kind, size, sceneRadius);
+    return {
+        enabled: Boolean(shadowCaster),
+        size,
+        ...tuning,
+        strength: category === "city-day" ? 0.38
+            : category === "material" || category === "product" ? 0.24
+                : 0.32,
+        pcfRadius: size >= 2048 ? 1.5 : 1.2,
+        pcfSamples: size >= 2048 ? 16 : 9,
+        filter: "pcf",
+        label: `aura3d-root-production-${category}-${size}px-shadow-map`
+    };
+}
+export function describeProductionSpotShadow(input) {
+    if (!input.requested || !input.casterIsSpot || input.angle === undefined) {
+        return {
+            requested: input.requested,
+            casterIsSpot: input.casterIsSpot,
+            ...(input.casterName === undefined ? {} : { casterName: input.casterName }),
+            spotPixelBacked: false,
+            reason: !input.requested
+                ? "no authored spot requested a shadow map"
+                : !input.casterIsSpot
+                    ? "shadow requested but the caster slot went to a non-spot light"
+                    : "spot caster has no cone description"
+        };
+    }
+    // Tier selection validates the cone fail-closed (RangeError on bad angle);
+    // the full projection matrix composes in-device from this cone + range.
+    const tier = selectSpotShadowAtlasTier(input.angle);
+    createSpotShadowProjection(input.angle, Math.max(1, input.range ?? 12));
+    const backed = input.mapRendered && input.mapSampled;
+    return {
+        requested: true,
+        casterIsSpot: true,
+        ...(input.casterName === undefined ? {} : { casterName: input.casterName }),
+        angle: input.angle,
+        ...(input.penumbra === undefined ? {} : { penumbra: input.penumbra }),
+        range: Math.max(1, input.range ?? 12),
+        atlasResolution: tier.resolution,
+        atlasReason: tier.reason,
+        spotPixelBacked: backed,
+        reason: backed
+            ? `spot shadow map rendered and sampled (${tier.resolution}px ${tier.reason})`
+            : "spot caster selected but the device shows no rendered+sampled shadow map yet"
+    };
+}
+import { QUALITY_TIERS } from "../../../rendering/contracts/index.js";
+const FILTER_BY_TIER = {
+    pcf2: "hard",
+    pcf3: "castano",
+    pcf5: "vogel"
+};
+/**
+ * Scene-bounds radius for shadow sizing. Nodes parked at y ≤ -50 (the
+ * offstage convention) do not count — the map size must not grow because
+ * an agent parked something far below the stage (PRD-02 §6.4 test).
+ */
+export function sceneShadowRadius(snapshot) {
+    const nodes = groups.flatten(snapshot.nodes);
+    return nodes.reduce((radius, node) => {
+        const position = "position" in node && Array.isArray(node.position) ? node.position : [0, 0, 0];
+        if (position[1] <= -50)
+            return radius;
+        const nodeScale = "scale" in node ? node.scale : undefined;
+        const scale = typeof nodeScale === "number"
+            ? Math.abs(nodeScale)
+            : Array.isArray(nodeScale) ? Math.max(...nodeScale.map(Math.abs)) : 1;
+        return Math.max(radius, Math.hypot(...position) + scale);
+    }, 1);
+}
+/**
+ * Flag-path shadow config (PRD-02 §6.4): strength 1.0 for every category,
+ * size from the C-27 tier (`QUALITY_TIERS[tier].shadow`), "auto" cascades
+ * (1 when scene radius ≤ 15 m), maxDistance = min(camera.far, 150),
+ * lambda 0.75, bias 0, normalBias = 1.5 × texelWorld.
+ */
+export function resolveShadowSystemConfig(snapshot, descriptors, tier, options = {}) {
+    const settings = QUALITY_TIERS[tier];
+    const radius = sceneShadowRadius(snapshot);
+    const sunOptions = descriptors.find((d) => d.shadowRequested && !d.shadowDisabled)?.shadowOptions;
+    const cascadesOpt = sunOptions?.cascades;
+    const cascades = (cascadesOpt === undefined || cascadesOpt === "auto")
+        ? (radius <= 15 ? 1 : settings.shadow.cascades)
+        : cascadesOpt;
+    const mapSize = (sunOptions?.mapSize ?? settings.shadow.mapSize);
+    const texelWorld = (radius * 2) / mapSize;
+    const enabled = descriptors.some((d) => d.shadowRequested && !d.shadowDisabled);
+    return {
+        enabled,
+        mapSize,
+        cascades,
+        maxDistance: Math.min(options.cameraFar ?? 150, sunOptions?.maxDistance ?? 150),
+        splitLambda: sunOptions?.splitLambda ?? 0.75,
+        blend: sunOptions?.blend ?? 0.1,
+        filter: sunOptions?.filter === "pcss" ? "pcss" : FILTER_BY_TIER[settings.shadow.filter],
+        strength: 1.0,
+        bias: sunOptions?.bias ?? 0,
+        normalBias: sunOptions?.normalBias ?? 1.5 * texelWorld,
+        sceneRadius: radius
+    };
+}
+/**
+ * `lighting.quality: "auto"` resolves through the C-27 stub (PRD-02 §6.8):
+ * "high" on desktop, "medium" on coarse pointers. The real compile-context
+ * quality arrives via `resolveLightingTier` once C-36 ctx wiring lands.
+ */
+export function prd02ResolveTier(requested) {
+    if (requested && requested !== "auto")
+        return requested;
+    const coarse = typeof matchMedia === "function" && matchMedia("(pointer: coarse)").matches;
+    return resolveLightingTier(undefined, { quality: { tier: coarse ? "medium" : "high" } });
+}
+/**
+ * Flag-path shadow options (PRD-02 §6.4): `collectPrd02Lights` →
+ * `selectShadowedLights` (explicit shadow first, autoSun promotes one
+ * directional, max = 1 sun + tier localShadowLights) →
+ * `resolveShadowSystemConfig` (strength 1.0, C-27 map size, bias 0, normalBias
+ * auto). Legacy `resolveProductionShadowCasterIndex` /
+ * `resolveProductionRuntimeShadowTuning` are not consulted on this path.
+ */
+export function createPrd02ShadowOptions(snapshot, options = {}) {
+    const tier = prd02ResolveTier(options.tier);
+    const collected = collectPrd02Lights(snapshot);
+    const selection = selectShadowedLights(collected.descriptors, {
+        autoSunShadow: true,
+        max: 1 + QUALITY_TIERS[tier].shadow.localShadowLights
+    });
+    const config = resolveShadowSystemConfig(snapshot, collected.descriptors, tier, { cameraFar: options.cameraFar });
+    const contactNode = groups.flatten(snapshot.nodes).find((node) => node.kind === "effect" && node.effect === "contact-shadows");
+    const contactRequest = contactNode && "contactShadows" in contactNode
+        ? contactNode.contactShadows
+        : undefined;
+    return {
+        enabled: config.enabled && selection.casters.length > 0,
+        size: config.mapSize,
+        strength: config.strength,
+        bias: config.bias,
+        filter: "pcf",
+        cascadeCount: config.cascades,
+        cascadeLambda: config.splitLambda,
+        label: `aura3d-prd02-${tier}-${config.mapSize}px-${config.cascades}casc-shadow-map`,
+        prd02Shadows: config,
+        ...(contactRequest ? { prd02Contact: contactRequest } : {}),
+        prd02KillSwitches: readLightingKillSwitches()
+    };
+}
+//# sourceMappingURL=shadows.js.map