@aura3d/rendering 2.0.4 → 3.0.1

package/dist/WebGPUExtensionAtlas.d.ts

@@ -0,0 +1,6 @@
+import type { UniformValue } from "./RenderDevice.js";
+export declare const WEBGPU_ATLAS_MAPS: readonly ["baseColor", "normal", "metallicRoughness", "occlusion", "emissive", "clearcoat", "clearcoatRoughness", "clearcoatNormal", "sheenColor", "sheenRoughness", "anisotropy", "iridescence", "iridescenceThickness"];
+/** Layout mirrors AtlasUniforms: 13 map records of five vec4s, then seven vec4s. */
+export declare function webgpuExtensionAtlasUniforms(uniforms?: ReadonlyMap<string, UniformValue>): Float32Array;
+export declare const WEBGPU_EXTENSION_ATLAS_WGSL = "\nstruct AtlasMap {\n  transform: vec4<f32>,\n  control: vec4<f32>,\n  wrapMode: vec4<f32>,\n  rect: vec4<f32>,\n  filterMode: vec4<f32>,\n};\nstruct AtlasUniforms {\n  maps: array<AtlasMap, 13>,\n  coat: vec4<f32>,\n  sheen: vec4<f32>,\n  iridescence: vec4<f32>,\n  factors: vec4<f32>,\n  emissive: vec4<f32>,\n  substrate: vec4<f32>,\n  specularColor: vec4<f32>,\n};\n@group(0) @binding(19) var<uniform> u_atlas: AtlasUniforms;\n@group(0) @binding(20) var u_scalarAtlas: texture_2d<f32>;\n@group(0) @binding(21) var u_coatNormalSampler: sampler;\n@group(0) @binding(22) var u_coatNormalTexture: texture_2d<f32>;\n@group(0) @binding(23) var u_sheenSampler: sampler;\n@group(0) @binding(24) var u_sheenTexture: texture_2d<f32>;\n@group(0) @binding(25) var u_anisotropySampler: sampler;\n@group(0) @binding(26) var u_anisotropyTexture: texture_2d<f32>;\n@group(0) @binding(27) var u_emissiveSampler: sampler;\n@group(0) @binding(28) var u_emissiveTexture: texture_2d<f32>;\nfn atlasUv(index: u32, uv0: vec2<f32>, uv1: vec2<f32>) -> vec2<f32> {\n  let map = u_atlas.maps[index];\n  let uv = select(uv0,uv1,map.control.y > 0.5) * map.transform.zw;\n  let cosine = cos(map.control.x); let sine = sin(map.control.x);\n  return vec2<f32>(cosine*uv.x-sine*uv.y,sine*uv.x+cosine*uv.y)+map.transform.xy;\n}\nfn atlasWrapIndex(x: i32, size: i32, mode: f32) -> i32 {\n  if (mode<0.5) { return clamp(x,0,size-1); }\n  let period=select(size,2*size,mode>1.5);\n  let index=((x%period)+period)%period;\n  return select(index,period-1-index,mode>1.5 && index>=size);\n}\nfn atlasFetch(point: vec2<i32>, size: vec2<i32>, origin: vec2<i32>, wrapMode: vec2<f32>) -> vec4<f32> {\n  let wrapped=vec2<i32>(atlasWrapIndex(point.x,size.x,wrapMode.x),atlasWrapIndex(point.y,size.y,wrapMode.y));\n  return textureLoad(u_scalarAtlas,origin+wrapped,0);\n}\nfn atlasLevel(uv: vec2<f32>, map: AtlasMap, level: i32, nearestFilter: bool) -> vec4<f32> {\n  var size=vec2<i32>(map.rect.yz); var origin=vec2<i32>(i32(map.rect.x),i32(map.control.w));\n  for (var i=0;i<16;i=i+1) { if (i>=level) { break; } origin.y=origin.y+size.y; size=max(size/2,vec2<i32>(1)); }\n  let pixel=uv*vec2<f32>(size)-0.5;\n  if (nearestFilter) { return atlasFetch(vec2<i32>(floor(pixel+0.5)),size,origin,map.wrapMode.xy); }\n  let low=vec2<i32>(floor(pixel)); let fraction=fract(pixel);\n  return mix(mix(atlasFetch(low,size,origin,map.wrapMode.xy),atlasFetch(low+vec2<i32>(1,0),size,origin,map.wrapMode.xy),fraction.x),\n             mix(atlasFetch(low+vec2<i32>(0,1),size,origin,map.wrapMode.xy),atlasFetch(low+vec2<i32>(1,1),size,origin,map.wrapMode.xy),fraction.x),fraction.y);\n}\nfn atlasSample(index: u32, uv0: vec2<f32>, uv1: vec2<f32>) -> vec4<f32> {\n  let map=u_atlas.maps[index]; let uv=atlasUv(index,uv0,uv1);\n  let dx=dpdx(uv); let dy=dpdy(uv); let lx=length(dx*map.rect.yz); let ly=length(dy*map.rect.yz);\n  let major=max(lx,ly); let minor=max(min(lx,ly),0.000001); let magnify=major<=1.0;\n  let taps=select(clamp(ceil(major/max(minor,1.0)),1.0,floor(map.filterMode.w)),1.0,magnify);\n  let axis=select(dy,dx,lx>=ly);\n  var lod=clamp(log2(max(major/taps,1.0)),0.0,map.rect.w);\n  if (map.filterMode.z<0.5) { lod=0.0; } else if (map.filterMode.z<1.5) { lod=floor(lod+0.5); }\n  let low=i32(floor(lod)); let high=min(low+1,i32(map.rect.w));\n  let nearestFilter=select(map.filterMode.y>0.5,map.filterMode.x>0.5,magnify);\n  var total=vec4<f32>(0.0);\n  for (var i=0;i<16;i=i+1) { if (f32(i)>=taps) { break; }\n    let sampleUv=uv+axis*((f32(i)+0.5)/taps-0.5);\n    total=total+mix(atlasLevel(sampleUv,map,low,nearestFilter),atlasLevel(sampleUv,map,high,nearestFilter),fract(lod));\n  }\n  return total/taps;\n}\n/* Spectral thin-film evaluation adapted from three.js iridescence_fragment (MIT).\nThe MIT License\n\nCopyright \u00A9 2010-2026 three.js authors\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n*/\n// Belcour/Barla Fourier-domain CIE XYZ sensitivity, converted to linear Rec.709.\n// Three monochromatic wavelength samples are not RGB tristimulus reflectance.\nfn atlasFilmSensitivity(opd: f32, shift: vec3<f32>) -> vec3<f32> {\n  let phase=2.0*3.14159265359*opd*1.0e-9;\n  let variance=vec3<f32>(4.3278e9,9.3046e9,6.6121e9);\n  var xyz=vec3<f32>(5.4856e-13,4.4201e-13,5.2481e-13)*sqrt(2.0*3.14159265359*variance)\n    *cos(vec3<f32>(1.6810e6,1.7953e6,2.2084e6)*phase+shift)*exp(-phase*phase*variance);\n  xyz.x=xyz.x+9.7470e-14*sqrt(2.0*3.14159265359*4.5282e9)*cos(2.2399e6*phase+shift.x)*exp(-4.5282e9*phase*phase);\n  xyz=xyz/1.0685e-7;\n  return mat3x3<f32>(vec3<f32>(3.2404542,-0.9692660,0.0556434),vec3<f32>(-1.5371385,1.8760108,-0.2040259),vec3<f32>(-0.4985314,0.0415560,1.0572252))*xyz;\n}\nfn atlasThinFilm(substrateF0: vec3<f32>, filmIor: f32, thickness: f32, cosine: f32) -> vec3<f32> {\n  let c1=clamp(cosine,0.0001,1.0);\n  if (thickness<=0.0) { return fresnelSchlick(c1,substrateF0); }\n  let n2=mix(1.0,filmIor,smoothstep(0.0,0.03,thickness));\n  let c2Squared=1.0-(1.0-c1*c1)/(n2*n2);\n  if (c2Squared<0.0) { return vec3<f32>(1.0); }\n  let c2=sqrt(c2Squared);\n  let f12=(n2-1.0)/(n2+1.0);\n  let r12=fresnelSchlick(c1,vec3<f32>(f12*f12)).x;\n  let t121=1.0-r12;\n  let rootF0=sqrt(clamp(substrateF0,vec3<f32>(0.0),vec3<f32>(0.9999)));\n  let n3=(vec3<f32>(1.0)+rootF0)/(vec3<f32>(1.0)-rootF0);\n  let f23=(n3-vec3<f32>(n2))/(n3+vec3<f32>(n2));\n  let r23=fresnelSchlick(c2,f23*f23);\n  let phi21=select(3.14159265359,0.0,n2<1.0);\n  let phi=vec3<f32>(phi21)+select(vec3<f32>(0.0),vec3<f32>(3.14159265359),n3<vec3<f32>(n2));\n  let opd=2.0*n2*thickness*c2;\n  let r123=clamp(r12*r23,vec3<f32>(0.00001),vec3<f32>(0.9999));\n  let amplitude=sqrt(r123);\n  let rs=t121*t121*r23/(vec3<f32>(1.0)-r123);\n  var reflectance=vec3<f32>(r12)+rs;\n  var coefficient=rs-vec3<f32>(t121);\n  for (var order=1;order<=2;order=order+1) {\n    coefficient=coefficient*amplitude;\n    reflectance=reflectance+coefficient*2.0*atlasFilmSensitivity(f32(order)*opd,f32(order)*phi);\n  }\n  return max(reflectance,vec3<f32>(0.0));\n}\n\n// KHR_materials_iridescence: a missing thickness map samples 1.0, and\n// the dielectric base receives inverse-max Fresnel weighting (rgb_mix).\nfn atlasIridescenceFresnel(substrateF0: vec3<f32>, cosine: f32, uv0: vec2<f32>, uv1: vec2<f32>) -> vec3<f32> {\n  let strength=clamp(u_atlas.iridescence.y*mix(1.0,atlasSample(11u,uv0,uv1).r,u_atlas.maps[11].control.z),0.0,1.0);\n  let thickness=mix(u_atlas.iridescence.w,u_atlas.factors.x,mix(1.0,atlasSample(12u,uv0,uv1).g,u_atlas.maps[12].control.z));\n  return mix(fresnelSchlick(cosine,substrateF0),atlasThinFilm(substrateF0,u_atlas.iridescence.z,thickness,cosine),strength);\n}\n\n// Recover the Schlick normal-incidence coefficient before applying the split-sum\n// BRDF LUT. Multiplying an already Fresnel-weighted environment by a Fresnel\n// difference would count Fresnel twice and incorrectly scale the LUT bias term.\nfn atlasIridescenceEnvironmentF0(substrateF0: vec3<f32>, cosine: f32, uv0: vec2<f32>, uv1: vec2<f32>) -> vec3<f32> {\n  let strength=clamp(u_atlas.iridescence.y*mix(1.0,atlasSample(11u,uv0,uv1).r,u_atlas.maps[11].control.z),0.0,1.0);\n  let thickness=mix(u_atlas.iridescence.w,u_atlas.factors.x,mix(1.0,atlasSample(12u,uv0,uv1).g,u_atlas.maps[12].control.z));\n  let grazing=clamp(pow(clamp(1.0-cosine,0.0,1.0),5.0),0.0,0.9999);\n  let filmF0=(atlasThinFilm(substrateF0,u_atlas.iridescence.z,thickness,cosine)-vec3<f32>(grazing))/(1.0-grazing);\n  return mix(substrateF0,filmF0,strength);\n}\n\nfn atlasExtensionLighting(normal: vec3<f32>, tangent: vec4<f32>, view: vec3<f32>, light: vec3<f32>, uv0: vec2<f32>, uv1: vec2<f32>, shadow: f32, environment: vec3<f32>, substrateF0: vec3<f32>, substrateRoughness: f32) -> vec3<f32> {\n  let coatMask=atlasSample(5u,uv0,uv1).r; let coatRoughMask=atlasSample(6u,uv0,uv1).g;\n  let sheenRoughMask=atlasSample(9u,uv0,uv1).a; let filmMask=atlasSample(11u,uv0,uv1).r;\n  let thicknessMask=atlasSample(12u,uv0,uv1).g;\n  let coatNormalSample=textureSample(u_coatNormalTexture,u_coatNormalSampler,atlasUv(7u,uv0,uv1)).rgb;\n  let coatNormal=normalize(mix(normal,perturbNormal(normal,tangent,coatNormalSample,u_atlas.coat.z),u_atlas.maps[7].control.z));\n  let sheenSample=textureSample(u_sheenTexture,u_sheenSampler,atlasUv(8u,uv0,uv1)).rgb;\n  let anisotropySample=textureSample(u_anisotropyTexture,u_anisotropySampler,atlasUv(10u,uv0,uv1));\n  let coat=u_atlas.coat.x*mix(1.0,coatMask,u_atlas.maps[5].control.z);\n  let coatRough=max(0.045,u_atlas.coat.y*mix(1.0,coatRoughMask,u_atlas.maps[6].control.z));\n  let sheen=u_atlas.sheen.rgb*mix(vec3<f32>(1.0),sheenSample,u_atlas.maps[8].control.z);\n  let sheenRough=max(0.045,u_atlas.coat.w*mix(1.0,sheenRoughMask,u_atlas.maps[9].control.z));\n  let anisotropy=u_atlas.sheen.w*mix(1.0,anisotropySample.b,u_atlas.maps[10].control.z);\n  let film=u_atlas.iridescence.y*mix(1.0,filmMask,u_atlas.maps[11].control.z);\n  let thickness=mix(u_atlas.iridescence.w,u_atlas.factors.x,mix(1.0,thicknessMask,u_atlas.maps[12].control.z));\n  let halfVector=normalize(light+view); let ndl=max(dot(normal,light),0.0); let ndv=max(dot(normal,view),0.001);\n  let coatNdl=max(dot(coatNormal,light),0.0); let coatNdv=max(dot(coatNormal,view),0.001); let coatNdh=max(dot(coatNormal,halfVector),0.001);\n  let coatBrdf=coat*ggxDistribution(coatNdh,coatRough)*ggxVisibilitySmithCorrelated(coatNdv,coatNdl,coatRough)*fresnelSchlick(max(dot(view,halfVector),0.0),vec3<f32>(0.04));\n  let ndh=max(dot(normal,halfVector),0.0); let inverseRoughness=1.0/(sheenRough*sheenRough);\n  let charlie=(2.0+inverseRoughness)*pow(max(1.0-ndh*ndh,0.00001),0.5*inverseRoughness)/(2.0*3.14159265);\n  let sheenBrdf=sheen*charlie/max(4.0*(ndl+ndv-ndl*ndv),0.0001);\n  let tx=normalize(tangent.xyz-normal*dot(tangent.xyz,normal)); let ty=normalize(cross(normal,tx))*tangent.w;\n  let mappedDirection=mix(vec2<f32>(1.0,0.0),anisotropySample.rg*2.0-1.0,u_atlas.maps[10].control.z);\n  let angle=u_atlas.iridescence.x+atan2(mappedDirection.y,mappedDirection.x);\n  let axis=tx*cos(angle)+ty*sin(angle); let crossAxis=-tx*sin(angle)+ty*cos(angle);\n  // Anisotropy and iridescence modify the same substrate specular BRDF.\n  // KHR anisotropy broadens the tangent alpha; it is not an extra white lobe.\n  let alpha=max(substrateRoughness,0.045)*max(substrateRoughness,0.045);\n  let ax=mix(alpha,1.0,clamp(anisotropy*anisotropy,0.0,1.0)); let ay=alpha;\n  let tangentH=dot(halfVector,axis)/ax; let bitangentH=dot(halfVector,crossAxis)/ay;\n  let denominator=tangentH*tangentH+bitangentH*bitangentH+ndh*ndh;\n  let anisotropicD=1.0/max(3.14159265*ax*ay*denominator*denominator,0.0000000000000001);\n  let lambdaV=ndl*length(vec3<f32>(ax*dot(axis,view),ay*dot(crossAxis,view),ndv));\n  let lambdaL=ndv*length(vec3<f32>(ax*dot(axis,light),ay*dot(crossAxis,light),ndl));\n  let anisotropicV=0.5/max(lambdaV+lambdaL,0.00001);\n  let isotropicDv=ggxDistribution(ndh,substrateRoughness)*ggxVisibilitySmithCorrelated(ndv,ndl,substrateRoughness);\n  let substrateDv=select(isotropicDv,anisotropicD*anisotropicV,anisotropy>0.0);\n  let vdh=max(dot(view,halfVector),0.0001);\n  let substrateFresnel=fresnelSchlick(vdh,substrateF0);\n  let anisotropicBrdf=substrateFresnel*(substrateDv-isotropicDv);\n  let filmDirect=film*(atlasThinFilm(substrateF0,u_atlas.iridescence.z,thickness,vdh)-substrateFresnel)*substrateDv;\n  // Film environment energy is integrated once in shadePbr through the BRDF LUT.\n  let filmEnvironment=vec3<f32>(0.0);\n  let direct=(coatBrdf*coatNdl+(sheenBrdf+anisotropicBrdf+filmDirect)*ndl)*2.25*shadow;\n  return (direct+environment*(coat*0.04+sheen*pow(1.0-ndv,5.0)+filmEnvironment))*u_atlas.factors.z;\n\n}\n";
+//# sourceMappingURL=WebGPUExtensionAtlas.d.ts.map

