reze-engine 0.10.1 → 0.11.0

package/src/shaders/metal.ts

@@ -0,0 +1,173 @@
+// M_Metal — Metallic Principled (Metallic=1.0, Specular=1.0, Specular Tint=0.114, Roughness=0.3)
+// + NPR toon/AO emission stack (Strength=8.1), MixShader Fac=0.6967.
+// Base color uses a Voronoi pattern sampled in reflection-coord space (Blender 纹理坐标.Reflection)
+// to add subtle metallic sparkle variation. No Normal link in the graph.
+
+import { NODES_WGSL } from "./nodes"
+
+export const METAL_SHADER_WGSL = /* wgsl */ `
+
+${NODES_WGSL}
+
+struct CameraUniforms {
+  view: mat4x4f,
+  projection: mat4x4f,
+  viewPos: vec3f,
+  _padding: f32,
+};
+
+struct Light {
+  direction: vec4f,
+  color: vec4f,
+};
+
+struct LightUniforms {
+  ambientColor: vec4f,
+  lights: array<Light, 4>,
+};
+
+struct MaterialUniforms {
+  diffuseColor: vec3f,
+  alpha: f32,
+};
+
+struct VertexOutput {
+  @builtin(position) position: vec4f,
+  @location(0) normal: vec3f,
+  @location(1) uv: vec2f,
+  @location(2) worldPos: vec3f,
+};
+
+struct LightVP { viewProj: mat4x4f, };
+
+@group(0) @binding(0) var<uniform> camera: CameraUniforms;
+@group(0) @binding(1) var<uniform> light: LightUniforms;
+@group(0) @binding(2) var diffuseSampler: sampler;
+@group(0) @binding(3) var shadowMap: texture_depth_2d;
+@group(0) @binding(4) var shadowSampler: sampler_comparison;
+@group(0) @binding(5) var<uniform> lightVP: LightVP;
+@group(1) @binding(0) var<storage, read> skinMats: array<mat4x4f>;
+@group(2) @binding(0) var diffuseTexture: texture_2d<f32>;
+@group(2) @binding(1) var<uniform> material: MaterialUniforms;
+
+fn sampleShadow(worldPos: vec3f, n: vec3f) -> f32 {
+  let biasedPos = worldPos + n * 0.08;
+  let lclip = lightVP.viewProj * vec4f(biasedPos, 1.0);
+  let ndc = lclip.xyz / max(lclip.w, 1e-6);
+  let suv = vec2f(ndc.x * 0.5 + 0.5, 0.5 - ndc.y * 0.5);
+  let cmpZ = ndc.z - 0.001;
+  let ts = 1.0 / 4096.0;
+  var vis = 0.0;
+  for (var y = -1; y <= 1; y++) {
+    for (var x = -1; x <= 1; x++) {
+      vis += textureSampleCompare(shadowMap, shadowSampler, suv + vec2f(f32(x), f32(y)) * ts, cmpZ);
+    }
+  }
+  return vis / 9.0;
+}
+
+const PI_M: f32 = 3.141592653589793;
+const METAL_SPECULAR: f32 = 1.0;
+const METAL_METALLIC: f32 = 1.0;
+const METAL_ROUGHNESS: f32 = 0.3;
+const METAL_SPECULAR_TINT: f32 = 0.114;
+const METAL_TOON_EDGE: f32 = 0.2966;
+const METAL_MIX04_MUL: f32 = 0.5;
+const METAL_EMIT_STR: f32 = 8.100000381469727;
+const METAL_MIX_SHADER_FAC: f32 = 0.6967;
+const METAL_VORONOI_SCALE: f32 = 4.3;
+
+@vertex fn vs(
+  @location(0) position: vec3f,
+  @location(1) normal: vec3f,
+  @location(2) uv: vec2f,
+  @location(3) joints0: vec4<u32>,
+  @location(4) weights0: vec4<f32>
+) -> VertexOutput {
+  var output: VertexOutput;
+  let pos4 = vec4f(position, 1.0);
+  let weightSum = weights0.x + weights0.y + weights0.z + weights0.w;
+  let invWeightSum = select(1.0, 1.0 / weightSum, weightSum > 0.0001);
+  let nw = select(vec4f(1.0, 0.0, 0.0, 0.0), weights0 * invWeightSum, weightSum > 0.0001);
+  var skinnedPos = vec4f(0.0);
+  var skinnedNrm = vec3f(0.0);
+  for (var i = 0u; i < 4u; i++) {
+    let m = skinMats[joints0[i]];
+    let w = nw[i];
+    skinnedPos += (m * pos4) * w;
+    skinnedNrm += (mat3x3f(m[0].xyz, m[1].xyz, m[2].xyz) * normal) * w;
+  }
+  output.position = camera.projection * camera.view * vec4f(skinnedPos.xyz, 1.0);
+  output.normal = normalize(skinnedNrm);
+  output.uv = uv;
+  output.worldPos = skinnedPos.xyz;
+  return output;
+}
+
+@fragment fn fs(input: VertexOutput) -> @location(0) vec4f {
+  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_s = textureSample(diffuseTexture, diffuseSampler, input.uv);
+  let tex_rgb = tex_s.rgb;
+  let out_alpha = material.alpha * tex_s.a;
+  if (out_alpha < 0.001) { discard; }
+
+  // ═══ NPR toon stack (图像 → HSV.007 Val=0.8 → 转接点.001) ═══
+  let tex_tint = hue_sat(0.5, 1.0, 0.800000011920929, 1.0, tex_rgb);
+  let lum_shade = shader_to_rgb_diffuse(n, l, sun, amb, shadow);
+  let ramp008 = ramp_constant_edge_aa(lum_shade, METAL_TOON_EDGE, vec4f(0,0,0,1), vec4f(1,1,1,1));
+  let mix04_fac = math_multiply(ramp008.r, METAL_MIX04_MUL);
+
+  // 混合.004: A=HSV.002(Val=0.2 dark), B=tex_tint
+  let dark_tex = hue_sat(0.5, 1.0, 0.19999998807907104, 1.0, tex_tint);
+  let mix04 = mix_blend(mix04_fac, dark_tex, tex_tint);
+
+  // AO white/black ramp → 混合.002 factor
+  let ao = ao_fake(n, v);
+  let ao_ramp_c = ramp_linear(ao, 0.0, vec4f(1,1,1,1), 0.8808, vec4f(0,0,0,1));
+  let overlay_fac = mix(1.0, 0.0, ao_ramp_c.r);
+
+  // 混合.002 OVERLAY: A=HSV.008(Val=1.0 identity) ← mix04, B=HSV.004(Val=2.0 bright) ← mix04
+  let hue008 = mix04; // identity HSV
+  let hue004 = hue_sat(0.5, 1.0, 2.0, 1.0, mix04);
+  let npr_rgb = mix_overlay(overlay_fac, hue008, hue004);
+  let npr_emission = npr_rgb * METAL_EMIT_STR;
+
+  // ═══ Metallic Principled base color ═══
+  // Reflection-coord Voronoi for metallic sparkle:
+  //   纹理坐标.Reflection → 矢量运算 → 沃罗诺伊(Scale=4.3) → 颜色渐变 → 混合.005
+  let refl_dir = reflect(-v, n);
+  let voro = tex_voronoi_f1(refl_dir, METAL_VORONOI_SCALE);
+  let voro_ramp = ramp_linear(voro, 0.0, vec4f(0,0,0,1), 1.0, vec4f(1,1,1,1)).r;
+  // 混合.005: Fac=voro_ramp, A=voro_color(grayscale), B=HSV.006(Hue=0.5 Sat=1.5 Val=1.3)
+  let hue006 = hue_sat(0.5, 1.5, 1.2999999523162842, 1.0, tex_tint);
+  let albedo = mix_blend(voro_ramp, vec3f(voro_ramp), hue006);
+
+  // 原理化BSDF (EEVEE port): metallic=1.0, specular=1.0, roughness=0.3.
+  // Per Blender principled wiring: f0 = mix((0.08*spec)*dielectric, albedo, metallic) → with
+  // metallic=1 this is just albedo (specular_tint is dielectric-only and ignored here).
+  let f0 = albedo;
+  let f90 = mix(f0, vec3f(1.0), sqrt(METAL_SPECULAR));
+  let NV = max(dot(n, v), 1e-4);
+  let split_sum = brdf_lut_baked(NV, METAL_ROUGHNESS);
+  let reflection_color = F_brdf_multi_scatter(f0, f90, split_sum);
+
+  let spec_direct = bsdf_ggx(n, l, v, METAL_ROUGHNESS) * sun * shadow * ltc_brdf_scale(NV, METAL_ROUGHNESS);
+  let spec_indirect = amb;
+  let spec_radiance = (spec_direct + spec_indirect) * reflection_color;
+
+  // Pure metal — no diffuse lobe (diffuse_weight = (1 - metallic) = 0).
+  let principled = spec_radiance;
+
+  // 混合着色器.001 Fac=0.6967: Shader=npr_emission, Shader_001=principled
+  let final_color = mix(npr_emission, principled, METAL_MIX_SHADER_FAC);
+
+  return vec4f(final_color, out_alpha);
+}
+
+`

