@aura3d/engine 3.0.0 → 4.0.0

package/dist/rendering/shaders/physical-wgsl/index.js

@@ -0,0 +1,51 @@
+/**
+ * WGSL twins of the PRD-04 physical-lobe chunks (PRD-04 §8.12, P6-1).
+ *
+ * One module per `shaders/physical/*.glsl.ts` chunk, exporting the WGSL body
+ * string that the chunk attaches as `ShaderChunk.wgsl`. The twins keep the
+ * same `a3d_` names and identical math; differences are WGSL-structural only
+ * (`ptr<function>` for out params, `texture_2d`+`sampler` split bindings,
+ * `textureSampleLevel` LOD, `dpdx`/`dpdy` derivatives, `mat3x3f` per-slot
+ * transforms in material uniform structs).
+ *
+ * Dependencies mirror the GLSL `requires` graph: `brdf` shim helpers
+ * (`pow2`, `pow2v`, `F_Schlick`, `Schlick_to_F0`, `V_GGX_SmithCorrelated`,
+ * `D_GGX`, `a3dDFG`, `max3`, `PI`, `RECIPROCAL_PI`, `EPSILON`) are provided by
+ * the PRD-11 brdf WGSL twin when C-29 lands — until then the test shim
+ * (`tests/qr/prd04/shims/brdf_r185.wgsl.ts`) resolves them for validation.
+ */
+import A3D_PRD04_BSDF_LOBES_COMMON_WGSL from "./bsdf_lobes_common.wgsl.js";
+import A3D_PRD04_SPECULAR_IOR_WGSL from "./specular_ior.wgsl.js";
+import A3D_PRD04_CLEARCOAT_WGSL from "./clearcoat.wgsl.js";
+import A3D_PRD04_SHEEN_WGSL from "./sheen.wgsl.js";
+import A3D_PRD04_IRIDESCENCE_WGSL from "./iridescence.wgsl.js";
+import A3D_PRD04_ANISOTROPY_WGSL from "./anisotropy.wgsl.js";
+import A3D_PRD04_TRANSMISSION_WGSL from "./transmission.wgsl.js";
+import A3D_PRD04_VOLUME_WGSL from "./volume.wgsl.js";
+import A3D_PRD04_DISPERSION_WGSL from "./dispersion.wgsl.js";
+import A3D_PRD04_EMISSIVE_STRENGTH_WGSL from "./emissive_strength.wgsl.js";
+import A3D_PRD04_UNLIT_WGSL from "./unlit.wgsl.js";
+import A3D_PRD04_TANGENT_FRAME_WGSL from "./tangent_frame.wgsl.js";
+import A3D_PRD04_UV_TRANSFORM_WGSL from "./uv_transform.wgsl.js";
+import A3D_PRD04_ALPHA_A2C_WGSL from "./alpha_a2c.wgsl.js";
+import A3D_PRD04_DEBUG_VIEW_WGSL from "./debug_view.wgsl.js";
+/** chunk name → WGSL twin body, mirroring PRD04_SHADER_CHUNKS. */
+export const PRD04_WGSL_TWINS = {
+    a3d_prd04_bsdf_lobes_common: A3D_PRD04_BSDF_LOBES_COMMON_WGSL,
+    a3d_prd04_specular_ior: A3D_PRD04_SPECULAR_IOR_WGSL,
+    a3d_prd04_clearcoat: A3D_PRD04_CLEARCOAT_WGSL,
+    a3d_prd04_sheen: A3D_PRD04_SHEEN_WGSL,
+    a3d_prd04_iridescence: A3D_PRD04_IRIDESCENCE_WGSL,
+    a3d_prd04_anisotropy: A3D_PRD04_ANISOTROPY_WGSL,
+    a3d_prd04_transmission: A3D_PRD04_TRANSMISSION_WGSL,
+    a3d_prd04_volume: A3D_PRD04_VOLUME_WGSL,
+    a3d_prd04_dispersion: A3D_PRD04_DISPERSION_WGSL,
+    a3d_prd04_emissive_strength: A3D_PRD04_EMISSIVE_STRENGTH_WGSL,
+    a3d_prd04_unlit: A3D_PRD04_UNLIT_WGSL,
+    a3d_prd04_tangent_frame: A3D_PRD04_TANGENT_FRAME_WGSL,
+    a3d_prd04_uv_transform: A3D_PRD04_UV_TRANSFORM_WGSL,
+    a3d_prd04_alpha_a2c: A3D_PRD04_ALPHA_A2C_WGSL,
+    a3d_prd04_debug_view: A3D_PRD04_DEBUG_VIEW_WGSL
+};
+export { A3D_PRD04_BSDF_LOBES_COMMON_WGSL, A3D_PRD04_SPECULAR_IOR_WGSL, A3D_PRD04_CLEARCOAT_WGSL, A3D_PRD04_SHEEN_WGSL, A3D_PRD04_IRIDESCENCE_WGSL, A3D_PRD04_ANISOTROPY_WGSL, A3D_PRD04_TRANSMISSION_WGSL, A3D_PRD04_VOLUME_WGSL, A3D_PRD04_DISPERSION_WGSL, A3D_PRD04_EMISSIVE_STRENGTH_WGSL, A3D_PRD04_UNLIT_WGSL, A3D_PRD04_TANGENT_FRAME_WGSL, A3D_PRD04_UV_TRANSFORM_WGSL, A3D_PRD04_ALPHA_A2C_WGSL, A3D_PRD04_DEBUG_VIEW_WGSL };
+//# sourceMappingURL=index.js.map

package/dist/rendering/shaders/physical-wgsl/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/shaders/physical-wgsl/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,gCAAgC,MAAM,6BAA6B,CAAC;AAC3E,OAAO,2BAA2B,MAAM,wBAAwB,CAAC;AACjE,OAAO,wBAAwB,MAAM,qBAAqB,CAAC;AAC3D,OAAO,oBAAoB,MAAM,iBAAiB,CAAC;AACnD,OAAO,0BAA0B,MAAM,uBAAuB,CAAC;AAC/D,OAAO,yBAAyB,MAAM,sBAAsB,CAAC;AAC7D,OAAO,2BAA2B,MAAM,wBAAwB,CAAC;AACjE,OAAO,qBAAqB,MAAM,kBAAkB,CAAC;AACrD,OAAO,yBAAyB,MAAM,sBAAsB,CAAC;AAC7D,OAAO,gCAAgC,MAAM,6BAA6B,CAAC;AAC3E,OAAO,oBAAoB,MAAM,iBAAiB,CAAC;AACnD,OAAO,4BAA4B,MAAM,yBAAyB,CAAC;AACnE,OAAO,2BAA2B,MAAM,wBAAwB,CAAC;AACjE,OAAO,wBAAwB,MAAM,qBAAqB,CAAC;AAC3D,OAAO,yBAAyB,MAAM,sBAAsB,CAAC;AAE7D,kEAAkE;AAClE,MAAM,CAAC,MAAM,gBAAgB,GAAqC;IACjE,2BAA2B,EAAE,gCAAgC;IAC7D,sBAAsB,EAAE,2BAA2B;IACnD,mBAAmB,EAAE,wBAAwB;IAC7C,eAAe,EAAE,oBAAoB;IACrC,qBAAqB,EAAE,0BAA0B;IACjD,oBAAoB,EAAE,yBAAyB;IAC/C,sBAAsB,EAAE,2BAA2B;IACnD,gBAAgB,EAAE,qBAAqB;IACvC,oBAAoB,EAAE,yBAAyB;IAC/C,2BAA2B,EAAE,gCAAgC;IAC7D,eAAe,EAAE,oBAAoB;IACrC,uBAAuB,EAAE,4BAA4B;IACrD,sBAAsB,EAAE,2BAA2B;IACnD,mBAAmB,EAAE,wBAAwB;IAC7C,oBAAoB,EAAE,yBAAyB;CAC/C,CAAC;AAEF,OAAO,EACN,gCAAgC,EAChC,2BAA2B,EAC3B,wBAAwB,EACxB,oBAAoB,EACpB,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,EAC3B,qBAAqB,EACrB,yBAAyB,EACzB,gCAAgC,EAChC,oBAAoB,EACpB,4BAA4B,EAC5B,2BAA2B,EAC3B,wBAAwB,EACxB,yBAAyB,EACzB,CAAC"}

package/dist/rendering/shaders/physical-wgsl/iridescence.wgsl.d.ts

