@adobe/data-gpu 0.9.69

package/dist/graphics/rendering/bone-collider-plugin.js

@@ -0,0 +1,207 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Database, Entity } from "@adobe/data/ecs";
+import { True } from "@adobe/data/schema";
+import { Vec3, Quat, Mat4x4 } from "@adobe/data/math";
+import { physicsData } from "../../physics/physics-data-plugin.js";
+import { jointData } from "../../physics/joint/joint-plugin.js";
+import { fitBoneCapsules } from "../../physics/ragdoll/fit-bone-capsules.js";
+import { ragdollTrigger } from "./ragdoll-trigger-plugin.js";
+import { pbrSkinning } from "./skinning/skinning-plugin.js";
+import { modelLoader } from "../scene/model/model-loader-plugin.js";
+import { transform } from "../scene/node/transform-plugin.js";
+/**
+ * boneColliders — fits a capsule to each bone of a skinned model and ragdolls it.
+ *
+ * **Alive:** once the skin loads, `fitBoneCapsules` gives a per-bone capsule
+ * (bone-local offset + dims); we spawn a **kinematic** capsule per bone and each
+ * frame drive it to `jointWorldMatrix · offset`, so the capsules track the
+ * animation and collide with the world.
+ *
+ * **Ragdoll** (`triggerRagdoll`): connect each capsule to its nearest
+ * capsule-bearing ancestor with a point joint (anchored at the shared joint), flip
+ * every capsule kinematic→dynamic, and stop the animation. Now physics drives the
+ * capsules; `reconcileRagdoll` writes each bone's pose *back* onto its skeleton
+ * joint (world → bone-local), so the skinned mesh goes limp and flops. (Anatomical
+ * cone limits + Jolt support are follow-ups; see physics/README.md.)
+ */
+/** Column-major rigid transform from a position + unit quaternion. */
+function compose(p, q) {
+    return Mat4x4.multiply(Mat4x4.translation(p[0], p[1], p[2]), Quat.toMat4([q[0], q[1], q[2], q[3]]));
+}
+/** Orthonormalised rotation of a column-major matrix, as a quaternion. */
+function rotationOf(m) {
+    let m00 = m[0], m10 = m[1], m20 = m[2], m01 = m[4], m11 = m[5], m21 = m[6], m02 = m[8], m12 = m[9], m22 = m[10];
+    const sx = Math.hypot(m00, m10, m20) || 1, sy = Math.hypot(m01, m11, m21) || 1, sz = Math.hypot(m02, m12, m22) || 1;
+    m00 /= sx;
+    m10 /= sx;
+    m20 /= sx;
+    m01 /= sy;
+    m11 /= sy;
+    m21 /= sy;
+    m02 /= sz;
+    m12 /= sz;
+    m22 /= sz;
+    const tr = m00 + m11 + m22;
+    if (tr > 0) {
+        const s = Math.sqrt(tr + 1) * 2;
+        return [(m21 - m12) / s, (m02 - m20) / s, (m10 - m01) / s, 0.25 * s];
+    }
+    if (m00 > m11 && m00 > m22) {
+        const s = Math.sqrt(1 + m00 - m11 - m22) * 2;
+        return [0.25 * s, (m01 + m10) / s, (m02 + m20) / s, (m21 - m12) / s];
+    }
+    if (m11 > m22) {
+        const s = Math.sqrt(1 + m11 - m00 - m22) * 2;
+        return [(m01 + m10) / s, 0.25 * s, (m12 + m21) / s, (m02 - m20) / s];
+    }
+    const s = Math.sqrt(1 + m22 - m00 - m11) * 2;
+    return [(m02 + m20) / s, (m12 + m21) / s, 0.25 * s, (m10 - m01) / s];
+}
+export const boneColliders = Database.Plugin.create({
+    extends: Database.Plugin.combine(physicsData, jointData, ragdollTrigger, pbrSkinning, modelLoader, transform),
+    components: {
+        _boneJoint: Entity.schema, // the skeleton joint this capsule tracks
+        _boneOffsetPos: Vec3.schema, // capsule offset in the bone's bind-local frame
+        _boneOffsetRot: Quat.schema,
+        _ragdollBuilt: True.schema, // tag: this skeleton's bone capsules have been generated
+    },
+    archetypes: {
+        // a kinematic capsule body bound to a skeleton joint (collisionGroup 1 ⇒ the
+        // ragdoll's bones never collide with each other, only the world)
+        BoneCapsule: ["bodyType", "colliderShape", "halfExtents", "material", "collisionGroup", "position", "rotation", "linearVelocity", "angularVelocity", "_boneJoint", "_boneOffsetPos", "_boneOffsetRot"],
+    },
+    systems: {
+        // Once a skeleton's skin has loaded, fit + spawn its bone capsules (one-time;
+        // tag + exclude). Tail→head since tagging the skeleton migrates its row.
+        generateBoneColliders: {
+            schedule: { during: ["postUpdate"] },
+            create: db => () => {
+                const material = Object.values(db.store.resources.materials)[0] ?? 0;
+                for (const arch of db.store.queryArchetypes(["_skeletonJoints", "_skeletonGeometry"], { exclude: ["_ragdollBuilt"] })) {
+                    const ids = arch.columns.id, jc = arch.columns._skeletonJoints, gc = arch.columns._skeletonGeometry;
+                    for (let i = arch.rowCount - 1; i >= 0; i--) {
+                        const skeleton = ids.get(i), joints = jc.get(i), geo = gc.get(i);
+                        const g = db.store.read(geo);
+                        if (!g?._cpuSkin || !g._skinInverseBindMatrices)
+                            continue; // skin not loaded yet
+                        for (const c of fitBoneCapsules({ jointCount: joints.length, inverseBindMatrices: g._skinInverseBindMatrices, skin: g._cpuSkin })) {
+                            db.store.archetypes.BoneCapsule.insert({
+                                bodyType: "kinematic", colliderShape: "capsule", halfExtents: [c.radius, c.halfHeight, 0], material, collisionGroup: 1,
+                                position: [0, 0, 0], rotation: [0, 0, 0, 1], linearVelocity: [0, 0, 0], angularVelocity: [0, 0, 0],
+                                _boneJoint: joints[c.jointIndex], _boneOffsetPos: c.offsetPosition, _boneOffsetRot: c.offsetRotation,
+                            });
+                        }
+                        db.store.update(skeleton, { _ragdollBuilt: true });
+                    }
+                }
+            },
+        },
+        // Alive: place every *kinematic* bone capsule at jointWorldMatrix · offset
+        // (the solver then kinematic-drives the engine body there). Dynamic capsules
+        // are ragdolling — physics owns them, so skip.
+        trackBoneColliders: {
+            schedule: { during: ["postUpdate"], after: ["generateBoneColliders", "transformSystem"] },
+            create: db => () => {
+                for (const arch of db.store.queryArchetypes(["_boneJoint", "_boneOffsetPos", "_boneOffsetRot", "bodyType", "position", "rotation"])) {
+                    const bj = arch.columns._boneJoint, op = arch.columns._boneOffsetPos, orot = arch.columns._boneOffsetRot, bt = arch.columns.bodyType;
+                    const posCol = arch.columns.position, rotCol = arch.columns.rotation;
+                    for (let i = 0; i < arch.rowCount; i++) {
+                        if (bt.get(i) === "dynamic")
+                            continue; // ragdolling — physics drives it
+                        const jw = db.store.get(bj.get(i), "_worldMatrix");
+                        if (!jw)
+                            continue;
+                        posCol.set(i, Mat4x4.multiplyVec3(jw, op.get(i)));
+                        rotCol.set(i, Quat.multiply(rotationOf(jw), orot.get(i)));
+                    }
+                }
+            },
+        },
+        // On trigger: joint each capsule to its nearest capsule-bearing ancestor (at
+        // the shared joint point, anchors from the current pose), flip every capsule
+        // to dynamic, and stop the animation. The solver flips the engine bodies and
+        // mirrors the joints; the root capsule (no ancestor) falls free, dragging the rest.
+        ragdollOnTrigger: {
+            schedule: { during: ["postUpdate"], after: ["trackBoneColliders"] },
+            create: db => () => {
+                if (!db.store.resources._ragdollTrigger)
+                    return;
+                db.store.resources._ragdollTrigger = false;
+                // joint entity → its capsule + current world pose + rotation
+                const byJoint = new Map();
+                for (const arch of db.store.queryArchetypes(["_boneJoint", "position", "rotation"])) {
+                    const ids = arch.columns.id, bj = arch.columns._boneJoint, pc = arch.columns.position, rc = arch.columns.rotation;
+                    for (let i = 0; i < arch.rowCount; i++) {
+                        const r = rc.get(i);
+                        byJoint.set(bj.get(i), { capsule: ids.get(i), world: compose(pc.get(i), r), rot: r });
+                    }
+                }
+                for (const arch of db.store.queryArchetypes(["_boneJoint", "position", "rotation"])) {
+                    const ids = arch.columns.id, bj = arch.columns._boneJoint, pc = arch.columns.position, rc = arch.columns.rotation;
+                    for (let i = 0; i < arch.rowCount; i++) {
+                        const joint = bj.get(i);
+                        // nearest ancestor joint that has a capsule
+                        let pj = db.store.get(joint, "parent") ?? 0;
+                        while (pj && !byJoint.has(pj))
+                            pj = db.store.get(pj, "parent") ?? 0;
+                        const parent = pj ? byJoint.get(pj) : undefined;
+                        if (!parent)
+                            continue; // root capsule: unconstrained
+                        const jw = db.store.get(joint, "_worldMatrix");
+                        const origin = jw ? [jw[12], jw[13], jw[14]] : [pc.get(i)[0], pc.get(i)[1], pc.get(i)[2]];
+                        const childRot = rc.get(i);
+                        const childWorld = compose(pc.get(i), childRot);
+                        // cone reference = the child bone's current axis (its capsule +Y), in the
+                        // parent's frame; the swing-twist joint then limits how far the bone can
+                        // deviate from this rest pose — anatomical limits, not a free ball.
+                        const boneDirWorld = Quat.rotateVec3(childRot, [0, 1, 0]);
+                        const axis = Quat.rotateVec3(Quat.inverse(parent.rot), boneDirWorld);
+                        db.store.archetypes.Joint.insert({
+                            jointType: "cone", jointBodyA: parent.capsule, jointBodyB: ids.get(i),
+                            jointAnchorA: Mat4x4.multiplyVec3(Mat4x4.inverse(parent.world), origin),
+                            jointAnchorB: Mat4x4.multiplyVec3(Mat4x4.inverse(childWorld), origin),
+                            jointAxis: axis, jointMinLimit: -0.5, jointMaxLimit: 0.5, jointSwingLimit: 0.9, // ~±29° twist, ~52° swing cone
+                        });
+                    }
+                }
+                for (const arch of db.store.queryArchetypes(["_boneJoint", "bodyType"])) {
+                    const ids = arch.columns.id;
+                    for (let i = 0; i < arch.rowCount; i++)
+                        db.store.update(ids.get(i), { bodyType: "dynamic" });
+                }
+                for (const arch of db.store.queryArchetypes(["animationPlaying"])) {
+                    const ids = arch.columns.id;
+                    for (let i = 0; i < arch.rowCount; i++)
+                        db.store.update(ids.get(i), { animationPlaying: false });
+                }
+            },
+        },
+        // Ragdolling: write each dynamic bone capsule's pose back onto its skeleton
+        // joint as a local TRS (jointWorld = capsuleWorld · offset⁻¹, then relative to
+        // the parent's world), so the skinned mesh follows the physics. Two passes so
+        // a child uses its parent's *capsule-derived* world, keeping the chain consistent.
+        reconcileRagdoll: {
+            schedule: { during: ["preRender"], after: ["transformSystem"] },
+            create: db => () => {
+                const jointWorld = new Map();
+                for (const arch of db.store.queryArchetypes(["_boneJoint", "_boneOffsetPos", "_boneOffsetRot", "bodyType", "position", "rotation"])) {
+                    const bj = arch.columns._boneJoint, op = arch.columns._boneOffsetPos, orot = arch.columns._boneOffsetRot, bt = arch.columns.bodyType, pc = arch.columns.position, rc = arch.columns.rotation;
+                    for (let i = 0; i < arch.rowCount; i++) {
+                        if (bt.get(i) !== "dynamic")
+                            continue;
+                        jointWorld.set(bj.get(i), Mat4x4.multiply(compose(pc.get(i), rc.get(i)), Mat4x4.inverse(compose(op.get(i), orot.get(i)))));
+                    }
+                }
+                if (jointWorld.size === 0)
+                    return;
+                for (const [joint, jw] of jointWorld) {
+                    const parent = db.store.get(joint, "parent") ?? 0;
+                    const parentW = jointWorld.get(parent) ?? (parent ? db.store.get(parent, "_worldMatrix") : undefined) ?? Mat4x4.identity;
+                    const local = Mat4x4.multiply(Mat4x4.inverse(parentW), jw);
+                    db.store.update(joint, { position: [local[12], local[13], local[14]], rotation: rotationOf(local) });
+                }
+            },
+        },
+    },
+});
+//# sourceMappingURL=bone-collider-plugin.js.map

