@adobe/data-gpu 0.9.69

package/dist/graphics/rendering/ibl-render/ibl/environment.js

@@ -0,0 +1,170 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { floatArrayToHalf } from "./float-to-half.js";
+import iblMath from "./ibl-math.wgsl.js";
+import { createCubemap, cubeFaceView, FULLSCREEN_VS } from "./render-helpers.js";
+const ENV_PROCEDURAL_FS = /* wgsl */ `
+struct Params { face: u32, size: u32 };
+@group(0) @binding(0) var<uniform> params: Params;
+
+fn env_color(dir: vec3f) -> vec3f {
+    let sky_top = vec3f(0.45, 0.55, 0.75);
+    let horizon = vec3f(0.18, 0.20, 0.24);
+    let ground  = vec3f(0.08, 0.08, 0.10);
+    var color = mix(horizon, sky_top, smoothstep(-0.05, 0.65, dir.y));
+    color = mix(ground, color, smoothstep(-0.3, 0.0, dir.y));
+
+    let warm = vec3f(9.0, 7.2, 5.0);
+    let cool = vec3f(5.0, 7.5, 10.0);
+    for (var i = 0u; i < 4u; i = i + 1u) {
+        let a = f32(i) * 1.5707963;
+        let ld = normalize(vec3f(sin(a) * 0.55, 0.85, cos(a) * 0.55));
+        let d = max(dot(dir, ld), 0.0);
+        let intensity = pow(d, 96.0);
+        let lc = select(warm, cool, i % 2u == 0u);
+        color = color + intensity * lc;
+    }
+    return color;
+}
+
+@fragment
+fn fs_main(@builtin(position) frag: vec4f) -> @location(0) vec4f {
+    let uv = frag.xy / f32(params.size);
+    let dir = cube_uv_to_dir(params.face, uv);
+    return vec4f(env_color(dir), 1.0);
+}
+`;
+const ENV_EQUIRECT_FS = /* wgsl */ `
+struct Params { face: u32, size: u32 };
+@group(0) @binding(0) var<uniform> params: Params;
+@group(0) @binding(1) var equirect: texture_2d<f32>;
+@group(0) @binding(2) var equirectSampler: sampler;
+
+fn dir_to_equirect_uv(d: vec3f) -> vec2f {
+    let theta = atan2(d.z, d.x);
+    let phi = asin(clamp(d.y, -1.0, 1.0));
+    return vec2f((theta + PI) / (2.0 * PI), 0.5 - phi / PI);
+}
+
+@fragment
+fn fs_main(@builtin(position) frag: vec4f) -> @location(0) vec4f {
+    let uv = frag.xy / f32(params.size);
+    let dir = cube_uv_to_dir(params.face, uv);
+    let env_uv = dir_to_equirect_uv(dir);
+    return textureSampleLevel(equirect, equirectSampler, env_uv, 0.0);
+}
+`;
+function uploadHdrAsTexture(device, hdr) {
+    const halfData = floatArrayToHalf(hdr.rgba);
+    const texture = device.createTexture({
+        size: [hdr.width, hdr.height, 1],
+        format: "rgba16float",
+        usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST,
+    });
+    device.queue.writeTexture({ texture }, halfData.buffer, { bytesPerRow: hdr.width * 8 }, [hdr.width, hdr.height, 1]);
+    return texture;
+}
+function makeProceduralPipeline(device, format) {
+    const module = device.createShaderModule({ code: FULLSCREEN_VS + iblMath + ENV_PROCEDURAL_FS });
+    const bindGroupLayout = device.createBindGroupLayout({
+        entries: [{ binding: 0, visibility: GPUShaderStage.FRAGMENT, buffer: { type: "uniform" } }],
+    });
+    const pipeline = device.createRenderPipeline({
+        layout: device.createPipelineLayout({ bindGroupLayouts: [bindGroupLayout] }),
+        vertex: { module, entryPoint: "vs_fullscreen" },
+        fragment: { module, entryPoint: "fs_main", targets: [{ format }] },
+        primitive: { topology: "triangle-list" },
+    });
+    return { pipeline, bindGroupLayout };
+}
+function makeEquirectPipeline(device, format) {
+    const module = device.createShaderModule({ code: FULLSCREEN_VS + iblMath + ENV_EQUIRECT_FS });
+    const bindGroupLayout = device.createBindGroupLayout({
+        entries: [
+            { binding: 0, visibility: GPUShaderStage.FRAGMENT, buffer: { type: "uniform" } },
+            { binding: 1, visibility: GPUShaderStage.FRAGMENT, texture: { sampleType: "float", viewDimension: "2d" } },
+            { binding: 2, visibility: GPUShaderStage.FRAGMENT, sampler: { type: "filtering" } },
+        ],
+    });
+    const pipeline = device.createRenderPipeline({
+        layout: device.createPipelineLayout({ bindGroupLayouts: [bindGroupLayout] }),
+        vertex: { module, entryPoint: "vs_fullscreen" },
+        fragment: { module, entryPoint: "fs_main", targets: [{ format }] },
+        primitive: { topology: "triangle-list" },
+    });
+    return { pipeline, bindGroupLayout };
+}
+/**
+ * Renders an environment cubemap. With no `hdr` source it falls back to the
+ * built-in procedural studio. Pass a parsed Radiance HDR for a real photoreal
+ * environment — used by the IBL plugin to enable Babylon-style glossy
+ * reflections.
+ */
+export function generateEnvironment(device, encoder, size, hdr) {
+    const format = "rgba16float";
+    const texture = createCubemap(device, size, format, 1);
+    if (hdr) {
+        const equirectTexture = uploadHdrAsTexture(device, hdr);
+        const sampler = device.createSampler({
+            magFilter: "linear",
+            minFilter: "linear",
+            addressModeU: "repeat",
+            addressModeV: "clamp-to-edge",
+        });
+        const { pipeline, bindGroupLayout } = makeEquirectPipeline(device, format);
+        const equirectView = equirectTexture.createView();
+        for (let face = 0; face < 6; face++) {
+            const ub = device.createBuffer({
+                size: 16,
+                usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+            });
+            device.queue.writeBuffer(ub, 0, new Uint32Array([face, size, 0, 0]));
+            const bindGroup = device.createBindGroup({
+                layout: bindGroupLayout,
+                entries: [
+                    { binding: 0, resource: { buffer: ub } },
+                    { binding: 1, resource: equirectView },
+                    { binding: 2, resource: sampler },
+                ],
+            });
+            const pass = encoder.beginRenderPass({
+                colorAttachments: [{
+                        view: cubeFaceView(texture, face, 0),
+                        loadOp: "clear",
+                        storeOp: "store",
+                        clearValue: [0, 0, 0, 1],
+                    }],
+            });
+            pass.setPipeline(pipeline);
+            pass.setBindGroup(0, bindGroup);
+            pass.draw(3);
+            pass.end();
+        }
+        return texture;
+    }
+    const { pipeline, bindGroupLayout } = makeProceduralPipeline(device, format);
+    for (let face = 0; face < 6; face++) {
+        const ub = device.createBuffer({
+            size: 16,
+            usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+        });
+        device.queue.writeBuffer(ub, 0, new Uint32Array([face, size, 0, 0]));
+        const bindGroup = device.createBindGroup({
+            layout: bindGroupLayout,
+            entries: [{ binding: 0, resource: { buffer: ub } }],
+        });
+        const pass = encoder.beginRenderPass({
+            colorAttachments: [{
+                    view: cubeFaceView(texture, face, 0),
+                    loadOp: "clear",
+                    storeOp: "store",
+                    clearValue: [0, 0, 0, 1],
+                }],
+        });
+        pass.setPipeline(pipeline);
+        pass.setBindGroup(0, bindGroup);
+        pass.draw(3);
+        pass.end();
+    }
+    return texture;
+}
+//# sourceMappingURL=environment.js.map

