@aura3d/rendering 3.0.1 → 4.0.2

package/dist/environment/RoomEnvironmentScene.d.ts

@@ -0,0 +1,57 @@
+/**
+ * PRD-02 §7.1 — the neutral-room environment scene, ported verbatim from
+ * three.js r185 examples/jsm/environments/RoomEnvironment.js (MIT).
+ * Geometry/emissive values match the r185 file (node_modules/three, pinned
+ * 0.185.1) so the CPU prefilter and the GPU path render the same neutral
+ * studio, including the scene's y = -3.5 offset and the point-lit walls.
+ */
+export interface RoomBox {
+    readonly position: readonly [number, number, number];
+    readonly scale: readonly [number, number, number];
+    readonly rotationY: number;
+    /** Lambertian reflectance: r185 uses default (white) `MeshStandardMaterial`s → 1. */
+    readonly albedo: readonly [number, number, number];
+}
+export interface RoomEmissivePanel {
+    readonly position: readonly [number, number, number];
+    readonly scale: readonly [number, number, number];
+    readonly rotationY: number;
+    readonly emissive: readonly [number, number, number];
+}
+export interface RoomPointLight {
+    readonly color: readonly [number, number, number];
+    readonly intensity: number;
+    readonly distance: number;
+    readonly decay: number;
+    readonly position: readonly [number, number, number];
+}
+export interface RoomEnvironmentSceneDescriptor {
+    readonly room: RoomBox;
+    readonly boxes: readonly RoomBox[];
+    readonly panels: readonly RoomEmissivePanel[];
+    readonly light: RoomPointLight;
+}
+/** r185 `RoomEnvironment` sets `this.position.y = -3.5`: the whole room sits 3.5 below the capture point. */
+export declare const ROOM_ENVIRONMENT_SCENE_OFFSET_Y = -3.5;
+/** Panel emissive intensities, r185 verbatim. */
+export declare const ROOM_ENVIRONMENT_PANEL_RADIANCES: readonly number[];
+export declare function createRoomEnvironmentScene(): RoomEnvironmentSceneDescriptor;
+type V3 = [number, number, number];
+/**
+ * Analytic radiance of the r185 room along `dir`, seen from the PMREM capture
+ * point. three's `RoomEnvironment` shifts the whole scene by y = -3.5
+ * (`this.position.y`), so the capture point sits at y = +3.5 in scene space.
+ *
+ *  - emissive panels (`MeshLambertMaterial`, black colour, white emissive ×
+ *    intensity) → their emissive radiance;
+ *  - room walls (BackSide) and prop boxes are default `MeshStandardMaterial`s
+ *    (white, roughness 1, metalness 0): Lambertian albedo 1 lit only by the
+ *    `PointLight(0xffffff, 900, 28, 2)`, i.e. `(1/π) · 900 · max(0, n·l) ·
+ *    attenuation(d)`. No shadows: PMREM capture renders without shadow maps.
+ *
+ * Deterministic. Used by `environments bake` for the neutral preset, by the
+ * neutral floor constants, and by tests against the pinned three file.
+ */
+export declare function sampleRoomEnvironment(dir: readonly [number, number, number]): V3;
+export {};
+//# sourceMappingURL=RoomEnvironmentScene.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RoomEnvironmentScene.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/environment/RoomEnvironmentScene.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,qFAAqF;IACrF,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACpD;AACD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACtD;AACD,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACtD;AACD,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC9C,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;CAChC;AAED,6GAA6G;AAC7G,eAAO,MAAM,+BAA+B,OAAO,CAAC;AAEpD,iDAAiD;AACjD,eAAO,MAAM,gCAAgC,EAAE,SAAS,MAAM,EAA8B,CAAC;AAE7F,wBAAgB,0BAA0B,IAAI,8BAA8B,CA+B3E;AAID,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAoFnC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,EAAE,CAmChF"}

package/dist/environment/RoomEnvironmentScene.js