package/dist/WebGPUExtensionAtlas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGPUExtensionAtlas.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/WebGPUExtensionAtlas.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEnD,eAAO,MAAM,iBAAiB,2NAA4N,CAAC;AAC3P,oFAAoF;AACpF,wBAAgB,4BAA4B,CAAC,QAAQ,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,YAAY,CAqBvG;AAED,eAAO,MAAM,2BAA2B,02YAuMvC,CAAC"}

package/dist/WebGPUExtensionAtlas.js

@@ -0,0 +1,225 @@
+export const WEBGPU_ATLAS_MAPS = ["baseColor", "normal", "metallicRoughness", "occlusion", "emissive", "clearcoat", "clearcoatRoughness", "clearcoatNormal", "sheenColor", "sheenRoughness", "anisotropy", "iridescence", "iridescenceThickness"];
+/** Layout mirrors AtlasUniforms: 13 map records of five vec4s, then seven vec4s. */
+export function webgpuExtensionAtlasUniforms(uniforms) {
+    const out = new Float32Array(13 * 20 + 28);
+    const number = (key, fallback = 0) => { const value = uniforms?.get(key); return typeof value === "number" ? value : fallback; };
+    const vector = (key, fallback) => { const value = uniforms?.get(key); return Array.isArray(value) || value instanceof Float32Array ? value : fallback; };
+    WEBGPU_ATLAS_MAPS.forEach((slot, index) => {
+        const offset = index * 20;
+        out.set(vector(`u_${slot}TextureOffset`, [0, 0]), offset);
+        out.set(vector(`u_${slot}TextureScale`, [1, 1]), offset + 2);
+        out.set([number(`u_${slot}TextureRotation`), number(`u_${slot}TextureTexCoord`), number(`u_${slot}TextureEnabled`), number(`u_${slot}AtlasY`)], offset + 4);
+        out.set(vector(`u_${slot}TextureWrap`, [0, 0]), offset + 8);
+        out.set(vector(`u_${slot}AtlasRect`, [0, 1, 1, 0]), offset + 12);
+        out.set(vector(`u_${slot}AtlasFilter`, [0, 0, 0, 1]), offset + 16);
+    });
+    out.set([number("u_clearcoatFactor"), number("u_clearcoatRoughnessFactor"), number("u_clearcoatNormalScale", 1), number("u_sheenRoughnessFactor")], 260);
+    out.set([...vector("u_sheenColorFactor", [0, 0, 0]), number("u_anisotropyStrength")], 264);
+    out.set([number("u_anisotropyRotation"), number("u_iridescenceFactor"), number("u_iridescenceIor", 1.3), number("u_iridescenceThicknessMinimum", 100)], 268);
+    out.set([number("u_iridescenceThicknessMaximum", 400), number("u_emissiveStrength", 1), number("u_materialEnvironmentSpecularScale", 1), 0], 272);
+    out.set([...vector("u_emissiveColor", [0, 0, 0]), 0], 276);
+    out.set([number("u_ior", 1.5), number("u_specularFactor", 1), 0, 0], 280);
+    out.set([...vector("u_specularColorFactor", [1, 1, 1]), 0], 284);
+    return out;
+}
+export const WEBGPU_EXTENSION_ATLAS_WGSL = `
+struct AtlasMap {
+  transform: vec4<f32>,
+  control: vec4<f32>,
+  wrapMode: vec4<f32>,
+  rect: vec4<f32>,
+  filterMode: vec4<f32>,
+};
+struct AtlasUniforms {
+  maps: array<AtlasMap, 13>,
+  coat: vec4<f32>,
+  sheen: vec4<f32>,
+  iridescence: vec4<f32>,
+  factors: vec4<f32>,
+  emissive: vec4<f32>,
+  substrate: vec4<f32>,
+  specularColor: vec4<f32>,
+};
+@group(0) @binding(19) var<uniform> u_atlas: AtlasUniforms;
+@group(0) @binding(20) var u_scalarAtlas: texture_2d<f32>;
+@group(0) @binding(21) var u_coatNormalSampler: sampler;
+@group(0) @binding(22) var u_coatNormalTexture: texture_2d<f32>;
+@group(0) @binding(23) var u_sheenSampler: sampler;
+@group(0) @binding(24) var u_sheenTexture: texture_2d<f32>;
+@group(0) @binding(25) var u_anisotropySampler: sampler;
+@group(0) @binding(26) var u_anisotropyTexture: texture_2d<f32>;
+@group(0) @binding(27) var u_emissiveSampler: sampler;
+@group(0) @binding(28) var u_emissiveTexture: texture_2d<f32>;
+fn atlasUv(index: u32, uv0: vec2<f32>, uv1: vec2<f32>) -> vec2<f32> {
+  let map = u_atlas.maps[index];
+  let uv = select(uv0,uv1,map.control.y > 0.5) * map.transform.zw;
+  let cosine = cos(map.control.x); let sine = sin(map.control.x);
+  return vec2<f32>(cosine*uv.x-sine*uv.y,sine*uv.x+cosine*uv.y)+map.transform.xy;
+}
+fn atlasWrapIndex(x: i32, size: i32, mode: f32) -> i32 {
+  if (mode<0.5) { return clamp(x,0,size-1); }
+  let period=select(size,2*size,mode>1.5);
+  let index=((x%period)+period)%period;
+  return select(index,period-1-index,mode>1.5 && index>=size);
+}
+fn atlasFetch(point: vec2<i32>, size: vec2<i32>, origin: vec2<i32>, wrapMode: vec2<f32>) -> vec4<f32> {
+  let wrapped=vec2<i32>(atlasWrapIndex(point.x,size.x,wrapMode.x),atlasWrapIndex(point.y,size.y,wrapMode.y));
+  return textureLoad(u_scalarAtlas,origin+wrapped,0);
+}
+fn atlasLevel(uv: vec2<f32>, map: AtlasMap, level: i32, nearestFilter: bool) -> vec4<f32> {
+  var size=vec2<i32>(map.rect.yz); var origin=vec2<i32>(i32(map.rect.x),i32(map.control.w));
+  for (var i=0;i<16;i=i+1) { if (i>=level) { break; } origin.y=origin.y+size.y; size=max(size/2,vec2<i32>(1)); }
+  let pixel=uv*vec2<f32>(size)-0.5;
+  if (nearestFilter) { return atlasFetch(vec2<i32>(floor(pixel+0.5)),size,origin,map.wrapMode.xy); }
+  let low=vec2<i32>(floor(pixel)); let fraction=fract(pixel);
+  return mix(mix(atlasFetch(low,size,origin,map.wrapMode.xy),atlasFetch(low+vec2<i32>(1,0),size,origin,map.wrapMode.xy),fraction.x),
+             mix(atlasFetch(low+vec2<i32>(0,1),size,origin,map.wrapMode.xy),atlasFetch(low+vec2<i32>(1,1),size,origin,map.wrapMode.xy),fraction.x),fraction.y);
+}
+fn atlasSample(index: u32, uv0: vec2<f32>, uv1: vec2<f32>) -> vec4<f32> {
+  let map=u_atlas.maps[index]; let uv=atlasUv(index,uv0,uv1);
+  let dx=dpdx(uv); let dy=dpdy(uv); let lx=length(dx*map.rect.yz); let ly=length(dy*map.rect.yz);
+  let major=max(lx,ly); let minor=max(min(lx,ly),0.000001); let magnify=major<=1.0;
+  let taps=select(clamp(ceil(major/max(minor,1.0)),1.0,floor(map.filterMode.w)),1.0,magnify);
+  let axis=select(dy,dx,lx>=ly);
+  var lod=clamp(log2(max(major/taps,1.0)),0.0,map.rect.w);
+  if (map.filterMode.z<0.5) { lod=0.0; } else if (map.filterMode.z<1.5) { lod=floor(lod+0.5); }
+  let low=i32(floor(lod)); let high=min(low+1,i32(map.rect.w));
+  let nearestFilter=select(map.filterMode.y>0.5,map.filterMode.x>0.5,magnify);
+  var total=vec4<f32>(0.0);
+  for (var i=0;i<16;i=i+1) { if (f32(i)>=taps) { break; }
+    let sampleUv=uv+axis*((f32(i)+0.5)/taps-0.5);
+    total=total+mix(atlasLevel(sampleUv,map,low,nearestFilter),atlasLevel(sampleUv,map,high,nearestFilter),fract(lod));
+  }
+  return total/taps;
+}
+/* Spectral thin-film evaluation adapted from three.js iridescence_fragment (MIT).
+The MIT License
+
+Copyright © 2010-2026 three.js authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+*/
+// Belcour/Barla Fourier-domain CIE XYZ sensitivity, converted to linear Rec.709.
+// Three monochromatic wavelength samples are not RGB tristimulus reflectance.
+fn atlasFilmSensitivity(opd: f32, shift: vec3<f32>) -> vec3<f32> {
+  let phase=2.0*3.14159265359*opd*1.0e-9;
+  let variance=vec3<f32>(4.3278e9,9.3046e9,6.6121e9);
+  var xyz=vec3<f32>(5.4856e-13,4.4201e-13,5.2481e-13)*sqrt(2.0*3.14159265359*variance)
+    *cos(vec3<f32>(1.6810e6,1.7953e6,2.2084e6)*phase+shift)*exp(-phase*phase*variance);
+  xyz.x=xyz.x+9.7470e-14*sqrt(2.0*3.14159265359*4.5282e9)*cos(2.2399e6*phase+shift.x)*exp(-4.5282e9*phase*phase);
+  xyz=xyz/1.0685e-7;
+  return mat3x3<f32>(vec3<f32>(3.2404542,-0.9692660,0.0556434),vec3<f32>(-1.5371385,1.8760108,-0.2040259),vec3<f32>(-0.4985314,0.0415560,1.0572252))*xyz;
+}
+fn atlasThinFilm(substrateF0: vec3<f32>, filmIor: f32, thickness: f32, cosine: f32) -> vec3<f32> {
+  let c1=clamp(cosine,0.0001,1.0);
+  if (thickness<=0.0) { return fresnelSchlick(c1,substrateF0); }
+  let n2=mix(1.0,filmIor,smoothstep(0.0,0.03,thickness));
+  let c2Squared=1.0-(1.0-c1*c1)/(n2*n2);
+  if (c2Squared<0.0) { return vec3<f32>(1.0); }
+  let c2=sqrt(c2Squared);
+  let f12=(n2-1.0)/(n2+1.0);
+  let r12=fresnelSchlick(c1,vec3<f32>(f12*f12)).x;
+  let t121=1.0-r12;
+  let rootF0=sqrt(clamp(substrateF0,vec3<f32>(0.0),vec3<f32>(0.9999)));
+  let n3=(vec3<f32>(1.0)+rootF0)/(vec3<f32>(1.0)-rootF0);
+  let f23=(n3-vec3<f32>(n2))/(n3+vec3<f32>(n2));
+  let r23=fresnelSchlick(c2,f23*f23);
+  let phi21=select(3.14159265359,0.0,n2<1.0);
+  let phi=vec3<f32>(phi21)+select(vec3<f32>(0.0),vec3<f32>(3.14159265359),n3<vec3<f32>(n2));
+  let opd=2.0*n2*thickness*c2;
+  let r123=clamp(r12*r23,vec3<f32>(0.00001),vec3<f32>(0.9999));
+  let amplitude=sqrt(r123);
+  let rs=t121*t121*r23/(vec3<f32>(1.0)-r123);
+  var reflectance=vec3<f32>(r12)+rs;
+  var coefficient=rs-vec3<f32>(t121);
+  for (var order=1;order<=2;order=order+1) {
+    coefficient=coefficient*amplitude;
+    reflectance=reflectance+coefficient*2.0*atlasFilmSensitivity(f32(order)*opd,f32(order)*phi);
+  }
+  return max(reflectance,vec3<f32>(0.0));
+}
+
+// KHR_materials_iridescence: a missing thickness map samples 1.0, and
+// the dielectric base receives inverse-max Fresnel weighting (rgb_mix).
+fn atlasIridescenceFresnel(substrateF0: vec3<f32>, cosine: f32, uv0: vec2<f32>, uv1: vec2<f32>) -> vec3<f32> {
+  let strength=clamp(u_atlas.iridescence.y*mix(1.0,atlasSample(11u,uv0,uv1).r,u_atlas.maps[11].control.z),0.0,1.0);
+  let thickness=mix(u_atlas.iridescence.w,u_atlas.factors.x,mix(1.0,atlasSample(12u,uv0,uv1).g,u_atlas.maps[12].control.z));
+  return mix(fresnelSchlick(cosine,substrateF0),atlasThinFilm(substrateF0,u_atlas.iridescence.z,thickness,cosine),strength);
+}
+
+// Recover the Schlick normal-incidence coefficient before applying the split-sum
+// BRDF LUT. Multiplying an already Fresnel-weighted environment by a Fresnel
+// difference would count Fresnel twice and incorrectly scale the LUT bias term.
+fn atlasIridescenceEnvironmentF0(substrateF0: vec3<f32>, cosine: f32, uv0: vec2<f32>, uv1: vec2<f32>) -> vec3<f32> {
+  let strength=clamp(u_atlas.iridescence.y*mix(1.0,atlasSample(11u,uv0,uv1).r,u_atlas.maps[11].control.z),0.0,1.0);
+  let thickness=mix(u_atlas.iridescence.w,u_atlas.factors.x,mix(1.0,atlasSample(12u,uv0,uv1).g,u_atlas.maps[12].control.z));
+  let grazing=clamp(pow(clamp(1.0-cosine,0.0,1.0),5.0),0.0,0.9999);
+  let filmF0=(atlasThinFilm(substrateF0,u_atlas.iridescence.z,thickness,cosine)-vec3<f32>(grazing))/(1.0-grazing);
+  return mix(substrateF0,filmF0,strength);
+}
+
+fn atlasExtensionLighting(normal: vec3<f32>, tangent: vec4<f32>, view: vec3<f32>, light: vec3<f32>, uv0: vec2<f32>, uv1: vec2<f32>, shadow: f32, environment: vec3<f32>, substrateF0: vec3<f32>, substrateRoughness: f32) -> vec3<f32> {
+  let coatMask=atlasSample(5u,uv0,uv1).r; let coatRoughMask=atlasSample(6u,uv0,uv1).g;
+  let sheenRoughMask=atlasSample(9u,uv0,uv1).a; let filmMask=atlasSample(11u,uv0,uv1).r;
+  let thicknessMask=atlasSample(12u,uv0,uv1).g;
+  let coatNormalSample=textureSample(u_coatNormalTexture,u_coatNormalSampler,atlasUv(7u,uv0,uv1)).rgb;
+  let coatNormal=normalize(mix(normal,perturbNormal(normal,tangent,coatNormalSample,u_atlas.coat.z),u_atlas.maps[7].control.z));
+  let sheenSample=textureSample(u_sheenTexture,u_sheenSampler,atlasUv(8u,uv0,uv1)).rgb;
+  let anisotropySample=textureSample(u_anisotropyTexture,u_anisotropySampler,atlasUv(10u,uv0,uv1));
+  let coat=u_atlas.coat.x*mix(1.0,coatMask,u_atlas.maps[5].control.z);
+  let coatRough=max(0.045,u_atlas.coat.y*mix(1.0,coatRoughMask,u_atlas.maps[6].control.z));
+  let sheen=u_atlas.sheen.rgb*mix(vec3<f32>(1.0),sheenSample,u_atlas.maps[8].control.z);
+  let sheenRough=max(0.045,u_atlas.coat.w*mix(1.0,sheenRoughMask,u_atlas.maps[9].control.z));
+  let anisotropy=u_atlas.sheen.w*mix(1.0,anisotropySample.b,u_atlas.maps[10].control.z);
+  let film=u_atlas.iridescence.y*mix(1.0,filmMask,u_atlas.maps[11].control.z);
+  let thickness=mix(u_atlas.iridescence.w,u_atlas.factors.x,mix(1.0,thicknessMask,u_atlas.maps[12].control.z));
+  let halfVector=normalize(light+view); let ndl=max(dot(normal,light),0.0); let ndv=max(dot(normal,view),0.001);
+  let coatNdl=max(dot(coatNormal,light),0.0); let coatNdv=max(dot(coatNormal,view),0.001); let coatNdh=max(dot(coatNormal,halfVector),0.001);
+  let coatBrdf=coat*ggxDistribution(coatNdh,coatRough)*ggxVisibilitySmithCorrelated(coatNdv,coatNdl,coatRough)*fresnelSchlick(max(dot(view,halfVector),0.0),vec3<f32>(0.04));
+  let ndh=max(dot(normal,halfVector),0.0); let inverseRoughness=1.0/(sheenRough*sheenRough);
+  let charlie=(2.0+inverseRoughness)*pow(max(1.0-ndh*ndh,0.00001),0.5*inverseRoughness)/(2.0*3.14159265);
+  let sheenBrdf=sheen*charlie/max(4.0*(ndl+ndv-ndl*ndv),0.0001);
+  let tx=normalize(tangent.xyz-normal*dot(tangent.xyz,normal)); let ty=normalize(cross(normal,tx))*tangent.w;
+  let mappedDirection=mix(vec2<f32>(1.0,0.0),anisotropySample.rg*2.0-1.0,u_atlas.maps[10].control.z);
+  let angle=u_atlas.iridescence.x+atan2(mappedDirection.y,mappedDirection.x);
+  let axis=tx*cos(angle)+ty*sin(angle); let crossAxis=-tx*sin(angle)+ty*cos(angle);
+  // Anisotropy and iridescence modify the same substrate specular BRDF.
+  // KHR anisotropy broadens the tangent alpha; it is not an extra white lobe.
+  let alpha=max(substrateRoughness,0.045)*max(substrateRoughness,0.045);
+  let ax=mix(alpha,1.0,clamp(anisotropy*anisotropy,0.0,1.0)); let ay=alpha;
+  let tangentH=dot(halfVector,axis)/ax; let bitangentH=dot(halfVector,crossAxis)/ay;
+  let denominator=tangentH*tangentH+bitangentH*bitangentH+ndh*ndh;
+  let anisotropicD=1.0/max(3.14159265*ax*ay*denominator*denominator,0.0000000000000001);
+  let lambdaV=ndl*length(vec3<f32>(ax*dot(axis,view),ay*dot(crossAxis,view),ndv));
+  let lambdaL=ndv*length(vec3<f32>(ax*dot(axis,light),ay*dot(crossAxis,light),ndl));
+  let anisotropicV=0.5/max(lambdaV+lambdaL,0.00001);
+  let isotropicDv=ggxDistribution(ndh,substrateRoughness)*ggxVisibilitySmithCorrelated(ndv,ndl,substrateRoughness);
+  let substrateDv=select(isotropicDv,anisotropicD*anisotropicV,anisotropy>0.0);
+  let vdh=max(dot(view,halfVector),0.0001);
+  let substrateFresnel=fresnelSchlick(vdh,substrateF0);
+  let anisotropicBrdf=substrateFresnel*(substrateDv-isotropicDv);
+  let filmDirect=film*(atlasThinFilm(substrateF0,u_atlas.iridescence.z,thickness,vdh)-substrateFresnel)*substrateDv;
+  // Film environment energy is integrated once in shadePbr through the BRDF LUT.
+  let filmEnvironment=vec3<f32>(0.0);
+  let direct=(coatBrdf*coatNdl+(sheenBrdf+anisotropicBrdf+filmDirect)*ndl)*2.25*shadow;
+  return (direct+environment*(coat*0.04+sheen*pow(1.0-ndv,5.0)+filmEnvironment))*u_atlas.factors.z;
+
+}
+`;
+//# sourceMappingURL=WebGPUExtensionAtlas.js.map

