@aura3d/rendering 1.5.2 → 2.0.0

package/dist/ShaderLibrary.js

@@ -1,691 +1,55 @@
-import { ShaderPreprocessor } from "./ShaderPreprocessor.js";
-import { DEFAULT_PBR_SHADER_MARKER, DEFAULT_PBR_SHADER_NAME } from "./PBRMaterial.js";
 import { SHADER_CHUNKS, validateShaderChunks } from "./ShaderChunks.js";
 import { registerAnimationToonShader } from "./animation/AnimationToonMaterial.js";
-export class ShaderLibrary {
-    shaders = new Map();
-    chunks = new Map();
-    preprocessor = new ShaderPreprocessor();
-    variantCache = new Map();
-    register(shader) {
-        if (this.shaders.has(shader.name)) {
-            throw new Error(`Shader is already registered: ${shader.name}`);
-        }
-        this.assertMarker(shader);
-        this.assertVariants(shader);
-        this.shaders.set(shader.name, shader);
-        this.variantCache.clear();
-    }
-    registerChunk(name, source) {
-        if (this.chunks.has(name)) {
-            throw new Error(`Shader chunk is already registered: ${name}`);
-        }
-        this.chunks.set(name, source);
-        this.variantCache.clear();
-    }
-    get(name) {
-        const shader = this.shaders.get(name);
-        if (!shader) {
-            throw new Error(`Shader is not registered: ${name}`);
-        }
-        return shader;
-    }
-    compileSource(name, options = {}) {
-        const shader = this.get(name);
-        const includes = new Map([...this.chunks, ...(options.includes ?? new Map())]);
-        const preprocessOptions = { ...options, includes };
-        const vertex = this.preprocessor.preprocess(shader.vertex, preprocessOptions).source;
-        const fragment = this.preprocessor.preprocess(shader.fragment, preprocessOptions).source;
-        if (!vertex.includes(shader.marker) || !fragment.includes(shader.marker)) {
-            throw new Error(`Shader marker ${shader.marker} was not preserved for ${name}`);
-        }
-        return { label: name, marker: shader.marker, vertex, fragment };
-    }
-    compileVariant(name, variantName, options = {}) {
-        const shader = this.get(name);
-        const variant = shader.variants?.find((candidate) => candidate.name === variantName);
-        if (!variant) {
-            throw new Error(`Shader variant is not registered: ${name}:${variantName}`);
-        }
-        const compileOptions = {
-            ...options,
-            defines: {
-                ...(variant.defines ?? {}),
-                ...(options.defines ?? {})
-            }
-        };
-        const cacheKey = variantCacheKey(name, variantName, compileOptions);
-        const cached = this.variantCache.get(cacheKey);
-        if (cached) {
-            return cached;
-        }
-        const compiled = this.compileSource(name, compileOptions);
-        const labeled = { ...compiled, label: `${name}:${variantName}` };
-        this.variantCache.set(cacheKey, labeled);
-        return labeled;
-    }
-    names() {
-        return [...this.shaders.keys()];
-    }
-    assertMarker(shader) {
-        if (!shader.marker.trim()) {
-            throw new Error(`Shader ${shader.name} must declare a non-empty source marker`);
-        }
-        if (!shader.vertex.includes(shader.marker) || !shader.fragment.includes(shader.marker)) {
-            throw new Error(`Shader ${shader.name} must include marker ${shader.marker} in both stages`);
-        }
-    }
-    assertVariants(shader) {
-        const seen = new Set();
-        for (const variant of shader.variants ?? []) {
-            if (!variant.name.trim()) {
-                throw new Error(`Shader ${shader.name} has a variant with an empty name`);
-            }
-            if (seen.has(variant.name)) {
-                throw new Error(`Shader variant is already registered: ${shader.name}:${variant.name}`);
-            }
-            seen.add(variant.name);
-        }
-    }
-}
-function variantCacheKey(name, variantName, options) {
-    return JSON.stringify({
-        name,
-        variantName,
-        defines: Object.entries(options.defines ?? {}).sort(([left], [right]) => left.localeCompare(right)),
-        includes: [...(options.includes ?? new Map()).entries()].sort(([left], [right]) => left.localeCompare(right))
-    });
-}
-export const DEFAULT_UNLIT_SHADER_NAME = "aura3d/unlit";
-export const DEFAULT_UNLIT_SHADER_MARKER = "@aura3d-shader:unlit";
-export const DEFAULT_INSTANCED_UNLIT_SHADER_NAME = "aura3d/instanced-unlit";
-export const DEFAULT_INSTANCED_UNLIT_SHADER_MARKER = "@aura3d-shader:instanced-unlit";
-export const DEFAULT_INSTANCED_PBR_SHADER_NAME = "aura3d/instanced-pbr";
-export const DEFAULT_INSTANCED_PBR_SHADER_MARKER = "@aura3d-shader:instanced-pbr";
-export const DEFAULT_TEXTURED_UNLIT_SHADER_NAME = "aura3d/textured-unlit";
-export const DEFAULT_TEXTURED_UNLIT_SHADER_MARKER = "@aura3d-shader:textured-unlit";
-export const DEFAULT_SKINNED_UNLIT_SHADER_NAME = "aura3d/skinned-unlit";
-export const DEFAULT_SKINNED_UNLIT_SHADER_MARKER = "@aura3d-shader:skinned-unlit";
-export const DEFAULT_SKINNED_LIT_SHADER_NAME = "aura3d/skinned-lit";
-export const DEFAULT_SKINNED_LIT_SHADER_MARKER = "@aura3d-shader:skinned-lit";
-/**
- * Eight-influence skinned shaders. These read a second `JOINTS_1`/`WEIGHTS_1`
- * attribute set and select between uniform-array and data-texture joint palettes at
- * runtime through `u_jointPaletteMode`, so a single program serves both small rigs
- * and rigs above the uniform-array joint limit.
- */
-export const DEFAULT_SKINNED_UNLIT_EIGHT_INFLUENCE_SHADER_NAME = "aura3d/skinned-unlit-8";
-export const DEFAULT_SKINNED_UNLIT_EIGHT_INFLUENCE_SHADER_MARKER = "@aura3d-shader:skinned-unlit-8";
-export const DEFAULT_SKINNED_LIT_EIGHT_INFLUENCE_SHADER_NAME = "aura3d/skinned-lit-8";
-export const DEFAULT_SKINNED_LIT_EIGHT_INFLUENCE_SHADER_MARKER = "@aura3d-shader:skinned-lit-8";
-export const DEFAULT_MORPH_UNLIT_SHADER_NAME = "aura3d/morph-unlit";
-export const DEFAULT_MORPH_UNLIT_SHADER_MARKER = "@aura3d-shader:morph-unlit";
-export const DEFAULT_NORMAL_MAPPED_PBR_SHADER_NAME = "aura3d/pbr-normal-map";
-export const DEFAULT_NORMAL_MAPPED_PBR_SHADER_MARKER = "@aura3d-shader:pbr-normal-map";
-export const DEFAULT_TEXTURED_PBR_SHADER_NAME = "aura3d/pbr-textured";
-export const DEFAULT_TEXTURED_PBR_SHADER_MARKER = "@aura3d-shader:pbr-textured";
-export const DEFAULT_TEXTURED_PBR_CLEARCOAT_TEXTURES_VARIANT = "clearcoat-textures";
-export const DEFAULT_TEXTURED_PBR_TRANSMISSION_VOLUME_TEXTURES_VARIANT = "transmission-volume-textures";
-export const DEFAULT_TEXTURED_PBR_SPECULAR_SHEEN_ANISOTROPY_TEXTURES_VARIANT = "specular-sheen-anisotropy-textures";
-export const DEFAULT_TEXTURED_PBR_IRIDESCENCE_TEXTURES_VARIANT = "iridescence-textures";
-export const DEFAULT_TEXTURED_PBR_CLEARCOAT_TRANSMISSION_VOLUME_TEXTURES_VARIANT = "clearcoat-transmission-volume-textures";
-export const DEFAULT_TEXTURED_PBR_CLEARCOAT_SPECULAR_TEXTURES_VARIANT = "clearcoat-specular-textures";
-export const DEFAULT_TEXTURED_PBR_SPECULAR_SHEEN_ANISOTROPY_IRIDESCENCE_TEXTURES_VARIANT = "specular-sheen-anisotropy-iridescence-textures";
-/**
- * True screen-space fat lines, equivalent in intent to Three.js `Line2`/`LineMaterial`.
- * Width is specified in pixels and stays constant across distance, FOV, viewport size,
- * and device pixel ratio.
- */
-export const DEFAULT_SCREEN_SPACE_LINE_SHADER_NAME = "aura3d/screen-space-line";
-export const DEFAULT_SCREEN_SPACE_LINE_SHADER_MARKER = "@aura3d-shader:screen-space-line";
-export const DEFAULT_DEPTH_SHADER_NAME = "aura3d/depth";
-export const DEFAULT_DEPTH_SHADER_MARKER = "@aura3d-shader:depth";
-export const DEFAULT_ENVIRONMENT_BACKGROUND_SHADER_NAME = "aura3d/environment-background";
-export const DEFAULT_ENVIRONMENT_BACKGROUND_SHADER_MARKER = "@aura3d-shader:environment-background";
-export function createDefaultShaderLibrary() {
-    const library = new ShaderLibrary();
-    validateShaderChunks();
-    for (const chunk of SHADER_CHUNKS) {
-        library.registerChunk(chunk.name, chunk.source);
-    }
-    library.register({
-        name: DEFAULT_UNLIT_SHADER_NAME,
-        marker: DEFAULT_UNLIT_SHADER_MARKER,
-        vertex: `#version 300 es
-// ${DEFAULT_UNLIT_SHADER_MARKER}
-precision highp float;
-layout(location = 0) in vec3 a_position;
-layout(location = 4) in vec4 a_color;
-uniform mat4 u_modelViewProjection;
-uniform float u_pointSize;
-out vec4 v_vertexColor;
-void main() {
-  v_vertexColor = a_color;
-  gl_PointSize = max(u_pointSize, 1.0);
-  gl_Position = u_modelViewProjection * vec4(a_position, 1.0);
-}
-`,
-        fragment: `#version 300 es
-// ${DEFAULT_UNLIT_SHADER_MARKER}
-precision highp float;
-uniform vec4 u_baseColor;
-uniform float u_alphaCutoff;
-uniform float u_roundPoints;
-in vec4 v_vertexColor;
-out vec4 outColor;
-void main() {
-  if (u_roundPoints > 0.5) {
-    vec2 pointUv = gl_PointCoord * 2.0 - 1.0;
-    float radius = dot(pointUv, pointUv);
-    if (radius > 1.0) discard;
-  }
-  vec4 base = u_baseColor * v_vertexColor;
-  if (base.a < u_alphaCutoff) discard;
-  outColor = base;
-}
-`
-    });
-    library.register({
-        name: DEFAULT_INSTANCED_UNLIT_SHADER_NAME,
-        marker: DEFAULT_INSTANCED_UNLIT_SHADER_MARKER,
-        vertex: `#version 300 es
-// ${DEFAULT_INSTANCED_UNLIT_SHADER_MARKER}
-precision highp float;
-layout(location = 0) in vec3 a_position;
-layout(location = 4) in vec4 a_color;
-uniform mat4 u_modelViewProjection;
-uniform mat4 u_instanceMatrices[64];
-uniform float u_instanceCount;
-uniform float u_instanceAttributeMode;
-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;
-out vec4 v_vertexColor;
-void main() {
-  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);
-}
-`,
-        fragment: `#version 300 es
-// ${DEFAULT_INSTANCED_UNLIT_SHADER_MARKER}
-precision highp float;
-uniform vec4 u_baseColor;
-uniform float u_alphaCutoff;
-in vec4 v_vertexColor;
-out vec4 outColor;
-void main() {
-  vec4 base = u_baseColor * v_vertexColor;
-  if (base.a < u_alphaCutoff) discard;
-  outColor = base;
-}
-`
-    });
-    library.register({
-        name: DEFAULT_PBR_SHADER_NAME,
-        marker: DEFAULT_PBR_SHADER_MARKER,
-        vertex: `#version 300 es
-// ${DEFAULT_PBR_SHADER_MARKER}
-precision highp float;
-layout(location = 0) in vec3 a_position;
-layout(location = 1) in vec3 a_normal;
-layout(location = 4) in vec4 a_color;
-uniform mat4 u_modelViewProjection;
-uniform mat4 u_modelMatrix;
-uniform mat4 u_normalMatrix;
-out vec3 v_normal;
-out vec3 v_worldPosition;
-out vec4 v_vertexColor;
-void main() {
-  v_normal = mat3(u_normalMatrix) * a_normal;
-  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
-// ${DEFAULT_PBR_SHADER_MARKER}
-precision highp float;
-#include <lighting_common>
-#include <pbr_common>
-uniform vec4 u_baseColor;
-uniform float u_alphaCutoff;
-uniform float u_metallic;
-uniform float u_roughness;
-uniform vec3 u_environmentColor;
-uniform float u_environmentIntensity;
-uniform vec3 u_environmentSkyColor;
-uniform vec3 u_environmentHorizonColor;
-uniform vec3 u_environmentGroundColor;
-uniform vec3 u_environmentSpecularColor;
-uniform float u_environmentMapIntensity;
-uniform float u_environmentSpecularIntensity;
-uniform sampler2D u_environmentMapTexture;
-uniform samplerCube u_environmentCubeMapTexture;
-uniform float u_environmentCubeMapTextureEnabled;
-uniform float u_environmentMapTextureEnabled;
-uniform float u_environmentMapTextureIntensity;
-uniform float u_environmentMapTextureSpecularIntensity;
-uniform float u_environmentMapTextureRotation;
-uniform float u_environmentMapTextureMipCount;
-uniform float u_environmentMapTextureEncoding;
-uniform sampler2D u_environmentBrdfLutTexture;
-uniform float u_environmentBrdfLutEnabled;
-uniform vec3 u_emissiveColor;
-uniform float u_emissiveStrength;
-uniform float u_clearcoatFactor;
-uniform float u_clearcoatRoughnessFactor;
-uniform float u_transmissionFactor;
-uniform float u_diffuseTransmissionFactor;
-uniform vec3 u_diffuseTransmissionColorFactor;
-uniform float u_transmissionFallbackEnergy;
-uniform float u_volumeThicknessFactor;
-uniform float u_volumeAttenuationDistance;
-uniform vec3 u_volumeAttenuationColor;
-uniform float u_transmissionParallaxStrength;
-uniform vec3 u_transmissionParallaxBoxMin;
-uniform vec3 u_transmissionParallaxBoxMax;
-uniform float u_transmissionBounceCount;
-uniform float u_transmissionCausticStrength;
-uniform float u_ior;
-uniform float u_specularFactor;
-uniform vec3 u_specularColorFactor;
-uniform vec3 u_sheenColorFactor;
-uniform float u_sheenRoughnessFactor;
-uniform float u_anisotropyStrength;
-uniform float u_anisotropyRotation;
-uniform float u_iridescenceFactor;
-uniform float u_iridescenceIor;
-uniform float u_iridescenceThicknessMinimum;
-uniform float u_iridescenceThicknessMaximum;
-uniform float u_dispersion;
-uniform float u_lightCount;
-uniform vec4 u_lightData[96];
-uniform float u_clusteredLightEnabled;
-uniform vec2 u_clusterGridSize;
-uniform vec2 u_clusterViewportSize;
-uniform sampler2D u_clusterLightData;
-uniform sampler2D u_clusterLightIndices;
-uniform sampler2D u_shadowMapTexture;
-uniform float u_shadowMapEnabled;
-uniform mat4 u_shadowMapMatrix;
-uniform float u_shadowMapStrength;
-uniform float u_shadowMapBias;
-uniform float u_shadowMapSlopeBias;
-uniform vec2 u_shadowMapTexelSize;
-uniform float u_shadowPcfSampleCount;
-uniform vec4 u_shadowPcfSamples[32];
-uniform sampler2D u_pointShadowMapTexture;
-uniform float u_pointShadowMapEnabled;
-uniform vec3 u_pointShadowLightPosition;
-uniform float u_pointShadowRange;
-uniform mat4 u_pointShadowFaceMatrices[6];
-uniform vec4 u_pointShadowFaceRects[6];
-uniform float u_pointShadowStrength;
-uniform float u_pointShadowBias;
-uniform float u_pointShadowSlopeBias;
-uniform vec2 u_pointShadowTexelSize;
-uniform float u_pointShadowPcfSampleCount;
-uniform vec4 u_pointShadowPcfSamples[32];
-uniform float u_outputColorSpace;
-uniform vec3 u_cameraPosition;
-uniform float u_environmentFogEnabled;
-uniform float u_environmentFogMode;
-uniform vec3 u_environmentFogColor;
-uniform float u_environmentFogNear;
-uniform float u_environmentFogFar;
-uniform float u_environmentFogDensity;
-uniform float u_environmentFogHeightFalloff;
-uniform float u_environmentFogHeightReference;
-uniform float u_environmentFogMaxOpacity;
-in vec3 v_normal;
-in vec3 v_worldPosition;
-in vec4 v_vertexColor;
-out vec4 outColor;
-#include <environment_fog_common>
-vec2 a3dEnvironmentEquirectUv(vec3 direction, float rotation) {
-  vec3 d = normalize(direction);
-  float u = atan(d.z, d.x) / 6.28318530718 + 0.5 + rotation;
-  float v = acos(clamp(d.y, -1.0, 1.0)) / 3.14159265359;
-  return vec2(fract(u), clamp(v, 0.0, 1.0));
-}
-vec3 a3dEnvironmentCubeDirection(vec3 direction, float rotation) {
-  float angle = rotation * 6.28318530718;
-  float c = cos(angle);
-  float s = sin(angle);
-  vec3 d = normalize(direction);
-  return normalize(vec3(c * d.x - s * d.z, d.y, s * d.x + c * d.z));
-}
-vec3 a3dPbrDecodeEnvironmentSrgb(vec3 encodedColor) {
-  return max(encodedColor, vec3(0.0));
-}
-vec3 a3dPbrDecodeEnvironmentRgbe(vec4 encodedSample) {
-  float exponent = encodedSample.a * 255.0;
-  float scale = exponent <= 0.0 ? 0.0 : exp2(exponent - 128.0) * (255.0 / 256.0);
-  return max(encodedSample.rgb * scale, vec3(0.0));
-}
-vec3 a3dPbrDecodeEnvironmentSample(vec4 encodedSample) {
-  if (u_environmentMapTextureEncoding > 1.5) return max(encodedSample.rgb, vec3(0.0));
-  if (u_environmentMapTextureEncoding > 0.5) return a3dPbrDecodeEnvironmentRgbe(encodedSample);
-  return a3dPbrDecodeEnvironmentSrgb(encodedSample.rgb);
-}
-vec3 a3dPbrBoundHdrTransmissionRadiance(vec3 radiance) {
-  vec3 nonNegative = max(radiance, vec3(0.0));
-  return nonNegative / (vec3(1.0) + max(nonNegative - vec3(1.0), vec3(0.0)));
-}
-vec3 a3dPbrBoundHdrSpecularRadiance(vec3 radiance) {
-  vec3 nonNegative = max(radiance, vec3(0.0));
-  vec3 softKnee = nonNegative / (vec3(1.0) + max(nonNegative - vec3(1.0), vec3(0.0)) * 0.58);
-  float maxChannel = max(max(softKnee.r, softKnee.g), softKnee.b);
-  return maxChannel > 1.65 ? softKnee * (1.65 / maxChannel) : softKnee;
-}
-vec3 a3dPbrClampSampledSpecularEdgeEnergy(vec3 radiance, float nDotV, float roughness) {
-  float faceOn = smoothstep(0.12, 0.55, clamp(nDotV, 0.0, 1.0));
-  float roughEnergy = mix(0.6, 1.0, clamp(roughness, 0.0, 1.0));
-  float edgeCap = mix(0.12, 1.2, faceOn) * roughEnergy;
-  float edgeScale = mix(0.14, 0.92, faceOn);
-  vec3 bounded = min(radiance * edgeScale, vec3(edgeCap));
-  return max(bounded, vec3(0.0));
-}
-vec4 a3dPbrEnvironmentSampleRaw(vec3 direction, float lod) {
-  vec4 equirectSample = textureLod(u_environmentMapTexture, a3dEnvironmentEquirectUv(direction, u_environmentMapTextureRotation), lod);
-  vec4 cubeSample = textureLod(u_environmentCubeMapTexture, a3dEnvironmentCubeDirection(direction, u_environmentMapTextureRotation), lod);
-  return mix(equirectSample, cubeSample, step(0.5, u_environmentCubeMapTextureEnabled));
-}
-vec3 a3dPbrBoxProjectedDirection(vec3 worldPosition, vec3 direction, vec3 boxMin, vec3 boxMax) {
-  vec3 safeDirection = normalize(direction);
-  vec3 invDirection = 1.0 / max(abs(safeDirection), vec3(0.0001)) * sign(safeDirection);
-  vec3 firstPlane = mix(boxMin, boxMax, step(vec3(0.0), safeDirection));
-  vec3 distances = (firstPlane - worldPosition) * invDirection;
-  float travel = min(min(
-    distances.x > 0.0 ? distances.x : 100000.0,
-    distances.y > 0.0 ? distances.y : 100000.0
-  ), distances.z > 0.0 ? distances.z : 100000.0);
-  vec3 hitPosition = worldPosition + safeDirection * travel;
-  vec3 boxCenter = (boxMin + boxMax) * 0.5;
-  return normalize(hitPosition - boxCenter);
-}
-float a3dForwardShadowFactor(vec3 worldPosition, vec3 normal, vec3 lightDirection) {
-  if (u_shadowMapEnabled < 0.5) return 1.0;
-  vec4 lightPosition = u_shadowMapMatrix * 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);
-  // 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;
-  float shadowed = 0.0;
-  float totalWeight = 0.0;
-  int sampleCount = clamp(int(u_shadowPcfSampleCount), 1, 32);
-  for (int i = 0; i < 32; ++i) {
-    if (i >= sampleCount) break;
-    vec4 sampleData = u_shadowPcfSamples[i];
-    float weight = max(sampleData.z, 0.0);
-    vec2 offset = sampleData.xy * u_shadowMapTexelSize;
-    float storedDepth = texture(u_shadowMapTexture, uv + offset).r;
-    float sampleTexelDistance = max(1.0, length(sampleData.xy));
-    float receiverDepth = projectedDepth - u_shadowMapBias - 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_shadowMapStrength, 0.0, 1.0));
-}
-float a3dPointShadowFaceIndex(vec3 direction) {
-  vec3 absoluteDirection = abs(direction);
-  if (absoluteDirection.x >= absoluteDirection.y && absoluteDirection.x >= absoluteDirection.z) return direction.x >= 0.0 ? 0.0 : 1.0;
-  if (absoluteDirection.y >= absoluteDirection.x && absoluteDirection.y >= absoluteDirection.z) return direction.y >= 0.0 ? 2.0 : 3.0;
-  return direction.z >= 0.0 ? 4.0 : 5.0;
-}
-float a3dPointShadowFactor(vec3 worldPosition, vec3 normal, vec3 lightDirection) {
-  if (u_pointShadowMapEnabled < 0.5) return 1.0;
-  vec3 lightToFragment = worldPosition - u_pointShadowLightPosition;
-  float distanceToLight = length(lightToFragment);
-  if (distanceToLight > u_pointShadowRange) return 1.0;
-  int faceIndex = int(a3dPointShadowFaceIndex(lightToFragment));
-  vec4 lightPosition = u_pointShadowFaceMatrices[faceIndex] * vec4(worldPosition, 1.0);
-  vec3 projected = lightPosition.xyz / max(lightPosition.w, 0.0001);
-  vec2 localUv = projected.xy * 0.5 + 0.5;
-  if (localUv.x < 0.0 || localUv.x > 1.0 || localUv.y < 0.0 || localUv.y > 1.0) return 1.0;
-  vec4 rect = u_pointShadowFaceRects[faceIndex];
-  vec2 uv = rect.xy + localUv * rect.zw;
-  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;
-  float shadowed = 0.0;
-  float totalWeight = 0.0;
-  int sampleCount = clamp(int(u_pointShadowPcfSampleCount), 1, 32);
-  for (int i = 0; i < 32; ++i) {
-    if (i >= sampleCount) break;
-    vec4 sampleData = u_pointShadowPcfSamples[i];
-    float weight = max(sampleData.z, 0.0);
-    vec2 offset = sampleData.xy * u_pointShadowTexelSize;
-    float storedDepth = texture(u_pointShadowMapTexture, uv + offset).r;
-    float sampleTexelDistance = max(1.0, length(sampleData.xy));
-    float receiverDepth = projectedDepth - u_pointShadowBias - 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_pointShadowStrength, 0.0, 1.0));
-}
-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));
-  return mix(color, srgb, step(0.5, u_outputColorSpace));
+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";
+export * from "./ShaderLibraryCore.js";
+export function createDefaultShaderLibrary() {
+    const library = new ShaderLibrary();
+    validateShaderChunks();
+    for (const chunk of SHADER_CHUNKS) {
+        library.registerChunk(chunk.name, chunk.source);
+    }
+    registerLeanUnlitShader(library);
+    library.register({
+        name: DEFAULT_INSTANCED_UNLIT_SHADER_NAME,
+        marker: DEFAULT_INSTANCED_UNLIT_SHADER_MARKER,
+        vertex: `#version 300 es
+// ${DEFAULT_INSTANCED_UNLIT_SHADER_MARKER}
+precision highp float;
+layout(location = 0) in vec3 a_position;
+layout(location = 4) in vec4 a_color;
+uniform mat4 u_modelViewProjection;
+uniform mat4 u_instanceMatrices[64];
+uniform float u_instanceCount;
+uniform float u_instanceAttributeMode;
+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;
+out vec4 v_vertexColor;
+void main() {
+  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);
 }
+`,
+        fragment: `#version 300 es
+// ${DEFAULT_INSTANCED_UNLIT_SHADER_MARKER}
+precision highp float;
+uniform vec4 u_baseColor;
+uniform float u_alphaCutoff;
+in vec4 v_vertexColor;
+out vec4 outColor;
 void main() {
-  vec3 normal = normalize(v_normal);
-  if (!gl_FrontFacing) normal = -normal;
-  vec3 viewDirection = normalize(u_cameraPosition - v_worldPosition);
-  vec3 materialBase = a3dApplyAdvancedPbrLobes(
-    u_baseColor.rgb * v_vertexColor.rgb,
-    u_clearcoatFactor,
-    u_clearcoatRoughnessFactor,
-    u_transmissionFactor,
-    u_diffuseTransmissionFactor,
-    u_diffuseTransmissionColorFactor,
-    u_transmissionFallbackEnergy,
-    u_volumeThicknessFactor,
-    u_volumeAttenuationDistance,
-    u_volumeAttenuationColor,
-    u_ior,
-    u_specularFactor,
-    u_specularColorFactor,
-    u_sheenColorFactor,
-    u_sheenRoughnessFactor,
-    u_anisotropyStrength,
-    u_anisotropyRotation,
-    u_iridescenceFactor,
-    u_iridescenceIor,
-    u_iridescenceThicknessMinimum,
-    u_iridescenceThicknessMaximum,
-    u_dispersion
-  );
-  float environmentHemi = mix(0.35, 1.0, clamp(normal.y * 0.5 + 0.5, 0.0, 1.0));
-  vec3 ambientEnvironment = u_environmentColor * u_environmentIntensity * environmentHemi;
-  float proceduralEnvironmentWeight = step(0.0001, u_environmentMapIntensity);
-  float skyBlend = clamp(normal.y * 0.5 + 0.5, 0.0, 1.0);
-  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));
-  environmentDiffuse = mix(environmentDiffuse, ambientEnvironment + sampledDiffuse * u_environmentMapTextureIntensity, sampledEnvironmentWeight);
-  vec3 reflectionDirection = reflect(-viewDirection, normal);
-  float roughness = clamp(u_roughness, 0.0, 1.0);
-  float reflectionBand = pow(clamp(reflectionDirection.y * 0.5 + 0.5, 0.0, 1.0), mix(18.0, 2.0, roughness));
-  float roughEnvironmentFloor = mix(0.04, 0.38, roughness);
-  float proceduralSpecularResponse = max(reflectionBand, roughEnvironmentFloor);
-  vec3 proceduralSpecular = u_environmentSpecularColor * u_environmentSpecularIntensity * proceduralSpecularResponse * proceduralEnvironmentWeight;
-  float environmentLod = roughness * max(u_environmentMapTextureMipCount - 1.0, 0.0);
-  vec3 sampledSpecular = a3dPbrBoundHdrSpecularRadiance(a3dPbrDecodeEnvironmentSample(a3dPbrEnvironmentSampleRaw(reflectionDirection, environmentLod)));
-  float nDotV = clamp(dot(normal, viewDirection), 0.0, 1.0);
-  vec2 brdfLut = texture(u_environmentBrdfLutTexture, vec2(nDotV, roughness)).rg;
-  sampledSpecular = a3dPbrClampSampledSpecularEdgeEnergy(sampledSpecular, nDotV, roughness);
-  sampledSpecular *= u_environmentMapTextureSpecularIntensity * sampledEnvironmentWeight * mix(1.1, 0.85, roughness);
-  vec3 shaded = a3dPbrEnvironmentLightSplitSum(
-    normal,
-    viewDirection,
-    environmentDiffuse,
-    proceduralSpecular + sampledSpecular,
-    mix(vec2(1.0, 0.0), brdfLut, step(0.0001, u_environmentBrdfLutEnabled)),
-    materialBase,
-    u_metallic,
-    u_roughness,
-    u_specularFactor,
-    u_specularColorFactor
-  ) + u_emissiveColor * u_emissiveStrength;
-  shaded += a3dPbrExtensionEnvironmentLight(
-    normal,
-    viewDirection,
-    proceduralSpecular + sampledSpecular,
-    u_clearcoatFactor,
-    u_clearcoatRoughnessFactor,
-    u_sheenColorFactor,
-    u_sheenRoughnessFactor,
-    u_anisotropyStrength,
-    u_anisotropyRotation,
-    u_iridescenceFactor,
-    u_iridescenceIor,
-    u_iridescenceThicknessMinimum,
-    u_iridescenceThicknessMaximum
-  );
-  float transmissionAmount = clamp(max(u_transmissionFactor, u_diffuseTransmissionFactor), 0.0, 1.0);
-  if (transmissionAmount > 0.0001 && sampledEnvironmentWeight > 0.0001) {
-    vec3 refractionDirection = refract(-viewDirection, normal, 1.0 / max(u_ior, 1.0));
-    refractionDirection = length(refractionDirection) > 0.0001 ? normalize(refractionDirection) : -reflectionDirection;
-    float parallaxStrength = clamp(u_transmissionParallaxStrength, 0.0, 1.0);
-    if (parallaxStrength > 0.0001) {
-      vec3 parallaxDirection = a3dPbrBoxProjectedDirection(v_worldPosition, refractionDirection, u_transmissionParallaxBoxMin, u_transmissionParallaxBoxMax);
-      refractionDirection = normalize(mix(refractionDirection, parallaxDirection, parallaxStrength));
-    }
-    float bounceCount = clamp(u_transmissionBounceCount, 0.0, 4.0);
-    float refractionLod = clamp(roughness + u_volumeThicknessFactor * 0.12 + bounceCount * 0.04 * parallaxStrength, 0.0, 1.0) * max(u_environmentMapTextureMipCount - 1.0, 0.0);
-    vec3 refractedEnvironment = a3dPbrBoundHdrTransmissionRadiance(a3dPbrDecodeEnvironmentSample(a3dPbrEnvironmentSampleRaw(refractionDirection, refractionLod)));
-    float volumeTravel = clamp((max(u_volumeThicknessFactor, 0.0) * (1.0 + bounceCount * 0.18 * parallaxStrength)) / max(u_volumeAttenuationDistance, 0.0001), 0.0, 16.0);
-    vec3 volumeTint = pow(clamp(u_volumeAttenuationColor, vec3(0.0001), vec3(1.0)), vec3(volumeTravel));
-    float causticEnergy = u_transmissionCausticStrength * parallaxStrength * transmissionAmount * pow(1.0 - roughness, 2.0) / (1.0 + bounceCount * 0.35);
-    float roughVolumeIorLift = mix(1.0, 1.45, clamp((u_ior - 1.0) / 1.5, 0.0, 1.0) * smoothstep(0.35, 0.95, roughness + u_volumeThicknessFactor * 0.2));
-    float fallbackEnvironmentTransmissionEnergy = mix(1.0, clamp(u_transmissionFallbackEnergy, 0.0, 1.0), transmissionAmount);
-    vec3 refractionRadiance = (refractedEnvironment + vec3(causticEnergy)) * volumeTint * u_environmentMapTextureIntensity * transmissionAmount * fallbackEnvironmentTransmissionEnergy * mix(0.9, 0.55, roughness) * roughVolumeIorLift;
-    shaded = mix(shaded, shaded * 0.72 + refractionRadiance, transmissionAmount * mix(0.08, 0.58, fallbackEnvironmentTransmissionEnergy));
-  }
-  ivec2 clusterTile = clamp(ivec2(floor(gl_FragCoord.xy / max(u_clusterViewportSize / u_clusterGridSize, vec2(1.0)))), ivec2(0), ivec2(u_clusterGridSize) - ivec2(1));
-  int clusterIndex = clusterTile.y * int(u_clusterGridSize.x) + clusterTile.x;
-  int count = u_clusteredLightEnabled > 0.5 ? min(int(texelFetch(u_clusterLightIndices, ivec2(0, clusterIndex), 0).g), 64) : min(int(u_lightCount), 16);
-  for (int i = 0; i < 64; ++i) {
-    if (i >= count) break;
-    int lightIndex = u_clusteredLightEnabled > 0.5 ? int(texelFetch(u_clusterLightIndices, ivec2(i, clusterIndex), 0).r) : i;
-    int baseIndex = lightIndex * 6;
-    vec4 colorIntensity = u_clusteredLightEnabled > 0.5 ? texelFetch(u_clusterLightData, ivec2(0, lightIndex), 0) : u_lightData[baseIndex];
-    vec4 positionRange = u_clusteredLightEnabled > 0.5 ? texelFetch(u_clusterLightData, ivec2(1, lightIndex), 0) : u_lightData[baseIndex + 1];
-    vec4 directionKind = u_clusteredLightEnabled > 0.5 ? texelFetch(u_clusterLightData, ivec2(2, lightIndex), 0) : u_lightData[baseIndex + 2];
-    vec4 spotShadowLayer = u_clusteredLightEnabled > 0.5 ? texelFetch(u_clusterLightData, ivec2(3, lightIndex), 0) : u_lightData[baseIndex + 3];
-    vec4 areaRight = u_clusteredLightEnabled > 0.5 ? texelFetch(u_clusterLightData, ivec2(4, lightIndex), 0) : u_lightData[baseIndex + 4];
-    vec4 areaUp = u_clusteredLightEnabled > 0.5 ? texelFetch(u_clusterLightData, ivec2(5, lightIndex), 0) : u_lightData[baseIndex + 5];
-    float kind = directionKind.w;
-    if (kind > 2.5) {
-      shaded += a3dPbrRectAreaLight(
-        v_worldPosition, positionRange.xyz, directionKind.xyz, areaRight.xyz, areaUp.xyz,
-        spotShadowLayer.x, spotShadowLayer.y, positionRange.w,
-        normal, viewDirection, colorIntensity.rgb, colorIntensity.a,
-        materialBase, u_metallic, u_roughness, u_specularFactor, u_specularColorFactor
-      );
-      continue;
-    }
-    vec3 lightDirection = -directionKind.xyz;
-    float attenuation = 1.0;
-    if (kind > 0.5) {
-      vec3 toLight = positionRange.xyz - v_worldPosition;
-      float distanceToLight = length(toLight);
-      lightDirection = distanceToLight > 0.0001 ? toLight / distanceToLight : -directionKind.xyz;
-      float range = max(positionRange.w, 0.0001);
-      float rangeFalloff = clamp(1.0 - pow(distanceToLight / range, 4.0), 0.0, 1.0);
-      rangeFalloff *= rangeFalloff;
-      attenuation = rangeFalloff / max(distanceToLight * distanceToLight, 1.0);
-    }
-    if (kind > 1.5) {
-      vec3 lightToFragment = normalize(v_worldPosition - positionRange.xyz);
-      float cone = dot(normalize(directionKind.xyz), lightToFragment);
-      float outer = cos(spotShadowLayer.x);
-      float inner = cos(spotShadowLayer.x * max(1.0 - spotShadowLayer.y, 0.001));
-      attenuation *= smoothstep(outer, inner, cone);
-    }
-    float directLightIntensity = 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));
-    shaded += a3dPbrDirectLight(
-      normal,
-      viewDirection,
-      lightDirection,
-      colorIntensity.rgb,
-      directLightIntensity,
-      materialBase,
-      u_metallic,
-      u_roughness,
-      u_specularFactor,
-      u_specularColorFactor
-    );
-    shaded += a3dPbrExtensionDirectLight(
-      normal,
-      viewDirection,
-      lightDirection,
-      colorIntensity.rgb,
-      directLightIntensity,
-      u_clearcoatFactor,
-      u_clearcoatRoughnessFactor,
-      u_sheenColorFactor,
-      u_sheenRoughnessFactor,
-      u_anisotropyStrength,
-      u_anisotropyRotation,
-      u_iridescenceFactor,
-      u_iridescenceIor,
-      u_iridescenceThicknessMinimum,
-      u_iridescenceThicknessMaximum
-    );
-  }
-  float alpha = u_baseColor.a * v_vertexColor.a;
-  if (alpha < u_alphaCutoff) discard;
-  vec3 fogged = a3dApplyEnvironmentFog(max(shaded, vec3(0.0)), v_worldPosition);
-  outColor = vec4(a3dPbrEncodeOutput(fogged), alpha);
+  vec4 base = u_baseColor * v_vertexColor;
+  if (base.a < u_alphaCutoff) discard;
+  outColor = base;
 }
 `
     });
+    registerLeanPbrShader(library);
     library.register({
         name: DEFAULT_INSTANCED_PBR_SHADER_NAME,
         marker: DEFAULT_INSTANCED_PBR_SHADER_MARKER,
@@ -2955,7 +2319,12 @@ vec3 a3dTexturedPbrEnvironmentSpecularInput(vec3 normal, vec3 viewDirection, flo
   float nDotV = clamp(dot(normal, viewDirection), 0.0, 1.0);
   float faceOnSpecularGate = smoothstep(0.1, 0.42, nDotV);
   float reflectionBand = pow(clamp(reflectionDirection.y * 0.5 + 0.5, 0.0, 1.0), mix(18.0, 2.0, clampedRoughness));
-  float roughEnvironmentFloor = mix(0.04, 0.38, 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));
   float sideStripe = pow(clamp(abs(reflectionDirection.x), 0.0, 1.0), mix(10.0, 3.0, clampedRoughness)) * smoothstep(0.0, 0.72, 1.0 - abs(reflectionDirection.y));
@@ -2974,14 +2343,50 @@ vec3 a3dTexturedPbrEnvironmentSpecularInput(vec3 normal, vec3 viewDirection, flo
   float sampledSpecularScale = materialEnvironmentSpecularScale * mix(0.18, 1.0, faceOnSpecularGate);
   return proceduralSpecular * proceduralSpecularScale + sampledSpecular * sampledSpecularScale;
 }
-vec3 a3dTexturedPbrIridescenceColor(float minimumThickness, float maximumThickness, float iridescenceIor) {
+vec3 a3dTexturedPbrIridescenceColor(float minimumThickness, float maximumThickness, float iridescenceIor, float nDotV) {
   float thickness = clamp((minimumThickness + maximumThickness) * 0.5, 0.0, 1200.0);
-  float phase = clamp((thickness - 100.0) / 1100.0, 0.0, 1.0) * 6.2831853;
+  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;
-  return clamp(0.5 + 0.5 * cos(phase + iorShift + vec3(0.0, 2.0943951, 4.1887902)), vec3(0.0), vec3(1.0));
+  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));
+}
+float a3dTexturedPbrCharlieSheen(float nDotH, float sheenRoughness) {
+  float alpha = max(0.07, sheenRoughness * sheenRoughness);
+  float inverseAlpha = 1.0 / alpha;
+  float sin2h = max(1.0 - nDotH * nDotH, 0.0078125);
+  return (2.0 + inverseAlpha) * pow(sin2h, inverseAlpha * 0.5) / (2.0 * A3D_PI);
+}
+float a3dTexturedPbrAnisotropicDistribution(
+  vec3 normal,
+  vec3 halfVector,
+  vec4 tangentFrame,
+  float roughness,
+  float anisotropy,
+  float rotation
+) {
+  vec3 N = normalize(normal);
+  vec3 authoredTangent = normalize(tangentFrame.xyz);
+  vec3 authoredBitangent = normalize(cross(N, authoredTangent)) * (tangentFrame.w < 0.0 ? -1.0 : 1.0);
+  float c = cos(rotation);
+  float s = sin(rotation);
+  vec3 T = normalize(authoredTangent * c + authoredBitangent * s);
+  vec3 B = normalize(authoredBitangent * c - authoredTangent * s);
+  float alpha = max(0.035, roughness * roughness);
+  float aspect = sqrt(max(0.08, 1.0 - clamp(anisotropy, 0.0, 0.98) * 0.92));
+  float alphaT = max(0.012, alpha / aspect);
+  float alphaB = max(0.012, alpha * aspect);
+  float tDotH = dot(T, halfVector);
+  float bDotH = dot(B, halfVector);
+  float nDotH = max(dot(N, halfVector), 0.0);
+  float denominator = tDotH * tDotH / (alphaT * alphaT)
+    + bDotH * bDotH / (alphaB * alphaB)
+    + nDotH * nDotH;
+  return 1.0 / max(A3D_PI * alphaT * alphaB * denominator * denominator, A3D_EPSILON);
 }
 vec3 a3dTexturedPbrExtensionDirectLight(
   vec3 normal,
+  vec4 tangentFrame,
   vec3 viewDirection,
   vec3 lightDirection,
   vec3 lightColor,
@@ -3010,17 +2415,21 @@ vec3 a3dTexturedPbrExtensionDirectLight(
   float clearcoatD = a3dDistributionGGX(nDotH, clearcoatRough);
   float clearcoatG = a3dGeometrySmithGGXCorrelated(nDotV, nDotL, clearcoatRough);
   vec3 clearcoatLobe = clearcoatF * clearcoatD * clearcoatG * clamp(clearcoat, 0.0, 1.0) * 0.12;
-  float sheenStrength = (1.0 - clamp(sheenRoughness, 0.0, 1.0)) * pow(a3dSaturate(1.0 - vDotH), 5.0);
-  vec3 sheenLobe = clamp(sheenColor, vec3(0.0), vec3(1.0)) * sheenStrength * 0.18;
-  vec3 anisotropyAxis = normalize(vec3(cos(anisotropyRotation), 0.0, sin(anisotropyRotation)));
-  float anisotropyBand = pow(abs(dot(H, anisotropyAxis)), mix(28.0, 6.0, clearcoatRough));
-  vec3 anisotropyLobe = vec3(clamp(anisotropy, 0.0, 1.0) * anisotropyBand * 0.055);
-  vec3 iridescenceColor = a3dTexturedPbrIridescenceColor(iridescenceThicknessMinimum, iridescenceThicknessMaximum, iridescenceIor);
+  float sheenDistribution = a3dTexturedPbrCharlieSheen(nDotH, sheenRoughness);
+  float sheenVisibility = 1.0 / max(4.0 * (nDotV + nDotL - nDotV * nDotL), A3D_EPSILON);
+  float sheenGrazing = pow(1.0 - nDotV, 12.0);
+  vec3 sheenLobe = clamp(sheenColor, vec3(0.0), vec3(1.0))
+    * (sheenDistribution * sheenVisibility * 0.012 + sheenGrazing * 0.18);
+  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 a3dTexturedPbrExtensionEnvironmentLight(
   vec3 normal,
+  vec4 tangentFrame,
   vec3 viewDirection,
   vec3 specularRadiance,
   float clearcoat,
@@ -3039,10 +2448,17 @@ vec3 a3dTexturedPbrExtensionEnvironmentLight(
   float faceOn = smoothstep(0.18, 0.68, nDotV);
   vec3 boundedSpecularRadiance = min(specularRadiance * mix(0.1, 0.82, faceOn), vec3(mix(0.08, 0.95, faceOn)));
   vec3 clearcoatLobe = boundedSpecularRadiance * clearcoatF * clamp(clearcoat, 0.0, 1.0) * 0.045;
-  vec3 sheenLobe = clamp(sheenColor, vec3(0.0), vec3(1.0)) * (1.0 - clamp(sheenRoughness, 0.0, 1.0)) * pow(a3dSaturate(1.0 - nDotV), 5.0) * 0.12;
-  float anisotropyBand = 0.5 + 0.5 * cos(anisotropyRotation * 2.0);
-  vec3 anisotropyLobe = boundedSpecularRadiance * clamp(anisotropy, 0.0, 1.0) * mix(0.025, 0.07, anisotropyBand);
-  vec3 iridescenceColor = a3dTexturedPbrIridescenceColor(iridescenceThicknessMinimum, iridescenceThicknessMaximum, iridescenceIor);
+  vec3 sheenLobe = clamp(sheenColor, vec3(0.0), vec3(1.0))
+    * pow(a3dSaturate(1.0 - nDotV), 8.0)
+    * mix(1.4, 0.75, clamp(sheenRoughness, 0.0, 1.0));
+  vec3 N = normalize(normal);
+  vec3 V = normalize(viewDirection);
+  vec3 environmentDirection = normalize(vec3(0.42, 0.78, 0.46));
+  vec3 environmentHalf = normalize(V + environmentDirection);
+  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;
   return clearcoatLobe + sheenLobe + anisotropyLobe + iridescenceLobe;
 }
@@ -3229,8 +2645,9 @@ void main() {
     roughness,
     specular,
     specularColor
-  ) + a3dTexturedPbrExtensionEnvironmentLight(
+  ) * mix(1.0, 0.18, anisotropy) + a3dTexturedPbrExtensionEnvironmentLight(
     clearcoatNormalDirection,
+    v_tangent,
     viewDirection,
     extensionEnvironmentSpecular,
     clearcoat,
@@ -3275,7 +2692,15 @@ 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);
-      texturedRefractionRadiance = mix(texturedRefractionRadiance, backdropRadiance * texturedTransmissionAmount * mix(1.0, 1.22, texturedBackdropWeight), texturedBackdropWeight);
+      // 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),
+        texturedBackdropWeight
+      );
     }
 #endif
     shaded = mix(shaded, shaded * 0.72 + texturedRefractionRadiance, texturedTransmissionAmount * mix(0.08, 0.58, texturedFallbackEnvironmentTransmissionEnergy));
@@ -3344,9 +2769,11 @@ void main() {
     float directExtensionNdotV = clamp(dot(clearcoatNormalDirection, viewDirection), 0.0, 1.0);
     float directExtensionGrazingGate = mix(0.18, 1.0, smoothstep(0.12, 0.58, directExtensionNdotV));
     float directExtensionSpecularScale = sqrt(clamp(u_materialEnvironmentSpecularScale, 0.0, 1.0)) * directExtensionGrazingGate;
-    shaded += a3dPbrDirectLight(mappedNormal, viewDirection, lightDirection, colorIntensity.rgb, directLightIntensity, base, metallic, roughness, specular, specularColor);
+    shaded += a3dPbrDirectLight(mappedNormal, viewDirection, lightDirection, colorIntensity.rgb, directLightIntensity, base, metallic, roughness, specular, specularColor)
+      * mix(1.0, 0.18, anisotropy);
     shaded += a3dTexturedPbrExtensionDirectLight(
       clearcoatNormalDirection,
+      v_tangent,
       viewDirection,
       lightDirection,
       colorIntensity.rgb,
@@ -3370,80 +2797,7 @@ void main() {
 }
 `
     });
