@aura3d/rendering 3.0.1 → 4.0.2

package/dist/shadows/Prd02DepthShaderLibrary.js

@@ -0,0 +1,381 @@
+/**
+ * PRD-02 Phase 4 — C-11 shadow-caster depth variants.
+ *
+ * One depth shader body compiled per variant id (`shadowCasterVariantId`):
+ * instanced draws pull `u_instanceMatrices` via `gl_InstanceID` (64/draw, the
+ * same uniform-array convention the lit shaders use when instance attributes
+ * are absent), skinned draws reuse the `skinning_common` chunk (uniform or
+ * data-texture palette through `u_jointPaletteMode`), alpha-tested casters
+ * sample `u_baseColorTexture` and discard below `u_alphaCutoff`. Extra
+ * `DepthVariantFeature`s registered for pass "depth" splice their own defines.
+ *
+ * Flag: A3D_QR_LIGHTING.
+ */
+import { depthVariantFeaturesFor, registerDepthVariantFeature } from "../contracts/shadows.js";
+import { shaderChunk } from "../contracts/program.js";
+import { MAX_UNIFORM_SKINNING_JOINTS } from "../ShaderChunks.js";
+import { MaterialInstance } from "../MaterialInstance.js";
+import { shadowCasterVariantId } from "../contracts/shadows.js";
+export const PRD02_DEPTH_SHADER_NAME = "aura3d/prd02-depth";
+export const PRD02_DEPTH_SHADER_MARKER = "@aura3d-shader:prd02-depth";
+/** Uniform-path instancing cap; larger batches split into multiple draws. */
+export const PRD02_DEPTH_MAX_INSTANCES = 64;
+export function registerPrd02DepthShader(library) {
+    library.register({
+        name: PRD02_DEPTH_SHADER_NAME,
+        marker: PRD02_DEPTH_SHADER_MARKER,
+        vertex: `#version 300 es
+// ${PRD02_DEPTH_SHADER_MARKER}
+precision highp float;
+layout(location = 0) in vec3 a_position;
+#if A3D_DEPTH_SKINNED
+layout(location = 5) in vec4 a_joints;
+layout(location = 6) in vec4 a_weights;
+#endif
+#if A3D_DEPTH_ALPHA
+layout(location = 2) in vec2 a_uv;
+out vec2 v_depthUv;
+#endif
+uniform mat4 u_modelViewProjection;
+#if A3D_DEPTH_INSTANCED
+uniform mat4 u_instanceMatrices[${PRD02_DEPTH_MAX_INSTANCES}];
+uniform float u_instanceCount;
+#endif
+#if A3D_DEPTH_SKINNED
+#include <skinning_common>
+#endif
+void main() {
+#if A3D_DEPTH_ALPHA
+  v_depthUv = a_uv;
+#endif
+#if A3D_DEPTH_SKINNED
+  vec4 local = a3dSkinMatrix4(a_joints, a_weights) * vec4(a_position, 1.0);
+#else
+  vec4 local = vec4(a_position, 1.0);
+#endif
+#if A3D_DEPTH_INSTANCED
+  int instanceIndex = clamp(gl_InstanceID, 0, max(int(u_instanceCount) - 1, 0));
+  gl_Position = u_modelViewProjection * (u_instanceMatrices[instanceIndex] * local);
+#else
+  gl_Position = u_modelViewProjection * local;
+#endif
+}
+`,
+        fragment: `#version 300 es
+// ${PRD02_DEPTH_SHADER_MARKER}
+precision highp float;
+#if A3D_DEPTH_ALPHA
+in vec2 v_depthUv;
+uniform sampler2D u_baseColorTexture;
+uniform float u_alphaCutoff;
+#endif
+out vec4 outColor;
+void main() {
+#if A3D_DEPTH_ALPHA
+  if (texture(u_baseColorTexture, v_depthUv).a < u_alphaCutoff) discard;
+#endif
+  outColor = vec4(vec3(gl_FragCoord.z), 1.0);
+}
+`
+    });
+}
+// ---------------------------------------------------------------------------
+// C-11 feature registration + real resolver ("provide real for the stub")
+// ---------------------------------------------------------------------------
+let registeredDepthFeatures = false;
+const prd02Features = [];
+const PRD02_DEPTH_FEATURES = [
+    {
+        id: "prd02.depthInstancing",
+        owner: "prd02",
+        flag: "A3D_QR_LIGHTING",
+        order: 10,
+        passes: ["depth"],
+        select: (input) => (input.item.instanceTransforms || input.item.instanceAttributes ? 1 : undefined),
+        defines: () => ({ A3D_DEPTH_INSTANCED: 1 }),
+        chunks: [],
+        hooks: []
+    },
+    {
+        id: "prd02.depthAlpha",
+        owner: "prd02",
+        flag: "A3D_QR_LIGHTING",
+        order: 20,
+        passes: ["depth"],
+        select: (input) => (casterAlphaCutoff(input.item) !== null ? 1 : undefined),
+        defines: () => ({ A3D_DEPTH_ALPHA: 1 }),
+        chunks: [],
+        hooks: []
+    },
+    {
+        id: "prd02.depthSkinning",
+        owner: "prd02",
+        flag: "A3D_QR_LIGHTING",
+        order: 30,
+        passes: ["depth"],
+        select: (input) => {
+            const skinning = input.item.skinning;
+            return skinning ? (skinning.extraInfluences ? 8 : 4) : undefined;
+        },
+        defines: () => ({ A3D_DEPTH_SKINNED: 1 }),
+        chunks: [],
+        hooks: []
+    }
+];
+/**
+ * Registers `prd02.depthInstancing`, `prd02.depthAlpha`, `prd02.depthSkinning`.
+ * Idempotent. The C-11 registry (`contracts/shadows.ts`) exposes no enumeration
+ * accessor — only `registerDepthVariantFeature` — so lanes that register their
+ * own depth features (e.g. prd06) must pass them into `ShadowSystem` until
+ * lane-01 adds a registry reader (qr-request logged).
+ */
+export function ensurePrd02DepthFeatures() {
+    if (registeredDepthFeatures)
+        return;
+    registeredDepthFeatures = true;
+    for (const feature of PRD02_DEPTH_FEATURES) {
+        registerDepthVariantFeature(feature);
+        prd02Features.push(feature);
+    }
+}
+/** The depth-variant features this lane registered (see note above). */
+export function prd02DepthFeatures() {
+    ensurePrd02DepthFeatures();
+    return prd02Features;
+}
+/**
+ * 02-DEPTH: every C-11 depth-variant feature active under `flags` for the
+ * shadow "depth" pass — prd02's own plus other lanes' (prd05.lodDither,
+ * prd06.deform, prd10.wind, prd11.drawId) via lane 01's
+ * `depthVariantFeaturesFor` (#751).
+ */
+export function activeDepthFeatures(flags) {
+    ensurePrd02DepthFeatures();
+    return depthVariantFeaturesFor(flags).filter((feature) => feature.passes.includes("depth"));
+}
+/** Features selected for this variant that claim the C-18 `vertex:deform` hook. */
+function selectedDeformFeatures(key, depthFeatures) {
+    return depthFeatures.filter((feature) => key.features[feature.id] !== undefined && feature.hooks.includes("vertex:deform"));
+}
+/** `requires`-first closure of a feature's chunks (each chunk once). */
+function chunkClosure(names, out, seen, stack = []) {
+    for (const name of names) {
+        if (seen.has(name))
+            continue;
+        if (stack.includes(name))
+            throw new Error(`SHADER_CHUNK_CYCLE:${[...stack, name].join(">")}`);
+        const chunk = shaderChunk(name);
+        if (!chunk)
+            throw new Error(`SHADER_CHUNK_MISSING:${name}`);
+        chunkClosure(chunk.requires ?? [], out, seen, [...stack, name]);
+        seen.add(name);
+        out.push(chunk);
+    }
+}
+/** Why a deform feature cannot be spliced (C-18 needs `a3dDeform`), or null. */
+export function depthDeformIncompatibility(feature) {
+    const chunks = [];
+    try {
+        chunkClosure(feature.chunks, chunks, new Set());
+    }
+    catch (error) {
+        return `${feature.id}: ${error instanceof Error ? error.message : String(error)}`;
+    }
+    if (chunks.some((chunk) => chunk.stage === "fragment"))
+        return `${feature.id}: fragment-stage chunk at vertex:deform`;
+    return chunks.some((chunk) => /\ba3dDeform\s*\(/.test(chunk.glsl)) ? null : `${feature.id}: no a3dDeform() entry point (C-18)`;
+}
+/**
+ * 02-DEPTH: splice the selected `vertex:deform` features into the depth
+ * vertex source — chunk closure at global scope before `main`, and the
+ * canonical C-18 call `a3dDeform(pos, nrm, tan)` replacing the object-space
+ * position. Features without an `a3dDeform` entry point are not spliced; the
+ * caller reports them (C-31 droppedFeatures).
+ */
+export function composeDepthDeformVertex(vertex, key, depthFeatures) {
+    const deform = selectedDeformFeatures(key, depthFeatures).filter((feature) => depthDeformIncompatibility(feature) === null);
+    if (deform.length === 0)
+        return vertex;
+    const chunks = [];
+    const seen = new Set();
+    for (const feature of deform)
+        chunkClosure(feature.chunks, chunks, seen);
+    const decls = chunks.map((chunk) => chunk.glsl).join("\n");
+    const call = [
+        "  // C-18 deform (02-DEPTH): registered vertex:deform features own object space.",
+        "  vec3 a3dDeformNormal = vec3(0.0, 0.0, 1.0);",
+        "  vec4 a3dDeformTangent = vec4(0.0);",
+        "  a3dDeform(local, a3dDeformNormal, a3dDeformTangent);"
+    ].join("\n");
+    const mainAt = vertex.indexOf("void main() {");
+    if (mainAt < 0)
+        throw new Error("PRD02_DEPTH_DEFORM_ANCHOR_MISSING:main");
+    // The call goes after `local` is formed and before it is projected (the
+    // first instancing or gl_Position statement; #if blocks may already be
+    // resolved by the preprocessor).
+    const body = vertex.slice(mainAt);
+    const anchor = /\n[ \t]*(?:#if A3D_DEPTH_INSTANCED|int instanceIndex|gl_Position\s*=)/.exec(body);
+    if (!anchor)
+        throw new Error("PRD02_DEPTH_DEFORM_ANCHOR_MISSING:projection");
+    const at = mainAt + anchor.index;
+    return `${vertex.slice(0, mainAt)}${decls}\n${vertex.slice(mainAt, at)}\n${call}${vertex.slice(at)}`;
+}
+/** Base material of an item's RenderMaterial (instances unwrap). */
+function baseOf(material) {
+    return material instanceof MaterialInstance ? material.baseMaterial : material;
+}
+/** Alpha-cutoff set on the caster material's parameter map, or null. */
+export function casterAlphaCutoff(item) {
+    const material = item.material;
+    if (!material)
+        return null;
+    const value = material.getParameter?.("u_alphaCutoff");
+    if (typeof value === "number" && value > 0)
+        return value;
+    return null;
+}
+/**
+ * Real C-11 resolution (supersedes the PR-0a stub for the PRD-02 depth path):
+ * fills every variant bit plus the `features` map from the registered
+ * depth-variant features whose `select` returns a value for this item.
+ */
+export function resolvePrd02ShadowCasterVariant(item, flags, tier, depthFeatures = []) {
+    const skinning = item.skinning;
+    const features = {};
+    for (const feature of depthFeatures) {
+        const value = feature.select({ item, pass: "depth", tier, flags });
+        if (value !== undefined)
+            features[feature.id] = value;
+    }
+    const base = item.material ? baseOf(item.material) : null;
+    const blended = base?.renderState.blend === true;
+    // "batched" = produced by `batchStaticRenderItems` (SceneOptimization.ts):
+    // it stamps a multi-instance `instanceTransforms` chunk under a
+    // `static-batch-*` label. Authored instancing may share the field, so the
+    // label prefix is the stronger marker; either marks the batch variant.
+    const instanced = item.instanceTransforms !== undefined || item.instanceAttributes !== undefined;
+    const batched = (item.instanceTransforms?.length ?? 0) > 16 ||
+        /^static-batch-/.test(item.label ?? "");
+    // A spliced vertex:deform feature (e.g. prd06.deform) owns skinning/morph
+    // in object space, so the built-in prd02 skinning path stays off for it.
+    const deformOwnsSkinning = depthFeatures.some((feature) => features[feature.id] !== undefined && feature.hooks.includes("vertex:deform") && depthDeformIncompatibility(feature) === null);
+    return {
+        skinning: skinning && !deformOwnsSkinning ? (skinning.extraInfluences ? 8 : 4) : 0,
+        skinningTexture: (skinning?.jointCount ?? 0) > MAX_UNIFORM_SKINNING_JOINTS,
+        morphTargets: (item.morphTargets?.length ?? 0) > 0 || (item.morphWeights?.length ?? 0) > 0,
+        instanced,
+        batched,
+        alphaTest: casterAlphaCutoff(item) !== null,
+        // BLEND + explicit castShadow: alpha-hashed depth (no cutoff); BLEND
+        // without castShadow is excluded upstream (prd02ShadowCasterEligible).
+        alphaHash: blended && item.castShadow === true,
+        doubleSided: base ? base.renderState.cullMode === "none" : false,
+        features
+    };
+}
+/** §6.4 caster rule: BLEND items are excluded unless `castShadow === true`
+ *  (then they take the alpha-hash variant); `castShadow === false` always
+ *  excludes. Everything else casts. */
+export function prd02ShadowCasterEligible(item) {
+    if (item.castShadow === false)
+        return false;
+    const base = item.material ? baseOf(item.material) : null;
+    if (base?.renderState.blend === true && item.castShadow !== true)
+        return false;
+    return true;
+}
+/** GLSL defines a variant key compiles the depth body with. */
+export function prd02DepthVariantDefines(key, depthFeatures = []) {
+    // ShaderPreprocessor rejects #if on an undefined name — emit all three.
+    const defines = {
+        A3D_DEPTH_INSTANCED: 0,
+        A3D_DEPTH_SKINNED: 0,
+        A3D_DEPTH_ALPHA: 0
+    };
+    if (key.instanced)
+        defines.A3D_DEPTH_INSTANCED = 1;
+    if (key.skinning > 0)
+        defines.A3D_DEPTH_SKINNED = 1;
+    if (key.alphaTest || key.alphaHash)
+        defines.A3D_DEPTH_ALPHA = 1;
+    for (const feature of depthFeatures) {
+        const value = key.features[feature.id];
+        if (value !== undefined)
+            Object.assign(defines, feature.defines(value));
+    }
+    return defines;
+}
+// ---------------------------------------------------------------------------
+// Program cache + precompile (C-28)
+// ---------------------------------------------------------------------------
+/**
+ * Variant programs keyed by variant id, per device — DepthPass instances are
+ * constructed per pass, so the cache lives on the device (WeakMap) and dies
+ * with it, mirroring the per-library WeakMap above.
+ */
+const depthPrograms = new WeakMap();
+function programKey(library, key, features) {
+    const extra = features.map((feature) => feature.id).sort().join(",");
+    return `${library.getRevision()}:${shadowCasterVariantId(key)}:${extra}`;
+}
+/** Compile (or fetch) the composed depth program for a caster variant. */
+export function prd02DepthProgram(device, library, key, features = []) {
+    let perDevice = depthPrograms.get(device);
+    if (!perDevice) {
+        perDevice = new Map();
+        depthPrograms.set(device, perDevice);
+    }
+    const id = programKey(library, key, features);
+    let program = perDevice.get(id);
+    if (!program || program.disposed) {
+        const source = library.compileSource(PRD02_DEPTH_SHADER_NAME, { defines: prd02DepthVariantDefines(key, features) });
+        program = device.createShaderProgram({
+            label: source.label,
+            marker: source.marker,
+            vertex: composeDepthDeformVertex(source.vertex, key, features),
+            fragment: source.fragment,
+            ...(source.webgpu ? { webgpu: source.webgpu } : {}),
+            ...(source.portableBindings ? { portableBindings: source.portableBindings } : {})
+        });
+        perDevice.set(id, program);
+    }
+    return program;
+}
+/**
+ * C-28 warm-up: compile every distinct variant once (async via
+ * `device.compileAsync` when the backend supports it) so steady-state frames
+ * show `programCompileCount` delta 0.
+ */
+export async function precompilePrd02DepthVariants(device, library, variants) {
+    const pending = [];
+    let perDevice = depthPrograms.get(device);
+    if (!perDevice) {
+        perDevice = new Map();
+        depthPrograms.set(device, perDevice);
+    }
+    for (const [id, variant] of variants) {
+        const cacheKey = `${library.getRevision()}:${id}:${variant.features.map((feature) => feature.id).sort().join(",")}`;
+        const existing = perDevice.get(cacheKey);
+        if (existing && !existing.disposed)
+            continue;
+        const source = library.compileSource(PRD02_DEPTH_SHADER_NAME, { defines: prd02DepthVariantDefines(variant.key, variant.features) });
+        const sources = {
+            label: source.label,
+            marker: source.marker,
+            vertex: composeDepthDeformVertex(source.vertex, variant.key, variant.features),
+            fragment: source.fragment,
+            ...(source.webgpu ? { webgpu: source.webgpu } : {}),
+            ...(source.portableBindings ? { portableBindings: source.portableBindings } : {})
+        };
+        if (device.compileAsync) {
+            pending.push(device.compileAsync(sources).then((program) => {
+                perDevice.set(cacheKey, program);
+            }));
+        }
+        else {
+            perDevice.set(cacheKey, device.createShaderProgram(sources));
+        }
+    }
+    await Promise.all(pending);
+}
+//# sourceMappingURL=Prd02DepthShaderLibrary.js.map

package/dist/shadows/Prd02DepthShaderLibrary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Prd02DepthShaderLibrary.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/shadows/Prd02DepthShaderLibrary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAG5B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAoB,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAIvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7D,MAAM,CAAC,MAAM,uBAAuB,GAAG,oBAAoB,CAAC;AAC5D,MAAM,CAAC,MAAM,yBAAyB,GAAG,4BAA4B,CAAC;AACtE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,yBAAyB,GAAG,EAAE,CAAC;AAE5C,MAAM,UAAU,wBAAwB,CAAC,OAAsB;IAC7D,OAAO,CAAC,QAAQ,CAAC;QACf,IAAI,EAAE,uBAAuB;QAC7B,MAAM,EAAE,yBAAyB;QACjC,MAAM,EAAE;KACP,yBAAyB;;;;;;;;;;;;;kCAaI,yBAAyB;;;;;;;;;;;;;;;;;;;;;;CAsB1D;QACG,QAAQ,EAAE;KACT,yBAAyB;;;;;;;;;;;;;;CAc7B;KACE,CAAC,CAAC;AACL,CAAC;AAED,8EAA8E;AAC9E,0EAA0E;AAC1E,8EAA8E;AAE9E,IAAI,uBAAuB,GAAG,KAAK,CAAC;AACpC,MAAM,aAAa,GAA0B,EAAE,CAAC;AAEhD,MAAM,oBAAoB,GAAmC;IAC3D;QACE,EAAE,EAAE,uBAAuB;QAC3B,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,CAAC,OAAO,CAAC;QACjB,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,IAAI,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnG,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,mBAAmB,EAAE,CAAC,EAAE,CAAC;QAC3C,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,EAAE;KACV;IACD;QACE,EAAE,EAAE,kBAAkB;QACtB,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,CAAC,OAAO,CAAC;QACjB,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3E,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;QACvC,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,EAAE;KACV;IACD;QACE,EAAE,EAAE,qBAAqB;QACzB,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,CAAC,OAAO,CAAC;QACjB,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAChB,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;YACrC,OAAO,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnE,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC;QACzC,MAAM,EAAE,EAAE;QACV,KAAK,EAAE,EAAE;KACV;CACF,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB;IACtC,IAAI,uBAAuB;QAAE,OAAO;IACpC,uBAAuB,GAAG,IAAI,CAAC;IAC/B,KAAK,MAAM,OAAO,IAAI,oBAAoB,EAAE,CAAC;QAC3C,2BAA2B,CAAC,OAAO,CAAC,CAAC;QACrC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,kBAAkB;IAChC,wBAAwB,EAAE,CAAC;IAC3B,OAAO,aAAa,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,wBAAwB,EAAE,CAAC;IAC3B,OAAO,uBAAuB,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AAC9F,CAAC;AAED,mFAAmF;AACnF,SAAS,sBAAsB,CAC7B,GAA2B,EAC3B,aAA6C;IAE7C,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC;AAC9H,CAAC;AAED,wEAAwE;AACxE,SAAS,YAAY,CAAC,KAAwB,EAAE,GAAkB,EAAE,IAAiB,EAAE,QAAkB,EAAE;IACzG,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,SAAS;QAC7B,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC9F,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,EAAE,CAAC,CAAC;QAC5D,YAAY,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;QAChE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACf,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,0BAA0B,CAAC,OAA4B;IACrE,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,IAAI,CAAC;QACH,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,OAAO,CAAC,EAAE,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;IACpF,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,UAAU,CAAC;QAAE,OAAO,GAAG,OAAO,CAAC,EAAE,yCAAyC,CAAC;IACtH,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,EAAE,qCAAqC,CAAC;AACjI,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAc,EACd,GAA2B,EAC3B,aAA6C;IAE7C,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,0BAA0B,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;IAC5H,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IACvC,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,OAAO,IAAI,MAAM;QAAE,YAAY,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;IACzE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG;QACX,kFAAkF;QAClF,+CAA+C;QAC/C,sCAAsC;QACtC,wDAAwD;KACzD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC/C,IAAI,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC1E,wEAAwE;IACxE,uEAAuE;IACvE,iCAAiC;IACjC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,uEAAuE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClG,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAC7E,MAAM,EAAE,GAAG,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC;IACjC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,KAAK,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;AACvG,CAAC;AAED,oEAAoE;AACpE,SAAS,MAAM,CAAC,QAA6C;IAC3D,OAAO,QAAQ,YAAY,gBAAgB,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC;AACjF,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,iBAAiB,CAAC,IAAgB;IAChD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC/B,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,EAAE,CAAC,eAAe,CAAC,CAAC;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACzD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,+BAA+B,CAC7C,IAAgB,EAChB,KAAc,EACd,IAA6B,EAC7B,gBAAgD,EAAE;IAElD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC/B,MAAM,QAAQ,GAA8C,EAAE,CAAC;IAC/D,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACnE,IAAI,KAAK,KAAK,SAAS;YAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC;IACxD,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1D,MAAM,OAAO,GAAG,IAAI,EAAE,WAAW,CAAC,KAAK,KAAK,IAAI,CAAC;IACjD,2EAA2E;IAC3E,gEAAgE;IAChE,0EAA0E;IAC1E,uEAAuE;IACvE,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB,KAAK,SAAS,IAAI,IAAI,CAAC,kBAAkB,KAAK,SAAS,CAAC;IACjG,MAAM,OAAO,GACX,CAAC,IAAI,CAAC,kBAAkB,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,EAAE;QAC3C,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC1C,0EAA0E;IAC1E,yEAAyE;IACzE,MAAM,kBAAkB,GAAG,aAAa,CAAC,IAAI,CAC3C,CAAC,OAAO,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,SAAS,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC,IAAI,0BAA0B,CAAC,OAAO,CAAC,KAAK,IAAI,CAC3I,CAAC;IACF,OAAO;QACL,QAAQ,EAAE,QAAQ,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAClF,eAAe,EAAE,CAAC,QAAQ,EAAE,UAAU,IAAI,CAAC,CAAC,GAAG,2BAA2B;QAC1E,YAAY,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC;QAC1F,SAAS;QACT,OAAO;QACP,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC,KAAK,IAAI;QAC3C,qEAAqE;QACrE,uEAAuE;QACvE,SAAS,EAAE,OAAO,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI;QAC9C,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK;QAChE,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;uCAEuC;AACvC,MAAM,UAAU,yBAAyB,CAAC,IAAgB;IACxD,IAAI,IAAI,CAAC,UAAU,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1D,IAAI,IAAI,EAAE,WAAW,CAAC,KAAK,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC/E,OAAO,IAAI,CAAC;AACd,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,wBAAwB,CACtC,GAA2B,EAC3B,gBAAgD,EAAE;IAElD,wEAAwE;IACxE,MAAM,OAAO,GAA2C;QACtD,mBAAmB,EAAE,CAAC;QACtB,iBAAiB,EAAE,CAAC;QACpB,eAAe,EAAE,CAAC;KACnB,CAAC;IACF,IAAI,GAAG,CAAC,SAAS;QAAE,OAAO,CAAC,mBAAmB,GAAG,CAAC,CAAC;IACnD,IAAI,GAAG,CAAC,QAAQ,GAAG,CAAC;QAAE,OAAO,CAAC,iBAAiB,GAAG,CAAC,CAAC;IACpD,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS;QAAE,OAAO,CAAC,eAAe,GAAG,CAAC,CAAC;IAChE,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;QACpC,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,8EAA8E;AAC9E,oCAAoC;AACpC,8EAA8E;AAE9E;;;;GAIG;AACH,MAAM,aAAa,GAAG,IAAI,OAAO,EAAkD,CAAC;AAEpF,SAAS,UAAU,CAAC,OAAsB,EAAE,GAA2B,EAAE,QAAwC;IAC/G,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrE,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,IAAI,qBAAqB,CAAC,GAAG,CAAC,IAAI,KAAK,EAAE,CAAC;AAC3E,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,iBAAiB,CAC/B,MAAoB,EACpB,OAAsB,EACtB,GAA2B,EAC3B,WAA2C,EAAE;IAE7C,IAAI,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACvC,CAAC;IACD,MAAM,EAAE,GAAG,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC9C,IAAI,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,uBAAuB,EAAE,EAAE,OAAO,EAAE,wBAAwB,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QACpH,OAAO,GAAG,MAAM,CAAC,mBAAmB,CAAC;YACnC,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,wBAAwB,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,QAAQ,CAAC;YAC9D,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClF,CAAC,CAAC;QACH,SAAS,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,MAAoB,EACpB,OAAsB,EACtB,QAAwG;IAExG,MAAM,OAAO,GAAoB,EAAE,CAAC;IACpC,IAAI,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,aAAa,CAAC,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACvC,CAAC;IACD,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,QAAQ,EAAE,CAAC;QACrC,MAAM,QAAQ,GAAG,GAAG,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACpH,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ;YAAE,SAAS;QAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,uBAAuB,EAAE,EAAE,OAAO,EAAE,wBAAwB,CAAC,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QACpI,MAAM,OAAO,GAAG;YACd,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,MAAM,EAAE,wBAAwB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC;YAC9E,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnD,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAClF,CAAC;QACF,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;gBACzD,SAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACpC,CAAC,CAAC,CAAC,CAAC;QACN,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IACD,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC"}

package/dist/shadows/Prd02ReceiveShadowContributor.d.ts

@@ -0,0 +1,20 @@
+/**
+ * PRD-02 §6.4 / item 1923: lane-fixture `collect` contributor that stamps
+ * `receiveShadow` on selected `RenderItem`s so the flag-path
+ * `u_shadowMapEnabled = 0` binding (`forward/Lighting.ts`,
+ * `receiveShadowDisabled`) can be exercised before Q-15-5
+ * (`compiler/primitives.ts` → `node.receiveShadow`) and Q-04-2
+ * (`TypedGLBActor` items) land.
+ *
+ * Fixture-only helper — the lane scene registers it explicitly; production
+ * items get `receiveShadow` from the compiler/actor seams above.
+ */
+import type { FrameContributor } from "../contracts/frameGraph.js";
+import type { RenderItem } from "../contracts/renderItem.js";
+export interface Prd02ReceiveShadowOverrideOptions {
+    /** Items matching get `receiveShadow` set to `value` (default false). */
+    readonly predicate: (item: RenderItem, index: number) => boolean;
+    readonly value?: boolean;
+}
+export declare function createPrd02ReceiveShadowContributor(options: Prd02ReceiveShadowOverrideOptions): FrameContributor;
+//# sourceMappingURL=Prd02ReceiveShadowContributor.d.ts.map

package/dist/shadows/Prd02ReceiveShadowContributor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Prd02ReceiveShadowContributor.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/shadows/Prd02ReceiveShadowContributor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAA2B,MAAM,yBAAyB,CAAC;AACzF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,MAAM,WAAW,iCAAiC;IAChD,yEAAyE;IACzE,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,mCAAmC,CACjD,OAAO,EAAE,iCAAiC,GACzC,gBAAgB,CAiBlB"}

package/dist/shadows/Prd02ReceiveShadowContributor.js

@@ -0,0 +1,20 @@
+export function createPrd02ReceiveShadowContributor(options) {
+    const value = options.value ?? false;
+    return {
+        id: "prd02.receiveShadowFixture",
+        owner: "prd02",
+        flag: "A3D_QR_LIGHTING",
+        phases: ["collect"],
+        collect(items, _ctx) {
+            let changed = false;
+            const next = items.map((item, index) => {
+                if (!options.predicate(item, index) || item.receiveShadow === value)
+                    return item;
+                changed = true;
+                return { ...item, receiveShadow: value };
+            });
+            return changed ? next : items;
+        }
+    };
+}
+//# sourceMappingURL=Prd02ReceiveShadowContributor.js.map

package/dist/shadows/Prd02ReceiveShadowContributor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Prd02ReceiveShadowContributor.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/shadows/Prd02ReceiveShadowContributor.ts"],"names":[],"mappings":"AAoBA,MAAM,UAAU,mCAAmC,CACjD,OAA0C;IAE1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC;IACrC,OAAO;QACL,EAAE,EAAE,4BAA4B;QAChC,KAAK,EAAE,OAAO;QACd,IAAI,EAAE,iBAAiB;QACvB,MAAM,EAAE,CAAC,SAAS,CAAC;QACnB,OAAO,CAAC,KAAmB,EAAE,IAA6B;YACxD,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;gBACrC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,aAAa,KAAK,KAAK;oBAAE,OAAO,IAAI,CAAC;gBACjF,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,EAAE,GAAG,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;YAC3C,CAAC,CAAC,CAAC;YACH,OAAO,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;QAChC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/shadows/Prd02ShadowBridge.d.ts

@@ -0,0 +1,111 @@
+/**
+ * T0-26 — real consumer for the PRD-02 shadow system (flag A3D_QR_LIGHTING).
+ *
+ * The `a3d_prd02_shadow_lookup` chunk has no forward program yet (it arrives
+ * with the C-02 generator path), so binding `u_prd02*` uniforms alone produced
+ * no visible shadow while the flag path also disabled the legacy shadow map.
+ * Until then this bridge renders the prd02 sun cascades (stable-fit CSM from
+ * `Prd02ShadowSystem`) and hands them to the legacy forward shader as
+ * `ForwardShadowMapOptions` (`u_shadowMapTexture` + per-cascade light
+ * matrices). Cascades are allocated only when a forward consumer exists:
+ *   - a material declaring the lookup chunk (`u_prd02CascadeCompare0`) → the
+ *     `prd02.shadows` contributor renders and binds (no bridge);
+ *   - otherwise shadow-receiving forward items → the bridge renders here.
+ *
+ * Inputs come from the compiled RenderSource: `source.shadow.prd02Shadows`
+ * (compiler/shadows.ts) for the config and `source.collectedLights` for the
+ * sun, falling back to the scene graph only when the source carries neither.
+ * Flag off never reaches this module (ShadowOrchestration legacy path).
+ */
+import type { Camera } from "@aura3d/scene";
+import type { ForwardShadowMapOptions } from "../ForwardPass.js";
+import type { RenderDevice } from "../RenderDevice.js";
+import type { QrFlags } from "../contracts/core.js";
+import type { AuraQualityTierSettings } from "../contracts/quality.js";
+import type { RenderItem } from "../contracts/renderItem.js";
+import type { RenderSource } from "../contracts/renderSource.js";
+import { Prd02ShadowSystem, type Prd02ShadowFrameUniforms, type ShadowSystemConfigInput } from "./ShadowSystem.js";
+/** Uniform the `a3d_prd02_shadow_lookup` chunk declares (C-11); marks a lookup consumer. */
+export declare const PRD02_SHADOW_LOOKUP_UNIFORM = "u_prd02CascadeCompare0";
+type SourceLike = RenderSource | Iterable<RenderItem> | unknown;
+/**
+ * PRD-02 §6.4 config: the compiler's `prd02Shadows` when present (T0-26),
+ * else the legacy RendererShadowOptions mapped onto the tier defaults.
+ */
+export declare function prd02ShadowConfig(source: SourceLike, flags: QrFlags, tier: AuraQualityTierSettings, cameraFar: number | undefined): ShadowSystemConfigInput;
+/** Normalized direction of the first visible shadow-casting sun. */
+export declare function prd02SunDirection(source: SourceLike): readonly [number, number, number] | null;
+/** True when a forward program samples the prd02 lookup chunk (C-02 generator path). */
+export declare function prd02LookupConsumerExists(items: readonly RenderItem[]): boolean;
+export declare function shadowSystemForDevice(device: RenderDevice, config: ShadowSystemConfigInput): Prd02ShadowSystem;
+/** A frame the bridge already rendered; the contributor publishes it instead of re-rendering. */
+export interface Prd02BridgedShadowFrame {
+    readonly uniforms: Prd02ShadowFrameUniforms;
+    readonly config: ShadowSystemConfigInput;
+    readonly system: Prd02ShadowSystem;
+}
+/** The device the bridge last ran on (lane-page GPU evidence probes). */
+export declare function prd02LastBridgeDevice(): RenderDevice | null;
+/** Last bridge outcome for `device` (default: the last bridged device): "rendered", a bail-out reason, or "never-ran". */
+export declare function prd02ShadowBridgeReason(device?: RenderDevice | null): string;
+/**
+ * GPU evidence probe for the lane page: cascade depth statistics of the
+ * bridge's shadow system on `device` (empty before the bridge first runs).
+ */
+export declare function prd02ShadowDepthProbe(device?: RenderDevice | null): ReturnType<Prd02ShadowSystem["readCascadeDepthStats"]>;
+/** Consume (and clear) the bridged frame for `device`, if the bridge ran this frame. */
+export declare function takePrd02BridgedShadowFrame(device: RenderDevice): Prd02BridgedShadowFrame | null;
+/**
+ * The renderer hands `executeRendererShadowMap` only a concrete `Camera`;
+ * compiled sources render through a structural CameraLike and frame items
+ * reach the shadow step pre-filtered to casters. The `prd02.shadows`
+ * contributor's collect phase (which runs first, with the C-01 frame context)
+ * records the frame camera and whether ANY frame item — casters or not —
+ * declares the lookup chunk.
+ */
+interface Prd02FrameObservation {
+    readonly camera: {
+        readonly viewProjectionMatrix: Float32Array | readonly number[];
+        readonly near?: number;
+        readonly far?: number;
+    } | null;
+    readonly lookupConsumer: boolean;
+}
+export declare function recordPrd02FrameObservation(device: RenderDevice, observation: Prd02FrameObservation): void;
+export interface Prd02BridgeInput {
+    readonly device: RenderDevice;
+    readonly source: SourceLike;
+    /** Shadow casters (items with `castShadow !== false`). */
+    readonly items: readonly RenderItem[];
+    readonly camera: Camera | undefined;
+    /**
+     * #1141: the renderer's resolved frame camera (VP + eye). Production-runtime
+     * frames render through a structural CameraLike, so `camera` is undefined
+     * and the contributor observation may be absent; without this the bridge
+     * skipped and the flag path rendered no sun shadow map at all.
+     */
+    readonly frameCamera?: Prd02BridgeFrameCamera;
+    readonly flags: QrFlags;
+    readonly tier?: AuraQualityTierSettings;
+}
+/** Structural frame camera handed to the bridge by the renderer (#1141). */
+export interface Prd02BridgeFrameCamera {
+    readonly viewProjectionMatrix: Float32Array | readonly number[];
+    readonly near?: number;
+    readonly far?: number;
+}
+/**
+ * Renderer VP + eye → bridge camera, recovering near/far from the matrix
+ * (the cascade fitter lerps the VP's frustum corners by view distance).
+ */
+export declare function shadowFrameCamera(viewProjection: Float32Array | readonly number[] | undefined, eye: readonly [number, number, number] | undefined): Prd02BridgeFrameCamera | undefined;
+/**
+ * Renders the prd02 sun cascades now and returns them as legacy
+ * `ForwardShadowMapOptions` (T0-26 bridge). Returns undefined — and allocates
+ * nothing — when shadows are off/killed, a lookup-chunk consumer exists (the
+ * contributor owns that path), or there is no sun, caster, camera or depth
+ * texture support.
+ */
+export declare function executePrd02BridgedShadowMap(input: Prd02BridgeInput): ForwardShadowMapOptions | undefined;
+export {};
+//# sourceMappingURL=Prd02ShadowBridge.d.ts.map

package/dist/shadows/Prd02ShadowBridge.d.ts.map

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