package/dist/graphics/rendering/bone-collider-plugin.js.map

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

package/dist/graphics/rendering/display-transform-plugin.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The **display transform** seam — the pose a renderer should actually draw at,
+ * which may differ from the canonical `position`/`rotation` (the authoritative
+ * gameplay/sim state). When physics runs on a fixed clock faster or slower than
+ * the render rate, an interpolation pass writes the blended prev→current pose
+ * here each render frame so motion stays smooth; gameplay still reads the
+ * canonical pose.
+ *
+ * Both `_`-prefixed (derived, not authored). A renderer reads `_renderPosition`/
+ * `_renderRotation` *when present* and otherwise falls back to the canonical
+ * `position`/`rotation` — so this plugin is a pure, physics-free dependency:
+ * graphics-only scenes register the components (harmless, unused) and bodies that
+ * nothing interpolates simply never gain them. The producer is
+ * `interpolation-plugin` (physics → display); the consumer is any renderer.
+ */
+export declare const displayTransform: {
+    readonly components: {
+        readonly _renderPosition: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly minItems: 3;
+            readonly maxItems: 3;
+            readonly default: readonly [0, 0, 0];
+        };
+        readonly _renderRotation: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "number";
+                readonly precision: 1;
+                readonly default: number;
+            };
+            readonly minItems: 4;
+            readonly maxItems: 4;
+            readonly default: readonly [0, 0, 0, 1];
+            readonly interpolators: {
+                readonly linear: (q1: any, q2: any, t: number) => any;
+            };
+        };
+    };
+    readonly resources: {};
+    readonly archetypes: {};
+    readonly transactions: {};
+    readonly systems: import("@adobe/data/ecs").SystemDeclarations<never>;
+    readonly actions: {};
+    readonly services: {};
+    readonly computed: {};
+    readonly indexes: {};
+};