@@ -0,0 +1,9 @@
+/**
+ * WGSL twin of a3d_prd04_iridescence (PRD-04 §8.12): same `a3d_` names,
+ * identical math (r185 iridescence_fragment.glsl.js:5-116,
+ * lights_physical_fragment.glsl.js:88-109, lights_fragment_begin.glsl.js:30-50).
+ */
+declare const wgsl = "\nconst a3d_prd04_XYZ_TO_REC709 = mat3x3f(\n\tvec3f( 3.2404542, -0.9692660,  0.0556434),\n\tvec3f(-1.5371385,  1.8760108, -0.2040259),\n\tvec3f(-0.4985314,  0.0415560,  1.0572252)\n);\n\n// Fresnel0 -> IOR (r185 iridescence_fragment.glsl.js:14-19).\nfn a3dPrd04IridescenceFresnel0ToIor(fresnel0: vec3f) -> vec3f {\n\tlet sqrtF0 = sqrt(fresnel0);\n\treturn (vec3f(1.0) + sqrtF0) / (vec3f(1.0) - sqrtF0);\n}\n\nfn a3dPrd04IridescenceIorToFresnel0(transmittedIor: vec3f, incidentIor: f32) -> vec3f {\n\treturn pow2v((transmittedIor - vec3f(incidentIor)) / (transmittedIor + vec3f(incidentIor)));\n}\n\nfn a3dPrd04IridescenceIorToFresnel0f(transmittedIor: f32, incidentIor: f32) -> f32 {\n\treturn pow2((transmittedIor - incidentIor) / (transmittedIor + incidentIor));\n}\n\n// XYZ sensitivity curves in Fourier space \u2014 Belcour & Barla 2017\n// (r185 evalSensitivity, iridescence_fragment.glsl.js:38-52).\nfn a3dPrd04EvalSensitivity(OPD: f32, shift: vec3f) -> vec3f {\n\tlet phase = 2.0 * PI * OPD * 1.0e-9;\n\tlet val = vec3f(5.4856e-13, 4.4201e-13, 5.2481e-13);\n\tlet pos = vec3f(1.6810e+06, 1.7953e+06, 2.2084e+06);\n\tlet var_ = vec3f(4.3278e+09, 9.3046e+09, 6.6121e+09);\n\n\tvar xyz = val * sqrt(2.0 * PI * var_) * cos(pos * phase + shift) * exp(-pow2(phase) * var_);\n\txyz.x += 9.7470e-14 * sqrt(2.0 * PI * 4.5282e+09) * cos(2.2399e+06 * phase + shift[0]) * exp(-4.5282e+09 * pow2(phase));\n\txyz /= 1.0685e-7;\n\n\tlet rgb = a3d_prd04_XYZ_TO_REC709 * xyz;\n\treturn rgb;\n}\n\n// Thin-film Fresnel (r185 evalIridescence, iridescence_fragment.glsl.js:54-116).\nfn a3dPrd04EvalIridescence(outsideIOR: f32, eta2: f32, cosTheta1: f32, thinFilmThickness: f32, baseF0: vec3f) -> vec3f {\n\tvar I: vec3f;\n\n\t// Force iridescenceIOR -> outsideIOR when thinFilmThickness -> 0.0\n\tlet iridescenceIOR = mix(outsideIOR, eta2, smoothstep(0.0, 0.03, thinFilmThickness));\n\t// Evaluate the cosTheta on the base layer (Snell law)\n\tlet sinTheta2Sq = pow2(outsideIOR / iridescenceIOR) * (1.0 - pow2(cosTheta1));\n\n\t// Handle TIR:\n\tlet cosTheta2Sq = 1.0 - sinTheta2Sq;\n\tif (cosTheta2Sq < 0.0) {\n\t\treturn vec3f(1.0);\n\t}\n\n\tlet cosTheta2 = sqrt(cosTheta2Sq);\n\n\t// First interface\n\tlet R0 = a3dPrd04IridescenceIorToFresnel0f(iridescenceIOR, outsideIOR);\n\tlet R12 = F_Schlick(vec3f(R0), 1.0, cosTheta1).x;\n\tlet T121 = 1.0 - R12;\n\tvar phi12 = 0.0;\n\tif (iridescenceIOR < outsideIOR) {\n\t\tphi12 = PI;\n\t}\n\tlet phi21 = PI - phi12;\n\n\t// Second interface\n\tlet baseIOR = a3dPrd04IridescenceFresnel0ToIor(clamp(baseF0, vec3f(0.0), vec3f(0.9999))); // guard against 1.0\n\tlet R1 = a3dPrd04IridescenceIorToFresnel0(baseIOR, iridescenceIOR);\n\tlet R23 = F_Schlick(R1, 1.0, cosTheta2);\n\tvar phi23 = vec3f(0.0);\n\tif (baseIOR[0] < iridescenceIOR) {\n\t\tphi23[0] = PI;\n\t}\n\tif (baseIOR[1] < iridescenceIOR) {\n\t\tphi23[1] = PI;\n\t}\n\tif (baseIOR[2] < iridescenceIOR) {\n\t\tphi23[2] = PI;\n\t}\n\n\t// Phase shift\n\tlet OPD = 2.0 * iridescenceIOR * thinFilmThickness * cosTheta2;\n\tlet phi = vec3f(phi21) + phi23;\n\n\t// Compound terms\n\tlet R123 = clamp(R12 * R23, vec3f(1e-5), vec3f(0.9999));\n\tlet r123 = sqrt(R123);\n\tlet Rs = pow2(T121) * R23 / (vec3f(1.0) - R123);\n\n\t// Reflectance term for m = 0 (DC term amplitude)\n\tlet C0 = R12 + Rs;\n\tI = C0;\n\n\t// Reflectance term for m > 0 (pairs of diracs)\n\tvar Cm = Rs - T121;\n\tfor (var m = 1; m <= 2; m++) {\n\t\tCm *= r123;\n\t\tlet Sm = 2.0 * a3dPrd04EvalSensitivity(f32(m) * OPD, f32(m) * phi);\n\t\tI += Cm * Sm;\n\t}\n\n\t// Since out of gamut colors might be produced, negative color values are clamped to 0.\n\treturn max(I, vec3f(0.0));\n}\n\n// Factor resolution (r185 lights_physical_fragment.glsl.js:88-109 +\n// lights_fragment_begin.glsl.js:30-40).\nfn a3dPrd04IridescenceInit(lobes: ptr<function, A3DPrd04Lobes>, iridescenceFactor: f32, iridescenceIOR: f32, iridescenceTex: vec4f, thicknessTex: vec4f, thicknessMin: f32, thicknessMax: f32, specularColor: vec3f, diffuseColor: vec3f, metalness: f32, dotNV: f32) {\n\t(*lobes).iridescence = iridescenceFactor * iridescenceTex.r;\n\t(*lobes).iridescenceIOR = iridescenceIOR;\n\t(*lobes).iridescenceThickness = (thicknessMax - thicknessMin) * thicknessTex.g + thicknessMin;\n\n\tif ((*lobes).iridescenceThickness == 0.0) {\n\t\t(*lobes).iridescence = 0.0;\n\t} else {\n\t\t(*lobes).iridescence = saturate((*lobes).iridescence);\n\t}\n\n\tif ((*lobes).iridescence > 0.0) {\n\t\tlet fresnelDielectric = a3dPrd04EvalIridescence(1.0, (*lobes).iridescenceIOR, dotNV, (*lobes).iridescenceThickness, specularColor);\n\t\tlet fresnelMetallic = a3dPrd04EvalIridescence(1.0, (*lobes).iridescenceIOR, dotNV, (*lobes).iridescenceThickness, diffuseColor);\n\n\t\t(*lobes).iridescenceFresnel = mix(fresnelDielectric, fresnelMetallic, metalness);\n\t\t(*lobes).iridescenceF0 = Schlick_to_F0((*lobes).iridescenceFresnel, 1.0, dotNV);\n\t} else {\n\t\t(*lobes).iridescenceFresnel = vec3f(0.0);\n\t\t(*lobes).iridescenceF0 = vec3f(0.0);\n\t}\n}\n\n// Direct-lobe Fresnel blend (r185 lights_physical_pars_fragment.glsl.js:170-174).\nfn a3dPrd04IridescenceFresnelMix(F: vec3f, iridescenceFresnel: vec3f, iridescence: f32) -> vec3f {\n\treturn mix(F, iridescenceFresnel, iridescence);\n}\n\n// IBL multiscattering with thin-film F0 (r185 computeMultiscatteringIridescence,\n// lights_physical_pars_fragment.glsl.js:389-419).\nfn a3dPrd04ComputeMultiscatteringIridescence(normal: vec3f, viewDir: vec3f, specularColor: vec3f, specularF90: f32, iridescence: f32, iridescenceF0: vec3f, roughness: f32, singleScatter: ptr<function, vec3f>, multiScatter: ptr<function, vec3f>) {\n\tlet dotNV = saturate(dot(normal, viewDir));\n\tlet fab = a3dDFG(roughness, dotNV);\n\n\tlet Fr = mix(specularColor, iridescenceF0, iridescence);\n\n\tlet FssEss = Fr * fab.x + specularF90 * fab.y;\n\n\tlet Ess = fab.x + fab.y;\n\tlet Ems = 1.0 - Ess;\n\n\tlet Favg = Fr + (1.0 - Fr) * 0.047619; // 1/21\n\tlet Fms = FssEss * Favg / (1.0 - Ems * Favg);\n\n\t*singleScatter += FssEss;\n\t*multiScatter += Fms * Ems;\n}\n";
+export declare const A3D_PRD04_IRIDESCENCE_WGSL = "\nconst a3d_prd04_XYZ_TO_REC709 = mat3x3f(\n\tvec3f( 3.2404542, -0.9692660,  0.0556434),\n\tvec3f(-1.5371385,  1.8760108, -0.2040259),\n\tvec3f(-0.4985314,  0.0415560,  1.0572252)\n);\n\n// Fresnel0 -> IOR (r185 iridescence_fragment.glsl.js:14-19).\nfn a3dPrd04IridescenceFresnel0ToIor(fresnel0: vec3f) -> vec3f {\n\tlet sqrtF0 = sqrt(fresnel0);\n\treturn (vec3f(1.0) + sqrtF0) / (vec3f(1.0) - sqrtF0);\n}\n\nfn a3dPrd04IridescenceIorToFresnel0(transmittedIor: vec3f, incidentIor: f32) -> vec3f {\n\treturn pow2v((transmittedIor - vec3f(incidentIor)) / (transmittedIor + vec3f(incidentIor)));\n}\n\nfn a3dPrd04IridescenceIorToFresnel0f(transmittedIor: f32, incidentIor: f32) -> f32 {\n\treturn pow2((transmittedIor - incidentIor) / (transmittedIor + incidentIor));\n}\n\n// XYZ sensitivity curves in Fourier space \u2014 Belcour & Barla 2017\n// (r185 evalSensitivity, iridescence_fragment.glsl.js:38-52).\nfn a3dPrd04EvalSensitivity(OPD: f32, shift: vec3f) -> vec3f {\n\tlet phase = 2.0 * PI * OPD * 1.0e-9;\n\tlet val = vec3f(5.4856e-13, 4.4201e-13, 5.2481e-13);\n\tlet pos = vec3f(1.6810e+06, 1.7953e+06, 2.2084e+06);\n\tlet var_ = vec3f(4.3278e+09, 9.3046e+09, 6.6121e+09);\n\n\tvar xyz = val * sqrt(2.0 * PI * var_) * cos(pos * phase + shift) * exp(-pow2(phase) * var_);\n\txyz.x += 9.7470e-14 * sqrt(2.0 * PI * 4.5282e+09) * cos(2.2399e+06 * phase + shift[0]) * exp(-4.5282e+09 * pow2(phase));\n\txyz /= 1.0685e-7;\n\n\tlet rgb = a3d_prd04_XYZ_TO_REC709 * xyz;\n\treturn rgb;\n}\n\n// Thin-film Fresnel (r185 evalIridescence, iridescence_fragment.glsl.js:54-116).\nfn a3dPrd04EvalIridescence(outsideIOR: f32, eta2: f32, cosTheta1: f32, thinFilmThickness: f32, baseF0: vec3f) -> vec3f {\n\tvar I: vec3f;\n\n\t// Force iridescenceIOR -> outsideIOR when thinFilmThickness -> 0.0\n\tlet iridescenceIOR = mix(outsideIOR, eta2, smoothstep(0.0, 0.03, thinFilmThickness));\n\t// Evaluate the cosTheta on the base layer (Snell law)\n\tlet sinTheta2Sq = pow2(outsideIOR / iridescenceIOR) * (1.0 - pow2(cosTheta1));\n\n\t// Handle TIR:\n\tlet cosTheta2Sq = 1.0 - sinTheta2Sq;\n\tif (cosTheta2Sq < 0.0) {\n\t\treturn vec3f(1.0);\n\t}\n\n\tlet cosTheta2 = sqrt(cosTheta2Sq);\n\n\t// First interface\n\tlet R0 = a3dPrd04IridescenceIorToFresnel0f(iridescenceIOR, outsideIOR);\n\tlet R12 = F_Schlick(vec3f(R0), 1.0, cosTheta1).x;\n\tlet T121 = 1.0 - R12;\n\tvar phi12 = 0.0;\n\tif (iridescenceIOR < outsideIOR) {\n\t\tphi12 = PI;\n\t}\n\tlet phi21 = PI - phi12;\n\n\t// Second interface\n\tlet baseIOR = a3dPrd04IridescenceFresnel0ToIor(clamp(baseF0, vec3f(0.0), vec3f(0.9999))); // guard against 1.0\n\tlet R1 = a3dPrd04IridescenceIorToFresnel0(baseIOR, iridescenceIOR);\n\tlet R23 = F_Schlick(R1, 1.0, cosTheta2);\n\tvar phi23 = vec3f(0.0);\n\tif (baseIOR[0] < iridescenceIOR) {\n\t\tphi23[0] = PI;\n\t}\n\tif (baseIOR[1] < iridescenceIOR) {\n\t\tphi23[1] = PI;\n\t}\n\tif (baseIOR[2] < iridescenceIOR) {\n\t\tphi23[2] = PI;\n\t}\n\n\t// Phase shift\n\tlet OPD = 2.0 * iridescenceIOR * thinFilmThickness * cosTheta2;\n\tlet phi = vec3f(phi21) + phi23;\n\n\t// Compound terms\n\tlet R123 = clamp(R12 * R23, vec3f(1e-5), vec3f(0.9999));\n\tlet r123 = sqrt(R123);\n\tlet Rs = pow2(T121) * R23 / (vec3f(1.0) - R123);\n\n\t// Reflectance term for m = 0 (DC term amplitude)\n\tlet C0 = R12 + Rs;\n\tI = C0;\n\n\t// Reflectance term for m > 0 (pairs of diracs)\n\tvar Cm = Rs - T121;\n\tfor (var m = 1; m <= 2; m++) {\n\t\tCm *= r123;\n\t\tlet Sm = 2.0 * a3dPrd04EvalSensitivity(f32(m) * OPD, f32(m) * phi);\n\t\tI += Cm * Sm;\n\t}\n\n\t// Since out of gamut colors might be produced, negative color values are clamped to 0.\n\treturn max(I, vec3f(0.0));\n}\n\n// Factor resolution (r185 lights_physical_fragment.glsl.js:88-109 +\n// lights_fragment_begin.glsl.js:30-40).\nfn a3dPrd04IridescenceInit(lobes: ptr<function, A3DPrd04Lobes>, iridescenceFactor: f32, iridescenceIOR: f32, iridescenceTex: vec4f, thicknessTex: vec4f, thicknessMin: f32, thicknessMax: f32, specularColor: vec3f, diffuseColor: vec3f, metalness: f32, dotNV: f32) {\n\t(*lobes).iridescence = iridescenceFactor * iridescenceTex.r;\n\t(*lobes).iridescenceIOR = iridescenceIOR;\n\t(*lobes).iridescenceThickness = (thicknessMax - thicknessMin) * thicknessTex.g + thicknessMin;\n\n\tif ((*lobes).iridescenceThickness == 0.0) {\n\t\t(*lobes).iridescence = 0.0;\n\t} else {\n\t\t(*lobes).iridescence = saturate((*lobes).iridescence);\n\t}\n\n\tif ((*lobes).iridescence > 0.0) {\n\t\tlet fresnelDielectric = a3dPrd04EvalIridescence(1.0, (*lobes).iridescenceIOR, dotNV, (*lobes).iridescenceThickness, specularColor);\n\t\tlet fresnelMetallic = a3dPrd04EvalIridescence(1.0, (*lobes).iridescenceIOR, dotNV, (*lobes).iridescenceThickness, diffuseColor);\n\n\t\t(*lobes).iridescenceFresnel = mix(fresnelDielectric, fresnelMetallic, metalness);\n\t\t(*lobes).iridescenceF0 = Schlick_to_F0((*lobes).iridescenceFresnel, 1.0, dotNV);\n\t} else {\n\t\t(*lobes).iridescenceFresnel = vec3f(0.0);\n\t\t(*lobes).iridescenceF0 = vec3f(0.0);\n\t}\n}\n\n// Direct-lobe Fresnel blend (r185 lights_physical_pars_fragment.glsl.js:170-174).\nfn a3dPrd04IridescenceFresnelMix(F: vec3f, iridescenceFresnel: vec3f, iridescence: f32) -> vec3f {\n\treturn mix(F, iridescenceFresnel, iridescence);\n}\n\n// IBL multiscattering with thin-film F0 (r185 computeMultiscatteringIridescence,\n// lights_physical_pars_fragment.glsl.js:389-419).\nfn a3dPrd04ComputeMultiscatteringIridescence(normal: vec3f, viewDir: vec3f, specularColor: vec3f, specularF90: f32, iridescence: f32, iridescenceF0: vec3f, roughness: f32, singleScatter: ptr<function, vec3f>, multiScatter: ptr<function, vec3f>) {\n\tlet dotNV = saturate(dot(normal, viewDir));\n\tlet fab = a3dDFG(roughness, dotNV);\n\n\tlet Fr = mix(specularColor, iridescenceF0, iridescence);\n\n\tlet FssEss = Fr * fab.x + specularF90 * fab.y;\n\n\tlet Ess = fab.x + fab.y;\n\tlet Ems = 1.0 - Ess;\n\n\tlet Favg = Fr + (1.0 - Fr) * 0.047619; // 1/21\n\tlet Fms = FssEss * Favg / (1.0 - Ems * Favg);\n\n\t*singleScatter += FssEss;\n\t*multiScatter += Fms * Ems;\n}\n";
+export default wgsl;
+//# sourceMappingURL=iridescence.wgsl.d.ts.map