-    library.register({
-        name: DEFAULT_ENVIRONMENT_BACKGROUND_SHADER_NAME,
-        marker: DEFAULT_ENVIRONMENT_BACKGROUND_SHADER_MARKER,
-        vertex: `#version 300 es
-// ${DEFAULT_ENVIRONMENT_BACKGROUND_SHADER_MARKER}
-precision highp float;
-layout(location = 0) in vec3 a_position;
-out vec2 v_backgroundNdc;
-void main() {
-  v_backgroundNdc = a_position.xy;
-  gl_Position = vec4(a_position.xy, 1.0, 1.0);
-}
-`,
-        fragment: `#version 300 es
-// ${DEFAULT_ENVIRONMENT_BACKGROUND_SHADER_MARKER}
-precision highp float;
-uniform sampler2D u_environmentBackgroundTexture;
-uniform samplerCube u_environmentBackgroundCubeTexture;
-uniform float u_environmentBackgroundProjection;
-uniform float u_environmentBackgroundRotation;
-uniform float u_environmentBackgroundIntensity;
-uniform float u_environmentBackgroundEncoding;
-uniform float u_outputColorSpace;
-uniform mat4 u_environmentBackgroundInverseViewProjection;
-in vec2 v_backgroundNdc;
-out vec4 outColor;
-vec2 a3dBackgroundEquirectUv(vec3 direction) {
-  vec3 d = normalize(direction);
-  float u = atan(d.z, d.x) / 6.28318530718 + 0.5;
-  float v = acos(clamp(d.y, -1.0, 1.0)) / 3.14159265359;
-  return vec2(fract(u), clamp(v, 0.0, 1.0));
-}
-vec3 a3dRotateBackgroundDirection(vec3 direction, float rotation) {
-  float angle = rotation * 6.28318530718;
-  float c = cos(angle);
-  float s = sin(angle);
-  vec3 d = normalize(direction);
-  return normalize(vec3(c * d.x - s * d.z, d.y, s * d.x + c * d.z));
-}
-vec3 a3dBackgroundDirectionFromNdc(vec2 ndc) {
-  vec4 nearPoint = u_environmentBackgroundInverseViewProjection * vec4(ndc, -1.0, 1.0);
-  vec4 farPoint = u_environmentBackgroundInverseViewProjection * vec4(ndc, 1.0, 1.0);
-  vec3 nearWorld = nearPoint.xyz / max(nearPoint.w, 0.00001);
-  vec3 farWorld = farPoint.xyz / max(farPoint.w, 0.00001);
-  return normalize(farWorld - nearWorld);
-}
-vec3 a3dBackgroundDecodeRgbe(vec4 encodedSample) {
-  float exponent = encodedSample.a * 255.0;
-  float scale = exponent <= 0.0 ? 0.0 : exp2(exponent - 128.0) * (255.0 / 256.0);
-  return max(encodedSample.rgb * scale, vec3(0.0));
-}
-vec3 a3dBackgroundDecode(vec4 encodedSample) {
-  if (u_environmentBackgroundEncoding > 1.5) return a3dBackgroundDecodeRgbe(encodedSample);
-  return max(encodedSample.rgb, vec3(0.0));
-}
-vec3 a3dBackgroundEncodeOutput(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));
-  return mix(color, srgb, step(0.5, u_outputColorSpace));
-}
-void main() {
-  vec3 direction = a3dRotateBackgroundDirection(a3dBackgroundDirectionFromNdc(v_backgroundNdc), u_environmentBackgroundRotation);
-  vec4 encodedSample = vec4(0.0, 0.0, 0.0, 1.0);
-  if (u_environmentBackgroundProjection > 1.5) {
-    encodedSample = texture(u_environmentBackgroundCubeTexture, direction);
-  } else {
-    encodedSample = texture(u_environmentBackgroundTexture, a3dBackgroundEquirectUv(direction));
-  }
-  vec3 color = a3dBackgroundDecode(encodedSample) * max(u_environmentBackgroundIntensity, 0.0);
-  outColor = vec4(a3dBackgroundEncodeOutput(color), 1.0);
-}
-`
-    });
+    registerLeanEnvironmentBackgroundShader(library);
     library.register({
         name: DEFAULT_SCREEN_SPACE_LINE_SHADER_NAME,
         marker: DEFAULT_SCREEN_SPACE_LINE_SHADER_MARKER,
@@ -3547,27 +2901,7 @@ void main() {
 }
 `
     });
-    library.register({
-        name: DEFAULT_DEPTH_SHADER_NAME,
-        marker: DEFAULT_DEPTH_SHADER_MARKER,
-        vertex: `#version 300 es
-// ${DEFAULT_DEPTH_SHADER_MARKER}
-precision highp float;
-layout(location = 0) in vec3 a_position;
-uniform mat4 u_modelViewProjection;
-void main() {
-  gl_Position = u_modelViewProjection * vec4(a_position, 1.0);
-}
-`,
-        fragment: `#version 300 es
-// ${DEFAULT_DEPTH_SHADER_MARKER}
-precision highp float;
-out vec4 outColor;
-void main() {
-  outColor = vec4(vec3(gl_FragCoord.z), 1.0);
-}
-`
-    });
+    registerLeanDepthShader(library);
     // Register the animation/cel toon program (banded N·L ramp + Fresnel rim).
     // This is a real GLSL program compiled through the same library path as the
     // built-in shaders; AnimationToonMaterial targets it via ANIMATION_TOON_SHADER_NAME.