package/dist/WebGPUExtensionAtlas.js.map

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

package/dist/WebGPUSkinningLimits.d.ts

@@ -11,4 +11,44 @@
  */
 /** Joint-palette capacity of the WebGPU skinning path — parity with the WebGL2 `u_jointMatrices[96]`. */
 export declare const MAX_WEBGPU_SKINNING_JOINTS = 96;
+/**
+ * Machine-readable reason a skinned mesh takes (or avoids) the CPU skinning fallback.
+ * Reported in diagnostics so gates can distinguish "too many joints" from "no GPU path
+ * available" instead of lumping every fallback together.
+ */
+export type SkinningCpuFallbackReason = 
+/** Joint count fits the uniform array; no fallback involved. */
+"none-uniform-array"
+/** Joint count exceeds the uniform array but fits the data-texture palette path. */
+ | "none-data-texture"
+/** Joint count exceeds even the data-texture ceiling — CPU skinning is the only option. */
+ | "joint-count-exceeds-data-texture-limit"
+/** The shader has no data-texture palette uniforms, so palettes above the uniform cap fall back. */
+ | "shader-lacks-data-texture-palette"
+/** No joint-palette uniforms at all on this shader — CPU skinning is the only option. */
+ | "shader-lacks-skinning-uniforms";
+export interface SkinningPaletteDecision {
+    readonly jointCount: number;
+    /** `"uniform-array"` | `"data-texture"` — the GPU upload path, or `"cpu"` when neither fits. */
+    readonly path: "uniform-array" | "data-texture" | "cpu";
+    readonly reason: SkinningCpuFallbackReason;
+    /** True when the mesh must be skinned on the CPU for this shader/capability set. */
+    readonly cpuFallback: boolean;
+}
+/**
+ * Decide the joint-palette upload path for a skinned mesh without touching the GPU.
+ * Pure and deterministic: same inputs always produce the same decision, so diagnostics
+ * and gates can assert on it in unit tests.
+ *
+ * Mirrors the runtime rule in the forward pass (uniform array up to the uniform cap,
+ * data-texture palette above it when the shader declares the uniforms, CPU otherwise)
+ * without importing renderer internals.
+ */
+export declare function decideSkinningPalettePath(options: {
+    readonly jointCount: number;
+    readonly maxUniformJoints?: number;
+    readonly maxDataTextureJoints?: number;
+    readonly shaderHasDataTexturePalette?: boolean;
+    readonly shaderHasSkinningUniforms?: boolean;
+}): SkinningPaletteDecision;
 //# sourceMappingURL=WebGPUSkinningLimits.d.ts.map