@@ -0,0 +1,165 @@
+/** r185 `RoomEnvironment` sets `this.position.y = -3.5`: the whole room sits 3.5 below the capture point. */
+export const ROOM_ENVIRONMENT_SCENE_OFFSET_Y = -3.5;
+/** Panel emissive intensities, r185 verbatim. */
+export const ROOM_ENVIRONMENT_PANEL_RADIANCES = [50, 50, 17, 43, 20, 100];
+export function createRoomEnvironmentScene() {
+    const room = {
+        position: [-0.757, 13.219, 0.717],
+        scale: [31.713, 28.305, 28.591],
+        rotationY: 0,
+        albedo: [1, 1, 1]
+    };
+    const boxes = [
+        { position: [-10.906, 2.009, 1.846], scale: [2.328, 7.905, 4.651], rotationY: -0.195, albedo: [1, 1, 1] },
+        { position: [-5.607, -0.754, -0.758], scale: [1.970, 1.534, 3.955], rotationY: 0.994, albedo: [1, 1, 1] },
+        { position: [6.167, 0.857, 7.803], scale: [3.927, 6.285, 3.687], rotationY: 0.561, albedo: [1, 1, 1] },
+        { position: [-2.017, 0.018, 6.124], scale: [2.002, 4.566, 2.064], rotationY: 0.333, albedo: [1, 1, 1] },
+        { position: [2.291, -0.756, -2.621], scale: [1.546, 1.552, 1.496], rotationY: -0.286, albedo: [1, 1, 1] },
+        { position: [-2.193, -0.369, -5.547], scale: [3.875, 3.487, 2.986], rotationY: 0.516, albedo: [1, 1, 1] }
+    ];
+    const panels = [
+        { position: [-16.116, 14.37, 8.208], scale: [0.1, 2.428, 2.739], rotationY: 0, emissive: [50, 50, 50] }, // -x right
+        { position: [-16.109, 18.021, -8.207], scale: [0.1, 2.425, 2.751], rotationY: 0, emissive: [50, 50, 50] }, // -x left
+        { position: [14.904, 12.198, -1.832], scale: [0.15, 4.265, 6.331], rotationY: 0, emissive: [17, 17, 17] }, // +x
+        { position: [-0.462, 8.89, 14.520], scale: [4.38, 5.441, 0.088], rotationY: 0, emissive: [43, 43, 43] }, // +z
+        { position: [3.235, 11.486, -12.541], scale: [2.5, 2.0, 0.1], rotationY: 0, emissive: [20, 20, 20] }, // -z
+        { position: [0.0, 20.0, 0.0], scale: [1.0, 0.1, 1.0], rotationY: 0, emissive: [100, 100, 100] } // +y
+    ];
+    const light = {
+        color: [1, 1, 1],
+        intensity: 900,
+        distance: 28,
+        decay: 2,
+        position: [0.418, 16.199, 0.300]
+    };
+    return { room, boxes, panels, light };
+}
+const sub = (a, b) => [a[0] - b[0], a[1] - b[1], a[2] - b[2]];
+const add = (a, b) => [a[0] + b[0], a[1] + b[1], a[2] + b[2]];
+const scale = (a, s) => [a[0] * s, a[1] * s, a[2] * s];
+const dot = (a, b) => a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
+/**
+ * World → box-local for a box with three's `rotation.y = angle`. three's
+ * `makeRotationY(a)` maps local → world as x' = c·x + s·z, z' = −s·x + c·z,
+ * so the inverse is x = c·x' − s·z', z = s·x' + c·z'.
+ */
+function rotateYInv(p, angle) {
+    const c = Math.cos(angle);
+    const s = Math.sin(angle);
+    return [p[0] * c - p[2] * s, p[1], p[0] * s + p[2] * c];
+}
+/** Slab test vs an axis-aligned box (in the box's local frame). Returns hit t or -1. */
+function slabHit(origin, dir, half) {
+    let tMin = -Infinity;
+    let tMax = Infinity;
+    for (let i = 0; i < 3; i += 1) {
+        const o = origin[i];
+        const d = dir[i];
+        if (Math.abs(d) < 1e-9) {
+            if (Math.abs(o) > half[i])
+                return -1;
+            continue;
+        }
+        const t1 = (-half[i] - o) / d;
+        const t2 = (half[i] - o) / d;
+        tMin = Math.max(tMin, Math.min(t1, t2));
+        tMax = Math.min(tMax, Math.max(t1, t2));
+    }
+    // Inside the box (tMin < 0 < tMax) the exit face is at tMax; outside it is tMin.
+    if (tMax < tMin || tMax <= 0)
+        return -1;
+    return tMin > 0 ? tMin : tMax;
+}
+function boxHit(origin, dir, box) {
+    const o = rotateYInv(sub(origin, box.position), box.rotationY);
+    const d = rotateYInv(dir, box.rotationY);
+    return slabHit(o, d, [box.scale[0] / 2, box.scale[1] / 2, box.scale[2] / 2]);
+}
+/** Physical point-light distance falloff, three r185 `getDistanceAttenuation`. */
+function distanceAttenuation(d, cutoff, decay) {
+    let falloff = 1 / Math.max(d ** decay, 0.01);
+    if (cutoff > 0) {
+        const x = Math.min(Math.max(1 - (d / cutoff) ** 4, 0), 1);
+        falloff *= x * x;
+    }
+    return falloff;
+}
+/** Ray vs a Y-rotated box: hit distance and the world-space normal facing the ray. */
+function boxSurfaceHit(origin, dir, box) {
+    const o = rotateYInv(sub(origin, box.position), box.rotationY);
+    const d = rotateYInv(dir, box.rotationY);
+    const half = [box.scale[0] / 2, box.scale[1] / 2, box.scale[2] / 2];
+    const t = slabHit(o, d, half);
+    if (t <= 0)
+        return null;
+    // The hit face is the slab whose plane the local hit point lies on.
+    const p = add(o, scale(d, t));
+    let axis = 0;
+    let best = Infinity;
+    for (let i = 0; i < 3; i += 1) {
+        const gap = Math.abs(Math.abs(p[i]) - half[i]);
+        if (gap < best) {
+            best = gap;
+            axis = i;
+        }
+    }
+    // Facing the ray: outside faces (props) and the room's inner faces (BackSide) alike.
+    const local = [0, 0, 0];
+    local[axis] = d[axis] > 0 ? -1 : 1;
+    const c = Math.cos(box.rotationY);
+    const s = Math.sin(box.rotationY);
+    return { t, normal: [local[0] * c + local[2] * s, local[1], -local[0] * s + local[2] * c] };
+}
+let cachedScene = null;
+/**
+ * Analytic radiance of the r185 room along `dir`, seen from the PMREM capture
+ * point. three's `RoomEnvironment` shifts the whole scene by y = -3.5
+ * (`this.position.y`), so the capture point sits at y = +3.5 in scene space.
+ *
+ *  - emissive panels (`MeshLambertMaterial`, black colour, white emissive ×
+ *    intensity) → their emissive radiance;
+ *  - room walls (BackSide) and prop boxes are default `MeshStandardMaterial`s
+ *    (white, roughness 1, metalness 0): Lambertian albedo 1 lit only by the
+ *    `PointLight(0xffffff, 900, 28, 2)`, i.e. `(1/π) · 900 · max(0, n·l) ·
+ *    attenuation(d)`. No shadows: PMREM capture renders without shadow maps.
+ *
+ * Deterministic. Used by `environments bake` for the neutral preset, by the
+ * neutral floor constants, and by tests against the pinned three file.
+ */
+export function sampleRoomEnvironment(dir) {
+    const scene = (cachedScene ??= createRoomEnvironmentScene());
+    const origin = [0, -ROOM_ENVIRONMENT_SCENE_OFFSET_Y, 0];
+    const len = Math.hypot(dir[0], dir[1], dir[2]) || 1;
+    const ray = [dir[0] / len, dir[1] / len, dir[2] / len];
+    let bestT = Infinity;
+    let radiance = [0, 0, 0];
+    for (const panel of scene.panels) {
+        const t = boxHit(origin, ray, panel);
+        if (t > 0 && t < bestT) {
+            bestT = t;
+            radiance = [panel.emissive[0], panel.emissive[1], panel.emissive[2]];
+        }
+    }
+    let surface = null;
+    for (const box of [scene.room, ...scene.boxes]) {
+        const hit = boxSurfaceHit(origin, ray, box);
+        if (hit && hit.t < bestT) {
+            bestT = hit.t;
+            surface = { hit, albedo: box.albedo };
+        }
+    }
+    if (surface) {
+        const p = add(origin, scale(ray, surface.hit.t));
+        const toLight = sub(scene.light.position, p);
+        const d = Math.hypot(toLight[0], toLight[1], toLight[2]);
+        const nDotL = Math.max(0, dot(surface.hit.normal, scale(toLight, 1 / d)));
+        const e = scene.light.intensity * nDotL * distanceAttenuation(d, scene.light.distance, scene.light.decay);
+        radiance = [
+            (surface.albedo[0] / Math.PI) * e * scene.light.color[0],
+            (surface.albedo[1] / Math.PI) * e * scene.light.color[1],
+            (surface.albedo[2] / Math.PI) * e * scene.light.color[2]
+        ];
+    }
+    return radiance;
+}
+//# sourceMappingURL=RoomEnvironmentScene.js.map