package/dist/graphics/rendering/ibl-render/ibl/environment.js.map

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

package/dist/graphics/rendering/ibl-render/ibl/float-to-half.d.ts

@@ -0,0 +1,2 @@
+export declare function floatToHalf(value: number): number;
+export declare function floatArrayToHalf(src: Float32Array): Uint16Array;

package/dist/graphics/rendering/ibl-render/ibl/float-to-half.js

@@ -0,0 +1,32 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+// IEEE 754 binary16 (half-float) encoder. WebGPU's rgba16float upload path
+// expects Uint16-packed half-floats; Float32 source data has to be converted
+// element-wise. Standard bit-twiddle, no infinity/NaN edge cases needed for
+// well-formed HDRI input (subnormals are flushed to zero).
+const f32 = new Float32Array(1);
+const u32 = new Uint32Array(f32.buffer);
+export function floatToHalf(value) {
+    f32[0] = value;
+    const bits = u32[0];
+    const sign = (bits >> 16) & 0x8000;
+    const expRaw = (bits >> 23) & 0xff;
+    const mantissa = bits & 0x7fffff;
+    if (expRaw === 0xff) {
+        // Infinity or NaN.
+        return sign | 0x7c00 | (mantissa ? 0x200 : 0);
+    }
+    const exp = expRaw - 127;
+    if (exp >= 16)
+        return sign | 0x7c00; // overflow → ±Inf
+    if (exp < -14)
+        return sign; // underflow → ±0
+    return sign | ((exp + 15) << 10) | (mantissa >> 13);
+}
+export function floatArrayToHalf(src) {
+    const out = new Uint16Array(src.length);
+    for (let i = 0; i < src.length; i++) {
+        out[i] = floatToHalf(src[i]);
+    }
+    return out;
+}
+//# sourceMappingURL=float-to-half.js.map