package/dist/graphics/rendering/display-transform-plugin.js

@@ -0,0 +1,25 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { Database } from "@adobe/data/ecs";
+import { Vec3, Quat } from "@adobe/data/math";
+/**
+ * The **display transform** seam — the pose a renderer should actually draw at,
+ * which may differ from the canonical `position`/`rotation` (the authoritative
+ * gameplay/sim state). When physics runs on a fixed clock faster or slower than
+ * the render rate, an interpolation pass writes the blended prev→current pose
+ * here each render frame so motion stays smooth; gameplay still reads the
+ * canonical pose.
+ *
+ * Both `_`-prefixed (derived, not authored). A renderer reads `_renderPosition`/
+ * `_renderRotation` *when present* and otherwise falls back to the canonical
+ * `position`/`rotation` — so this plugin is a pure, physics-free dependency:
+ * graphics-only scenes register the components (harmless, unused) and bodies that
+ * nothing interpolates simply never gain them. The producer is
+ * `interpolation-plugin` (physics → display); the consumer is any renderer.
+ */
+export const displayTransform = Database.Plugin.create({
+    components: {
+        _renderPosition: Vec3.schema, // derived: interpolated pose to render at (else use `position`)
+        _renderRotation: Quat.schema,
+    },
+});
+//# sourceMappingURL=display-transform-plugin.js.map

