@aura3d/rendering 3.0.1 → 4.0.0

package/dist/contracts/testing/ChunkHarness.js

@@ -0,0 +1,68 @@
+/**
+ * ChunkHarness (PR 0a): wraps registered C-02 chunks into a minimal GLSL ES 3.00
+ * vertex+fragment pair so chunks compile in the browser conformance suite and
+ * can be text-checked in unit tests (CONTRACTS.md §C-02 / §3.8).
+ *
+ * Declares both the legacy per-uniform camera symbols and the C-08
+ * AuraFrame/AuraLights uniform blocks so stub chunks compile either way.
+ */
+const PREAMBLE = `#version 300 es
+precision highp float;
+`;
+const LEGACY_DECLS = `
+uniform mat4 u_viewProjection;
+uniform vec3 u_cameraPosition;
+layout(std140) uniform AuraFrame {
+  mat4 u_view; mat4 u_projection; mat4 u_viewProjection_m; mat4 u_prevViewProjection;
+  vec4 u_cameraPositionNear; vec4 u_resolutionFarTime; vec4 u_exposureFlags;
+};
+layout(std140) uniform AuraLights {
+  vec4 u_lightData[8];
+};
+`;
+export function buildChunkHarnessProgram(chunks, entry = {}) {
+    const pars = [];
+    const vertex = [];
+    const fragment = [];
+    const seen = new Set();
+    for (const chunk of chunks) {
+        if (seen.has(chunk.name))
+            continue;
+        seen.add(chunk.name);
+        if (chunk.stage !== "vertex")
+            fragment.push(chunk.glsl);
+        else
+            vertex.push(chunk.glsl);
+    }
+    const vertexBody = [
+        "in vec3 a_position;",
+        "uniform mat4 u_modelViewProjection;",
+        "void main() { gl_Position = u_modelViewProjection * vec4(a_position, 1.0); }"
+    ];
+    const fragmentBody = [
+        "layout(location = 0) out vec4 fragColor;",
+        "void main() { fragColor = vec4(1.0); }"
+    ];
+    const vertexSrc = [
+        PREAMBLE,
+        "in vec3 a_position;",
+        LEGACY_DECLS,
+        ...pars,
+        entry.vertexMain ?? "",
+        ...vertex,
+        `void main() { gl_Position = u_viewProjection * vec4(a_position, 1.0); }`
+    ].join("\n");
+    const fragmentSrc = [
+        PREAMBLE,
+        LEGACY_DECLS,
+        ...pars,
+        entry.fragmentMain ?? "",
+        ...fragment,
+        "layout(location = 0) out vec4 fragColor;",
+        "void main() { fragColor = vec4(1.0); }"
+    ].join("\n");
+    void vertexBody;
+    void fragmentBody;
+    return { vertex: vertexSrc, fragment: fragmentSrc };
+}
+//# sourceMappingURL=ChunkHarness.js.map

package/dist/contracts/testing/ChunkHarness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChunkHarness.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/contracts/testing/ChunkHarness.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,MAAM,QAAQ,GAAG;;CAEhB,CAAC;AAEF,MAAM,YAAY,GAAG;;;;;;;;;;CAUpB,CAAC;AAEF,MAAM,UAAU,wBAAwB,CAAC,MAA8B,EAAE,QAA0E,EAAE;IACnJ,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAS;QACnC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrB,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ;YAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;;YACnD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IACD,MAAM,UAAU,GAAG;QACjB,qBAAqB;QACrB,qCAAqC;QACrC,8EAA8E;KAC/E,CAAC;IACF,MAAM,YAAY,GAAG;QACnB,0CAA0C;QAC1C,wCAAwC;KACzC,CAAC;IACF,MAAM,SAAS,GAAG;QAChB,QAAQ;QACR,qBAAqB;QACrB,YAAY;QACZ,GAAG,IAAI;QACP,KAAK,CAAC,UAAU,IAAI,EAAE;QACtB,GAAG,MAAM;QACT,yEAAyE;KAC1E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,MAAM,WAAW,GAAG;QAClB,QAAQ;QACR,YAAY;QACZ,GAAG,IAAI;QACP,KAAK,CAAC,YAAY,IAAI,EAAE;QACxB,GAAG,QAAQ;QACX,0CAA0C;QAC1C,wCAAwC;KACzC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,KAAK,UAAU,CAAC;IAChB,KAAK,YAAY,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACtD,CAAC"}