package/dist/WebGPUSkinningLimits.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WebGPUSkinningLimits.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/WebGPUSkinningLimits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,yGAAyG;AACzG,eAAO,MAAM,0BAA0B,KAAK,CAAC"}
+{"version":3,"file":"WebGPUSkinningLimits.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/WebGPUSkinningLimits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,yGAAyG;AACzG,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C;;;;GAIG;AACH,MAAM,MAAM,yBAAyB;AACnC,gEAAgE;AAC9D,oBAAoB;AACtB,oFAAoF;GAClF,mBAAmB;AACrB,2FAA2F;GACzF,wCAAwC;AAC1C,oGAAoG;GAClG,mCAAmC;AACrC,yFAAyF;GACvF,gCAAgC,CAAC;AAErC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gGAAgG;IAChG,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,cAAc,GAAG,KAAK,CAAC;IACxD,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAC3C,oFAAoF;IACpF,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE;IACjD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,2BAA2B,CAAC,EAAE,OAAO,CAAC;IAC/C,QAAQ,CAAC,yBAAyB,CAAC,EAAE,OAAO,CAAC;CAC9C,GAAG,uBAAuB,CAsB1B"}

package/dist/WebGPUSkinningLimits.js

@@ -11,4 +11,36 @@
  */
 /** Joint-palette capacity of the WebGPU skinning path — parity with the WebGL2 `u_jointMatrices[96]`. */
 export const MAX_WEBGPU_SKINNING_JOINTS = 96;