package/dist/graphics/rendering/display-transform-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display-transform-plugin.js","sourceRoot":"","sources":["../../../src/graphics/rendering/display-transform-plugin.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE9C;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;IACnD,UAAU,EAAE;QACR,eAAe,EAAE,IAAI,CAAC,MAAM,EAAE,gEAAgE;QAC9F,eAAe,EAAE,IAAI,CAAC,MAAM;KAC/B;CACJ,CAAC,CAAC"}

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

@@ -0,0 +1,2 @@
+declare const _default: "\nconst PI: f32 = 3.14159265359;\nconst MIN_ROUGHNESS: f32 = 0.04;\n\n// Trowbridge-Reitz / GGX normal distribution.\nfn d_ggx(nDotH: f32, alpha: f32) -> f32 {\n    let a2 = alpha * alpha;\n    let denom = nDotH * nDotH * (a2 - 1.0) + 1.0;\n    return a2 / (PI * denom * denom);\n}\n\n// Smith G with Schlick-GGX.\nfn g_smith(nDotV: f32, nDotL: f32, alpha: f32) -> f32 {\n    let k = (alpha + 1.0) * (alpha + 1.0) / 8.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\n// Schlick Fresnel.\nfn f_schlick(vDotH: f32, f0: vec3f) -> vec3f {\n    let f = pow(clamp(1.0 - vDotH, 0.0, 1.0), 5.0);\n    return f0 + (vec3f(1.0) - f0) * f;\n}\n\n// Roughness-aware Schlick for IBL: avoids over-strong rim at high roughness.\nfn f_schlick_roughness(nDotV: f32, f0: vec3f, roughness: f32) -> vec3f {\n    let r = vec3f(1.0 - roughness);\n    return f0 + (max(r, f0) - f0) * pow(max(1.0 - nDotV, 0.0), 5.0);\n}\n\n// Narkowicz ACES filmic tonemap fit. Cheap, looks clearly filmic.\nfn tone_map_aces(x: vec3f) -> vec3f {\n    let a = 2.51; let b = 0.03; let c = 2.43; let d = 0.59; let e = 0.14;\n    return clamp((x * (a * x + b)) / (x * (c * x + d) + e), vec3f(0.0), vec3f(1.0));\n}\n";
+export default _default;

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