package/dist/graphics/rendering/ibl-render/ibl/float-to-half.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"float-to-half.js","sourceRoot":"","sources":["../../../../../src/graphics/rendering/ibl-render/ibl/float-to-half.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,2EAA2E;AAC3E,6EAA6E;AAC7E,4EAA4E;AAC5E,2DAA2D;AAE3D,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;AAChC,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAExC,MAAM,UAAU,WAAW,CAAC,KAAa;IACrC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IACf,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IAEpB,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC;IACnC,MAAM,MAAM,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,GAAG,QAAQ,CAAC;IAEjC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QAClB,mBAAmB;QACnB,OAAO,IAAI,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,GAAG,GAAG,CAAC;IACzB,IAAI,GAAG,IAAI,EAAE;QAAE,OAAO,IAAI,GAAG,MAAM,CAAC,CAAO,kBAAkB;IAC7D,IAAI,GAAG,GAAG,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC,CAAkB,iBAAiB;IAC9D,OAAO,IAAI,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,GAAiB;IAC9C,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,GAAG,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC"}

package/dist/graphics/rendering/ibl-render/ibl/ibl-math.wgsl.d.ts

@@ -0,0 +1,2 @@
+declare const _default: "\nconst PI: f32 = 3.14159265359;\n\nfn cube_uv_to_dir(face: u32, uv: vec2f) -> vec3f {\n    let p = uv * 2.0 - vec2f(1.0);\n    var dir: vec3f;\n    switch face {\n        case 0u: { dir = vec3f( 1.0, -p.y, -p.x); }\n        case 1u: { dir = vec3f(-1.0, -p.y,  p.x); }\n        case 2u: { dir = vec3f( p.x,  1.0,  p.y); }\n        case 3u: { dir = vec3f( p.x, -1.0, -p.y); }\n        case 4u: { dir = vec3f( p.x, -p.y,  1.0); }\n        default: { dir = vec3f(-p.x, -p.y, -1.0); }\n    }\n    return normalize(dir);\n}\n\nfn radical_inverse_vdc(bitsIn: u32) -> f32 {\n    var bits = bitsIn;\n    bits = (bits << 16u) | (bits >> 16u);\n    bits = ((bits & 0x55555555u) << 1u) | ((bits & 0xAAAAAAAAu) >> 1u);\n    bits = ((bits & 0x33333333u) << 2u) | ((bits & 0xCCCCCCCCu) >> 2u);\n    bits = ((bits & 0x0F0F0F0Fu) << 4u) | ((bits & 0xF0F0F0F0u) >> 4u);\n    bits = ((bits & 0x00FF00FFu) << 8u) | ((bits & 0xFF00FF00u) >> 8u);\n    return f32(bits) * 2.3283064365386963e-10;\n}\n\nfn hammersley(i: u32, n: u32) -> vec2f {\n    return vec2f(f32(i) / f32(n), radical_inverse_vdc(i));\n}\n\nfn importance_sample_ggx(xi: vec2f, N: vec3f, roughness: f32) -> vec3f {\n    let a = roughness * roughness;\n    let phi = 2.0 * PI * xi.x;\n    let cosTheta = sqrt((1.0 - xi.y) / (1.0 + (a * a - 1.0) * xi.y));\n    let sinTheta = sqrt(1.0 - cosTheta * cosTheta);\n    let H_tangent = vec3f(cos(phi) * sinTheta, sin(phi) * sinTheta, cosTheta);\n\n    let up = select(vec3f(0.0, 0.0, 1.0), vec3f(1.0, 0.0, 0.0), abs(N.z) < 0.999);\n    let tangent = normalize(cross(up, N));\n    let bitangent = cross(N, tangent);\n\n    return normalize(tangent * H_tangent.x + bitangent * H_tangent.y + N * H_tangent.z);\n}\n\nfn g_smith_ibl(nDotV: f32, nDotL: f32, roughness: f32) -> f32 {\n    let a = roughness;\n    let k = (a * a) / 2.0;\n    let gv = nDotV / (nDotV * (1.0 - k) + k);\n    let gl = nDotL / (nDotL * (1.0 - k) + k);\n    return gv * gl;\n}\n";
+export default _default;