package/src/shaders/nodes.ts

@@ -0,0 +1,424 @@
+// Shared WGSL primitives for Blender-style NPR material nodes.
+// Every function here maps 1:1 to a Blender shader node type used in the preset JSONs.
+// Hand-ported material shaders concatenate this block before their own code.
+
+export const NODES_WGSL = /* wgsl */ `
+
+// Baked 64×64 rg16float DFG LUT — created once at engine init by dfg_lut.ts.
+// Paired with group(0) binding(2) diffuseSampler (linear filter, clamp implicit
+// via the half-texel bias inside brdf_lut_baked). Bound by the main per-frame
+// bind group to every material pipeline that includes this module.
+@group(0) @binding(9) var dfgLut: texture_2d<f32>;
+
+// Baked 64×64 rg16float LTC GGX magnitude LUT — ltc_mag_ggx from Blender eevee_lut.c.
+// Heitz 2016 LTC fit amplitude — same UV addressing as dfgLut.
+// Used for direct-specular energy compensation (ltc_brdf_scale in closure_eval_glossy_lib.glsl).
+@group(0) @binding(10) var ltcMag: texture_2d<f32>;
+
+// ─── RGB ↔ HSV ──────────────────────────────────────────────────────
+
+fn rgb_to_hsv(rgb: vec3f) -> vec3f {
+  let c_max = max(rgb.r, max(rgb.g, rgb.b));
+  let c_min = min(rgb.r, min(rgb.g, rgb.b));
+  let delta = c_max - c_min;
+
+  var h = 0.0;
+  if (delta > 1e-6) {
+    if (c_max == rgb.r) {
+      h = (rgb.g - rgb.b) / delta;
+      if (h < 0.0) { h += 6.0; }
+    } else if (c_max == rgb.g) {
+      h = 2.0 + (rgb.b - rgb.r) / delta;
+    } else {
+      h = 4.0 + (rgb.r - rgb.g) / delta;
+    }
+    h /= 6.0;
+  }
+  let s = select(0.0, delta / c_max, c_max > 1e-6);
+  return vec3f(h, s, c_max);
+}
+
+fn hsv_to_rgb(hsv: vec3f) -> vec3f {
+  let h = hsv.x;
+  let s = hsv.y;
+  let v = hsv.z;
+  if (s < 1e-6) { return vec3f(v); }
+
+  let hh = fract(h) * 6.0;
+  let sector = u32(hh);
+  let f = hh - f32(sector);
+  let p = v * (1.0 - s);
+  let q = v * (1.0 - s * f);
+  let t = v * (1.0 - s * (1.0 - f));
+
+  switch (sector) {
+    case 0u: { return vec3f(v, t, p); }
+    case 1u: { return vec3f(q, v, p); }
+    case 2u: { return vec3f(p, v, t); }
+    case 3u: { return vec3f(p, q, v); }
+    case 4u: { return vec3f(t, p, v); }
+    default: { return vec3f(v, p, q); }
+  }
+}
+
+// ─── HUE_SAT node ───────────────────────────────────────────────────
+
+fn hue_sat(hue: f32, saturation: f32, value: f32, fac: f32, color: vec3f) -> vec3f {
+  var hsv = rgb_to_hsv(color);
+  hsv.x = fract(hsv.x + hue - 0.5);
+  hsv.y = clamp(hsv.y * saturation, 0.0, 1.0);
+  hsv.z *= value;
+  return mix(color, hsv_to_rgb(hsv), fac);
+}
+
+// ─── BRIGHTCONTRAST node ────────────────────────────────────────────
+
+fn bright_contrast(color: vec3f, bright: f32, contrast: f32) -> vec3f {
+  let a = 1.0 + contrast;
+  let b = bright - contrast * 0.5;
+  return max(vec3f(0.0), color * a + vec3f(b));
+}
+
+// ─── INVERT node ────────────────────────────────────────────────────
+
+fn invert(fac: f32, color: vec3f) -> vec3f {
+  return mix(color, vec3f(1.0) - color, fac);
+}
+
+fn invert_f(fac: f32, val: f32) -> f32 {
+  return mix(val, 1.0 - val, fac);
+}
+
+// ─── Color ramp (VALTORGB) — 2-stop variants ───────────────────────
+// All 7 presets use exclusively 2-stop ramps.
+
+fn ramp_constant(f: f32, p0: f32, c0: vec4f, p1: f32, c1: vec4f) -> vec4f {
+  return select(c0, c1, f >= p1);
+}
+
+// CONSTANT ramp with screen-space edge AA — kills sparkle where fwidth(f) straddles a hard step (NPR terminator)
+fn ramp_constant_edge_aa(f: f32, edge: f32, c0: vec4f, c1: vec4f) -> vec4f {
+  let w = max(fwidth(f) * 1.75, 6e-6);
+  let t = smoothstep(edge - w, edge + w, f);
+  return mix(c0, c1, t);
+}
+
+fn ramp_linear(f: f32, p0: f32, c0: vec4f, p1: f32, c1: vec4f) -> vec4f {
+  let t = saturate((f - p0) / max(p1 - p0, 1e-6));
+  return mix(c0, c1, t);
+}
+
+fn ramp_cardinal(f: f32, p0: f32, c0: vec4f, p1: f32, c1: vec4f) -> vec4f {
+  // cardinal spline with 2 stops degrades to smoothstep
+  let t = saturate((f - p0) / max(p1 - p0, 1e-6));
+  let ss = t * t * (3.0 - 2.0 * t);
+  return mix(c0, c1, ss);
+}
+
+// ─── MATH node operations ───────────────────────────────────────────
+
+fn math_add(a: f32, b: f32) -> f32 { return a + b; }
+fn math_multiply(a: f32, b: f32) -> f32 { return a * b; }
+fn math_power(a: f32, b: f32) -> f32 { return pow(max(a, 0.0), b); }
+fn math_greater_than(a: f32, b: f32) -> f32 { return select(0.0, 1.0, a > b); }
+
+// ─── MIX node (blend_type variants) ────────────────────────────────
+
+fn mix_blend(fac: f32, a: vec3f, b: vec3f) -> vec3f {
+  return mix(a, b, fac);
+}
+
+fn mix_overlay(fac: f32, a: vec3f, b: vec3f) -> vec3f {
+  let lo = 2.0 * a * b;
+  let hi = vec3f(1.0) - 2.0 * (vec3f(1.0) - a) * (vec3f(1.0) - b);
+  let overlay = select(hi, lo, a < vec3f(0.5));
+  return mix(a, overlay, fac);
+}
+
+fn mix_multiply(fac: f32, a: vec3f, b: vec3f) -> vec3f {
+  return mix(a, a * b, fac);
+}
+
+fn mix_lighten(fac: f32, a: vec3f, b: vec3f) -> vec3f {
+  return mix(a, max(a, b), fac);
+}
+
+// Blender Mix (Color) blend LINEAR_LIGHT: result = mix(A, A + 2*B - 1, Fac)
+fn mix_linear_light(fac: f32, a: vec3f, b: vec3f) -> vec3f {
+  return mix(a, a + 2.0 * b - vec3f(1.0), fac);
+}
+
+// Luminance for Shader→RGB scalar gates (linear RGB, Rec.709 weights)
+fn luminance_rec709_linear(c: vec3f) -> f32 {
+  return dot(max(c, vec3f(0.0)), vec3f(0.2126, 0.7152, 0.0722));
+}
+
+// ─── FRESNEL node ───────────────────────────────────────────────────
+// Schlick approximation matching Blender's Fresnel node
+
+fn fresnel(ior: f32, n: vec3f, v: vec3f) -> f32 {
+  let f0 = pow((ior - 1.0) / (ior + 1.0), 2.0);
+  let cos_theta = clamp(dot(n, v), 0.0, 1.0);
+  return f0 + (1.0 - f0) * pow(1.0 - cos_theta, 5.0);
+}
+
+// ─── LAYER_WEIGHT node ──────────────────────────────────────────────
+
+fn layer_weight_fresnel(blend: f32, n: vec3f, v: vec3f) -> f32 {
+  let eta = max(1.0 - blend, 1e-4);
+  let f0 = pow((1.0 - eta) / (1.0 + eta), 2.0);
+  let cos_theta = clamp(abs(dot(n, v)), 0.0, 1.0);
+  return f0 + (1.0 - f0) * pow(1.0 - cos_theta, 5.0);
+}
+
+fn layer_weight_facing(blend: f32, n: vec3f, v: vec3f) -> f32 {
+  var facing = abs(dot(n, v));
+  let b = clamp(blend, 0.0, 0.99999);
+  if (b != 0.5) {
+    let exponent = select(2.0 * b, 0.5 / (1.0 - b), b >= 0.5);
+    facing = pow(facing, exponent);
+  }
+  return 1.0 - facing;
+}
+
+// ─── SHADER_TO_RGB (white DiffuseBSDF) ──────────────────────────────
+// Eevee captures lit diffuse: (albedo/π)*sun*N·L*shadow + ambient (linear). Albedo=1.
+// Matches default.ts direct term scale so VALTORGB thresholds from Blender JSON stay valid.
+
+fn shader_to_rgb_diffuse(n: vec3f, l: vec3f, sun_rgb: vec3f, ambient_rgb: vec3f, shadow: f32) -> f32 {
+  const PI_S: f32 = 3.141592653589793;
+  let ndotl = max(dot(n, l), 0.0);
+  let rgb = sun_rgb * (ndotl * shadow / PI_S) + ambient_rgb;
+  return luminance_rec709_linear(rgb);
+}
+
+// ─── AMBIENT_OCCLUSION node (faked) ─────────────────────────────────
+// Real SSAO is a non-goal. We approximate: use the "inside" value from
+// concavity heuristic: 1.0 = fully lit, lower = occluded.
+// For now returns 1.0 (no darkening). Individual presets can override.
+
+fn ao_fake(n: vec3f, v: vec3f) -> f32 {
+  return 1.0;
+}
+
+// ─── BUMP node ──────────────────────────────────────────────────────
+// Screen-space bump from a scalar height field. Needs dFdx/dFdy which
+// WGSL provides as dpdx/dpdy.
+
+fn bump(strength: f32, height: f32, normal: vec3f, world_pos: vec3f) -> vec3f {
+  let dhdx = dpdx(height);
+  let dhdy = dpdy(height);
+  let dpdx_pos = dpdx(world_pos);
+  let dpdy_pos = dpdy(world_pos);
+  let perturbed = normalize(normal) - strength * (dhdx * normalize(cross(dpdy_pos, normal)) + dhdy * normalize(cross(normal, dpdx_pos)));
+  return normalize(perturbed);
+}
+
+// LH engine + WebGPU fragment Y: flip dhdy contribution so height peaks read as outward bumps vs Blender reference
+fn bump_lh(strength: f32, height: f32, normal: vec3f, world_pos: vec3f) -> vec3f {
+  let dhdx = dpdx(height);
+  let dhdy = dpdy(height);
+  let dpdx_pos = dpdx(world_pos);
+  let dpdy_pos = dpdy(world_pos);
+  let perturbed = normalize(normal) - strength * (dhdx * normalize(cross(dpdy_pos, normal)) - dhdy * normalize(cross(normal, dpdx_pos)));
+  return normalize(perturbed);
+}
+
+// ─── NOISE texture (Perlin-style) ───────────────────────────────────
+// Simplified gradient noise matching Blender's default noise output.
+
+fn _hash33(p: vec3f) -> vec3f {
+  var q = vec3f(
+    dot(p, vec3f(127.1, 311.7, 74.7)),
+    dot(p, vec3f(269.5, 183.3, 246.1)),
+    dot(p, vec3f(113.5, 271.9, 124.6))
+  );
+  return fract(sin(q) * 43758.5453123) * 2.0 - 1.0;
+}
+
+fn _noise3(p: vec3f) -> f32 {
+  let i = floor(p);
+  let f = fract(p);
+  let u = f * f * (3.0 - 2.0 * f);
+
+  return mix(
+    mix(
+      mix(dot(_hash33(i + vec3f(0,0,0)), f - vec3f(0,0,0)),
+          dot(_hash33(i + vec3f(1,0,0)), f - vec3f(1,0,0)), u.x),
+      mix(dot(_hash33(i + vec3f(0,1,0)), f - vec3f(0,1,0)),
+          dot(_hash33(i + vec3f(1,1,0)), f - vec3f(1,1,0)), u.x), u.y),
+    mix(
+      mix(dot(_hash33(i + vec3f(0,0,1)), f - vec3f(0,0,1)),
+          dot(_hash33(i + vec3f(1,0,1)), f - vec3f(1,0,1)), u.x),
+      mix(dot(_hash33(i + vec3f(0,1,1)), f - vec3f(0,1,1)),
+          dot(_hash33(i + vec3f(1,1,1)), f - vec3f(1,1,1)), u.x), u.y),
+    u.z);
+}
+
+fn tex_noise(p: vec3f, scale: f32, detail: f32, roughness: f32, distortion: f32) -> f32 {
+  var q = p;
+  if (abs(distortion) > 1e-6) {
+    let w = _noise3(p * scale * 1.37 + vec3f(2.31, 5.17, 8.09));
+    q = p + (w * 2.0 - 1.0) * distortion;
+  }
+  let coords = q * scale;
+  var value = 0.0;
+  var amplitude = 1.0;
+  var frequency = 1.0;
+  var total_amp = 0.0;
+  let octaves = i32(clamp(detail, 0.0, 15.0)) + 1;
+  for (var i = 0; i < octaves; i++) {
+    value += amplitude * _noise3(coords * frequency);
+    total_amp += amplitude;
+    amplitude *= roughness;
+    frequency *= 2.0;
+  }
+  return value / max(total_amp, 1e-6) * 0.5 + 0.5;
+}
+
+// ─── TEX_GRADIENT (linear) ──────────────────────────────────────────
+// Used by Stockings preset. Maps the input vector's X to a 0–1 gradient.
+
+fn tex_gradient_linear(uv: vec3f) -> f32 {
+  return clamp(uv.x, 0.0, 1.0);
+}
+
+// ─── TEX_VORONOI (distance only) ────────────────────────────────────
+// Used by Metal preset. Simplified F1 cell noise.
+
+fn tex_voronoi_f1(p: vec3f, scale: f32) -> f32 {
+  let coords = p * scale;
+  let i = floor(coords);
+  let f = fract(coords);
+  var min_dist = 1e10;
+  for (var z = -1; z <= 1; z++) {
+    for (var y = -1; y <= 1; y++) {
+      for (var x = -1; x <= 1; x++) {
+        let neighbor = vec3f(f32(x), f32(y), f32(z));
+        let point = _hash33(i + neighbor) * 0.5 + 0.5;
+        let diff = neighbor + point - f;
+        min_dist = min(min_dist, dot(diff, diff));
+      }
+    }
+  }
+  return sqrt(min_dist);
+}
+
+// ─── SEPXYZ node ────────────────────────────────────────────────────
+
+fn separate_xyz(v: vec3f) -> vec3f { return v; }
+
+// ─── VECT_MATH (cross product) ──────────────────────────────────────
+
+fn vect_math_cross(a: vec3f, b: vec3f) -> vec3f { return cross(a, b); }
+
+// ─── MAPPING node ───────────────────────────────────────────────────
+// Point-type mapping: scale, rotate (euler XYZ), translate.
+
+fn mapping_point(v: vec3f, loc: vec3f, rot: vec3f, scl: vec3f) -> vec3f {
+  var p = v * scl;
+  // simplified: skip rotation when all angles are zero (common case)
+  if (abs(rot.x) + abs(rot.y) + abs(rot.z) > 1e-6) {
+    let cx = cos(rot.x); let sx = sin(rot.x);
+    let cy = cos(rot.y); let sy = sin(rot.y);
+    let cz = cos(rot.z); let sz = sin(rot.z);
+    let rx = vec3f(p.x, cx*p.y - sx*p.z, sx*p.y + cx*p.z);
+    let ry = vec3f(cy*rx.x + sy*rx.z, rx.y, -sy*rx.x + cy*rx.z);
+    p = vec3f(cz*ry.x - sz*ry.y, sz*ry.x + cz*ry.y, ry.z);
+  }
+  return p + loc;
+}
+
+// ─── NORMAL_MAP node (tangent-space) ────────────────────────────────
+// Applies a tangent-space normal map. Requires TBN from vertex stage.
+
+fn normal_map(strength: f32, map_color: vec3f, normal: vec3f, tangent: vec3f, bitangent: vec3f) -> vec3f {
+  let ts = map_color * 2.0 - 1.0;
+  let perturbed = normalize(tangent * ts.x + bitangent * ts.y + normal * ts.z);
+  return normalize(mix(normal, perturbed, strength));
+}
+
+// ─── EEVEE Principled BSDF primitives ───────────────────────────────
+// Ports from Blender 3.6 source/blender/draw/engines/eevee/shaders/
+//   bsdf_common_lib.glsl + gpu_shader_material_principled.glsl.
+// Usage pattern (see material shaders): direct spec = bsdf_ggx × sun × shadow
+// (NL baked in, no F yet); ambient spec = probe_radiance; tint both with
+// reflection_color = F_brdf_multi_scatter(f0, f90, split_sum) AFTER summing.
+
+const EEVEE_PI: f32 = 3.141592653589793;
+
+// Fused analytic GGX specular (direct lights). Returns BRDF × NL.
+// 4·NL·NV is cancelled via G1_Smith reciprocal form — see bsdf_common_lib.glsl:115.
+fn bsdf_ggx(N: vec3f, L: vec3f, V: vec3f, roughness: f32) -> f32 {
+  let a = max(roughness, 1e-4);
+  let a2 = a * a;
+  let H = normalize(L + V);
+  let NH = max(dot(N, H), 1e-8);
+  let NL = max(dot(N, L), 1e-8);
+  let NV = max(dot(N, V), 1e-8);
+  // G1_Smith_GGX_opti reciprocal form — denominator piece only.
+  let G1L = NL + sqrt(NL * (NL - NL * a2) + a2);
+  let G1V = NV + sqrt(NV * (NV - NV * a2) + a2);
+  let G = G1L * G1V;
+  // D_ggx_opti = pi * denom² — reciprocal D × a².
+  let tmp = (NH * a2 - NH) * NH + 1.0;
+  let D_opti = EEVEE_PI * tmp * tmp;
+  return NL * a2 / (D_opti * G);
+}
+
+// Split-sum DFG LUT — Karis 2013 curve fit stand-in for the 64×64 baked LUT.
+// Returns (lut.x, lut.y) in Blender convention: tint = f0·lut.x + f90·lut.y.
+fn brdf_lut_approx(NV: f32, roughness: f32) -> vec2f {
+  let c0 = vec4f(-1.0, -0.0275, -0.572, 0.022);
+  let c1 = vec4f(1.0, 0.0425, 1.04, -0.04);
+  let r = roughness * c0 + c1;
+  let a004 = min(r.x * r.x, exp2(-9.28 * NV)) * r.x + r.y;
+  return vec2f(-1.04, 1.04) * a004 + r.zw;
+}
+
+// Baked 64×64 EEVEE split-sum LUT — exact port of bsdf_lut_frag.glsl.
+// Addressed as Blender's common_utiltex_lib.glsl:lut_coords:
+//   coords = (roughness, sqrt(1 - NV)), then half-texel bias for filtering.
+// Requires group(0) binding(9) dfgLut + binding(2) diffuseSampler in the host shader.
+fn brdf_lut_baked(NV: f32, roughness: f32) -> vec2f {
+  let LUT_SIZE: f32 = 64.0;
+  var uv = vec2f(saturate(roughness), sqrt(saturate(1.0 - NV)));
+  uv = uv * ((LUT_SIZE - 1.0) / LUT_SIZE) + 0.5 / LUT_SIZE;
+  return textureSampleLevel(dfgLut, diffuseSampler, uv, 0.0).rg;
+}
+
+fn F_brdf_single_scatter(f0: vec3f, f90: vec3f, lut: vec2f) -> vec3f {
+  return lut.y * f90 + lut.x * f0;
+}
+
+// Fdez-Agüera 2019 multi-scatter compensation (EEVEE do_multiscatter=1).
+fn F_brdf_multi_scatter(f0: vec3f, f90: vec3f, lut: vec2f) -> vec3f {
+  let FssEss = lut.y * f90 + lut.x * f0;
+  let Ess = lut.x + lut.y;
+  let Ems = 1.0 - Ess;
+  let Favg = f0 + (1.0 - f0) / 21.0;
+  let Fms = FssEss * Favg / (1.0 - (1.0 - Ess) * Favg);
+  return FssEss + Fms * Ems;
+}
+
+// EEVEE direct-specular energy compensation factor — closure_eval_glossy_lib.glsl:79-81:
+//   ltc_brdf_scale = (ltc.x + ltc.y) / (split_sum.x + split_sum.y)
+// Because Blender evaluates direct lights via LTC (Heitz 2016) but indirect via split-sum,
+// direct radiance is rescaled so total-energy matches what the split-sum LUT expects.
+// Sample both LUTs at identical lut_coords and return the ratio.
+fn ltc_brdf_scale(NV: f32, roughness: f32) -> f32 {
+  let LUT_SIZE: f32 = 64.0;
+  var uv = vec2f(saturate(roughness), sqrt(saturate(1.0 - NV)));
+  uv = uv * ((LUT_SIZE - 1.0) / LUT_SIZE) + 0.5 / LUT_SIZE;
+  let ltc = textureSampleLevel(ltcMag, diffuseSampler, uv, 0.0).rg;
+  let dfg = textureSampleLevel(dfgLut, diffuseSampler, uv, 0.0).rg;
+  return (ltc.x + ltc.y) / max(dfg.x + dfg.y, 1e-6);
+}
+
+// Luminance-normalized hue extraction — Blender tint_from_color (isolates hue+sat).
+fn tint_from_color(color: vec3f) -> vec3f {
+  let lum = dot(color, vec3f(0.3, 0.6, 0.1));
+  return select(vec3f(1.0), color / lum, lum > 0.0);
+}
+
+`;