package/dist/environment/RoomEnvironmentScene.js.map

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

package/dist/environment/SphericalHarmonics.d.ts

@@ -0,0 +1,32 @@
+import { evaluateSH9Irradiance } from "../contracts/environment.js";
+export { evaluateSH9Irradiance };
+/**
+ * Cube → SH9 projection. Lives here (not `contracts/environment.ts`, owned by
+ * lane 01) because the contract version carries a `4/(len²·F²)` weight that
+ * under-weights off-axis texels by ~22%; the correct texel solid angle is
+ * `4/(len³·F²)` (du=dv=2/F over the unnormalized direction). qr-request
+ * `to:prd01` tracks the contract fix; until it lands the lane barrel exports
+ * this corrected implementation.
+ */
+export declare function projectCubeToSH9(faces: readonly Float32Array[], faceSize: number): Float32Array;
+export declare const SH9_BANDS = 9;
+/**
+ * Real SH basis in the contract order:
+ * c0, −c1·y, c1·z, −c1·x, c2·xy, c2·yz, c3·(3z²−1), c2·xz, c4·(x²−y²).
+ */
+export declare function sh9Basis(x: number, y: number, z: number, out?: Float32Array | number[]): Float32Array | number[];
+/** Cosine-convolution band multipliers A_l = {π, 2π/3, π/4} in contract coefficient order. */
+export declare const SH9_IRRADIANCE_BASIS_SCALE: readonly number[];
+/** basis × Ahat — the folded irradiance kernel evaluated at a direction. */
+export declare function foldIrradianceBasis(x: number, y: number, z: number): Float32Array;
+/** Radiance (unconvolved) evaluation of a 27-float SH9 coefficient set. */
+export declare function evaluateSH9Radiance(sh: Float32Array, x: number, y: number, z: number): [number, number, number];
+/**
+ * Project an equirectangular radiance map to SH9. u ∈ [0,1) sweeps
+ * φ ∈ [−π, π), v ∈ [0,1] sweeps θ ∈ [0, π] top-to-bottom; solid-angle
+ * weight is sinθ·dφ·dθ.
+ */
+export declare function projectEquirectToSH9(data: Float32Array, width: number, height: number, channels?: number): Float32Array;
+/** Cosine convolution: multiply band l by A_l = {π, 2π/3, π/4}[l]. */
+export declare function convolveSH9Irradiance(radiance: Float32Array): Float32Array;
+//# sourceMappingURL=SphericalHarmonics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SphericalHarmonics.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/environment/SphericalHarmonics.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,OAAO,EAAE,qBAAqB,EAAE,CAAC;AAEjC;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAsB/F;AAyBD,eAAO,MAAM,SAAS,IAAI,CAAC;AAE3B;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,GAAE,YAAY,GAAG,MAAM,EAAwB,GAAG,YAAY,GAAG,MAAM,EAAE,CAgBrI;AAED,8FAA8F;AAC9F,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAIvD,CAAC;AAEF,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,CAIjF;AAED,2EAA2E;AAC3E,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAS/G;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,YAAY,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,SAAI,GACX,YAAY,CA0Bd;AAED,sEAAsE;AACtE,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,YAAY,GAAG,YAAY,CAW1E"}

