reze-engine 0.19.0 → 0.21.0

package/dist/graph/presets/default.js

@@ -1,20 +1,27 @@
-// Default material as a StyleGraph — Blender's new-material template verbatim:
-// Image Texture → Principled BSDF (Metallic 0, Specular 0.5, Roughness 0.5) → Output.
-// This is both the port of shaders/materials/default.ts (must match it pixel-for-pixel;
-// see tests/graph.test.mjs) and the blank-canvas starter graph an editor offers when
-// the user creates a new style.
+// Default material — the neutral base used two ways: the ungrouped fallback (a material
+// in no style group renders this) and the blank-canvas starter the editor's "New graph"
+// begins from, so the two always agree. MMD-correct PBSDF base: diffuse texture × the
+// PMX material diffuse color → Principled BSDF (Metallic 0, Specular 0.5, Roughness 0.5).
+// The material-color multiply is what keeps untextured/solid-color materials from
+// rendering white (they carry their color in material.diffuse, not a texture).
 export const DEFAULT_GRAPH = {
     version: 1,
     name: "Principled BSDF",
     tags: ["default"],
     nodes: [
         { id: "tex", type: "texture" },
+        { id: "mat", type: "material_diffuse" },
+        { id: "base", type: "mix/multiply", inputs: { fac: 1.0 } }, // texture × material diffuse
         {
             id: "principled",
             type: "principled",
             inputs: { metallic: 0.0, specular: 0.5, roughness: 0.5, spec_clamp: 10.0, sheen: 0.0, sheen_tint: 0.0 },
         },
     ],
-    links: [{ from: { node: "tex", socket: "color" }, to: { node: "principled", socket: "base" } }],
+    links: [
+        { from: { node: "tex", socket: "color" }, to: { node: "base", socket: "a" } },
+        { from: { node: "mat", socket: "color" }, to: { node: "base", socket: "b" } },
+        { from: { node: "base", socket: "color" }, to: { node: "principled", socket: "base" } },
+    ],
     output: { node: "principled", socket: "color" },
 };

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/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/graph/registry.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE3C,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEzD,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,KAAK,CAAA;IACX,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,4FAA4F;IAC5F,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,yFAAyF;IACzF,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IAC9B,2FAA2F;IAC3F,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAA;IAC/C,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACtC,CAAA;AAMD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI1C;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,GAAG,MAAM,CAgBhE;AAED,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO,CAIpE;AAMD,wBAAgB,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAM1D;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpE;AA6BD,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CA+OlD,CAAA"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/graph/registry.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAE3C,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAA;AAEzD,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,KAAK,CAAA;IACX,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,4FAA4F;IAC5F,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,yFAAyF;IACzF,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACjC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IAC9B,2FAA2F;IAC3F,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,MAAM,CAAA;IAC/C,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACvC,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACtC,CAAA;AAMD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAI1C;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,GAAG,MAAM,CAgBhE;AAED,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO,CAIpE;AAMD,wBAAgB,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,GAAG,OAAO,CAM1D;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpE;AA6BD,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAuPlD,CAAA"}

package/dist/graph/registry.js

@@ -118,6 +118,14 @@ export const NODE_REGISTRY = {
             reflection: "reflect(-v, n)",
         },
     },
+    // PMX material's diffuse color (the authored base tint). Multiply the diffuse texture
+    // by this for the MMD-correct base — untextured materials carry their color here, so a
+    // texture-only base would render them white.
+    material_diffuse: {
+        inputs: {},
+        outputs: { color: "color" },
+        contextOutputs: { color: "material.diffuseColor" },
+    },
     // ── Literals as nodes (for editor ergonomics; inlined literals work too) ──
     value: { inputs: { value: F(0) }, outputs: { value: "float" }, emit: (a) => a.value },
     rgb: { inputs: { color: C() }, outputs: { color: "color" }, emit: (a) => a.color },

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/dist/tga-loader.d.ts

@@ -0,0 +1,7 @@
+export type DecodedImage = {
+    width: number;
+    height: number;
+    rgba: Uint8Array;
+};
+export declare function decodeTga(buffer: ArrayBuffer): DecodedImage;
+//# sourceMappingURL=tga-loader.d.ts.map