package/dist/rendering/shaders/physical-wgsl/iridescence.wgsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iridescence.wgsl.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/shaders/physical-wgsl/iridescence.wgsl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,QAAA,MAAM,IAAI,i5LAyJT,CAAC;AAEF,eAAO,MAAM,0BAA0B,i5LAAO,CAAC;AAC/C,eAAe,IAAI,CAAC"}

package/dist/rendering/shaders/physical-wgsl/iridescence.wgsl.js

@@ -0,0 +1,162 @@
+/**
+ * WGSL twin of a3d_prd04_iridescence (PRD-04 §8.12): same `a3d_` names,
+ * identical math (r185 iridescence_fragment.glsl.js:5-116,
+ * lights_physical_fragment.glsl.js:88-109, lights_fragment_begin.glsl.js:30-50).
+ */
+const wgsl = /* wgsl */ `
+const a3d_prd04_XYZ_TO_REC709 = mat3x3f(
+	vec3f( 3.2404542, -0.9692660,  0.0556434),
+	vec3f(-1.5371385,  1.8760108, -0.2040259),
+	vec3f(-0.4985314,  0.0415560,  1.0572252)
+);
+
+// Fresnel0 -> IOR (r185 iridescence_fragment.glsl.js:14-19).
+fn a3dPrd04IridescenceFresnel0ToIor(fresnel0: vec3f) -> vec3f {
+	let sqrtF0 = sqrt(fresnel0);
+	return (vec3f(1.0) + sqrtF0) / (vec3f(1.0) - sqrtF0);
+}
+
+fn a3dPrd04IridescenceIorToFresnel0(transmittedIor: vec3f, incidentIor: f32) -> vec3f {
+	return pow2v((transmittedIor - vec3f(incidentIor)) / (transmittedIor + vec3f(incidentIor)));
+}
+
+fn a3dPrd04IridescenceIorToFresnel0f(transmittedIor: f32, incidentIor: f32) -> f32 {
+	return pow2((transmittedIor - incidentIor) / (transmittedIor + incidentIor));
+}
+
+// XYZ sensitivity curves in Fourier space — Belcour & Barla 2017
+// (r185 evalSensitivity, iridescence_fragment.glsl.js:38-52).
+fn a3dPrd04EvalSensitivity(OPD: f32, shift: vec3f) -> vec3f {
+	let phase = 2.0 * PI * OPD * 1.0e-9;
+	let val = vec3f(5.4856e-13, 4.4201e-13, 5.2481e-13);
+	let pos = vec3f(1.6810e+06, 1.7953e+06, 2.2084e+06);
+	let var_ = vec3f(4.3278e+09, 9.3046e+09, 6.6121e+09);
+
+	var xyz = val * sqrt(2.0 * PI * var_) * cos(pos * phase + shift) * exp(-pow2(phase) * var_);
+	xyz.x += 9.7470e-14 * sqrt(2.0 * PI * 4.5282e+09) * cos(2.2399e+06 * phase + shift[0]) * exp(-4.5282e+09 * pow2(phase));
+	xyz /= 1.0685e-7;
+
+	let rgb = a3d_prd04_XYZ_TO_REC709 * xyz;
+	return rgb;
+}
+
+// Thin-film Fresnel (r185 evalIridescence, iridescence_fragment.glsl.js:54-116).
+fn a3dPrd04EvalIridescence(outsideIOR: f32, eta2: f32, cosTheta1: f32, thinFilmThickness: f32, baseF0: vec3f) -> vec3f {
+	var I: vec3f;
+
+	// Force iridescenceIOR -> outsideIOR when thinFilmThickness -> 0.0
+	let iridescenceIOR = mix(outsideIOR, eta2, smoothstep(0.0, 0.03, thinFilmThickness));
+	// Evaluate the cosTheta on the base layer (Snell law)
+	let sinTheta2Sq = pow2(outsideIOR / iridescenceIOR) * (1.0 - pow2(cosTheta1));
+
+	// Handle TIR:
+	let cosTheta2Sq = 1.0 - sinTheta2Sq;
+	if (cosTheta2Sq < 0.0) {
+		return vec3f(1.0);
+	}
+
+	let cosTheta2 = sqrt(cosTheta2Sq);
+
+	// First interface
+	let R0 = a3dPrd04IridescenceIorToFresnel0f(iridescenceIOR, outsideIOR);
+	let R12 = F_Schlick(vec3f(R0), 1.0, cosTheta1).x;
+	let T121 = 1.0 - R12;
+	var phi12 = 0.0;
+	if (iridescenceIOR < outsideIOR) {
+		phi12 = PI;
+	}
+	let phi21 = PI - phi12;
+
+	// Second interface
+	let baseIOR = a3dPrd04IridescenceFresnel0ToIor(clamp(baseF0, vec3f(0.0), vec3f(0.9999))); // guard against 1.0
+	let R1 = a3dPrd04IridescenceIorToFresnel0(baseIOR, iridescenceIOR);
+	let R23 = F_Schlick(R1, 1.0, cosTheta2);
+	var phi23 = vec3f(0.0);
+	if (baseIOR[0] < iridescenceIOR) {
+		phi23[0] = PI;
+	}
+	if (baseIOR[1] < iridescenceIOR) {
+		phi23[1] = PI;
+	}
+	if (baseIOR[2] < iridescenceIOR) {
+		phi23[2] = PI;
+	}
+
+	// Phase shift
+	let OPD = 2.0 * iridescenceIOR * thinFilmThickness * cosTheta2;
+	let phi = vec3f(phi21) + phi23;
+
+	// Compound terms
+	let R123 = clamp(R12 * R23, vec3f(1e-5), vec3f(0.9999));
+	let r123 = sqrt(R123);
+	let Rs = pow2(T121) * R23 / (vec3f(1.0) - R123);
+
+	// Reflectance term for m = 0 (DC term amplitude)
+	let C0 = R12 + Rs;
+	I = C0;
+
+	// Reflectance term for m > 0 (pairs of diracs)
+	var Cm = Rs - T121;
+	for (var m = 1; m <= 2; m++) {
+		Cm *= r123;
+		let Sm = 2.0 * a3dPrd04EvalSensitivity(f32(m) * OPD, f32(m) * phi);
+		I += Cm * Sm;
+	}
+
+	// Since out of gamut colors might be produced, negative color values are clamped to 0.
+	return max(I, vec3f(0.0));
+}
+
+// Factor resolution (r185 lights_physical_fragment.glsl.js:88-109 +
+// lights_fragment_begin.glsl.js:30-40).
+fn a3dPrd04IridescenceInit(lobes: ptr<function, A3DPrd04Lobes>, iridescenceFactor: f32, iridescenceIOR: f32, iridescenceTex: vec4f, thicknessTex: vec4f, thicknessMin: f32, thicknessMax: f32, specularColor: vec3f, diffuseColor: vec3f, metalness: f32, dotNV: f32) {
+	(*lobes).iridescence = iridescenceFactor * iridescenceTex.r;
+	(*lobes).iridescenceIOR = iridescenceIOR;
+	(*lobes).iridescenceThickness = (thicknessMax - thicknessMin) * thicknessTex.g + thicknessMin;
+
+	if ((*lobes).iridescenceThickness == 0.0) {
+		(*lobes).iridescence = 0.0;
+	} else {
+		(*lobes).iridescence = saturate((*lobes).iridescence);
+	}
+
+	if ((*lobes).iridescence > 0.0) {
+		let fresnelDielectric = a3dPrd04EvalIridescence(1.0, (*lobes).iridescenceIOR, dotNV, (*lobes).iridescenceThickness, specularColor);
+		let fresnelMetallic = a3dPrd04EvalIridescence(1.0, (*lobes).iridescenceIOR, dotNV, (*lobes).iridescenceThickness, diffuseColor);
+
+		(*lobes).iridescenceFresnel = mix(fresnelDielectric, fresnelMetallic, metalness);
+		(*lobes).iridescenceF0 = Schlick_to_F0((*lobes).iridescenceFresnel, 1.0, dotNV);
+	} else {
+		(*lobes).iridescenceFresnel = vec3f(0.0);
+		(*lobes).iridescenceF0 = vec3f(0.0);
+	}
+}
+
+// Direct-lobe Fresnel blend (r185 lights_physical_pars_fragment.glsl.js:170-174).
+fn a3dPrd04IridescenceFresnelMix(F: vec3f, iridescenceFresnel: vec3f, iridescence: f32) -> vec3f {
+	return mix(F, iridescenceFresnel, iridescence);
+}
+
+// IBL multiscattering with thin-film F0 (r185 computeMultiscatteringIridescence,
+// lights_physical_pars_fragment.glsl.js:389-419).
+fn a3dPrd04ComputeMultiscatteringIridescence(normal: vec3f, viewDir: vec3f, specularColor: vec3f, specularF90: f32, iridescence: f32, iridescenceF0: vec3f, roughness: f32, singleScatter: ptr<function, vec3f>, multiScatter: ptr<function, vec3f>) {
+	let dotNV = saturate(dot(normal, viewDir));
+	let fab = a3dDFG(roughness, dotNV);
+
+	let Fr = mix(specularColor, iridescenceF0, iridescence);
+
+	let FssEss = Fr * fab.x + specularF90 * fab.y;
+
+	let Ess = fab.x + fab.y;
+	let Ems = 1.0 - Ess;
+
+	let Favg = Fr + (1.0 - Fr) * 0.047619; // 1/21
+	let Fms = FssEss * Favg / (1.0 - Ems * Favg);
+
+	*singleScatter += FssEss;
+	*multiScatter += Fms * Ems;
+}
+`;
+export const A3D_PRD04_IRIDESCENCE_WGSL = wgsl;
+export default wgsl;
+//# sourceMappingURL=iridescence.wgsl.js.map

