@aura3d/rendering 3.0.1 → 4.0.0

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":"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"}

package/dist/environment/probeBuild.js

@@ -0,0 +1,406 @@
+/**
+ * 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 { sampleRoomEnvironment } from "./RoomEnvironmentScene.js";
+import { evaluateSH9Irradiance, projectCubeToSH9 } from "./SphericalHarmonics.js";
+import { CUBE_FACE_BASIS, faceUvToDir, prefilterCubeGGX, sampleCube } from "./workers/cpuPrefilter.js";
+export const CUBE_FACE_ORDER = ["px", "nx", "py", "ny", "pz", "nz"];
+export class Prd02EnvironmentProbe {
+    kind = "environment-probe";
+    specularCube;
+    mipCount;
+    faceSize;
+    sh9;
+    shTexture;
+    background;
+    source;
+    disposed = false;
+    constructor(args) {
+        this.specularCube = args.specularCube;
+        this.mipCount = args.mipCount;
+        this.faceSize = args.faceSize;
+        this.sh9 = args.sh9;
+        this.shTexture = args.shTexture;
+        this.background = args.background;
+        this.source = args.source;
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        this.specularCube.dispose();
+        this.shTexture?.dispose();
+        this.background?.dispose();
+    }
+}
+/** IEEE-754 binary16 encode for rgba16f upload (clamps negatives/∞ to the HDR range). */
+function floatToHalf(value) {
+    const v = Math.max(0, value);
+    if (Number.isNaN(v))
+        return 0x7e00;
+    if (!Number.isFinite(v) || v >= 65504)
+        return 0x7bff;
+    if (v === 0)
+        return 0;
+    if (v < 2 ** -14)
+        return Math.round(v / 2 ** -24);
+    const exponent = Math.floor(Math.log2(v));
+    const mantissa = Math.round((v / 2 ** exponent - 1) * 1024);
+    return ((exponent + 15) << 10) | (mantissa & 0x03ff);
+}
+/** Float32 RGBA face → Uint16 half-float bytes (the rgba16f upload format). */
+function faceToHalf(face) {
+    const out = new Uint16Array(face.length);
+    for (let i = 0; i < face.length; i += 1)
+        out[i] = floatToHalf(face[i] ?? 0);
+    return out;
+}
+/** Pack the 27-float SH into a 9×1 rgba32f texture (w lane unused). */
+export function sh9ToTexture(sh9) {
+    const data = new Float32Array(36);
+    for (let i = 0; i < 9; i += 1) {
+        data[i * 4] = sh9[i * 3] ?? 0;
+        data[i * 4 + 1] = sh9[i * 3 + 1] ?? 0;
+        data[i * 4 + 2] = sh9[i * 3 + 2] ?? 0;
+    }
+    return new Texture({ width: 9, height: 1, format: "rgba32f", label: "env-sh9", data });
+}
+/** Build a probe from six RGBA float faces (linear HDR). */
+export function buildProbeFromFaces(faces, faceSize, options = {}) {
+    const prefilter = options.prefilter ?? ((src) => prefilterCubeGGX(src, { samples: options.samples }));
+    const result = prefilter({ faceSize, faces }, options.samples);
+    const cubeFaces = CUBE_FACE_ORDER.map((face, f) => ({
+        face: face,
+        mipLevels: result.levels.map((level) => ({
+            width: level.faceSize,
+            height: level.faceSize,
+            data: faceToHalf(level.faces[f]),
+        }))
+    }));
+    const specularCube = new Texture({
+        width: faceSize,
+        height: faceSize,
+        format: "rgba16f",
+        label: options.label ?? "env-pmrem",
+        cubeFaces
+    });
+    const sh9 = projectCubeToSH9(faces, faceSize);
+    return new Prd02EnvironmentProbe({
+        specularCube,
+        mipCount: result.mipCount,
+        faceSize,
+        sh9,
+        shTexture: sh9ToTexture(sh9),
+        background: options.background ?? null,
+        source: options.source ?? "hdri"
+    });
+}
+/** Build a probe from already-prefiltered per-level faces (baked KTX2 path). */
+export function buildProbeFromLevels(levels, faceSize, options = {}) {
+    const cubeFaces = CUBE_FACE_ORDER.map((face, f) => ({
+        face: face,
+        mipLevels: levels.map((level) => ({
+            width: level.faceSize,
+            height: level.faceSize,
+            data: faceToHalf(level.faces[f])
+        }))
+    }));
+    const specularCube = new Texture({
+        width: faceSize,
+        height: faceSize,
+        format: "rgba16f",
+        label: options.label ?? "env-pmrem-baked",
+        cubeFaces
+    });
+    const mip0 = levels[0];
+    const sh9 = options.sh9 ?? (mip0 ? projectCubeToSH9(mip0.faces, mip0.faceSize) : new Float32Array(27));
+    return new Prd02EnvironmentProbe({
+        specularCube,
+        mipCount: levels.length,
+        faceSize,
+        sh9,
+        shTexture: sh9ToTexture(sh9),
+        background: options.background ?? null,
+        source: options.source ?? "preset"
+    });
+}
+/**
+ * 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 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 const NEUTRAL_FLOOR_SH9 = new Float32Array([
+    3.7560017, 3.7560017, 3.7560017,
+    -1.7286245, -1.7286245, -1.7286245,
+    1.5881586, 1.5881586, 1.5881586,
+    -0.25784275, -0.25784275, -0.25784275,
+    0.19389074, 0.19389074, 0.19389074,
+    1.0348382, 1.0348382, 1.0348382,
+    1.1923468, 1.1923468, 1.1923468,
+    -0.33930653, -0.33930653, -0.33930653,
+    -0.62652594, -0.62652594, -0.62652594
+]);
+/**
+ * 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 function buildNeutralFloorProbe(faceSize, options = {}) {
+    const face = new Float32Array(faceSize * faceSize * 4);
+    for (let i = 0; i < faceSize * faceSize; i += 1) {
+        face[i * 4] = NEUTRAL_FLOOR_RADIANCE;
+        face[i * 4 + 1] = NEUTRAL_FLOOR_RADIANCE;
+        face[i * 4 + 2] = NEUTRAL_FLOOR_RADIANCE;
+        face[i * 4 + 3] = 1;
+    }
+    const faces = [face, face, face, face, face, face];
+    return buildProbeFromLevels([{ faceSize, faces }], faceSize, {
+        ...options,
+        label: options.label ?? "env-neutral-floor",
+        source: options.source ?? "neutral",
+        sh9: options.sh9 ?? new Float32Array(NEUTRAL_FLOOR_SH9)
+    });
+}
+/** Nearest 2× upsample of one square float RGBA face. */
+function upsampleFace(face, size) {
+    const out = new Float32Array(size * size * 16);
+    for (let y = 0; y < size * 2; y += 1) {
+        for (let x = 0; x < size * 2; x += 1) {
+            const src = ((y >> 1) * size + (x >> 1)) * 4;
+            const dst = (y * size * 2 + x) * 4;
+            out[dst] = face[src];
+            out[dst + 1] = face[src + 1];
+            out[dst + 2] = face[src + 2];
+            out[dst + 3] = face[src + 3];
+        }
+    }
+    return out;
+}
+/** 2×2 box downsample of one square float RGBA face. */
+function downsampleFace(face, size) {
+    const half = size / 2;
+    const out = new Float32Array(half * half * 4);
+    for (let y = 0; y < half; y += 1) {
+        for (let x = 0; x < half; x += 1) {
+            for (let c = 0; c < 4; c += 1) {
+                const at = (yy, xx) => face[(yy * size + xx) * 4 + c];
+                out[(y * half + x) * 4 + c] = 0.25 * (at(2 * y, 2 * x) + at(2 * y, 2 * x + 1) + at(2 * y + 1, 2 * x) + at(2 * y + 1, 2 * x + 1));
+            }
+        }
+    }
+    return out;
+}
+/**
+ * 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 function buildNeutralRoomLegacyProbe(options = {}) {
+    const base = 128;
+    const sh9 = options.sh9 ?? new Float32Array(NEUTRAL_FLOOR_SH9);
+    // Sample the room at 64 px (24k analytic rays) and nearest-upsample to the
+    // 128 px base the probe contract requires: keeps the one-off main-thread
+    // cost lower than sampling the full 128 px base; timing is device-dependent.
+    const sampled = buildRoomFaces(base / 2);
+    const levels = [
+        { faceSize: base, faces: sampled.map((face) => upsampleFace(face, base / 2)) },
+        { faceSize: base / 2, faces: sampled }
+    ];
+    levels.push({ faceSize: base / 4, faces: sampled.map((face) => downsampleFace(face, base / 2)) });
+    const last = 16;
+    const irradiance = [];
+    for (let f = 0; f < 6; f += 1) {
+        const face = new Float32Array(last * last * 4);
+        for (let y = 0; y < last; y += 1) {
+            for (let x = 0; x < last; x += 1) {
+                const d = faceUvToDir(f, ((x + 0.5) / last) * 2 - 1, ((y + 0.5) / last) * 2 - 1);
+                const len = Math.hypot(d[0], d[1], d[2]) || 1;
+                const [r, g, b] = evaluateSH9Irradiance(sh9, [d[0] / len, d[1] / len, d[2] / len]);
+                const i = (y * last + x) * 4;
+                face[i] = Math.max(0, r / Math.PI);
+                face[i + 1] = Math.max(0, g / Math.PI);
+                face[i + 2] = Math.max(0, b / Math.PI);
+                face[i + 3] = 1;
+            }
+        }
+        irradiance.push(face);
+    }
+    levels.push({ faceSize: last, faces: irradiance });
+    return buildProbeFromLevels(levels, base, {
+        ...options,
+        label: options.label ?? "env-neutral-room-legacy",
+        source: options.source ?? "neutral",
+        sh9
+    });
+}
+/** Rasterize the analytic RoomEnvironmentScene into six float faces. */
+export function buildRoomFaces(faceSize) {
+    const faces = [];
+    for (let f = 0; f < 6; f += 1) {
+        const face = new Float32Array(faceSize * faceSize * 4);
+        for (let y = 0; y < faceSize; y += 1) {
+            for (let x = 0; x < faceSize; x += 1) {
+                const dir = faceUvToDir(f, ((x + 0.5) / faceSize) * 2 - 1, ((y + 0.5) / faceSize) * 2 - 1);
+                const [r, g, b] = sampleRoomEnvironment(dir);
+                const i = (y * faceSize + x) * 4;
+                face[i] = r;
+                face[i + 1] = g;
+                face[i + 2] = b;
+                face[i + 3] = 1;
+            }
+        }
+        faces.push(face);
+    }
+    return faces;
+}
+/** 90° perspective view-projection for cube capture at `position`. Row-major, GL clip space. */
+export function cubeFaceViewProjection(face, position = [0, 0, 0], near = 0.05, far = 100) {
+    const basis = CUBE_FACE_BASIS; // GL face basis: up = −V, right = U
+    const [n, ux, vx] = basis[face];
+    // view = lookAt along +n with up derived from the face basis (vx is "down" on the face).
+    const up = [-vx[0], -vx[1], -vx[2]];
+    const right = [
+        up[1] * n[2] - up[2] * n[1],
+        up[2] * n[0] - up[0] * n[2],
+        up[0] * n[1] - up[1] * n[0]
+    ];
+    // Column-major view matrix (GL convention) then 90° perspective.
+    const tx = -(right[0] * position[0] + right[1] * position[1] + right[2] * position[2]);
+    const ty = -(up[0] * position[0] + up[1] * position[1] + up[2] * position[2]);
+    const tz = -(-(n[0] * position[0] + n[1] * position[1] + n[2] * position[2]));
+    const view = [
+        right[0], up[0], -n[0], 0,
+        right[1], up[1], -n[1], 0,
+        right[2], up[2], -n[2], 0,
+        tx, ty, tz, 1
+    ];
+    const f = 1 / Math.tan(Math.PI / 4);
+    const nf = 1 / (near - far);
+    const proj = [
+        f, 0, 0, 0,
+        0, f, 0, 0,
+        0, 0, (far + near) * nf, -1,
+        0, 0, 2 * far * near * nf, 0
+    ];
+    const out = new Float32Array(16);
+    for (let c = 0; c < 4; c += 1) {
+        for (let r = 0; r < 4; r += 1) {
+            let s = 0;
+            for (let k = 0; k < 4; k += 1)
+                s += proj[k * 4 + r] * view[c * 4 + k];
+            out[c * 4 + r] = s;
+        }
+    }
+    return out;
+}
+/** IEEE-754 binary16 decode (rgba16f readback → Float32). */
+function halfToFloat(h) {
+    const sign = h & 0x8000 ? -1 : 1;
+    const exp = (h >> 10) & 0x1f;
+    const mantissa = h & 0x03ff;
+    if (exp === 0)
+        return sign * mantissa * 2 ** -24;
+    if (exp === 0x1f)
+        return mantissa !== 0 ? Number.NaN : sign * Number.POSITIVE_INFINITY;
+    return sign * (1 + mantissa / 1024) * 2 ** (exp - 15);
+}
+/** 2× box-filter downsample of an RGBA32F image (mip chain, linear HDR). */
+function downsampleRgba(src, w, h) {
+    const nw = Math.max(1, w >> 1);
+    const nh = Math.max(1, h >> 1);
+    const out = new Float32Array(nw * nh * 4);
+    for (let y = 0; y < nh; y += 1) {
+        for (let x = 0; x < nw; x += 1) {
+            for (let c = 0; c < 4; c += 1) {
+                let sum = 0;
+                let count = 0;
+                for (let dy = 0; dy < 2; dy += 1) {
+                    for (let dx = 0; dx < 2; dx += 1) {
+                        const sx = Math.min(w - 1, x * 2 + dx);
+                        const sy = Math.min(h - 1, y * 2 + dy);
+                        sum += src[(sy * w + sx) * 4 + c];
+                        count += 1;
+                    }
+                }
+                out[(y * nw + x) * 4 + c] = sum / count;
+            }
+        }
+    }
+    return { data: out, width: nw, height: nh };
+}
+/**
+ * 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 function probeToEquirectTexture(probe, options = {}) {
+    const width = options.width ?? probe.faceSize * 2;
+    const height = options.height ?? probe.faceSize;
+    const faceSize = probe.faceSize;
+    const level0 = probe.specularCube.cubeFaces.map((face) => {
+        const mip = face.mipLevels[0];
+        if (!mip)
+            throw new Error("probe specular cube has no mip-0 data");
+        if (mip.data instanceof Uint16Array) {
+            const out = new Float32Array(mip.data.length);
+            for (let i = 0; i < mip.data.length; i += 1)
+                out[i] = halfToFloat(mip.data[i]);
+            return out;
+        }
+        return new Float32Array(mip.data);
+    });
+    const source = { faceSize, faces: level0 };
+    let equirect = new Float32Array(width * height * 4);
+    for (let row = 0; row < height; row += 1) {
+        const theta = ((row + 0.5) / height) * Math.PI;
+        const sinT = Math.sin(theta);
+        const cosT = Math.cos(theta);
+        for (let col = 0; col < width; col += 1) {
+            const phi = ((col + 0.5) / width) * 2 * Math.PI - Math.PI;
+            const dir = [-Math.cos(phi) * sinT, cosT, Math.sin(phi) * sinT];
+            const [r, g, b] = sampleCube(source, dir);
+            const i = (row * width + col) * 4;
+            equirect[i] = r;
+            equirect[i + 1] = g;
+            equirect[i + 2] = b;
+            equirect[i + 3] = 1;
+        }
+    }
+    const mipLevels = [
+        { width, height, data: faceToHalf(equirect) }
+    ];
+    let w = width;
+    let h = height;
+    while (w > 1 || h > 1) {
+        const next = downsampleRgba(equirect, w, h);
+        mipLevels.push({ width: next.width, height: next.height, data: faceToHalf(next.data) });
+        equirect = next.data;
+        w = next.width;
+        h = next.height;
+    }
+    return new Texture({
+        width,
+        height,
+        format: "rgba16f",
+        colorSpace: "linear",
+        label: `prd02-equirect-${probe.source}`,
+        mipLevels
+    });
+}
+//# sourceMappingURL=probeBuild.js.map