@aura3d/rendering 2.0.4 → 3.0.1

package/dist/ShaderLibrary.js

@@ -1,6 +1,6 @@
 import { SHADER_CHUNKS, validateShaderChunks } from "./ShaderChunks.js";
 import { registerAnimationToonShader } from "./animation/AnimationToonMaterial.js";
-import { ShaderLibrary, registerLeanUnlitShader, registerLeanPbrShader, registerLeanDepthShader, registerLeanEnvironmentBackgroundShader, DEFAULT_DEPTH_SHADER_MARKER, DEFAULT_DEPTH_SHADER_NAME, DEFAULT_ENVIRONMENT_BACKGROUND_SHADER_MARKER, DEFAULT_ENVIRONMENT_BACKGROUND_SHADER_NAME, DEFAULT_INSTANCED_PBR_SHADER_MARKER, DEFAULT_INSTANCED_PBR_SHADER_NAME, DEFAULT_INSTANCED_UNLIT_SHADER_MARKER, DEFAULT_INSTANCED_UNLIT_SHADER_NAME, DEFAULT_MORPH_UNLIT_SHADER_MARKER, DEFAULT_MORPH_UNLIT_SHADER_NAME, DEFAULT_NORMAL_MAPPED_PBR_SHADER_MARKER, DEFAULT_NORMAL_MAPPED_PBR_SHADER_NAME, DEFAULT_PBR_SHADER_MARKER, DEFAULT_PBR_SHADER_NAME, DEFAULT_SCREEN_SPACE_LINE_SHADER_MARKER, DEFAULT_SCREEN_SPACE_LINE_SHADER_NAME, DEFAULT_SKINNED_LIT_EIGHT_INFLUENCE_SHADER_MARKER, DEFAULT_SKINNED_LIT_EIGHT_INFLUENCE_SHADER_NAME, DEFAULT_SKINNED_LIT_SHADER_MARKER, DEFAULT_SKINNED_LIT_SHADER_NAME, DEFAULT_SKINNED_UNLIT_EIGHT_INFLUENCE_SHADER_MARKER, DEFAULT_SKINNED_UNLIT_EIGHT_INFLUENCE_SHADER_NAME, DEFAULT_SKINNED_UNLIT_SHADER_MARKER, DEFAULT_SKINNED_UNLIT_SHADER_NAME, DEFAULT_TEXTURED_PBR_CLEARCOAT_SPECULAR_TEXTURES_VARIANT, DEFAULT_TEXTURED_PBR_CLEARCOAT_TEXTURES_VARIANT, DEFAULT_TEXTURED_PBR_CLEARCOAT_TRANSMISSION_VOLUME_TEXTURES_VARIANT, DEFAULT_TEXTURED_PBR_IRIDESCENCE_TEXTURES_VARIANT, DEFAULT_TEXTURED_PBR_SHADER_MARKER, DEFAULT_TEXTURED_PBR_SHADER_NAME, DEFAULT_TEXTURED_PBR_SPECULAR_SHEEN_ANISOTROPY_IRIDESCENCE_TEXTURES_VARIANT, DEFAULT_TEXTURED_PBR_SPECULAR_SHEEN_ANISOTROPY_TEXTURES_VARIANT, DEFAULT_TEXTURED_PBR_TRANSMISSION_VOLUME_TEXTURES_VARIANT, DEFAULT_TEXTURED_UNLIT_SHADER_MARKER, DEFAULT_TEXTURED_UNLIT_SHADER_NAME, DEFAULT_UNLIT_SHADER_MARKER, DEFAULT_UNLIT_SHADER_NAME, } from "./ShaderLibraryCore.js";
+import { ShaderLibrary, registerLeanUnlitShader, registerLeanPbrShader, registerLeanDepthShader, registerLeanEnvironmentBackgroundShader, DEFAULT_DEPTH_SHADER_MARKER, DEFAULT_DEPTH_SHADER_NAME, DEFAULT_ENVIRONMENT_BACKGROUND_SHADER_MARKER, DEFAULT_ENVIRONMENT_BACKGROUND_SHADER_NAME, DEFAULT_INSTANCED_PBR_SHADER_MARKER, DEFAULT_INSTANCED_PBR_SHADER_NAME, DEFAULT_INSTANCED_UNLIT_SHADER_MARKER, DEFAULT_INSTANCED_UNLIT_SHADER_NAME, DEFAULT_MORPH_UNLIT_SHADER_MARKER, DEFAULT_MORPH_UNLIT_SHADER_NAME, DEFAULT_NORMAL_MAPPED_PBR_SHADER_MARKER, DEFAULT_NORMAL_MAPPED_PBR_SHADER_NAME, DEFAULT_PBR_SHADER_MARKER, DEFAULT_PBR_SHADER_NAME, DEFAULT_SCREEN_SPACE_LINE_SHADER_MARKER, DEFAULT_SCREEN_SPACE_LINE_SHADER_NAME, DEFAULT_SKINNED_LIT_EIGHT_INFLUENCE_SHADER_MARKER, DEFAULT_SKINNED_LIT_EIGHT_INFLUENCE_SHADER_NAME, DEFAULT_SKINNED_LIT_SHADER_MARKER, DEFAULT_SKINNED_LIT_SHADER_NAME, DEFAULT_SKINNED_UNLIT_EIGHT_INFLUENCE_SHADER_MARKER, DEFAULT_SKINNED_UNLIT_EIGHT_INFLUENCE_SHADER_NAME, DEFAULT_SKINNED_UNLIT_SHADER_MARKER, DEFAULT_SKINNED_UNLIT_SHADER_NAME, DEFAULT_TEXTURED_PBR_CLEARCOAT_SHEEN_ANISOTROPY_TEXTURES_VARIANT, DEFAULT_TEXTURED_PBR_CLEARCOAT_IRIDESCENCE_TEXTURES_VARIANT, DEFAULT_TEXTURED_PBR_EXTENSION_ATLAS_VARIANT, DEFAULT_TEXTURED_PBR_CLEARCOAT_SPECULAR_TEXTURES_VARIANT, DEFAULT_TEXTURED_PBR_CLEARCOAT_TEXTURES_VARIANT, DEFAULT_TEXTURED_PBR_CLEARCOAT_TRANSMISSION_VOLUME_TEXTURES_VARIANT, DEFAULT_TEXTURED_PBR_IRIDESCENCE_TEXTURES_VARIANT, DEFAULT_TEXTURED_PBR_SHADER_MARKER, DEFAULT_TEXTURED_PBR_SHADER_NAME, DEFAULT_TEXTURED_PBR_SPECULAR_SHEEN_ANISOTROPY_IRIDESCENCE_TEXTURES_VARIANT, DEFAULT_TEXTURED_PBR_SPECULAR_SHEEN_ANISOTROPY_TEXTURES_VARIANT, DEFAULT_TEXTURED_PBR_TRANSMISSION_VOLUME_TEXTURES_VARIANT, DEFAULT_TEXTURED_UNLIT_SHADER_MARKER, DEFAULT_TEXTURED_UNLIT_SHADER_NAME, DEFAULT_UNLIT_SHADER_MARKER, DEFAULT_UNLIT_SHADER_NAME, } from "./ShaderLibraryCore.js";
 export * from "./ShaderLibraryCore.js";
 export function createDefaultShaderLibrary() {
     const library = new ShaderLibrary();
@@ -94,6 +94,7 @@ uniform float u_metallic;
 uniform float u_roughness;
 uniform vec3 u_environmentColor;
 uniform float u_environmentIntensity;
+uniform float u_materialEnvironmentIntensity;
 uniform vec3 u_environmentSkyColor;
 uniform vec3 u_environmentHorizonColor;
 uniform vec3 u_environmentGroundColor;
@@ -141,6 +142,19 @@ uniform float u_pointShadowSlopeBias;
 uniform vec2 u_pointShadowTexelSize;
 uniform float u_pointShadowPcfSampleCount;
 uniform vec4 u_pointShadowPcfSamples[32];
+uniform sampler2D u_spotShadowMapTexture;
+uniform float u_spotShadowMapEnabled;
+uniform vec3 u_spotShadowLightPosition;
+uniform vec3 u_spotShadowLightDirection;
+uniform mat4 u_spotShadowMatrix;
+uniform vec2 u_spotShadowCone;
+uniform float u_spotShadowRange;
+uniform float u_spotShadowStrength;
+uniform float u_spotShadowBias;
+uniform float u_spotShadowSlopeBias;
+uniform vec2 u_spotShadowTexelSize;
+uniform float u_spotShadowPcfSampleCount;
+uniform vec4 u_spotShadowPcfSamples[32];
 uniform float u_outputColorSpace;
 uniform vec3 u_cameraPosition;
 uniform float u_environmentFogEnabled;
@@ -150,6 +164,9 @@ uniform float u_environmentFogNear;
 uniform float u_environmentFogFar;
 uniform float u_environmentFogDensity;
 uniform float u_environmentFogHeightFalloff;
+uniform float u_volumetricIntensity;
+uniform vec3 u_volumetricLightDirection;
+uniform vec3 u_volumetricLightColor;
 uniform float u_environmentFogHeightReference;
 uniform float u_environmentFogMaxOpacity;
 in vec3 v_normal;
@@ -166,15 +183,6 @@ float a3dForwardShadowFactor(vec3 worldPosition, vec3 normal, vec3 lightDirectio
   vec3 receiverNormal = normalize(normal);
   vec3 receiverLightDirection = lightDirection / max(length(lightDirection), 0.0001);
   float normalDotLight = clamp(abs(dot(receiverNormal, receiverLightDirection)), 0.0, 1.0);
-  // Slope-scaled depth bias must be evaluated per PCF sample, not once for the kernel
-  // centre. A sample offset N texels away on a receiver sloped relative to the light sees a
-  // depth difference proportional to N, so a centre-only bias under-compensates every outer
-  // tap and the receiver shadows itself. Scaling by each sample's own texel distance keeps
-  // wide kernels acne-free without inflating the constant bias into peter-panning.
-  // The depth gradient across one shadow texel is tan(angle between receiver normal and
-  // light), not (1 - N.L). The linear form collapses toward zero far faster than the real
-  // gradient grows, so it under-biases exactly the grazing angles that need the most
-  // compensation. Clamped so a near-perpendicular receiver cannot demand unbounded bias.
   float slopeTangent = min(sqrt(max(1.0 - normalDotLight * normalDotLight, 0.0)) / max(normalDotLight, 0.05), 8.0);
   float slopeTexelBias = slopeTangent * u_shadowMapSlopeBias * max(u_shadowMapTexelSize.x, u_shadowMapTexelSize.y);
   float projectedDepth = projected.z * 0.5 + 0.5;
@@ -207,9 +215,6 @@ float a3dPointShadowFactor(vec3 worldPosition, vec3 normal, vec3 lightDirection)
   vec4 rect = u_pointShadowFaceRects[faceIndex];
   vec2 uv = rect.xy + localUv * rect.zw;
   float normalDotLight = clamp(abs(dot(normalize(normal), normalize(lightDirection))), 0.0, 1.0);
-  // Same per-sample, tangent-scaled slope bias as the directional and atlas paths. These
-  // cubemap-face variants inline the sample fetch, but they share the identical acne
-  // mechanism: a centre-only, (1 - N.L)-scaled bias under-compensates every outer tap.
   float slopeTangent = min(sqrt(max(1.0 - normalDotLight * normalDotLight, 0.0)) / max(normalDotLight, 0.05), 8.0);
   float slopeTexelBias = slopeTangent * u_pointShadowSlopeBias * max(u_pointShadowTexelSize.x, u_pointShadowTexelSize.y);
   float projectedDepth = projected.z * 0.5 + 0.5;
@@ -228,6 +233,44 @@ float a3dPointShadowFactor(vec3 worldPosition, vec3 normal, vec3 lightDirection)
   float occlusion = totalWeight > 0.0 ? shadowed / totalWeight : 0.0;
   return mix(1.0, 1.0 - occlusion, clamp(u_pointShadowStrength, 0.0, 1.0));
 }
+float a3dSpotShadowFactor(vec3 worldPosition, vec3 normal, vec3 lightDirection) {
+  if (u_spotShadowMapEnabled < 0.5) return 1.0;
+  vec3 toFragment = worldPosition - u_spotShadowLightPosition;
+  float distanceToLight = max(length(toFragment), 0.0001);
+  if (distanceToLight > u_spotShadowRange) return 1.0;
+  vec3 coneAxis = u_spotShadowLightDirection / max(length(u_spotShadowLightDirection), 0.0001);
+  if (dot(toFragment / distanceToLight, coneAxis) < cos(u_spotShadowCone.x)) return 1.0;
+  vec4 lightPosition = u_spotShadowMatrix * vec4(worldPosition, 1.0);
+  vec3 projected = lightPosition.xyz / max(lightPosition.w, 0.0001);
+  vec2 uv = projected.xy * 0.5 + 0.5;
+  if (uv.x < 0.0 || uv.x > 1.0 || uv.y < 0.0 || uv.y > 1.0) return 1.0;
+  vec3 receiverNormal = normalize(normal);
+  vec3 receiverLightDirection = lightDirection / max(length(lightDirection), 0.0001);
+  float normalDotLight = clamp(abs(dot(receiverNormal, receiverLightDirection)), 0.0, 1.0);
+  float slopeTangent = min(sqrt(max(1.0 - normalDotLight * normalDotLight, 0.0)) / max(normalDotLight, 0.05), 8.0);
+  float slopeTexelBias = slopeTangent * u_spotShadowSlopeBias * max(u_spotShadowTexelSize.x, u_spotShadowTexelSize.y);
+  float projectedDepth = projected.z * 0.5 + 0.5;
+  float shadowed = 0.0;
+  float totalWeight = 0.0;
+  int sampleCount = clamp(int(u_spotShadowPcfSampleCount), 1, 32);
+  for (int i = 0; i < 32; ++i) {
+    if (i >= sampleCount) break;
+    vec4 sampleData = u_spotShadowPcfSamples[i];
+    float weight = max(sampleData.z, 0.0);
+    vec2 offset = sampleData.xy * u_spotShadowTexelSize;
+    float storedDepth = texture(u_spotShadowMapTexture, uv + offset).r;
+    float sampleTexelDistance = max(1.0, length(sampleData.xy));
+    float receiverDepth = projectedDepth - u_spotShadowBias - slopeTexelBias * sampleTexelDistance;
+    shadowed += (receiverDepth > storedDepth ? 1.0 : 0.0) * weight;
+    totalWeight += weight;
+  }
+  float occlusion = totalWeight > 0.0 ? shadowed / totalWeight : 0.0;
+  return mix(1.0, 1.0 - occlusion, clamp(u_spotShadowStrength, 0.0, 1.0));
+}
+float a3dResolveSpotShadowOverride(float baseFactor, float kind, float shadowFlag, vec3 worldPosition, vec3 normal, vec3 lightDirection) {
+  float spotGate = step(1.5, kind) * (1.0 - step(2.5, kind)) * step(0.5, u_spotShadowMapEnabled) * step(0.5, shadowFlag);
+  return mix(baseFactor, a3dSpotShadowFactor(worldPosition, normal, lightDirection), spotGate);
+}
 vec2 a3dEnvironmentEquirectUv(vec3 direction, float rotation) {
   vec3 d = normalize(direction);
   float u = atan(d.z, d.x) / 6.28318530718 + 0.5 + rotation;
@@ -273,16 +316,11 @@ vec3 a3dPbrEnvironmentDiffuseInput(vec3 normal) {
   float horizonBlend = 1.0 - abs(normal.y);
   vec3 proceduralDiffuse = mix(u_environmentGroundColor, u_environmentSkyColor, skyBlend);
   proceduralDiffuse = mix(proceduralDiffuse, u_environmentHorizonColor, clamp(horizonBlend, 0.0, 1.0) * 0.55);
-  // The ambient term must be added to the procedural contribution, not replaced by it. A mix
-  // here discarded u_environmentColor * u_environmentIntensity entirely whenever a procedural
-  // map was present, which is the normal case: raising ambient intensity from 0.18 to 3.0 on
-  // the product-turntable kit produced a byte-identical frame. Ambient and a sky gradient are
-  // separate physical contributions, so they sum.
   vec3 environmentDiffuse = ambientEnvironment + proceduralDiffuse * u_environmentMapIntensity * proceduralEnvironmentWeight;
   float sampledEnvironmentWeight = step(0.0001, u_environmentMapTextureEnabled * u_environmentMapTextureIntensity);
   float diffuseEnvironmentLod = max(u_environmentMapTextureMipCount - 1.0, 0.0);
   vec3 sampledDiffuse = a3dPbrDecodeEnvironmentSample(a3dPbrEnvironmentSampleRaw(normal, diffuseEnvironmentLod));
-  return mix(environmentDiffuse, ambientEnvironment + sampledDiffuse * u_environmentMapTextureIntensity, sampledEnvironmentWeight);
+  return mix(environmentDiffuse, ambientEnvironment + sampledDiffuse * u_environmentMapTextureIntensity * u_materialEnvironmentIntensity, sampledEnvironmentWeight);
 }
 vec3 a3dPbrEnvironmentSpecularInput(vec3 normal, vec3 viewDirection, float roughness) {
   float proceduralEnvironmentWeight = step(0.0001, u_environmentMapIntensity);
@@ -304,7 +342,7 @@ vec3 a3dPbrEnvironmentSpecularInput(vec3 normal, vec3 viewDirection, float rough
   vec3 sampledSpecular = a3dPbrBoundHdrSpecularRadiance(a3dPbrDecodeEnvironmentSample(a3dPbrEnvironmentSampleRaw(reflectionDirection, environmentLod)));
   float nDotV = clamp(dot(normal, viewDirection), 0.0, 1.0);
   sampledSpecular = a3dPbrClampSampledSpecularEdgeEnergy(sampledSpecular, nDotV, clampedRoughness);
-  sampledSpecular *= u_environmentMapTextureSpecularIntensity * sampledEnvironmentWeight * mix(0.84, 0.58, clampedRoughness);
+  sampledSpecular *= u_environmentMapTextureSpecularIntensity * u_materialEnvironmentIntensity * sampledEnvironmentWeight * mix(0.84, 0.58, clampedRoughness);
   return proceduralSpecular + sampledSpecular;
 }
 vec2 a3dPbrEnvironmentBrdfInput(vec3 normal, vec3 viewDirection, float roughness) {
@@ -312,10 +350,16 @@ vec2 a3dPbrEnvironmentBrdfInput(vec3 normal, vec3 viewDirection, float roughness
   vec2 lut = texture(u_environmentBrdfLutTexture, vec2(nDotV, clamp(roughness, 0.0, 1.0))).rg;
   return mix(vec2(1.0, 0.0), lut, step(0.0001, u_environmentBrdfLutEnabled));
 }
+vec3 a3dLinearToSrgb(vec3 linear) {
+  vec3 clamped = max(linear, vec3(0.0));
+  vec3 low = clamped * 12.92;
+  vec3 high = 1.055 * pow(clamped, vec3(1.0 / 2.4)) - 0.055;
+  return mix(low, high, step(vec3(0.0031308), clamped));
+}
 vec3 a3dPbrEncodeOutput(vec3 linearColor) {
   vec3 color = max(linearColor, vec3(0.0));
   vec3 filmic = clamp((color * (2.51 * color + 0.03)) / (color * (2.43 * color + 0.59) + 0.14), vec3(0.0), vec3(1.0));
-  vec3 srgb = pow(filmic, vec3(1.0 / 2.2));
+  vec3 srgb = a3dLinearToSrgb(filmic);
   return mix(color, srgb, step(0.5, u_outputColorSpace));
 }
 void main() {
@@ -376,7 +420,7 @@ void main() {
       float inner = cos(spotShadowLayer.x * max(1.0 - spotShadowLayer.y, 0.001));
       attenuation *= smoothstep(outer, inner, cone);
     }
-    float shadowFactor = mix(1.0, kind > 0.5 && kind < 1.5 ? a3dPointShadowFactor(v_worldPosition, normal, lightDirection) : a3dForwardShadowFactor(v_worldPosition, normal, lightDirection), step(0.5, spotShadowLayer.z));
+    float shadowFactor = a3dResolveSpotShadowOverride(mix(1.0, kind > 0.5 && kind < 1.5 ? a3dPointShadowFactor(v_worldPosition, normal, lightDirection) : a3dForwardShadowFactor(v_worldPosition, normal, lightDirection), step(0.5, spotShadowLayer.z)), kind, spotShadowLayer.z, v_worldPosition, normal, lightDirection);
     shaded += a3dPbrDirectLight(normal, viewDirection, lightDirection, colorIntensity.rgb, colorIntensity.a * attenuation * shadowFactor, base, u_metallic, u_roughness, 1.0, vec3(1.0));
   }
   float alpha = u_baseColor.a * v_instanceColor.a;
@@ -395,10 +439,18 @@ precision highp float;
 layout(location = 0) in vec3 a_position;
 layout(location = 2) in vec2 a_uv;
 layout(location = 4) in vec4 a_color;
+layout(location = 8) in vec4 a_instanceMatrix0;
+layout(location = 9) in vec4 a_instanceMatrix1;
+layout(location = 10) in vec4 a_instanceMatrix2;
+layout(location = 11) in vec4 a_instanceMatrix3;
+layout(location = 12) in vec4 a_instanceColor;
 uniform mat4 u_modelViewProjection;
 uniform vec2 u_baseColorTextureOffset;
 uniform vec2 u_baseColorTextureScale;
 uniform float u_baseColorTextureRotation;
+uniform mat4 u_instanceMatrices[64];
+uniform float u_instanceCount;
+uniform float u_instanceAttributeMode;
 out vec2 v_uv;
 out vec4 v_vertexColor;
 void main() {
@@ -406,8 +458,16 @@ void main() {
   float c = cos(u_baseColorTextureRotation);
   float s = sin(u_baseColorTextureRotation);
   v_uv = vec2(scaledUv.x * c - scaledUv.y * s, scaledUv.x * s + scaledUv.y * c) + u_baseColorTextureOffset;
-  v_vertexColor = a_color;
-  gl_Position = u_modelViewProjection * vec4(a_position, 1.0);
+  if (u_instanceCount > 0.5) {
+    int instanceIndex = clamp(gl_InstanceID, 0, max(int(u_instanceCount) - 1, 0));
+    mat4 attributeMatrix = mat4(a_instanceMatrix0, a_instanceMatrix1, a_instanceMatrix2, a_instanceMatrix3);
+    mat4 instanceMatrix = u_instanceAttributeMode > 0.5 ? attributeMatrix : u_instanceMatrices[instanceIndex];
+    v_vertexColor = a_color * a_instanceColor;
+    gl_Position = u_modelViewProjection * instanceMatrix * vec4(a_position, 1.0);
+  } else {
+    v_vertexColor = a_color;
+    gl_Position = u_modelViewProjection * vec4(a_position, 1.0);
+  }
 }
 `,
         fragment: `#version 300 es
@@ -508,6 +568,7 @@ uniform float u_baseColorTextureEnabled;
 uniform sampler2D u_normalTexture;
 uniform float u_normalTextureEnabled;
 uniform float u_normalScale;
+uniform float u_wrinkleStrength;
 uniform sampler2D u_metallicRoughnessTexture;
 uniform float u_metallicRoughnessTextureEnabled;
 uniform sampler2D u_occlusionTexture;
@@ -520,6 +581,7 @@ uniform float u_metallic;
 uniform float u_roughness;
 uniform vec3 u_environmentColor;
 uniform float u_environmentIntensity;
+uniform float u_materialEnvironmentIntensity;
 uniform vec3 u_environmentSkyColor;
 uniform vec3 u_environmentHorizonColor;
 uniform vec3 u_environmentGroundColor;
@@ -593,6 +655,19 @@ uniform float u_pointShadowSlopeBias;
 uniform vec2 u_pointShadowTexelSize;
 uniform float u_pointShadowPcfSampleCount;
 uniform vec4 u_pointShadowPcfSamples[32];
+uniform sampler2D u_spotShadowMapTexture;
+uniform float u_spotShadowMapEnabled;
+uniform vec3 u_spotShadowLightPosition;
+uniform vec3 u_spotShadowLightDirection;
+uniform mat4 u_spotShadowMatrix;
+uniform vec2 u_spotShadowCone;
+uniform float u_spotShadowRange;
+uniform float u_spotShadowStrength;
+uniform float u_spotShadowBias;
+uniform float u_spotShadowSlopeBias;
+uniform vec2 u_spotShadowTexelSize;
+uniform float u_spotShadowPcfSampleCount;
+uniform vec4 u_spotShadowPcfSamples[32];
 uniform float u_outputColorSpace;
 uniform vec3 u_cameraPosition;
 uniform float u_environmentFogEnabled;
@@ -602,6 +677,9 @@ uniform float u_environmentFogNear;
 uniform float u_environmentFogFar;
 uniform float u_environmentFogDensity;
 uniform float u_environmentFogHeightFalloff;
+uniform float u_volumetricIntensity;
+uniform vec3 u_volumetricLightDirection;
+uniform vec3 u_volumetricLightColor;
 uniform float u_environmentFogHeightReference;
 uniform float u_environmentFogMaxOpacity;
 in vec3 v_normal;
@@ -649,6 +727,17 @@ vec4 a3dPbrEnvironmentSampleRaw(vec3 direction, float lod) {
   vec4 cubeSample = textureLod(u_environmentCubeMapTexture, a3dEnvironmentCubeDirection(direction, u_environmentMapTextureRotation), lod);
   return mix(equirectSample, cubeSample, step(0.5, u_environmentCubeMapTextureEnabled));
 }
+/**
+ * Procedural wrinkle detail (E1 face-rig demo): high-frequency normal perturbation driven
+ * by u_wrinkleStrength, which the engine resolves per frame from live morph weights
+ * (resolveWrinkleMapStrength). Stable in world space (no time input); strength 0 uploads
+ * 0 and the guarded call site below leaves the normal bit-identical.
+ */
+vec3 a3dWrinkleDetail(vec3 p) {
+  float f = sin(p.x * 230.0) * sin(p.y * 197.0 + 1.7) * sin(p.z * 211.0 + 0.6);
+  float g = sin(p.x * 97.0 + 0.4) * sin(p.y * 113.0 + 2.1) * sin(p.z * 103.0 + 1.2);
+  return vec3(f, g, f * g) * 0.35;
+}
 vec3 a3dSkinnedPbrNormal(vec3 baseNormal, vec4 tangentFrame, vec2 uv) {
   vec3 sampled = texture(u_normalTexture, uv).xyz * 2.0 - 1.0;
   vec3 n = normalize(baseNormal);
@@ -665,15 +754,6 @@ float a3dForwardShadowFactor(vec3 worldPosition, vec3 normal, vec3 lightDirectio
   vec3 receiverNormal = normalize(normal);
   vec3 receiverLightDirection = lightDirection / max(length(lightDirection), 0.0001);
   float normalDotLight = clamp(abs(dot(receiverNormal, receiverLightDirection)), 0.0, 1.0);
-  // Slope-scaled depth bias must be evaluated per PCF sample, not once for the kernel
-  // centre. A sample offset N texels away on a receiver sloped relative to the light sees a
-  // depth difference proportional to N, so a centre-only bias under-compensates every outer
-  // tap and the receiver shadows itself. Scaling by each sample's own texel distance keeps
-  // wide kernels acne-free without inflating the constant bias into peter-panning.
-  // The depth gradient across one shadow texel is tan(angle between receiver normal and
-  // light), not (1 - N.L). The linear form collapses toward zero far faster than the real
-  // gradient grows, so it under-biases exactly the grazing angles that need the most
-  // compensation. Clamped so a near-perpendicular receiver cannot demand unbounded bias.
   float slopeTangent = min(sqrt(max(1.0 - normalDotLight * normalDotLight, 0.0)) / max(normalDotLight, 0.05), 8.0);
   float slopeTexelBias = slopeTangent * u_shadowMapSlopeBias * max(u_shadowMapTexelSize.x, u_shadowMapTexelSize.y);
   float projectedDepth = projected.z * 0.5 + 0.5;
@@ -715,15 +795,6 @@ float a3dPointShadowFactor(vec3 worldPosition, vec3 normal, vec3 lightDirection)
   vec3 receiverNormal = normalize(normal);
   vec3 receiverLightDirection = lightDirection / max(length(lightDirection), 0.0001);
   float normalDotLight = clamp(abs(dot(receiverNormal, receiverLightDirection)), 0.0, 1.0);
-  // Slope-scaled depth bias must be evaluated per PCF sample, not once for the kernel
-  // centre. A sample offset N texels away on a receiver sloped relative to the light sees a
-  // depth difference proportional to N, so a centre-only bias under-compensates every outer
-  // tap and the receiver shadows itself. Scaling by each sample's own texel distance keeps
-  // wide kernels acne-free without inflating the constant bias into peter-panning.
-  // The depth gradient across one shadow texel is tan(angle between receiver normal and
-  // light), not (1 - N.L). The linear form collapses toward zero far faster than the real
-  // gradient grows, so it under-biases exactly the grazing angles that need the most
-  // compensation. Clamped so a near-perpendicular receiver cannot demand unbounded bias.
   float slopeTangent = min(sqrt(max(1.0 - normalDotLight * normalDotLight, 0.0)) / max(normalDotLight, 0.05), 8.0);
   float slopeTexelBias = slopeTangent * u_pointShadowSlopeBias * max(u_pointShadowTexelSize.x, u_pointShadowTexelSize.y);
   float projectedDepth = projected.z * 0.5 + 0.5;
@@ -744,15 +815,62 @@ float a3dPointShadowFactor(vec3 worldPosition, vec3 normal, vec3 lightDirection)
   float occlusion = totalWeight > 0.0 ? shadowed / totalWeight : 0.0;
   return mix(1.0, 1.0 - occlusion, clamp(u_pointShadowStrength, 0.0, 1.0));
 }
+float a3dSpotShadowFactor(vec3 worldPosition, vec3 normal, vec3 lightDirection) {
+  if (u_spotShadowMapEnabled < 0.5) return 1.0;
+  vec3 toFragment = worldPosition - u_spotShadowLightPosition;
+  float distanceToLight = max(length(toFragment), 0.0001);
+  if (distanceToLight > u_spotShadowRange) return 1.0;
+  vec3 coneAxis = u_spotShadowLightDirection / max(length(u_spotShadowLightDirection), 0.0001);
+  if (dot(toFragment / distanceToLight, coneAxis) < cos(u_spotShadowCone.x)) return 1.0;
+  vec4 lightPosition = u_spotShadowMatrix * vec4(worldPosition, 1.0);
+  vec3 projected = lightPosition.xyz / max(lightPosition.w, 0.0001);
+  vec2 uv = projected.xy * 0.5 + 0.5;
+  if (uv.x < 0.0 || uv.x > 1.0 || uv.y < 0.0 || uv.y > 1.0) return 1.0;
+  vec3 receiverNormal = normalize(normal);
+  vec3 receiverLightDirection = lightDirection / max(length(lightDirection), 0.0001);
+  float normalDotLight = clamp(abs(dot(receiverNormal, receiverLightDirection)), 0.0, 1.0);
+  float slopeTangent = min(sqrt(max(1.0 - normalDotLight * normalDotLight, 0.0)) / max(normalDotLight, 0.05), 8.0);
+  float slopeTexelBias = slopeTangent * u_spotShadowSlopeBias * max(u_spotShadowTexelSize.x, u_spotShadowTexelSize.y);
+  float projectedDepth = projected.z * 0.5 + 0.5;
+  float shadowed = 0.0;
+  float totalWeight = 0.0;
+  int sampleCount = clamp(int(u_spotShadowPcfSampleCount), 1, 32);
+  for (int i = 0; i < 32; ++i) {
+    if (i >= sampleCount) break;
+    vec4 sampleData = u_spotShadowPcfSamples[i];
+    float weight = max(sampleData.z, 0.0);
+    vec2 offset = sampleData.xy * u_spotShadowTexelSize;
+    float storedDepth = texture(u_spotShadowMapTexture, uv + offset).r;
+    float sampleTexelDistance = max(1.0, length(sampleData.xy));
+    float receiverDepth = projectedDepth - u_spotShadowBias - slopeTexelBias * sampleTexelDistance;
+    shadowed += (receiverDepth > storedDepth ? 1.0 : 0.0) * weight;
+    totalWeight += weight;
+  }
+  float occlusion = totalWeight > 0.0 ? shadowed / totalWeight : 0.0;
+  return mix(1.0, 1.0 - occlusion, clamp(u_spotShadowStrength, 0.0, 1.0));
+}
+float a3dResolveSpotShadowOverride(float baseFactor, float kind, float shadowFlag, vec3 worldPosition, vec3 normal, vec3 lightDirection) {
+  float spotGate = step(1.5, kind) * (1.0 - step(2.5, kind)) * step(0.5, u_spotShadowMapEnabled) * step(0.5, shadowFlag);
+  return mix(baseFactor, a3dSpotShadowFactor(worldPosition, normal, lightDirection), spotGate);
+}
+vec3 a3dLinearToSrgb(vec3 linear) {
+  vec3 clamped = max(linear, vec3(0.0));
+  vec3 low = clamped * 12.92;
+  vec3 high = 1.055 * pow(clamped, vec3(1.0 / 2.4)) - 0.055;
+  return mix(low, high, step(vec3(0.0031308), clamped));
+}
 vec3 a3dPbrEncodeOutput(vec3 linearColor) {
   vec3 color = max(linearColor, vec3(0.0));
   vec3 filmic = clamp((color * (2.51 * color + 0.03)) / (color * (2.43 * color + 0.59) + 0.14), vec3(0.0), vec3(1.0));
-  vec3 srgb = pow(filmic, vec3(1.0 / 2.2));
+  vec3 srgb = a3dLinearToSrgb(filmic);
   return mix(color, srgb, step(0.5, u_outputColorSpace));
 }
 void main() {
   vec3 normal = normalize(v_normal);
   normal = mix(normal, a3dSkinnedPbrNormal(v_normal, v_tangent, v_uv), step(0.5, u_normalTextureEnabled));
+  if (u_wrinkleStrength > 0.0) {
+    normal = normalize(normal + u_wrinkleStrength * a3dWrinkleDetail(v_worldPosition));
+  }
   if (!gl_FrontFacing) normal = -normal;
   vec3 viewDirection = normalize(u_cameraPosition - v_worldPosition);
   vec4 sampledBaseColor = texture(u_baseColorTexture, v_uv);
@@ -795,11 +913,6 @@ void main() {
   float horizonBlend = 1.0 - abs(normal.y);
   vec3 proceduralDiffuse = mix(u_environmentGroundColor, u_environmentSkyColor, skyBlend);
   proceduralDiffuse = mix(proceduralDiffuse, u_environmentHorizonColor, clamp(horizonBlend, 0.0, 1.0) * 0.55);
-  // The ambient term must be added to the procedural contribution, not replaced by it. A mix
-  // here discarded u_environmentColor * u_environmentIntensity entirely whenever a procedural
-  // map was present, which is the normal case: raising ambient intensity from 0.18 to 3.0 on
-  // the product-turntable kit produced a byte-identical frame. Ambient and a sky gradient are
-  // separate physical contributions, so they sum.
   vec3 environmentDiffuse = ambientEnvironment + proceduralDiffuse * u_environmentMapIntensity * proceduralEnvironmentWeight;
   vec3 reflectionDirection = reflect(-viewDirection, normal);
   float sampledEnvironmentWeight = step(0.0001, u_environmentMapTextureEnabled * u_environmentMapTextureIntensity);
@@ -822,11 +935,11 @@ void main() {
   float nDotV = clamp(dot(normal, viewDirection), 0.0, 1.0);
   vec2 brdfLut = texture(u_environmentBrdfLutTexture, vec2(nDotV, clampedRoughness)).rg;
   sampledSpecular = a3dPbrClampSampledSpecularEdgeEnergy(sampledSpecular, nDotV, clampedRoughness);
-  sampledSpecular *= u_environmentMapTextureSpecularIntensity * sampledEnvironmentWeight * mix(1.1, 0.65, roughness);
+  sampledSpecular *= u_environmentMapTextureSpecularIntensity * u_materialEnvironmentIntensity * sampledEnvironmentWeight * mix(1.1, 0.65, roughness);
   vec3 shaded = a3dPbrEnvironmentLightSplitSum(
     normal,
     viewDirection,
-    mix(environmentDiffuse, ambientEnvironment + sampledDiffuse * u_environmentMapTextureIntensity, sampledEnvironmentWeight),
+    mix(environmentDiffuse, ambientEnvironment + sampledDiffuse * u_environmentMapTextureIntensity * u_materialEnvironmentIntensity, sampledEnvironmentWeight),
     proceduralSpecular + sampledSpecular,
     mix(vec2(1.0, 0.0), brdfLut, step(0.0001, u_environmentBrdfLutEnabled)),
     materialBase,
@@ -881,7 +994,7 @@ void main() {
       viewDirection,
       lightDirection,
       colorIntensity.rgb,
-      colorIntensity.a * attenuation * mix(1.0, kind > 0.5 && kind < 1.5 ? a3dPointShadowFactor(v_worldPosition, normal, lightDirection) : a3dForwardShadowFactor(v_worldPosition, normal, lightDirection), step(0.5, spotShadowLayer.z)),
+      colorIntensity.a * attenuation * a3dResolveSpotShadowOverride(mix(1.0, kind > 0.5 && kind < 1.5 ? a3dPointShadowFactor(v_worldPosition, normal, lightDirection) : a3dForwardShadowFactor(v_worldPosition, normal, lightDirection), step(0.5, spotShadowLayer.z)), kind, spotShadowLayer.z, v_worldPosition, normal, lightDirection),
       materialBase,
       metallic,
       roughness,
@@ -966,8 +1079,6 @@ void main() {
     a_weights.x + a_weights.y + a_weights.z + a_weights.w +
     a_weights1.x + a_weights1.y + a_weights1.z + a_weights1.w;
   vec4 skinnedPosition = v_weightSum > 0.0001 ? skin * vec4(a_position, 1.0) : vec4(a_position, 1.0);
-  // Normals and tangents use the same skin matrix with w = 0 so translation is
-  // excluded; renormalizing happens in the fragment stage.
   vec3 skinnedNormal = (v_weightSum > 0.0001 ? skin * vec4(a_normal, 0.0) : vec4(a_normal, 0.0)).xyz;
   vec3 skinnedTangent = (v_weightSum > 0.0001 ? skin * vec4(a_tangent.xyz, 0.0) : vec4(a_tangent.xyz, 0.0)).xyz;
   v_normal = mat3(u_normalMatrix) * skinnedNormal;
@@ -987,6 +1098,7 @@ uniform float u_baseColorTextureEnabled;
 uniform sampler2D u_normalTexture;
 uniform float u_normalTextureEnabled;
 uniform float u_normalScale;
+uniform float u_wrinkleStrength;
 uniform sampler2D u_metallicRoughnessTexture;
 uniform float u_metallicRoughnessTextureEnabled;
 uniform sampler2D u_occlusionTexture;
@@ -999,6 +1111,7 @@ uniform float u_metallic;
 uniform float u_roughness;
 uniform vec3 u_environmentColor;
 uniform float u_environmentIntensity;
+uniform float u_materialEnvironmentIntensity;
 uniform vec3 u_environmentSkyColor;
 uniform vec3 u_environmentHorizonColor;
 uniform vec3 u_environmentGroundColor;
@@ -1072,6 +1185,19 @@ uniform float u_pointShadowSlopeBias;
 uniform vec2 u_pointShadowTexelSize;
 uniform float u_pointShadowPcfSampleCount;
 uniform vec4 u_pointShadowPcfSamples[32];
+uniform sampler2D u_spotShadowMapTexture;
+uniform float u_spotShadowMapEnabled;
+uniform vec3 u_spotShadowLightPosition;
+uniform vec3 u_spotShadowLightDirection;
+uniform mat4 u_spotShadowMatrix;
+uniform vec2 u_spotShadowCone;
+uniform float u_spotShadowRange;
+uniform float u_spotShadowStrength;
+uniform float u_spotShadowBias;
+uniform float u_spotShadowSlopeBias;
+uniform vec2 u_spotShadowTexelSize;
+uniform float u_spotShadowPcfSampleCount;
+uniform vec4 u_spotShadowPcfSamples[32];
 uniform float u_outputColorSpace;
 uniform vec3 u_cameraPosition;
 uniform float u_environmentFogEnabled;
@@ -1081,6 +1207,9 @@ uniform float u_environmentFogNear;
 uniform float u_environmentFogFar;
 uniform float u_environmentFogDensity;
 uniform float u_environmentFogHeightFalloff;
+uniform float u_volumetricIntensity;
+uniform vec3 u_volumetricLightDirection;
+uniform vec3 u_volumetricLightColor;
 uniform float u_environmentFogHeightReference;
 uniform float u_environmentFogMaxOpacity;
 in vec3 v_normal;
@@ -1128,6 +1257,17 @@ vec4 a3dPbrEnvironmentSampleRaw(vec3 direction, float lod) {
   vec4 cubeSample = textureLod(u_environmentCubeMapTexture, a3dEnvironmentCubeDirection(direction, u_environmentMapTextureRotation), lod);
   return mix(equirectSample, cubeSample, step(0.5, u_environmentCubeMapTextureEnabled));
 }
+/**
+ * Procedural wrinkle detail (E1 face-rig demo): high-frequency normal perturbation driven
+ * by u_wrinkleStrength, which the engine resolves per frame from live morph weights
+ * (resolveWrinkleMapStrength). Stable in world space (no time input); strength 0 uploads
+ * 0 and the guarded call site below leaves the normal bit-identical.
+ */
+vec3 a3dWrinkleDetail(vec3 p) {
+  float f = sin(p.x * 230.0) * sin(p.y * 197.0 + 1.7) * sin(p.z * 211.0 + 0.6);
+  float g = sin(p.x * 97.0 + 0.4) * sin(p.y * 113.0 + 2.1) * sin(p.z * 103.0 + 1.2);
+  return vec3(f, g, f * g) * 0.35;
+}
 vec3 a3dSkinnedPbrNormal(vec3 baseNormal, vec4 tangentFrame, vec2 uv) {
   vec3 sampled = texture(u_normalTexture, uv).xyz * 2.0 - 1.0;
   vec3 n = normalize(baseNormal);
@@ -1144,15 +1284,6 @@ float a3dForwardShadowFactor(vec3 worldPosition, vec3 normal, vec3 lightDirectio
   vec3 receiverNormal = normalize(normal);
   vec3 receiverLightDirection = lightDirection / max(length(lightDirection), 0.0001);
   float normalDotLight = clamp(abs(dot(receiverNormal, receiverLightDirection)), 0.0, 1.0);
-  // Slope-scaled depth bias must be evaluated per PCF sample, not once for the kernel
-  // centre. A sample offset N texels away on a receiver sloped relative to the light sees a
-  // depth difference proportional to N, so a centre-only bias under-compensates every outer
-  // tap and the receiver shadows itself. Scaling by each sample's own texel distance keeps
-  // wide kernels acne-free without inflating the constant bias into peter-panning.
-  // The depth gradient across one shadow texel is tan(angle between receiver normal and
-  // light), not (1 - N.L). The linear form collapses toward zero far faster than the real
-  // gradient grows, so it under-biases exactly the grazing angles that need the most
-  // compensation. Clamped so a near-perpendicular receiver cannot demand unbounded bias.
   float slopeTangent = min(sqrt(max(1.0 - normalDotLight * normalDotLight, 0.0)) / max(normalDotLight, 0.05), 8.0);
   float slopeTexelBias = slopeTangent * u_shadowMapSlopeBias * max(u_shadowMapTexelSize.x, u_shadowMapTexelSize.y);
   float projectedDepth = projected.z * 0.5 + 0.5;
@@ -1194,15 +1325,6 @@ float a3dPointShadowFactor(vec3 worldPosition, vec3 normal, vec3 lightDirection)
   vec3 receiverNormal = normalize(normal);
   vec3 receiverLightDirection = lightDirection / max(length(lightDirection), 0.0001);
   float normalDotLight = clamp(abs(dot(receiverNormal, receiverLightDirection)), 0.0, 1.0);
-  // Slope-scaled depth bias must be evaluated per PCF sample, not once for the kernel
-  // centre. A sample offset N texels away on a receiver sloped relative to the light sees a
-  // depth difference proportional to N, so a centre-only bias under-compensates every outer
-  // tap and the receiver shadows itself. Scaling by each sample's own texel distance keeps
-  // wide kernels acne-free without inflating the constant bias into peter-panning.
-  // The depth gradient across one shadow texel is tan(angle between receiver normal and
-  // light), not (1 - N.L). The linear form collapses toward zero far faster than the real
-  // gradient grows, so it under-biases exactly the grazing angles that need the most
-  // compensation. Clamped so a near-perpendicular receiver cannot demand unbounded bias.
   float slopeTangent = min(sqrt(max(1.0 - normalDotLight * normalDotLight, 0.0)) / max(normalDotLight, 0.05), 8.0);
   float slopeTexelBias = slopeTangent * u_pointShadowSlopeBias * max(u_pointShadowTexelSize.x, u_pointShadowTexelSize.y);
   float projectedDepth = projected.z * 0.5 + 0.5;
@@ -1223,15 +1345,62 @@ float a3dPointShadowFactor(vec3 worldPosition, vec3 normal, vec3 lightDirection)
   float occlusion = totalWeight > 0.0 ? shadowed / totalWeight : 0.0;
   return mix(1.0, 1.0 - occlusion, clamp(u_pointShadowStrength, 0.0, 1.0));
 }
+float a3dSpotShadowFactor(vec3 worldPosition, vec3 normal, vec3 lightDirection) {
+  if (u_spotShadowMapEnabled < 0.5) return 1.0;
+  vec3 toFragment = worldPosition - u_spotShadowLightPosition;
+  float distanceToLight = max(length(toFragment), 0.0001);
+  if (distanceToLight > u_spotShadowRange) return 1.0;
+  vec3 coneAxis = u_spotShadowLightDirection / max(length(u_spotShadowLightDirection), 0.0001);
+  if (dot(toFragment / distanceToLight, coneAxis) < cos(u_spotShadowCone.x)) return 1.0;
+  vec4 lightPosition = u_spotShadowMatrix * vec4(worldPosition, 1.0);
+  vec3 projected = lightPosition.xyz / max(lightPosition.w, 0.0001);
+  vec2 uv = projected.xy * 0.5 + 0.5;
+  if (uv.x < 0.0 || uv.x > 1.0 || uv.y < 0.0 || uv.y > 1.0) return 1.0;
+  vec3 receiverNormal = normalize(normal);
+  vec3 receiverLightDirection = lightDirection / max(length(lightDirection), 0.0001);
+  float normalDotLight = clamp(abs(dot(receiverNormal, receiverLightDirection)), 0.0, 1.0);
+  float slopeTangent = min(sqrt(max(1.0 - normalDotLight * normalDotLight, 0.0)) / max(normalDotLight, 0.05), 8.0);
+  float slopeTexelBias = slopeTangent * u_spotShadowSlopeBias * max(u_spotShadowTexelSize.x, u_spotShadowTexelSize.y);
+  float projectedDepth = projected.z * 0.5 + 0.5;
+  float shadowed = 0.0;
+  float totalWeight = 0.0;
+  int sampleCount = clamp(int(u_spotShadowPcfSampleCount), 1, 32);
+  for (int i = 0; i < 32; ++i) {
+    if (i >= sampleCount) break;
+    vec4 sampleData = u_spotShadowPcfSamples[i];
+    float weight = max(sampleData.z, 0.0);
+    vec2 offset = sampleData.xy * u_spotShadowTexelSize;
+    float storedDepth = texture(u_spotShadowMapTexture, uv + offset).r;
+    float sampleTexelDistance = max(1.0, length(sampleData.xy));
+    float receiverDepth = projectedDepth - u_spotShadowBias - slopeTexelBias * sampleTexelDistance;
+    shadowed += (receiverDepth > storedDepth ? 1.0 : 0.0) * weight;
+    totalWeight += weight;
+  }
+  float occlusion = totalWeight > 0.0 ? shadowed / totalWeight : 0.0;
+  return mix(1.0, 1.0 - occlusion, clamp(u_spotShadowStrength, 0.0, 1.0));
+}
+float a3dResolveSpotShadowOverride(float baseFactor, float kind, float shadowFlag, vec3 worldPosition, vec3 normal, vec3 lightDirection) {
+  float spotGate = step(1.5, kind) * (1.0 - step(2.5, kind)) * step(0.5, u_spotShadowMapEnabled) * step(0.5, shadowFlag);
+  return mix(baseFactor, a3dSpotShadowFactor(worldPosition, normal, lightDirection), spotGate);
+}
+vec3 a3dLinearToSrgb(vec3 linear) {
+  vec3 clamped = max(linear, vec3(0.0));
+  vec3 low = clamped * 12.92;
+  vec3 high = 1.055 * pow(clamped, vec3(1.0 / 2.4)) - 0.055;
+  return mix(low, high, step(vec3(0.0031308), clamped));
+}
 vec3 a3dPbrEncodeOutput(vec3 linearColor) {
   vec3 color = max(linearColor, vec3(0.0));
   vec3 filmic = clamp((color * (2.51 * color + 0.03)) / (color * (2.43 * color + 0.59) + 0.14), vec3(0.0), vec3(1.0));
-  vec3 srgb = pow(filmic, vec3(1.0 / 2.2));
+  vec3 srgb = a3dLinearToSrgb(filmic);
   return mix(color, srgb, step(0.5, u_outputColorSpace));
 }
 void main() {
   vec3 normal = normalize(v_normal);
   normal = mix(normal, a3dSkinnedPbrNormal(v_normal, v_tangent, v_uv), step(0.5, u_normalTextureEnabled));
+  if (u_wrinkleStrength > 0.0) {
+    normal = normalize(normal + u_wrinkleStrength * a3dWrinkleDetail(v_worldPosition));
+  }
   if (!gl_FrontFacing) normal = -normal;
   vec3 viewDirection = normalize(u_cameraPosition - v_worldPosition);
   vec4 sampledBaseColor = texture(u_baseColorTexture, v_uv);
@@ -1274,11 +1443,6 @@ void main() {
   float horizonBlend = 1.0 - abs(normal.y);
   vec3 proceduralDiffuse = mix(u_environmentGroundColor, u_environmentSkyColor, skyBlend);
   proceduralDiffuse = mix(proceduralDiffuse, u_environmentHorizonColor, clamp(horizonBlend, 0.0, 1.0) * 0.55);
-  // The ambient term must be added to the procedural contribution, not replaced by it. A mix
-  // here discarded u_environmentColor * u_environmentIntensity entirely whenever a procedural
-  // map was present, which is the normal case: raising ambient intensity from 0.18 to 3.0 on
-  // the product-turntable kit produced a byte-identical frame. Ambient and a sky gradient are
-  // separate physical contributions, so they sum.
   vec3 environmentDiffuse = ambientEnvironment + proceduralDiffuse * u_environmentMapIntensity * proceduralEnvironmentWeight;
   vec3 reflectionDirection = reflect(-viewDirection, normal);
   float sampledEnvironmentWeight = step(0.0001, u_environmentMapTextureEnabled * u_environmentMapTextureIntensity);
@@ -1301,11 +1465,11 @@ void main() {
   float nDotV = clamp(dot(normal, viewDirection), 0.0, 1.0);
   vec2 brdfLut = texture(u_environmentBrdfLutTexture, vec2(nDotV, clampedRoughness)).rg;
   sampledSpecular = a3dPbrClampSampledSpecularEdgeEnergy(sampledSpecular, nDotV, clampedRoughness);
-  sampledSpecular *= u_environmentMapTextureSpecularIntensity * sampledEnvironmentWeight * mix(1.1, 0.65, roughness);
+  sampledSpecular *= u_environmentMapTextureSpecularIntensity * u_materialEnvironmentIntensity * sampledEnvironmentWeight * mix(1.1, 0.65, roughness);
   vec3 shaded = a3dPbrEnvironmentLightSplitSum(
     normal,
     viewDirection,
-    mix(environmentDiffuse, ambientEnvironment + sampledDiffuse * u_environmentMapTextureIntensity, sampledEnvironmentWeight),
+    mix(environmentDiffuse, ambientEnvironment + sampledDiffuse * u_environmentMapTextureIntensity * u_materialEnvironmentIntensity, sampledEnvironmentWeight),
     proceduralSpecular + sampledSpecular,
     mix(vec2(1.0, 0.0), brdfLut, step(0.0001, u_environmentBrdfLutEnabled)),
     materialBase,
@@ -1360,7 +1524,7 @@ void main() {
       viewDirection,
       lightDirection,
       colorIntensity.rgb,
-      colorIntensity.a * attenuation * mix(1.0, kind > 0.5 && kind < 1.5 ? a3dPointShadowFactor(v_worldPosition, normal, lightDirection) : a3dForwardShadowFactor(v_worldPosition, normal, lightDirection), step(0.5, spotShadowLayer.z)),
+      colorIntensity.a * attenuation * a3dResolveSpotShadowOverride(mix(1.0, kind > 0.5 && kind < 1.5 ? a3dPointShadowFactor(v_worldPosition, normal, lightDirection) : a3dForwardShadowFactor(v_worldPosition, normal, lightDirection), step(0.5, spotShadowLayer.z)), kind, spotShadowLayer.z, v_worldPosition, normal, lightDirection),
       materialBase,
       metallic,
       roughness,
@@ -1382,18 +1546,15 @@ void main() {
 precision highp float;
 layout(location = 0) in vec3 a_position;
 uniform mat4 u_modelViewProjection;
-// Uniform fast path (<= 4 targets / 64 verts):
 uniform vec4 u_morphPositionDeltas[256];
 uniform vec4 u_morphWeights;
 uniform float u_morphTargetCount;
-// Texture-backed path (lifts the 4/64 cap; see MorphTargetPlan.ts createMorphTargetPlan):
 uniform sampler2D u_morphDeltaTexture;
-uniform float u_morphUsesTexture;     // > 0.5 => sample deltas from the texture
-uniform float u_morphTextureWidth;    // = vertexCount
-uniform float u_morphRowsPerTarget;   // 1 = positions only, 2 = positions + normals
-uniform float u_morphWeightArray[64]; // per-target weights for the texture path
+uniform float u_morphUsesTexture;
+uniform float u_morphTextureWidth;
+uniform float u_morphRowsPerTarget;
+uniform float u_morphWeightArray[64];
 vec3 sampleMorphTexel(float row, float vertex) {
-  // Fetch RGBA float texel at (x=vertex, y=row) using normalized coords + nearest filtering.
   float u = (vertex + 0.5) / max(1.0, u_morphTextureWidth);
   float height = u_morphTargetCount * u_morphRowsPerTarget;
   float v = (row + 0.5) / max(1.0, height);
@@ -1443,21 +1604,42 @@ layout(location = 2) in vec2 a_uv;
 layout(location = 3) in vec4 a_tangent;
 layout(location = 4) in vec4 a_color;
 layout(location = 7) in vec2 a_uv1;
+layout(location = 8) in vec4 a_instanceMatrix0;
+layout(location = 9) in vec4 a_instanceMatrix1;
+layout(location = 10) in vec4 a_instanceMatrix2;
+layout(location = 11) in vec4 a_instanceMatrix3;
+layout(location = 12) in vec4 a_instanceColor;
 uniform mat4 u_modelViewProjection;
 uniform mat4 u_modelMatrix;
 uniform mat4 u_normalMatrix;
+uniform mat4 u_instanceMatrices[64];
+uniform float u_instanceCount;
+uniform float u_instanceAttributeMode;
 out vec3 v_normal;
 out vec4 v_tangent;
 out vec3 v_worldPosition;
 out vec2 v_uv;
 out vec4 v_vertexColor;
 void main() {
-  v_normal = mat3(u_normalMatrix) * a_normal;
-  v_tangent = vec4(mat3(u_normalMatrix) * a_tangent.xyz, a_tangent.w);
-  v_worldPosition = (u_modelMatrix * vec4(a_position, 1.0)).xyz;
-  v_uv = a_uv;
-  v_vertexColor = a_color;
-  gl_Position = u_modelViewProjection * vec4(a_position, 1.0);
+  if (u_instanceCount > 0.5) {
+    int instanceIndex = clamp(gl_InstanceID, 0, max(int(u_instanceCount) - 1, 0));
+    mat4 attributeMatrix = mat4(a_instanceMatrix0, a_instanceMatrix1, a_instanceMatrix2, a_instanceMatrix3);
+    mat4 instanceMatrix = u_instanceAttributeMode > 0.5 ? attributeMatrix : u_instanceMatrices[instanceIndex];
+    vec4 worldPosition = u_modelMatrix * instanceMatrix * vec4(a_position, 1.0);
+    v_normal = mat3(u_normalMatrix) * transpose(inverse(mat3(instanceMatrix))) * a_normal;
+    v_tangent = vec4(mat3(u_normalMatrix) * (mat3(instanceMatrix) * a_tangent.xyz), a_tangent.w);
+    v_worldPosition = worldPosition.xyz;
+    v_uv = a_uv;
+    v_vertexColor = a_color * a_instanceColor;
+    gl_Position = u_modelViewProjection * instanceMatrix * vec4(a_position, 1.0);
+  } else {
+    v_normal = mat3(u_normalMatrix) * a_normal;
+    v_tangent = vec4(mat3(u_normalMatrix) * a_tangent.xyz, a_tangent.w);
+    v_worldPosition = (u_modelMatrix * vec4(a_position, 1.0)).xyz;
+    v_uv = a_uv;
+    v_vertexColor = a_color;
+    gl_Position = u_modelViewProjection * vec4(a_position, 1.0);
+  }
 }
 `,
         fragment: `#version 300 es
@@ -1471,6 +1653,7 @@ uniform float u_metallic;
 uniform float u_roughness;
 uniform vec3 u_environmentColor;
 uniform float u_environmentIntensity;
+uniform float u_materialEnvironmentIntensity;
 uniform vec3 u_environmentSkyColor;
 uniform vec3 u_environmentHorizonColor;
 uniform vec3 u_environmentGroundColor;
@@ -1539,6 +1722,19 @@ uniform float u_pointShadowSlopeBias;
 uniform vec2 u_pointShadowTexelSize;
 uniform float u_pointShadowPcfSampleCount;
 uniform vec4 u_pointShadowPcfSamples[32];
+uniform sampler2D u_spotShadowMapTexture;
+uniform float u_spotShadowMapEnabled;
+uniform vec3 u_spotShadowLightPosition;
+uniform vec3 u_spotShadowLightDirection;
+uniform mat4 u_spotShadowMatrix;
+uniform vec2 u_spotShadowCone;
+uniform float u_spotShadowRange;
+uniform float u_spotShadowStrength;
+uniform float u_spotShadowBias;
+uniform float u_spotShadowSlopeBias;
+uniform vec2 u_spotShadowTexelSize;
+uniform float u_spotShadowPcfSampleCount;
+uniform vec4 u_spotShadowPcfSamples[32];
 uniform float u_outputColorSpace;
 uniform vec3 u_cameraPosition;
 uniform float u_environmentFogEnabled;
@@ -1548,6 +1744,9 @@ uniform float u_environmentFogNear;
 uniform float u_environmentFogFar;
 uniform float u_environmentFogDensity;
 uniform float u_environmentFogHeightFalloff;
+uniform float u_volumetricIntensity;
+uniform vec3 u_volumetricLightDirection;
+uniform vec3 u_volumetricLightColor;
 uniform float u_environmentFogHeightReference;
 uniform float u_environmentFogMaxOpacity;
 in vec3 v_normal;
@@ -1573,15 +1772,6 @@ float a3dForwardShadowFactor(vec3 worldPosition, vec3 normal, vec3 lightDirectio
   vec3 receiverNormal = normalize(normal);
   vec3 receiverLightDirection = lightDirection / max(length(lightDirection), 0.0001);
   float normalDotLight = clamp(abs(dot(receiverNormal, receiverLightDirection)), 0.0, 1.0);
-  // Slope-scaled depth bias must be evaluated per PCF sample, not once for the kernel
-  // centre. A sample offset N texels away on a receiver sloped relative to the light sees a
-  // depth difference proportional to N, so a centre-only bias under-compensates every outer
-  // tap and the receiver shadows itself. Scaling by each sample's own texel distance keeps
-  // wide kernels acne-free without inflating the constant bias into peter-panning.
-  // The depth gradient across one shadow texel is tan(angle between receiver normal and
-  // light), not (1 - N.L). The linear form collapses toward zero far faster than the real
-  // gradient grows, so it under-biases exactly the grazing angles that need the most
-  // compensation. Clamped so a near-perpendicular receiver cannot demand unbounded bias.
   float slopeTangent = min(sqrt(max(1.0 - normalDotLight * normalDotLight, 0.0)) / max(normalDotLight, 0.05), 8.0);
   float slopeTexelBias = slopeTangent * u_shadowMapSlopeBias * max(u_shadowMapTexelSize.x, u_shadowMapTexelSize.y);
   float projectedDepth = projected.z * 0.5 + 0.5;
@@ -1614,9 +1804,6 @@ float a3dPointShadowFactor(vec3 worldPosition, vec3 normal, vec3 lightDirection)
   vec4 rect = u_pointShadowFaceRects[faceIndex];
   vec2 uv = rect.xy + localUv * rect.zw;
   float normalDotLight = clamp(abs(dot(normalize(normal), normalize(lightDirection))), 0.0, 1.0);
-  // Same per-sample, tangent-scaled slope bias as the directional and atlas paths. These
-  // cubemap-face variants inline the sample fetch, but they share the identical acne
-  // mechanism: a centre-only, (1 - N.L)-scaled bias under-compensates every outer tap.
   float slopeTangent = min(sqrt(max(1.0 - normalDotLight * normalDotLight, 0.0)) / max(normalDotLight, 0.05), 8.0);
   float slopeTexelBias = slopeTangent * u_pointShadowSlopeBias * max(u_pointShadowTexelSize.x, u_pointShadowTexelSize.y);
   float projectedDepth = projected.z * 0.5 + 0.5;
@@ -1635,6 +1822,44 @@ float a3dPointShadowFactor(vec3 worldPosition, vec3 normal, vec3 lightDirection)
   float occlusion = totalWeight > 0.0 ? shadowed / totalWeight : 0.0;
   return mix(1.0, 1.0 - occlusion, clamp(u_pointShadowStrength, 0.0, 1.0));
 }
+float a3dSpotShadowFactor(vec3 worldPosition, vec3 normal, vec3 lightDirection) {
+  if (u_spotShadowMapEnabled < 0.5) return 1.0;
+  vec3 toFragment = worldPosition - u_spotShadowLightPosition;
+  float distanceToLight = max(length(toFragment), 0.0001);
+  if (distanceToLight > u_spotShadowRange) return 1.0;
+  vec3 coneAxis = u_spotShadowLightDirection / max(length(u_spotShadowLightDirection), 0.0001);
+  if (dot(toFragment / distanceToLight, coneAxis) < cos(u_spotShadowCone.x)) return 1.0;
+  vec4 lightPosition = u_spotShadowMatrix * vec4(worldPosition, 1.0);
+  vec3 projected = lightPosition.xyz / max(lightPosition.w, 0.0001);
+  vec2 uv = projected.xy * 0.5 + 0.5;
+  if (uv.x < 0.0 || uv.x > 1.0 || uv.y < 0.0 || uv.y > 1.0) return 1.0;
+  vec3 receiverNormal = normalize(normal);
+  vec3 receiverLightDirection = lightDirection / max(length(lightDirection), 0.0001);
+  float normalDotLight = clamp(abs(dot(receiverNormal, receiverLightDirection)), 0.0, 1.0);
+  float slopeTangent = min(sqrt(max(1.0 - normalDotLight * normalDotLight, 0.0)) / max(normalDotLight, 0.05), 8.0);
+  float slopeTexelBias = slopeTangent * u_spotShadowSlopeBias * max(u_spotShadowTexelSize.x, u_spotShadowTexelSize.y);
+  float projectedDepth = projected.z * 0.5 + 0.5;
+  float shadowed = 0.0;
+  float totalWeight = 0.0;
+  int sampleCount = clamp(int(u_spotShadowPcfSampleCount), 1, 32);
+  for (int i = 0; i < 32; ++i) {
+    if (i >= sampleCount) break;
+    vec4 sampleData = u_spotShadowPcfSamples[i];
+    float weight = max(sampleData.z, 0.0);
+    vec2 offset = sampleData.xy * u_spotShadowTexelSize;
+    float storedDepth = texture(u_spotShadowMapTexture, uv + offset).r;
+    float sampleTexelDistance = max(1.0, length(sampleData.xy));
+    float receiverDepth = projectedDepth - u_spotShadowBias - slopeTexelBias * sampleTexelDistance;
+    shadowed += (receiverDepth > storedDepth ? 1.0 : 0.0) * weight;
+    totalWeight += weight;
+  }
+  float occlusion = totalWeight > 0.0 ? shadowed / totalWeight : 0.0;
+  return mix(1.0, 1.0 - occlusion, clamp(u_spotShadowStrength, 0.0, 1.0));
+}
+float a3dResolveSpotShadowOverride(float baseFactor, float kind, float shadowFlag, vec3 worldPosition, vec3 normal, vec3 lightDirection) {
+  float spotGate = step(1.5, kind) * (1.0 - step(2.5, kind)) * step(0.5, u_spotShadowMapEnabled) * step(0.5, shadowFlag);
+  return mix(baseFactor, a3dSpotShadowFactor(worldPosition, normal, lightDirection), spotGate);
+}
 vec2 a3dEnvironmentEquirectUv(vec3 direction, float rotation) {
   vec3 d = normalize(direction);
   float u = atan(d.z, d.x) / 6.28318530718 + 0.5 + rotation;
@@ -1680,16 +1905,11 @@ vec3 a3dPbrEnvironmentDiffuseInput(vec3 normal) {
   float horizonBlend = 1.0 - abs(normal.y);
   vec3 proceduralDiffuse = mix(u_environmentGroundColor, u_environmentSkyColor, skyBlend);
   proceduralDiffuse = mix(proceduralDiffuse, u_environmentHorizonColor, clamp(horizonBlend, 0.0, 1.0) * 0.55);
-  // The ambient term must be added to the procedural contribution, not replaced by it. A mix
-  // here discarded u_environmentColor * u_environmentIntensity entirely whenever a procedural
-  // map was present, which is the normal case: raising ambient intensity from 0.18 to 3.0 on
-  // the product-turntable kit produced a byte-identical frame. Ambient and a sky gradient are
-  // separate physical contributions, so they sum.
   vec3 environmentDiffuse = ambientEnvironment + proceduralDiffuse * u_environmentMapIntensity * proceduralEnvironmentWeight;
   float sampledEnvironmentWeight = step(0.0001, u_environmentMapTextureEnabled * u_environmentMapTextureIntensity);
   float diffuseEnvironmentLod = max(u_environmentMapTextureMipCount - 1.0, 0.0);
   vec3 sampledDiffuse = a3dPbrDecodeEnvironmentSample(a3dPbrEnvironmentSampleRaw(normal, diffuseEnvironmentLod));
-  return mix(environmentDiffuse, ambientEnvironment + sampledDiffuse * u_environmentMapTextureIntensity, sampledEnvironmentWeight);
+  return mix(environmentDiffuse, ambientEnvironment + sampledDiffuse * u_environmentMapTextureIntensity * u_materialEnvironmentIntensity, sampledEnvironmentWeight);
 }
 vec3 a3dPbrEnvironmentSpecularInput(vec3 normal, vec3 viewDirection, float roughness) {
   float proceduralEnvironmentWeight = step(0.0001, u_environmentMapIntensity);
@@ -1704,7 +1924,7 @@ vec3 a3dPbrEnvironmentSpecularInput(vec3 normal, vec3 viewDirection, float rough
   vec3 sampledSpecular = a3dPbrBoundHdrSpecularRadiance(a3dPbrDecodeEnvironmentSample(a3dPbrEnvironmentSampleRaw(reflectionDirection, environmentLod)));
   float nDotV = clamp(dot(normal, viewDirection), 0.0, 1.0);
   sampledSpecular = a3dPbrClampSampledSpecularEdgeEnergy(sampledSpecular, nDotV, clampedRoughness);
-  sampledSpecular *= u_environmentMapTextureSpecularIntensity * sampledEnvironmentWeight * mix(0.84, 0.58, clampedRoughness);
+  sampledSpecular *= u_environmentMapTextureSpecularIntensity * u_materialEnvironmentIntensity * sampledEnvironmentWeight * mix(0.84, 0.58, clampedRoughness);
   return proceduralSpecular + sampledSpecular;
 }
 vec2 a3dPbrEnvironmentBrdfInput(vec3 normal, vec3 viewDirection, float roughness) {
@@ -1712,10 +1932,16 @@ vec2 a3dPbrEnvironmentBrdfInput(vec3 normal, vec3 viewDirection, float roughness
   vec2 lut = texture(u_environmentBrdfLutTexture, vec2(nDotV, clamp(roughness, 0.0, 1.0))).rg;
   return mix(vec2(1.0, 0.0), lut, step(0.0001, u_environmentBrdfLutEnabled));
 }
+vec3 a3dLinearToSrgb(vec3 linear) {
+  vec3 clamped = max(linear, vec3(0.0));
+  vec3 low = clamped * 12.92;
+  vec3 high = 1.055 * pow(clamped, vec3(1.0 / 2.4)) - 0.055;
+  return mix(low, high, step(vec3(0.0031308), clamped));
+}
 vec3 a3dPbrEncodeOutput(vec3 linearColor) {
   vec3 color = max(linearColor, vec3(0.0));
   vec3 filmic = clamp((color * (2.51 * color + 0.03)) / (color * (2.43 * color + 0.59) + 0.14), vec3(0.0), vec3(1.0));
-  vec3 srgb = pow(filmic, vec3(1.0 / 2.2));
+  vec3 srgb = a3dLinearToSrgb(filmic);
   return mix(color, srgb, step(0.5, u_outputColorSpace));
 }
 void main() {
@@ -1776,7 +2002,7 @@ void main() {
       float inner = cos(spotShadowLayer.x * max(1.0 - spotShadowLayer.y, 0.001));
       attenuation *= smoothstep(outer, inner, cone);
     }
-    float shadowFactor = mix(1.0, kind > 0.5 && kind < 1.5 ? a3dPointShadowFactor(v_worldPosition, mappedNormal, lightDirection) : a3dForwardShadowFactor(v_worldPosition, mappedNormal, lightDirection), step(0.5, spotShadowLayer.z));
+    float shadowFactor = a3dResolveSpotShadowOverride(mix(1.0, kind > 0.5 && kind < 1.5 ? a3dPointShadowFactor(v_worldPosition, mappedNormal, lightDirection) : a3dForwardShadowFactor(v_worldPosition, mappedNormal, lightDirection), step(0.5, spotShadowLayer.z)), kind, spotShadowLayer.z, v_worldPosition, mappedNormal, lightDirection);
     shaded += a3dPbrDirectLight(mappedNormal, viewDirection, lightDirection, colorIntensity.rgb, colorIntensity.a * attenuation * shadowFactor, materialBase, u_metallic, u_roughness, u_specularFactor, u_specularColorFactor);
   }
   float alpha = u_baseColor.a * v_vertexColor.a;
@@ -1790,13 +2016,16 @@ void main() {
         name: DEFAULT_TEXTURED_PBR_SHADER_NAME,
         marker: DEFAULT_TEXTURED_PBR_SHADER_MARKER,
         variants: [
+            { name: DEFAULT_TEXTURED_PBR_EXTENSION_ATLAS_VARIANT, defines: { A3D_PBR_EXTENSION_ATLAS: true, A3D_PBR_CLEARCOAT_TEXTURES: true, A3D_PBR_SPECULAR_SHEEN_ANISOTROPY_TEXTURES: true, A3D_PBR_IRIDESCENCE_TEXTURES: true, A3D_PBR_DISABLE_TRANSMISSION_BACKDROP: true, A3D_PBR_DISABLE_CLUSTERED_LIGHTING: true } },
+            { name: DEFAULT_TEXTURED_PBR_CLEARCOAT_SHEEN_ANISOTROPY_TEXTURES_VARIANT, defines: { A3D_PBR_CLEARCOAT_TEXTURES: true, A3D_PBR_SPECULAR_SHEEN_ANISOTROPY_TEXTURES: true, A3D_PBR_DISABLE_TRANSMISSION_BACKDROP: true, A3D_PBR_DISABLE_CLUSTERED_LIGHTING: true, A3D_PBR_NO_SPOT_SHADOW: true } },
+            { name: DEFAULT_TEXTURED_PBR_CLEARCOAT_IRIDESCENCE_TEXTURES_VARIANT, defines: { A3D_PBR_CLEARCOAT_TEXTURES: true, A3D_PBR_IRIDESCENCE_TEXTURES: true, A3D_PBR_DISABLE_TRANSMISSION_BACKDROP: true, A3D_PBR_DISABLE_CLUSTERED_LIGHTING: true } },
             { name: DEFAULT_TEXTURED_PBR_CLEARCOAT_TEXTURES_VARIANT, defines: { A3D_PBR_CLEARCOAT_TEXTURES: true, A3D_PBR_DISABLE_TRANSMISSION_BACKDROP: true, A3D_PBR_DISABLE_CLUSTERED_LIGHTING: true } },
             { name: DEFAULT_TEXTURED_PBR_TRANSMISSION_VOLUME_TEXTURES_VARIANT, defines: { A3D_PBR_TRANSMISSION_VOLUME_TEXTURES: true, A3D_PBR_DISABLE_TRANSMISSION_BACKDROP: true, A3D_PBR_DISABLE_CLUSTERED_LIGHTING: true } },
             { name: DEFAULT_TEXTURED_PBR_SPECULAR_SHEEN_ANISOTROPY_TEXTURES_VARIANT, defines: { A3D_PBR_SPECULAR_TEXTURES: true, A3D_PBR_SPECULAR_SHEEN_ANISOTROPY_TEXTURES: true, A3D_PBR_DISABLE_TRANSMISSION_BACKDROP: true, A3D_PBR_DISABLE_CLUSTERED_LIGHTING: true } },
             { name: DEFAULT_TEXTURED_PBR_IRIDESCENCE_TEXTURES_VARIANT, defines: { A3D_PBR_IRIDESCENCE_TEXTURES: true, A3D_PBR_DISABLE_TRANSMISSION_BACKDROP: true, A3D_PBR_DISABLE_CLUSTERED_LIGHTING: true } },
-            { name: DEFAULT_TEXTURED_PBR_CLEARCOAT_TRANSMISSION_VOLUME_TEXTURES_VARIANT, defines: { A3D_PBR_CLEARCOAT_TEXTURES: true, A3D_PBR_TRANSMISSION_VOLUME_TEXTURES: true, A3D_PBR_DISABLE_TRANSMISSION_BACKDROP: true, A3D_PBR_DISABLE_CLUSTERED_LIGHTING: true } },
+            { name: DEFAULT_TEXTURED_PBR_CLEARCOAT_TRANSMISSION_VOLUME_TEXTURES_VARIANT, defines: { A3D_PBR_CLEARCOAT_TEXTURES: true, A3D_PBR_TRANSMISSION_VOLUME_TEXTURES: true, A3D_PBR_DISABLE_TRANSMISSION_BACKDROP: true, A3D_PBR_DISABLE_CLUSTERED_LIGHTING: true, A3D_PBR_NO_SPOT_SHADOW: true } },
             { name: DEFAULT_TEXTURED_PBR_CLEARCOAT_SPECULAR_TEXTURES_VARIANT, defines: { A3D_PBR_CLEARCOAT_TEXTURES: true, A3D_PBR_SPECULAR_TEXTURES: true, A3D_PBR_DISABLE_TRANSMISSION_BACKDROP: true, A3D_PBR_DISABLE_CLUSTERED_LIGHTING: true } },
-            { name: DEFAULT_TEXTURED_PBR_SPECULAR_SHEEN_ANISOTROPY_IRIDESCENCE_TEXTURES_VARIANT, defines: { A3D_PBR_SPECULAR_TEXTURES: true, A3D_PBR_SPECULAR_SHEEN_ANISOTROPY_TEXTURES: true, A3D_PBR_IRIDESCENCE_TEXTURES: true, A3D_PBR_DISABLE_TRANSMISSION_BACKDROP: true, A3D_PBR_DISABLE_CLUSTERED_LIGHTING: true } }
+            { name: DEFAULT_TEXTURED_PBR_SPECULAR_SHEEN_ANISOTROPY_IRIDESCENCE_TEXTURES_VARIANT, defines: { A3D_PBR_SPECULAR_TEXTURES: true, A3D_PBR_SPECULAR_SHEEN_ANISOTROPY_TEXTURES: true, A3D_PBR_IRIDESCENCE_TEXTURES: true, A3D_PBR_DISABLE_TRANSMISSION_BACKDROP: true, A3D_PBR_DISABLE_CLUSTERED_LIGHTING: true, A3D_PBR_NO_SPOT_SHADOW: true } },
         ],
         vertex: `#version 300 es
 // ${DEFAULT_TEXTURED_PBR_SHADER_MARKER}
@@ -1807,9 +2036,17 @@ layout(location = 2) in vec2 a_uv;
 layout(location = 3) in vec4 a_tangent;
 layout(location = 4) in vec4 a_color;
 layout(location = 7) in vec2 a_uv1;
+layout(location = 8) in vec4 a_instanceMatrix0;
+layout(location = 9) in vec4 a_instanceMatrix1;
+layout(location = 10) in vec4 a_instanceMatrix2;
+layout(location = 11) in vec4 a_instanceMatrix3;
+layout(location = 12) in vec4 a_instanceColor;
 uniform mat4 u_modelViewProjection;
 uniform mat4 u_modelMatrix;
 uniform mat4 u_normalMatrix;
+uniform mat4 u_instanceMatrices[64];
+uniform float u_instanceCount;
+uniform float u_instanceAttributeMode;
 out vec3 v_normal;
 out vec4 v_tangent;
 out vec3 v_worldPosition;
@@ -1819,11 +2056,23 @@ out vec4 v_vertexColor;
 void main() {
   v_uv = a_uv;
   v_uv1 = a_uv1;
-  v_normal = mat3(u_normalMatrix) * a_normal;
-  v_tangent = vec4(mat3(u_normalMatrix) * a_tangent.xyz, a_tangent.w);
-  v_worldPosition = (u_modelMatrix * vec4(a_position, 1.0)).xyz;
-  v_vertexColor = a_color;
-  gl_Position = u_modelViewProjection * vec4(a_position, 1.0);
+  if (u_instanceCount > 0.5) {
+    int instanceIndex = clamp(gl_InstanceID, 0, max(int(u_instanceCount) - 1, 0));
+    mat4 attributeMatrix = mat4(a_instanceMatrix0, a_instanceMatrix1, a_instanceMatrix2, a_instanceMatrix3);
+    mat4 instanceMatrix = u_instanceAttributeMode > 0.5 ? attributeMatrix : u_instanceMatrices[instanceIndex];
+    vec4 worldPosition = u_modelMatrix * instanceMatrix * vec4(a_position, 1.0);
+    v_normal = mat3(u_normalMatrix) * transpose(inverse(mat3(instanceMatrix))) * a_normal;
+    v_tangent = vec4(mat3(u_normalMatrix) * (mat3(instanceMatrix) * a_tangent.xyz), a_tangent.w);
+    v_worldPosition = worldPosition.xyz;
+    v_vertexColor = a_color * a_instanceColor;
+    gl_Position = u_modelViewProjection * instanceMatrix * vec4(a_position, 1.0);
+  } else {
+    v_normal = mat3(u_normalMatrix) * a_normal;
+    v_tangent = vec4(mat3(u_normalMatrix) * a_tangent.xyz, a_tangent.w);
+    v_worldPosition = (u_modelMatrix * vec4(a_position, 1.0)).xyz;
+    v_vertexColor = a_color;
+    gl_Position = u_modelViewProjection * vec4(a_position, 1.0);
+  }
 }
 `,
         fragment: `#version 300 es
@@ -1837,6 +2086,7 @@ uniform float u_metallic;
 uniform float u_roughness;
 uniform vec3 u_environmentColor;
 uniform float u_environmentIntensity;
+uniform float u_materialEnvironmentIntensity;
 uniform vec3 u_environmentSkyColor;
 uniform vec3 u_environmentHorizonColor;
 uniform vec3 u_environmentGroundColor;
@@ -1921,6 +2171,21 @@ uniform float u_pointShadowSlopeBias;
 uniform vec2 u_pointShadowTexelSize;
 uniform float u_pointShadowPcfSampleCount;
 uniform vec4 u_pointShadowPcfSamples[32];
+#ifndef A3D_PBR_NO_SPOT_SHADOW
+uniform sampler2D u_spotShadowMapTexture;
+uniform float u_spotShadowMapEnabled;
+uniform vec3 u_spotShadowLightPosition;
+uniform vec3 u_spotShadowLightDirection;
+uniform mat4 u_spotShadowMatrix;
+uniform vec2 u_spotShadowCone;
+uniform float u_spotShadowRange;
+uniform float u_spotShadowStrength;
+uniform float u_spotShadowBias;
+uniform float u_spotShadowSlopeBias;
+uniform vec2 u_spotShadowTexelSize;
+uniform float u_spotShadowPcfSampleCount;
+uniform vec4 u_spotShadowPcfSamples[32];
+#endif
 uniform sampler2D u_baseColorTexture;
 uniform float u_baseColorTextureEnabled;
 uniform vec2 u_baseColorTextureOffset;
@@ -1959,14 +2224,26 @@ uniform vec2 u_occlusionTextureWrap;
 uniform float u_occlusionStrength;
 uniform float u_clearcoatNormalScale;
 #ifdef A3D_PBR_CLEARCOAT_TEXTURES
+#ifndef A3D_PBR_EXTENSION_ATLAS
 uniform sampler2D u_clearcoatTexture;
+#else
+uniform vec4 u_clearcoatAtlasRect;
+uniform float u_clearcoatAtlasY;
+uniform vec4 u_clearcoatAtlasFilter;
+#endif
 uniform float u_clearcoatTextureEnabled;
 uniform vec2 u_clearcoatTextureOffset;
 uniform vec2 u_clearcoatTextureScale;
 uniform float u_clearcoatTextureRotation;
 uniform float u_clearcoatTextureTexCoord;
 uniform vec2 u_clearcoatTextureWrap;
+#ifndef A3D_PBR_EXTENSION_ATLAS
 uniform sampler2D u_clearcoatRoughnessTexture;
+#else
+uniform vec4 u_clearcoatRoughnessAtlasRect;
+uniform float u_clearcoatRoughnessAtlasY;
+uniform vec4 u_clearcoatRoughnessAtlasFilter;
+#endif
 uniform float u_clearcoatRoughnessTextureEnabled;
 uniform vec2 u_clearcoatRoughnessTextureOffset;
 uniform vec2 u_clearcoatRoughnessTextureScale;
@@ -2035,7 +2312,13 @@ uniform vec2 u_sheenColorTextureScale;
 uniform float u_sheenColorTextureRotation;
 uniform float u_sheenColorTextureTexCoord;
 uniform vec2 u_sheenColorTextureWrap;
+#ifndef A3D_PBR_EXTENSION_ATLAS
 uniform sampler2D u_sheenRoughnessTexture;
+#else
+uniform vec4 u_sheenRoughnessAtlasRect;
+uniform float u_sheenRoughnessAtlasY;
+uniform vec4 u_sheenRoughnessAtlasFilter;
+#endif
 uniform float u_sheenRoughnessTextureEnabled;
 uniform vec2 u_sheenRoughnessTextureOffset;
 uniform vec2 u_sheenRoughnessTextureScale;
@@ -2051,14 +2334,26 @@ uniform float u_anisotropyTextureTexCoord;
 uniform vec2 u_anisotropyTextureWrap;
 #endif
 #ifdef A3D_PBR_IRIDESCENCE_TEXTURES
+#ifndef A3D_PBR_EXTENSION_ATLAS
 uniform sampler2D u_iridescenceTexture;
+#else
+uniform vec4 u_iridescenceAtlasRect;
+uniform float u_iridescenceAtlasY;
+uniform vec4 u_iridescenceAtlasFilter;
+#endif
 uniform float u_iridescenceTextureEnabled;
 uniform vec2 u_iridescenceTextureOffset;
 uniform vec2 u_iridescenceTextureScale;
 uniform float u_iridescenceTextureRotation;
 uniform float u_iridescenceTextureTexCoord;
 uniform vec2 u_iridescenceTextureWrap;
+#ifndef A3D_PBR_EXTENSION_ATLAS
 uniform sampler2D u_iridescenceThicknessTexture;
+#else
+uniform vec4 u_iridescenceThicknessAtlasRect;
+uniform float u_iridescenceThicknessAtlasY;
+uniform vec4 u_iridescenceThicknessAtlasFilter;
+#endif
 uniform float u_iridescenceThicknessTextureEnabled;
 uniform vec2 u_iridescenceThicknessTextureOffset;
 uniform vec2 u_iridescenceThicknessTextureScale;
@@ -2076,6 +2371,9 @@ uniform float u_environmentFogNear;
 uniform float u_environmentFogFar;
 uniform float u_environmentFogDensity;
 uniform float u_environmentFogHeightFalloff;
+uniform float u_volumetricIntensity;
+uniform vec3 u_volumetricLightDirection;
+uniform vec3 u_volumetricLightColor;
 uniform float u_environmentFogHeightReference;
 uniform float u_environmentFogMaxOpacity;
 in vec3 v_normal;
@@ -2110,10 +2408,16 @@ vec2 a3dTexturedPbrWrapUv(vec2 uv, vec2 wrapMode) {
     a3dTexturedPbrWrapCoordinate(uv.y, wrapMode.y)
   );
 }
+vec3 a3dTexturedPbrEncodeLinearToSrgb(vec3 linear) {
+  vec3 clamped = max(linear, vec3(0.0));
+  vec3 low = clamped * 12.92;
+  vec3 high = 1.055 * pow(clamped, vec3(1.0 / 2.4)) - 0.055;
+  return mix(low, high, step(vec3(0.0031308), clamped));
+}
 vec3 a3dTexturedPbrEncodeOutput(vec3 linearColor) {
   vec3 color = max(linearColor, vec3(0.0));
   vec3 filmic = clamp((color * (2.51 * color + 0.03)) / (color * (2.43 * color + 0.59) + 0.14), vec3(0.0), vec3(1.0));
-  vec3 srgb = pow(filmic, vec3(1.0 / 2.2));
+  vec3 srgb = a3dTexturedPbrEncodeLinearToSrgb(filmic);
   return mix(color, srgb, step(0.5, u_outputColorSpace));
 }
 vec3 a3dTexturedPbrDecodeSrgb(vec3 encodedColor) {
@@ -2158,15 +2462,6 @@ float a3dTexturedPbrShadowFactor(vec3 worldPosition, vec3 normal, vec3 lightDire
   vec3 receiverNormal = normalize(normal);
   vec3 receiverLightDirection = lightDirection / max(length(lightDirection), 0.0001);
   float normalDotLight = clamp(abs(dot(receiverNormal, receiverLightDirection)), 0.0, 1.0);
-  // Slope-scaled depth bias must be evaluated per PCF sample, not once for the kernel
-  // centre. A sample offset N texels away on a receiver sloped relative to the light sees a
-  // depth difference proportional to N, so a centre-only bias under-compensates every outer
-  // tap and the receiver shadows itself. Scaling by each sample's own texel distance keeps
-  // wide kernels acne-free without inflating the constant bias into peter-panning.
-  // The depth gradient across one shadow texel is tan(angle between receiver normal and
-  // light), not (1 - N.L). The linear form collapses toward zero far faster than the real
-  // gradient grows, so it under-biases exactly the grazing angles that need the most
-  // compensation. Clamped so a near-perpendicular receiver cannot demand unbounded bias.
   float slopeTangent = min(sqrt(max(1.0 - normalDotLight * normalDotLight, 0.0)) / max(normalDotLight, 0.05), 8.0);
   float slopeTexelBias = slopeTangent * u_shadowMapSlopeBias * max(u_shadowMapTexelSize.x, u_shadowMapTexelSize.y);
   float projectedDepth = projected.z * 0.5 + 0.5;
@@ -2199,9 +2494,6 @@ float a3dTexturedPbrPointShadowFactor(vec3 worldPosition, vec3 normal, vec3 ligh
   vec4 rect = u_pointShadowFaceRects[faceIndex];
   vec2 uv = rect.xy + localUv * rect.zw;
   float normalDotLight = clamp(abs(dot(normalize(normal), normalize(lightDirection))), 0.0, 1.0);
-  // Same per-sample, tangent-scaled slope bias as the directional and atlas paths. These
-  // cubemap-face variants inline the sample fetch, but they share the identical acne
-  // mechanism: a centre-only, (1 - N.L)-scaled bias under-compensates every outer tap.
   float slopeTangent = min(sqrt(max(1.0 - normalDotLight * normalDotLight, 0.0)) / max(normalDotLight, 0.05), 8.0);
   float slopeTexelBias = slopeTangent * u_pointShadowSlopeBias * max(u_pointShadowTexelSize.x, u_pointShadowTexelSize.y);
   float projectedDepth = projected.z * 0.5 + 0.5;
@@ -2220,6 +2512,46 @@ float a3dTexturedPbrPointShadowFactor(vec3 worldPosition, vec3 normal, vec3 ligh
   float occlusion = totalWeight > 0.0 ? shadowed / totalWeight : 0.0;
   return mix(1.0, 1.0 - occlusion, clamp(u_pointShadowStrength, 0.0, 1.0));
 }
+#ifndef A3D_PBR_NO_SPOT_SHADOW
+float a3dTexturedPbrSpotShadowFactor(vec3 worldPosition, vec3 normal, vec3 lightDirection) {
+  if (u_spotShadowMapEnabled < 0.5) return 1.0;
+  vec3 toFragment = worldPosition - u_spotShadowLightPosition;
+  float distanceToLight = max(length(toFragment), 0.0001);
+  if (distanceToLight > u_spotShadowRange) return 1.0;
+  vec3 coneAxis = u_spotShadowLightDirection / max(length(u_spotShadowLightDirection), 0.0001);
+  if (dot(toFragment / distanceToLight, coneAxis) < cos(u_spotShadowCone.x)) return 1.0;
+  vec4 lightPosition = u_spotShadowMatrix * vec4(worldPosition, 1.0);
+  vec3 projected = lightPosition.xyz / max(lightPosition.w, 0.0001);
+  vec2 uv = projected.xy * 0.5 + 0.5;
+  if (uv.x < 0.0 || uv.x > 1.0 || uv.y < 0.0 || uv.y > 1.0) return 1.0;
+  vec3 receiverNormal = normalize(normal);
+  vec3 receiverLightDirection = lightDirection / max(length(lightDirection), 0.0001);
+  float normalDotLight = clamp(abs(dot(receiverNormal, receiverLightDirection)), 0.0, 1.0);
+  float slopeTangent = min(sqrt(max(1.0 - normalDotLight * normalDotLight, 0.0)) / max(normalDotLight, 0.05), 8.0);
+  float slopeTexelBias = slopeTangent * u_spotShadowSlopeBias * max(u_spotShadowTexelSize.x, u_spotShadowTexelSize.y);
+  float projectedDepth = projected.z * 0.5 + 0.5;
+  float shadowed = 0.0;
+  float totalWeight = 0.0;
+  int sampleCount = clamp(int(u_spotShadowPcfSampleCount), 1, 32);
+  for (int i = 0; i < 32; ++i) {
+    if (i >= sampleCount) break;
+    vec4 sampleData = u_spotShadowPcfSamples[i];
+    float weight = max(sampleData.z, 0.0);
+    vec2 offset = sampleData.xy * u_spotShadowTexelSize;
+    float storedDepth = texture(u_spotShadowMapTexture, uv + offset).r;
+    float sampleTexelDistance = max(1.0, length(sampleData.xy));
+    float receiverDepth = projectedDepth - u_spotShadowBias - slopeTexelBias * sampleTexelDistance;
+    shadowed += (receiverDepth > storedDepth ? 1.0 : 0.0) * weight;
+    totalWeight += weight;
+  }
+  float occlusion = totalWeight > 0.0 ? shadowed / totalWeight : 0.0;
+  return mix(1.0, 1.0 - occlusion, clamp(u_spotShadowStrength, 0.0, 1.0));
+}
+float a3dTexturedPbrResolveSpotShadowOverride(float baseFactor, float kind, float shadowFlag, vec3 worldPosition, vec3 normal, vec3 lightDirection) {
+  float spotGate = step(1.5, kind) * (1.0 - step(2.5, kind)) * step(0.5, u_spotShadowMapEnabled) * step(0.5, shadowFlag);
+  return mix(baseFactor, a3dTexturedPbrSpotShadowFactor(worldPosition, normal, lightDirection), spotGate);
+}
+#endif
 vec2 a3dTexturedPbrEnvironmentUv(vec3 direction, float rotation) {
   vec3 d = normalize(direction);
   float u = atan(d.z, d.x) / 6.28318530718 + 0.5 + rotation;
@@ -2259,16 +2591,11 @@ vec3 a3dTexturedPbrEnvironmentDiffuseInput(vec3 normal) {
   float horizonBlend = 1.0 - abs(normal.y);
   vec3 proceduralDiffuse = mix(u_environmentGroundColor, u_environmentSkyColor, skyBlend);
   proceduralDiffuse = mix(proceduralDiffuse, u_environmentHorizonColor, clamp(horizonBlend, 0.0, 1.0) * 0.55);
-  // The ambient term must be added to the procedural contribution, not replaced by it. A mix
-  // here discarded u_environmentColor * u_environmentIntensity entirely whenever a procedural
-  // map was present, which is the normal case: raising ambient intensity from 0.18 to 3.0 on
-  // the product-turntable kit produced a byte-identical frame. Ambient and a sky gradient are
-  // separate physical contributions, so they sum.
   vec3 environmentDiffuse = ambientEnvironment + proceduralDiffuse * u_environmentMapIntensity * proceduralEnvironmentWeight;
   float sampledEnvironmentWeight = step(0.0001, u_environmentMapTextureEnabled * u_environmentMapTextureIntensity);
   float diffuseEnvironmentLod = max(u_environmentMapTextureMipCount - 1.0, 0.0);
   vec3 sampledDiffuse = a3dTexturedPbrDecodeEnvironmentSample(a3dTexturedPbrEnvironmentSampleRaw(normal, diffuseEnvironmentLod));
-  return mix(environmentDiffuse, ambientEnvironment + sampledDiffuse * u_environmentMapTextureIntensity, sampledEnvironmentWeight);
+  return mix(environmentDiffuse, ambientEnvironment + sampledDiffuse * u_environmentMapTextureIntensity * u_materialEnvironmentIntensity, sampledEnvironmentWeight);
 }
 vec3 a3dTexturedPbrEnvironmentSpecularInput(vec3 normal, vec3 viewDirection, float roughness) {
   float materialEnvironmentSpecularScale = clamp(u_materialEnvironmentSpecularScale, 0.0, 1.0);
@@ -2278,11 +2605,6 @@ vec3 a3dTexturedPbrEnvironmentSpecularInput(vec3 normal, vec3 viewDirection, flo
   float clampedRoughness = clamp(roughness, 0.0, 1.0);
   float nDotV = clamp(dot(normal, viewDirection), 0.0, 1.0);
   float reflectionBand = pow(clamp(reflectionDirection.y * 0.5 + 0.5, 0.0, 1.0), mix(18.0, 2.0, clampedRoughness));
-  // Keep the procedural environment from becoming a uniform white veil on
-  // saturated textured base colors. A high roughness floor spread neutral
-  // specular over every fragment, while image-based lighting and Three.js keep
-  // the strongest neutral energy in reflection bands and glancing highlights.
-  // The lower floor preserves ambient readability without erasing texture chroma.
   float roughEnvironmentFloor = mix(0.012, 0.16, clampedRoughness);
   float proceduralSpecularResponse = max(reflectionBand, roughEnvironmentFloor);
   float horizonStripe = pow(clamp(1.0 - abs(reflectionDirection.y), 0.0, 1.0), mix(14.0, 3.0, clampedRoughness));
@@ -2297,18 +2619,30 @@ vec3 a3dTexturedPbrEnvironmentSpecularInput(vec3 normal, vec3 viewDirection, flo
   float environmentLod = clampedRoughness * max(u_environmentMapTextureMipCount - 1.0, 0.0);
   vec3 sampledSpecular = a3dTexturedPbrBoundHdrSpecularRadiance(a3dTexturedPbrDecodeEnvironmentSample(a3dTexturedPbrEnvironmentSampleRaw(reflectionDirection, environmentLod)));
   sampledSpecular = a3dTexturedPbrClampSampledSpecularEdgeEnergy(sampledSpecular, nDotV, clampedRoughness);
-  sampledSpecular *= u_environmentMapTextureSpecularIntensity * sampledEnvironmentWeight * mix(1.1, 0.65, clampedRoughness);
+  sampledSpecular *= u_environmentMapTextureSpecularIntensity * u_materialEnvironmentIntensity * sampledEnvironmentWeight * mix(1.1, 0.65, clampedRoughness);
   float proceduralSpecularScale = materialFiniteSpecularScale;
   float sampledSpecularScale = materialEnvironmentSpecularScale;
   return proceduralSpecular * proceduralSpecularScale + sampledSpecular * sampledSpecularScale;
 }
-vec3 a3dTexturedPbrIridescenceColor(float minimumThickness, float maximumThickness, float iridescenceIor, float nDotV) {
-  float thickness = clamp((minimumThickness + maximumThickness) * 0.5, 0.0, 1200.0);
-  float opticalThicknessPhase = clamp((thickness - 100.0) / 1100.0, 0.0, 1.0) * 6.2831853;
-  float iorShift = clamp((iridescenceIor - 1.0) / 2.0, 0.0, 1.0) * 0.65;
-  float viewPhase = pow(1.0 - clamp(nDotV, 0.0, 1.0), 1.25) * (3.2 + iridescenceIor * 1.4);
-  float phase = opticalThicknessPhase + iorShift + viewPhase;
-  return clamp(0.5 + 0.5 * cos(phase + vec3(0.0, 2.0943951, 4.1887902)), vec3(0.0), vec3(1.0));
+vec3 a3dTexturedPbrThinFilmFresnel(vec3 substrateF0, float filmIor, float thickness, float cosine) {
+  float c1 = clamp(cosine, 0.0001, 1.0);
+  if (thickness <= 0.0) return a3dFresnelSchlick(substrateF0, c1);
+  float n2 = max(filmIor, 1.0001);
+  vec3 rootF0 = sqrt(clamp(substrateF0, vec3(0.0), vec3(0.98)));
+  vec3 n3 = (vec3(1.0) + rootF0) / max(vec3(1.0) - rootF0, vec3(0.0001));
+  float sinSquared = 1.0 - c1 * c1;
+  float c2 = sqrt(max(0.0, 1.0 - sinSquared / (n2 * n2)));
+  vec3 c3 = sqrt(max(vec3(0.0), vec3(1.0) - sinSquared / (n3 * n3)));
+  float r12s = (c1 - n2 * c2) / max(c1 + n2 * c2, 0.0001);
+  float r12p = (n2 * c1 - c2) / max(n2 * c1 + c2, 0.0001);
+  vec3 r23s = (n2 * c2 - n3 * c3) / max(n2 * c2 + n3 * c3, vec3(0.0001));
+  vec3 r23p = (n3 * c2 - n2 * c3) / max(n3 * c2 + n2 * c3, vec3(0.0001));
+  vec3 phase = 4.0 * A3D_PI * n2 * max(thickness, 0.0) * c2 / vec3(650.0, 510.0, 475.0);
+  vec3 crossS = 2.0 * r12s * r23s * cos(phase);
+  vec3 crossP = 2.0 * r12p * r23p * cos(phase);
+  vec3 Rs = (r12s * r12s + r23s * r23s + crossS) / max(vec3(1.0) + r12s * r12s * r23s * r23s + crossS, vec3(0.0001));
+  vec3 Rp = (r12p * r12p + r23p * r23p + crossP) / max(vec3(1.0) + r12p * r12p * r23p * r23p + crossP, vec3(0.0001));
+  return clamp((Rs + Rp) * 0.5, vec3(0.0), vec3(1.0));
 }
 float a3dTexturedPbrCharlieSheen(float nDotH, float sheenRoughness) {
   float alpha = max(0.07, sheenRoughness * sheenRoughness);
@@ -2359,7 +2693,10 @@ vec3 a3dTexturedPbrExtensionDirectLight(
   float iridescence,
   float iridescenceIor,
   float iridescenceThicknessMinimum,
-  float iridescenceThicknessMaximum
+  float iridescenceThicknessMaximum,
+  vec3 substrateF0,
+  vec3 substrateNormal,
+  float substrateRoughness
 ) {
   vec3 N = normalize(normal);
   vec3 V = normalize(viewDirection);
@@ -2382,9 +2719,14 @@ vec3 a3dTexturedPbrExtensionDirectLight(
   float anisotropicDistribution = a3dTexturedPbrAnisotropicDistribution(N, H, tangentFrame, clearcoatRough, anisotropy, anisotropyRotation);
   float anisotropyShape = anisotropicDistribution / (anisotropicDistribution + 3.0);
   vec3 anisotropyLobe = vec3(clamp(anisotropy, 0.0, 1.0) * anisotropyShape * 0.72);
-  vec3 iridescenceColor = a3dTexturedPbrIridescenceColor(iridescenceThicknessMinimum, iridescenceThicknessMaximum, iridescenceIor, nDotV);
-  vec3 iridescenceLobe = iridescenceColor * clamp(iridescence, 0.0, 1.0) * clearcoatF * pow(a3dSaturate(1.0 - nDotV), 2.0) * 0.12;
-  return (clearcoatLobe + sheenLobe + anisotropyLobe + iridescenceLobe) * lightColor * lightIntensity * nDotL;
+  vec3 filmF = a3dTexturedPbrThinFilmFresnel(substrateF0, iridescenceIor, (iridescenceThicknessMinimum + iridescenceThicknessMaximum) * 0.5, vDotH);
+  vec3 filmN = normalize(substrateNormal);
+  float filmNdotV = max(a3dSaturate(dot(filmN, V)), A3D_EPSILON);
+  float filmNdotL = a3dSaturate(dot(filmN, L));
+  float filmD = a3dDistributionGGX(a3dSaturate(dot(filmN, H)), substrateRoughness);
+  float filmG = a3dGeometrySmithGGXCorrelated(filmNdotV, filmNdotL, substrateRoughness);
+  vec3 iridescenceLobe = (filmF - a3dFresnelSchlick(substrateF0, vDotH)) * clamp(iridescence, 0.0, 1.0) * filmD * filmG;
+  return ((clearcoatLobe + sheenLobe + anisotropyLobe) * nDotL + iridescenceLobe * filmNdotL) * lightColor * lightIntensity;
 }
 vec3 a3dTexturedPbrExtensionEnvironmentLight(
   vec3 normal,
@@ -2400,7 +2742,10 @@ vec3 a3dTexturedPbrExtensionEnvironmentLight(
   float iridescence,
   float iridescenceIor,
   float iridescenceThicknessMinimum,
-  float iridescenceThicknessMaximum
+  float iridescenceThicknessMaximum,
+  vec3 substrateF0,
+  vec3 substrateNormal,
+  vec3 substrateSpecularRadiance
 ) {
   float nDotV = max(a3dSaturate(dot(normalize(normal), normalize(viewDirection))), A3D_EPSILON);
   vec3 clearcoatF = a3dFresnelSchlickRoughness(vec3(0.04), nDotV, clamp(clearcoatRoughness, 0.18, 1.0));
@@ -2417,10 +2762,66 @@ vec3 a3dTexturedPbrExtensionEnvironmentLight(
   float anisotropicDistribution = a3dTexturedPbrAnisotropicDistribution(N, environmentHalf, tangentFrame, clearcoatRoughness, anisotropy, anisotropyRotation);
   float anisotropyShape = anisotropicDistribution / (anisotropicDistribution + 3.0);
   vec3 anisotropyLobe = boundedSpecularRadiance * clamp(anisotropy, 0.0, 1.0) * anisotropyShape * 0.72;
-  vec3 iridescenceColor = a3dTexturedPbrIridescenceColor(iridescenceThicknessMinimum, iridescenceThicknessMaximum, iridescenceIor, nDotV);
-  vec3 iridescenceLobe = boundedSpecularRadiance * iridescenceColor * clamp(iridescence, 0.0, 1.0) * pow(a3dSaturate(1.0 - nDotV), 2.0) * 0.09;
+  float filmNdotV = max(a3dSaturate(dot(normalize(substrateNormal), normalize(viewDirection))), A3D_EPSILON);
+  vec3 filmF = a3dTexturedPbrThinFilmFresnel(substrateF0, iridescenceIor, (iridescenceThicknessMinimum + iridescenceThicknessMaximum) * 0.5, filmNdotV);
+  vec3 iridescenceLobe = substrateSpecularRadiance * (filmF - a3dFresnelSchlick(substrateF0, filmNdotV)) * clamp(iridescence, 0.0, 1.0);
   return clearcoatLobe + sheenLobe + anisotropyLobe + iridescenceLobe;
 }
+
+#ifdef A3D_PBR_EXTENSION_ATLAS
+uniform sampler2D u_extensionScalarAtlas;
+int a3dAtlasWrapIndex(int x, int size, float mode) {
+  if (mode < 0.5) return clamp(x, 0, size - 1);
+  int period = mode < 1.5 ? size : 2 * size;
+  int index = ((x % period) + period) % period;
+  return mode < 1.5 ? index : (index < size ? index : period - 1 - index);
+}
+vec4 a3dAtlasFetch(ivec2 point, ivec2 size, ivec2 origin, vec2 wrapMode) {
+  ivec2 wrapped = ivec2(a3dAtlasWrapIndex(point.x,size.x,wrapMode.x), a3dAtlasWrapIndex(point.y,size.y,wrapMode.y));
+  return texelFetch(u_extensionScalarAtlas, origin + wrapped, 0);
+}
+vec4 a3dAtlasLevel(vec2 uv, vec4 rect, float originY, vec2 wrapMode, int level, bool nearestFilter) {
+  ivec2 size = ivec2(rect.yz);
+  ivec2 origin = ivec2(int(rect.x),int(originY));
+  for (int i=0; i<16; i++) {
+    if (i >= level) break;
+    origin.y += size.y;
+    size = max(size / 2, ivec2(1));
+  }
+  vec2 pixel = uv * vec2(size) - 0.5;
+  if (nearestFilter) return a3dAtlasFetch(ivec2(floor(pixel + 0.5)),size,origin,wrapMode);
+  ivec2 low = ivec2(floor(pixel));
+  vec2 fraction = fract(pixel);
+  return mix(mix(a3dAtlasFetch(low,size,origin,wrapMode),a3dAtlasFetch(low+ivec2(1,0),size,origin,wrapMode),fraction.x),
+             mix(a3dAtlasFetch(low+ivec2(0,1),size,origin,wrapMode),a3dAtlasFetch(low+ivec2(1,1),size,origin,wrapMode),fraction.x),fraction.y);
+}
+vec4 a3dAtlasSample(vec2 uv, vec4 rect, float originY, vec2 wrapMode, vec4 filterMode) {
+  vec2 dx=dFdx(uv), dy=dFdy(uv);
+  float lx=length(dx*rect.yz), ly=length(dy*rect.yz);
+  float major=max(lx,ly), minor=max(min(lx,ly),0.000001);
+  bool magnify=major<=1.0;
+  float taps=magnify ? 1.0 : clamp(ceil(major/max(minor,1.0)),1.0,floor(filterMode.w));
+  vec2 axis=lx>=ly ? dx : dy;
+  float lod=clamp(log2(max(major/taps,1.0)),0.0,rect.w);
+  if (filterMode.z<0.5) lod=0.0;
+  else if (filterMode.z<1.5) lod=floor(lod+0.5);
+  int low=int(floor(lod)), high=min(low+1,int(rect.w));
+  bool nearestFilter=magnify ? filterMode.x>0.5 : filterMode.y>0.5;
+  vec4 total=vec4(0.0);
+  for (int i=0;i<16;i++) {
+    if (float(i)>=taps) break;
+    vec2 sampleUv=uv+axis*((float(i)+0.5)/taps-0.5);
+    total+=mix(a3dAtlasLevel(sampleUv,rect,originY,wrapMode,low,nearestFilter),a3dAtlasLevel(sampleUv,rect,originY,wrapMode,high,nearestFilter),fract(lod));
+  }
+  return total/taps;
+}
+#endif
+
+
+
+
+
+
 void main() {
   vec2 baseColorUv = a3dTexturedPbrUv(u_baseColorTextureTexCoord, u_baseColorTextureOffset, u_baseColorTextureScale, u_baseColorTextureRotation);
   vec2 normalUv = a3dTexturedPbrUv(u_normalTextureTexCoord, u_normalTextureOffset, u_normalTextureScale, u_normalTextureRotation);
@@ -2534,10 +2935,18 @@ void main() {
   float anisotropy = clamp(u_anisotropyStrength, 0.0, 1.0);
   float anisotropyRotation = u_anisotropyRotation;
   float iridescence = clamp(u_iridescenceFactor, 0.0, 1.0);
-  float iridescenceThickness = mix(u_iridescenceThicknessMinimum, u_iridescenceThicknessMaximum, 0.5);
+  float iridescenceThickness = u_iridescenceThicknessMaximum;
 #ifdef A3D_PBR_CLEARCOAT_TEXTURES
+#ifdef A3D_PBR_EXTENSION_ATLAS
+  clearcoat = clamp(clearcoat * mix(1.0, a3dAtlasSample(clearcoatUv, u_clearcoatAtlasRect, u_clearcoatAtlasY, u_clearcoatTextureWrap, u_clearcoatAtlasFilter).r, step(0.5, u_clearcoatTextureEnabled)), 0.0, 1.0);
+#else
   clearcoat = clamp(clearcoat * mix(1.0, texture(u_clearcoatTexture, a3dTexturedPbrWrapUv(clearcoatUv, u_clearcoatTextureWrap)).r, step(0.5, u_clearcoatTextureEnabled)), 0.0, 1.0);
+#endif
+#ifdef A3D_PBR_EXTENSION_ATLAS
+  clearcoatRoughness = clamp(clearcoatRoughness * mix(1.0, a3dAtlasSample(clearcoatRoughnessUv, u_clearcoatRoughnessAtlasRect, u_clearcoatRoughnessAtlasY, u_clearcoatRoughnessTextureWrap, u_clearcoatRoughnessAtlasFilter).g, step(0.5, u_clearcoatRoughnessTextureEnabled)), 0.0, 1.0);
+#else
   clearcoatRoughness = clamp(clearcoatRoughness * mix(1.0, texture(u_clearcoatRoughnessTexture, a3dTexturedPbrWrapUv(clearcoatRoughnessUv, u_clearcoatRoughnessTextureWrap)).g, step(0.5, u_clearcoatRoughnessTextureEnabled)), 0.0, 1.0);
+#endif
   clearcoatRoughness = max(clearcoatRoughness, 0.19 + (1.0 - clearcoatNormalBoost) * 0.12);
 #endif
 #ifdef A3D_PBR_TRANSMISSION_VOLUME_TEXTURES
@@ -2552,12 +2961,29 @@ void main() {
 #endif
 #ifdef A3D_PBR_SPECULAR_SHEEN_ANISOTROPY_TEXTURES
   sheenColor *= mix(vec3(1.0), a3dTexturedPbrDecodeSrgb(texture(u_sheenColorTexture, a3dTexturedPbrWrapUv(sheenColorUv, u_sheenColorTextureWrap)).rgb), step(0.5, u_sheenColorTextureEnabled));
+#ifdef A3D_PBR_EXTENSION_ATLAS
+  sheenRoughness = clamp(sheenRoughness * mix(1.0, a3dAtlasSample(sheenRoughnessUv, u_sheenRoughnessAtlasRect, u_sheenRoughnessAtlasY, u_sheenRoughnessTextureWrap, u_sheenRoughnessAtlasFilter).a, step(0.5, u_sheenRoughnessTextureEnabled)), 0.0, 1.0);
+#else
   sheenRoughness = clamp(sheenRoughness * mix(1.0, texture(u_sheenRoughnessTexture, a3dTexturedPbrWrapUv(sheenRoughnessUv, u_sheenRoughnessTextureWrap)).a, step(0.5, u_sheenRoughnessTextureEnabled)), 0.0, 1.0);
-  anisotropy = clamp(anisotropy * mix(1.0, texture(u_anisotropyTexture, a3dTexturedPbrWrapUv(anisotropyUv, u_anisotropyTextureWrap)).b, step(0.5, u_anisotropyTextureEnabled)), 0.0, 1.0);
+#endif
+  vec3 anisotropySample = texture(u_anisotropyTexture, a3dTexturedPbrWrapUv(anisotropyUv, u_anisotropyTextureWrap)).rgb;
+  anisotropy = clamp(anisotropy * mix(1.0, anisotropySample.b, step(0.5, u_anisotropyTextureEnabled)), 0.0, 1.0);
+  vec2 anisotropyDirection = anisotropySample.rg * 2.0 - 1.0;
+  if (u_anisotropyTextureEnabled > 0.5 && dot(anisotropyDirection, anisotropyDirection) > 0.000001) {
+    anisotropyRotation += atan(anisotropyDirection.y, anisotropyDirection.x);
+  }
 #endif
 #ifdef A3D_PBR_IRIDESCENCE_TEXTURES
+#ifdef A3D_PBR_EXTENSION_ATLAS
+  iridescence = clamp(iridescence * mix(1.0, a3dAtlasSample(iridescenceUv, u_iridescenceAtlasRect, u_iridescenceAtlasY, u_iridescenceTextureWrap, u_iridescenceAtlasFilter).r, step(0.5, u_iridescenceTextureEnabled)), 0.0, 1.0);
+#else
   iridescence = clamp(iridescence * mix(1.0, texture(u_iridescenceTexture, a3dTexturedPbrWrapUv(iridescenceUv, u_iridescenceTextureWrap)).r, step(0.5, u_iridescenceTextureEnabled)), 0.0, 1.0);
+#endif
+#ifdef A3D_PBR_EXTENSION_ATLAS
+  iridescenceThickness = mix(iridescenceThickness, mix(u_iridescenceThicknessMinimum, u_iridescenceThicknessMaximum, a3dAtlasSample(iridescenceThicknessUv, u_iridescenceThicknessAtlasRect, u_iridescenceThicknessAtlasY, u_iridescenceThicknessTextureWrap, u_iridescenceThicknessAtlasFilter).g), step(0.5, u_iridescenceThicknessTextureEnabled));
+#else
   iridescenceThickness = mix(iridescenceThickness, mix(u_iridescenceThicknessMinimum, u_iridescenceThicknessMaximum, texture(u_iridescenceThicknessTexture, a3dTexturedPbrWrapUv(iridescenceThicknessUv, u_iridescenceThicknessTextureWrap)).g), step(0.5, u_iridescenceThicknessTextureEnabled));
+#endif
 #endif
   vec3 base = a3dApplyAdvancedPbrLobes(
     texturedBase.rgb,
@@ -2577,13 +3003,14 @@ void main() {
     sheenRoughness,
     anisotropy,
     anisotropyRotation,
-    iridescence,
+    0.0,
     u_iridescenceIor,
     iridescenceThickness,
     iridescenceThickness,
     u_dispersion
   );
   vec3 viewDirection = normalize(u_cameraPosition - v_worldPosition);
+  vec3 iridescenceSubstrateF0 = mix(vec3(pow((u_ior - 1.0) / max(u_ior + 1.0, 0.0001), 2.0)) * specularColor * specular, texturedBase.rgb, metallic);
   float materialRedPaintGate = smoothstep(0.28, 0.72, texturedBase.r)
     * (1.0 - smoothstep(0.05, 0.18, max(texturedBase.g, texturedBase.b)))
     * smoothstep(0.015, 0.07, u_materialEnvironmentSpecularScale);
@@ -2618,7 +3045,10 @@ void main() {
     iridescence,
     u_iridescenceIor,
     iridescenceThickness,
-    iridescenceThickness
+    iridescenceThickness,
+    iridescenceSubstrateF0,
+    mappedNormal,
+    a3dTexturedPbrEnvironmentSpecularInput(mappedNormal, viewDirection, roughness)
   );
   float texturedTransmissionAmount = clamp(max(transmission, diffuseTransmission), 0.0, 1.0);
   float texturedSampledEnvironmentWeight = step(0.0001, u_environmentMapTextureEnabled * u_environmentMapTextureIntensity);
@@ -2651,10 +3081,6 @@ void main() {
       vec2 backdropOffset = normalize(texturedRefractionDirection.xy + vec2(0.0001)) * u_transmissionBackdropRefractionScale * mix(1.25, 0.55, roughness) * clamp(u_ior - 1.0, 0.0, 2.5);
       float backdropLod = clamp((roughness + volumeThickness * 0.08) * max(u_transmissionBackdropMipCount - 1.0, 0.0), 0.0, max(u_transmissionBackdropMipCount - 1.0, 0.0));
       vec3 backdropRadiance = a3dTexturedPbrDecodeSrgb(textureLod(u_transmissionBackdropTexture, clamp(backdropUv + backdropOffset, vec2(0.001), vec2(0.999)), backdropLod).rgb);
-      // Scene-color refraction travels through the same participating volume as
-      // environment refraction. Omitting texturedVolumeTint here made thickness,
-      // attenuationDistance, and attenuationColor byte-identical whenever the
-      // renderer-owned backdrop path was active.
       texturedRefractionRadiance = mix(
         texturedRefractionRadiance,
         backdropRadiance * texturedVolumeTint * texturedTransmissionAmount * mix(1.0, 1.22, texturedBackdropWeight),
@@ -2720,6 +3146,9 @@ void main() {
       attenuation *= smoothstep(outer, inner, cone);
     }
     float shadowFactor = mix(1.0, kind > 0.5 && kind < 1.5 ? a3dTexturedPbrPointShadowFactor(v_worldPosition, mappedNormal, lightDirection) : a3dTexturedPbrShadowFactor(v_worldPosition, mappedNormal, lightDirection), step(0.5, spotShadowLayer.z));
+#ifndef A3D_PBR_NO_SPOT_SHADOW
+    shadowFactor = a3dTexturedPbrResolveSpotShadowOverride(shadowFactor, kind, spotShadowLayer.z, v_worldPosition, mappedNormal, lightDirection);
+#endif
     float directLightIntensity = colorIntensity.a
       * attenuation
       * shadowFactor
@@ -2746,7 +3175,10 @@ void main() {
       iridescence,
       u_iridescenceIor,
       iridescenceThickness,
-      iridescenceThickness
+      iridescenceThickness,
+      iridescenceSubstrateF0,
+      mappedNormal,
+      roughness
     ) * directExtensionSpecularScale;
   }
   float alpha = texturedBase.a;
@@ -2781,28 +3213,18 @@ out float v_lineDistance;
 out float v_halfWidthPixels;
 
 void main() {
-  // a_position holds this vertex's anchor endpoint in world space. It is referenced
-  // with zero weight so the attribute is not optimized out of the linked program:
-  // bounds computation, frustum culling, and the material's attribute contract all
-  // depend on the geometry declaring a real position stream.
   vec3 anchorWorld = a_position;
   vec4 clipStart = u_modelViewProjection * vec4(a_lineStart + anchorWorld * 0.0, 1.0);
   vec4 clipEnd = u_modelViewProjection * vec4(a_lineEnd, 1.0);
 
-  // Guard against a zero or negative w: a vertex behind the eye would otherwise
-  // produce a wildly wrong NDC position and a smeared quad.
   float wStart = max(abs(clipStart.w), 1e-5);
   float wEnd = max(abs(clipEnd.w), 1e-5);
 
-  // Project to device pixels. Expansion happens here, so the resulting width is a
-  // pixel quantity and is therefore independent of depth, FOV, and viewport size.
   vec2 pixelStart = (clipStart.xy / wStart) * 0.5 * u_lineResolution;
   vec2 pixelEnd = (clipEnd.xy / wEnd) * 0.5 * u_lineResolution;
 
   vec2 pixelDirection = pixelEnd - pixelStart;
   float pixelLength = length(pixelDirection);
-  // A segment that projects to a single pixel has no screen direction; pick an
-  // arbitrary axis so the cap still renders instead of collapsing.
   vec2 direction = pixelLength > 1e-4 ? pixelDirection / pixelLength : vec2(1.0, 0.0);
   vec2 normal = vec2(-direction.y, direction.x);
 
@@ -2811,14 +3233,10 @@ void main() {
 
   float along = a_lineCorner.y;
   vec2 anchorPixel = mix(pixelStart, pixelEnd, along);
-  // Square caps push the quad outward along the segment direction so the stroke
-  // extends half a width past each endpoint, matching Three.js LineMaterial behaviour.
   float capExtension = u_lineSquareCaps > 0.5 ? halfWidth : 0.0;
   vec2 capOffset = direction * (along > 0.5 ? capExtension : -capExtension);
   vec2 pixelPosition = anchorPixel + normal * (a_lineCorner.x * halfWidth) + capOffset;
 
-  // Back to clip space, preserving the anchor endpoint's own depth so the line
-  // depth-sorts against the rest of the scene correctly.
   vec4 anchorClip = along > 0.5 ? clipEnd : clipStart;
   float anchorW = along > 0.5 ? wEnd : wStart;
   vec2 ndc = pixelPosition / (0.5 * u_lineResolution);
@@ -2847,12 +3265,9 @@ void main() {
   if (u_lineDashSize > 0.0) {
     float period = u_lineDashSize + max(u_lineGapSize, 0.0);
     float phase = mod(v_lineDistance + u_lineDashOffset, period);
-    // Discard the gap portion of each dash period.
     if (phase > u_lineDashSize) discard;
   }
   if (u_lineRoundCaps > 0.5) {
-    // Round caps: reject fragments outside the unit half-disc at each end. The
-    // corner's x component already spans -1..1 across the stroke width.
     float acrossStroke = v_lineCorner.x;
     if (abs(acrossStroke) > 1.0) discard;
   }