package/dist/rendering/shaders/physical-wgsl/iridescence.wgsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iridescence.wgsl.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/shaders/physical-wgsl/iridescence.wgsl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,IAAI,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyJvB,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAC/C,eAAe,IAAI,CAAC"}

package/dist/rendering/shaders/physical-wgsl/sheen.wgsl.d.ts

@@ -0,0 +1,9 @@
+/**
+ * WGSL twin of a3d_prd04_sheen (PRD-04 §8.12): same `a3d_` names, identical
+ * math (r185 lights_physical_fragment.glsl.js:111-129,
+ * lights_physical_pars_fragment.glsl.js:321-375).
+ */
+declare const wgsl = "\n// Factor resolution (r185 lights_physical_fragment.glsl.js:111-129).\nfn a3dPrd04SheenInit(lobes: ptr<function, A3DPrd04Lobes>, sheenColorFactor: vec3f, sheenRoughnessFactor: f32, colorTex: vec4f, roughnessTex: vec4f) {\n\t(*lobes).sheenColor = sheenColorFactor * colorTex.rgb;\n\t(*lobes).sheenRoughness = clamp(sheenRoughnessFactor, 0.0001, 1.0) * roughnessTex.a;\n}\n\n// Charlie distribution \u2014 Estevez and Kulla 2017\n// (r185 D_Charlie, lights_physical_pars_fragment.glsl.js:321-332).\nfn a3dPrd04DCharlie(roughness: f32, dotNH: f32) -> f32 {\n\tlet alpha = pow2(roughness);\n\n\tlet invAlpha = 1.0 / alpha;\n\tlet cos2h = dotNH * dotNH;\n\tlet sin2h = max(1.0 - cos2h, 0.0078125); // 2^(-14/2), so sin2h^2 > 0 in fp16\n\n\treturn (2.0 + invAlpha) * pow(sin2h, invAlpha * 0.5) / (2.0 * PI);\n}\n\n// Neubelt visibility \u2014 Neubelt and Pettineo 2013\n// (r185 V_Neubelt, lights_physical_pars_fragment.glsl.js:335-340).\nfn a3dPrd04VNeubelt(dotNV: f32, dotNL: f32) -> f32 {\n\treturn saturate(1.0 / (4.0 * (dotNL + dotNV - dotNL * dotNV)));\n}\n\n// BRDF_Sheen = sheenColor * ( D_Charlie * V_Neubelt ) (r185 :342-355).\nfn a3dPrd04SheenDirect(lightDir: vec3f, viewDir: vec3f, normal: vec3f, sheenColor: vec3f, sheenRoughness: f32) -> vec3f {\n\tlet halfDir = normalize(lightDir + viewDir);\n\n\tlet dotNL = saturate(dot(normal, lightDir));\n\tlet dotNV = saturate(dot(normal, viewDir));\n\tlet dotNH = saturate(dot(normal, halfDir));\n\n\tlet D = a3dPrd04DCharlie(sheenRoughness, dotNH);\n\tlet V = a3dPrd04VNeubelt(dotNV, dotNL);\n\n\treturn sheenColor * (D * V);\n}\n\n// Curve-fit hemisphere integral of the Charlie BRDF \u2014 Estevez and Kulla 2017\n// (r185 IBLSheenBRDF, lights_physical_pars_fragment.glsl.js:361-375).\nfn a3dPrd04IBLSheen(dotNV: f32, roughness: f32) -> f32 {\n\tlet r2 = roughness * roughness;\n\tlet rInv = 1.0 / (roughness + 0.1);\n\n\tlet a = -1.9362 + 1.0678 * roughness + 0.4573 * r2 - 0.8469 * rInv;\n\tlet b = -0.6014 + 0.5538 * roughness - 0.4670 * r2 - 0.1255 * rInv;\n\n\tlet DG = exp(a * dotNV + b);\n\n\treturn saturate(DG);\n}\n\n// Indirect sheen term: irradiance * sheenColor * IBLSheenBRDF / PI\n// (r185 :587-589).\nfn a3dPrd04SheenIndirect(normal: vec3f, viewDir: vec3f, sheenRoughness: f32, sheenColor: vec3f, irradiance: vec3f) -> vec3f {\n\tlet sheenAlbedo = a3dPrd04IBLSheen(saturate(dot(normal, viewDir)), sheenRoughness);\n\n\treturn irradiance * sheenColor * sheenAlbedo * RECIPROCAL_PI;\n}\n\n// Direct-energy compensation factor: 1 - max3( sheenColor ) * max( V, L )\n// (r185 :547-552).\nfn a3dPrd04SheenEnergyCompensation(normal: vec3f, viewDir: vec3f, lightDir: vec3f, sheenColor: vec3f, sheenRoughness: f32) -> f32 {\n\tlet sheenAlbedoV = a3dPrd04IBLSheen(saturate(dot(normal, viewDir)), sheenRoughness);\n\tlet sheenAlbedoL = a3dPrd04IBLSheen(saturate(dot(normal, lightDir)), sheenRoughness);\n\n\treturn 1.0 - max3(sheenColor) * max(sheenAlbedoV, sheenAlbedoL);\n}\n\n// Indirect (diffuse) energy compensation (r185 :565-571).\nfn a3dPrd04SheenEnergyCompensationIndirect(normal: vec3f, viewDir: vec3f, sheenColor: vec3f, sheenRoughness: f32) -> f32 {\n\tlet sheenAlbedo = a3dPrd04IBLSheen(saturate(dot(normal, viewDir)), sheenRoughness);\n\n\treturn 1.0 - max3(sheenColor) * sheenAlbedo;\n}\n";
+export declare const A3D_PRD04_SHEEN_WGSL = "\n// Factor resolution (r185 lights_physical_fragment.glsl.js:111-129).\nfn a3dPrd04SheenInit(lobes: ptr<function, A3DPrd04Lobes>, sheenColorFactor: vec3f, sheenRoughnessFactor: f32, colorTex: vec4f, roughnessTex: vec4f) {\n\t(*lobes).sheenColor = sheenColorFactor * colorTex.rgb;\n\t(*lobes).sheenRoughness = clamp(sheenRoughnessFactor, 0.0001, 1.0) * roughnessTex.a;\n}\n\n// Charlie distribution \u2014 Estevez and Kulla 2017\n// (r185 D_Charlie, lights_physical_pars_fragment.glsl.js:321-332).\nfn a3dPrd04DCharlie(roughness: f32, dotNH: f32) -> f32 {\n\tlet alpha = pow2(roughness);\n\n\tlet invAlpha = 1.0 / alpha;\n\tlet cos2h = dotNH * dotNH;\n\tlet sin2h = max(1.0 - cos2h, 0.0078125); // 2^(-14/2), so sin2h^2 > 0 in fp16\n\n\treturn (2.0 + invAlpha) * pow(sin2h, invAlpha * 0.5) / (2.0 * PI);\n}\n\n// Neubelt visibility \u2014 Neubelt and Pettineo 2013\n// (r185 V_Neubelt, lights_physical_pars_fragment.glsl.js:335-340).\nfn a3dPrd04VNeubelt(dotNV: f32, dotNL: f32) -> f32 {\n\treturn saturate(1.0 / (4.0 * (dotNL + dotNV - dotNL * dotNV)));\n}\n\n// BRDF_Sheen = sheenColor * ( D_Charlie * V_Neubelt ) (r185 :342-355).\nfn a3dPrd04SheenDirect(lightDir: vec3f, viewDir: vec3f, normal: vec3f, sheenColor: vec3f, sheenRoughness: f32) -> vec3f {\n\tlet halfDir = normalize(lightDir + viewDir);\n\n\tlet dotNL = saturate(dot(normal, lightDir));\n\tlet dotNV = saturate(dot(normal, viewDir));\n\tlet dotNH = saturate(dot(normal, halfDir));\n\n\tlet D = a3dPrd04DCharlie(sheenRoughness, dotNH);\n\tlet V = a3dPrd04VNeubelt(dotNV, dotNL);\n\n\treturn sheenColor * (D * V);\n}\n\n// Curve-fit hemisphere integral of the Charlie BRDF \u2014 Estevez and Kulla 2017\n// (r185 IBLSheenBRDF, lights_physical_pars_fragment.glsl.js:361-375).\nfn a3dPrd04IBLSheen(dotNV: f32, roughness: f32) -> f32 {\n\tlet r2 = roughness * roughness;\n\tlet rInv = 1.0 / (roughness + 0.1);\n\n\tlet a = -1.9362 + 1.0678 * roughness + 0.4573 * r2 - 0.8469 * rInv;\n\tlet b = -0.6014 + 0.5538 * roughness - 0.4670 * r2 - 0.1255 * rInv;\n\n\tlet DG = exp(a * dotNV + b);\n\n\treturn saturate(DG);\n}\n\n// Indirect sheen term: irradiance * sheenColor * IBLSheenBRDF / PI\n// (r185 :587-589).\nfn a3dPrd04SheenIndirect(normal: vec3f, viewDir: vec3f, sheenRoughness: f32, sheenColor: vec3f, irradiance: vec3f) -> vec3f {\n\tlet sheenAlbedo = a3dPrd04IBLSheen(saturate(dot(normal, viewDir)), sheenRoughness);\n\n\treturn irradiance * sheenColor * sheenAlbedo * RECIPROCAL_PI;\n}\n\n// Direct-energy compensation factor: 1 - max3( sheenColor ) * max( V, L )\n// (r185 :547-552).\nfn a3dPrd04SheenEnergyCompensation(normal: vec3f, viewDir: vec3f, lightDir: vec3f, sheenColor: vec3f, sheenRoughness: f32) -> f32 {\n\tlet sheenAlbedoV = a3dPrd04IBLSheen(saturate(dot(normal, viewDir)), sheenRoughness);\n\tlet sheenAlbedoL = a3dPrd04IBLSheen(saturate(dot(normal, lightDir)), sheenRoughness);\n\n\treturn 1.0 - max3(sheenColor) * max(sheenAlbedoV, sheenAlbedoL);\n}\n\n// Indirect (diffuse) energy compensation (r185 :565-571).\nfn a3dPrd04SheenEnergyCompensationIndirect(normal: vec3f, viewDir: vec3f, sheenColor: vec3f, sheenRoughness: f32) -> f32 {\n\tlet sheenAlbedo = a3dPrd04IBLSheen(saturate(dot(normal, viewDir)), sheenRoughness);\n\n\treturn 1.0 - max3(sheenColor) * sheenAlbedo;\n}\n";
+export default wgsl;
+//# sourceMappingURL=sheen.wgsl.d.ts.map