package/dist/contracts/textureFormats.d.ts

@@ -0,0 +1,18 @@
+/**
+ * C-16 — compressed texture formats (rendering side, CONTRACTS.md). Provider: PRD 05.
+ * Flag: A3D_QR_ASSETS.
+ *
+ * TextureCompressedFormat (Texture.ts:1) gains "bc7-rgba-unorm" | "etc2-rgb8unorm"
+ * in PR 0a; every exhaustive switch gets a throwing default for the new members.
+ */
+import type { TextureCompressedFormat } from "../Texture.js";
+import { type ContractSlot } from "./core.js";
+export interface CompressedTextureCapabilities {
+    readonly astc: boolean;
+    readonly bptc: boolean;
+    readonly etc2: boolean;
+    readonly s3tc: boolean;
+    readonly s3tcSrgb: boolean;
+}
+export declare function resolveCompressedTextureFormatSlot(): ContractSlot<(format: TextureCompressedFormat, colorSpace: "srgb" | "linear", gl: WebGL2RenderingContext) => number | null>;
+//# sourceMappingURL=textureFormats.d.ts.map

package/dist/contracts/textureFormats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textureFormats.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/textureFormats.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AAE/D,MAAM,WAAW,6BAA6B;IAAG,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAAE;AAK9K,wBAAgB,kCAAkC,IAAI,YAAY,CAAC,CAAC,MAAM,EAAE,uBAAuB,EAAE,UAAU,EAAE,MAAM,GAAG,QAAQ,EAAE,EAAE,EAAE,sBAAsB,KAAK,MAAM,GAAG,IAAI,CAAC,CAEhL"}

package/dist/contracts/textureFormats.js

@@ -0,0 +1,13 @@
+/**
+ * C-16 — compressed texture formats (rendering side, CONTRACTS.md). Provider: PRD 05.
+ * Flag: A3D_QR_ASSETS.
+ *
+ * TextureCompressedFormat (Texture.ts:1) gains "bc7-rgba-unorm" | "etc2-rgb8unorm"
+ * in PR 0a; every exhaustive switch gets a throwing default for the new members.
+ */
+import { defineContractSlot } from "./core.js";
+const compressedTextureFormatSlot = defineContractSlot("C-16", "prd05", "A3D_QR_ASSETS", () => null);
+export function resolveCompressedTextureFormatSlot() {
+    return compressedTextureFormatSlot;
+}
+//# sourceMappingURL=textureFormats.js.map

package/dist/contracts/textureFormats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textureFormats.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/textureFormats.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,kBAAkB,EAAqB,MAAM,QAAQ,CAAC;AAI/D,MAAM,2BAA2B,GAC/B,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;AAEnE,MAAM,UAAU,kCAAkC;IAChD,OAAO,2BAA2B,CAAC;AACrC,CAAC"}

package/dist/contracts/velocity.d.ts

@@ -0,0 +1,37 @@
+/**
+ * C-14 — velocity target and temporal history reset (CONTRACTS.md). Provider: PRD 03.
+ * Flag: A3D_QR_POST. RenderItem gains previous-frame optional fields in PR 0a.
+ */
+export declare const VELOCITY_MRT: {
+    readonly velocityLocation: 1;
+    readonly velocityFormat: "rg16f";
+    readonly reactiveLocation: 2;
+    readonly reactiveFormat: "r8";
+    readonly define: "AURA_VELOCITY";
+};
+import type { RenderTarget } from "../RenderDevice.js";
+export interface TemporalCameraMatrices {
+    /** Jittered clip-space view-projection for the current frame (raster VP). */
+    readonly jittered: Float32Array;
+    /** Physical (unjittered) clip-space view-projection — velocity reprojection input. */
+    readonly unjittered: Float32Array;
+    /** Previous frame's jittered clip-space view-projection. */
+    readonly previous: Float32Array;
+    /** Linear-Z source written by the forward depth pass this frame. */
+    readonly linZ?: RenderTarget;
+    /** Linear-Z ping-pong partner — last frame's Z after commit. */
+    readonly linZOutput?: RenderTarget;
+    /** Jitter in full-pixel units (u_jitterClip = jitter / {w, h}). */
+    readonly jitterClip?: readonly [number, number];
+    /** §8.8: measured frame delta in seconds; scales the S7 shutter (C-23). */
+    readonly frameTime?: number;
+}
+export interface TemporalHistoryLike {
+    prepare(viewProjection: Float32Array, jitter: readonly [number, number]): TemporalCameraMatrices;
+    reset(reason: "camera-cut" | "resize" | "tier-change" | "scene-swap"): void;
+}
+/** Registered by the renderer seam (PR 0b, TemporalHistory wiring). */
+export declare function setTemporalHistoryImpl(history: TemporalHistoryLike | null): void;
+/** PR 0a stub: calls the registered TemporalHistoryLike.reset() (Renderer.ts). */
+export declare function resetTemporalHistory(reason: "camera-cut" | "resize" | "tier-change" | "scene-swap"): void;
+//# sourceMappingURL=velocity.d.ts.map