package/dist/tga-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tga-loader.d.ts","sourceRoot":"","sources":["../src/tga-loader.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAA;AAY9E,wBAAgB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,YAAY,CAoH3D"}

package/dist/tga-loader.js

@@ -0,0 +1,154 @@
+// Minimal TGA decoder. TGA is not a web-native format (createImageBitmap can't decode
+// it), yet it's common in PMX assets — especially sphere maps (.spa/.sph) and eye/detail
+// textures — so without this those materials render untextured. Produces top-left-origin
+// RGBA8, ready for queue.writeTexture into an rgba8unorm(-srgb) texture.
+//
+// Handles the variants that actually appear in the wild: true-color (16/24/32), grayscale
+// (8), and color-mapped (8-bit index), each raw or RLE-compressed, with the image
+// descriptor's origin bits honored. Throws on malformed/unsupported input — the caller
+// catches, logs, and falls back to the white texture (never panics the render loop).
+// Image type byte (header offset 2).
+var TgaType;
+(function (TgaType) {
+    TgaType[TgaType["ColorMapped"] = 1] = "ColorMapped";
+    TgaType[TgaType["TrueColor"] = 2] = "TrueColor";
+    TgaType[TgaType["Grayscale"] = 3] = "Grayscale";
+    TgaType[TgaType["RleColorMapped"] = 9] = "RleColorMapped";
+    TgaType[TgaType["RleTrueColor"] = 10] = "RleTrueColor";
+    TgaType[TgaType["RleGrayscale"] = 11] = "RleGrayscale";
+})(TgaType || (TgaType = {}));
+export function decodeTga(buffer) {
+    const bytes = new Uint8Array(buffer);
+    const view = new DataView(buffer);
+    if (bytes.length < 18)
+        throw new Error("TGA too small for header");
+    const idLength = view.getUint8(0);
+    const colorMapType = view.getUint8(1);
+    const imageType = view.getUint8(2);
+    const cmapLength = view.getUint16(5, true);
+    const cmapEntryBits = view.getUint8(7);
+    const width = view.getUint16(12, true);
+    const height = view.getUint16(14, true);
+    const pixelDepth = view.getUint8(16);
+    const descriptor = view.getUint8(17);
+    if (width <= 0 || height <= 0)
+        throw new Error(`TGA bad dimensions ${width}x${height}`);
+    const rle = imageType === TgaType.RleColorMapped ||
+        imageType === TgaType.RleTrueColor ||
+        imageType === TgaType.RleGrayscale;
+    const colorMapped = imageType === TgaType.ColorMapped || imageType === TgaType.RleColorMapped;
+    const grayscale = imageType === TgaType.Grayscale || imageType === TgaType.RleGrayscale;
+    const trueColor = imageType === TgaType.TrueColor || imageType === TgaType.RleTrueColor;
+    if (!colorMapped && !grayscale && !trueColor)
+        throw new Error(`TGA unsupported image type ${imageType}`);
+    let offset = 18 + idLength;
+    // Color map (BGR/BGRA entries) → precomputed RGBA lookup.
+    let colorMap = null;
+    if (colorMapType === 1) {
+        const entryBytes = Math.ceil(cmapEntryBits / 8);
+        colorMap = new Uint8Array(cmapLength * 4);
+        for (let i = 0; i < cmapLength; i++) {
+            const [r, g, b, a] = unpackColor(bytes, offset + i * entryBytes, cmapEntryBits);
+            colorMap.set([r, g, b, a], i * 4);
+        }
+        offset += cmapLength * entryBytes;
+    }
+    else if (colorMapped) {
+        throw new Error("TGA color-mapped image without a color map");
+    }
+    // Bytes per stored element (index byte for color-mapped, else pixel bytes).
+    const elemBits = colorMapped ? pixelDepth : pixelDepth;
+    const elemBytes = Math.ceil(elemBits / 8);
+    const pixelCount = width * height;
+    // Decode the (possibly RLE) element stream into one element per pixel, file order.
+    const elements = new Uint8Array(pixelCount * elemBytes);
+    if (rle) {
+        let out = 0;
+        let src = offset;
+        while (out < elements.length) {
+            if (src >= bytes.length)
+                throw new Error("TGA RLE stream truncated");
+            const packet = bytes[src++];
+            const count = (packet & 0x7f) + 1;
+            if (packet & 0x80) {
+                // RLE packet: one element repeated `count` times.
+                if (src + elemBytes > bytes.length)
+                    throw new Error("TGA RLE packet truncated");
+                for (let i = 0; i < count && out < elements.length; i++) {
+                    elements.set(bytes.subarray(src, src + elemBytes), out);
+                    out += elemBytes;
+                }
+                src += elemBytes;
+            }
+            else {
+                // Raw packet: `count` elements follow.
+                const span = count * elemBytes;
+                if (src + span > bytes.length)
+                    throw new Error("TGA raw packet truncated");
+                elements.set(bytes.subarray(src, src + span), out);
+                out += span;
+                src += span;
+            }
+        }
+    }
+    else {
+        const span = pixelCount * elemBytes;
+        if (offset + span > bytes.length)
+            throw new Error("TGA pixel data truncated");
+        elements.set(bytes.subarray(offset, offset + span), 0);
+    }
+    // Convert elements → RGBA in file order.
+    const linear = new Uint8Array(pixelCount * 4);
+    for (let p = 0; p < pixelCount; p++) {
+        let rgba;
+        if (colorMapped) {
+            const index = elements[p]; // 8-bit index (pixelDepth 8)
+            const c = index * 4;
+            rgba = colorMap ? [colorMap[c], colorMap[c + 1], colorMap[c + 2], colorMap[c + 3]] : [0, 0, 0, 255];
+        }
+        else if (grayscale) {
+            const g = elements[p * elemBytes];
+            rgba = [g, g, g, 255];
+        }
+        else {
+            rgba = unpackColor(elements, p * elemBytes, pixelDepth);
+        }
+        linear.set(rgba, p * 4);
+    }
+    // Honor origin bits: bit5 set → top-to-bottom (no flip); clear → bottom-to-top.
+    // bit4 set → right-to-left. Output is always top-left origin for GPU upload.
+    const flipY = (descriptor & 0x20) === 0;
+    const flipX = (descriptor & 0x10) !== 0;
+    if (!flipX && !flipY)
+        return { width, height, rgba: linear };
+    const rgba = new Uint8Array(pixelCount * 4);
+    for (let y = 0; y < height; y++) {
+        const sy = flipY ? height - 1 - y : y;
+        for (let x = 0; x < width; x++) {
+            const sx = flipX ? width - 1 - x : x;
+            const src = (sy * width + sx) * 4;
+            const dst = (y * width + x) * 4;
+            rgba[dst] = linear[src];
+            rgba[dst + 1] = linear[src + 1];
+            rgba[dst + 2] = linear[src + 2];
+            rgba[dst + 3] = linear[src + 3];
+        }
+    }
+    return { width, height, rgba };
+}
+// Unpack one true-color element (16/24/32-bit, stored BGR[A]) to RGBA8.
+function unpackColor(src, o, bits) {
+    if (bits === 32)
+        return [src[o + 2], src[o + 1], src[o], src[o + 3]];
+    if (bits === 24)
+        return [src[o + 2], src[o + 1], src[o], 255];
+    if (bits === 16 || bits === 15) {
+        // 1-5-5-5: bit15 = attribute, then 5 red, 5 green, 5 blue (little-endian).
+        const val = src[o] | (src[o + 1] << 8);
+        const r = ((val >> 10) & 0x1f) * 255;
+        const g = ((val >> 5) & 0x1f) * 255;
+        const b = (val & 0x1f) * 255;
+        return [Math.round(r / 31), Math.round(g / 31), Math.round(b / 31), 255];
+    }
+    throw new Error(`TGA unsupported pixel depth ${bits}`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "reze-engine",
-    "version": "0.19.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",
@@ -23,7 +23,7 @@
         "build": "tsc",
         "dev": "tsc --watch",
         "test": "node --import ./tests/register.mjs --test tests/*.test.mjs",
-        "prepublishOnly": "npm run build"
+        "prepublishOnly": "cp ../README.md ./README.md && npm run build"
     },
     "keywords": [
         "webgpu",