reze-engine 0.19.0 → 0.21.0

package/dist/engine.js

@@ -1,19 +1,10 @@
 import { Camera } from "./camera";
 import { Mat4, Quat, Vec3 } from "./math";
 import { MORPH_COMPUTE_WGSL } from "./shaders/passes/morph";
+import { decodeTga } from "./tga-loader";
 import { PmxLoader } from "./pmx-loader";
 import { RezePhysics } from "./physics";
 import { createFetchAssetReader, createFileMapAssetReader, deriveBasePathFromPmxPath, fileListToMap, findFirstPmxFileInList, joinAssetPath, normalizeAssetPath, } from "./asset-reader";
-import { DEFAULT_SHADER_WGSL } from "./shaders/materials/default";
-import { FACE_SHADER_WGSL } from "./shaders/materials/face";
-import { HAIR_SHADER_WGSL } from "./shaders/materials/hair";
-import { CLOTH_SMOOTH_SHADER_WGSL } from "./shaders/materials/cloth_smooth";
-import { CLOTH_ROUGH_SHADER_WGSL } from "./shaders/materials/cloth_rough";
-import { METAL_SHADER_WGSL } from "./shaders/materials/metal";
-import { BODY_SHADER_WGSL } from "./shaders/materials/body";
-import { EYE_SHADER_WGSL } from "./shaders/materials/eye";
-import { STOCKINGS_SHADER_WGSL } from "./shaders/materials/stockings";
-import { MMD_CLASSIC_SHADER_WGSL } from "./shaders/materials/mmd_classic";
 import { BRDF_LUT_SIZE, BRDF_LUT_BAKE_WGSL } from "./shaders/dfg_lut";
 import { LTC_MAG_LUT_SIZE, LTC_MAG_LUT_DATA } from "./shaders/ltc_mag_lut";
 import { SHADOW_DEPTH_SHADER_WGSL } from "./shaders/passes/shadow";
