reze-engine 0.18.1 → 0.19.0

package/dist/graph/compile.d.ts

@@ -1,4 +1,5 @@
 import type { Diagnostic, ExposedParam, StyleGraph } from "./schema";
+import type { AlphaMode, RenderClass } from "./render-class";
 export type CompileOptions = {
     /** Fold exposed params to their defaults as consts (no StyleUniforms binding).
      *  Used by golden tests and by hosts that don't bind the style buffer. */
@@ -9,6 +10,11 @@ export type CompileOptions = {
         node: string;
         socket: string;
     };
+    /** Pass-integration class the fs() shell is assembled for (stencil/cull/gate). The
+     *  graph is pure shading; the group supplies this. Default "auto". */
+    renderClass?: RenderClass;
+    /** Alpha-handling axis, orthogonal to renderClass. Default "opaque". */
+    alphaMode?: AlphaMode;
 };
 /** UBO slot for one exposed param: write `value` at style.p[vec4Index] (+ component). */
 export type StyleSlot = {

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;AAK5F,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;CAC/C,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,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"}

package/dist/graph/compile.js

@@ -294,6 +294,6 @@ export function compileGraph(graph, opts = {}) {
     }
     lines.push(`  let final_color = ${outputExpr(out, "color")}; // @node:${out.node}`);
     const fsBody = lines.join("\n");
-    const wgsl = assembleModule(graph.slot, fsBody, usesStyle.current);
+    const wgsl = assembleModule(opts.renderClass ?? "auto", opts.alphaMode ?? "opaque", fsBody, usesStyle.current);
     return { ok: true, wgsl, fsBody, slotMap, diagnostics, prunedNodes };
 }

package/dist/graph/presets/body.js