package/dist/environment/SphericalHarmonics.js

@@ -0,0 +1,155 @@
+/**
+ * PRD-02 §7.1 — SH9 helpers for the environment path.
+ * Re-exports the C-09 working projection/evaluation from contracts and adds
+ * the pieces the CPU pipeline needs: basis evaluation, the irradiance
+ * basis fold (Ahat_l per-band scale), radiance evaluation, equirect
+ * projection, and the cosine convolution (band multipliers π, 2π/3, π/4).
+ */
+import { CUBE_FACE_BASIS } from "./workers/cpuPrefilter.js";
+import { evaluateSH9Irradiance } from "../contracts/environment.js";
+export { evaluateSH9Irradiance };
+/**
+ * Cube → SH9 projection. Lives here (not `contracts/environment.ts`, owned by
+ * lane 01) because the contract version carries a `4/(len²·F²)` weight that
+ * under-weights off-axis texels by ~22%; the correct texel solid angle is
+ * `4/(len³·F²)` (du=dv=2/F over the unnormalized direction). qr-request
+ * `to:prd01` tracks the contract fix; until it lands the lane barrel exports
+ * this corrected implementation.
+ */
+export function projectCubeToSH9(faces, faceSize) {
+    const out = new Float32Array(27);
+    const step = 2 / faceSize;
+    for (let f = 0; f < 6; f += 1) {
+        const face = faces[f];
+        if (!face)
+            continue;
+        const [n, u, v] = FACE_BASIS[f];
+        for (let y = 0; y < faceSize; y += 1) {
+            const fv = (y + 0.5) * step - 1;
+            for (let x = 0; x < faceSize; x += 1) {
+                const fu = (x + 0.5) * step - 1;
+                const dx = n[0] + u[0] * fu + v[0] * fv;
+                const dy = n[1] + u[1] * fu + v[1] * fv;
+                const dz = n[2] + u[2] * fu + v[2] * fv;
+                const len = Math.hypot(dx, dy, dz);
+                const weight = 4 / (len * len * len * faceSize * faceSize);
+                const i = (y * faceSize + x) * 4;
+                accumulateBasis(out, dx / len, dy / len, dz / len, face[i], face[i + 1], face[i + 2], weight);
+            }
+        }
+    }
+    return out;
+}
+// GL cube-face basis shared with the prefilter/samplers (02 IBL fix).
+const FACE_BASIS = CUBE_FACE_BASIS;
+function accumulateBasis(out, x, y, z, r, g, b, w) {
+    const basis = [
+        0.282095,
+        -0.488603 * y,
+        0.488603 * z,
+        -0.488603 * x,
+        1.092548 * x * y,
+        1.092548 * y * z,
+        0.315392 * (3 * z * z - 1),
+        1.092548 * x * z,
+        0.546274 * (x * x - y * y)
+    ];
+    for (let i = 0; i < 9; i += 1) {
+        // Contract layout: interleaved [coefficient·3 + channel] (r,g,b per basis).
+        out[i * 3] = out[i * 3] + basis[i] * r * w;
+        out[i * 3 + 1] = out[i * 3 + 1] + basis[i] * g * w;
+        out[i * 3 + 2] = out[i * 3 + 2] + basis[i] * b * w;
+    }
+}
+export const SH9_BANDS = 9;
+/**
+ * Real SH basis in the contract order:
+ * c0, −c1·y, c1·z, −c1·x, c2·xy, c2·yz, c3·(3z²−1), c2·xz, c4·(x²−y²).
+ */
+export function sh9Basis(x, y, z, out = new Float32Array(9)) {
+    const c0 = 0.282095;
+    const c1 = 0.488603;
+    const c2 = 1.092548;
+    const c3 = 0.315392;
+    const c4 = 0.546274;
+    out[0] = c0;
+    out[1] = -c1 * y;
+    out[2] = c1 * z;
+    out[3] = -c1 * x;
+    out[4] = c2 * x * y;
+    out[5] = c2 * y * z;
+    out[6] = c3 * (3 * z * z - 1);
+    out[7] = c2 * x * z;
+    out[8] = c4 * (x * x - y * y);
+    return out;
+}
+/** Cosine-convolution band multipliers A_l = {π, 2π/3, π/4} in contract coefficient order. */
+export const SH9_IRRADIANCE_BASIS_SCALE = [
+    Math.PI,
+    (2 * Math.PI) / 3, (2 * Math.PI) / 3, (2 * Math.PI) / 3,
+    Math.PI / 4, Math.PI / 4, Math.PI / 4, Math.PI / 4, Math.PI / 4
+];
+/** basis × Ahat — the folded irradiance kernel evaluated at a direction. */
+export function foldIrradianceBasis(x, y, z) {
+    const b = sh9Basis(x, y, z);
+    for (let i = 0; i < 9; i += 1)
+        b[i] *= SH9_IRRADIANCE_BASIS_SCALE[i];
+    return b;
+}
+/** Radiance (unconvolved) evaluation of a 27-float SH9 coefficient set. */
+export function evaluateSH9Radiance(sh, x, y, z) {
+    const b = sh9Basis(x, y, z);
+    let r = 0, g = 0, bl = 0;
+    for (let i = 0; i < 9; i += 1) {
+        r += sh[i * 3] * b[i];
+        g += sh[i * 3 + 1] * b[i];
+        bl += sh[i * 3 + 2] * b[i];
+    }
+    return [r, g, bl];
+}
+/**
+ * Project an equirectangular radiance map to SH9. u ∈ [0,1) sweeps
+ * φ ∈ [−π, π), v ∈ [0,1] sweeps θ ∈ [0, π] top-to-bottom; solid-angle
+ * weight is sinθ·dφ·dθ.
+ */
+export function projectEquirectToSH9(data, width, height, channels = 4) {
+    const sh = new Float32Array(27);
+    const dPhi = (2 * Math.PI) / width;
+    const dTheta = Math.PI / height;
+    const basis = new Float32Array(9);
+    for (let row = 0; row < height; row += 1) {
+        const v = (row + 0.5) / height;
+        const theta = v * Math.PI;
+        const sinT = Math.sin(theta);
+        const weight = sinT * dPhi * dTheta;
+        for (let col = 0; col < width; col += 1) {
+            const u = (col + 0.5) / width;
+            const phi = u * 2 * Math.PI - Math.PI;
+            const x = -Math.cos(phi) * sinT;
+            const y = Math.cos(theta);
+            const z = Math.sin(phi) * sinT;
+            sh9Basis(x, y, z, basis);
+            const i = (row * width + col) * channels;
+            for (let k = 0; k < 9; k += 1) {
+                sh[k * 3] += data[i] * basis[k] * weight;
+                sh[k * 3 + 1] += data[i + 1] * basis[k] * weight;
+                sh[k * 3 + 2] += data[i + 2] * basis[k] * weight;
+            }
+        }
+    }
+    return sh;
+}
+/** Cosine convolution: multiply band l by A_l = {π, 2π/3, π/4}[l]. */
+export function convolveSH9Irradiance(radiance) {
+    const bandScale = [Math.PI, (2 * Math.PI) / 3, Math.PI / 4];
+    const out = new Float32Array(27);
+    for (let i = 0; i < 9; i += 1) {
+        const l = i === 0 ? 0 : i < 4 ? 1 : 2;
+        const s = bandScale[l];
+        out[i * 3] = radiance[i * 3] * s;
+        out[i * 3 + 1] = radiance[i * 3 + 1] * s;
+        out[i * 3 + 2] = radiance[i * 3 + 2] * s;
+    }
+    return out;
+}
+//# sourceMappingURL=SphericalHarmonics.js.map