+/**
+ * Decide the joint-palette upload path for a skinned mesh without touching the GPU.
+ * Pure and deterministic: same inputs always produce the same decision, so diagnostics
+ * and gates can assert on it in unit tests.
+ *
+ * Mirrors the runtime rule in the forward pass (uniform array up to the uniform cap,
+ * data-texture palette above it when the shader declares the uniforms, CPU otherwise)
+ * without importing renderer internals.
+ */
+export function decideSkinningPalettePath(options) {
+    const jointCount = options.jointCount;
+    if (!Number.isInteger(jointCount) || jointCount < 0) {
+        throw new Error("decideSkinningPalettePath jointCount must be a non-negative integer.");
+    }
+    const maxUniformJoints = options.maxUniformJoints ?? MAX_WEBGPU_SKINNING_JOINTS;
+    const maxDataTextureJoints = options.maxDataTextureJoints ?? MAX_WEBGPU_SKINNING_JOINTS;
+    const shaderHasSkinningUniforms = options.shaderHasSkinningUniforms ?? true;
+    const shaderHasDataTexturePalette = options.shaderHasDataTexturePalette ?? true;
+    if (jointCount <= maxUniformJoints && shaderHasSkinningUniforms) {
+        return { jointCount, path: "uniform-array", reason: "none-uniform-array", cpuFallback: false };
+    }
+    if (!shaderHasSkinningUniforms) {
+        return { jointCount, path: "cpu", reason: "shader-lacks-skinning-uniforms", cpuFallback: true };
+    }
+    if (jointCount <= maxDataTextureJoints && shaderHasDataTexturePalette) {
+        return { jointCount, path: "data-texture", reason: "none-data-texture", cpuFallback: false };
+    }
+    if (!shaderHasDataTexturePalette) {
+        return { jointCount, path: "cpu", reason: "shader-lacks-data-texture-palette", cpuFallback: true };
+    }
+    return { jointCount, path: "cpu", reason: "joint-count-exceeds-data-texture-limit", cpuFallback: true };
+}
 //# sourceMappingURL=WebGPUSkinningLimits.js.map