package/dist/graphics/rendering/ibl-render/ibl/ibl-math.wgsl.js

@@ -0,0 +1,59 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+// Shared WGSL math for IBL precomputation passes.
+// - cube_uv_to_dir: WebGPU cube layer (face 0..5) + 2D uv → world-space direction
+// - hammersley / radical_inverse_vdc: low-discrepancy 2D sample sequence
+// - importance_sample_ggx: GGX-distributed half-vector in tangent space, returned in world space
+export default /* wgsl */ `
+const PI: f32 = 3.14159265359;
+
+fn cube_uv_to_dir(face: u32, uv: vec2f) -> vec3f {
+    let p = uv * 2.0 - vec2f(1.0);
+    var dir: vec3f;
+    switch face {
+        case 0u: { dir = vec3f( 1.0, -p.y, -p.x); }
+        case 1u: { dir = vec3f(-1.0, -p.y,  p.x); }
+        case 2u: { dir = vec3f( p.x,  1.0,  p.y); }
+        case 3u: { dir = vec3f( p.x, -1.0, -p.y); }
+        case 4u: { dir = vec3f( p.x, -p.y,  1.0); }
+        default: { dir = vec3f(-p.x, -p.y, -1.0); }
+    }
+    return normalize(dir);
+}
+
+fn radical_inverse_vdc(bitsIn: u32) -> f32 {
+    var bits = bitsIn;
+    bits = (bits << 16u) | (bits >> 16u);
+    bits = ((bits & 0x55555555u) << 1u) | ((bits & 0xAAAAAAAAu) >> 1u);
+    bits = ((bits & 0x33333333u) << 2u) | ((bits & 0xCCCCCCCCu) >> 2u);
+    bits = ((bits & 0x0F0F0F0Fu) << 4u) | ((bits & 0xF0F0F0F0u) >> 4u);
+    bits = ((bits & 0x00FF00FFu) << 8u) | ((bits & 0xFF00FF00u) >> 8u);
+    return f32(bits) * 2.3283064365386963e-10;
+}
+
+fn hammersley(i: u32, n: u32) -> vec2f {
+    return vec2f(f32(i) / f32(n), radical_inverse_vdc(i));
+}
+
+fn importance_sample_ggx(xi: vec2f, N: vec3f, roughness: f32) -> vec3f {
+    let a = roughness * roughness;
+    let phi = 2.0 * PI * xi.x;
+    let cosTheta = sqrt((1.0 - xi.y) / (1.0 + (a * a - 1.0) * xi.y));
+    let sinTheta = sqrt(1.0 - cosTheta * cosTheta);
+    let H_tangent = vec3f(cos(phi) * sinTheta, sin(phi) * sinTheta, cosTheta);
+
+    let up = select(vec3f(0.0, 0.0, 1.0), vec3f(1.0, 0.0, 0.0), abs(N.z) < 0.999);
+    let tangent = normalize(cross(up, N));
+    let bitangent = cross(N, tangent);
+
+    return normalize(tangent * H_tangent.x + bitangent * H_tangent.y + N * H_tangent.z);
+}
+
+fn g_smith_ibl(nDotV: f32, nDotL: f32, roughness: f32) -> f32 {
+    let a = roughness;
+    let k = (a * a) / 2.0;
+    let gv = nDotV / (nDotV * (1.0 - k) + k);
+    let gl = nDotL / (nDotL * (1.0 - k) + k);
+    return gv * gl;
+}
+`;
+//# sourceMappingURL=ibl-math.wgsl.js.map