package/dist/rendering/shaders/physical-wgsl/sheen.wgsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheen.wgsl.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/shaders/physical-wgsl/sheen.wgsl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,QAAA,MAAM,IAAI,qsGA4ET,CAAC;AAEF,eAAO,MAAM,oBAAoB,qsGAAO,CAAC;AACzC,eAAe,IAAI,CAAC"}

package/dist/rendering/shaders/physical-wgsl/sheen.wgsl.js

@@ -0,0 +1,85 @@
+/**
+ * WGSL twin of a3d_prd04_sheen (PRD-04 §8.12): same `a3d_` names, identical
+ * math (r185 lights_physical_fragment.glsl.js:111-129,
+ * lights_physical_pars_fragment.glsl.js:321-375).
+ */
+const wgsl = /* wgsl */ `
+// Factor resolution (r185 lights_physical_fragment.glsl.js:111-129).
+fn a3dPrd04SheenInit(lobes: ptr<function, A3DPrd04Lobes>, sheenColorFactor: vec3f, sheenRoughnessFactor: f32, colorTex: vec4f, roughnessTex: vec4f) {
+	(*lobes).sheenColor = sheenColorFactor * colorTex.rgb;
+	(*lobes).sheenRoughness = clamp(sheenRoughnessFactor, 0.0001, 1.0) * roughnessTex.a;
+}
+
+// Charlie distribution — Estevez and Kulla 2017
+// (r185 D_Charlie, lights_physical_pars_fragment.glsl.js:321-332).
+fn a3dPrd04DCharlie(roughness: f32, dotNH: f32) -> f32 {
+	let alpha = pow2(roughness);
+
+	let invAlpha = 1.0 / alpha;
+	let cos2h = dotNH * dotNH;
+	let sin2h = max(1.0 - cos2h, 0.0078125); // 2^(-14/2), so sin2h^2 > 0 in fp16
+
+	return (2.0 + invAlpha) * pow(sin2h, invAlpha * 0.5) / (2.0 * PI);
+}
+
+// Neubelt visibility — Neubelt and Pettineo 2013
+// (r185 V_Neubelt, lights_physical_pars_fragment.glsl.js:335-340).
+fn a3dPrd04VNeubelt(dotNV: f32, dotNL: f32) -> f32 {
+	return saturate(1.0 / (4.0 * (dotNL + dotNV - dotNL * dotNV)));
+}
+
+// BRDF_Sheen = sheenColor * ( D_Charlie * V_Neubelt ) (r185 :342-355).
+fn a3dPrd04SheenDirect(lightDir: vec3f, viewDir: vec3f, normal: vec3f, sheenColor: vec3f, sheenRoughness: f32) -> vec3f {
+	let halfDir = normalize(lightDir + viewDir);
+
+	let dotNL = saturate(dot(normal, lightDir));
+	let dotNV = saturate(dot(normal, viewDir));
+	let dotNH = saturate(dot(normal, halfDir));
+
+	let D = a3dPrd04DCharlie(sheenRoughness, dotNH);
+	let V = a3dPrd04VNeubelt(dotNV, dotNL);
+
+	return sheenColor * (D * V);
+}
+
+// Curve-fit hemisphere integral of the Charlie BRDF — Estevez and Kulla 2017
+// (r185 IBLSheenBRDF, lights_physical_pars_fragment.glsl.js:361-375).
+fn a3dPrd04IBLSheen(dotNV: f32, roughness: f32) -> f32 {
+	let r2 = roughness * roughness;
+	let rInv = 1.0 / (roughness + 0.1);
+
+	let a = -1.9362 + 1.0678 * roughness + 0.4573 * r2 - 0.8469 * rInv;
+	let b = -0.6014 + 0.5538 * roughness - 0.4670 * r2 - 0.1255 * rInv;
+
+	let DG = exp(a * dotNV + b);
+
+	return saturate(DG);
+}
+
+// Indirect sheen term: irradiance * sheenColor * IBLSheenBRDF / PI
+// (r185 :587-589).
+fn a3dPrd04SheenIndirect(normal: vec3f, viewDir: vec3f, sheenRoughness: f32, sheenColor: vec3f, irradiance: vec3f) -> vec3f {
+	let sheenAlbedo = a3dPrd04IBLSheen(saturate(dot(normal, viewDir)), sheenRoughness);
+
+	return irradiance * sheenColor * sheenAlbedo * RECIPROCAL_PI;
+}
+
+// Direct-energy compensation factor: 1 - max3( sheenColor ) * max( V, L )
+// (r185 :547-552).
+fn a3dPrd04SheenEnergyCompensation(normal: vec3f, viewDir: vec3f, lightDir: vec3f, sheenColor: vec3f, sheenRoughness: f32) -> f32 {
+	let sheenAlbedoV = a3dPrd04IBLSheen(saturate(dot(normal, viewDir)), sheenRoughness);
+	let sheenAlbedoL = a3dPrd04IBLSheen(saturate(dot(normal, lightDir)), sheenRoughness);
+
+	return 1.0 - max3(sheenColor) * max(sheenAlbedoV, sheenAlbedoL);
+}
+
+// Indirect (diffuse) energy compensation (r185 :565-571).
+fn a3dPrd04SheenEnergyCompensationIndirect(normal: vec3f, viewDir: vec3f, sheenColor: vec3f, sheenRoughness: f32) -> f32 {
+	let sheenAlbedo = a3dPrd04IBLSheen(saturate(dot(normal, viewDir)), sheenRoughness);
+
+	return 1.0 - max3(sheenColor) * sheenAlbedo;
+}
+`;
+export const A3D_PRD04_SHEEN_WGSL = wgsl;
+export default wgsl;
+//# sourceMappingURL=sheen.wgsl.js.map

package/dist/rendering/shaders/physical-wgsl/sheen.wgsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sheen.wgsl.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/shaders/physical-wgsl/sheen.wgsl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,IAAI,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4EvB,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC;AACzC,eAAe,IAAI,CAAC"}

package/dist/rendering/shaders/physical-wgsl/specular_ior.wgsl.d.ts

@@ -0,0 +1,10 @@
+/**
+ * WGSL twin of a3d_prd04_specular_ior (PRD-04 §8.12): same `a3d_` names,
+ * identical math (r185 iridescence_fragment.glsl.js:14-33 +
+ * lights_physical_fragment.glsl.js:14-54). `pow2`/`pow2v`/`mix` come from the
+ * brdf twin shim; `pow2v` is the vec3 overload (WGSL has no overloading).
+ */
+declare const wgsl = "\n// IOR <-> F0 conversion (r185 iridescence_fragment.glsl.js:14-33).\nfn a3dPrd04IorToF0(transmittedIor: vec3f, incidentIor: f32) -> vec3f {\n\treturn pow2v((transmittedIor - vec3f(incidentIor)) / (transmittedIor + vec3f(incidentIor)));\n}\n\nfn a3dPrd04IorToF0f(transmittedIor: f32, incidentIor: f32) -> f32 {\n\treturn pow2((transmittedIor - incidentIor) / (transmittedIor + incidentIor));\n}\n\nfn a3dPrd04F0ToIor(fresnel0: vec3f) -> vec3f {\n\tlet sqrtF0 = sqrt(fresnel0);\n\treturn (vec3f(1.0) + sqrtF0) / (vec3f(1.0) - sqrtF0);\n}\n\n// Resolve specular texture factors (r185 lights_physical_fragment.glsl.js:20-33).\n// Returns specularColorFactor * texel.rgb; *outSpecIntensity =\n// specularIntensity * texel.a.\nfn a3dPrd04SpecIorFactors(specularColorFactor: vec3f, specularIntensityFactor: f32, specularColorTexel: vec3f, specularIntensityTexel: f32, outSpecIntensity: ptr<function, f32>) -> vec3f {\n\t*outSpecIntensity = specularIntensityFactor * specularIntensityTexel;\n\treturn specularColorFactor * specularColorTexel;\n}\n\n// Dielectric specularColor from ior (r185 lights_physical_fragment.glsl.js:45).\nfn a3dPrd04SpecIorSpecularColor(ior: f32, specularColorFactor: vec3f, specularIntensity: f32) -> vec3f {\n\treturn min(a3dPrd04IorToF0(vec3f(ior), 1.0) * specularColorFactor, vec3f(1.0)) * specularIntensity;\n}\n\n// specularF90 = mix( specularIntensity, 1, metalness ) (r185 :35).\nfn a3dPrd04SpecIorSpecularF90(specularIntensity: f32, metallic: f32) -> f32 {\n\treturn mix(specularIntensity, 1.0, metallic);\n}\n\n// specularColorBlended = mix( specularColor, diffuseColor, metalness ) (r185 :46, :51).\nfn a3dPrd04SpecIorSpecularColorBlended(specularColor: vec3f, diffuseColor: vec3f, metallic: f32) -> vec3f {\n\treturn mix(specularColor, diffuseColor, metallic);\n}\n";
+export declare const A3D_PRD04_SPECULAR_IOR_WGSL = "\n// IOR <-> F0 conversion (r185 iridescence_fragment.glsl.js:14-33).\nfn a3dPrd04IorToF0(transmittedIor: vec3f, incidentIor: f32) -> vec3f {\n\treturn pow2v((transmittedIor - vec3f(incidentIor)) / (transmittedIor + vec3f(incidentIor)));\n}\n\nfn a3dPrd04IorToF0f(transmittedIor: f32, incidentIor: f32) -> f32 {\n\treturn pow2((transmittedIor - incidentIor) / (transmittedIor + incidentIor));\n}\n\nfn a3dPrd04F0ToIor(fresnel0: vec3f) -> vec3f {\n\tlet sqrtF0 = sqrt(fresnel0);\n\treturn (vec3f(1.0) + sqrtF0) / (vec3f(1.0) - sqrtF0);\n}\n\n// Resolve specular texture factors (r185 lights_physical_fragment.glsl.js:20-33).\n// Returns specularColorFactor * texel.rgb; *outSpecIntensity =\n// specularIntensity * texel.a.\nfn a3dPrd04SpecIorFactors(specularColorFactor: vec3f, specularIntensityFactor: f32, specularColorTexel: vec3f, specularIntensityTexel: f32, outSpecIntensity: ptr<function, f32>) -> vec3f {\n\t*outSpecIntensity = specularIntensityFactor * specularIntensityTexel;\n\treturn specularColorFactor * specularColorTexel;\n}\n\n// Dielectric specularColor from ior (r185 lights_physical_fragment.glsl.js:45).\nfn a3dPrd04SpecIorSpecularColor(ior: f32, specularColorFactor: vec3f, specularIntensity: f32) -> vec3f {\n\treturn min(a3dPrd04IorToF0(vec3f(ior), 1.0) * specularColorFactor, vec3f(1.0)) * specularIntensity;\n}\n\n// specularF90 = mix( specularIntensity, 1, metalness ) (r185 :35).\nfn a3dPrd04SpecIorSpecularF90(specularIntensity: f32, metallic: f32) -> f32 {\n\treturn mix(specularIntensity, 1.0, metallic);\n}\n\n// specularColorBlended = mix( specularColor, diffuseColor, metalness ) (r185 :46, :51).\nfn a3dPrd04SpecIorSpecularColorBlended(specularColor: vec3f, diffuseColor: vec3f, metallic: f32) -> vec3f {\n\treturn mix(specularColor, diffuseColor, metallic);\n}\n";
+export default wgsl;
+//# sourceMappingURL=specular_ior.wgsl.d.ts.map