@@ -0,0 +1,42 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+// Shared WGSL fragment: Cook-Torrance metallic-roughness BRDF building blocks.
+// Concatenated into the direct and (future) IBL shader modules so both paths
+// agree on the math.
+export default /* wgsl */ `
+const PI: f32 = 3.14159265359;
+const MIN_ROUGHNESS: f32 = 0.04;
+
+// Trowbridge-Reitz / GGX normal distribution.
+fn d_ggx(nDotH: f32, alpha: f32) -> f32 {
+    let a2 = alpha * alpha;
+    let denom = nDotH * nDotH * (a2 - 1.0) + 1.0;
+    return a2 / (PI * denom * denom);
+}
+
+// Smith G with Schlick-GGX.
+fn g_smith(nDotV: f32, nDotL: f32, alpha: f32) -> f32 {
+    let k = (alpha + 1.0) * (alpha + 1.0) / 8.0;
+    let gv = nDotV / (nDotV * (1.0 - k) + k);
+    let gl = nDotL / (nDotL * (1.0 - k) + k);
+    return gv * gl;
+}
+
+// Schlick Fresnel.
+fn f_schlick(vDotH: f32, f0: vec3f) -> vec3f {
+    let f = pow(clamp(1.0 - vDotH, 0.0, 1.0), 5.0);
+    return f0 + (vec3f(1.0) - f0) * f;
+}
+
+// Roughness-aware Schlick for IBL: avoids over-strong rim at high roughness.
+fn f_schlick_roughness(nDotV: f32, f0: vec3f, roughness: f32) -> vec3f {
+    let r = vec3f(1.0 - roughness);
+    return f0 + (max(r, f0) - f0) * pow(max(1.0 - nDotV, 0.0), 5.0);
+}
+
+// Narkowicz ACES filmic tonemap fit. Cheap, looks clearly filmic.
+fn tone_map_aces(x: vec3f) -> vec3f {
+    let a = 2.51; let b = 0.03; let c = 2.43; let d = 0.59; let e = 0.14;
+    return clamp((x * (a * x + b)) / (x * (c * x + d) + e), vec3f(0.0), vec3f(1.0));
+}
+`;
+//# sourceMappingURL=brdf.wgsl.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"brdf.wgsl.js","sourceRoot":"","sources":["../../../../src/graphics/rendering/ibl-render/brdf.wgsl.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,+EAA+E;AAC/E,6EAA6E;AAC7E,qBAAqB;AAErB,eAAe,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCzB,CAAC"}

package/dist/graphics/rendering/ibl-render/ibl/brdf-lut.d.ts

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

package/dist/graphics/rendering/ibl-render/ibl/brdf-lut.js