package/dist/graphics/rendering/ibl-render/ibl/ibl-math.wgsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ibl-math.wgsl.js","sourceRoot":"","sources":["../../../../../src/graphics/rendering/ibl-render/ibl/ibl-math.wgsl.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,kDAAkD;AAClD,kFAAkF;AAClF,yEAAyE;AACzE,iGAAiG;AAEjG,eAAe,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoDzB,CAAC"}

package/dist/graphics/rendering/ibl-render/ibl/irradiance.d.ts

@@ -0,0 +1 @@
+export declare function generateIrradiance(device: GPUDevice, encoder: GPUCommandEncoder, envMap: GPUTexture, size: number): GPUTexture;

package/dist/graphics/rendering/ibl-render/ibl/irradiance.js

@@ -0,0 +1,94 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import iblMath from "./ibl-math.wgsl.js";
+import { createCubemap, cubeFaceView, cubemapSampleView, FULLSCREEN_VS } from "./render-helpers.js";
+// Cosine-weighted hemispherical Monte-Carlo convolution of the source
+// environment. With cos-weighted PDF, irradiance/π = mean(L(ωi)) — no extra
+// factor needed. 1024 samples is plenty for a 32x32 output.
+const IRRADIANCE_FS = /* wgsl */ `
+struct Params { face: u32, size: u32 };
+@group(0) @binding(0) var<uniform> params: Params;
+@group(0) @binding(1) var envMap: texture_cube<f32>;
+@group(0) @binding(2) var envSampler: sampler;
+
+const SAMPLES: u32 = 1024u;
+
+fn convolve(N: vec3f) -> vec3f {
+    let up = select(vec3f(0.0, 0.0, 1.0), vec3f(1.0, 0.0, 0.0), abs(N.z) < 0.999);
+    let tangent = normalize(cross(up, N));
+    let bitangent = cross(N, tangent);
+
+    var acc = vec3f(0.0);
+    for (var i = 0u; i < SAMPLES; i = i + 1u) {
+        let xi = hammersley(i, SAMPLES);
+        let phi = 2.0 * PI * xi.x;
+        let cosTheta = sqrt(xi.y);
+        let sinTheta = sqrt(1.0 - xi.y);
+        let local = vec3f(cos(phi) * sinTheta, sin(phi) * sinTheta, cosTheta);
+        let dir = normalize(tangent * local.x + bitangent * local.y + N * local.z);
+        acc = acc + textureSampleLevel(envMap, envSampler, dir, 0.0).rgb;
+    }
+    return acc / f32(SAMPLES);
+}
+
+@fragment
+fn fs_main(@builtin(position) frag: vec4f) -> @location(0) vec4f {
+    let uv = frag.xy / f32(params.size);
+    let N = cube_uv_to_dir(params.face, uv);
+    return vec4f(convolve(N), 1.0);
+}
+`;
+export function generateIrradiance(device, encoder, envMap, size) {
+    const format = "rgba16float";
+    const texture = createCubemap(device, size, format, 1);
+    const module = device.createShaderModule({ code: FULLSCREEN_VS + iblMath + IRRADIANCE_FS });
+    const bindGroupLayout = device.createBindGroupLayout({
+        entries: [
+            { binding: 0, visibility: GPUShaderStage.FRAGMENT, buffer: { type: "uniform" } },
+            { binding: 1, visibility: GPUShaderStage.FRAGMENT, texture: { sampleType: "float", viewDimension: "cube" } },
+            { binding: 2, visibility: GPUShaderStage.FRAGMENT, sampler: { type: "filtering" } },
+        ],
+    });
+    const pipeline = device.createRenderPipeline({
+        layout: device.createPipelineLayout({ bindGroupLayouts: [bindGroupLayout] }),
+        vertex: { module, entryPoint: "vs_fullscreen" },
+        fragment: { module, entryPoint: "fs_main", targets: [{ format }] },
+        primitive: { topology: "triangle-list" },
+    });
+    const sampler = device.createSampler({
+        magFilter: "linear",
+        minFilter: "linear",
+        addressModeU: "clamp-to-edge",
+        addressModeV: "clamp-to-edge",
+        addressModeW: "clamp-to-edge",
+    });
+    const envView = cubemapSampleView(envMap);
+    for (let face = 0; face < 6; face++) {
+        const ub = device.createBuffer({
+            size: 16,
+            usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+        });
+        device.queue.writeBuffer(ub, 0, new Uint32Array([face, size, 0, 0]));
+        const bindGroup = device.createBindGroup({
+            layout: bindGroupLayout,
+            entries: [
+                { binding: 0, resource: { buffer: ub } },
+                { binding: 1, resource: envView },
+                { binding: 2, resource: sampler },
+            ],
+        });
+        const pass = encoder.beginRenderPass({
+            colorAttachments: [{
+                    view: cubeFaceView(texture, face, 0),
+                    loadOp: "clear",
+                    storeOp: "store",
+                    clearValue: [0, 0, 0, 1],
+                }],
+        });
+        pass.setPipeline(pipeline);
+        pass.setBindGroup(0, bindGroup);
+        pass.draw(3);
+        pass.end();
+    }
+    return texture;
+}
+//# sourceMappingURL=irradiance.js.map