package/dist/rendering/shaders/physical-wgsl/specular_ior.wgsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"specular_ior.wgsl.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/shaders/physical-wgsl/specular_ior.wgsl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,QAAA,MAAM,IAAI,0wDAqCT,CAAC;AAEF,eAAO,MAAM,2BAA2B,0wDAAO,CAAC;AAChD,eAAe,IAAI,CAAC"}

package/dist/rendering/shaders/physical-wgsl/specular_ior.wgsl.js

@@ -0,0 +1,47 @@
+/**
+ * WGSL twin of a3d_prd04_specular_ior (PRD-04 §8.12): same `a3d_` names,
+ * identical math (r185 iridescence_fragment.glsl.js:14-33 +
+ * lights_physical_fragment.glsl.js:14-54). `pow2`/`pow2v`/`mix` come from the
+ * brdf twin shim; `pow2v` is the vec3 overload (WGSL has no overloading).
+ */
+const wgsl = /* wgsl */ `
+// IOR <-> F0 conversion (r185 iridescence_fragment.glsl.js:14-33).
+fn a3dPrd04IorToF0(transmittedIor: vec3f, incidentIor: f32) -> vec3f {
+	return pow2v((transmittedIor - vec3f(incidentIor)) / (transmittedIor + vec3f(incidentIor)));
+}
+
+fn a3dPrd04IorToF0f(transmittedIor: f32, incidentIor: f32) -> f32 {
+	return pow2((transmittedIor - incidentIor) / (transmittedIor + incidentIor));
+}
+
+fn a3dPrd04F0ToIor(fresnel0: vec3f) -> vec3f {
+	let sqrtF0 = sqrt(fresnel0);
+	return (vec3f(1.0) + sqrtF0) / (vec3f(1.0) - sqrtF0);
+}
+
+// Resolve specular texture factors (r185 lights_physical_fragment.glsl.js:20-33).
+// Returns specularColorFactor * texel.rgb; *outSpecIntensity =
+// specularIntensity * texel.a.
+fn a3dPrd04SpecIorFactors(specularColorFactor: vec3f, specularIntensityFactor: f32, specularColorTexel: vec3f, specularIntensityTexel: f32, outSpecIntensity: ptr<function, f32>) -> vec3f {
+	*outSpecIntensity = specularIntensityFactor * specularIntensityTexel;
+	return specularColorFactor * specularColorTexel;
+}
+
+// Dielectric specularColor from ior (r185 lights_physical_fragment.glsl.js:45).
+fn a3dPrd04SpecIorSpecularColor(ior: f32, specularColorFactor: vec3f, specularIntensity: f32) -> vec3f {
+	return min(a3dPrd04IorToF0(vec3f(ior), 1.0) * specularColorFactor, vec3f(1.0)) * specularIntensity;
+}
+
+// specularF90 = mix( specularIntensity, 1, metalness ) (r185 :35).
+fn a3dPrd04SpecIorSpecularF90(specularIntensity: f32, metallic: f32) -> f32 {
+	return mix(specularIntensity, 1.0, metallic);
+}
+
+// specularColorBlended = mix( specularColor, diffuseColor, metalness ) (r185 :46, :51).
+fn a3dPrd04SpecIorSpecularColorBlended(specularColor: vec3f, diffuseColor: vec3f, metallic: f32) -> vec3f {
+	return mix(specularColor, diffuseColor, metallic);
+}
+`;
+export const A3D_PRD04_SPECULAR_IOR_WGSL = wgsl;
+export default wgsl;
+//# sourceMappingURL=specular_ior.wgsl.js.map

package/dist/rendering/shaders/physical-wgsl/specular_ior.wgsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"specular_ior.wgsl.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/shaders/physical-wgsl/specular_ior.wgsl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,IAAI,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCvB,CAAC;AAEF,MAAM,CAAC,MAAM,2BAA2B,GAAG,IAAI,CAAC;AAChD,eAAe,IAAI,CAAC"}

package/dist/rendering/shaders/physical-wgsl/tangent_frame.wgsl.d.ts

@@ -0,0 +1,11 @@
+/**
+ * WGSL twin of a3d_prd04_tangent_frame (PRD-04 §8.11/§8.12): same `a3d_`
+ * names, identical math (r185 normal_fragment_begin.glsl.js:24-48,
+ * normalmap_pars_fragment.glsl.js:20-39). §8.12: `dpdx`/`dpdy` for the
+ * derivative frame. The GLSL `A3D_STAGE_VERTEX`/`A3D_TANGENT_DERIVATIVE` guards
+ * are generator-time defines; the twin emits both arms.
+ */
+declare const wgsl = "\n// Vertex arm: world-space tangent + preserved bitangent sign\n// (r185 defaultnormal_vertex path).\nfn a3dPrd04TangentWorld(skinnedModel: mat3x3f, tangent: vec4f) -> vec4f {\n\treturn vec4f(normalize(skinnedModel * tangent.xyz), tangent.w);\n}\n\n// Re-orthogonalized TBN from interpolated attributes (r185\n// normal_fragment_begin.glsl.js:24-28 + Gram-Schmidt; faceDirection applies\n// the double-sided flip to both axes, :42-47).\nfn a3dPrd04TangentFrame(normal: vec3f, tangent: vec4f, faceDirection: f32) -> mat3x3f {\n\tvar T = normalize(tangent.xyz);\n\tT = normalize(T - normal * dot(normal, T));\n\tlet B = cross(normal, T) * tangent.w;\n\n\tvar tbn = mat3x3f(T, B, normal);\n\n\ttbn[0] = tbn[0] * faceDirection;\n\ttbn[1] = tbn[1] * faceDirection;\n\n\treturn tbn;\n}\n\n// Derivative fallback frame \u2014 Normal Mapping Without Precomputed Tangents\n// (r185 getTangentFrame, normalmap_pars_fragment.glsl.js:20-39;\n// A3D_TANGENT_DERIVATIVE arm \u2014 the generator selects it only when the mesh\n// lacks a TANGENT attribute).\nfn a3dPrd04GetTangentFrame(eye_pos: vec3f, surf_norm: vec3f, uv: vec2f) -> mat3x3f {\n\tlet q0 = dpdx(eye_pos);\n\tlet q1 = dpdy(eye_pos);\n\tlet st0 = dpdx(uv);\n\tlet st1 = dpdy(uv);\n\n\tlet N = surf_norm; // normalized\n\n\tlet q1perp = cross(q1, N);\n\tlet q0perp = cross(N, q0);\n\n\tlet T = q1perp * st0.x + q0perp * st1.x;\n\tlet B = q1perp * st0.y + q0perp * st1.y;\n\n\tlet det = max(dot(T, T), dot(B, B));\n\tlet scale = select(inverseSqrt(det), 0.0, det == 0.0);\n\n\treturn mat3x3f(T * scale, B * scale, N);\n}\n";
+export declare const A3D_PRD04_TANGENT_FRAME_WGSL = "\n// Vertex arm: world-space tangent + preserved bitangent sign\n// (r185 defaultnormal_vertex path).\nfn a3dPrd04TangentWorld(skinnedModel: mat3x3f, tangent: vec4f) -> vec4f {\n\treturn vec4f(normalize(skinnedModel * tangent.xyz), tangent.w);\n}\n\n// Re-orthogonalized TBN from interpolated attributes (r185\n// normal_fragment_begin.glsl.js:24-28 + Gram-Schmidt; faceDirection applies\n// the double-sided flip to both axes, :42-47).\nfn a3dPrd04TangentFrame(normal: vec3f, tangent: vec4f, faceDirection: f32) -> mat3x3f {\n\tvar T = normalize(tangent.xyz);\n\tT = normalize(T - normal * dot(normal, T));\n\tlet B = cross(normal, T) * tangent.w;\n\n\tvar tbn = mat3x3f(T, B, normal);\n\n\ttbn[0] = tbn[0] * faceDirection;\n\ttbn[1] = tbn[1] * faceDirection;\n\n\treturn tbn;\n}\n\n// Derivative fallback frame \u2014 Normal Mapping Without Precomputed Tangents\n// (r185 getTangentFrame, normalmap_pars_fragment.glsl.js:20-39;\n// A3D_TANGENT_DERIVATIVE arm \u2014 the generator selects it only when the mesh\n// lacks a TANGENT attribute).\nfn a3dPrd04GetTangentFrame(eye_pos: vec3f, surf_norm: vec3f, uv: vec2f) -> mat3x3f {\n\tlet q0 = dpdx(eye_pos);\n\tlet q1 = dpdy(eye_pos);\n\tlet st0 = dpdx(uv);\n\tlet st1 = dpdy(uv);\n\n\tlet N = surf_norm; // normalized\n\n\tlet q1perp = cross(q1, N);\n\tlet q0perp = cross(N, q0);\n\n\tlet T = q1perp * st0.x + q0perp * st1.x;\n\tlet B = q1perp * st0.y + q0perp * st1.y;\n\n\tlet det = max(dot(T, T), dot(B, B));\n\tlet scale = select(inverseSqrt(det), 0.0, det == 0.0);\n\n\treturn mat3x3f(T * scale, B * scale, N);\n}\n";
+export default wgsl;
+//# sourceMappingURL=tangent_frame.wgsl.d.ts.map

package/dist/rendering/shaders/physical-wgsl/tangent_frame.wgsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tangent_frame.wgsl.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/shaders/physical-wgsl/tangent_frame.wgsl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,QAAA,MAAM,IAAI,uiDA8CT,CAAC;AAEF,eAAO,MAAM,4BAA4B,uiDAAO,CAAC;AACjD,eAAe,IAAI,CAAC"}

package/dist/rendering/shaders/physical-wgsl/tangent_frame.wgsl.js