package/dist/contracts/velocity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"velocity.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/velocity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,eAAO,MAAM,YAAY,EAAE;IAAE,QAAQ,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAAC,QAAQ,CAAC,cAAc,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAA;CACpE,CAAC;AAEvH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,sFAAsF;IACtF,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;IAClC,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,oEAAoE;IACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,gEAAgE;IAChE,QAAQ,CAAC,UAAU,CAAC,EAAE,YAAY,CAAC;IACnC,mEAAmE;IACnE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAAG,OAAO,CAAC,cAAc,EAAE,YAAY,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,sBAAsB,CAAC;IAAC,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,GAAG,aAAa,GAAG,YAAY,GAAG,IAAI,CAAC;CAAE;AAIvN,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,GAAG,IAAI,CAEhF;AAED,kFAAkF;AAClF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,GAAG,aAAa,GAAG,YAAY,GAAG,IAAI,CAEzG"}

package/dist/contracts/velocity.js

@@ -0,0 +1,22 @@
+/**
+ * C-14 — velocity target and temporal history reset (CONTRACTS.md). Provider: PRD 03.
+ * Flag: A3D_QR_POST. RenderItem gains previous-frame optional fields in PR 0a.
+ */
+// RenderItem additions (PR 0a, all optional, all inert until A3D_QR_POST):
+//   readonly previousModelMatrix?: Float32Array;
+//   readonly previousInstanceTransforms?: Float32Array;
+//   readonly previousJointTexture?: import("../Texture.js").Texture;     // C-18 palette.previous
+//   readonly previousMorphWeights?: Float32Array;
+//   readonly writesReactive?: boolean;                                // particles/transparents (C-07-IN-8)
+export const VELOCITY_MRT = { velocityLocation: 1, velocityFormat: "rg16f", reactiveLocation: 2, reactiveFormat: "r8", define: "AURA_VELOCITY" };
+let temporalHistoryImpl = null;
+/** Registered by the renderer seam (PR 0b, TemporalHistory wiring). */
+export function setTemporalHistoryImpl(history) {
+    temporalHistoryImpl = history;
+}
+/** PR 0a stub: calls the registered TemporalHistoryLike.reset() (Renderer.ts). */
+export function resetTemporalHistory(reason) {
+    temporalHistoryImpl?.reset(reason);
+}
+// AuraApp.cutCamera(): void  (via C-38; PRD 08's app.camera.cut() calls it)
+//# sourceMappingURL=velocity.js.map

package/dist/contracts/velocity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"velocity.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/contracts/velocity.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,2EAA2E;AAC3E,iDAAiD;AACjD,wDAAwD;AACxD,+FAA+F;AAC/F,kDAAkD;AAClD,4GAA4G;AAC5G,MAAM,CAAC,MAAM,YAAY,GACvB,EAAE,gBAAgB,EAAE,CAAC,EAAE,cAAc,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;AAuBvH,IAAI,mBAAmB,GAA+B,IAAI,CAAC;AAE3D,uEAAuE;AACvE,MAAM,UAAU,sBAAsB,CAAC,OAAmC;IACxE,mBAAmB,GAAG,OAAO,CAAC;AAChC,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,oBAAoB,CAAC,MAA8D;IACjG,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AACD,4EAA4E"}

package/dist/environment/EnvUniforms.d.ts