package/dist/graphics/rendering/ibl-render/ibl/irradiance.js.map

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

package/dist/graphics/rendering/ibl-render/ibl/parse-hdr.d.ts

@@ -0,0 +1,6 @@
+export interface ParsedHdr {
+    width: number;
+    height: number;
+    rgba: Float32Array;
+}
+export declare function parseHdr(buffer: ArrayBuffer): ParsedHdr;

package/dist/graphics/rendering/ibl-render/ibl/parse-hdr.js

@@ -0,0 +1,106 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export function parseHdr(buffer) {
+    const bytes = new Uint8Array(buffer);
+    // Header: ASCII, terminated by a blank line; then the resolution line.
+    const text = new TextDecoder("latin1").decode(bytes);
+    const headerEnd = text.indexOf("\n\n");
+    if (headerEnd < 0)
+        throw new Error("HDR: missing header terminator");
+    const header = text.slice(0, headerEnd);
+    if (!header.startsWith("#?RADIANCE") && !header.startsWith("#?RGBE")) {
+        throw new Error("HDR: unknown magic");
+    }
+    if (!/FORMAT=32-bit_rle_rgbe/i.test(header)) {
+        throw new Error("HDR: only 32-bit_rle_rgbe is supported");
+    }
+    // Resolution: e.g. "-Y 512 +X 1024". Negative Y means top-to-bottom.
+    const resStart = headerEnd + 2;
+    const newline = bytes.indexOf(0x0a, resStart);
+    const resLine = new TextDecoder().decode(bytes.subarray(resStart, newline));
+    const m = /([+-][YX])\s+(\d+)\s+([+-][YX])\s+(\d+)/.exec(resLine);
+    if (!m)
+        throw new Error(`HDR: bad resolution line "${resLine}"`);
+    const axisA = m[1], dimA = +m[2], axisB = m[3], dimB = +m[4];
+    // We only handle the common -Y +X / +Y +X orientations.
+    let width, height, flipY;
+    if (axisA[1] === "Y") {
+        height = dimA;
+        width = dimB;
+        flipY = axisA[0] === "+";
+    }
+    else {
+        width = dimA;
+        height = dimB;
+        flipY = axisB[0] === "+";
+    }
+    if (axisA[1] === axisB[1])
+        throw new Error("HDR: redundant axes");
+    const data = bytes.subarray(newline + 1);
+    let p = 0;
+    const rgba = new Float32Array(width * height * 4);
+    const scanline = new Uint8Array(width * 4);
+    for (let y = 0; y < height; y++) {
+        if (p + 4 > data.length)
+            throw new Error("HDR: truncated scanline header");
+        // RLE-encoded scanline: starts with 0x02 0x02 (hi lo) of width.
+        if (data[p] === 0x02 && data[p + 1] === 0x02 &&
+            ((data[p + 2] << 8) | data[p + 3]) === width &&
+            width >= 8 && width <= 0x7fff) {
+            p += 4;
+            for (let c = 0; c < 4; c++) {
+                let x = 0;
+                while (x < width) {
+                    if (p >= data.length)
+                        throw new Error("HDR: truncated RLE channel");
+                    const len = data[p++];
+                    if (len > 128) {
+                        const runLen = len - 128;
+                        if (p >= data.length || x + runLen > width)
+                            throw new Error("HDR: bad run");
+                        const val = data[p++];
+                        for (let i = 0; i < runLen; i++)
+                            scanline[(x + i) * 4 + c] = val;
+                        x += runLen;
+                    }
+                    else {
+                        if (p + len > data.length || x + len > width)
+                            throw new Error("HDR: bad literal");
+                        for (let i = 0; i < len; i++)
+                            scanline[(x + i) * 4 + c] = data[p + i];
+                        p += len;
+                        x += len;
+                    }
+                }
+            }
+        }
+        else {
+            // Old-style: raw RGBE pixels in raster order.
+            if (p + width * 4 > data.length)
+                throw new Error("HDR: truncated raw scanline");
+            scanline.set(data.subarray(p, p + width * 4));
+            p += width * 4;
+        }
+        const dstY = flipY ? height - 1 - y : y;
+        const rowOffset = dstY * width * 4;
+        for (let x = 0; x < width; x++) {
+            const r = scanline[x * 4];
+            const g = scanline[x * 4 + 1];
+            const b = scanline[x * 4 + 2];
+            const e = scanline[x * 4 + 3];
+            if (e === 0) {
+                rgba[rowOffset + x * 4 + 0] = 0;
+                rgba[rowOffset + x * 4 + 1] = 0;
+                rgba[rowOffset + x * 4 + 2] = 0;
+            }
+            else {
+                const scale = Math.pow(2, e - 128) / 256;
+                rgba[rowOffset + x * 4 + 0] = r * scale;
+                rgba[rowOffset + x * 4 + 1] = g * scale;
+                rgba[rowOffset + x * 4 + 2] = b * scale;
+            }
+            rgba[rowOffset + x * 4 + 3] = 1;
+        }
+    }
+    return { width, height, rgba };
+}
+//# sourceMappingURL=parse-hdr.js.map