@@ -0,0 +1,57 @@
+/**
+ * WGSL twin of a3d_prd04_tangent_frame (PRD-04 §8.11/§8.12): same `a3d_`
+ * names, identical math (r185 normal_fragment_begin.glsl.js:24-48,
+ * normalmap_pars_fragment.glsl.js:20-39). §8.12: `dpdx`/`dpdy` for the
+ * derivative frame. The GLSL `A3D_STAGE_VERTEX`/`A3D_TANGENT_DERIVATIVE` guards
+ * are generator-time defines; the twin emits both arms.
+ */
+const wgsl = /* wgsl */ `
+// Vertex arm: world-space tangent + preserved bitangent sign
+// (r185 defaultnormal_vertex path).
+fn a3dPrd04TangentWorld(skinnedModel: mat3x3f, tangent: vec4f) -> vec4f {
+	return vec4f(normalize(skinnedModel * tangent.xyz), tangent.w);
+}
+
+// Re-orthogonalized TBN from interpolated attributes (r185
+// normal_fragment_begin.glsl.js:24-28 + Gram-Schmidt; faceDirection applies
+// the double-sided flip to both axes, :42-47).
+fn a3dPrd04TangentFrame(normal: vec3f, tangent: vec4f, faceDirection: f32) -> mat3x3f {
+	var T = normalize(tangent.xyz);
+	T = normalize(T - normal * dot(normal, T));
+	let B = cross(normal, T) * tangent.w;
+
+	var tbn = mat3x3f(T, B, normal);
+
+	tbn[0] = tbn[0] * faceDirection;
+	tbn[1] = tbn[1] * faceDirection;
+
+	return tbn;
+}
+
+// Derivative fallback frame — Normal Mapping Without Precomputed Tangents
+// (r185 getTangentFrame, normalmap_pars_fragment.glsl.js:20-39;
+// A3D_TANGENT_DERIVATIVE arm — the generator selects it only when the mesh
+// lacks a TANGENT attribute).
+fn a3dPrd04GetTangentFrame(eye_pos: vec3f, surf_norm: vec3f, uv: vec2f) -> mat3x3f {
+	let q0 = dpdx(eye_pos);
+	let q1 = dpdy(eye_pos);
+	let st0 = dpdx(uv);
+	let st1 = dpdy(uv);
+
+	let N = surf_norm; // normalized
+
+	let q1perp = cross(q1, N);
+	let q0perp = cross(N, q0);
+
+	let T = q1perp * st0.x + q0perp * st1.x;
+	let B = q1perp * st0.y + q0perp * st1.y;
+
+	let det = max(dot(T, T), dot(B, B));
+	let scale = select(inverseSqrt(det), 0.0, det == 0.0);
+
+	return mat3x3f(T * scale, B * scale, N);
+}
+`;
+export const A3D_PRD04_TANGENT_FRAME_WGSL = wgsl;
+export default wgsl;
+//# sourceMappingURL=tangent_frame.wgsl.js.map

package/dist/rendering/shaders/physical-wgsl/tangent_frame.wgsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tangent_frame.wgsl.js","sourceRoot":"","sources":["../../../../../../packages/rendering/src/shaders/physical-wgsl/tangent_frame.wgsl.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,IAAI,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CvB,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,CAAC;AACjD,eAAe,IAAI,CAAC"}

package/dist/rendering/shaders/physical-wgsl/transmission.wgsl.d.ts