@@ -0,0 +1,42 @@
+/**
+ * A3DEnvironment uniform packer (PRD-02 §6.10/§8.1): produces the loose
+ * uniform set the `a3d_prd02_lighting_ibl` chunk samples — specular cube,
+ * mip count, rotation, intensities, folded `u_envSH[7]`, ambient irradiance
+ * (×1/π exit radiance) and the hemisphere pair.
+ *
+ * `u_envSH` carries the probe's radiance sh9 with the Ramamoorthi–Hanrahan
+ * cosine-lobe constants folded at upload (`convolveSH9Irradiance`), packed
+ * into 7 vec4s (28 slots; last lane unused).
+ */
+import type { UniformValue } from "../RenderDevice.js";
+import type { EnvironmentProbe } from "../contracts/environment.js";
+export interface A3DEnvironmentUniformInput {
+    /**
+     * Bound probe; null → env terms zeroed, ambient/hemisphere still bound.
+     * Only the cube/mip/SH fields are read, so a bare cube binding can be
+     * packed without fabricating a full `EnvironmentProbe` (E3 stage-2b).
+     */
+    readonly probe: Pick<EnvironmentProbe, "specularCube" | "mipCount" | "sh9"> | null;
+    readonly ambient?: {
+        readonly color: readonly [number, number, number];
+        readonly intensity: number;
+    };
+    readonly hemisphere?: {
+        readonly sky: readonly [number, number, number];
+        readonly ground: readonly [number, number, number];
+        readonly intensity: number;
+        readonly direction?: readonly [number, number, number];
+    };
+    readonly rotation?: number;
+    readonly diffuseIntensity?: number;
+    readonly specularIntensity?: number;
+}
+export interface A3DEnvironmentUniforms {
+    readonly uniforms: ReadonlyMap<string, UniformValue>;
+    /** 1 when a real SH array was uploaded (C-28 `shBound` fact). */
+    readonly shBound: 0 | 1;
+}
+/** Pack folded irradiance SH9 (27 floats) into u_envSH[7] (28 slots). */
+export declare function packEnvSH(sh9: Float32Array): Float32Array;
+export declare function packA3DEnvironmentUniforms(input: A3DEnvironmentUniformInput): A3DEnvironmentUniforms;
+//# sourceMappingURL=EnvUniforms.d.ts.map

package/dist/environment/EnvUniforms.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvUniforms.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/environment/EnvUniforms.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAYpE,MAAM,WAAW,0BAA0B;IACzC;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,cAAc,GAAG,UAAU,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC;IACnF,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IACrG,QAAQ,CAAC,UAAU,CAAC,EAAE;QACpB,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAChD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;KACxD,CAAC;IACF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACrD,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;CACzB;AAED,yEAAyE;AACzE,wBAAgB,SAAS,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAKzD;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,0BAA0B,GAAG,sBAAsB,CAwBpG"}

package/dist/environment/EnvUniforms.js

@@ -0,0 +1,54 @@
+/**
+ * A3DEnvironment uniform packer (PRD-02 §6.10/§8.1): produces the loose
+ * uniform set the `a3d_prd02_lighting_ibl` chunk samples — specular cube,
+ * mip count, rotation, intensities, folded `u_envSH[7]`, ambient irradiance
+ * (×1/π exit radiance) and the hemisphere pair.
+ *
+ * `u_envSH` carries the probe's radiance sh9 with the Ramamoorthi–Hanrahan
+ * cosine-lobe constants folded at upload (`convolveSH9Irradiance`), packed
+ * into 7 vec4s (28 slots; last lane unused).
+ */
+import { Sampler } from "../Sampler.js";
+import { TextureBinding } from "../TextureBinding.js";
+import { convolveSH9Irradiance } from "./SphericalHarmonics.js";
+import { ambientToExitRadiance } from "../LightUniforms.js";
+/** Specular cube sampler: mip-mapped linear (PRD §8.1 u_envSpecular). */
+const ENV_SPECULAR_SAMPLER = new Sampler({
+    minFilter: "linear-mipmap-linear",
+    magFilter: "linear",
+    addressU: "clamp-to-edge",
+    addressV: "clamp-to-edge"
+});
+/** Pack folded irradiance SH9 (27 floats) into u_envSH[7] (28 slots). */
+export function packEnvSH(sh9) {
+    const folded = convolveSH9Irradiance(sh9);
+    const out = new Float32Array(28);
+    out.set(folded.subarray(0, 27));
+    return out;
+}
+export function packA3DEnvironmentUniforms(input) {
+    const uniforms = new Map();
+    const probe = input.probe;
+    uniforms.set("u_envSpecular", new TextureBinding({
+        name: "u_envSpecular",
+        texture: probe?.specularCube ?? undefined,
+        required: false,
+        sampler: ENV_SPECULAR_SAMPLER
+    }));
+    uniforms.set("u_envMipCount", probe?.mipCount ?? 1);
+    uniforms.set("u_envRotation", input.rotation ?? 0);
+    uniforms.set("u_envDiffuseIntensity", input.diffuseIntensity ?? 1);
+    uniforms.set("u_envSpecularIntensity", input.specularIntensity ?? 1);
+    const shBound = probe !== null && probe.sh9.length === 27 ? 1 : 0;
+    uniforms.set("u_envSH", probe !== null && probe.sh9.length === 27 ? packEnvSH(probe.sh9) : new Float32Array(28));
+    const ambient = input.ambient;
+    uniforms.set("u_ambientIrradiance", ambient ? ambientToExitRadiance(ambient.color, ambient.intensity) : [0, 0, 0]);
+    const hemi = input.hemisphere;
+    // §8.1: u_hemiSky/u_hemiGround are "pre-multiplied by intensity" (no /π).
+    const hemiScale = Math.max(0, hemi?.intensity ?? 0);
+    uniforms.set("u_hemiSky", hemi ? [hemi.sky[0] * hemiScale, hemi.sky[1] * hemiScale, hemi.sky[2] * hemiScale] : [0, 0, 0]);
+    uniforms.set("u_hemiGround", hemi ? [hemi.ground[0] * hemiScale, hemi.ground[1] * hemiScale, hemi.ground[2] * hemiScale] : [0, 0, 0]);
+    uniforms.set("u_hemiDirection", hemi?.direction ?? [0, 1, 0]);
+    return { uniforms, shBound };
+}
+//# sourceMappingURL=EnvUniforms.js.map

