reze-engine 0.16.2 → 0.16.3

package/src/shaders/materials/common.ts

@@ -73,6 +73,16 @@ struct LightVP { viewProj: mat4x4f, };
 @group(2) @binding(0) var diffuseTexture: texture_2d<f32>;
 @group(2) @binding(1) var<uniform> material: MaterialUniforms;
 
+// Four-bone blended normals can cancel to ~zero on physics-driven parts
+// (opposing bone rotations at 50/50 weights) — normalize(0) is 0/0 = NaN,
+// which poisons the whole shading stack and flashes through bloom. Fall
+// back to up for degenerate normals instead.
+fn safe_normal(nIn: vec3f) -> vec3f {
+  let l2 = dot(nIn, nIn);
+  if (l2 < 1e-12) { return vec3f(0.0, 1.0, 0.0); }
+  return nIn * inverseSqrt(l2);
+}
+
 `;
 
 // ─── Shadow sampler (3×3 PCF) ───────────────────────────────────────

package/src/shaders/materials/default.ts

@@ -1,40 +1,45 @@
-// Default material — Blender 3.6 Principled BSDF defaults, no NPR stack.
-// Metallic=0, Specular=0.5 (F0=0.04), Roughness=0.5. Serves as the EEVEE reference
-// path that every NPR material mixes against in its final stage.
-
-import { NODES_WGSL } from "./nodes"
-import { COMMON_MATERIAL_PRELUDE_WGSL } from "./common"
-
-export const DEFAULT_SHADER_WGSL = /* wgsl */ `
-
-${NODES_WGSL}
-${COMMON_MATERIAL_PRELUDE_WGSL}
-
-const DEFAULT_SPECULAR: f32 = 0.5;
-const DEFAULT_ROUGHNESS: f32 = 0.5;
-
-@fragment fn fs(input: VertexOutput) -> FSOut {
-  let alpha = material.alpha;
-  if (alpha < 0.001) { discard; }
-
-  let n = normalize(input.normal);
-  let v = normalize(camera.viewPos - input.worldPos);
-  let l = -light.lights[0].direction.xyz;
-  let sun = light.lights[0].color.xyz * light.lights[0].color.w;
-  let amb = light.ambientColor.xyz;
-  let shadow = sampleShadow(input.worldPos, n);
-
-  let albedo = textureSample(diffuseTexture, diffuseSampler, input.uv).rgb;
-
-  let color = eval_principled(
-    PrincipledIn(albedo, 0.0, DEFAULT_SPECULAR, DEFAULT_ROUGHNESS, 1e30, 0.0, 0.0),
-    n, l, v, sun, amb, shadow
-  );
-
-  var out: FSOut;
-  out.color = vec4f(color, alpha);
-  out.mask = vec4f(1.0, 1.0, 0.0, out.color.a);
-  return out;
-}
-
-`
+// Default material — Blender 3.6 Principled BSDF defaults, no NPR stack.
+// Metallic=0, Specular=0.5 (F0=0.04), Roughness=0.5. Serves as the EEVEE reference
+// path that every NPR material mixes against in its final stage.
+
+import { NODES_WGSL } from "./nodes"
+import { COMMON_MATERIAL_PRELUDE_WGSL } from "./common"
+
+export const DEFAULT_SHADER_WGSL = /* wgsl */ `
+
+${NODES_WGSL}
+${COMMON_MATERIAL_PRELUDE_WGSL}
+
+const DEFAULT_SPECULAR: f32 = 0.5;
+const DEFAULT_ROUGHNESS: f32 = 0.5;
+
+@fragment fn fs(input: VertexOutput) -> FSOut {
+  let tex_s = textureSample(diffuseTexture, diffuseSampler, input.uv);
+  // MMD alpha semantics: material alpha × texture alpha. Hair/lace/accessory
+  // textures cut their shapes in the alpha channel — ignoring it renders each
+  // card's full quad with the texture's padding color (white shimmer on dark
+  // hair for models whose textures pad with white).
+  let alpha = material.alpha * tex_s.a;
+  if (alpha < 0.001) { discard; }
+
+  let n = safe_normal(input.normal);
+  let v = normalize(camera.viewPos - input.worldPos);
+  let l = -light.lights[0].direction.xyz;
+  let sun = light.lights[0].color.xyz * light.lights[0].color.w;
+  let amb = light.ambientColor.xyz;
+  let shadow = sampleShadow(input.worldPos, n);
+
+  let albedo = tex_s.rgb;
+
+  let color = eval_principled(
+    PrincipledIn(albedo, 0.0, DEFAULT_SPECULAR, DEFAULT_ROUGHNESS, 10.0, 0.0, 0.0),
+    n, l, v, sun, amb, shadow
+  );
+
+  var out: FSOut;
+  out.color = vec4f(color, alpha);
+  out.mask = vec4f(1.0, 1.0, 0.0, out.color.a);
+  return out;
+}
+
+`

package/src/shaders/materials/eye.ts

@@ -1,43 +1,48 @@
-// Eye preset — default Principled BSDF + Emission socket set to albedo × 1.5.
-// Matches the published preset author's instruction: "keep eyes in the default
-// nodegraph, add emission 1.5". Emission feeds bloom pre-tonemap.
-
-import { NODES_WGSL } from "./nodes"
-import { COMMON_MATERIAL_PRELUDE_WGSL } from "./common"
-
-export const EYE_SHADER_WGSL = /* wgsl */ `
-
-${NODES_WGSL}
-${COMMON_MATERIAL_PRELUDE_WGSL}
-
-const EYE_SPECULAR: f32 = 0.5;
-const EYE_ROUGHNESS: f32 = 0.5;
-const EYE_EMISSION_STRENGTH: f32 = 1.5;
-
-@fragment fn fs(input: VertexOutput) -> FSOut {
-  let alpha = material.alpha;
-  if (alpha < 0.001) { discard; }
-
-  let n = normalize(input.normal);
-  let v = normalize(camera.viewPos - input.worldPos);
-  let l = -light.lights[0].direction.xyz;
-  let sun = light.lights[0].color.xyz * light.lights[0].color.w;
-  let amb = light.ambientColor.xyz;
-  let shadow = sampleShadow(input.worldPos, n);
-
-  let albedo = textureSample(diffuseTexture, diffuseSampler, input.uv).rgb;
-
-  let shaded = eval_principled(
-    PrincipledIn(albedo, 0.0, EYE_SPECULAR, EYE_ROUGHNESS, 1e30, 0.0, 0.0),
-    n, l, v, sun, amb, shadow
-  );
-  // Principled Emission socket: emissive = emission_color × strength, added on top.
-  let emission = albedo * EYE_EMISSION_STRENGTH;
-
-  var out: FSOut;
-  out.color = vec4f(shaded + emission, alpha);
-  out.mask = vec4f(1.0, 1.0, 0.0, out.color.a);
-  return out;
-}
-
-`
+// Eye preset — default Principled BSDF + Emission socket set to albedo × 1.5.
+// Matches the published preset author's instruction: "keep eyes in the default
+// nodegraph, add emission 1.5". Emission feeds bloom pre-tonemap.
+
+import { NODES_WGSL } from "./nodes"
+import { COMMON_MATERIAL_PRELUDE_WGSL } from "./common"
+
+export const EYE_SHADER_WGSL = /* wgsl */ `
+
+${NODES_WGSL}
+${COMMON_MATERIAL_PRELUDE_WGSL}
+
+const EYE_SPECULAR: f32 = 0.5;
+const EYE_ROUGHNESS: f32 = 0.5;
+const EYE_EMISSION_STRENGTH: f32 = 1.5;
+
+@fragment fn fs(input: VertexOutput) -> FSOut {
+  let tex_s = textureSample(diffuseTexture, diffuseSampler, input.uv);
+  // MMD alpha semantics: material alpha × texture alpha. Hair/lace/accessory
+  // textures cut their shapes in the alpha channel — ignoring it renders each
+  // card's full quad with the texture's padding color (white shimmer on dark
+  // hair for models whose textures pad with white).
+  let alpha = material.alpha * tex_s.a;
+  if (alpha < 0.001) { discard; }
+
+  let n = safe_normal(input.normal);
+  let v = normalize(camera.viewPos - input.worldPos);
+  let l = -light.lights[0].direction.xyz;
+  let sun = light.lights[0].color.xyz * light.lights[0].color.w;
+  let amb = light.ambientColor.xyz;
+  let shadow = sampleShadow(input.worldPos, n);
+
+  let albedo = tex_s.rgb;
+
+  let shaded = eval_principled(
+    PrincipledIn(albedo, 0.0, EYE_SPECULAR, EYE_ROUGHNESS, 1e30, 0.0, 0.0),
+    n, l, v, sun, amb, shadow
+  );
+  // Principled Emission socket: emissive = emission_color × strength, added on top.
+  let emission = albedo * EYE_EMISSION_STRENGTH;
+
+  var out: FSOut;
+  out.color = vec4f(shaded + emission, alpha);
+  out.mask = vec4f(1.0, 1.0, 0.0, out.color.a);
+  return out;
+}
+
+`

package/src/shaders/materials/face.ts

@@ -1,92 +1,97 @@
-// M_Face — 仿深空之眼渲染预设v1.0_by_小绿毛猫 "M_Face". Toon + warm rim + dual fresnel
-// rim + BT.601 bright-tex gate, mixed 50/50 against a Principled BSDF with noise bump.
-
-import { NODES_WGSL } from "./nodes"
-import { COMMON_MATERIAL_PRELUDE_WGSL } from "./common"
-
-export const FACE_SHADER_WGSL = /* wgsl */ `
-
-${NODES_WGSL}
-${COMMON_MATERIAL_PRELUDE_WGSL}
-
-const FACE_SPECULAR: f32 = 0.5;
-const FACE_ROUGHNESS: f32 = 0.3;
-const FACE_MIX_NPR: f32 = 0.5;
-const FACE_SPEC_CLAMP: f32 = 10.0;
-const FACE_RIM2_POW: f32 = 0.6300000548362732;
-const FACE_RIM2_BG: vec3f = vec3f(1.0, 0.4684903025627136, 0.3698573112487793);
-const FACE_WARM_STR: f32 = 0.30000001192092896;
-const FACE_BRIGHT_TEX_THRESH: f32 = 0.9300000071525574;
-
-@fragment fn fs(input: VertexOutput) -> FSOut {
-  let alpha = material.alpha;
-  if (alpha < 0.001) { discard; }
-
-  let n = normalize(input.normal);
-  let v = normalize(camera.viewPos - input.worldPos);
-  let l = -light.lights[0].direction.xyz;
-  let sun = light.lights[0].color.xyz * light.lights[0].color.w;
-  let amb = light.ambientColor.xyz;
-  let shadow = sampleShadow(input.worldPos, n);
-
-  let tex_color = textureSample(diffuseTexture, diffuseSampler, input.uv).rgb;
-
-  // ═══ NPR STACK ═══
-  let ndotl_raw = shader_to_rgb_diffuse(n, l, sun, amb, shadow);
-  // ramp_constant_edge_aa: avoids binary fac shimmer on terminator (fwidth + smoothstep).
-  let toon = ramp_constant_edge_aa(ndotl_raw, 0.2966, vec4f(0,0,0,1), vec4f(1,1,1,1)).r;
-
-  let shadow_tint = hue_sat(0.46000000834465027, 2.0, 0.3499999940395355, 1.0, tex_color);
-  let lit_tint = hue_sat(0.46000000834465027, 1.600000023841858, 1.5, 1.0, tex_color);
-  let toon_color = mix_blend(toon, shadow_tint, lit_tint);
-  let bc = bright_contrast(toon_color, 0.1, 0.2);
-
-  let emission3 = bc * 2.5;
-
-  let warm_input = clamp(toon * 0.5 + 0.5, 0.0, 1.0);
-  let warm_color = ramp_cardinal(warm_input, 0.2409,
-    vec4f(0.2426, 0.068, 0.0588, 1.0), 0.4663,
-    vec4f(0.6677, 0.5024, 0.5126, 1.0)).rgb;
-  let warm_emission = warm_color * FACE_WARM_STR;
-
-  let rim1_str = fresnel(2.0, n, v) * layer_weight_facing(0.24, n, v);
-  let rim1 = vec3f(0.984157919883728, 0.6110184788703918, 0.5736401677131653) * rim1_str;
-
-  let rim2_raw = fresnel(1.45, n, v) * layer_weight_fresnel(0.61, n, v);
-  let rim2_fac = math_power(rim2_raw, FACE_RIM2_POW);
-  let rim2_mixed = mix(emission3, FACE_RIM2_BG, rim2_fac);
-
-  // Blender implicitly converts Color → Float via BT.601 grayscale when a color output
-  // feeds a Math node's Value input. Using tex_color.r instead fires on R-dominant skin
-  // and produces firefly speckles on near-white R pixels — color_to_value matches the
-  // Blender socket semantic and only gates genuinely near-white painted features.
-  let tex_gate = math_greater_than(color_to_value(tex_color), FACE_BRIGHT_TEX_THRESH);
-  let bright_emit = vec3f(tex_gate) * 3.0;
-
-  let npr_stack = rim1 + rim2_mixed + bright_emit + warm_emission;
-
-  // ═══ PRINCIPLED BSDF with noise bump ═══
-  // Height sampled in rest space (restPos) so the micro-bump doesn't swim under motion;
-  // bump_lh's geometric basis stays in worldPos so the perturbed normal lands in the same
-  // world frame as n (screen-space height gradient still pairs correctly with it).
-  let noise_val = tex_noise_d2(input.restPos * vec3f(1.0, 1.0, 1.5), 1.0);
-  let noise_ramp = ramp_linear(noise_val, 0.0, vec4f(0,0,0,1), 1.0, vec4f(1,1,1,1)).r;
-  let bumped_n = bump_lh(0.324644535779953, noise_ramp, n, input.worldPos);
-
-  let principled_base = mix_blend(noise_ramp, bc, vec3f(0.6832, 0.1947, 0.1373));
-  let p_emission = bc * 0.2;
-
-  let principled = eval_principled(
-    PrincipledIn(principled_base, 0.0, FACE_SPECULAR, FACE_ROUGHNESS, FACE_SPEC_CLAMP, 0.0, 0.0),
-    bumped_n, l, v, sun, amb, shadow
-  ) + p_emission;
-
-  let final_color = mix(npr_stack, principled, FACE_MIX_NPR);
-
-  var out: FSOut;
-  out.color = vec4f(final_color, alpha);
-  out.mask = vec4f(1.0, 1.0, 0.0, out.color.a);
-  return out;
-}
-
-`
+// M_Face — 仿深空之眼渲染预设v1.0_by_小绿毛猫 "M_Face". Toon + warm rim + dual fresnel
+// rim + BT.601 bright-tex gate, mixed 50/50 against a Principled BSDF with noise bump.
+
+import { NODES_WGSL } from "./nodes"
+import { COMMON_MATERIAL_PRELUDE_WGSL } from "./common"
+
+export const FACE_SHADER_WGSL = /* wgsl */ `
+
+${NODES_WGSL}
+${COMMON_MATERIAL_PRELUDE_WGSL}
+
+const FACE_SPECULAR: f32 = 0.5;
+const FACE_ROUGHNESS: f32 = 0.3;
+const FACE_MIX_NPR: f32 = 0.5;
+const FACE_SPEC_CLAMP: f32 = 10.0;
+const FACE_RIM2_POW: f32 = 0.6300000548362732;
+const FACE_RIM2_BG: vec3f = vec3f(1.0, 0.4684903025627136, 0.3698573112487793);
+const FACE_WARM_STR: f32 = 0.30000001192092896;
+const FACE_BRIGHT_TEX_THRESH: f32 = 0.9300000071525574;
+
+@fragment fn fs(input: VertexOutput) -> FSOut {
+  let tex_s = textureSample(diffuseTexture, diffuseSampler, input.uv);
+  // MMD alpha semantics: material alpha × texture alpha. Hair/lace/accessory
+  // textures cut their shapes in the alpha channel — ignoring it renders each
+  // card's full quad with the texture's padding color (white shimmer on dark
+  // hair for models whose textures pad with white).
+  let alpha = material.alpha * tex_s.a;
+  if (alpha < 0.001) { discard; }
+
+  let n = safe_normal(input.normal);
+  let v = normalize(camera.viewPos - input.worldPos);
+  let l = -light.lights[0].direction.xyz;
+  let sun = light.lights[0].color.xyz * light.lights[0].color.w;
+  let amb = light.ambientColor.xyz;
+  let shadow = sampleShadow(input.worldPos, n);
+
+  let tex_color = tex_s.rgb;
+
+  // ═══ NPR STACK ═══
+  let ndotl_raw = shader_to_rgb_diffuse(n, l, sun, amb, shadow);
+  // ramp_constant_edge_aa: avoids binary fac shimmer on terminator (fwidth + smoothstep).
+  let toon = ramp_constant_edge_aa(ndotl_raw, 0.2966, vec4f(0,0,0,1), vec4f(1,1,1,1)).r;
+
+  let shadow_tint = hue_sat(0.46000000834465027, 2.0, 0.3499999940395355, 1.0, tex_color);
+  let lit_tint = hue_sat(0.46000000834465027, 1.600000023841858, 1.5, 1.0, tex_color);
+  let toon_color = mix_blend(toon, shadow_tint, lit_tint);
+  let bc = bright_contrast(toon_color, 0.1, 0.2);
+
+  let emission3 = bc * 2.5;
+
+  let warm_input = clamp(toon * 0.5 + 0.5, 0.0, 1.0);
+  let warm_color = ramp_cardinal(warm_input, 0.2409,
+    vec4f(0.2426, 0.068, 0.0588, 1.0), 0.4663,
+    vec4f(0.6677, 0.5024, 0.5126, 1.0)).rgb;
+  let warm_emission = warm_color * FACE_WARM_STR;
+
+  let rim1_str = fresnel(2.0, n, v) * layer_weight_facing(0.24, n, v);
+  let rim1 = vec3f(0.984157919883728, 0.6110184788703918, 0.5736401677131653) * rim1_str;
+
+  let rim2_raw = fresnel(1.45, n, v) * layer_weight_fresnel(0.61, n, v);
+  let rim2_fac = math_power(rim2_raw, FACE_RIM2_POW);
+  let rim2_mixed = mix(emission3, FACE_RIM2_BG, rim2_fac);
+
+  // Blender implicitly converts Color → Float via BT.601 grayscale when a color output
+  // feeds a Math node's Value input. Using tex_color.r instead fires on R-dominant skin
+  // and produces firefly speckles on near-white R pixels — color_to_value matches the
+  // Blender socket semantic and only gates genuinely near-white painted features.
+  let tex_gate = math_greater_than(color_to_value(tex_color), FACE_BRIGHT_TEX_THRESH);
+  let bright_emit = vec3f(tex_gate) * 3.0;
+
+  let npr_stack = rim1 + rim2_mixed + bright_emit + warm_emission;
+
+  // ═══ PRINCIPLED BSDF with noise bump ═══
+  // Height sampled in rest space (restPos) so the micro-bump doesn't swim under motion;
+  // bump_lh's geometric basis stays in worldPos so the perturbed normal lands in the same
+  // world frame as n (screen-space height gradient still pairs correctly with it).
+  let noise_val = tex_noise_d2(input.restPos * vec3f(1.0, 1.0, 1.5), 1.0);
+  let noise_ramp = ramp_linear(noise_val, 0.0, vec4f(0,0,0,1), 1.0, vec4f(1,1,1,1)).r;
+  let bumped_n = bump_lh(0.324644535779953, noise_ramp, n, input.worldPos);
+
+  let principled_base = mix_blend(noise_ramp, bc, vec3f(0.6832, 0.1947, 0.1373));
+  let p_emission = bc * 0.2;
+
+  let principled = eval_principled(
+    PrincipledIn(principled_base, 0.0, FACE_SPECULAR, FACE_ROUGHNESS, FACE_SPEC_CLAMP, 0.0, 0.0),
+    bumped_n, l, v, sun, amb, shadow
+  ) + p_emission;
+
+  let final_color = mix(npr_stack, principled, FACE_MIX_NPR);
+
+  var out: FSOut;
+  out.color = vec4f(final_color, alpha);
+  out.mask = vec4f(1.0, 1.0, 0.0, out.color.a);
+  return out;
+}
+
+`

package/src/shaders/materials/hair.ts

@@ -1,82 +1,92 @@
-// M_Hair — 仿深空之眼渲染预设v1.0_by_小绿毛猫 "M_Hair". Toon + fresnel rim + bevel +
-// bright-tex gate, mixed 80/20 NPR/PBR. MixShader.001 Fac=0.2 keeps Principled subtle.
-
-import { NODES_WGSL } from "./nodes"
-import { COMMON_MATERIAL_PRELUDE_WGSL } from "./common"
-
-export const HAIR_SHADER_WGSL = /* wgsl */ `
-
-${NODES_WGSL}
-${COMMON_MATERIAL_PRELUDE_WGSL}
-
-// Pipeline-override: the engine compiles two variants — the normal opaque hair pipeline
-// (IS_OVER_EYES=false) and a second pipeline that re-draws hair fragments stencil-matched
-// against the eye stamp with 25% alpha so eyes read through the hair silhouette. Resolved
-// at pipeline-compile time; the dead branch is dropped by the shader compiler.
-override IS_OVER_EYES: bool = false;
-
-const HAIR_SPECULAR: f32 = 1.0;
-const HAIR_ROUGHNESS: f32 = 0.3;
-const HAIR_TEX_GATE_THRESH: f32 = 0.15000000596046448;
-const HAIR_RIM2_POW: f32 = 0.6300000548362732;
-const HAIR_MIX_BG: vec3f = vec3f(0.1673291176557541);
-const HAIR_MIX_NPR: f32 = 0.2;
-
-@fragment fn fs(input: VertexOutput) -> FSOut {
-  let alpha = material.alpha;
-  if (alpha < 0.001) { discard; }
-
-  let n = normalize(input.normal);
-  let v = normalize(camera.viewPos - input.worldPos);
-  let l = -light.lights[0].direction.xyz;
-  let sun = light.lights[0].color.xyz * light.lights[0].color.w;
-  let amb = light.ambientColor.xyz;
-  let shadow = sampleShadow(input.worldPos, n);
-
-  let tex_color = textureSample(diffuseTexture, diffuseSampler, input.uv).rgb;
-
-  // ═══ NPR STACK ═══
-  let hue_sat_shadow = hue_sat_id(1.2, 0.5, 1.0, tex_color);
-  let hue_sat_002 = hue_sat(0.48, 1.2, 0.7, 1.0, hue_sat_shadow);
-  let hue_sat_001 = hue_sat_id(1.5, 1.0, 1.0, tex_color);
-
-  let ndotl_raw = shader_to_rgb_diffuse(n, l, sun, amb, shadow);
-  let ramp_008 = ramp_constant(ndotl_raw, 0.0, vec4f(0,0,0,1), 0.2966, vec4f(1,1,1,1)).r;
-
-  let mix_004 = mix_blend(ramp_008, hue_sat_002, hue_sat_001);
-  let bc = bright_contrast(mix_004, 0.1, 0.2);
-
-  let bevel_z = clamp(n.y, 0.0, 1.0);
-  let mix_003 = mix_blend(bevel_z, bc, hue_sat_002);
-
-  let rim2_raw = fresnel(1.45, n, v) * layer_weight_fresnel(0.61, n, v);
-  let rim2_fac = math_power(rim2_raw, HAIR_RIM2_POW);
-  let mix_shader_002 = mix(mix_003, HAIR_MIX_BG, rim2_fac);
-
-  // GREATER_THAN on a color input uses BT.601 luminance — same socket-semantic fix as face.ts.
-  let tex_gate = math_greater_than(color_to_value(tex_color), HAIR_TEX_GATE_THRESH);
-  let gate_emit = vec3f(tex_gate) * 0.1;
-
-  let npr_stack = mix_shader_002 + gate_emit;
-
-  // ═══ PRINCIPLED BSDF ═══
-  // Graph has a noise→normal_map bump (Strength=0.1) on Principled.Normal, but MixShader.001
-  // weights Principled at only 0.2 — the bumped spec × that weight is imperceptible, so we
-  // drop the subtree and keep plain n (saves a tex_noise + bump_lh per hair fragment).
-  let principled = eval_principled(
-    PrincipledIn(bc, 0.0, HAIR_SPECULAR, HAIR_ROUGHNESS, 1e30, 0.0, 0.0),
-    n, l, v, sun, amb, shadow
-  );
-
-  let final_color = mix(npr_stack, principled, HAIR_MIX_NPR);
-
-  var outAlpha = alpha;
-  if (IS_OVER_EYES) { outAlpha = alpha * 0.25; }
-
-  var out: FSOut;
-  out.color = vec4f(final_color, outAlpha);
-  out.mask = vec4f(1.0, 1.0, 0.0, out.color.a);
-  return out;
-}
-
-`
+// M_Hair — 仿深空之眼渲染预设v1.0_by_小绿毛猫 "M_Hair". Toon + fresnel rim + bevel +
+// bright-tex gate, mixed 80/20 NPR/PBR. MixShader.001 Fac=0.2 keeps Principled subtle.
+
+import { NODES_WGSL } from "./nodes"
+import { COMMON_MATERIAL_PRELUDE_WGSL } from "./common"
+
+export const HAIR_SHADER_WGSL = /* wgsl */ `
+
+${NODES_WGSL}
+${COMMON_MATERIAL_PRELUDE_WGSL}
+
+// Pipeline-override: the engine compiles two variants — the normal opaque hair pipeline
+// (IS_OVER_EYES=false) and a second pipeline that re-draws hair fragments stencil-matched
+// against the eye stamp with 25% alpha so eyes read through the hair silhouette. Resolved
+// at pipeline-compile time; the dead branch is dropped by the shader compiler.
+override IS_OVER_EYES: bool = false;
+
+const HAIR_SPECULAR: f32 = 1.0;
+const HAIR_ROUGHNESS: f32 = 0.3;
+// EEVEE Light Clamp equivalent (same value as body/face/cloth_rough). Hair
+// is the firefly-prone material: physics-animated with the noisiest blended
+// normals, so grazing NV spikes the GGX term and flashes white through
+// bloom without this.
+const HAIR_SPEC_CLAMP: f32 = 10.0;
+const HAIR_TEX_GATE_THRESH: f32 = 0.15000000596046448;
+const HAIR_RIM2_POW: f32 = 0.6300000548362732;
+const HAIR_MIX_BG: vec3f = vec3f(0.1673291176557541);
+const HAIR_MIX_NPR: f32 = 0.2;
+
+@fragment fn fs(input: VertexOutput) -> FSOut {
+  let tex_s = textureSample(diffuseTexture, diffuseSampler, input.uv);
+  // MMD alpha semantics: material alpha × texture alpha. Hair/lace/accessory
+  // textures cut their shapes in the alpha channel — ignoring it renders each
+  // card's full quad with the texture's padding color (white shimmer on dark
+  // hair for models whose textures pad with white).
+  let alpha = material.alpha * tex_s.a;
+  if (alpha < 0.001) { discard; }
+
+  let n = safe_normal(input.normal);
+  let v = normalize(camera.viewPos - input.worldPos);
+  let l = -light.lights[0].direction.xyz;
+  let sun = light.lights[0].color.xyz * light.lights[0].color.w;
+  let amb = light.ambientColor.xyz;
+  let shadow = sampleShadow(input.worldPos, n);
+
+  let tex_color = tex_s.rgb;
+
+  // ═══ NPR STACK ═══
+  let hue_sat_shadow = hue_sat_id(1.2, 0.5, 1.0, tex_color);
+  let hue_sat_002 = hue_sat(0.48, 1.2, 0.7, 1.0, hue_sat_shadow);
+  let hue_sat_001 = hue_sat_id(1.5, 1.0, 1.0, tex_color);
+
+  let ndotl_raw = shader_to_rgb_diffuse(n, l, sun, amb, shadow);
+  let ramp_008 = ramp_constant(ndotl_raw, 0.0, vec4f(0,0,0,1), 0.2966, vec4f(1,1,1,1)).r;
+
+  let mix_004 = mix_blend(ramp_008, hue_sat_002, hue_sat_001);
+  let bc = bright_contrast(mix_004, 0.1, 0.2);
+
+  let bevel_z = clamp(n.y, 0.0, 1.0);
+  let mix_003 = mix_blend(bevel_z, bc, hue_sat_002);
+
+  let rim2_raw = fresnel(1.45, n, v) * layer_weight_fresnel(0.61, n, v);
+  let rim2_fac = math_power(rim2_raw, HAIR_RIM2_POW);
+  let mix_shader_002 = mix(mix_003, HAIR_MIX_BG, rim2_fac);
+
+  // GREATER_THAN on a color input uses BT.601 luminance — same socket-semantic fix as face.ts.
+  let tex_gate = math_greater_than(color_to_value(tex_color), HAIR_TEX_GATE_THRESH);
+  let gate_emit = vec3f(tex_gate) * 0.1;
+
+  let npr_stack = mix_shader_002 + gate_emit;
+
+  // ═══ PRINCIPLED BSDF ═══
+  // Graph has a noise→normal_map bump (Strength=0.1) on Principled.Normal, but MixShader.001
+  // weights Principled at only 0.2 — the bumped spec × that weight is imperceptible, so we
+  // drop the subtree and keep plain n (saves a tex_noise + bump_lh per hair fragment).
+  let principled = eval_principled(
+    PrincipledIn(bc, 0.0, HAIR_SPECULAR, HAIR_ROUGHNESS, HAIR_SPEC_CLAMP, 0.0, 0.0),
+    n, l, v, sun, amb, shadow
+  );
+
+  let final_color = mix(npr_stack, principled, HAIR_MIX_NPR);
+
+  var outAlpha = alpha;
+  if (IS_OVER_EYES) { outAlpha = alpha * 0.25; }
+
+  var out: FSOut;
+  out.color = vec4f(final_color, outAlpha);
+  out.mask = vec4f(1.0, 1.0, 0.0, out.color.a);
+  return out;
+}
+
+`

package/src/shaders/materials/metal.ts

@@ -26,7 +26,7 @@ const METAL_MIX_SHADER_FAC: f32 = 0.6967;
 const METAL_VORONOI_SCALE: f32 = 4.3;
 
 @fragment fn fs(input: VertexOutput) -> FSOut {
-  let n = normalize(input.normal);
+  let n = safe_normal(input.normal);
   let v = normalize(camera.viewPos - input.worldPos);
   let l = -light.lights[0].direction.xyz;
   let sun = light.lights[0].color.xyz * light.lights[0].color.w;

package/src/shaders/materials/stockings.ts

@@ -66,7 +66,7 @@ fn ramp_ease_s(f: f32, p0: f32, p1: f32) -> f32 {
 }
 
 @fragment fn fs(input: VertexOutput) -> FSOut {
-  let n = normalize(input.normal);
+  let n = safe_normal(input.normal);
   let v = normalize(camera.viewPos - input.worldPos);
   let l = -light.lights[0].direction.xyz;
   let sun = light.lights[0].color.xyz * light.lights[0].color.w;