@@ -0,0 +1,14 @@
+/**
+ * WGSL twin of a3d_prd04_transmission (PRD-04 §8.12): same `a3d_` names,
+ * identical math (r185 transmission_pars_fragment.glsl.js:32-233).
+ *
+ * §8.12 deltas vs the GLSL chunk: `textureSampleLevel` for LOD, a material
+ * uniform struct instead of loose `uniform mat4` globals, and separate
+ * `texture_2d`/`sampler` bindings. The `A3D_TRANSMISSION`/`A3D_TRANSMISSION_BICUBIC`
+ * guards are generator-time defines (C-29), so the twin emits all functions;
+ * the bicubic helpers stay inert until the generator selects them.
+ */
+declare const wgsl = "\nstruct A3DPrd04TransmissionUniforms {\n\ttransmissionSamplerSize: vec2f,\n\tmodelMatrix: mat4x4f,\n\tprojectionMatrix: mat4x4f,\n\tviewMatrix: mat4x4f,\n}\n\n@group(1) @binding(30) var<uniform> a3d_prd04_transmission: A3DPrd04TransmissionUniforms;\n@group(1) @binding(31) var a3d_prd04_transmissionTex: texture_2d<f32>;\n@group(1) @binding(32) var a3d_prd04_transmissionSmp: sampler;\n\n// Mipped Bicubic Texture Filtering by N8\n// https://www.shadertoy.com/view/Dl2SDW\n// (r185 transmission_pars_fragment.glsl.js:35-119 \u2014 A3D_TRANSMISSION_BICUBIC arm)\nfn a3d_prd04_w0(a: f32) -> f32 {\n\treturn (1.0 / 6.0) * (a * (a * (-a + 3.0) - 3.0) + 1.0);\n}\n\nfn a3d_prd04_w1(a: f32) -> f32 {\n\treturn (1.0 / 6.0) * (a * a * (3.0 * a - 6.0) + 4.0);\n}\n\nfn a3d_prd04_w2(a: f32) -> f32 {\n\treturn (1.0 / 6.0) * (a * (a * (-3.0 * a + 3.0) + 3.0) + 1.0);\n}\n\nfn a3d_prd04_w3(a: f32) -> f32 {\n\treturn (1.0 / 6.0) * (a * a * a);\n}\n\nfn a3d_prd04_g0(a: f32) -> f32 {\n\treturn a3d_prd04_w0(a) + a3d_prd04_w1(a);\n}\n\nfn a3d_prd04_g1(a: f32) -> f32 {\n\treturn a3d_prd04_w2(a) + a3d_prd04_w3(a);\n}\n\nfn a3d_prd04_h0(a: f32) -> f32 {\n\treturn -1.0 + a3d_prd04_w1(a) / (a3d_prd04_w0(a) + a3d_prd04_w1(a));\n}\n\nfn a3d_prd04_h1(a: f32) -> f32 {\n\treturn 1.0 + a3d_prd04_w3(a) / (a3d_prd04_w2(a) + a3d_prd04_w3(a));\n}\n\nfn a3d_prd04_bicubic(tex: texture_2d<f32>, smp: sampler, uv: vec2f, texelSize: vec4f, lod: f32) -> vec4f {\n\tlet uvScaled = uv * texelSize.zw + vec2f(0.5);\n\n\tlet iuv = floor(uvScaled);\n\tlet fuv = fract(uvScaled);\n\n\tlet g0x = a3d_prd04_g0(fuv.x);\n\tlet g1x = a3d_prd04_g1(fuv.x);\n\tlet h0x = a3d_prd04_h0(fuv.x);\n\tlet h1x = a3d_prd04_h1(fuv.x);\n\tlet h0y = a3d_prd04_h0(fuv.y);\n\tlet h1y = a3d_prd04_h1(fuv.y);\n\n\tlet p0 = (vec2f(iuv.x + h0x, iuv.y + h0y) - vec2f(0.5)) * texelSize.xy;\n\tlet p1 = (vec2f(iuv.x + h1x, iuv.y + h0y) - vec2f(0.5)) * texelSize.xy;\n\tlet p2 = (vec2f(iuv.x + h0x, iuv.y + h1y) - vec2f(0.5)) * texelSize.xy;\n\tlet p3 = (vec2f(iuv.x + h1x, iuv.y + h1y) - vec2f(0.5)) * texelSize.xy;\n\n\treturn a3d_prd04_g0(fuv.y) * (g0x * textureSampleLevel(tex, smp, p0, lod) + g1x * textureSampleLevel(tex, smp, p1, lod)) +\n\t\ta3d_prd04_g1(fuv.y) * (g0x * textureSampleLevel(tex, smp, p2, lod) + g1x * textureSampleLevel(tex, smp, p3, lod));\n}\n\nfn a3d_prd04_textureBicubic(tex: texture_2d<f32>, smp: sampler, uv: vec2f, lod: f32) -> vec4f {\n\tlet fLodSize = vec2f(textureDimensions(tex, u32(lod)));\n\tlet cLodSize = vec2f(textureDimensions(tex, u32(lod + 1.0)));\n\tlet fLodSizeInv = 1.0 / fLodSize;\n\tlet cLodSizeInv = 1.0 / cLodSize;\n\tlet fSample = a3d_prd04_bicubic(tex, smp, uv, vec4f(fLodSizeInv, fLodSize), floor(lod));\n\tlet cSample = a3d_prd04_bicubic(tex, smp, uv, vec4f(cLodSizeInv, cLodSize), ceil(lod));\n\treturn mix(fSample, cSample, fract(lod));\n}\n\n// Direction of refracted light through the volume (r185\n// getVolumeTransmissionRay, transmission_pars_fragment.glsl.js:121-135).\nfn a3dVolumeTransmissionRay(n: vec3f, v: vec3f, thickness: f32, ior: f32, modelMatrix: mat4x4f) -> vec3f {\n\tlet refractionVector = refract(-v, normalize(n), 1.0 / ior);\n\n\t// Compute rotation-independent scaling of the model matrix.\n\tvar modelScale: vec3f;\n\tmodelScale.x = length(modelMatrix[0].xyz);\n\tmodelScale.y = length(modelMatrix[1].xyz);\n\tmodelScale.z = length(modelMatrix[2].xyz);\n\n\t// The thickness is specified in local space.\n\treturn normalize(refractionVector) * thickness * modelScale;\n}\n\n// Scale roughness with IOR (r185 applyIorToRoughness,\n// transmission_pars_fragment.glsl.js:137-143).\nfn a3dApplyIorToRoughness(roughness: f32, ior: f32) -> f32 {\n\treturn roughness * clamp(ior * 2.0 - 2.0, 0.0, 1.0);\n}\n\n// Sample the opaque-scene copy at the mip implied by the IOR-scaled\n// roughness (r185 getTransmissionSample,\n// transmission_pars_fragment.glsl.js:145-150). fragCoord in [0,1] NDC-UV.\n// WGSL twin keeps the bicubic arm as a separate function the generator picks;\n// default arm is the plain textureSampleLevel.\nfn a3dTransmissionSample(fragCoord: vec2f, roughness: f32, ior: f32) -> vec4f {\n\tlet lod = log2(a3d_prd04_transmission.transmissionSamplerSize.x) * a3dApplyIorToRoughness(roughness, ior);\n\treturn textureSampleLevel(a3d_prd04_transmissionTex, a3d_prd04_transmissionSmp, fragCoord, lod);\n}\n\nfn a3dTransmissionSampleBicubic(fragCoord: vec2f, roughness: f32, ior: f32) -> vec4f {\n\tlet lod = log2(a3d_prd04_transmission.transmissionSamplerSize.x) * a3dApplyIorToRoughness(roughness, ior);\n\treturn a3d_prd04_textureBicubic(a3d_prd04_transmissionTex, a3d_prd04_transmissionSmp, fragCoord, lod);\n}\n\n// Screen-space refraction sample: NDC-UV for position + transmissionRay\n// (r185 getIBLVolumeRefraction projection block,\n// transmission_pars_fragment.glsl.js:188-195).\nfn a3dTransmissionCoords(exitPosition: vec3f, viewMatrix: mat4x4f, projMatrix: mat4x4f) -> vec2f {\n\tlet ndcPos = projMatrix * viewMatrix * vec4f(exitPosition, 1.0);\n\tvar refractionCoords = ndcPos.xy / ndcPos.w;\n\trefractionCoords += 1.0;\n\trefractionCoords /= 2.0;\n\treturn refractionCoords;\n}\n\n// Single-band volume refraction (r185 getIBLVolumeRefraction non-dispersion\n// arm, transmission_pars_fragment.glsl.js:206-231).\nfn a3dGetIBLVolumeRefraction(n: vec3f, v: vec3f, roughness: f32, diffuseColor: vec3f, specularColor: vec3f, specularF90: f32, position: vec3f, modelMatrix: mat4x4f, ior: f32, thickness: f32, attenuationColor: vec3f, attenuationDistance: f32) -> vec4f {\n\tlet transmissionRay = a3dVolumeTransmissionRay(n, v, thickness, ior, modelMatrix);\n\tlet refractedRayExit = position + transmissionRay;\n\n\tlet refractionCoords = a3dTransmissionCoords(refractedRayExit, a3d_prd04_transmission.viewMatrix, a3d_prd04_transmission.projectionMatrix);\n\n\tlet transmittedLight = a3dTransmissionSample(refractionCoords, roughness, ior);\n\tlet transmittance = diffuseColor * a3dVolumeAttenuation(length(transmissionRay), attenuationColor, attenuationDistance);\n\n\tlet attenuatedColor = transmittance * transmittedLight.rgb;\n\n\tlet F = a3dPrd04EnvironmentBRDF(n, v, specularColor, specularF90, roughness);\n\n\tlet transmittanceFactor = (transmittance.r + transmittance.g + transmittance.b) / 3.0;\n\n\treturn vec4f((1.0 - F) * attenuatedColor, 1.0 - (1.0 - transmittedLight.a) * transmittanceFactor);\n}\n";
+export declare const A3D_PRD04_TRANSMISSION_WGSL = "\nstruct A3DPrd04TransmissionUniforms {\n\ttransmissionSamplerSize: vec2f,\n\tmodelMatrix: mat4x4f,\n\tprojectionMatrix: mat4x4f,\n\tviewMatrix: mat4x4f,\n}\n\n@group(1) @binding(30) var<uniform> a3d_prd04_transmission: A3DPrd04TransmissionUniforms;\n@group(1) @binding(31) var a3d_prd04_transmissionTex: texture_2d<f32>;\n@group(1) @binding(32) var a3d_prd04_transmissionSmp: sampler;\n\n// Mipped Bicubic Texture Filtering by N8\n// https://www.shadertoy.com/view/Dl2SDW\n// (r185 transmission_pars_fragment.glsl.js:35-119 \u2014 A3D_TRANSMISSION_BICUBIC arm)\nfn a3d_prd04_w0(a: f32) -> f32 {\n\treturn (1.0 / 6.0) * (a * (a * (-a + 3.0) - 3.0) + 1.0);\n}\n\nfn a3d_prd04_w1(a: f32) -> f32 {\n\treturn (1.0 / 6.0) * (a * a * (3.0 * a - 6.0) + 4.0);\n}\n\nfn a3d_prd04_w2(a: f32) -> f32 {\n\treturn (1.0 / 6.0) * (a * (a * (-3.0 * a + 3.0) + 3.0) + 1.0);\n}\n\nfn a3d_prd04_w3(a: f32) -> f32 {\n\treturn (1.0 / 6.0) * (a * a * a);\n}\n\nfn a3d_prd04_g0(a: f32) -> f32 {\n\treturn a3d_prd04_w0(a) + a3d_prd04_w1(a);\n}\n\nfn a3d_prd04_g1(a: f32) -> f32 {\n\treturn a3d_prd04_w2(a) + a3d_prd04_w3(a);\n}\n\nfn a3d_prd04_h0(a: f32) -> f32 {\n\treturn -1.0 + a3d_prd04_w1(a) / (a3d_prd04_w0(a) + a3d_prd04_w1(a));\n}\n\nfn a3d_prd04_h1(a: f32) -> f32 {\n\treturn 1.0 + a3d_prd04_w3(a) / (a3d_prd04_w2(a) + a3d_prd04_w3(a));\n}\n\nfn a3d_prd04_bicubic(tex: texture_2d<f32>, smp: sampler, uv: vec2f, texelSize: vec4f, lod: f32) -> vec4f {\n\tlet uvScaled = uv * texelSize.zw + vec2f(0.5);\n\n\tlet iuv = floor(uvScaled);\n\tlet fuv = fract(uvScaled);\n\n\tlet g0x = a3d_prd04_g0(fuv.x);\n\tlet g1x = a3d_prd04_g1(fuv.x);\n\tlet h0x = a3d_prd04_h0(fuv.x);\n\tlet h1x = a3d_prd04_h1(fuv.x);\n\tlet h0y = a3d_prd04_h0(fuv.y);\n\tlet h1y = a3d_prd04_h1(fuv.y);\n\n\tlet p0 = (vec2f(iuv.x + h0x, iuv.y + h0y) - vec2f(0.5)) * texelSize.xy;\n\tlet p1 = (vec2f(iuv.x + h1x, iuv.y + h0y) - vec2f(0.5)) * texelSize.xy;\n\tlet p2 = (vec2f(iuv.x + h0x, iuv.y + h1y) - vec2f(0.5)) * texelSize.xy;\n\tlet p3 = (vec2f(iuv.x + h1x, iuv.y + h1y) - vec2f(0.5)) * texelSize.xy;\n\n\treturn a3d_prd04_g0(fuv.y) * (g0x * textureSampleLevel(tex, smp, p0, lod) + g1x * textureSampleLevel(tex, smp, p1, lod)) +\n\t\ta3d_prd04_g1(fuv.y) * (g0x * textureSampleLevel(tex, smp, p2, lod) + g1x * textureSampleLevel(tex, smp, p3, lod));\n}\n\nfn a3d_prd04_textureBicubic(tex: texture_2d<f32>, smp: sampler, uv: vec2f, lod: f32) -> vec4f {\n\tlet fLodSize = vec2f(textureDimensions(tex, u32(lod)));\n\tlet cLodSize = vec2f(textureDimensions(tex, u32(lod + 1.0)));\n\tlet fLodSizeInv = 1.0 / fLodSize;\n\tlet cLodSizeInv = 1.0 / cLodSize;\n\tlet fSample = a3d_prd04_bicubic(tex, smp, uv, vec4f(fLodSizeInv, fLodSize), floor(lod));\n\tlet cSample = a3d_prd04_bicubic(tex, smp, uv, vec4f(cLodSizeInv, cLodSize), ceil(lod));\n\treturn mix(fSample, cSample, fract(lod));\n}\n\n// Direction of refracted light through the volume (r185\n// getVolumeTransmissionRay, transmission_pars_fragment.glsl.js:121-135).\nfn a3dVolumeTransmissionRay(n: vec3f, v: vec3f, thickness: f32, ior: f32, modelMatrix: mat4x4f) -> vec3f {\n\tlet refractionVector = refract(-v, normalize(n), 1.0 / ior);\n\n\t// Compute rotation-independent scaling of the model matrix.\n\tvar modelScale: vec3f;\n\tmodelScale.x = length(modelMatrix[0].xyz);\n\tmodelScale.y = length(modelMatrix[1].xyz);\n\tmodelScale.z = length(modelMatrix[2].xyz);\n\n\t// The thickness is specified in local space.\n\treturn normalize(refractionVector) * thickness * modelScale;\n}\n\n// Scale roughness with IOR (r185 applyIorToRoughness,\n// transmission_pars_fragment.glsl.js:137-143).\nfn a3dApplyIorToRoughness(roughness: f32, ior: f32) -> f32 {\n\treturn roughness * clamp(ior * 2.0 - 2.0, 0.0, 1.0);\n}\n\n// Sample the opaque-scene copy at the mip implied by the IOR-scaled\n// roughness (r185 getTransmissionSample,\n// transmission_pars_fragment.glsl.js:145-150). fragCoord in [0,1] NDC-UV.\n// WGSL twin keeps the bicubic arm as a separate function the generator picks;\n// default arm is the plain textureSampleLevel.\nfn a3dTransmissionSample(fragCoord: vec2f, roughness: f32, ior: f32) -> vec4f {\n\tlet lod = log2(a3d_prd04_transmission.transmissionSamplerSize.x) * a3dApplyIorToRoughness(roughness, ior);\n\treturn textureSampleLevel(a3d_prd04_transmissionTex, a3d_prd04_transmissionSmp, fragCoord, lod);\n}\n\nfn a3dTransmissionSampleBicubic(fragCoord: vec2f, roughness: f32, ior: f32) -> vec4f {\n\tlet lod = log2(a3d_prd04_transmission.transmissionSamplerSize.x) * a3dApplyIorToRoughness(roughness, ior);\n\treturn a3d_prd04_textureBicubic(a3d_prd04_transmissionTex, a3d_prd04_transmissionSmp, fragCoord, lod);\n}\n\n// Screen-space refraction sample: NDC-UV for position + transmissionRay\n// (r185 getIBLVolumeRefraction projection block,\n// transmission_pars_fragment.glsl.js:188-195).\nfn a3dTransmissionCoords(exitPosition: vec3f, viewMatrix: mat4x4f, projMatrix: mat4x4f) -> vec2f {\n\tlet ndcPos = projMatrix * viewMatrix * vec4f(exitPosition, 1.0);\n\tvar refractionCoords = ndcPos.xy / ndcPos.w;\n\trefractionCoords += 1.0;\n\trefractionCoords /= 2.0;\n\treturn refractionCoords;\n}\n\n// Single-band volume refraction (r185 getIBLVolumeRefraction non-dispersion\n// arm, transmission_pars_fragment.glsl.js:206-231).\nfn a3dGetIBLVolumeRefraction(n: vec3f, v: vec3f, roughness: f32, diffuseColor: vec3f, specularColor: vec3f, specularF90: f32, position: vec3f, modelMatrix: mat4x4f, ior: f32, thickness: f32, attenuationColor: vec3f, attenuationDistance: f32) -> vec4f {\n\tlet transmissionRay = a3dVolumeTransmissionRay(n, v, thickness, ior, modelMatrix);\n\tlet refractedRayExit = position + transmissionRay;\n\n\tlet refractionCoords = a3dTransmissionCoords(refractedRayExit, a3d_prd04_transmission.viewMatrix, a3d_prd04_transmission.projectionMatrix);\n\n\tlet transmittedLight = a3dTransmissionSample(refractionCoords, roughness, ior);\n\tlet transmittance = diffuseColor * a3dVolumeAttenuation(length(transmissionRay), attenuationColor, attenuationDistance);\n\n\tlet attenuatedColor = transmittance * transmittedLight.rgb;\n\n\tlet F = a3dPrd04EnvironmentBRDF(n, v, specularColor, specularF90, roughness);\n\n\tlet transmittanceFactor = (transmittance.r + transmittance.g + transmittance.b) / 3.0;\n\n\treturn vec4f((1.0 - F) * attenuatedColor, 1.0 - (1.0 - transmittedLight.a) * transmittanceFactor);\n}\n";
+export default wgsl;
+//# sourceMappingURL=transmission.wgsl.d.ts.map

package/dist/rendering/shaders/physical-wgsl/transmission.wgsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transmission.wgsl.d.ts","sourceRoot":"","sources":["../../../../../../packages/rendering/src/shaders/physical-wgsl/transmission.wgsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,QAAA,MAAM,IAAI,ktMAiJT,CAAC;AAEF,eAAO,MAAM,2BAA2B,ktMAAO,CAAC;AAChD,eAAe,IAAI,CAAC"}