package/dist/environment/EnvUniforms.js.map

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

package/dist/environment/EnvironmentCache.d.ts

@@ -0,0 +1,83 @@
+/**
+ * EnvironmentCache (PRD-02 §6.2/§8.7): keyed by `(url|preset, tier)`,
+ * ref-counted. Probes released to 0 references stay resident for reuse until
+ * the LRU limit forces eviction (`dispose()` then runs).
+ *
+ * Resident limits (PRD §2216 / test contract): 3 normally; **2 on Medium when
+ * any resident probe is RGBA16F** (the default storage format — so Medium is
+ * effectively 2) and **always 2 on Ultra**. Neutral probes bypass the limit:
+ * they are the fallback floor and are never evicted.
+ *
+ * `acquire` is async (fetch + decode + prefilter). While it resolves, the
+ * caller keeps the previous probe bound (PRD §4: never a black frame).
+ */
+import type { RenderDevice } from "../RenderDevice.js";
+import { type EnvironmentProbe, type EnvironmentProbeFactory } from "../contracts/environment.js";
+import { type AuraQualityTier } from "../contracts/quality.js";
+export interface EnvironmentCacheKey {
+    readonly url?: string;
+    readonly preset?: string;
+    readonly tier: AuraQualityTier;
+}
+/** What the cache needs to produce a probe for a key. Injected per call site. */
+export type EnvironmentProbeLoader = (key: EnvironmentCacheKey) => Promise<EnvironmentProbe>;
+/** Resident limit per PRD: Ultra → 2; Medium → 2 when an RGBA16F probe is resident; else 3. */
+export declare function environmentCacheLimit(tier: AuraQualityTier, hasRgba16fResident: boolean): number;
+export declare class EnvironmentCache {
+    private readonly device;
+    private readonly factory;
+    private readonly loader?;
+    private readonly entries;
+    private readonly neutralEntries;
+    private readonly inFlight;
+    private clock;
+    constructor(device: RenderDevice, factory: EnvironmentProbeFactory, loader?: EnvironmentProbeLoader | undefined);
+    /**
+     * Acquire a probe. The loader defaults to `loadEnvironmentProbeKey` — preset
+     * names resolve to baked `aura-environments/<name>` manifests, `url` fetches
+     * an equirect HDR.
+     */
+    acquire(key: EnvironmentCacheKey, loader?: EnvironmentProbeLoader): Promise<EnvironmentProbe>;
+    /**
+     * Synchronous neutral floor (T0-25): an analytic constant probe matching the
+     * baked `neutral` preset's diffuse DC — never runs the CPU GGX prefilter on
+     * the main thread. Specular detail arrives via `acquire({preset:"neutral"})`.
+     */
+    neutral(tier: AuraQualityTier): EnvironmentProbe;
+    /** Decrement a probe's refcount; at 0 it becomes an eviction candidate. */
+    release(probe: EnvironmentProbe): void;
+    refCount(probe: EnvironmentProbe): number;
+    get residentCount(): number;
+    /** Evict oldest zero-ref entries until within the tier limit. */
+    private evictOverLimit;
+    dispose(): void;
+}
+export interface BakedEnvironmentManifest {
+    readonly name: string;
+    readonly faceSize: number;
+    readonly mipCount: number;
+    readonly specular: string;
+    readonly sh9: string;
+}
+/**
+ * Default key → probe loader. `preset` reads the day-0 baked bundles under
+ * `aura-environments/<name>/` (manifest + RGB9E5 specular cube + baked SH9 —
+ * already prefiltered, uploaded as RGBA16F until Q-06-1 native RGB9_E5 lands);
+ * `url` fetches an equirect .hdr and runs `factory.fromEquirect`.
+ *
+ * `factory` may be a getter, resolved when a load runs rather than when the
+ * loader is built, so a C-09 provider that registers after the scene compiles
+ * is still used. While the factory is the pending stub, an HDRI load rejects
+ * with `ENVIRONMENT_PROBE_PENDING:fromEquirect` before fetching anything; the
+ * caller keeps the neutral floor bound (see `bindPrd02EnvironmentProbe`).
+ */
+/**
+ * Face size for an HDRI probe: three r185's PMREM sizing (cube = equirect
+ * width / 4, so 256 for a 1k HDRI), capped by the tier's environment size and
+ * by 256 while the GGX prefilter is CPU-only on the main thread. A 1024 face
+ * at Ultra took seconds and delayed the first draw of HDRI scenes
+ * (lighting+compiler games: ~3 s → 8-9 s, run 38182457655).
+ */
+export declare function hdriProbeFaceSize(equirectWidth: number, tier: AuraQualityTier): EnvironmentProbe["faceSize"];
+export declare function defaultProbeLoader(factory: EnvironmentProbeFactory | (() => EnvironmentProbeFactory)): EnvironmentProbeLoader;
+//# sourceMappingURL=EnvironmentCache.d.ts.map