@@ -0,0 +1,91 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import iblMath from "./ibl-math.wgsl.js";
+import { FULLSCREEN_VS } from "./render-helpers.js";
+// Karis split-sum BRDF integration. Encodes the F0-independent part of the
+// specular IBL integral. Lookup is (NdotV, roughness) → (scale, bias) such
+// that specular_IBL = prefiltered * (F0 * scale + bias).
+const BRDF_LUT_FS = /* wgsl */ `
+struct Params { size: u32, _pad: u32, _pad2: u32, _pad3: u32 };
+@group(0) @binding(0) var<uniform> params: Params;
+
+const SAMPLES: u32 = 1024u;
+
+fn integrate(nDotV: f32, roughness: f32) -> vec2f {
+    let V = vec3f(sqrt(1.0 - nDotV * nDotV), 0.0, nDotV);
+    // N = (0,0,1): work directly in tangent space. importance_sample_ggx's
+    // TBN frame degenerates when N=(0,0,1), so we sample H inline here.
+    let a = roughness * roughness;
+
+    var A = 0.0;
+    var B = 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((1.0 - xi.y) / (1.0 + (a * a - 1.0) * xi.y));
+        let sinTheta = sqrt(1.0 - cosTheta * cosTheta);
+        let H = vec3f(cos(phi) * sinTheta, sin(phi) * sinTheta, cosTheta);
+        let L = normalize(2.0 * dot(V, H) * H - V);
+        let nDotL = max(L.z, 0.0);
+        let nDotH = max(H.z, 0.0);
+        let vDotH = max(dot(V, H), 0.0);
+        if (nDotL > 0.0) {
+            let G = g_smith_ibl(nDotV, nDotL, roughness);
+            let g_vis = (G * vDotH) / max(nDotH * nDotV, 0.0001);
+            let fc = pow(1.0 - vDotH, 5.0);
+            A = A + (1.0 - fc) * g_vis;
+            B = B + fc * g_vis;
+        }
+    }
+    return vec2f(A, B) / f32(SAMPLES);
+}
+
+@fragment
+fn fs_main(@builtin(position) frag: vec4f) -> @location(0) vec4f {
+    let uv = frag.xy / f32(params.size);
+    let nDotV = max(uv.x, 0.001);
+    let roughness = max(uv.y, 0.04);
+    let r = integrate(nDotV, roughness);
+    return vec4f(r, 0.0, 1.0);
+}
+`;
+export function generateBrdfLut(device, encoder, size = 256) {
+    const format = "rgba16float";
+    const texture = device.createTexture({
+        size: [size, size, 1],
+        format,
+        usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.RENDER_ATTACHMENT,
+    });
+    const module = device.createShaderModule({ code: FULLSCREEN_VS + iblMath + BRDF_LUT_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" },
+    });
+    const ub = device.createBuffer({
+        size: 16,
+        usage: GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST,
+    });
+    device.queue.writeBuffer(ub, 0, new Uint32Array([size, 0, 0, 0]));
+    const bindGroup = device.createBindGroup({
+        layout: bindGroupLayout,
+        entries: [{ binding: 0, resource: { buffer: ub } }],
+    });
+    const pass = encoder.beginRenderPass({
+        colorAttachments: [{
+                view: texture.createView(),
+                loadOp: "clear",
+                storeOp: "store",
+                clearValue: [0, 0, 0, 1],
+            }],
+    });
+    pass.setPipeline(pipeline);
+    pass.setBindGroup(0, bindGroup);
+    pass.draw(3);
+    pass.end();
+    return texture;
+}
+//# sourceMappingURL=brdf-lut.js.map

package/dist/graphics/rendering/ibl-render/ibl/brdf-lut.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brdf-lut.js","sourceRoot":"","sources":["../../../../../src/graphics/rendering/ibl-render/ibl/brdf-lut.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,OAAO,MAAM,oBAAoB,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,2EAA2E;AAC3E,2EAA2E;AAC3E,yDAAyD;AACzD,MAAM,WAAW,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2C9B,CAAC;AAEF,MAAM,UAAU,eAAe,CAC3B,MAAiB,EACjB,OAA0B,EAC1B,IAAI,GAAG,GAAG;IAEV,MAAM,MAAM,GAAqB,aAAa,CAAC;IAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,aAAa,CAAC;QACjC,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACrB,MAAM;QACN,KAAK,EAAE,eAAe,CAAC,eAAe,GAAG,eAAe,CAAC,iBAAiB;KAC7E,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,CAAC,kBAAkB,CAAC,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,GAAG,WAAW,EAAE,CAAC,CAAC;IAC1F,MAAM,eAAe,GAAG,MAAM,CAAC,qBAAqB,CAAC;QACjD,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,CAAC;KAC9F,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,MAAM,CAAC,oBAAoB,CAAC;QACzC,MAAM,EAAE,MAAM,CAAC,oBAAoB,CAAC,EAAE,gBAAgB,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC;QAC5E,MAAM,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE;QAC/C,QAAQ,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;QAClE,SAAS,EAAE,EAAE,QAAQ,EAAE,eAAe,EAAE;KAC3C,CAAC,CAAC;IAEH,MAAM,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC;QAC3B,IAAI,EAAE,EAAE;QACR,KAAK,EAAE,cAAc,CAAC,OAAO,GAAG,cAAc,CAAC,QAAQ;KAC1D,CAAC,CAAC;IACH,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,SAAS,GAAG,MAAM,CAAC,eAAe,CAAC;QACrC,MAAM,EAAE,eAAe;QACvB,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,CAAC;KACtD,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC;QACjC,gBAAgB,EAAE,CAAC;gBACf,IAAI,EAAE,OAAO,CAAC,UAAU,EAAE;gBAC1B,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,OAAO;gBAChB,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;aAC3B,CAAC;KACL,CAAC,CAAC;IACH,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC3B,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACb,IAAI,CAAC,GAAG,EAAE,CAAC;IAEX,OAAO,OAAO,CAAC;AACnB,CAAC"}