@@ -874,46 +865,6 @@ export class Engine {
         const sceneTargets = [standardBlend, maskBlend];
         this.sceneTargets = sceneTargets;
         this.fullVertexBufferLayouts = fullVertexBuffers;
-        const shaderModule = this.device.createShaderModule({
-            label: "default model shader",
-            code: DEFAULT_SHADER_WGSL,
-        });
-        const faceShaderModule = this.device.createShaderModule({
-            label: "face NPR shader",
-            code: FACE_SHADER_WGSL,
-        });
-        const hairShaderModule = this.device.createShaderModule({
-            label: "hair NPR shader",
-            code: HAIR_SHADER_WGSL,
-        });
-        const clothSmoothShaderModule = this.device.createShaderModule({
-            label: "cloth smooth NPR shader",
-            code: CLOTH_SMOOTH_SHADER_WGSL,
-        });
-        const clothRoughShaderModule = this.device.createShaderModule({
-            label: "cloth rough NPR shader",
-            code: CLOTH_ROUGH_SHADER_WGSL,
-        });
-        const metalShaderModule = this.device.createShaderModule({
-            label: "metal NPR shader",
-            code: METAL_SHADER_WGSL,
-        });
-        const bodyShaderModule = this.device.createShaderModule({
-            label: "body NPR shader",
-            code: BODY_SHADER_WGSL,
-        });
-        const eyeShaderModule = this.device.createShaderModule({
-            label: "eye shader",
-            code: EYE_SHADER_WGSL,
-        });
-        const stockingsShaderModule = this.device.createShaderModule({
-            label: "stockings NPR shader",
-            code: STOCKINGS_SHADER_WGSL,
-        });
-        const mmdClassicShaderModule = this.device.createShaderModule({
-            label: "mmd classic shader",
-            code: MMD_CLASSIC_SHADER_WGSL,
-        });
         // group 0: per-frame (camera + light + sampler + shadow) — bound once per pass
         this.mainPerFrameBindGroupLayout = this.device.createBindGroupLayout({
             label: "main per-frame bind group layout",
@@ -941,7 +892,8 @@ export class Engine {
             ],
         });
         // group 2: per-material (textures + material uniforms) — bound per draw call.
-        // Toon + sphere slots feed mmd_classic; other presets bind fallbacks.
+        // Toon + sphere texture slots (bindings 2/3) are reserved for future sphere/toon graph
+        // nodes; graphs that don't read them just bind the 1×1 white fallback.
         this.mainPerMaterialBindGroupLayout = this.device.createBindGroupLayout({
             label: "main per-material bind group layout",
             entries: [
@@ -971,179 +923,18 @@ export class Engine {
         });
         this.mainPipelineLayout = mainPipelineLayout;
         // perFrameBindGroup is created after shadow resources below
-        this.modelPipeline = this.createRenderPipeline({
-            label: "model pipeline",
-            layout: mainPipelineLayout,
-            shaderModule,
-            vertexBuffers: fullVertexBuffers,
-            fragmentTargets: sceneTargets,
-            cullMode: "none",
-            depthStencil: {
-                format: "depth24plus-stencil8",
-                depthWriteEnabled: true,
-                depthCompare: "less-equal",
-            },
-        });
-        this.facePipeline = this.createRenderPipeline({
-            label: "face NPR pipeline",
-            layout: mainPipelineLayout,
-            shaderModule: faceShaderModule,
-            vertexBuffers: fullVertexBuffers,
-            fragmentTargets: sceneTargets,
-            cullMode: "none",
-            depthStencil: {
-                format: "depth24plus-stencil8",
-                depthWriteEnabled: true,
-                depthCompare: "less-equal",
-            },
-        });
-        // Hair opaque: stencil != EYE_VALUE so fragments on top of eyes are skipped entirely —
-        // depth and color stay as the eye wrote them; the follow-up hairOverEyesPipeline then
-        // draws those skipped fragments alpha-blended so the eye reads through the hair.
-        this.hairPipeline = this.createRenderPipeline({
-            label: "hair NPR pipeline",
-            layout: mainPipelineLayout,
-            shaderModule: hairShaderModule,
-            vertexBuffers: fullVertexBuffers,
-            fragmentTargets: sceneTargets,
-            cullMode: "none",
-            depthStencil: {
-                format: "depth24plus-stencil8",
-                depthWriteEnabled: true,
-                depthCompare: "less-equal",
-                stencilFront: { compare: "not-equal", failOp: "keep", depthFailOp: "keep", passOp: "keep" },
-                stencilBack: { compare: "not-equal", failOp: "keep", depthFailOp: "keep", passOp: "keep" },
-                stencilReadMask: 0xff,
-                stencilWriteMask: 0,
-            },
-        });
-        // Eye-over-hair (the see-through-hair effect, inverted): after hair draws
-        // normally, the eye re-draws at 75% alpha with its depth pushed
-        // EYE_SEE_THROUGH_RANGE world units toward the camera, so it only shows
-        // through occluders within that window (bangs), never through the far
-        // side of the head. Stencil == EYE_VALUE confines it to pixels where the
-        // eye's primary draw passed depth — a hand in front of the face never
-        // stamps, so it still occludes fully.
-        // Hair-over-eyes: same shader with IS_OVER_EYES=true so alpha is scaled to 25% at compile time.
-        // Only fragments where eye stencil == EYE_VALUE pass; depth test still culls fragments
-        // that are further from camera than the eye, so hair behind the eye never shows through.
-        // depthWriteEnabled=false keeps the eye's depth authoritative for anything drawn after.
-        this.hairOverEyesPipeline = this.device.createRenderPipeline({
-            label: "hair over eyes pipeline",
-            layout: mainPipelineLayout,
-            vertex: { module: hairShaderModule, buffers: fullVertexBuffers },
-            fragment: {
-                module: hairShaderModule,
-                constants: { IS_OVER_EYES: 1 },
-                targets: sceneTargets,
-            },
-            primitive: { cullMode: "none" },
-            depthStencil: {
-                format: "depth24plus-stencil8",
-                depthWriteEnabled: false,
-                depthCompare: "less-equal",
-                stencilFront: { compare: "equal", failOp: "keep", depthFailOp: "keep", passOp: "keep" },
-                stencilBack: { compare: "equal", failOp: "keep", depthFailOp: "keep", passOp: "keep" },
-                stencilReadMask: 0xff,
-                stencilWriteMask: 0,
-            },
-            multisample: { count: Engine.MULTISAMPLE_COUNT },
-        });
-        this.clothSmoothPipeline = this.createRenderPipeline({
-            label: "cloth smooth NPR pipeline",
+        // Ungrouped materials render this neutral base — the compiled DEFAULT_GRAPH (diffuse
+        // texture x material color -> Principled BSDF). Grouped materials use their group's
+        // compiled pipeline instead. This is the single base shading model; the per-preset
+        // hand shaders are retired in favor of graphs.
+        const neutral = compileGraph(DEFAULT_GRAPH, { renderClass: "auto", alphaMode: "opaque" });
+        if (!neutral.ok)
+            throw new Error("failed to compile the neutral default graph");
+        const neutralModule = this.device.createShaderModule({ label: "neutral base (default graph)", code: neutral.wgsl });
+        this.neutralPipeline = this.createRenderPipeline({
+            label: "neutral base pipeline",
             layout: mainPipelineLayout,
-            shaderModule: clothSmoothShaderModule,
-            vertexBuffers: fullVertexBuffers,
-            fragmentTargets: sceneTargets,
-            cullMode: "none",
-            depthStencil: {
-                format: "depth24plus-stencil8",
-                depthWriteEnabled: true,
-                depthCompare: "less-equal",
-            },
-        });
-        this.mmdClassicPipeline = this.createRenderPipeline({
-            label: "mmd classic pipeline",
-            layout: mainPipelineLayout,
-            shaderModule: mmdClassicShaderModule,
-            vertexBuffers: fullVertexBuffers,
-            fragmentTargets: sceneTargets,
-            cullMode: "none",
-            depthStencil: {
-                format: "depth24plus-stencil8",
-                depthWriteEnabled: true,
-                depthCompare: "less-equal",
-            },
-        });
-        this.clothRoughPipeline = this.createRenderPipeline({
-            label: "cloth rough NPR pipeline",
-            layout: mainPipelineLayout,
-            shaderModule: clothRoughShaderModule,
-            vertexBuffers: fullVertexBuffers,
-            fragmentTargets: sceneTargets,
-            cullMode: "none",
-            depthStencil: {
-                format: "depth24plus-stencil8",
-                depthWriteEnabled: true,
-                depthCompare: "less-equal",
-            },
-        });
-        this.metalPipeline = this.createRenderPipeline({
-            label: "metal NPR pipeline",
-            layout: mainPipelineLayout,
-            shaderModule: metalShaderModule,
-            vertexBuffers: fullVertexBuffers,
-            fragmentTargets: sceneTargets,
-            cullMode: "none",
-            depthStencil: {
-                format: "depth24plus-stencil8",
-                depthWriteEnabled: true,
-                depthCompare: "less-equal",
-            },
-        });
-        this.bodyPipeline = this.createRenderPipeline({
-            label: "body NPR pipeline",
-            layout: mainPipelineLayout,
-            shaderModule: bodyShaderModule,
-            vertexBuffers: fullVertexBuffers,
-            fragmentTargets: sceneTargets,
-            cullMode: "none",
-            depthStencil: {
-                format: "depth24plus-stencil8",
-                depthWriteEnabled: true,
-                depthCompare: "less-equal",
-            },
-        });
-        // Eye: stamps stencil = EYE_VALUE on every fragment it writes. Later hair passes read
-        // this stamp to split into "draw normally (not over eye)" vs "draw alpha-blended".
-        // cullMode="front" + small negative depthBias is the MMD post-alpha-eye trick: only the
-        // back half of the eye sphere renders, it passes depth against the face (via bias) when
-        // viewed from the front, and it gets culled when viewed from behind — so eye fragments
-        // can't leak through the back of the head without needing a per-model skull occluder.
-        this.eyePipeline = this.createRenderPipeline({
-            label: "eye pipeline",
-            layout: mainPipelineLayout,
-            shaderModule: eyeShaderModule,
-            vertexBuffers: fullVertexBuffers,
-            fragmentTargets: sceneTargets,
-            cullMode: "front",
-            depthStencil: {
-                format: "depth24plus-stencil8",
-                depthWriteEnabled: true,
-                depthCompare: "less-equal",
-                depthBias: -0.00005,
-                depthBiasSlopeScale: 0.0,
-                depthBiasClamp: 0.0,
-                stencilFront: { compare: "always", failOp: "keep", depthFailOp: "keep", passOp: "replace" },
-                stencilBack: { compare: "always", failOp: "keep", depthFailOp: "keep", passOp: "replace" },
-                stencilReadMask: 0xff,
-                stencilWriteMask: 0xff,
-            },
-        });
-        this.stockingsPipeline = this.createRenderPipeline({
-            label: "stockings NPR pipeline",
-            layout: mainPipelineLayout,
-            shaderModule: stockingsShaderModule,
+            shaderModule: neutralModule,
             vertexBuffers: fullVertexBuffers,
             fragmentTargets: sceneTargets,
             cullMode: "none",
@@ -2139,7 +1930,6 @@ export class Engine {
             firstIndex: 0,
             bindGroup: this.groundShadowBindGroup,
             materialName: "Ground",
-            preset: "cloth_rough",
             groupId: null,
         };
     }
@@ -2289,17 +2079,6 @@ export class Engine {
         const boneIndex = inst.model.getSkeleton().bones.findIndex((b) => b.name === boneName);
         this.selectedBone = boneIndex >= 0 ? { modelName, boneName, boneIndex } : null;
     }
-    setMaterialPresets(modelName, presets) {
-        const inst = this.modelInstances.get(modelName);
-        if (!inst)
-            return;
-        inst.materialPresets = presets;
-        // Only updates the ungrouped fallback preset; grouped materials render via their
-        // group regardless. binding(4) is unaffected (ungrouped always binds the zero
-        // buffer; grouped bindings are owned by applyStyleGroups).
-        for (const dc of inst.drawCalls)
-            dc.preset = resolvePreset(dc.materialName, presets);
-    }
     // Build a material's bind group with binding(4) pointing at a given StyleUniforms buffer
     // (the group's buffer when grouped, or the shared zero buffer when ungrouped).
     createMaterialBindGroup(label, baseEntries, styleBuffer) {
@@ -2513,7 +2292,6 @@ export class Engine {
             pickPerInstanceBindGroup,
             pickDrawCalls: [],
             hiddenMaterials: new Set(),
-            materialPresets: undefined,
             physics,
             vertexBufferNeedsUpdate: false,
             gpuMorph,
@@ -2752,7 +2530,6 @@ export class Engine {
             }
             const materialUniformBuffer = this.createMaterialUniformBuffer(prefix + mat.name, mat, sphereMode, headBoneIndex);
             inst.gpuBuffers.push(materialUniformBuffer);
-            const preset = resolvePreset(mat.name, inst.materialPresets);
             const textureView = diffuseTexture.createView();
             const baseBindGroupEntries = [
                 { binding: 0, resource: textureView },
@@ -2760,7 +2537,8 @@ export class Engine {
                 { binding: 2, resource: (toonTexture ?? this.fallbackMaterialTexture).createView() },
                 { binding: 3, resource: (sphereTexture ?? this.fallbackMaterialTexture).createView() },
             ];
-            // Ungrouped at load — binding(4) = zero buffer. applyStyleGroups rebinds grouped ones.
+            // Ungrouped at load — binding(4) = zero buffer, neutral base pipeline. autoStyleGroups
+            // / applyStyleGroups rebind grouped materials to their group's buffer + pipeline.
             const bindGroup = this.createMaterialBindGroup(`${prefix}material: ${mat.name}`, baseBindGroupEntries, this.zeroStyleBuffer);
             const type = isTransparent ? "transparent" : "opaque";
             inst.drawCalls.push({
@@ -2769,7 +2547,6 @@ export class Engine {
                 firstIndex: currentIndexOffset,
                 bindGroup,
                 materialName: mat.name,
-                preset,
                 groupId: null,
                 baseBindGroupEntries,
             });
@@ -2798,7 +2575,6 @@ export class Engine {
                     firstIndex: currentIndexOffset,
                     bindGroup: outlineBindGroup,
                     materialName: mat.name,
-                    preset,
                     groupId: null,
                 });
             }
@@ -2861,33 +2637,66 @@ export class Engine {
         if (cached) {
             return cached;
         }
+        let buffer;
         try {
-            const buffer = await inst.assetReader.readBinary(logicalPath);
-            const imageBitmap = await createImageBitmap(new Blob([buffer]), {
-                premultiplyAlpha: "none",
-                colorSpaceConversion: "none",
-            });
-            const mipLevelCount = Math.floor(Math.log2(Math.max(imageBitmap.width, imageBitmap.height))) + 1;
-            const texture = this.device.createTexture({
-                label: `texture: ${cacheKey}`,
-                size: [imageBitmap.width, imageBitmap.height],
-                format: "rgba8unorm-srgb",
-                mipLevelCount,
-                usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST | GPUTextureUsage.RENDER_ATTACHMENT,
-            });
-            this.device.queue.copyExternalImageToTexture({ source: imageBitmap }, { texture }, [
-                imageBitmap.width,
-                imageBitmap.height,
-            ]);
-            if (mipLevelCount > 1)
-                this.generateMipmaps(texture, mipLevelCount);
-            this.textureCache.set(cacheKey, texture);
-            inst.textureCacheKeys.push(cacheKey);
-            return texture;
-        }
-        catch {
+            buffer = await inst.assetReader.readBinary(logicalPath);
+        }
+        catch (e) {
+            console.warn(`[reze] texture read failed: ${logicalPath}`, e instanceof Error ? e.message : e);
             return null;
         }
+        // Decode to either an ImageBitmap (web-native formats) or raw RGBA (TGA). .tga skips
+        // straight to the TGA decoder (createImageBitmap can't read it); other extensions try
+        // the browser decoder first, then fall back to TGA in case a .spa/.sph/etc. is TGA
+        // under its extension. Every failure is logged and soft — never throws to the caller.
+        let source = null;
+        let rgba = null;
+        let width;
+        let height;
+        const isTga = logicalPath.toLowerCase().endsWith(".tga");
+        if (!isTga) {
+            try {
+                source = await createImageBitmap(new Blob([buffer]), { premultiplyAlpha: "none", colorSpaceConversion: "none" });
+            }
+            catch {
+                source = null; // not a browser-native image — try TGA below
+            }
+        }
+        if (source) {
+            width = source.width;
+            height = source.height;
+        }
+        else {
+            try {
+                const img = decodeTga(buffer);
+                rgba = img.rgba;
+                width = img.width;
+                height = img.height;
+            }
+            catch (e) {
+                console.warn(`[reze] texture decode failed (unsupported format?): ${logicalPath}`, e instanceof Error ? e.message : e);
+                return null;
+            }
+        }
+        const mipLevelCount = Math.floor(Math.log2(Math.max(width, height))) + 1;
+        const texture = this.device.createTexture({
+            label: `texture: ${cacheKey}`,
+            size: [width, height],
+            format: "rgba8unorm-srgb",
+            mipLevelCount,
+            usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST | GPUTextureUsage.RENDER_ATTACHMENT,
+        });
+        if (source) {
+            this.device.queue.copyExternalImageToTexture({ source }, { texture }, [width, height]);
+        }
+        else {
+            this.device.queue.writeTexture({ texture }, rgba, { bytesPerRow: width * 4, rowsPerImage: height }, [width, height]);
+        }
+        if (mipLevelCount > 1)
+            this.generateMipmaps(texture, mipLevelCount);
+        this.textureCache.set(cacheKey, texture);
+        inst.textureCacheKeys.push(cacheKey);
+        return texture;
     }
     // Bilinear box-filter downsample per level. Reads srgb view (hardware linearizes on sample,
     // re-encodes on write), so intensities are filtered in linear space — matching EEVEE/Blender.
@@ -3405,15 +3214,14 @@ export class Engine {
         return [...inst.styleGroups.values()].map((g) => g.group);
     }
     /**
-     * Create default style groups from the model's material→preset resolution
-     * (`setMaterialPresets` map first, then name hints), so a freshly loaded model comes up
-     * editably grouped with zero interaction. Materials resolving to `mmd_classic` (no map
-     * entry, no hint) stay ungrouped. The returned promise resolves after grouping AND the
-     * async graph compiles, so `getStyleGroups` is populated the moment it resolves. Opt-in:
-     * call it explicitly (typically after `setMaterialPresets`); a bare load stays ungrouped
-     * / byte-identical to before.
+     * Create default style groups from each material's resolved style category — `overrides`
+     * (material name → category) first, then the built-in JP/CN/EN name hints. So a
+     * standard-named model auto-groups with no overrides; a custom-named one passes a map for
+     * the materials the hints miss. Unmatched materials (no override, no hint) stay ungrouped
+     * (neutral default). The category picks the default graph + render-class + alpha-mode.
+     * Resolves after grouping AND the async compiles, so `getStyleGroups` is then populated.
      */
-    async autoStyleGroups(modelName) {
+    async autoStyleGroups(modelName, overrides) {
         const inst = this.modelInstances.get(modelName);
         if (!inst)
             return { ok: false, groups: [], unknownMaterials: [], conflicts: [] };
@@ -3421,7 +3229,7 @@ export class Engine {
         for (const dc of inst.drawCalls) {
             if (!dc.baseBindGroupEntries)
                 continue; // material draw calls only (skip outlines)
-            const preset = resolvePreset(dc.materialName, inst.materialPresets);
+            const preset = resolvePreset(dc.materialName, overrides);
             if (preset === "mmd_classic")
                 continue; // unmatched → ungrouped
             const arr = buckets.get(preset) ?? [];
@@ -3653,13 +3461,11 @@ export class Engine {
         }
         this.device.queue.writeBuffer(buffer, 0, data);
     }
-    // Draw-order rank within a bucket: eye stamps before hair reads. A grouped call ranks by
-    // its group's render-class; an ungrouped call by its preset (the hand-shader path).
+    // Draw-order rank within a bucket: eye stamps before hair reads. Purely from the group's
+    // render-class — ungrouped materials are neutral (rank 0, no stencil interplay).
     drawCallRank(inst, dc) {
-        const rc = dc.groupId ? (inst.styleGroups.get(dc.groupId)?.renderClass ?? "auto") : undefined;
-        if (rc)
-            return rc === "hair" ? 2 : rc === "eye" ? 1 : 0;
-        return dc.preset === "hair" ? 2 : dc.preset === "eye" ? 1 : 0;
+        const rc = dc.groupId ? (inst.styleGroups.get(dc.groupId)?.renderClass ?? "auto") : "auto";
+        return rc === "hair" ? 2 : rc === "eye" ? 1 : 0;
     }
     sortDrawCalls(inst) {
         const typeOrder = {
@@ -3732,35 +3538,14 @@ export class Engine {
         });
     }
     // Pipeline for a material draw call: its group's compiled pipeline when grouped, else
-    // the built-in preset (hand-shader) pipeline.
+    // the neutral base (ungrouped materials render the default graph).
     pipelineForDrawCall(inst, dc) {
         if (dc.groupId) {
             const install = inst.styleGroups.get(dc.groupId);
             if (install)
                 return install.pipeline;
         }
-        return this.pipelineForPreset(dc.preset);
-    }
-    pipelineForPreset(preset) {
-        if (preset === "face")
-            return this.facePipeline;
-        if (preset === "hair")
-            return this.hairPipeline;
-        if (preset === "cloth_smooth")
-            return this.clothSmoothPipeline;
-        if (preset === "cloth_rough")
-            return this.clothRoughPipeline;
-        if (preset === "metal")
-            return this.metalPipeline;
-        if (preset === "body")
-            return this.bodyPipeline;
-        if (preset === "eye")
-            return this.eyePipeline;
-        if (preset === "stockings")
-            return this.stockingsPipeline;
-        if (preset === "mmd_classic")
-            return this.mmdClassicPipeline;
-        return this.modelPipeline;
+        return this.neutralPipeline;
     }
     /**
      * Draw every material of a given type (`opaque` or `transparent`) using the main
@@ -3830,10 +3615,10 @@ export class Engine {
         this.drawOutlines(pass, inst, "transparent-outline");
     }
     /**
-     * Second hair pass for the see-through-hair effect. Re-draws every hair-class opaque
-     * draw with its over-eyes pipeline — stencil-matched to `EYE_VALUE`, `IS_OVER_EYES=true`
-     * (25% alpha), depth-write off. Covers both grouped hair-class draws (their compiled
-     * over-eyes pipeline) and ungrouped hair-preset draws (the hand `hairOverEyesPipeline`).
+     * Second hair pass for the see-through-hair effect. Re-draws every hair-class grouped
+     * opaque draw with its compiled over-eyes pipeline — stencil-matched to `EYE_VALUE`,
+     * `IS_OVER_EYES=true` (25% alpha), depth-write off. Ungrouped materials are neutral and
+     * never participate.
      */
     drawHairOverEyes(pass, inst) {
         let bound = false;
@@ -3857,13 +3642,13 @@ export class Engine {
             pass.drawIndexed(draw.count, 1, draw.firstIndex, 0, 0);
         }
     }
-    // The over-eyes pipeline for a hair draw call, or null if it isn't hair-class.
+    // The over-eyes pipeline for a hair-class grouped draw call, or null. Ungrouped
+    // materials are neutral — no see-through pass.
     overEyesPipelineFor(inst, dc) {
-        if (dc.groupId) {
-            const install = inst.styleGroups.get(dc.groupId);
-            return install?.renderClass === "hair" ? (install.overEyesPipeline ?? null) : null;
-        }
-        return dc.preset === "hair" ? this.hairOverEyesPipeline : null;
+        if (!dc.groupId)
+            return null;
+        const install = inst.styleGroups.get(dc.groupId);
+        return install?.renderClass === "hair" ? (install.overEyesPipeline ?? null) : null;
     }
     updateCameraUniforms() {
         const viewMatrix = this.camera.getViewMatrix();

package/dist/graph/compile.d.ts

@@ -1,4 +1,4 @@
-import type { Diagnostic, ExposedParam, StyleGraph } from "./schema";
+import type { Diagnostic, ExposedParam, ShaderGraph } from "./schema";
 import type { AlphaMode, RenderClass } from "./render-class";
 export type CompileOptions = {
     /** Fold exposed params to their defaults as consts (no StyleUniforms binding).
@@ -35,6 +35,6 @@ export type CompileResult = {
     prunedNodes: string[];
 };
 export declare function assignStyleSlots(params: ExposedParam[]): StyleSlot[];
-export declare function validateGraph(graph: StyleGraph, opts?: CompileOptions): Diagnostic[];
-export declare function compileGraph(graph: StyleGraph, opts?: CompileOptions): CompileResult;
+export declare function validateGraph(graph: ShaderGraph, opts?: CompileOptions): Diagnostic[];
+export declare function compileGraph(graph: ShaderGraph, opts?: CompileOptions): CompileResult;
 //# sourceMappingURL=compile.d.ts.map

package/dist/graph/compile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/graph/compile.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAA0B,UAAU,EAAE,MAAM,UAAU,CAAA;AAI5F,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE5D,MAAM,MAAM,cAAc,GAAG;IAC3B;8EAC0E;IAC1E,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;6DACyD;IACzD,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9C;0EACsE;IACtE,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,wEAAwE;IACxE,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB,CAAA;AAED,yFAAyF;AACzF,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;IACjC,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,OAAO,CAAA;IACX,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB,CAAA;AAcD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,SAAS,EAAE,CAuBpE;AAID,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE,cAAmB,GAAG,UAAU,EAAE,CAqGxF;AAID,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,GAAE,cAAmB,GAAG,aAAa,CA6JxF"}
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/graph/compile.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAA0B,WAAW,EAAE,MAAM,UAAU,CAAA;AAI7F,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE5D,MAAM,MAAM,cAAc,GAAG;IAC3B;8EAC0E;IAC1E,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;6DACyD;IACzD,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IAC9C;0EACsE;IACtE,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,wEAAwE;IACxE,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB,CAAA;AAED,yFAAyF;AACzF,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAA;IACjC,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,OAAO,CAAA;IACX,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,SAAS,EAAE,CAAA;IACpB,WAAW,EAAE,UAAU,EAAE,CAAA;IACzB,WAAW,EAAE,MAAM,EAAE,CAAA;CACtB,CAAA;AAcD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,SAAS,EAAE,CAuBpE;AAID,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,GAAE,cAAmB,GAAG,UAAU,EAAE,CAqGzF;AAID,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,GAAE,cAAmB,GAAG,aAAa,CA6JzF"}

package/dist/graph/presets/body.d.ts

@@ -1,3 +1,3 @@
-import type { StyleGraph } from "../schema";
-export declare const BODY_GRAPH: StyleGraph;
+import type { ShaderGraph } from "../schema";
+export declare const BODY_GRAPH: ShaderGraph;
 //# sourceMappingURL=body.d.ts.map

package/dist/graph/presets/body.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"body.d.ts","sourceRoot":"","sources":["../../../src/graph/presets/body.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C,eAAO,MAAM,UAAU,EAAE,UA+FxB,CAAA"}
+{"version":3,"file":"body.d.ts","sourceRoot":"","sources":["../../../src/graph/presets/body.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAE5C,eAAO,MAAM,UAAU,EAAE,WA+FxB,CAAA"}

package/dist/graph/presets/body.js

@@ -1,4 +1,4 @@
-// M_Body as a StyleGraph — port of shaders/materials/body.ts (仿深空之眼 "M_Body").
+// M_Body as a ShaderGraph — port of shaders/materials/body.ts (仿深空之眼 "M_Body").
 // Toon + warm rim + rim1/rim2 stack mixed 50/50 against a Principled BSDF with
 // noise-bumped normal. The hand port's local ramp_ease is ramp_cardinal (identical
 // smoothstep form); the Mapping node's zero loc/rot folds to a scale multiply.

package/dist/graph/presets/cloth_rough.d.ts

@@ -1,3 +1,3 @@
-import type { StyleGraph } from "../schema";
-export declare const CLOTH_ROUGH_GRAPH: StyleGraph;
+import type { ShaderGraph } from "../schema";
+export declare const CLOTH_ROUGH_GRAPH: ShaderGraph;
 //# sourceMappingURL=cloth_rough.d.ts.map

package/dist/graph/presets/cloth_rough.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloth_rough.d.ts","sourceRoot":"","sources":["../../../src/graph/presets/cloth_rough.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C,eAAO,MAAM,iBAAiB,EAAE,UAwD/B,CAAA"}
+{"version":3,"file":"cloth_rough.d.ts","sourceRoot":"","sources":["../../../src/graph/presets/cloth_rough.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAE5C,eAAO,MAAM,iBAAiB,EAAE,WAwD/B,CAAA"}

package/dist/graph/presets/cloth_rough.js

@@ -1,4 +1,4 @@
-// M_Rough_Cloth as a StyleGraph — port of shaders/materials/cloth_rough.ts.
+// M_Rough_Cloth as a ShaderGraph — port of shaders/materials/cloth_rough.ts.
 // NPR graph identical to M_Smooth_Cloth, but the noise bump subtree IS live on
 // Principled.Normal (weave bump in rest space) and Roughness is raised to 0.8187.
 // The tex_noise node hits the detail=2 peephole → tex_noise_d2.

package/dist/graph/presets/cloth_smooth.d.ts

@@ -1,3 +1,3 @@
-import type { StyleGraph } from "../schema";
-export declare const CLOTH_SMOOTH_GRAPH: StyleGraph;
+import type { ShaderGraph } from "../schema";
+export declare const CLOTH_SMOOTH_GRAPH: ShaderGraph;
 //# sourceMappingURL=cloth_smooth.d.ts.map

package/dist/graph/presets/cloth_smooth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cloth_smooth.d.ts","sourceRoot":"","sources":["../../../src/graph/presets/cloth_smooth.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C,eAAO,MAAM,kBAAkB,EAAE,UAgDhC,CAAA"}
+{"version":3,"file":"cloth_smooth.d.ts","sourceRoot":"","sources":["../../../src/graph/presets/cloth_smooth.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAE5C,eAAO,MAAM,kBAAkB,EAAE,WAgDhC,CAAA"}

package/dist/graph/presets/cloth_smooth.js

@@ -1,4 +1,4 @@
-// M_Smooth_Cloth as a StyleGraph — port of shaders/materials/cloth_smooth.ts.
+// M_Smooth_Cloth as a ShaderGraph — port of shaders/materials/cloth_smooth.ts.
 // NPR toon + bevel + overlay-boosted emission (18.2×) mixed 10/90 against a plain
 // Principled BSDF. The Blender graph's dead bump subtree is omitted (as in the hand
 // port). hue_sat nodes with hue=0.5 compile to the hue_sat_id specialization.

package/dist/graph/presets/default.d.ts

@@ -1,3 +1,3 @@
-import type { StyleGraph } from "../schema";
-export declare const DEFAULT_GRAPH: StyleGraph;
+import type { ShaderGraph } from "../schema";
+export declare const DEFAULT_GRAPH: ShaderGraph;
 //# sourceMappingURL=default.d.ts.map

package/dist/graph/presets/default.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../../src/graph/presets/default.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C,eAAO,MAAM,aAAa,EAAE,UAc3B,CAAA"}
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../../src/graph/presets/default.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAE5C,eAAO,MAAM,aAAa,EAAE,WAoB3B,CAAA"}