package/dist/environment/EnvironmentCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnvironmentCache.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/environment/EnvironmentCache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAoC,KAAK,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACpI,OAAO,EAAiB,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAK9E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;CAChC;AAED,iFAAiF;AACjF,MAAM,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,mBAAmB,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAgB7F,+FAA+F;AAC/F,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,eAAe,EAAE,kBAAkB,EAAE,OAAO,GAAG,MAAM,CAIhG;AAED,qBAAa,gBAAgB;IAOzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAR1B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA0C;IACzE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgD;IACzE,OAAO,CAAC,KAAK,CAAK;gBAGC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,uBAAuB,EAChC,MAAM,CAAC,EAAE,sBAAsB,YAAA;IAGlD;;;;OAIG;IACG,OAAO,CAAC,GAAG,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAwBnG;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,gBAAgB;IAWhD,2EAA2E;IAC3E,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAStC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM;IAOzC,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,iEAAiE;IACjE,OAAO,CAAC,cAAc;IAetB,OAAO,IAAI,IAAI;CAOhB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAYD;;;;;;;;;;;GAWG;AACH;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAG5G;AASD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,uBAAuB,GAAG,CAAC,MAAM,uBAAuB,CAAC,GAAG,sBAAsB,CAgC7H"}

package/dist/environment/EnvironmentCache.js