package/dist/graphics/rendering/ibl-render/ibl/build-ibl-resources.d.ts

@@ -0,0 +1,24 @@
+import type { ParsedHdr } from "./parse-hdr.js";
+export interface IblResources {
+    environment: GPUTexture;
+    irradiance: GPUTexture;
+    prefiltered: GPUTexture;
+    prefilteredMipCount: number;
+    brdfLut: GPUTexture;
+}
+export interface IblOptions {
+    environmentSize?: number;
+    irradianceSize?: number;
+    prefilteredSize?: number;
+    prefilteredMipCount?: number;
+    brdfLutSize?: number;
+    /** Equirectangular HDR source. When omitted, a procedural studio is used. */
+    hdrSource?: ParsedHdr;
+}
+/**
+ * Computes the four IBL maps used by the prefiltered split-sum approximation:
+ * source environment, diffuse irradiance, specular prefiltered (mip chain by
+ * roughness), and the BRDF integration LUT. Everything runs in one command
+ * buffer; the GPU sequences the dependencies internally.
+ */
+export declare function buildIblResources(device: GPUDevice, options?: IblOptions): IblResources;

package/dist/graphics/rendering/ibl-render/ibl/build-ibl-resources.js

@@ -0,0 +1,34 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+import { generateBrdfLut } from "./brdf-lut.js";
+import { generateEnvironment } from "./environment.js";
+import { generateIrradiance } from "./irradiance.js";
+import { generatePrefiltered } from "./prefilter.js";
+/**
+ * Computes the four IBL maps used by the prefiltered split-sum approximation:
+ * source environment, diffuse irradiance, specular prefiltered (mip chain by
+ * roughness), and the BRDF integration LUT. Everything runs in one command
+ * buffer; the GPU sequences the dependencies internally.
+ */
+export function buildIblResources(device, options = {}) {
+    const envSize = options.environmentSize ?? 512;
+    const irradianceSize = options.irradianceSize ?? 32;
+    const prefilteredSize = options.prefilteredSize ?? 256;
+    const prefilteredMipCount = options.prefilteredMipCount ?? 7;
+    const brdfLutSize = options.brdfLutSize ?? 256;
+    const encoder = device.createCommandEncoder({ label: "ibl-precompute" });
+    const environment = generateEnvironment(device, encoder, envSize, options.hdrSource);
+    const irradiance = generateIrradiance(device, encoder, environment, irradianceSize);
+    const prefiltered = generatePrefiltered(device, encoder, environment, prefilteredSize, prefilteredMipCount);
+    device.queue.submit([encoder.finish()]);
+    const brdfEncoder = device.createCommandEncoder({ label: "ibl-brdf-lut" });
+    const brdfLut = generateBrdfLut(device, brdfEncoder, brdfLutSize);
+    device.queue.submit([brdfEncoder.finish()]);
+    return {
+        environment,
+        irradiance,
+        prefiltered: prefiltered.texture,
+        prefilteredMipCount: prefiltered.mipLevelCount,
+        brdfLut,
+    };
+}
+//# sourceMappingURL=build-ibl-resources.js.map

package/dist/graphics/rendering/ibl-render/ibl/build-ibl-resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-ibl-resources.js","sourceRoot":"","sources":["../../../../../src/graphics/rendering/ibl-render/ibl/build-ibl-resources.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAoBrD;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAiB,EAAE,UAAsB,EAAE;IACzE,MAAM,OAAO,GAAG,OAAO,CAAC,eAAe,IAAI,GAAG,CAAC;IAC/C,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,EAAE,CAAC;IACpD,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,GAAG,CAAC;IACvD,MAAM,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,IAAI,CAAC,CAAC;IAC7D,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,GAAG,CAAC;IAE/C,MAAM,OAAO,GAAG,MAAM,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACzE,MAAM,WAAW,GAAG,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACrF,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;IACpF,MAAM,WAAW,GAAG,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,mBAAmB,CAAC,CAAC;IAC5G,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAExC,MAAM,WAAW,GAAG,MAAM,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;IAC3E,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC;IAClE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAE5C,OAAO;QACH,WAAW;QACX,UAAU;QACV,WAAW,EAAE,WAAW,CAAC,OAAO;QAChC,mBAAmB,EAAE,WAAW,CAAC,aAAa;QAC9C,OAAO;KACV,CAAC;AACN,CAAC"}

