reze-engine 0.20.0 → 0.21.0

package/README.md

@@ -13,8 +13,7 @@ npm install reze-engine
 ## Features
 
 - Anime/MMD **hybrid renderer** — toon-ramp NPR over a Principled GGX BSDF, mixed per material
-- **9 per-material presets** assigned by material name (`face` / `hair` / `body` / `eye` / `stockings` / `metal` / `cloth_smooth` / `cloth_rough` / `default`)
-- **Node-graph materials** — Blender-style style graphs (JSON) validated + compiled to WGSL at runtime; instant slider tier, async pipeline swap with fallback-on-error
+- **Shader-graph materials + style groups** — every look is a Blender-style **shader graph** (JSON) compiled to WGSL at runtime; **style groups** bind any set of materials to any graph (unlimited, user-defined). 9 NPR graphs ship built-in (`face` / `hair` / `body` / `eye` / `stockings` / `metal` / `cloth_smooth` / `cloth_rough` / `default`); fully customizable — see [reze-design](https://reze.design) for the visual shader-graph editor
 - **HDR pipeline** — bloom, Filmic tone mapping, 4× MSAA, Apple-TBDR-friendly targets
 - **In-house TS physics** — sequential-impulse rigid bodies for PMX rigs, no external dependency
 - **VMD animation** with MMD IK, morphs (GPU compute path), and VMD export
@@ -26,7 +25,7 @@ See [Physics](#physics) and [Rendering](#rendering) for the internals.
 
 ## Used by
 
-- [Reze Design](https://reze.design) (web-native scene composer & node-graph styling)
+- [Reze Design](https://reze.design) (web-native scene composer & shader-graph styling)
 - [Reze Studio](https://reze.studio) (MMD animation editor)
 - [MiKaPo](https://mikapo.vercel.app) (motion capture)
 - [Popo](https://popo.love) (LLM-generated poses)
@@ -48,8 +47,17 @@ engine/src/
   pmx-loader.ts      PMX parser: mesh, bones, morphs, rigid bodies, joints
   vmd-loader.ts      VMD motion parser  ·  vmd-writer.ts  VMD export (Shift-JIS)
   asset-reader.ts    URL + local-folder asset resolution  ·  folder-upload.ts
+  tga-loader.ts      TGA decoder (formats createImageBitmap can't read)
   index.ts           public exports
 
+  graph/             shader-graph → WGSL compiler — materials as data
+    schema.ts          ShaderGraph / StyleGroup / param types + validation
+    registry.ts        node registry (Blender node → WGSL) + socket conversions
+    compile.ts         validate → prune → toposort → peephole → emit
+    render-class.ts    RenderClass / AlphaMode + the RENDER_CLASSES manifest
+    slots.ts           per-render-class fs() shell (stencil/alpha) around the graph body
+    presets/           the 9 built-in shader graphs (hair, face, eye, cloth, …)
+
   physics/           in-house rigid-body solver (~2.5k lines)
     physics.ts         RezePhysics: bone↔body sync, fixed-step accumulator + interpolation
     solver.ts          sequential-impulse PGS (joint + contact rows)
@@ -58,8 +66,9 @@ engine/src/
     body.ts            SoA rigid-body store  ·  types.ts
 
   shaders/
-    materials/       nodes.ts (Blender-node WGSL library) + common.ts (bindings, skinning VS)
-                     + one file per preset (face, hair, body, eye, stockings, …)
+    materials/       nodes.ts (Blender-node WGSL library the graph compiler emits into) +
+                     common.ts (bindings, skinning VS); the per-material .ts files are the
+                     original hand shaders, kept as the graph-port reference
     passes/          shadow, morph (GPU vertex-morph compute), bloom, composite (Filmic),
                      outline, selection, gizmo, pick, ground, mipmap
 ```
@@ -79,11 +88,11 @@ await engine.init()
 
 const model = await engine.loadModel("reze", "/models/reze/reze.pmx")
 
-// One-tap styling: bucket materials into the engine's built-in default style graphs
+// One-tap styling: bucket materials into the engine's built-in default shader graphs
 // (face / hair / eye / cloth / stockings / metal). These categories are just the shipped
 // starter graphs — NOT fixed slots. `overrides` maps names the built-in JP/CN/EN hints
 // miss; standard-named models need no map. Unmatched materials stay ungrouped (neutral).
-// For arbitrary groups with any graph, use applyStyleGroups (see "Style graphs & groups").
+// For arbitrary groups with any graph, use applyStyleGroups (see "Shader graphs & style groups").
 await engine.autoStyleGroups("reze", {
   face: ["face01"],
   body: ["skin"],
@@ -207,9 +216,9 @@ onGizmoDrag: (e) => {
 
 Note the asymmetry: rotation goes through `rotateBones(…, 0)`, but translation uses `setBoneLocalTranslation(idx, v)` — `moveBones` converts VMD-relative→local, and the gizmo output is already local.
 
-## Style graphs & groups (node-graph materials)
+## Shader graphs & style groups
 
-Materials are styled by **node graphs** — plain JSON (`StyleGraph`) validated and compiled to WGSL at runtime. Node semantics are frozen **Blender 3.6 legacy-EEVEE**, so community Blender NPR presets port by transcription. Nine graphs ship built-in (`FACE_GRAPH`, `HAIR_GRAPH`, `BODY_GRAPH`, `EYE_GRAPH`, `METAL_GRAPH`, `STOCKINGS_GRAPH`, `CLOTH_SMOOTH_GRAPH`, `CLOTH_ROUGH_GRAPH`, `DEFAULT_GRAPH` — the neutral base) as a starter library; you can also author or import your own.
+Materials are styled by **shader graphs** — plain JSON (`ShaderGraph`) validated and compiled to WGSL at runtime. Node semantics are frozen **Blender 3.6 legacy-EEVEE**, so community Blender NPR presets port by transcription. Nine graphs ship built-in (`FACE_GRAPH`, `HAIR_GRAPH`, `BODY_GRAPH`, `EYE_GRAPH`, `METAL_GRAPH`, `STOCKINGS_GRAPH`, `CLOTH_SMOOTH_GRAPH`, `CLOTH_ROUGH_GRAPH`, `DEFAULT_GRAPH` — the neutral base) as a starter library; you can also author or import your own.
 
 A **style group** binds `{ materials, graph, renderClass?, alphaMode? }` — a set of materials, the graph that shades them, and the engine's small pass-integration vocabulary (`renderClass`: `auto`/`eye`/`hair` for stencil/cull/draw-order; `alphaMode`: `opaque`/`hashed`). **Groups are user-defined and unlimited** — any materials, any graph. A graph is pure shading; `renderClass` carries the built-in effects (hair's over-eyes stencil, the eye see-through stamp), so any graph in an `eye`/`hair` group inherits them. **Every group needs a valid graph**; a material in no group renders the **neutral default** (`DEFAULT_GRAPH`).
 
@@ -255,20 +264,20 @@ Engine surface is just `setPhysicsEnabled` / `resetPhysics` — all tuning (mass
 
 ## Rendering
 
-Each surface mixes an NPR stack with a Principled-style BSDF per material, so characters keep a flat illustrated look while highlights and reflections stay grounded. Shaders live in `engine/src/shaders/materials/`; each fragment shader follows one 7-stage layout (shared stages from `nodes.ts` / `common.ts`):
+Each built-in shader graph mixes an NPR stack with a Principled-style BSDF, so characters keep a flat illustrated look while highlights and reflections stay grounded. A graph compiles to a fragment shader following one 7-stage layout (node primitives from `nodes.ts`, the fs() shell from `common.ts`):
 
 ```
 (A) setup → (B) texture + alpha → (C) NPR stack → (D) optional bump
 → (E) Principled BSDF → (F) NPR↔PBR mix → (G) FSOut
 ```
 
-`default` uses only A/B/E/G; NPR presets add C (and sometimes D), with F choosing how NPR-leaning the result is.
+`default` uses only A/B/E/G; the NPR graphs add C (and sometimes D), with F choosing how NPR-leaning the result is.
 
 - **PBR core** (`eval_principled`) — GGX + Schlick Fresnel, Walter–Smith G1, Fdez-Agüera 2019 multi-scatter, Karis split-sum DFG LUT, Heitz 2016 LTC direct-spec, optional sheen.
 - **NPR toolbox** — toon ramps (constant / fwidth-AA'd), HSV warm-shadow / cool-light remaps, fresnel + layer-weight rims, value-noise bump, Voronoi metallic sparkle, BT.601-gated emission.
 
 
-| Preset         | Notes                                                                   |
+| Built-in graph | Notes                                                                   |
 | -------------- | ----------------------------------------------------------------------- |
 | `default`      | Plain Principled, metallic 0, rough 0.5                                 |
 | `eye`          | Plain + post-eval emission ×1.5                                         |

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":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C,eAAO,MAAM,aAAa,EAAE,UAoB3B,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"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"eye.d.ts","sourceRoot":"","sources":["../../../src/graph/presets/eye.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C,eAAO,MAAM,SAAS,EAAE,UAqBvB,CAAA"}
+{"version":3,"file":"eye.d.ts","sourceRoot":"","sources":["../../../src/graph/presets/eye.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAE5C,eAAO,MAAM,SAAS,EAAE,WAqBvB,CAAA"}

package/dist/graph/presets/eye.js

@@ -1,4 +1,4 @@
-// Eye as a StyleGraph — port of shaders/materials/eye.ts. The published preset
+// Eye as a ShaderGraph — port of shaders/materials/eye.ts. The published preset
 // author's instruction: "keep eyes in the default nodegraph, add emission 1.5".
 // So it's the default Principled BSDF plus an Emission of the diffuse texture at
 // 1.5× (Blender's Principled Emission socket, decomposed as a separate Emission +

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

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

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

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

package/dist/graph/presets/face.js

@@ -1,4 +1,4 @@
-// M_Face as a StyleGraph — port of shaders/materials/face.ts (仿深空之眼 "M_Face").
+// M_Face as a ShaderGraph — port of shaders/materials/face.ts (仿深空之眼 "M_Face").
 // Toon + warm rim + dual fresnel rim + BT.601 bright-tex gate, mixed 50/50 against a
 // Principled BSDF with noise bump. Structurally close to body, but: the toon uses the
 // edge-AA ramp, hue tints are 0.46 (full hue_sat, not the 0.5 _id specialization),

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

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

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

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

package/dist/graph/presets/hair.js

@@ -1,4 +1,4 @@
-// M_Hair — 仿深空之眼渲染预设v1.0_by_小绿毛猫, as a StyleGraph. Node ids mirror the
+// M_Hair — 仿深空之眼渲染预设v1.0_by_小绿毛猫, as a ShaderGraph. Node ids mirror the
 // Blender node names referenced in shaders/materials/hair.ts comments; compiled with
 // { inlineParams: true } this graph must reproduce HAIR_SHADER_WGSL's fragment body
 // (golden test #1 — see tests/graph.test.mjs).

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

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

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

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

package/dist/graph/presets/metal.js

@@ -1,4 +1,4 @@
-// M_Metal as a StyleGraph — port of shaders/materials/metal.ts.
+// M_Metal as a ShaderGraph — port of shaders/materials/metal.ts.
 // Metallic Principled (Metallic=1, Specular=1, Roughness=0.3) with a
 // reflection-coord voronoi driving base color (metallic sparkle), plus an NPR
 // toon/overlay emission stack mixed at Fac=0.6967. The voronoi Color→ramp Fac

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"stockings.d.ts","sourceRoot":"","sources":["../../../src/graph/presets/stockings.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C,eAAO,MAAM,eAAe,EAAE,UA8C7B,CAAA"}
+{"version":3,"file":"stockings.d.ts","sourceRoot":"","sources":["../../../src/graph/presets/stockings.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAE5C,eAAO,MAAM,eAAe,EAAE,WA8C7B,CAAA"}

package/dist/graph/presets/stockings.js

@@ -1,4 +1,4 @@
-// M_Stockings as a StyleGraph — port of shaders/materials/stockings.ts.
+// M_Stockings as a ShaderGraph — port of shaders/materials/stockings.ts.
 // A bbox-gradient × facing-rim mask drives a Mix Shader between an HSV-boosted
 // emission (val 5×) and a sheen Principled. The hashed-alpha discard and the
 // alpha=1 output are slot-owned (see STOCKINGS_TEMPLATE in slots.ts) — the graph

package/dist/graph/render-class.js

@@ -1,5 +1,5 @@
 // Render-class + alpha-mode: the small, closed, engine-owned vocabularies that carry
-// pass integration for a style group. A group's node graph is pure shading; these select
+// pass integration for a style group. A group's shader graph is pure shading; these select
 // how the engine wires that shading into the passes. Not user-extensible — this is where
 // rendering correctness lives (stencil, cull, draw order, alpha test). See
 // docs/style-groups-spec.md §5.

package/dist/graph/schema.d.ts

@@ -39,7 +39,7 @@ export type ExposedParam = {
     max?: number;
     default: SocketValue;
 };
-export type StyleGraph = {
+export type ShaderGraph = {
     version: 1;
     name: string;
     nodes: GraphNode[];

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/graph/schema.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAE9F,MAAM,MAAM,SAAS,GAAG;IACtB,kFAAkF;IAClF,EAAE,EAAE,MAAM,CAAA;IACV,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAA;IACZ,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IACpC;mFAC+E;IAC/E,EAAE,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAA;CAC7C,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACtC,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CACrC,CAAA;AAED,0FAA0F;AAC1F,MAAM,MAAM,YAAY,GAAG;IACzB,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACxC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;IACvB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,WAAW,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,CAAC,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,uEAAuE;IACvE,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACxC,MAAM,CAAC,EAAE,YAAY,EAAE,CAAA;IACvB;;uFAEmF;IACnF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,eAAO,MAAM,SAAS,KAAK,CAAA;AAC3B,eAAO,MAAM,UAAU,KAAK,CAAA"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/graph/schema.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAE9F,MAAM,MAAM,SAAS,GAAG;IACtB,kFAAkF;IAClF,EAAE,EAAE,MAAM,CAAA;IACV,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAA;IACZ,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;IACpC;mFAC+E;IAC/E,EAAE,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE;YAAE,CAAC,EAAE,MAAM,CAAC;YAAC,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAA;CAC7C,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACtC,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CACrC,CAAA;AAED,0FAA0F;AAC1F,MAAM,MAAM,YAAY,GAAG;IACzB,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACxC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;IACvB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,WAAW,CAAA;CACrB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,CAAC,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,KAAK,EAAE,SAAS,EAAE,CAAA;IAClB,uEAAuE;IACvE,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACxC,MAAM,CAAC,EAAE,YAAY,EAAE,CAAA;IACvB;;uFAEmF;IACnF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;CAChB,CAAA;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAA;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AAED,eAAO,MAAM,SAAS,KAAK,CAAA;AAC3B,eAAO,MAAM,UAAU,KAAK,CAAA"}

package/dist/graph/schema.js

@@ -1,4 +1,4 @@
-// Material style graph — JSON-serializable node graph compiled to WGSL by compile.ts.
+// ShaderGraph — a JSON-serializable graph of shading nodes, compiled to WGSL by compile.ts.
 // Engine-space (LH, Y-up): porting a Blender graph converts coordinates at authoring
 // time (Blender Normal Z → engine Y), the compiler never sees Blender conventions.
 // See docs/graph-compiler-spec.md.

package/dist/graph/style-group.d.ts

@@ -1,4 +1,4 @@
-import type { Diagnostic, StyleGraph } from "./schema";
+import type { Diagnostic, ShaderGraph } from "./schema";
 import type { AlphaMode, RenderClass } from "./render-class";
 import type { StyleSlot } from "./compile";
 export type StyleGroup = {
@@ -9,8 +9,8 @@ export type StyleGroup = {
     label?: string;
     /** Material names in this group; each material is in AT MOST one group. */
     materials: string[];
-    /** Pure shading (StyleGraph has no `slot` — integration lives here on the group). */
-    graph: StyleGraph;
+    /** Pure shading (ShaderGraph has no `slot` — integration lives here on the group). */
+    graph: ShaderGraph;
     /** Pass-integration class: stencil/cull/draw-order. Default "auto". */
     renderClass?: RenderClass;
     /** Alpha-handling axis, orthogonal to renderClass. Default "opaque". */

package/dist/graph/style-group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"style-group.d.ts","sourceRoot":"","sources":["../../src/graph/style-group.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAE1C,MAAM,MAAM,UAAU,GAAG;IACvB,wFAAwF;IACxF,EAAE,EAAE,MAAM,CAAA;IACV;2CACuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2EAA2E;IAC3E,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,qFAAqF;IACrF,KAAK,EAAE,UAAU,CAAA;IACjB,uEAAuE;IACvE,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,wEAAwE;IACxE,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,UAAU,EAAE,CAAC;IAAC,EAAE,EAAE,OAAO,CAAA;CAAE,CAAA;AAEzF,MAAM,MAAM,sBAAsB,GAAG;IACnC,sCAAsC;IACtC,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,eAAe,EAAE,CAAA;IACzB,iEAAiE;IACjE,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,kFAAkF;IAClF,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,UAAU,EAAE,CAAC;IAAC,OAAO,EAAE,SAAS,EAAE,CAAA;CAAE,CAAA"}
+{"version":3,"file":"style-group.d.ts","sourceRoot":"","sources":["../../src/graph/style-group.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAE1C,MAAM,MAAM,UAAU,GAAG;IACvB,wFAAwF;IACxF,EAAE,EAAE,MAAM,CAAA;IACV;2CACuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2EAA2E;IAC3E,SAAS,EAAE,MAAM,EAAE,CAAA;IACnB,sFAAsF;IACtF,KAAK,EAAE,WAAW,CAAA;IAClB,uEAAuE;IACvE,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,wEAAwE;IACxE,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,UAAU,EAAE,CAAC;IAAC,EAAE,EAAE,OAAO,CAAA;CAAE,CAAA;AAEzF,MAAM,MAAM,sBAAsB,GAAG;IACnC,sCAAsC;IACtC,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,EAAE,eAAe,EAAE,CAAA;IACzB,iEAAiE;IACjE,gBAAgB,EAAE,MAAM,EAAE,CAAA;IAC1B,kFAAkF;IAClF,SAAS,EAAE,MAAM,EAAE,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,qBAAqB,GAAG;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,UAAU,EAAE,CAAC;IAAC,OAAO,EAAE,SAAS,EAAE,CAAA;CAAE,CAAA"}

package/dist/graph/style-group.js

@@ -1,5 +1,5 @@
 // Style groups — the user-facing unit of material styling. A group binds a set of
-// materials to a node graph (pure shading) plus the engine-owned pass-integration axes
+// materials to a shader graph (pure shading) plus the engine-owned pass-integration axes
 // (renderClass + alphaMode). Each material belongs to at most one group; grouped
 // materials render via the group's compiled-graph pipeline, ungrouped ones fall back to
 // the hand-written preset path. See docs/style-groups-spec.md.

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { Engine, DEFAULT_BLOOM_OPTIONS, DEFAULT_VIEW_TRANSFORM, type EngineStats, type EngineOptions, type BloomOptions, type ViewTransformOptions, type LoadModelFromFilesOptions, type MaterialPreset, type ResolvedMaterialPreset, type MaterialPresetMap, type GizmoDragEvent, type GizmoDragCallback, type GizmoDragKind, } from "./engine";
 export { parsePmxFolderInput, pmxFileAtRelativePath, type PmxFolderInputResult } from "./folder-upload";
 export { compileGraph, validateGraph, assignStyleSlots, type CompileOptions, type CompileResult, type StyleSlot, } from "./graph/compile";
-export type { StyleGraph, GraphNode, GraphLink, ExposedParam, SocketValue, Diagnostic, } from "./graph/schema";
+export type { ShaderGraph, GraphNode, GraphLink, ExposedParam, SocketValue, Diagnostic, } from "./graph/schema";
 export { NODE_REGISTRY, type NodeSpec, type SockT } from "./graph/registry";
 export { RENDER_CLASSES, type RenderClass, type AlphaMode, type RenderClassInfo } from "./graph/render-class";
 export type { StyleGroup, GroupDiagnostic, ApplyStyleGroupsResult, ApplyStyleGroupResult, } from "./graph/style-group";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,aAAa,GACnB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AACvG,OAAO,EACL,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,SAAS,GACf,MAAM,iBAAiB,CAAA;AACxB,YAAY,EACV,UAAU,EACV,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,UAAU,GACX,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC3E,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC7G,YAAY,EACV,UAAU,EACV,eAAe,EACf,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AACzC,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,MAAM,EACN,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,aAAa,GACnB,MAAM,UAAU,CAAA;AACjB,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,KAAK,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AACvG,OAAO,EACL,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,SAAS,GACf,MAAM,iBAAiB,CAAA;AACxB,YAAY,EACV,WAAW,EACX,SAAS,EACT,SAAS,EACT,YAAY,EACZ,WAAW,EACX,UAAU,GACX,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,aAAa,EAAE,KAAK,QAAQ,EAAE,KAAK,KAAK,EAAE,MAAM,kBAAkB,CAAA;AAC3E,OAAO,EAAE,cAAc,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC7G,YAAY,EACV,UAAU,EACV,eAAe,EACf,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AACzC,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,YAAY,GACb,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "reze-engine",
-    "version": "0.20.0",
+    "version": "0.21.0",
     "description": "A lightweight WebGPU engine for real-time 3D MMD/PMX model rendering",
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",

package/src/engine.ts

@@ -31,7 +31,7 @@ import { COMPOSITE_SHADER_WGSL } from "./shaders/passes/composite"
 import { PICK_SHADER_WGSL } from "./shaders/passes/pick"
 import { MIPMAP_BLIT_SHADER_WGSL } from "./shaders/passes/mipmap"
 import { compileGraph, type CompileOptions, type StyleSlot } from "./graph/compile"
-import type { Diagnostic, StyleGraph } from "./graph/schema"
+import type { Diagnostic, ShaderGraph } from "./graph/schema"
 import type { AlphaMode, RenderClass } from "./graph/render-class"
 import type {
   ApplyStyleGroupResult,
@@ -136,7 +136,7 @@ function resolvePreset(materialName: string, map: MaterialPresetMap | undefined)
 // (renderClass, alphaMode). This is the auto-default-groups mapping (docs §8) — the same
 // label→integration knowledge the old fixed slots encoded, now producing editable groups.
 // mmd_classic has no entry — those materials stay ungrouped (hand-shader path).
-const PRESET_GROUP_INFO: Partial<Record<MaterialPreset, { graph: StyleGraph; renderClass: RenderClass; alphaMode: AlphaMode }>> = {
+const PRESET_GROUP_INFO: Partial<Record<MaterialPreset, { graph: ShaderGraph; renderClass: RenderClass; alphaMode: AlphaMode }>> = {
   default: { graph: DEFAULT_GRAPH, renderClass: "auto", alphaMode: "opaque" },
   face: { graph: FACE_GRAPH, renderClass: "auto", alphaMode: "opaque" },
   hair: { graph: HAIR_GRAPH, renderClass: "hair", alphaMode: "opaque" },

package/src/graph/compile.ts

@@ -4,7 +4,7 @@
 // See docs/graph-compiler-spec.md.
 
 import { MAX_NODES, MAX_PARAMS } from "./schema"
-import type { Diagnostic, ExposedParam, GraphNode, SocketValue, StyleGraph } from "./schema"
+import type { Diagnostic, ExposedParam, GraphNode, SocketValue, ShaderGraph } from "./schema"
 import { NODE_REGISTRY, canConvert, convert, fmtValue, literalFits } from "./registry"
 import type { NodeSpec, SockT } from "./registry"
 import { assembleModule } from "./slots"
@@ -83,7 +83,7 @@ export function assignStyleSlots(params: ExposedParam[]): StyleSlot[] {
 
 // ─── Validation ─────────────────────────────────────────────────────
 
-export function validateGraph(graph: StyleGraph, opts: CompileOptions = {}): Diagnostic[] {
+export function validateGraph(graph: ShaderGraph, opts: CompileOptions = {}): Diagnostic[] {
   const d: Diagnostic[] = []
   const nodes = new Map<string, GraphNode>()
 
@@ -188,7 +188,7 @@ export function validateGraph(graph: StyleGraph, opts: CompileOptions = {}): Dia
 
 // ─── Compile ────────────────────────────────────────────────────────
 
-export function compileGraph(graph: StyleGraph, opts: CompileOptions = {}): CompileResult {
+export function compileGraph(graph: ShaderGraph, opts: CompileOptions = {}): CompileResult {
   const fail = (diagnostics: Diagnostic[]): CompileResult => ({
     ok: false,
     wgsl: "",

package/src/graph/presets/body.ts

@@ -1,11 +1,11 @@
-// 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.
 
-import type { StyleGraph } from "../schema"
+import type { ShaderGraph } from "../schema"
 
-export const BODY_GRAPH: StyleGraph = {
+export const BODY_GRAPH: ShaderGraph = {
   version: 1,
   name: "Body",
   tags: ["body"],

package/src/graph/presets/cloth_rough.ts

@@ -1,11 +1,11 @@
-// 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.
 
-import type { StyleGraph } from "../schema"
+import type { ShaderGraph } from "../schema"
 
-export const CLOTH_ROUGH_GRAPH: StyleGraph = {
+export const CLOTH_ROUGH_GRAPH: ShaderGraph = {
   version: 1,
   name: "Rough Cloth",
   tags: ["cloth_rough"],

package/src/graph/presets/cloth_smooth.ts

@@ -1,11 +1,11 @@
-// 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.
 
-import type { StyleGraph } from "../schema"
+import type { ShaderGraph } from "../schema"
 
-export const CLOTH_SMOOTH_GRAPH: StyleGraph = {
+export const CLOTH_SMOOTH_GRAPH: ShaderGraph = {
   version: 1,
   name: "Smooth Cloth",
   tags: ["cloth_smooth"],

package/src/graph/presets/default.ts

@@ -5,9 +5,9 @@
 // The material-color multiply is what keeps untextured/solid-color materials from
 // rendering white (they carry their color in material.diffuse, not a texture).
 
-import type { StyleGraph } from "../schema"
+import type { ShaderGraph } from "../schema"
 
-export const DEFAULT_GRAPH: StyleGraph = {
+export const DEFAULT_GRAPH: ShaderGraph = {
   version: 1,
   name: "Principled BSDF",
   tags: ["default"],

package/src/graph/presets/eye.ts

@@ -1,4 +1,4 @@
-// Eye as a StyleGraph — port of shaders/materials/eye.ts. The published preset
+// Eye as a ShaderGraph — port of shaders/materials/eye.ts. The published preset
 // author's instruction: "keep eyes in the default nodegraph, add emission 1.5".
 // So it's the default Principled BSDF plus an Emission of the diffuse texture at
 // 1.5× (Blender's Principled Emission socket, decomposed as a separate Emission +
@@ -7,9 +7,9 @@
 // The rear-view gate and the see-through stencil stamp are slot-owned (built-in eye
 // behavior, see EYE_TEMPLATE in slots.ts + createSlotPipeline) — not in this graph.
 
-import type { StyleGraph } from "../schema"
+import type { ShaderGraph } from "../schema"
 
-export const EYE_GRAPH: StyleGraph = {
+export const EYE_GRAPH: ShaderGraph = {
   version: 1,
   name: "Eye",
   tags: ["eye"],

package/src/graph/presets/face.ts

@@ -1,4 +1,4 @@
-// M_Face as a StyleGraph — port of shaders/materials/face.ts (仿深空之眼 "M_Face").
+// M_Face as a ShaderGraph — port of shaders/materials/face.ts (仿深空之眼 "M_Face").
 // Toon + warm rim + dual fresnel rim + BT.601 bright-tex gate, mixed 50/50 against a
 // Principled BSDF with noise bump. Structurally close to body, but: the toon uses the
 // edge-AA ramp, hue tints are 0.46 (full hue_sat, not the 0.5 _id specialization),
@@ -6,9 +6,9 @@
 // near-white texture gate that emits (freckle/highlight paint). Plain material — no
 // built-in slot effect, so it uses the default prelude/epilogue.
 
-import type { StyleGraph } from "../schema"
+import type { ShaderGraph } from "../schema"
 
-export const FACE_GRAPH: StyleGraph = {
+export const FACE_GRAPH: ShaderGraph = {
   version: 1,
   name: "Face",
   tags: ["face"],

package/src/graph/presets/hair.ts

@@ -1,4 +1,4 @@
-// M_Hair — 仿深空之眼渲染预设v1.0_by_小绿毛猫, as a StyleGraph. Node ids mirror the
+// M_Hair — 仿深空之眼渲染预设v1.0_by_小绿毛猫, as a ShaderGraph. Node ids mirror the
 // Blender node names referenced in shaders/materials/hair.ts comments; compiled with
 // { inlineParams: true } this graph must reproduce HAIR_SHADER_WGSL's fragment body
 // (golden test #1 — see tests/graph.test.mjs).
@@ -10,9 +10,9 @@
 // The object is pure JSON (no functions/undefined) — JSON.stringify round-trips it,
 // which is how reze.design will ship additional presets.
 
-import type { StyleGraph } from "../schema"
+import type { ShaderGraph } from "../schema"
 
-export const HAIR_GRAPH: StyleGraph = {
+export const HAIR_GRAPH: ShaderGraph = {
   version: 1,
   name: "Hair",
   tags: ["hair"],

package/src/graph/presets/metal.ts

@@ -1,12 +1,12 @@
-// M_Metal as a StyleGraph — port of shaders/materials/metal.ts.
+// M_Metal as a ShaderGraph — port of shaders/materials/metal.ts.
 // Metallic Principled (Metallic=1, Specular=1, Roughness=0.3) with a
 // reflection-coord voronoi driving base color (metallic sparkle), plus an NPR
 // toon/overlay emission stack mixed at Fac=0.6967. The voronoi Color→ramp Fac
 // link goes through Blender's implicit BT.601 conversion (color_to_value).
 
-import type { StyleGraph } from "../schema"
+import type { ShaderGraph } from "../schema"
 
-export const METAL_GRAPH: StyleGraph = {
+export const METAL_GRAPH: ShaderGraph = {
   version: 1,
   name: "Metal",
   tags: ["metal"],

package/src/graph/presets/stockings.ts

@@ -1,4 +1,4 @@
-// M_Stockings as a StyleGraph — port of shaders/materials/stockings.ts.
+// M_Stockings as a ShaderGraph — port of shaders/materials/stockings.ts.
 // A bbox-gradient × facing-rim mask drives a Mix Shader between an HSV-boosted
 // emission (val 5×) and a sheen Principled. The hashed-alpha discard and the
 // alpha=1 output are slot-owned (see STOCKINGS_TEMPLATE in slots.ts) — the graph
@@ -6,9 +6,9 @@
 // as in the hand port. The grayscale mask feeds Mix Shader Fac through Blender's
 // implicit BT.601 color→float conversion (equal-component vector → same scalar).
 
-import type { StyleGraph } from "../schema"
+import type { ShaderGraph } from "../schema"
 
-export const STOCKINGS_GRAPH: StyleGraph = {
+export const STOCKINGS_GRAPH: ShaderGraph = {
   version: 1,
   name: "Stockings",
   tags: ["stockings"],

package/src/graph/render-class.ts

@@ -1,5 +1,5 @@
 // Render-class + alpha-mode: the small, closed, engine-owned vocabularies that carry
-// pass integration for a style group. A group's node graph is pure shading; these select
+// pass integration for a style group. A group's shader graph is pure shading; these select
 // how the engine wires that shading into the passes. Not user-extensible — this is where
 // rendering correctness lives (stencil, cull, draw order, alpha test). See
 // docs/style-groups-spec.md §5.

package/src/graph/schema.ts

@@ -1,4 +1,4 @@
-// Material style graph — JSON-serializable node graph compiled to WGSL by compile.ts.
+// ShaderGraph — a JSON-serializable graph of shading nodes, compiled to WGSL by compile.ts.
 // Engine-space (LH, Y-up): porting a Blender graph converts coordinates at authoring
 // time (Blender Normal Z → engine Y), the compiler never sees Blender conventions.
 // See docs/graph-compiler-spec.md.
@@ -34,7 +34,7 @@ export type ExposedParam = {
   default: SocketValue
 }
 
-export type StyleGraph = {
+export type ShaderGraph = {
   version: 1
   name: string
   nodes: GraphNode[]

package/src/graph/style-group.ts

@@ -1,10 +1,10 @@
 // Style groups — the user-facing unit of material styling. A group binds a set of
-// materials to a node graph (pure shading) plus the engine-owned pass-integration axes
+// materials to a shader graph (pure shading) plus the engine-owned pass-integration axes
 // (renderClass + alphaMode). Each material belongs to at most one group; grouped
 // materials render via the group's compiled-graph pipeline, ungrouped ones fall back to
 // the hand-written preset path. See docs/style-groups-spec.md.
 
-import type { Diagnostic, StyleGraph } from "./schema"
+import type { Diagnostic, ShaderGraph } from "./schema"
 import type { AlphaMode, RenderClass } from "./render-class"
 import type { StyleSlot } from "./compile"
 
@@ -16,8 +16,8 @@ export type StyleGroup = {
   label?: string
   /** Material names in this group; each material is in AT MOST one group. */
   materials: string[]
-  /** Pure shading (StyleGraph has no `slot` — integration lives here on the group). */
-  graph: StyleGraph
+  /** Pure shading (ShaderGraph has no `slot` — integration lives here on the group). */
+  graph: ShaderGraph
   /** Pass-integration class: stencil/cull/draw-order. Default "auto". */
   renderClass?: RenderClass
   /** Alpha-handling axis, orthogonal to renderClass. Default "opaque". */

package/src/index.ts

@@ -1,63 +1,63 @@
-export {
-  Engine,
-  DEFAULT_BLOOM_OPTIONS,
-  DEFAULT_VIEW_TRANSFORM,
-  type EngineStats,
-  type EngineOptions,
-  type BloomOptions,
-  type ViewTransformOptions,
-  type LoadModelFromFilesOptions,
-  type MaterialPreset,
-  type ResolvedMaterialPreset,
-  type MaterialPresetMap,
-  type GizmoDragEvent,
-  type GizmoDragCallback,
-  type GizmoDragKind,
-} from "./engine"
-export { parsePmxFolderInput, pmxFileAtRelativePath, type PmxFolderInputResult } from "./folder-upload"
-export {
-  compileGraph,
-  validateGraph,
-  assignStyleSlots,
-  type CompileOptions,
-  type CompileResult,
-  type StyleSlot,
-} from "./graph/compile"
-export type {
-  StyleGraph,
-  GraphNode,
-  GraphLink,
-  ExposedParam,
-  SocketValue,
-  Diagnostic,
-} from "./graph/schema"
-export { NODE_REGISTRY, type NodeSpec, type SockT } from "./graph/registry"
-export { RENDER_CLASSES, type RenderClass, type AlphaMode, type RenderClassInfo } from "./graph/render-class"
-export type {
-  StyleGroup,
-  GroupDiagnostic,
-  ApplyStyleGroupsResult,
-  ApplyStyleGroupResult,
-} from "./graph/style-group"
-export { HAIR_GRAPH } from "./graph/presets/hair"
-export { DEFAULT_GRAPH } from "./graph/presets/default"
-export { CLOTH_SMOOTH_GRAPH } from "./graph/presets/cloth_smooth"
-export { CLOTH_ROUGH_GRAPH } from "./graph/presets/cloth_rough"
-export { METAL_GRAPH } from "./graph/presets/metal"
-export { BODY_GRAPH } from "./graph/presets/body"
-export { STOCKINGS_GRAPH } from "./graph/presets/stockings"
-export { EYE_GRAPH } from "./graph/presets/eye"
-export { FACE_GRAPH } from "./graph/presets/face"
-export { Model } from "./model"
-export { Vec3, Quat, Mat4 } from "./math"
-export type {
-  AnimationClip,
-  AnimationPlayOptions,
-  AnimationProgress,
-  BoneKeyframe,
-  MorphKeyframe,
-  BoneInterpolation,
-  ControlPoint,
-} from "./animation"
-export { FPS } from "./animation"
+export {
+  Engine,
+  DEFAULT_BLOOM_OPTIONS,
+  DEFAULT_VIEW_TRANSFORM,
+  type EngineStats,
+  type EngineOptions,
+  type BloomOptions,
+  type ViewTransformOptions,
+  type LoadModelFromFilesOptions,
+  type MaterialPreset,
+  type ResolvedMaterialPreset,
+  type MaterialPresetMap,
+  type GizmoDragEvent,
+  type GizmoDragCallback,
+  type GizmoDragKind,
+} from "./engine"
+export { parsePmxFolderInput, pmxFileAtRelativePath, type PmxFolderInputResult } from "./folder-upload"
+export {
+  compileGraph,
+  validateGraph,
+  assignStyleSlots,
+  type CompileOptions,
+  type CompileResult,
+  type StyleSlot,
+} from "./graph/compile"
+export type {
+  ShaderGraph,
+  GraphNode,
+  GraphLink,
+  ExposedParam,
+  SocketValue,
+  Diagnostic,
+} from "./graph/schema"
+export { NODE_REGISTRY, type NodeSpec, type SockT } from "./graph/registry"
+export { RENDER_CLASSES, type RenderClass, type AlphaMode, type RenderClassInfo } from "./graph/render-class"
+export type {
+  StyleGroup,
+  GroupDiagnostic,
+  ApplyStyleGroupsResult,
+  ApplyStyleGroupResult,
+} from "./graph/style-group"
+export { HAIR_GRAPH } from "./graph/presets/hair"
+export { DEFAULT_GRAPH } from "./graph/presets/default"
+export { CLOTH_SMOOTH_GRAPH } from "./graph/presets/cloth_smooth"
+export { CLOTH_ROUGH_GRAPH } from "./graph/presets/cloth_rough"
+export { METAL_GRAPH } from "./graph/presets/metal"
+export { BODY_GRAPH } from "./graph/presets/body"
+export { STOCKINGS_GRAPH } from "./graph/presets/stockings"
+export { EYE_GRAPH } from "./graph/presets/eye"
+export { FACE_GRAPH } from "./graph/presets/face"
+export { Model } from "./model"
+export { Vec3, Quat, Mat4 } from "./math"
+export type {
+  AnimationClip,
+  AnimationPlayOptions,
+  AnimationProgress,
+  BoneKeyframe,
+  MorphKeyframe,
+  BoneInterpolation,
+  ControlPoint,
+} from "./animation"
+export { FPS } from "./animation"
 export { RezePhysics } from "./physics"