@@ -0,0 +1,205 @@
+/**
+ * EnvironmentCache (PRD-02 §6.2/§8.7): keyed by `(url|preset, tier)`,
+ * ref-counted. Probes released to 0 references stay resident for reuse until
+ * the LRU limit forces eviction (`dispose()` then runs).
+ *
+ * Resident limits (PRD §2216 / test contract): 3 normally; **2 on Medium when
+ * any resident probe is RGBA16F** (the default storage format — so Medium is
+ * effectively 2) and **always 2 on Ultra**. Neutral probes bypass the limit:
+ * they are the fallback floor and are never evicted.
+ *
+ * `acquire` is async (fetch + decode + prefilter). While it resolves, the
+ * caller keeps the previous probe bound (PRD §4: never a black frame).
+ */
+import { Texture } from "../Texture.js";
+import { isEnvironmentProbeFactoryPending } from "../contracts/environment.js";
+import { QUALITY_TIERS } from "../contracts/quality.js";
+import { decodeHdrEquirect, hdrImageToRgba32f } from "./HdrEquirect.js";
+import { readRgb9e5Cube } from "./Rgb9e5Cube.js";
+import { buildNeutralFloorProbe, buildProbeFromLevels } from "./probeBuild.js";
+const NEUTRAL_TAG = "__neutral__";
+function keyId(key) {
+    return `${key.url ?? `preset:${key.preset ?? NEUTRAL_TAG}`}@${key.tier}`;
+}
+/** Resident limit per PRD: Ultra → 2; Medium → 2 when an RGBA16F probe is resident; else 3. */
+export function environmentCacheLimit(tier, hasRgba16fResident) {
+    if (tier === "ultra")
+        return 2;
+    if (tier === "medium" && hasRgba16fResident)
+        return 2;
+    return 3;
+}
+export class EnvironmentCache {
+    device;
+    factory;
+    loader;
+    entries = new Map();
+    neutralEntries = new Map();
+    inFlight = new Map();
+    clock = 0;
+    constructor(device, factory, loader) {
+        this.device = device;
+        this.factory = factory;
+        this.loader = loader;
+    }
+    /**
+     * Acquire a probe. The loader defaults to `loadEnvironmentProbeKey` — preset
+     * names resolve to baked `aura-environments/<name>` manifests, `url` fetches
+     * an equirect HDR.
+     */
+    async acquire(key, loader) {
+        const id = keyId(key);
+        const live = this.entries.get(id);
+        if (live) {
+            live.refs += 1;
+            live.touched = ++this.clock;
+            return live.probe;
+        }
+        let promise = this.inFlight.get(id);
+        if (!promise) {
+            const load = loader ?? this.loader ?? defaultProbeLoader(this.factory);
+            promise = load(key).then((probe) => {
+                this.entries.set(id, { key: id, probe, refs: 1, touched: ++this.clock });
+                this.inFlight.delete(id);
+                this.evictOverLimit(key.tier);
+                return probe;
+            });
+            this.inFlight.set(id, promise);
+            // Avoid unhandled rejection on racing callers: a failed load removes itself.
+            promise.catch(() => this.inFlight.delete(id));
+        }
+        return promise;
+    }
+    /**
+     * Synchronous neutral floor (T0-25): an analytic constant probe matching the
+     * baked `neutral` preset's diffuse DC — never runs the CPU GGX prefilter on
+     * the main thread. Specular detail arrives via `acquire({preset:"neutral"})`.
+     */
+    neutral(tier) {
+        const existing = this.neutralEntries.get(tier);
+        if (existing) {
+            existing.refs += 1;
+            return existing.probe;
+        }
+        const probe = buildNeutralFloorProbe(QUALITY_TIERS[tier].environmentSize);
+        this.neutralEntries.set(tier, { key: NEUTRAL_TAG, probe, refs: 1, touched: ++this.clock });
+        return probe;
+    }
+    /** Decrement a probe's refcount; at 0 it becomes an eviction candidate. */
+    release(probe) {
+        for (const entry of [...this.entries.values(), ...this.neutralEntries.values()]) {
+            if (entry.probe === probe) {
+                entry.refs = Math.max(0, entry.refs - 1);
+                return;
+            }
+        }
+    }
+    refCount(probe) {
+        for (const entry of [...this.entries.values(), ...this.neutralEntries.values()]) {
+            if (entry.probe === probe)
+                return entry.refs;
+        }
+        return 0;
+    }
+    get residentCount() {
+        return this.entries.size;
+    }
+    /** Evict oldest zero-ref entries until within the tier limit. */
+    evictOverLimit(tier) {
+        const hasRgba16f = [...this.entries.values()].some((e) => e.probe.specularCube?.format === "rgba16f");
+        const limit = environmentCacheLimit(tier, hasRgba16f);
+        const evictable = [...this.entries.values()]
+            .filter((e) => e.refs === 0)
+            .sort((a, b) => a.touched - b.touched);
+        while (this.entries.size > limit && evictable.length > 0) {
+            const victim = evictable.shift();
+            this.entries.delete(victim.key);
+            victim.probe.dispose();
+        }
+    }
+    dispose() {
+        for (const e of this.entries.values())
+            e.probe.dispose();
+        for (const e of this.neutralEntries.values())
+            e.probe.dispose();
+        this.entries.clear();
+        this.neutralEntries.clear();
+        this.inFlight.clear();
+    }
+}
+async function fetchBytes(url) {
+    let res = await fetch(url);
+    if (!res.ok && !url.startsWith("/") && !/^https?:\/\//.test(url)) {
+        const rootRes = await fetch(`/${url}`);
+        if (rootRes.ok)
+            res = rootRes;
+    }
+    if (!res.ok)
+        throw new Error(`ENV_FETCH_FAILED:${url}:${res.status}`);
+    return new Uint8Array(await res.arrayBuffer());
+}
+/**
+ * Default key → probe loader. `preset` reads the day-0 baked bundles under
+ * `aura-environments/<name>/` (manifest + RGB9E5 specular cube + baked SH9 —
+ * already prefiltered, uploaded as RGBA16F until Q-06-1 native RGB9_E5 lands);
+ * `url` fetches an equirect .hdr and runs `factory.fromEquirect`.
+ *
+ * `factory` may be a getter, resolved when a load runs rather than when the
+ * loader is built, so a C-09 provider that registers after the scene compiles
+ * is still used. While the factory is the pending stub, an HDRI load rejects
+ * with `ENVIRONMENT_PROBE_PENDING:fromEquirect` before fetching anything; the
+ * caller keeps the neutral floor bound (see `bindPrd02EnvironmentProbe`).
+ */
+/**
+ * Face size for an HDRI probe: three r185's PMREM sizing (cube = equirect
+ * width / 4, so 256 for a 1k HDRI), capped by the tier's environment size and
+ * by 256 while the GGX prefilter is CPU-only on the main thread. A 1024 face
+ * at Ultra took seconds and delayed the first draw of HDRI scenes
+ * (lighting+compiler games: ~3 s → 8-9 s, run 38182457655).
+ */
+export function hdriProbeFaceSize(equirectWidth, tier) {
+    const target = Math.min(equirectWidth / 4, QUALITY_TIERS[tier]?.environmentSize ?? 256, 256);
+    return (target >= 256 ? 256 : 128);
+}
+/** Resolve after two animation frames (immediately where there is no rAF, e.g. Node tests). */
+function afterFirstFrames() {
+    const raf = globalThis.requestAnimationFrame;
+    if (typeof raf !== "function")
+        return Promise.resolve();
+    return new Promise((resolve) => raf(() => raf(() => resolve())));
+}
+export function defaultProbeLoader(factory) {
+    const resolveFactory = () => (typeof factory === "function" ? factory() : factory);
+    return async (key) => {
+        if (key.preset) {
+            const manifestBytes = await fetchBytes(`/aura-environments/${key.preset}.manifest.json`);
+            const manifest = JSON.parse(new TextDecoder().decode(manifestBytes));
+            const [ktx2, sh9Bytes] = await Promise.all([
+                fetchBytes(`/aura-environments/${manifest.specular}`),
+                fetchBytes(`/aura-environments/${manifest.sh9}`)
+            ]);
+            const cube = readRgb9e5Cube(ktx2);
+            const sh9 = new Float32Array(sh9Bytes.buffer.slice(sh9Bytes.byteOffset, sh9Bytes.byteOffset + sh9Bytes.byteLength));
+            const levels = cube.levels.map((faces, i) => ({ faceSize: Math.max(1, cube.faceSize >> i), faces }));
+            return buildProbeFromLevels(levels, manifest.faceSize, {
+                source: "preset",
+                sh9,
+                label: `env-preset-${key.preset}`
+            });
+        }
+        if (key.url) {
+            if (isEnvironmentProbeFactoryPending(resolveFactory()))
+                throw new Error("ENVIRONMENT_PROBE_PENDING:fromEquirect");
+            const bytes = await fetchBytes(key.url);
+            // The decode + CPU GGX prefilter run on the main thread: let the first
+            // frames (drawn with the neutral floor) present before the work starts.
+            await afterFirstFrames();
+            const image = decodeHdrEquirect(bytes);
+            // #1153: decode yields RGB; rgba32f needs 4 floats per texel.
+            const src = new Texture({ width: image.width, height: image.height, format: "rgba32f", data: hdrImageToRgba32f(image), label: `env-src-${key.url}` });
+            return resolveFactory().fromEquirect(src, { faceSize: hdriProbeFaceSize(image.width, key.tier) });
+        }
+        throw new Error("ENVIRONMENT_KEY_EMPTY: acquire() needs url or preset");
+    };
+}
+//# sourceMappingURL=EnvironmentCache.js.map

package/dist/environment/EnvironmentCache.js.map

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