package/dist/graphics/rendering/ibl-render/ibl/create-cubemap.d.ts

@@ -0,0 +1 @@
+export declare function createCubemap(device: GPUDevice, size: number, format: GPUTextureFormat, mipLevelCount?: number): GPUTexture;

package/dist/graphics/rendering/ibl-render/ibl/create-cubemap.js

@@ -0,0 +1,12 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export function createCubemap(device, size, format, mipLevelCount = 1) {
+    return device.createTexture({
+        size: [size, size, 6],
+        format,
+        mipLevelCount,
+        usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.COPY_DST,
+        dimension: "2d",
+        textureBindingViewDimension: "cube",
+    });
+}
+//# sourceMappingURL=create-cubemap.js.map

package/dist/graphics/rendering/ibl-render/ibl/create-cubemap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-cubemap.js","sourceRoot":"","sources":["../../../../../src/graphics/rendering/ibl-render/ibl/create-cubemap.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,MAAM,UAAU,aAAa,CACzB,MAAiB,EACjB,IAAY,EACZ,MAAwB,EACxB,aAAa,GAAG,CAAC;IAEjB,OAAO,MAAM,CAAC,aAAa,CAAC;QACxB,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACrB,MAAM;QACN,aAAa;QACb,KAAK,EAAE,eAAe,CAAC,eAAe,GAAG,eAAe,CAAC,iBAAiB,GAAG,eAAe,CAAC,QAAQ;QACrG,SAAS,EAAE,IAAI;QACf,2BAA2B,EAAE,MAAM;KACtC,CAAC,CAAC;AACP,CAAC"}

package/dist/graphics/rendering/ibl-render/ibl/cube-face-view.d.ts

@@ -0,0 +1 @@
+export declare function cubeFaceView(texture: GPUTexture, face: number, mip?: number): GPUTextureView;

package/dist/graphics/rendering/ibl-render/ibl/cube-face-view.js

@@ -0,0 +1,11 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export function cubeFaceView(texture, face, mip = 0) {
+    return texture.createView({
+        dimension: "2d",
+        baseArrayLayer: face,
+        arrayLayerCount: 1,
+        baseMipLevel: mip,
+        mipLevelCount: 1,
+    });
+}
+//# sourceMappingURL=cube-face-view.js.map

package/dist/graphics/rendering/ibl-render/ibl/cube-face-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cube-face-view.js","sourceRoot":"","sources":["../../../../../src/graphics/rendering/ibl-render/ibl/cube-face-view.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,MAAM,UAAU,YAAY,CAAC,OAAmB,EAAE,IAAY,EAAE,GAAG,GAAG,CAAC;IACnE,OAAO,OAAO,CAAC,UAAU,CAAC;QACtB,SAAS,EAAE,IAAI;QACf,cAAc,EAAE,IAAI;QACpB,eAAe,EAAE,CAAC;QAClB,YAAY,EAAE,GAAG;QACjB,aAAa,EAAE,CAAC;KACnB,CAAC,CAAC;AACP,CAAC"}

package/dist/graphics/rendering/ibl-render/ibl/cubemap-sample-view.d.ts

@@ -0,0 +1 @@
+export declare function cubemapSampleView(texture: GPUTexture): GPUTextureView;

package/dist/graphics/rendering/ibl-render/ibl/cubemap-sample-view.js

@@ -0,0 +1,9 @@
+// © 2026 Adobe. MIT License. See /LICENSE for details.
+export function cubemapSampleView(texture) {
+    return texture.createView({
+        dimension: "cube",
+        baseArrayLayer: 0,
+        arrayLayerCount: 6,
+    });
+}
+//# sourceMappingURL=cubemap-sample-view.js.map

package/dist/graphics/rendering/ibl-render/ibl/cubemap-sample-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cubemap-sample-view.js","sourceRoot":"","sources":["../../../../../src/graphics/rendering/ibl-render/ibl/cubemap-sample-view.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,MAAM,UAAU,iBAAiB,CAAC,OAAmB;IACjD,OAAO,OAAO,CAAC,UAAU,CAAC;QACtB,SAAS,EAAE,MAAM;QACjB,cAAc,EAAE,CAAC;QACjB,eAAe,EAAE,CAAC;KACrB,CAAC,CAAC;AACP,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { ParsedHdr } from "./parse-hdr.js";
+/**
+ * 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 declare function generateEnvironment(device: GPUDevice, encoder: GPUCommandEncoder, size: number, hdr?: ParsedHdr): GPUTexture;