package/dist/environment/SphericalHarmonics.js.map

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

package/dist/environment/probeBuild.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Shared probe construction (PRD-02 §6.2): float RGBA faces → PMREM levels →
+ * rgba16f cube `Texture` + SH9 (+ packed `shTexture`). Pure CPU, no device
+ * dependency — used by `GPUPMREMGenerator`, `Prd02EnvironmentProbeFactory`,
+ * and `EnvironmentCache` without creating import cycles.
+ */
+import { Texture } from "../Texture.js";
+import type { EnvironmentProbe } from "../contracts/environment.js";
+import { type PrefilterCubeSource, type PrefilterResult } from "./workers/cpuPrefilter.js";
+export declare const CUBE_FACE_ORDER: readonly ["px", "nx", "py", "ny", "pz", "nz"];
+export type ProbeSource = EnvironmentProbe["source"];
+export interface Prd02ProbeBuildOptions {
+    readonly faceSize?: EnvironmentProbe["faceSize"];
+    /** Override prefilter executor (Worker/GPU). Defaults to `prefilterCubeGGX`. */
+    readonly prefilter?: (source: PrefilterCubeSource, samples?: number) => PrefilterResult;
+    readonly samples?: number;
+    readonly source?: ProbeSource;
+    /** Extra `Texture` bound as the scene background (equirect/preset only). */
+    readonly background?: Texture | null;
+    readonly label?: string;
+    /** Pre-computed SH9 (baked presets ship `<name>.sh9.f32` at 128-sample quality). */
+    readonly sh9?: Float32Array;
+}
+export declare class Prd02EnvironmentProbe implements EnvironmentProbe {
+    readonly kind: "environment-probe";
+    readonly specularCube: Texture;
+    readonly mipCount: number;
+    readonly faceSize: EnvironmentProbe["faceSize"];
+    readonly sh9: Float32Array;
+    readonly shTexture: Texture | null;
+    readonly background: Texture | null;
+    readonly source: ProbeSource;
+    private disposed;
+    constructor(args: {
+        readonly specularCube: Texture;
+        readonly mipCount: number;
+        readonly faceSize: EnvironmentProbe["faceSize"];
+        readonly sh9: Float32Array;
+        readonly shTexture: Texture | null;
+        readonly background: Texture | null;
+        readonly source: ProbeSource;
+    });
+    dispose(): void;
+}
+/** Pack the 27-float SH into a 9×1 rgba32f texture (w lane unused). */
+export declare function sh9ToTexture(sh9: Float32Array): Texture;
+/** Build a probe from six RGBA float faces (linear HDR). */
+export declare function buildProbeFromFaces(faces: readonly Float32Array[], faceSize: EnvironmentProbe["faceSize"], options?: Prd02ProbeBuildOptions): Prd02EnvironmentProbe;
+/** Build a probe from already-prefiltered per-level faces (baked KTX2 path). */
+export declare function buildProbeFromLevels(levels: readonly {
+    readonly faceSize: number;
+    readonly faces: readonly Float32Array[];
+}[], faceSize: EnvironmentProbe["faceSize"], options?: Prd02ProbeBuildOptions): Prd02EnvironmentProbe;
+/**
+ * Linear radiance of the analytic neutral floor (T0-25): constant chosen so the
+ * probe's SH9 DC equals the baked `neutral` preset's (3.7560 ≈ c·3.5483; the
+ * point-lit r185 room, re-baked with the RoomEnvironmentScene fix).
+ */
+export declare const NEUTRAL_FLOOR_RADIANCE = 1.0585341933512515;
+/**
+ * The baked `neutral` preset's SH9 verbatim (`neutral.sh9.f32`, CC0 bake) —
+ * the floor carries it so diffuse IBL is identical before and after the baked
+ * specular cube lands via `acquire`.
+ */
+export declare const NEUTRAL_FLOOR_SH9: Float32Array<ArrayBuffer>;
+/**
+ * Instant analytic neutral floor: a constant cube at `NEUTRAL_FLOOR_RADIANCE`
+ * plus the baked `NEUTRAL_FLOOR_SH9` — no CPU GGX prefilter. Specular detail
+ * arrives through the baked `neutral` preset upgrade.
+ */
+export declare function buildNeutralFloorProbe(faceSize: EnvironmentProbe["faceSize"], options?: Prd02ProbeBuildOptions): Prd02EnvironmentProbe;
+/**
+ * Directional neutral room for the legacy forward path (#1141 / 02-S2).
+ * The legacy shader reads diffuse from the *last* level of the bound cube
+ * (lod = mipCount − 1, clamped), so the constant `buildNeutralFloorProbe`
+ * gives every normal the same light. This probe is the analytic r185 room at
+ * 64 px (no GGX prefilter: ~24k analytic samples, once; nearest-upsampled
+ * to the 128 px mip 0), a 2×2 box mip at 32 px for glossy reflections, and a 16 px last level
+ * holding the SH9 cosine irradiance ÷ π (Lambert-equivalent radiance), so
+ * diffuse is directional and cosine-weighted like three's PMREM.
+ */
+export declare function buildNeutralRoomLegacyProbe(options?: Prd02ProbeBuildOptions): Prd02EnvironmentProbe;
+/** Rasterize the analytic RoomEnvironmentScene into six float faces. */
+export declare function buildRoomFaces(faceSize: number): Float32Array[];
+/** 90° perspective view-projection for cube capture at `position`. Row-major, GL clip space. */
+export declare function cubeFaceViewProjection(face: 0 | 1 | 2 | 3 | 4 | 5, position?: readonly [number, number, number], near?: number, far?: number): Float32Array;
+/**
+ * Legacy-path bridge (PRD-02 Phase 3): project the probe's mip-0 specular
+ * cube to a mipped RGBA16F equirect — linear HDR end to end (no Reinhard,
+ * no RGBA8), which fixes the E5 dim/clip problem on the legacy environment
+ * path when the flag is on. Mip chain is a CPU box filter.
+ */
+export declare function probeToEquirectTexture(probe: EnvironmentProbe, options?: {
+    readonly width?: number;
+    readonly height?: number;
+}): Texture;
+//# sourceMappingURL=probeBuild.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"probeBuild.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/environment/probeBuild.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAwB,MAAM,eAAe,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,OAAO,EAA8D,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEvJ,eAAO,MAAM,eAAe,+CAAgD,CAAC;AAE7E,MAAM,MAAM,WAAW,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AAErD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACjD,gFAAgF;IAChF,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,eAAe,CAAC;IACxF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,4EAA4E;IAC5E,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,oFAAoF;IACpF,QAAQ,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,qBAAa,qBAAsB,YAAW,gBAAgB;IAC5D,SAAgB,IAAI,EAAG,mBAAmB,CAAU;IACpD,SAAgB,YAAY,EAAE,OAAO,CAAC;IACtC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACvD,SAAgB,GAAG,EAAE,YAAY,CAAC;IAClC,SAAgB,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IAC1C,SAAgB,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;IAC3C,SAAgB,MAAM,EAAE,WAAW,CAAC;IACpC,OAAO,CAAC,QAAQ,CAAS;gBAEb,IAAI,EAAE;QAChB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;QAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAChD,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC;QAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;QACnC,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAAC;QACpC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;KAC9B;IAUD,OAAO,IAAI,IAAI;CAOhB;AAqBD,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,GAAG,EAAE,YAAY,GAAG,OAAO,CAQvD;AAED,4DAA4D;AAC5D,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,EACtC,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CA4BvB;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAA;CAAE,EAAE,EACzF,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,EACtC,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CA2BvB;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,qBAAqB,CAAC;AAEzD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,2BAU5B,CAAC;AAEH;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,gBAAgB,CAAC,UAAU,CAAC,EACtC,OAAO,GAAE,sBAA2B,GACnC,qBAAqB,CAmBvB;AA8BD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,sBAA2B,GAAG,qBAAqB,CAkCvG;AAED,wEAAwE;AACxE,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,EAAE,CAe/D;AAED,gGAAgG;AAChG,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAC3B,QAAQ,GAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAa,EACvD,IAAI,SAAO,EACX,GAAG,SAAM,GACR,YAAY,CAqCd;AAsCD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,gBAAgB,EACvB,OAAO,GAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAO,GAClE,OAAO,CAgDT"}