@@ -5,7 +5,7 @@
 export const BODY_GRAPH = {
     version: 1,
     name: "Body",
-    slot: "body",
+    tags: ["body"],
     nodes: [
         { id: "tex", type: "texture" },
         { id: "geo", type: "geometry" },

package/dist/graph/presets/cloth_rough.js

@@ -5,7 +5,7 @@
 export const CLOTH_ROUGH_GRAPH = {
     version: 1,
     name: "Rough Cloth",
-    slot: "cloth_rough",
+    tags: ["cloth_rough"],
     nodes: [
         { id: "tex", type: "texture" },
         { id: "geo", type: "geometry" },

package/dist/graph/presets/cloth_smooth.js

@@ -5,7 +5,7 @@
 export const CLOTH_SMOOTH_GRAPH = {
     version: 1,
     name: "Smooth Cloth",
-    slot: "cloth_smooth",
+    tags: ["cloth_smooth"],
     nodes: [
         { id: "tex", type: "texture" },
         { id: "geo", type: "geometry" },

package/dist/graph/presets/default.js

@@ -6,7 +6,7 @@
 export const DEFAULT_GRAPH = {
     version: 1,
     name: "Principled BSDF",
-    slot: "default",
+    tags: ["default"],
     nodes: [
         { id: "tex", type: "texture" },
         {

package/dist/graph/presets/eye.js

@@ -9,7 +9,7 @@
 export const EYE_GRAPH = {
     version: 1,
     name: "Eye",
-    slot: "eye",
+    tags: ["eye"],
     nodes: [
         { id: "tex", type: "texture" },
         {

package/dist/graph/presets/face.js

@@ -8,7 +8,7 @@
 export const FACE_GRAPH = {
     version: 1,
     name: "Face",
-    slot: "face",
+    tags: ["face"],
     nodes: [
         { id: "tex", type: "texture" },
         { id: "geo", type: "geometry" },

package/dist/graph/presets/hair.js

@@ -12,7 +12,7 @@
 export const HAIR_GRAPH = {
     version: 1,
     name: "Hair",
-    slot: "hair",
+    tags: ["hair"],
     nodes: [
         { id: "tex", type: "texture" },
         { id: "geo", type: "geometry" },

package/dist/graph/presets/metal.js

@@ -6,7 +6,7 @@
 export const METAL_GRAPH = {
     version: 1,
     name: "Metal",
-    slot: "metal",
+    tags: ["metal"],
     nodes: [
         { id: "tex", type: "texture" },
         { id: "geo", type: "geometry" },

package/dist/graph/presets/stockings.js

@@ -8,7 +8,7 @@
 export const STOCKINGS_GRAPH = {
     version: 1,
     name: "Stockings",
-    slot: "stockings",
+    tags: ["stockings"],
     nodes: [
         { id: "tex", type: "texture" },
         { id: "geo", type: "geometry" },

package/dist/graph/render-class.d.ts

@@ -0,0 +1,16 @@
+/** Pass-integration class. Selects stencil/cull/draw-order behavior. */
+export type RenderClass = "auto" | "eye" | "hair";
+/** Alpha-handling axis, orthogonal to RenderClass. "hashed" = Wyman & McGuire object-space
+ *  hashed alpha test (stockings); "opaque" = the standard near-zero threshold discard. */
+export type AlphaMode = "opaque" | "hashed";
+/** Descriptive manifest for hosts (reze-design) so the render-class picker is data-driven
+ *  instead of hardcoding strings. The effect implementations stay engine-side; this only
+ *  describes them. `pairsWith` = the effect needs a counterpart class present to show. */
+export type RenderClassInfo = {
+    id: RenderClass;
+    label: string;
+    description: string;
+    pairsWith?: RenderClass;
+};
+export declare const RENDER_CLASSES: readonly RenderClassInfo[];
+//# sourceMappingURL=render-class.d.ts.map

package/dist/graph/render-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-class.d.ts","sourceRoot":"","sources":["../../src/graph/render-class.ts"],"names":[],"mappings":"AAMA,wEAAwE;AACxE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAA;AAEjD;0FAC0F;AAC1F,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAE3C;;0FAE0F;AAC1F,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,WAAW,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,WAAW,CAAA;CACxB,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,SAAS,eAAe,EASpD,CAAA"}

package/dist/graph/render-class.js

@@ -0,0 +1,15 @@
+// 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
+// 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.
+export const RENDER_CLASSES = [
+    { id: "auto", label: "Standard", description: "Opaque or transparent, derived from material alpha." },
+    { id: "eye", label: "Eye", description: "Stamps the see-through stencil; visible through hair.", pairsWith: "hair" },
+    {
+        id: "hair",
+        label: "Hair",
+        description: "Reads the eye stencil so eyes show through the silhouette.",
+        pairsWith: "eye",
+    },
+];

package/dist/graph/schema.d.ts

@@ -1,4 +1,3 @@
-import type { MaterialPreset } from "../engine";
 export type SocketValue = number | [number, number, number] | [number, number, number, number];
 export type GraphNode = {
     /** Unique within the graph, /^[a-z0-9_]+$/ — becomes the WGSL variable suffix. */
@@ -43,10 +42,6 @@ export type ExposedParam = {
 export type StyleGraph = {
     version: 1;
     name: string;
-    /** Which preset slot this style targets. The slot owns pass integration (stencil
-     *  variants like hair-over-eyes, alpha semantics, draw order) — always on,
-     *  graph-invisible. The graph only restyles the slot's shading. */
-    slot: MaterialPreset;
     nodes: GraphNode[];
     links: GraphLink[];
     /** Must resolve to a color (vec3f) or float (auto-splatted) socket. */
@@ -55,6 +50,10 @@ export type StyleGraph = {
         socket: string;
     };
     params?: ExposedParam[];
+    /** Soft, host-only hints for library filtering and smart default-group / render-class
+     *  matching (e.g. ["hair"]). Ignored by the compiler; round-tripped. A graph is pure
+     *  shading — pass integration lives on the style group's renderClass, not here. */
+    tags?: string[];
 };
 export type Diagnostic = {
     severity: "error" | "warning";

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/graph/schema.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE/C,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;;uEAEmE;IACnE,IAAI,EAAE,cAAc,CAAA;IACpB,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;CACxB,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,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"}

package/dist/graph/slots.d.ts

@@ -1,14 +1,9 @@
-import type { MaterialPreset } from "../engine";
-export type SlotTemplate = {
-    /** Module-scope declarations (pipeline-override constants, helper fns). */
-    decls: string;
-    /** Optional replacement for the standard fs() prelude (custom alpha semantics). */
-    prelude?: string;
-    /** Tail of fs(): consumes `final_color` + template locals, writes FSOut. */
-    epilogue: string;
-};
-export declare const SLOT_TEMPLATES: Partial<Record<MaterialPreset, SlotTemplate>>;
-export declare function slotTemplate(slot: MaterialPreset): SlotTemplate;
+import type { AlphaMode, RenderClass } from "./render-class";
 export declare const STYLE_UNIFORMS_WGSL = "struct StyleUniforms { p: array<vec4f, 16> };\n@group(2) @binding(4) var<uniform> style: StyleUniforms;\n\n";
-export declare function assembleModule(slot: MaterialPreset, fsBody: string, includeStyleUniforms: boolean): string;
+/**
+ * Assemble a full WGSL module: shared node library + bindings/skinning prelude, optional
+ * StyleUniforms, render-class/alpha-mode declarations, the composed fs() shell, and the
+ * graph's node body.
+ */
+export declare function assembleModule(renderClass: RenderClass, alphaMode: AlphaMode, fsBody: string, includeStyleUniforms: boolean): string;
 //# sourceMappingURL=slots.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../src/graph/slots.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAA;AAE/C,MAAM,MAAM,YAAY,GAAG;IACzB,2EAA2E;IAC3E,KAAK,EAAE,MAAM,CAAA;IACb,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,CAAA;CACjB,CAAA;AAgHD,eAAO,MAAM,cAAc,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,YAAY,CAAC,CAIxE,CAAA;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,YAAY,CAE/D;AAID,eAAO,MAAM,mBAAmB,gHAG/B,CAAA;AAqBD,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,EAAE,OAAO,GAAG,MAAM,CAa1G"}
+{"version":3,"file":"slots.d.ts","sourceRoot":"","sources":["../../src/graph/slots.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAiD5D,eAAO,MAAM,mBAAmB,gHAG/B,CAAA;AAuDD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,MAAM,EACd,oBAAoB,EAAE,OAAO,GAC5B,MAAM,CAYR"}

package/dist/graph/slots.js

@@ -1,37 +1,20 @@
-// Per-slot WGSL templates. The graph computes only `final_color`; everything the slot
-// owns — texture sample, MMD alpha semantics, discard, lighting context, FSOut/mask
-// writes, and built-in pass effects like hair's over-eyes stencil variant — lives here,
-// always on, graph-invisible. Mirrors the hand-written material shaders line-for-line.
+// fs() shell assembly. The graph computes only `final_color`; everything around it —
+// texture sample, alpha discard, lighting context, built-in gates, and the FSOut/mask
+// write — is composed here from two orthogonal, engine-owned axes:
+//   RenderClass ("auto" | "eye" | "hair")  — stencil/cull/draw-order + eye rear-gate +
+//                                             hair over-eyes alpha. See render-class.ts.
+//   AlphaMode   ("opaque" | "hashed")       — standard threshold discard vs Wyman hashed.
+// A style group supplies both; this file turns them into the WGSL shell around fsBody.
+// See docs/style-groups-spec.md §5, §7.
 import { NODES_WGSL } from "../shaders/materials/nodes";
 import { COMMON_MATERIAL_PRELUDE_WGSL } from "../shaders/materials/common";
-const DEFAULT_EPILOGUE = `  var out: FSOut;
-  out.color = vec4f(final_color, alpha);
-  out.mask = vec4f(1.0, 1.0, 0.0, out.color.a);
-  return out;
-`;
-const DEFAULT_TEMPLATE = { decls: "", epilogue: DEFAULT_EPILOGUE };
-// Hair's built-in over-eyes effect (see hair.ts): the engine compiles two pipeline
-// variants from the same module — normal opaque hair, and a stencil-matched re-draw
-// at 25% alpha so eyes read through the silhouette. Always on for the hair slot.
-const HAIR_TEMPLATE = {
-    decls: `override IS_OVER_EYES: bool = false;
-
-`,
-    epilogue: `  var outAlpha = alpha;
-  if (IS_OVER_EYES) { outAlpha = alpha * 0.25; }
+// ── Module-scope declarations ──
+// hair: the over-eyes pipeline-override constant (a second pipeline is compiled with
+// IS_OVER_EYES=1). hashed: the Wyman & McGuire object-space hashed-alpha helpers.
+const HAIR_OVER_EYES_DECL = `override IS_OVER_EYES: bool = false;
 
-  var out: FSOut;
-  out.color = vec4f(final_color, outAlpha);
-  out.mask = vec4f(1.0, 1.0, 0.0, out.color.a);
-  return out;
-`,
-};
-// Stockings' built-in alpha behavior (see stockings.ts): Wyman & McGuire hashed
-// alpha testing on bind-pose restPos replaces the standard threshold discard —
-// sort-independent through self-overlap, dither pinned to the fabric. The graph
-// only computes final_color; the hash gate and the alpha=1 output are slot-owned.
-const STOCKINGS_TEMPLATE = {
-    decls: `fn _hash3d_wm(a: vec3f) -> f32 {
+`;
+const HASHED_ALPHA_DECLS = `fn _hash3d_wm(a: vec3f) -> f32 {
   return _hash33(a).x * 0.5 + 0.5;
 }
 fn hashed_alpha_threshold(co: vec3f) -> f32 {
@@ -56,84 +39,43 @@ fn hashed_alpha_threshold(co: vec3f) -> f32 {
   return clamp(threshold, 1e-6, 1.0);
 }
 
-`,
-    prelude: `@fragment fn fs(input: VertexOutput) -> FSOut {
-  let tex_s = textureSample(diffuseTexture, diffuseSampler, input.uv);
-  // Hashed alpha test (EEVEE "Hashed" blend) instead of the standard threshold.
-  let alpha = material.alpha * tex_s.a;
-  if (alpha < hashed_alpha_threshold(input.restPos)) { discard; }
-
-  let n = safe_normal(input.normal);
-  let v = normalize(camera.viewPos - input.worldPos);
-  let l = -light.lights[0].direction.xyz;
-  let sun = light.lights[0].color.xyz * light.lights[0].color.w;
-  let amb = light.ambientColor.xyz;
-  let shadow = sampleShadow(input.worldPos, n);
-  let tex_color = tex_s.rgb;
-
-`,
-    epilogue: `  var out: FSOut;
-  out.color = vec4f(final_color, 1.0);
-  out.mask = vec4f(1.0, 1.0, 0.0, out.color.a);
-  return out;
-`,
-};
-// Eye's built-in rear-view gate (see eye.ts): open-shell PMX heads don't occlude
-// the eye from behind, so it would draw (and stamp the see-through stencil) through
-// the back of the head. Gate by camera-vs-face hemisphere via the 頭 bone's skinning
-// matrix. Discarding here drops color, depth, and the stencil stamp together. The
-// stencil-stamp pipeline state + front-face cull are slot-owned in createSlotPipeline;
-// the graph only computes the eye's shading (Principled + emission).
-const EYE_TEMPLATE = {
-    decls: "",
-    prelude: `@fragment fn fs(input: VertexOutput) -> FSOut {
-  let tex_s = textureSample(diffuseTexture, diffuseSampler, input.uv);
-  let alpha = material.alpha * tex_s.a;
-  if (alpha < 0.001) { discard; }
-
-  let n = safe_normal(input.normal);
-  let v = normalize(camera.viewPos - input.worldPos);
-
+`;
+// Eye's built-in rear-view gate (open-shell PMX heads don't occlude the eye from behind,
+// so gate by camera-vs-face hemisphere via the 頭 bone; discard drops color + depth +
+// the stencil stamp together). Injected between the view vectors and the lighting setup.
+const EYE_REAR_GATE = `
   if (material.headBoneIndex >= 0.0) {
     let hm = skinMats[u32(material.headBoneIndex)];
     let faceDir = -normalize(hm[2].xyz);
     if (dot(faceDir, v) < -0.15) { discard; }
   }
-
-  let l = -light.lights[0].direction.xyz;
-  let sun = light.lights[0].color.xyz * light.lights[0].color.w;
-  let amb = light.ambientColor.xyz;
-  let shadow = sampleShadow(input.worldPos, n);
-  let tex_color = tex_s.rgb;
-
-`,
-    epilogue: DEFAULT_EPILOGUE,
-};
-export const SLOT_TEMPLATES = {
-    hair: HAIR_TEMPLATE,
-    stockings: STOCKINGS_TEMPLATE,
-    eye: EYE_TEMPLATE,
-};
-export function slotTemplate(slot) {
-    return SLOT_TEMPLATES[slot] ?? DEFAULT_TEMPLATE;
-}
-// Adjust-tier uniforms — fixed 16-vec4f block (256 B) so the single shared material
-// bind group layout serves every graph; non-graph presets bind a zero buffer.
+`;
+// ── Adjust-tier uniforms — fixed 16-vec4f block (256 B) shared by the single material
+// bind group layout; non-graph draws bind a zero buffer. ──
 export const STYLE_UNIFORMS_WGSL = `struct StyleUniforms { p: array<vec4f, 16> };
 @group(2) @binding(4) var<uniform> style: StyleUniforms;
 
 `;
-// fs() prelude — identical to the hand-written materials so template locals keep the
-// exact names the registry's context nodes and emit functions reference.
-const FS_PRELUDE = `@fragment fn fs(input: VertexOutput) -> FSOut {
+function decls(renderClass, alphaMode) {
+    return (alphaMode === "hashed" ? HASHED_ALPHA_DECLS : "") + (renderClass === "hair" ? HAIR_OVER_EYES_DECL : "");
+}
+// fs() header up to and including the graph body's context locals. Composed so the
+// hand-written material shaders' local names (tex_color, n, v, l, sun, amb, shadow) are
+// preserved exactly — the registry's context nodes and emit functions reference them.
+function prelude(renderClass, alphaMode) {
+    const discard = alphaMode === "hashed"
+        ? "  if (alpha < hashed_alpha_threshold(input.restPos)) { discard; }"
+        : "  if (alpha < 0.001) { discard; }";
+    const gate = renderClass === "eye" ? EYE_REAR_GATE : "";
+    return `@fragment fn fs(input: VertexOutput) -> FSOut {
   let tex_s = textureSample(diffuseTexture, diffuseSampler, input.uv);
-  // MMD alpha semantics: material alpha × texture alpha (hair/lace textures cut
-  // their shapes in the alpha channel).
+  // MMD alpha semantics: material alpha × texture alpha.
   let alpha = material.alpha * tex_s.a;
-  if (alpha < 0.001) { discard; }
+${discard}
 
   let n = safe_normal(input.normal);
   let v = normalize(camera.viewPos - input.worldPos);
+${gate}
   let l = -light.lights[0].direction.xyz;
   let sun = light.lights[0].color.xyz * light.lights[0].color.w;
   let amb = light.ambientColor.xyz;
@@ -141,15 +83,41 @@ const FS_PRELUDE = `@fragment fn fs(input: VertexOutput) -> FSOut {
   let tex_color = tex_s.rgb;
 
 `;
-export function assembleModule(slot, fsBody, includeStyleUniforms) {
-    const tmpl = slotTemplate(slot);
+}
+// Tail of fs(): consumes `final_color` + locals, writes FSOut. hashed forces output
+// alpha to 1 (the discard already did the cutout); hair scales alpha for the over-eyes
+// pass when IS_OVER_EYES is compiled true.
+function epilogue(renderClass, alphaMode) {
+    const alphaBase = alphaMode === "hashed" ? "1.0" : "alpha";
+    if (renderClass === "hair") {
+        return `  var outAlpha = ${alphaBase};
+  if (IS_OVER_EYES) { outAlpha = ${alphaBase} * 0.25; }
+
+  var out: FSOut;
+  out.color = vec4f(final_color, outAlpha);
+  out.mask = vec4f(1.0, 1.0, 0.0, out.color.a);
+  return out;
+`;
+    }
+    return `  var out: FSOut;
+  out.color = vec4f(final_color, ${alphaBase});
+  out.mask = vec4f(1.0, 1.0, 0.0, out.color.a);
+  return out;
+`;
+}
+/**
+ * Assemble a full WGSL module: shared node library + bindings/skinning prelude, optional
+ * StyleUniforms, render-class/alpha-mode declarations, the composed fs() shell, and the
+ * graph's node body.
+ */
+export function assembleModule(renderClass, alphaMode, fsBody, includeStyleUniforms) {
     return (NODES_WGSL +
         COMMON_MATERIAL_PRELUDE_WGSL +
         (includeStyleUniforms ? STYLE_UNIFORMS_WGSL : "") +
-        tmpl.decls +
-        (tmpl.prelude ?? FS_PRELUDE) +
+        decls(renderClass, alphaMode) +
+        prelude(renderClass, alphaMode) +
         fsBody +
         "\n" +
-        tmpl.epilogue +
+        epilogue(renderClass, alphaMode) +
         "}\n");
 }

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

@@ -0,0 +1,38 @@
+import type { Diagnostic, StyleGraph } from "./schema";
+import type { AlphaMode, RenderClass } from "./render-class";
+import type { StyleSlot } from "./compile";
+export type StyleGroup = {
+    /** Stable, unique within a model; /^[a-z0-9_-]+$/. The engine keys installs by this. */
+    id: string;
+    /** Human display name ("Skirt", "Visor"); host-owned, round-tripped, never interpreted
+     *  by the engine. Defaults to `id`. */
+    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;
+    /** Pass-integration class: stencil/cull/draw-order. Default "auto". */
+    renderClass?: RenderClass;
+    /** Alpha-handling axis, orthogonal to renderClass. Default "opaque". */
+    alphaMode?: AlphaMode;
+};
+export type GroupDiagnostic = {
+    groupId: string;
+    diagnostics: Diagnostic[];
+    ok: boolean;
+};
+export type ApplyStyleGroupsResult = {
+    /** Every group compiled + swapped. */
+    ok: boolean;
+    groups: GroupDiagnostic[];
+    /** Names in a group that no model material matches (warning). */
+    unknownMaterials: string[];
+    /** Materials claimed by >1 group; the last group in array order wins (logged). */
+    conflicts: string[];
+};
+export type ApplyStyleGroupResult = {
+    ok: boolean;
+    diagnostics: Diagnostic[];
+    slotMap: StyleSlot[];
+};
+//# sourceMappingURL=style-group.d.ts.map

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

@@ -0,0 +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"}

package/dist/graph/style-group.js

@@ -0,0 +1,6 @@
+// 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
+// (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.
+export {};

package/dist/index.d.ts

@@ -1,8 +1,10 @@
-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 ApplyStyleResult, type GizmoDragEvent, type GizmoDragCallback, type GizmoDragKind, } from "./engine";
+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";

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,gBAAgB,EACrB,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,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,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"}

package/dist/index.js

@@ -2,6 +2,7 @@ export { Engine, DEFAULT_BLOOM_OPTIONS, DEFAULT_VIEW_TRANSFORM, } from "./engine
 export { parsePmxFolderInput, pmxFileAtRelativePath } from "./folder-upload";
 export { compileGraph, validateGraph, assignStyleSlots, } from "./graph/compile";
 export { NODE_REGISTRY } from "./graph/registry";
+export { RENDER_CLASSES } from "./graph/render-class";
 export { HAIR_GRAPH } from "./graph/presets/hair";
 export { DEFAULT_GRAPH } from "./graph/presets/default";
 export { CLOTH_SMOOTH_GRAPH } from "./graph/presets/cloth_smooth";

package/package.json

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