package/dist/WebGPUSkinningLimits.js.map

@@ -1 +1 @@
-{"version":3,"file":"WebGPUSkinningLimits.js","sourceRoot":"","sources":["../../../../packages/rendering/src/WebGPUSkinningLimits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,yGAAyG;AACzG,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC"}
+{"version":3,"file":"WebGPUSkinningLimits.js","sourceRoot":"","sources":["../../../../packages/rendering/src/WebGPUSkinningLimits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,yGAAyG;AACzG,MAAM,CAAC,MAAM,0BAA0B,GAAG,EAAE,CAAC;AA4B7C;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAMzC;IACC,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;IAC1F,CAAC;IACD,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,0BAA0B,CAAC;IAChF,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,IAAI,0BAA0B,CAAC;IACxF,MAAM,yBAAyB,GAAG,OAAO,CAAC,yBAAyB,IAAI,IAAI,CAAC;IAC5E,MAAM,2BAA2B,GAAG,OAAO,CAAC,2BAA2B,IAAI,IAAI,CAAC;IAChF,IAAI,UAAU,IAAI,gBAAgB,IAAI,yBAAyB,EAAE,CAAC;QAChE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,oBAAoB,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IACjG,CAAC;IACD,IAAI,CAAC,yBAAyB,EAAE,CAAC;QAC/B,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,gCAAgC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAClG,CAAC;IACD,IAAI,UAAU,IAAI,oBAAoB,IAAI,2BAA2B,EAAE,CAAC;QACtE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,mBAAmB,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;IAC/F,CAAC;IACD,IAAI,CAAC,2BAA2B,EAAE,CAAC;QACjC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,mCAAmC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACrG,CAAC;IACD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,wCAAwC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;AAC1G,CAAC"}

package/dist/effects/CollisionModule.d.ts

@@ -6,10 +6,19 @@ export interface CollisionPlane {
     restitution?: number;
     mode?: "bounce" | "kill";
 }
+export interface GPUCollisionPlane {
+    readonly normal: Vector3Like;
+    readonly constant: number;
+    readonly restitution: number;
+    readonly killOnContact: boolean;
+}
 export declare class CollisionModule implements ParticleModule {
     readonly name = "CollisionModule";
+    readonly supportsGPU = true;
     readonly plane: Required<CollisionPlane>;
     constructor(plane: CollisionPlane);
+    /** Encode this plane for the WGSL compute kernel (analytic-plane slot). */
+    toGPUPlane(): GPUCollisionPlane;
     afterIntegrate(particle: Particle, _context: ParticleUpdateContext): void;
 }
 //# sourceMappingURL=CollisionModule.d.ts.map

package/dist/effects/CollisionModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CollisionModule.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/CollisionModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;CAC1B;AAeD,qBAAa,eAAgB,YAAW,cAAc;IACpD,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;gBAE7B,KAAK,EAAE,cAAc;IAajC,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,qBAAqB,GAAG,IAAI;CAuB1E"}
+{"version":3,"file":"CollisionModule.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/CollisionModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;CAC1B;AAeD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED,qBAAa,eAAgB,YAAW,cAAc;IACpD,QAAQ,CAAC,IAAI,qBAAqB;IAClC,QAAQ,CAAC,WAAW,QAAQ;IAC5B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;gBAE7B,KAAK,EAAE,cAAc;IAajC,2EAA2E;IAC3E,UAAU,IAAI,iBAAiB;IAS/B,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,qBAAqB,GAAG,IAAI;CAuB1E"}

package/dist/effects/CollisionModule.js

@@ -10,6 +10,7 @@ function normalize(value) {
 }
 export class CollisionModule {
     name = "CollisionModule";
+    supportsGPU = true;
     plane;
     constructor(plane) {
         this.plane = {
@@ -22,6 +23,15 @@ export class CollisionModule {
             throw new RangeError("Collision plane constant and restitution must be finite numbers.");
         }
     }
+    /** Encode this plane for the WGSL compute kernel (analytic-plane slot). */
+    toGPUPlane() {
+        return {
+            normal: { ...this.plane.normal },
+            constant: this.plane.constant,
+            restitution: this.plane.restitution,
+            killOnContact: this.plane.mode === "kill",
+        };
+    }
     afterIntegrate(particle, _context) {
         const distance = dot(this.plane.normal, particle.position) + this.plane.constant;
         if (distance >= 0) {

package/dist/effects/CollisionModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"CollisionModule.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/CollisionModule.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"CollisionModule.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/CollisionModule.ts"],"names":[],"mappings":"AAUA,SAAS,GAAG,CAAC,IAAiB,EAAE,KAAkB;IAChD,OAAO,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,SAAS,CAAC,KAAkB;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACrD,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,UAAU,CAAC,+CAA+C,CAAC,CAAC;IACxE,CAAC;IAED,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC;AAC3E,CAAC;AASD,MAAM,OAAO,eAAe;IACjB,IAAI,GAAG,iBAAiB,CAAC;IACzB,WAAW,GAAG,IAAI,CAAC;IACnB,KAAK,CAA2B;IAEzC,YAAY,KAAqB;QAC/B,IAAI,CAAC,KAAK,GAAG;YACX,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC;YAC/B,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,GAAG;YACrC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,QAAQ;SAC7B,CAAC;QAEF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;YACtF,MAAM,IAAI,UAAU,CAAC,kEAAkE,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAED,2EAA2E;IAC3E,UAAU;QACR,OAAO;YACL,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE;YAChC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ;YAC7B,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW;YACnC,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM;SAC1C,CAAC;IACJ,CAAC;IAED,cAAc,CAAC,QAAkB,EAAE,QAA+B;QAChE,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;QACjF,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC/B,QAAQ,CAAC,KAAK,GAAG,KAAK,CAAC;YACvB,OAAO;QACT,CAAC;QAED,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC;QACtD,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC;QACtD,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC;QAEtD,MAAM,cAAc,GAAG,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACjE,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,cAAc,CAAC;YAC/D,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC;YACrD,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC;YACrD,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC;QACvD,CAAC;IACH,CAAC;CACF"}

package/dist/effects/ColorModule.d.ts

@@ -6,10 +6,17 @@ export interface ColorKeyframe {
     color: ColorLike;
 }
 export declare function sampleColorGradient(keyframes: readonly ColorKeyframe[], time: number): ColorLike;
+/**
+ * Pack a color/alpha-over-life gradient into a fixed-stop RGBA LUT for the
+ * compute kernel. Alpha-over-life travels in the fourth channel.
+ */
+export declare function encodeColorGradientLUT(keyframes: readonly ColorKeyframe[], stops?: number): Float32Array;
 export declare class ColorModule implements ParticleModule {
     readonly name = "ColorModule";
+    readonly supportsGPU = true;
     readonly gradient: readonly ColorKeyframe[];
     constructor(gradient: readonly ColorKeyframe[]);
     update(particle: Particle, context: ParticleUpdateContext): void;
+    toGPUColorGradient(stops?: number): Float32Array;
 }
 //# sourceMappingURL=ColorModule.d.ts.map

package/dist/effects/ColorModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ColorModule.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/ColorModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;CAClB;AAgBD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAsBhG;AAED,qBAAa,WAAY,YAAW,cAAc;IAChD,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;gBAEhC,QAAQ,EAAE,SAAS,aAAa,EAAE;IAK9C,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI;CAGjE"}
+{"version":3,"file":"ColorModule.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/ColorModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;CAClB;AAgBD,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,CAsBhG;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,EAAE,KAAK,SAAK,GAAG,YAAY,CAcpG;AAED,qBAAa,WAAY,YAAW,cAAc;IAChD,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,WAAW,QAAQ;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;gBAEhC,QAAQ,EAAE,SAAS,aAAa,EAAE;IAK9C,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAIhE,kBAAkB,CAAC,KAAK,SAAK,GAAG,YAAY;CAG7C"}

package/dist/effects/ColorModule.js

@@ -31,8 +31,28 @@ export function sampleColorGradient(keyframes, time) {
     }
     return { ...keyframes[keyframes.length - 1].color };
 }
+/**
+ * Pack a color/alpha-over-life gradient into a fixed-stop RGBA LUT for the
+ * compute kernel. Alpha-over-life travels in the fourth channel.
+ */
+export function encodeColorGradientLUT(keyframes, stops = 16) {
+    validateGradient(keyframes);
+    if (!Number.isInteger(stops) || stops < 2 || stops > 64) {
+        throw new RangeError("Color gradient LUT stops must be an integer in [2, 64].");
+    }
+    const lut = new Float32Array(stops * 4);
+    for (let index = 0; index < stops; index += 1) {
+        const color = sampleColorGradient(keyframes, stops === 1 ? 0 : index / (stops - 1));
+        lut[index * 4] = color.r;
+        lut[index * 4 + 1] = color.g;
+        lut[index * 4 + 2] = color.b;
+        lut[index * 4 + 3] = color.a;
+    }
+    return lut;
+}
 export class ColorModule {
     name = "ColorModule";
+    supportsGPU = true;
     gradient;
     constructor(gradient) {
         this.gradient = gradient;
@@ -41,5 +61,8 @@ export class ColorModule {
     update(particle, context) {
         particle.color = sampleColorGradient(this.gradient, context.normalizedAge);
     }
+    toGPUColorGradient(stops = 16) {
+        return encodeColorGradientLUT(this.gradient, stops);
+    }
 }
 //# sourceMappingURL=ColorModule.js.map

package/dist/effects/ColorModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"ColorModule.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/ColorModule.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,MAAM,eAAe,CAAC;AAS/C,SAAS,gBAAgB,CAAC,SAAmC;IAC3D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,IAAI,UAAU,CAAC,mDAAmD,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,QAAQ,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC;IACzC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC;YACvE,MAAM,IAAI,UAAU,CAAC,2EAA2E,CAAC,CAAC;QACpG,CAAC;QACD,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,SAAmC,EAAE,IAAY;IACnF,IAAI,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9B,OAAO,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;IACnC,CAAC;IAED,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9B,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACtB,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YACtC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;YAC5C,MAAM,KAAK,GAAG,CAAC,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YAE5C,OAAO;gBACL,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK;gBAC/D,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK;gBAC/D,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK;gBAC/D,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK;aAChE,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;AACtD,CAAC;AAED,MAAM,OAAO,WAAW;IACb,IAAI,GAAG,aAAa,CAAC;IACrB,QAAQ,CAA2B;IAE5C,YAAY,QAAkC;QAC5C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,QAAkB,EAAE,OAA8B;QACvD,QAAQ,CAAC,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAC7E,CAAC;CACF"}
+{"version":3,"file":"ColorModule.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/ColorModule.ts"],"names":[],"mappings":"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"}

package/dist/effects/ForceModule.d.ts

@@ -8,4 +8,39 @@ export declare class ForceModule implements ParticleModule {
     update(particle: Particle, context: ParticleUpdateContext): void;
 }
 export declare function gravityForce(gravity?: number): ForceModule;
+export interface WindModuleOptions {
+    readonly direction: Vector3Like;
+    readonly strength?: number;
+    /** Gust amplitude as a fraction of strength (0 = steady wind). */
+    readonly gustAmplitude?: number;
+    readonly gustDirection?: Vector3Like;
+    readonly gustFrequency?: number;
+    readonly gustSpeed?: number;
+}
+export interface GPUWindParams {
+    readonly direction: Vector3Like;
+    readonly strength: number;
+    readonly gustAmplitude: number;
+    readonly gustDirection: Vector3Like;
+    readonly gustFrequency: number;
+    readonly gustSpeed: number;
+}
+/**
+ * Analytic wind field with a traveling sinusoidal gust. The CPU fallback
+ * evaluates the same closed form the WGSL kernel implements, so the wind
+ * costs zero CPU per-particle work on the GPU path.
+ */
+export declare class WindModule implements ParticleModule {
+    readonly name = "WindModule";
+    readonly supportsGPU = true;
+    readonly direction: Vector3Like;
+    readonly strength: number;
+    readonly gustAmplitude: number;
+    readonly gustDirection: Vector3Like;
+    readonly gustFrequency: number;
+    readonly gustSpeed: number;
+    constructor(options: WindModuleOptions);
+    update(particle: Particle, context: ParticleUpdateContext): void;
+    toGPUWind(): GPUWindParams;
+}
 //# sourceMappingURL=ForceModule.d.ts.map

package/dist/effects/ForceModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ForceModule.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/ForceModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,KAAK,WAAW,CAAC,CAAC;AAE/G,qBAAa,WAAY,YAAW,cAAc;IAChD,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;gBAEjB,KAAK,EAAE,YAAY;IAI/B,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI;CAOjE;AAED,wBAAgB,YAAY,CAAC,OAAO,SAAQ,GAAG,WAAW,CAEzD"}
+{"version":3,"file":"ForceModule.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/effects/ForceModule.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjF,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,KAAK,WAAW,CAAC,CAAC;AAE/G,qBAAa,WAAY,YAAW,cAAc;IAChD,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;gBAEjB,KAAK,EAAE,YAAY;IAI/B,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI;CAOjE;AAED,wBAAgB,YAAY,CAAC,OAAO,SAAQ,GAAG,WAAW,CAEzD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,kEAAkE;IAClE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,CAAC,EAAE,WAAW,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,qBAAa,UAAW,YAAW,cAAc;IAC/C,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,QAAQ;IAC5B,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,WAAW,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,OAAO,EAAE,iBAAiB;IAgBtC,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAahE,SAAS,IAAI,aAAa;CAU3B"}

package/dist/effects/ForceModule.js

@@ -14,4 +14,53 @@ export class ForceModule {
 export function gravityForce(gravity = -9.81) {
     return new ForceModule({ x: 0, y: gravity, z: 0 });
 }
+/**
+ * Analytic wind field with a traveling sinusoidal gust. The CPU fallback
+ * evaluates the same closed form the WGSL kernel implements, so the wind
+ * costs zero CPU per-particle work on the GPU path.
+ */
+export class WindModule {
+    name = "WindModule";
+    supportsGPU = true;
+    direction;
+    strength;
+    gustAmplitude;
+    gustDirection;
+    gustFrequency;
+    gustSpeed;
+    constructor(options) {
+        this.direction = { ...options.direction };
+        this.strength = options.strength ?? 1;
+        this.gustAmplitude = options.gustAmplitude ?? 0;
+        this.gustDirection = { ...(options.gustDirection ?? { x: 1, y: 0, z: 0 }) };
+        this.gustFrequency = options.gustFrequency ?? 0.5;
+        this.gustSpeed = options.gustSpeed ?? 0.8;
+        if (!Number.isFinite(this.strength) || !Number.isFinite(this.gustAmplitude) ||
+            !Number.isFinite(this.gustFrequency) || !Number.isFinite(this.gustSpeed)) {
+            throw new RangeError("WindModule strength and gust parameters must be finite numbers.");
+        }
+        if (this.gustAmplitude < 0) {
+            throw new RangeError("WindModule gustAmplitude must be non-negative.");
+        }
+    }
+    update(particle, context) {
+        const alongWind = particle.position.x * this.gustDirection.x +
+            particle.position.y * this.gustDirection.y +
+            particle.position.z * this.gustDirection.z;
+        const gust = 1 + this.gustAmplitude * Math.sin(alongWind * this.gustFrequency + context.elapsedTime * this.gustSpeed);
+        particle.velocity.x += this.direction.x * this.strength * gust * context.deltaTime;
+        particle.velocity.y += this.direction.y * this.strength * gust * context.deltaTime;
+        particle.velocity.z += this.direction.z * this.strength * gust * context.deltaTime;
+    }
+    toGPUWind() {
+        return {
+            direction: { ...this.direction },
+            strength: this.strength,
+            gustAmplitude: this.gustAmplitude,
+            gustDirection: { ...this.gustDirection },
+            gustFrequency: this.gustFrequency,
+            gustSpeed: this.gustSpeed,
+        };
+    }
+}
 //# sourceMappingURL=ForceModule.js.map