package/dist/graphics/rendering/ibl-render/ibl/parse-hdr.js.map

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

package/dist/graphics/rendering/ibl-render/ibl/prefilter.d.ts

@@ -0,0 +1,5 @@
+export interface PrefilteredResult {
+    texture: GPUTexture;
+    mipLevelCount: number;
+}
+export declare function generatePrefiltered(device: GPUDevice, encoder: GPUCommandEncoder, envMap: GPUTexture, baseSize: number, mipLevelCount: number): PrefilteredResult;

package/dist/graphics/rendering/ibl-render/ibl/prefilter.js

@@ -0,0 +1,103 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import iblMath from "./ibl-math.wgsl.js";
+import { createCubemap, cubeFaceView, cubemapSampleView, FULLSCREEN_VS } from "./render-helpers.js";
+// Split-sum prefiltered specular: each mip stores GGX importance-sampled
+// reflections at a fixed roughness. Mip 0 = mirror (roughness 0), mip max =
+// fully blurred (roughness 1). Uses Karis' simplification of N == V == R.
+const PREFILTER_FS = /* wgsl */ `
+struct Params { face: u32, size: u32, roughness: f32, _pad: f32 };
+@group(0) @binding(0) var<uniform> params: Params;
+@group(0) @binding(1) var envMap: texture_cube<f32>;
+@group(0) @binding(2) var envSampler: sampler;
+
+const SAMPLES: u32 = 1024u;
+
+fn prefilter(N: vec3f) -> vec3f {
+    if (params.roughness < 0.001) {
+        return textureSampleLevel(envMap, envSampler, N, 0.0).rgb;
+    }
+    let V = N;
+    var color = vec3f(0.0);
+    var weight = 0.0;
+    for (var i = 0u; i < SAMPLES; i = i + 1u) {
+        let xi = hammersley(i, SAMPLES);
+        let H = importance_sample_ggx(xi, N, params.roughness);
+        let L = normalize(2.0 * dot(V, H) * H - V);
+        let nDotL = max(dot(N, L), 0.0);
+        if (nDotL > 0.0) {
+            color = color + textureSampleLevel(envMap, envSampler, L, 0.0).rgb * nDotL;
+            weight = weight + nDotL;
+        }
+    }
+    return color / max(weight, 0.0001);
+}
+
+@fragment
+fn fs_main(@builtin(position) frag: vec4f) -> @location(0) vec4f {
+    let uv = frag.xy / f32(params.size);
+    let N = cube_uv_to_dir(params.face, uv);
+    return vec4f(prefilter(N), 1.0);
+}
+`;
+export function generatePrefiltered(device, encoder, envMap, baseSize, mipLevelCount) {
+    const format = "rgba16float";
+    const texture = createCubemap(device, baseSize, format, mipLevelCount);
+    const module = device.createShaderModule({ code: FULLSCREEN_VS + iblMath + PREFILTER_FS });
+    const bindGroupLayout = device.createBindGroupLayout({
+        entries: [
+            { binding: 0, visibility: GPUShaderStage.FRAGMENT, buffer: { type: "uniform" } },
+            { binding: 1, visibility: GPUShaderStage.FRAGMENT, texture: { sampleType: "float", viewDimension: "cube" } },
+            { binding: 2, visibility: GPUShaderStage.FRAGMENT, sampler: { type: "filtering" } },
+        ],
+    });
+    const pipeline = device.createRenderPipeline({
+        layout: device.createPipelineLayout({ bindGroupLayouts: [bindGroupLayout] }),
+        vertex: { module, entryPoint: "vs_fullscreen" },
+        fragment: { module, entryPoint: "fs_main", targets: [{ format }] },
+        primitive: { topology: "triangle-list" },
+    });
+    const sampler = device.createSampler({
+        magFilter: "linear",
+        minFilter: "linear",
+        addressModeU: "clamp-to-edge",
+        addressModeV: "clamp-to-edge",
+        addressModeW: "clamp-to-edge",
+    });
+    const envView = cubemapSampleView(envMap);
+    for (let mip = 0; mip < mipLevelCount; mip++) {
+        const mipSize = Math.max(1, baseSize >> mip);
+        const roughness = mipLevelCount > 1 ? mip / (mipLevelCount - 1) : 0;
+        for (let face = 0; face < 6; face++) {
+            const ub = device.createBuffer({
+                size: 16,
+                usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+            });
+            const buf = new ArrayBuffer(16);
+            new Uint32Array(buf, 0, 2).set([face, mipSize]);
+            new Float32Array(buf, 8, 2).set([roughness, 0]);
+            device.queue.writeBuffer(ub, 0, buf);
+            const bindGroup = device.createBindGroup({
+                layout: bindGroupLayout,
+                entries: [
+                    { binding: 0, resource: { buffer: ub } },
+                    { binding: 1, resource: envView },
+                    { binding: 2, resource: sampler },
+                ],
+            });
+            const pass = encoder.beginRenderPass({
+                colorAttachments: [{
+                        view: cubeFaceView(texture, face, mip),
+                        loadOp: "clear",
+                        storeOp: "store",
+                        clearValue: [0, 0, 0, 1],
+                    }],
+            });
+            pass.setPipeline(pipeline);
+            pass.setBindGroup(0, bindGroup);
+            pass.draw(3);
+            pass.end();
+        }
+    }
+    return { texture, mipLevelCount };
+}
+//# sourceMappingURL=prefilter.js.map

package/dist/graphics/rendering/ibl-render/ibl/prefilter.js.map

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

package/dist/graphics/rendering/ibl-render/ibl/render-helpers.d.ts

@@ -0,0 +1,4 @@
+export { createCubemap } from "./create-cubemap.js";
+export { cubeFaceView } from "./cube-face-view.js";
+export { cubemapSampleView } from "./cubemap-sample-view.js";
+export declare const FULLSCREEN_VS = "\n@vertex\nfn vs_fullscreen(@builtin(vertex_index) i: u32) -> @builtin(position) vec4f {\n    let xs = array<f32, 3>(-1.0, 3.0, -1.0);\n    let ys = array<f32, 3>(-1.0, -1.0, 3.0);\n    return vec4f(xs[i], ys[i], 0.0, 1.0);\n}\n";