@triforge/shader-core 0.2.0 → 0.3.0

package/dist/bundle.js

@@ -84,6 +84,12 @@ var OutputSocket = class {
 };
 
 // src/core/ShaderNode.ts
+function finiteOr(value, fallback) {
+  return Number.isFinite(value) ? value : fallback;
+}
+function sanitizeVec3(v) {
+  return [finiteOr(v[0], 0), finiteOr(v[1], 0), finiteOr(v[2], 0)];
+}
 function hexToRgb(hex) {
   const h = hex.replace("#", "");
   return [
@@ -133,6 +139,15 @@ var ShaderNode = class {
   vertexInjections() {
     return [];
   }
+  /**
+   * Whether this node's contribution to the compiled material requires
+   * `transparent: true` on the resulting THREE.ShaderMaterial (e.g. a
+   * `shader`-socket alpha channel that can read below 1.0).
+   * Override in nodes that carry alpha semantics — see PrincipledBSDF.
+   */
+  wantsTransparency() {
+    return false;
+  }
   /**
    * Returns the named output socket.
    * Throws ShaderNodeError if the socket does not exist.
@@ -178,14 +193,14 @@ var ShaderNode = class {
       if (type === "float" && typeof literal === "number") {
         socket.uniformName = `u_${this.id}_${name}`;
         this._uniformMap.set(name, socket.uniformName);
-        this.parameters[name] = literal;
+        this.parameters[name] = finiteOr(literal, 0);
       }
       if (type === "color" && !(value instanceof OutputSocket)) {
         if (typeof literal === "string" || Array.isArray(literal)) {
           socket.uniformName = `u_${this.id}_${name}`;
           this._uniformMap.set(name, socket.uniformName);
           this._colorParams.add(name);
-          this.parameters[name] = typeof literal === "string" ? hexToRgb(literal) : literal;
+          this.parameters[name] = typeof literal === "string" ? hexToRgb(literal) : sanitizeVec3(literal);
         }
       }
       sockets[name] = socket;
@@ -217,7 +232,7 @@ var ShaderNode = class {
           Object.defineProperty(this.parameters, paramName, {
             get: () => uniforms[uniformName].value,
             set: (v) => {
-              uniforms[uniformName].value = v;
+              uniforms[uniformName].value = sanitizeVec3(v);
             },
             enumerable: true,
             configurable: true
@@ -226,7 +241,7 @@ var ShaderNode = class {
           Object.defineProperty(this.parameters, paramName, {
             get: () => uniforms[uniformName].value,
             set: (v) => {
-              uniforms[uniformName].value = v;
+              uniforms[uniformName].value = finiteOr(v, 0);
             },
             enumerable: true,
             configurable: true
@@ -289,7 +304,8 @@ var CompileContext = class _CompileContext {
       vertexShader: this.buildVertexShader(),
       fragmentShader: this.buildFragmentShader(),
       uniforms: this._uniforms,
-      nodes: this.order
+      nodes: this.order,
+      needsTransparency: this.order.some((node) => node.wantsTransparency())
     };
   }
   /**
@@ -309,12 +325,23 @@ var CompileContext = class _CompileContext {
   resolveInput(socket) {
     if (socket.connection) {
       const varName = this.outputVar(socket.connection.node, socket.connection.name);
-      if (socket.type === "vector" && socket.connection.type !== "vector") {
+      const fromType = socket.connection.type;
+      const toType = socket.type;
+      if (toType === "vector" && fromType !== "vector") {
         return `(${varName}).xy`;
       }
-      if (socket.type === "color" && socket.connection.type === "vector") {
+      if (toType === "color" && fromType === "vector") {
         return `vec3(${varName}, 0.0)`;
       }
+      if (toType === "color" && fromType === "shader") {
+        return `(${varName}).rgb`;
+      }
+      if (toType === "shader" && fromType === "color") {
+        return `vec4(${varName}, 1.0)`;
+      }
+      if (toType === "shader" && fromType === "vector") {
+        return `vec4(${varName}, 0.0, 1.0)`;
+      }
       return varName;
     }
     if (socket.uniformName !== null) {
@@ -322,9 +349,10 @@ var CompileContext = class _CompileContext {
         if (socket.type === "color") {
           const raw = socket.defaultValue;
           const rgb = typeof raw === "string" ? _CompileContext.hexToRgbArray(raw) : Array.isArray(raw) ? raw : [1, 1, 1];
-          this._uniforms[socket.uniformName] = { value: rgb };
+          this._uniforms[socket.uniformName] = { value: rgb.map((n) => Number.isFinite(n) ? n : 0) };
         } else {
-          this._uniforms[socket.uniformName] = { value: socket.defaultValue };
+          const n = socket.defaultValue;
+          this._uniforms[socket.uniformName] = { value: Number.isFinite(n) ? n : 0 };
         }
       }
       return socket.uniformName;
@@ -429,7 +457,7 @@ var CompileContext = class _CompileContext {
     if (from === to) return true;
     if ((from === "shader" || from === "color") && (to === "shader" || to === "color")) return true;
     if ((from === "color" || from === "shader") && to === "vector") return true;
-    if (from === "vector" && to === "color") return true;
+    if (from === "vector" && (to === "color" || to === "shader")) return true;
     return false;
   }
   // ── GLSL builders ─────────────────────────────────────────────────
@@ -478,14 +506,16 @@ ${callsBlock}
   // ── Literal conversion ────────────────────────────────────────────
   toLiteral(value, type) {
     switch (type) {
-      case "float":
-        return (typeof value === "number" ? value : 0).toFixed(4);
+      case "float": {
+        const n = typeof value === "number" && Number.isFinite(value) ? value : 0;
+        return n.toFixed(4);
+      }
       case "color":
         return typeof value === "string" ? this.hexToVec3(value) : "vec3(1.0, 1.0, 1.0)";
       case "vector":
         return "vec2(vUv)";
       case "shader":
-        return "vec3(0.0)";
+        return "vec4(0.0, 0.0, 0.0, 1.0)";
       default:
         return "vec3(1.0)";
     }
@@ -544,7 +574,8 @@ var OutputNode = class extends ShaderNode {
     this.material = new ShaderMaterial({
       vertexShader: compiled.vertexShader,
       fragmentShader: compiled.fragmentShader,
-      uniforms: compiled.uniforms
+      uniforms: compiled.uniforms,
+      transparent: compiled.needsTransparency
     });
     if (!this.material.uniforms.uSunDirection) {
       this.material.uniforms.uSunDirection = { value: new Vector3(1, 2, 1).normalize() };
@@ -568,7 +599,7 @@ var ProcessNode = class extends ShaderNode {
 
 // src/core/SocketType.ts
 var SOCKET_GLSL_TYPE = {
-  shader: "vec3",
+  shader: "vec4",
   color: "vec3",
   vector: "vec2",
   float: "float"
@@ -1222,8 +1253,8 @@ var MaterialOutput = class extends OutputNode {
     return mat;
   }
   compileCall(ctx) {
-    const sv = this._inputs.surface.isConnected() ? ctx.outputVar(this._inputs.surface.connection.node, this._inputs.surface.connection.name) : "vec3(0.8)";
-    return `gl_FragColor = vec4(${sv}, 1.0);`;
+    const sv = this._inputs.surface.isConnected() ? ctx.outputVar(this._inputs.surface.connection.node, this._inputs.surface.connection.name) : "vec4(0.8, 0.8, 0.8, 1.0)";
+    return `gl_FragColor = ${sv};`;
   }
 };
 
@@ -3372,7 +3403,7 @@ float _st_geo(float NdotX, float r) {
   float k = (r + 1.0) * (r + 1.0) / 8.0;
   return NdotX / max(NdotX * (1.0 - k) + k, 1e-7);
 }
-vec3 _st_principledBSDF(vec3 base, float metallic, float roughness, float ior, float alpha, vec3 N) {
+vec3 _st_principledBSDF(vec3 base, float metallic, float roughness, float ior, vec3 N) {
   vec3  V     = normalize(cameraPosition - vPosition);
   vec3  L     = normalize(uSunDirection);
   vec3  H     = normalize(L + V);
@@ -3413,9 +3444,23 @@ vec3 _st_principledBSDF(vec3 base, float metallic, float roughness, float ior, f
   compileDefs() {
     return this.glslFunction ?? _PrincipledBSDF.glslFunction;
   }
+  /**
+   * Alpha has no channel of its own in the underlying vec3 lighting function —
+   * it's applied as the vec4 alpha component at the call site instead (see
+   * compileCall). transparent:true is needed whenever alpha can read below 1.0:
+   * a non-default literal, or any live/connected value (conservatively true).
+   */
+  wantsTransparency() {
+    const alphaSocket = this._inputs.alpha;
+    if (alphaSocket.isConnected()) return true;
+    const v = alphaSocket.defaultValue;
+    return typeof v === "number" && v < 1;
+  }
   compileCall(ctx) {
     const normal = this._inputs.normal.isConnected() ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name) : "normalize(vNormal)";
-    return `vec3 ${ctx.outputVar(this, "BSDF")} = _st_principledBSDF(${ctx.resolveInput(this._inputs.baseColor)}, ${ctx.resolveInput(this._inputs.metallic)}, ${ctx.resolveInput(this._inputs.roughness)}, ${ctx.resolveInput(this._inputs.ior)}, ${ctx.resolveInput(this._inputs.alpha)}, ${normal});`;
+    const rgb = `_st_principledBSDF(${ctx.resolveInput(this._inputs.baseColor)}, ${ctx.resolveInput(this._inputs.metallic)}, ${ctx.resolveInput(this._inputs.roughness)}, ${ctx.resolveInput(this._inputs.ior)}, ${normal})`;
+    const alpha = ctx.resolveInput(this._inputs.alpha);
+    return `vec4 ${ctx.outputVar(this, "BSDF")} = vec4(${rgb}, ${alpha});`;
   }
 };
 
@@ -3456,7 +3501,7 @@ vec3 _st_emission(vec3 color, float strength) {
   compileCall(ctx) {
     const color = ctx.resolveInput(this._inputs.color);
     const strength = ctx.resolveInput(this._inputs.strength);
-    return `vec3 ${ctx.outputVar(this, "BSDF")} = _st_emission(${color}, ${strength});`;
+    return `vec4 ${ctx.outputVar(this, "BSDF")} = vec4(_st_emission(${color}, ${strength}), 1.0);`;
   }
 };
 
@@ -3497,7 +3542,7 @@ vec3 _st_volumeAbsorption(vec3 color, float density) {
   compileCall(ctx) {
     const color = ctx.resolveInput(this._inputs.color);
     const density = ctx.resolveInput(this._inputs.density);
-    return `vec3 ${ctx.outputVar(this, "Volume")} = _st_volumeAbsorption(${color}, ${density});`;
+    return `vec4 ${ctx.outputVar(this, "Volume")} = vec4(_st_volumeAbsorption(${color}, ${density}), 1.0);`;
   }
 };
 
@@ -3544,7 +3589,7 @@ vec3 _st_volumeScatter(vec3 color, float density, float anisotropy) {
     const color = ctx.resolveInput(this._inputs.color);
     const density = ctx.resolveInput(this._inputs.density);
     const anisotropy = ctx.resolveInput(this._inputs.anisotropy);
-    return `vec3 ${ctx.outputVar(this, "Volume")} = _st_volumeScatter(${color}, ${density}, ${anisotropy});`;
+    return `vec4 ${ctx.outputVar(this, "Volume")} = vec4(_st_volumeScatter(${color}, ${density}, ${anisotropy}), 1.0);`;
   }
 };
 
@@ -3615,7 +3660,7 @@ vec3 _st_principledVolume(
     const emissionStrength = ctx.resolveInput(this._inputs.emissionStrength);
     const blackbodyIntensity = ctx.resolveInput(this._inputs.blackbodyIntensity);
     const temperature = ctx.resolveInput(this._inputs.temperature);
-    return `vec3 ${ctx.outputVar(this, "Volume")} = _st_principledVolume(${color}, ${density}, ${anisotropy}, ${absorptionColor}, ${emissionColor}, ${emissionStrength}, ${blackbodyIntensity}, ${temperature});`;
+    return `vec4 ${ctx.outputVar(this, "Volume")} = vec4(_st_principledVolume(${color}, ${density}, ${anisotropy}, ${absorptionColor}, ${emissionColor}, ${emissionStrength}, ${blackbodyIntensity}, ${temperature}), 1.0);`;
   }
 };
 
@@ -3637,7 +3682,7 @@ var MixShader = class _MixShader extends ProcessNode {
   }
   static {
     this.glslFunction = `
-vec3 _st_mixShader(float fac, vec3 a, vec3 b) {
+vec4 _st_mixShader(float fac, vec4 a, vec4 b) {
   return mix(a, b, clamp(fac, 0.0, 1.0));
 }`;
   }
@@ -3663,7 +3708,7 @@ vec3 _st_mixShader(float fac, vec3 a, vec3 b) {
     const fac = ctx.resolveInput(this._inputs.fac);
     const shader1 = ctx.resolveInput(this._inputs.shader1);
     const shader2 = ctx.resolveInput(this._inputs.shader2);
-    return `vec3 ${ctx.outputVar(this, "BSDF")} = _st_mixShader(${fac}, ${shader1}, ${shader2});`;
+    return `vec4 ${ctx.outputVar(this, "BSDF")} = _st_mixShader(${fac}, ${shader1}, ${shader2});`;
   }
 };
 
@@ -3680,8 +3725,8 @@ var AddShader = class _AddShader extends ProcessNode {
   }
   static {
     this.glslFunction = `
-vec3 _st_addShader(vec3 a, vec3 b) {
-  return a + b;
+vec4 _st_addShader(vec4 a, vec4 b) {
+  return vec4(a.rgb + b.rgb, max(a.a, b.a));
 }`;
   }
   constructor(inputs = {}) {
@@ -3704,7 +3749,7 @@ vec3 _st_addShader(vec3 a, vec3 b) {
   compileCall(ctx) {
     const s1 = ctx.resolveInput(this._inputs.shader1);
     const s2 = ctx.resolveInput(this._inputs.shader2);
-    return `vec3 ${ctx.outputVar(this, "BSDF")} = _st_addShader(${s1}, ${s2});`;
+    return `vec4 ${ctx.outputVar(this, "BSDF")} = _st_addShader(${s1}, ${s2});`;
   }
 };
 
@@ -3801,7 +3846,7 @@ vec3 _st_diffuseBSDF(vec3 color, float roughness, vec3 N) {
     const color = ctx.resolveInput(this._inputs.color);
     const roughness = ctx.resolveInput(this._inputs.roughness);
     const normal = this._inputs.normal.isConnected() ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name) : "normalize(vNormal)";
-    return `vec3 ${ctx.outputVar(this, "BSDF")} = _st_diffuseBSDF(${color}, ${roughness}, ${normal});`;
+    return `vec4 ${ctx.outputVar(this, "BSDF")} = vec4(_st_diffuseBSDF(${color}, ${roughness}, ${normal}), 1.0);`;
   }
 };
 
@@ -3855,7 +3900,7 @@ vec3 _st_glossyBSDF(vec3 color, float roughness, vec3 N) {
     const color = ctx.resolveInput(this._inputs.color);
     const roughness = ctx.resolveInput(this._inputs.roughness);
     const normal = this._inputs.normal.isConnected() ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name) : "normalize(vNormal)";
-    return `vec3 ${ctx.outputVar(this, "BSDF")} = _st_glossyBSDF(${color}, ${roughness}, ${normal});`;
+    return `vec4 ${ctx.outputVar(this, "BSDF")} = vec4(_st_glossyBSDF(${color}, ${roughness}, ${normal}), 1.0);`;
   }
 };
 
@@ -3904,7 +3949,7 @@ vec3 _st_refractionBSDF(vec3 color, float roughness, float ior, vec3 N) {
     const roughness = ctx.resolveInput(this._inputs.roughness);
     const ior = ctx.resolveInput(this._inputs.ior);
     const normal = this._inputs.normal.isConnected() ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name) : "normalize(vNormal)";
-    return `vec3 ${ctx.outputVar(this, "BSDF")} = _st_refractionBSDF(${color}, ${roughness}, ${ior}, ${normal});`;
+    return `vec4 ${ctx.outputVar(this, "BSDF")} = vec4(_st_refractionBSDF(${color}, ${roughness}, ${ior}, ${normal}), 1.0);`;
   }
 };
 
@@ -3959,7 +4004,7 @@ vec3 _st_glassBSDF(vec3 color, float roughness, float ior, vec3 N) {
     const roughness = ctx.resolveInput(this._inputs.roughness);
     const ior = ctx.resolveInput(this._inputs.ior);
     const normal = this._inputs.normal.isConnected() ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name) : "normalize(vNormal)";
-    return `vec3 ${ctx.outputVar(this, "BSDF")} = _st_glassBSDF(${color}, ${roughness}, ${ior}, ${normal});`;
+    return `vec4 ${ctx.outputVar(this, "BSDF")} = vec4(_st_glassBSDF(${color}, ${roughness}, ${ior}, ${normal}), 1.0);`;
   }
 };
 
@@ -4011,7 +4056,7 @@ vec3 _st_sheenBSDF(vec3 color, float roughness, vec3 N) {
     const color = ctx.resolveInput(this._inputs.color);
     const roughness = ctx.resolveInput(this._inputs.roughness);
     const normal = this._inputs.normal.isConnected() ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name) : "normalize(vNormal)";
-    return `vec3 ${ctx.outputVar(this, "BSDF")} = _st_sheenBSDF(${color}, ${roughness}, ${normal});`;
+    return `vec4 ${ctx.outputVar(this, "BSDF")} = vec4(_st_sheenBSDF(${color}, ${roughness}, ${normal}), 1.0);`;
   }
 };
 
@@ -4060,7 +4105,7 @@ vec3 _st_sss(vec3 color, float scale, vec3 radius, vec3 N) {
     const scale = ctx.resolveInput(this._inputs.scale);
     const [r, g, b] = this.radius;
     const normal = this._inputs.normal.isConnected() ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name) : "normalize(vNormal)";
-    return `vec3 ${ctx.outputVar(this, "BSDF")} = _st_sss(${color}, ${scale}, vec3(${r.toFixed(4)}, ${g.toFixed(4)}, ${b.toFixed(4)}), ${normal});`;
+    return `vec4 ${ctx.outputVar(this, "BSDF")} = vec4(_st_sss(${color}, ${scale}, vec3(${r.toFixed(4)}, ${g.toFixed(4)}, ${b.toFixed(4)}), ${normal}), 1.0);`;
   }
 };
 
@@ -4108,7 +4153,7 @@ vec3 _st_toonBSDF(vec3 color, float size, float smoothWidth, vec3 N) {
     const size = ctx.resolveInput(this._inputs.size);
     const smoothWidth = ctx.resolveInput(this._inputs.smooth);
     const normal = this._inputs.normal.isConnected() ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name) : "normalize(vNormal)";
-    return `vec3 ${ctx.outputVar(this, "BSDF")} = _st_toonBSDF(${color}, ${size}, ${smoothWidth}, ${normal});`;
+    return `vec4 ${ctx.outputVar(this, "BSDF")} = vec4(_st_toonBSDF(${color}, ${size}, ${smoothWidth}, ${normal}), 1.0);`;
   }
 };
 
@@ -4165,7 +4210,7 @@ vec3 _st_specularBSDF(vec3 base, vec3 spec, float roughness, vec3 N) {
     const spec = ctx.resolveInput(this._inputs.specular);
     const roughness = ctx.resolveInput(this._inputs.roughness);
     const normal = this._inputs.normal.isConnected() ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name) : "normalize(vNormal)";
-    return `vec3 ${ctx.outputVar(this, "BSDF")} = _st_specularBSDF(${base}, ${spec}, ${roughness}, ${normal});`;
+    return `vec4 ${ctx.outputVar(this, "BSDF")} = vec4(_st_specularBSDF(${base}, ${spec}, ${roughness}, ${normal}), 1.0);`;
   }
 };
 
@@ -4208,7 +4253,7 @@ vec3 _st_translucentBSDF(vec3 color, vec3 N) {
   compileCall(ctx) {
     const color = ctx.resolveInput(this._inputs.color);
     const normal = this._inputs.normal.isConnected() ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name) : "normalize(vNormal)";
-    return `vec3 ${ctx.outputVar(this, "BSDF")} = _st_translucentBSDF(${color}, ${normal});`;
+    return `vec4 ${ctx.outputVar(this, "BSDF")} = vec4(_st_translucentBSDF(${color}, ${normal}), 1.0);`;
   }
 };
 
@@ -4340,7 +4385,7 @@ vec3 _st_principledHair(
     const randomRoughness = ctx.resolveInput(this._inputs.randomRoughness);
     const random = ctx.resolveInput(this._inputs.random);
     const tangent = this._inputs.tangent.isConnected() ? ctx.outputVar(this._inputs.tangent.connection.node, this._inputs.tangent.connection.name) : "normalize(vStrandTangent)";
-    return `vec3 ${ctx.outputVar(this, "BSDF")} = _st_principledHair(${color}, ${roughness}, ${radialRoughness}, ${coat}, ${ior}, ${offset}, ${randomColor}, ${randomRoughness}, ${random}, ${tangent});`;
+    return `vec4 ${ctx.outputVar(this, "BSDF")} = vec4(_st_principledHair(${color}, ${roughness}, ${radialRoughness}, ${coat}, ${ior}, ${offset}, ${randomColor}, ${randomRoughness}, ${random}, ${tangent}), 1.0);`;
   }
 };
 
@@ -4655,8 +4700,8 @@ var ShaderToRGB = class extends ProcessNode {
     const cv = ctx.outputVar(this, "Color");
     const av = ctx.outputVar(this, "Alpha");
     return [
-      `vec3  ${cv} = ${shader};`,
-      `float ${av} = 1.0;`
+      `vec3  ${cv} = (${shader}).rgb;`,
+      `float ${av} = (${shader}).a;`
     ].join("\n  ");
   }
 };
@@ -4942,11 +4987,13 @@ var ShaderScript = class extends ProcessNode {
   _socketGlslType(type) {
     if (type === "float") return "float";
     if (type === "vector") return "vec2";
+    if (type === "shader") return "vec4";
     return "vec3";
   }
   _declGlslType(type) {
     if (type === "float") return "float";
     if (type === "vector") return "vec2";
+    if (type === "shader") return "vec4";
     return "vec3";
   }
 };
@@ -5528,7 +5575,7 @@ var RayPortal = class extends ProcessNode {
     const color = ctx.resolveInput(this._inputs.color);
     const rawBlend = this.parameters.blend;
     const blend = Number.isFinite(rawBlend) ? Math.min(Math.max(rawBlend, 0), 1).toFixed(4) : "1.0000";
-    return `vec3 ${ctx.outputVar(this, "BSDF")} = ${color} * ${blend};`;
+    return `vec4 ${ctx.outputVar(this, "BSDF")} = vec4(${color} * ${blend}, 1.0);`;
   }
 };
 export {

package/dist/core/CompileContext.d.ts

@@ -8,6 +8,8 @@ export interface CompiledMaterial {
         value: unknown;
     }>;
     nodes: ShaderNode[];
+    /** True when any node in the graph carries alpha that can read below 1.0 (see ShaderNode.wantsTransparency). */
+    needsTransparency: boolean;
 }
 /**
  * Walks the node graph from an OutputNode, validates all connections,

package/dist/core/CompileContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CompileContext.d.ts","sourceRoot":"","sources":["../../src/core/CompileContext.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAI,MAAM,CAAA;IACtB,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,EAAQ,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IAClD,KAAK,EAAW,UAAU,EAAE,CAAA;CAC7B;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAqD;IACpE,OAAO,CAAC,QAAQ,CAAoD;IACpE,OAAO,CAAC,KAAK,CAAgD;IAC7D,OAAO,CAAC,WAAW,CAAiD;IACpE,OAAO,CAAC,IAAI,CAAiD;IAC7D,OAAO,CAAC,KAAK,CAAgD;IAC7D,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,SAAS,CAAuD;IACxE,0FAA0F;IAC1F,OAAO,CAAC,iBAAiB,CAAiE;IAI1F,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,gBAAgB;IAcjD;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAKvD;;;;;OAKG;IACH,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,MAAM;IAgClD,OAAO,CAAC,KAAK;IA8Bb,OAAO,CAAC,IAAI;IAyBZ,OAAO,CAAC,QAAQ;IA0BhB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,YAAY;IAsCpB,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,wBAAwB;IAMhC,OAAO,CAAC,mBAAmB;IA2B3B,OAAO,CAAC,SAAS;IAqBjB,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAS3D,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAQrC,OAAO,CAAC,SAAS;CAGlB"}
+{"version":3,"file":"CompileContext.d.ts","sourceRoot":"","sources":["../../src/core/CompileContext.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAO,MAAM,CAAA;IACzB,cAAc,EAAK,MAAM,CAAA;IACzB,QAAQ,EAAW,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,CAAA;IACrD,KAAK,EAAc,UAAU,EAAE,CAAA;IAC/B,gHAAgH;IAChH,iBAAiB,EAAE,OAAO,CAAA;CAC3B;AAED;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAqD;IACpE,OAAO,CAAC,QAAQ,CAAoD;IACpE,OAAO,CAAC,KAAK,CAAgD;IAC7D,OAAO,CAAC,WAAW,CAAiD;IACpE,OAAO,CAAC,IAAI,CAAiD;IAC7D,OAAO,CAAC,KAAK,CAAgD;IAC7D,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,SAAS,CAAuD;IACxE,0FAA0F;IAC1F,OAAO,CAAC,iBAAiB,CAAiE;IAI1F,OAAO,CAAC,UAAU,EAAE,UAAU,GAAG,gBAAgB;IAejD;;;OAGG;IACH,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAKvD;;;;;OAKG;IACH,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,GAAG,MAAM;IAgDlD,OAAO,CAAC,KAAK;IA8Bb,OAAO,CAAC,IAAI;IAyBZ,OAAO,CAAC,QAAQ;IA0BhB,OAAO,CAAC,QAAQ;IAKhB,OAAO,CAAC,YAAY;IAsCpB,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,wBAAwB;IAMhC,OAAO,CAAC,mBAAmB;IA2B3B,OAAO,CAAC,SAAS;IAwBjB,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAS3D,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAQrC,OAAO,CAAC,SAAS;CAGlB"}

package/dist/core/CompileContext.js

@@ -35,6 +35,7 @@ export class CompileContext {
             fragmentShader: this.buildFragmentShader(),
             uniforms: this._uniforms,
             nodes: this.order,
+            needsTransparency: this.order.some(node => node.wantsTransparency()),
         };
     }
     /**
@@ -54,14 +55,28 @@ export class CompileContext {
     resolveInput(socket) {
         if (socket.connection) {
             const varName = this.outputVar(socket.connection.node, socket.connection.name);
-            // vec3 (color/shader) → vec2 (vector) implicit conversion, e.g. Mapping.Vector → ImageTexture.vector
-            if (socket.type === 'vector' && socket.connection.type !== 'vector') {
+            const fromType = socket.connection.type;
+            const toType = socket.type;
+            // vec3/vec4 (color/shader) → vec2 (vector) implicit narrowing, e.g. Mapping.Vector → ImageTexture.vector
+            if (toType === 'vector' && fromType !== 'vector') {
                 return `(${varName}).xy`;
             }
-            // vec2 (vector) → vec3 (color) implicit conversion, e.g. TextureCoordinate.UV → Mapping.vector
-            if (socket.type === 'color' && socket.connection.type === 'vector') {
+            // vec2 (vector) → vec3 (color) implicit widening, e.g. TextureCoordinate.UV → Mapping.vector
+            if (toType === 'color' && fromType === 'vector') {
                 return `vec3(${varName}, 0.0)`;
             }
+            // vec4 (shader) → vec3 (color) implicit narrowing — drop alpha, e.g. ShaderToRGB-style consumption
+            if (toType === 'color' && fromType === 'shader') {
+                return `(${varName}).rgb`;
+            }
+            // vec3 (color) → vec4 (shader) implicit widening — opaque alpha
+            if (toType === 'shader' && fromType === 'color') {
+                return `vec4(${varName}, 1.0)`;
+            }
+            // vec2 (vector) → vec4 (shader) implicit widening — opaque alpha
+            if (toType === 'shader' && fromType === 'vector') {
+                return `vec4(${varName}, 0.0, 1.0)`;
+            }
             return varName;
         }
         if (socket.uniformName !== null) {
@@ -71,10 +86,12 @@ export class CompileContext {
                     const rgb = typeof raw === 'string'
                         ? CompileContext.hexToRgbArray(raw)
                         : (Array.isArray(raw) ? raw : [1, 1, 1]);
-                    this._uniforms[socket.uniformName] = { value: rgb };
+                    // Guard against NaN/Infinity reaching the GPU uniform.
+                    this._uniforms[socket.uniformName] = { value: rgb.map(n => Number.isFinite(n) ? n : 0) };
                 }
                 else {
-                    this._uniforms[socket.uniformName] = { value: socket.defaultValue };
+                    const n = socket.defaultValue;
+                    this._uniforms[socket.uniformName] = { value: Number.isFinite(n) ? n : 0 };
                 }
             }
             return socket.uniformName;
@@ -198,15 +215,15 @@ export class CompileContext {
     typesCompatible(from, to) {
         if (from === to)
             return true;
-        // shader and color are both vec3 — compatible
+        // shader (vec4) and color (vec3) freely convert — narrow via .rgb, widen via vec4(v, 1.0)
         if ((from === 'shader' || from === 'color') && (to === 'shader' || to === 'color'))
             return true;
-        // vec3 (color/shader) implicitly narrows to vec2 (vector) via .xy, mirroring Blender's
+        // vec3/vec4 (color/shader) implicitly narrows to vec2 (vector) via .xy, mirroring Blender's
         // Mapping (vector output) → Image Texture Vector panning graph
         if ((from === 'color' || from === 'shader') && to === 'vector')
             return true;
-        // vec2 (vector) implicitly widens to vec3 (color), e.g. Texture Coordinate UV → Mapping.vector
-        if (from === 'vector' && to === 'color')
+        // vec2 (vector) implicitly widens to vec3 (color) or vec4 (shader)
+        if (from === 'vector' && (to === 'color' || to === 'shader'))
             return true;
         return false;
     }
@@ -263,8 +280,11 @@ ${callsBlock}
     // ── Literal conversion ────────────────────────────────────────────
     toLiteral(value, type) {
         switch (type) {
-            case 'float':
-                return (typeof value === 'number' ? value : 0).toFixed(4);
+            case 'float': {
+                // Guard against NaN/Infinity reaching the shader source as an invalid GLSL literal.
+                const n = typeof value === 'number' && Number.isFinite(value) ? value : 0;
+                return n.toFixed(4);
+            }
             case 'color':
                 return typeof value === 'string'
                     ? this.hexToVec3(value)
@@ -272,7 +292,7 @@ ${callsBlock}
             case 'vector':
                 return 'vec2(vUv)';
             case 'shader':
-                return 'vec3(0.0)';
+                return 'vec4(0.0, 0.0, 0.0, 1.0)';
             default:
                 return 'vec3(1.0)';
         }

package/dist/core/OutputNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OutputNode.d.ts","sourceRoot":"","sources":["../../src/core/OutputNode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,OAAO,EAAE,cAAc,EAAW,MAAM,OAAO,CAAA;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD;;;;GAIG;AACH,8BAAsB,UAAW,SAAQ,UAAU;IACjD,+EAA+E;IAC/E,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAO;IAEtC,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAIhD,WAAW,IAAI,MAAM;IAIrB;;;;;;;;;;;;;OAaG;IACH,OAAO,IAAI,cAAc;CAyB1B"}
+{"version":3,"file":"OutputNode.d.ts","sourceRoot":"","sources":["../../src/core/OutputNode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,OAAO,EAAE,cAAc,EAAW,MAAM,OAAO,CAAA;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAErD;;;;GAIG;AACH,8BAAsB,UAAW,SAAQ,UAAU;IACjD,+EAA+E;IAC/E,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAO;IAEtC,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAIhD,WAAW,IAAI,MAAM;IAIrB;;;;;;;;;;;;;OAaG;IACH,OAAO,IAAI,cAAc;CA0B1B"}

package/dist/core/OutputNode.js

@@ -39,6 +39,7 @@ export class OutputNode extends ShaderNode {
             vertexShader: compiled.vertexShader,
             fragmentShader: compiled.fragmentShader,
             uniforms: compiled.uniforms,
+            transparent: compiled.needsTransparency,
         });
         // Inject default scene-lighting uniforms used by PrincipledBSDF.
         // Users can override these after compile() to match their scene lights.

package/dist/core/ShaderNode.d.ts

@@ -61,6 +61,13 @@ export declare abstract class ShaderNode {
         attrType: 'float' | 'vec2' | 'vec3';
         varyingName: string;
     }>;
+    /**
+     * Whether this node's contribution to the compiled material requires
+     * `transparent: true` on the resulting THREE.ShaderMaterial (e.g. a
+     * `shader`-socket alpha channel that can read below 1.0).
+     * Override in nodes that carry alpha semantics — see PrincipledBSDF.
+     */
+    wantsTransparency(): boolean;
     /**
      * Returns the named output socket.
      * Throws ShaderNodeError if the socket does not exist.

package/dist/core/ShaderNode.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShaderNode.d.ts","sourceRoot":"","sources":["../../src/core/ShaderNode.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAajD,6DAA6D;AAC7D,KAAK,QAAQ,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;AAE/C,8CAA8C;AAC9C,KAAK,SAAS,GAAG,UAAU,CAAA;AAE3B,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAK,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAK,MAAM,CAAA;IAChB,IAAI,EAAM,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;GAGG;AACH,8BAAsB,UAAU;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAEnB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;;;;OAKG;IACH,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAEvC;;;;;;;;OAQG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAK;IAElE,2EAA2E;IAC3E,OAAO,CAAC,WAAW,CAAmC;IACtD,yDAAyD;IACzD,OAAO,CAAC,YAAY,CAAkC;gBAE1C,QAAQ,EAAE,MAAM;IAI5B,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAA;IAC/B,QAAQ,KAAK,QAAQ,IAAI,YAAY,CAAA;IAErC,QAAQ,CAAC,eAAe,IAAK,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACjE,QAAQ,CAAC,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAEzD;;;;;;;;;OASG;IACH,gBAAgB,IAAI,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAIzG;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAelC;;;OAGG;IACH,QAAQ,CAAC,WAAW,IAAI,MAAM;IAE9B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,qBAAqB,EAAE,cAAc,GAAG,MAAM;IAE/E;;;;OAIG;IACH,MAAM,CAAC,mBAAmB,UAAQ;IAElC;;;;;;;;;;OAUG;IACH,SAAS,CAAC,YAAY,CACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAgCvC;;;;;OAKG;IACH,SAAS,CAAC,aAAa,CACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAQ/B;;;;OAIG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,GAAG,IAAI;CAqBpE"}
+{"version":3,"file":"ShaderNode.d.ts","sourceRoot":"","sources":["../../src/core/ShaderNode.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAsBjD,6DAA6D;AAC7D,KAAK,QAAQ,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAA;AAE/C,8CAA8C;AAC9C,KAAK,SAAS,GAAG,UAAU,CAAA;AAE3B,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAK,MAAM,CAAA;IAChB,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAK,MAAM,CAAA;IAChB,IAAI,EAAM,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAA;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED;;;GAGG;AACH,8BAAsB,UAAU;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAEnB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,MAAM,CAAA;IAErB;;;;;OAKG;IACH,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAEvC;;;;;;;;OAQG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAK;IAElE,2EAA2E;IAC3E,OAAO,CAAC,WAAW,CAAmC;IACtD,yDAAyD;IACzD,OAAO,CAAC,YAAY,CAAkC;gBAE1C,QAAQ,EAAE,MAAM;IAI5B,QAAQ,KAAK,QAAQ,IAAI,MAAM,CAAA;IAC/B,QAAQ,KAAK,QAAQ,IAAI,YAAY,CAAA;IAErC,QAAQ,CAAC,eAAe,IAAK,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IACjE,QAAQ,CAAC,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAEzD;;;;;;;;;OASG;IACH,gBAAgB,IAAI,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAIzG;;;;;OAKG;IACH,iBAAiB,IAAI,OAAO;IAE5B;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY;IAelC;;;OAGG;IACH,QAAQ,CAAC,WAAW,IAAI,MAAM;IAE9B;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,qBAAqB,EAAE,cAAc,GAAG,MAAM;IAE/E;;;;OAIG;IACH,MAAM,CAAC,mBAAmB,UAAQ;IAElC;;;;;;;;;;OAUG;IACH,SAAS,CAAC,YAAY,CACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,GAC7B,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAkCvC;;;;;OAKG;IACH,SAAS,CAAC,aAAa,CACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAQ/B;;;;OAIG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC,GAAG,IAAI;CAqBpE"}

package/dist/core/ShaderNode.js

@@ -2,6 +2,13 @@ import { ShaderNodeError } from './ShaderNodeError.js';
 import { ShaderConfig } from './ShaderConfig.js';
 import { InputSocket } from './InputSocket.js';
 import { OutputSocket } from './OutputSocket.js';
+/** Guards against NaN/Infinity reaching a GLSL uniform (would emit invalid GLSL literals like "NaN"). */
+function finiteOr(value, fallback) {
+    return Number.isFinite(value) ? value : fallback;
+}
+function sanitizeVec3(v) {
+    return [finiteOr(v[0], 0), finiteOr(v[1], 0), finiteOr(v[2], 0)];
+}
 function hexToRgb(hex) {
     const h = hex.replace('#', '');
     return [
@@ -53,6 +60,13 @@ export class ShaderNode {
     vertexInjections() {
         return [];
     }
+    /**
+     * Whether this node's contribution to the compiled material requires
+     * `transparent: true` on the resulting THREE.ShaderMaterial (e.g. a
+     * `shader`-socket alpha channel that can read below 1.0).
+     * Override in nodes that carry alpha semantics — see PrincipledBSDF.
+     */
+    wantsTransparency() { return false; }
     /**
      * Returns the named output socket.
      * Throws ShaderNodeError if the socket does not exist.
@@ -92,7 +106,7 @@ export class ShaderNode {
             if (type === 'float' && typeof literal === 'number') {
                 socket.uniformName = `u_${this.id}_${name}`;
                 this._uniformMap.set(name, socket.uniformName);
-                this.parameters[name] = literal;
+                this.parameters[name] = finiteOr(literal, 0);
             }
             // Auto-register unconnected color inputs as vec3 uniforms
             if (type === 'color' && !(value instanceof OutputSocket)) {
@@ -100,7 +114,9 @@ export class ShaderNode {
                     socket.uniformName = `u_${this.id}_${name}`;
                     this._uniformMap.set(name, socket.uniformName);
                     this._colorParams.add(name);
-                    this.parameters[name] = typeof literal === 'string' ? hexToRgb(literal) : literal;
+                    this.parameters[name] = typeof literal === 'string'
+                        ? hexToRgb(literal)
+                        : sanitizeVec3(literal);
                 }
             }
             sockets[name] = socket;
@@ -131,7 +147,7 @@ export class ShaderNode {
                 if (this._colorParams.has(paramName)) {
                     Object.defineProperty(this.parameters, paramName, {
                         get: () => uniforms[uniformName].value,
-                        set: (v) => { uniforms[uniformName].value = v; },
+                        set: (v) => { uniforms[uniformName].value = sanitizeVec3(v); },
                         enumerable: true,
                         configurable: true,
                     });
@@ -139,7 +155,7 @@ export class ShaderNode {
                 else {
                     Object.defineProperty(this.parameters, paramName, {
                         get: () => uniforms[uniformName].value,
-                        set: (v) => { uniforms[uniformName].value = v; },
+                        set: (v) => { uniforms[uniformName].value = finiteOr(v, 0); },
                         enumerable: true,
                         configurable: true,
                     });

package/dist/core/SocketType.d.ts

@@ -1,7 +1,7 @@
 /**
  * Socket types mirror Blender's socket colours.
  *
- * shader  — yellow  — BSDF / material output
+ * shader  — yellow  — BSDF / material output — vec4 RGB + alpha
  * color   — yellow-green — vec3 RGB
  * vector  — purple  — vec2 / vec3 spatial
  * float   — grey    — single scalar

package/dist/core/SocketType.js

@@ -1,6 +1,6 @@
 /** Maps SocketType to its GLSL primitive. */
 export const SOCKET_GLSL_TYPE = {
-    shader: 'vec3',
+    shader: 'vec4',
     color: 'vec3',
     vector: 'vec2',
     float: 'float',

package/dist/nodes/output/MaterialOutput.js

@@ -112,7 +112,7 @@ export class MaterialOutput extends OutputNode {
     compileCall(ctx) {
         const sv = this._inputs.surface.isConnected()
             ? ctx.outputVar(this._inputs.surface.connection.node, this._inputs.surface.connection.name)
-            : 'vec3(0.8)';
-        return `gl_FragColor = vec4(${sv}, 1.0);`;
+            : 'vec4(0.8, 0.8, 0.8, 1.0)';
+        return `gl_FragColor = ${sv};`;
     }
 }

package/dist/nodes/process/AddShader.js

@@ -26,11 +26,11 @@ export class AddShader extends ProcessNode {
     compileCall(ctx) {
         const s1 = ctx.resolveInput(this._inputs.shader1);
         const s2 = ctx.resolveInput(this._inputs.shader2);
-        return `vec3 ${ctx.outputVar(this, 'BSDF')} = _st_addShader(${s1}, ${s2});`;
+        return `vec4 ${ctx.outputVar(this, 'BSDF')} = _st_addShader(${s1}, ${s2});`;
     }
 }
 AddShader.instanceSpecificDef = false;
 AddShader.glslFunction = `
-vec3 _st_addShader(vec3 a, vec3 b) {
-  return a + b;
+vec4 _st_addShader(vec4 a, vec4 b) {
+  return vec4(a.rgb + b.rgb, max(a.a, b.a));
 }`;

package/dist/nodes/process/DiffuseBSDF.js

@@ -29,7 +29,7 @@ export class DiffuseBSDF extends ProcessNode {
         const normal = this._inputs.normal.isConnected()
             ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name)
             : 'normalize(vNormal)';
-        return `vec3 ${ctx.outputVar(this, 'BSDF')} = _st_diffuseBSDF(${color}, ${roughness}, ${normal});`;
+        return `vec4 ${ctx.outputVar(this, 'BSDF')} = vec4(_st_diffuseBSDF(${color}, ${roughness}, ${normal}), 1.0);`;
     }
 }
 DiffuseBSDF.instanceSpecificDef = false;

package/dist/nodes/process/Emission.js

@@ -26,7 +26,7 @@ export class Emission extends ProcessNode {
     compileCall(ctx) {
         const color = ctx.resolveInput(this._inputs.color);
         const strength = ctx.resolveInput(this._inputs.strength);
-        return `vec3 ${ctx.outputVar(this, 'BSDF')} = _st_emission(${color}, ${strength});`;
+        return `vec4 ${ctx.outputVar(this, 'BSDF')} = vec4(_st_emission(${color}, ${strength}), 1.0);`;
     }
 }
 Emission.instanceSpecificDef = false;

package/dist/nodes/process/GlassBSDF.js

@@ -31,7 +31,7 @@ export class GlassBSDF extends ProcessNode {
         const normal = this._inputs.normal.isConnected()
             ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name)
             : 'normalize(vNormal)';
-        return `vec3 ${ctx.outputVar(this, 'BSDF')} = _st_glassBSDF(${color}, ${roughness}, ${ior}, ${normal});`;
+        return `vec4 ${ctx.outputVar(this, 'BSDF')} = vec4(_st_glassBSDF(${color}, ${roughness}, ${ior}, ${normal}), 1.0);`;
     }
 }
 GlassBSDF.instanceSpecificDef = false;

package/dist/nodes/process/GlossyBSDF.js

@@ -29,7 +29,7 @@ export class GlossyBSDF extends ProcessNode {
         const normal = this._inputs.normal.isConnected()
             ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name)
             : 'normalize(vNormal)';
-        return `vec3 ${ctx.outputVar(this, 'BSDF')} = _st_glossyBSDF(${color}, ${roughness}, ${normal});`;
+        return `vec4 ${ctx.outputVar(this, 'BSDF')} = vec4(_st_glossyBSDF(${color}, ${roughness}, ${normal}), 1.0);`;
     }
 }
 GlossyBSDF.instanceSpecificDef = false;

package/dist/nodes/process/MixShader.js

@@ -37,11 +37,11 @@ export class MixShader extends ProcessNode {
         const fac = ctx.resolveInput(this._inputs.fac);
         const shader1 = ctx.resolveInput(this._inputs.shader1);
         const shader2 = ctx.resolveInput(this._inputs.shader2);
-        return `vec3 ${ctx.outputVar(this, 'BSDF')} = _st_mixShader(${fac}, ${shader1}, ${shader2});`;
+        return `vec4 ${ctx.outputVar(this, 'BSDF')} = _st_mixShader(${fac}, ${shader1}, ${shader2});`;
     }
 }
 MixShader.instanceSpecificDef = false;
 MixShader.glslFunction = `
-vec3 _st_mixShader(float fac, vec3 a, vec3 b) {
+vec4 _st_mixShader(float fac, vec4 a, vec4 b) {
   return mix(a, b, clamp(fac, 0.0, 1.0));
 }`;

package/dist/nodes/process/PrincipledBSDF.d.ts

@@ -27,6 +27,13 @@ export declare class PrincipledBSDF extends ProcessNode {
     getInputSockets(): Record<string, import("../../index.js").InputSocket<unknown>>;
     getOutputSockets(): Record<string, OutputSocket>;
     compileDefs(): string;
+    /**
+     * Alpha has no channel of its own in the underlying vec3 lighting function —
+     * it's applied as the vec4 alpha component at the call site instead (see
+     * compileCall). transparent:true is needed whenever alpha can read below 1.0:
+     * a non-default literal, or any live/connected value (conservatively true).
+     */
+    wantsTransparency(): boolean;
     compileCall(ctx: CompileContext): string;
 }
 //# sourceMappingURL=PrincipledBSDF.d.ts.map

package/dist/nodes/process/PrincipledBSDF.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PrincipledBSDF.d.ts","sourceRoot":"","sources":["../../../src/nodes/process/PrincipledBSDF.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,YAAY,GAAG,MAAM,CAAA;IACjC,QAAQ,CAAC,EAAG,YAAY,GAAG,MAAM,CAAA;IACjC,SAAS,CAAC,EAAE,YAAY,GAAG,MAAM,CAAA;IACjC,GAAG,CAAC,EAAQ,YAAY,GAAG,MAAM,CAAA;IACjC,KAAK,CAAC,EAAM,YAAY,GAAG,MAAM,CAAA;IACjC,MAAM,CAAC,EAAK,YAAY,CAAA;CACzB;AAED;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,IAAI,QAAQ,WAA8B;IAC1C,MAAM,CAAC,mBAAmB,UAAQ;IAElC,IAAI,QAAQ,IAAI,YAAY,CAE3B;IAED,MAAM,CAAC,YAAY,SAuCnB;IAEA,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2E;IACnG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmE;gBAEhF,MAAM,GAAE,oBAAyB;IAa7C,eAAe;IACf,gBAAgB;IAChB,WAAW;IAEX,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM;CAMzC"}
+{"version":3,"file":"PrincipledBSDF.d.ts","sourceRoot":"","sources":["../../../src/nodes/process/PrincipledBSDF.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAE9D,MAAM,WAAW,oBAAoB;IACnC,SAAS,CAAC,EAAE,YAAY,GAAG,MAAM,CAAA;IACjC,QAAQ,CAAC,EAAG,YAAY,GAAG,MAAM,CAAA;IACjC,SAAS,CAAC,EAAE,YAAY,GAAG,MAAM,CAAA;IACjC,GAAG,CAAC,EAAQ,YAAY,GAAG,MAAM,CAAA;IACjC,KAAK,CAAC,EAAM,YAAY,GAAG,MAAM,CAAA;IACjC,MAAM,CAAC,EAAK,YAAY,CAAA;CACzB;AAED;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,WAAW;IAC7C,IAAI,QAAQ,WAA8B;IAC1C,MAAM,CAAC,mBAAmB,UAAQ;IAElC,IAAI,QAAQ,IAAI,YAAY,CAE3B;IAED,MAAM,CAAC,YAAY,SAuCnB;IAEA,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2E;IACnG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmE;gBAEhF,MAAM,GAAE,oBAAyB;IAa7C,eAAe;IACf,gBAAgB;IAChB,WAAW;IAEX;;;;;OAKG;IACH,iBAAiB,IAAI,OAAO;IAO5B,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM;CAQzC"}

package/dist/nodes/process/PrincipledBSDF.js

@@ -25,11 +25,26 @@ export class PrincipledBSDF extends ProcessNode {
     getInputSockets() { return this._inputs; }
     getOutputSockets() { return this._outputs; }
     compileDefs() { return this.glslFunction ?? PrincipledBSDF.glslFunction; }
+    /**
+     * Alpha has no channel of its own in the underlying vec3 lighting function —
+     * it's applied as the vec4 alpha component at the call site instead (see
+     * compileCall). transparent:true is needed whenever alpha can read below 1.0:
+     * a non-default literal, or any live/connected value (conservatively true).
+     */
+    wantsTransparency() {
+        const alphaSocket = this._inputs.alpha;
+        if (alphaSocket.isConnected())
+            return true;
+        const v = alphaSocket.defaultValue;
+        return typeof v === 'number' && v < 1.0;
+    }
     compileCall(ctx) {
         const normal = this._inputs.normal.isConnected()
             ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name)
             : 'normalize(vNormal)';
-        return `vec3 ${ctx.outputVar(this, 'BSDF')} = _st_principledBSDF(${ctx.resolveInput(this._inputs.baseColor)}, ${ctx.resolveInput(this._inputs.metallic)}, ${ctx.resolveInput(this._inputs.roughness)}, ${ctx.resolveInput(this._inputs.ior)}, ${ctx.resolveInput(this._inputs.alpha)}, ${normal});`;
+        const rgb = `_st_principledBSDF(${ctx.resolveInput(this._inputs.baseColor)}, ${ctx.resolveInput(this._inputs.metallic)}, ${ctx.resolveInput(this._inputs.roughness)}, ${ctx.resolveInput(this._inputs.ior)}, ${normal})`;
+        const alpha = ctx.resolveInput(this._inputs.alpha);
+        return `vec4 ${ctx.outputVar(this, 'BSDF')} = vec4(${rgb}, ${alpha});`;
     }
 }
 PrincipledBSDF.instanceSpecificDef = false;
@@ -54,7 +69,7 @@ float _st_geo(float NdotX, float r) {
   float k = (r + 1.0) * (r + 1.0) / 8.0;
   return NdotX / max(NdotX * (1.0 - k) + k, 1e-7);
 }
-vec3 _st_principledBSDF(vec3 base, float metallic, float roughness, float ior, float alpha, vec3 N) {
+vec3 _st_principledBSDF(vec3 base, float metallic, float roughness, float ior, vec3 N) {
   vec3  V     = normalize(cameraPosition - vPosition);
   vec3  L     = normalize(uSunDirection);
   vec3  H     = normalize(L + V);

package/dist/nodes/process/PrincipledHair.js

@@ -59,7 +59,7 @@ export class PrincipledHair extends ProcessNode {
         const tangent = this._inputs.tangent.isConnected()
             ? ctx.outputVar(this._inputs.tangent.connection.node, this._inputs.tangent.connection.name)
             : 'normalize(vStrandTangent)'; // fallback: read attribute directly if not connected
-        return `vec3 ${ctx.outputVar(this, 'BSDF')} = _st_principledHair(${color}, ${roughness}, ${radialRoughness}, ${coat}, ${ior}, ${offset}, ${randomColor}, ${randomRoughness}, ${random}, ${tangent});`;
+        return `vec4 ${ctx.outputVar(this, 'BSDF')} = vec4(_st_principledHair(${color}, ${roughness}, ${radialRoughness}, ${coat}, ${ior}, ${offset}, ${randomColor}, ${randomRoughness}, ${random}, ${tangent}), 1.0);`;
     }
 }
 PrincipledHair.instanceSpecificDef = false;

package/dist/nodes/process/PrincipledVolume.js

@@ -39,7 +39,7 @@ export class PrincipledVolume extends ProcessNode {
         const emissionStrength = ctx.resolveInput(this._inputs.emissionStrength);
         const blackbodyIntensity = ctx.resolveInput(this._inputs.blackbodyIntensity);
         const temperature = ctx.resolveInput(this._inputs.temperature);
-        return `vec3 ${ctx.outputVar(this, 'Volume')} = _st_principledVolume(${color}, ${density}, ${anisotropy}, ${absorptionColor}, ${emissionColor}, ${emissionStrength}, ${blackbodyIntensity}, ${temperature});`;
+        return `vec4 ${ctx.outputVar(this, 'Volume')} = vec4(_st_principledVolume(${color}, ${density}, ${anisotropy}, ${absorptionColor}, ${emissionColor}, ${emissionStrength}, ${blackbodyIntensity}, ${temperature}), 1.0);`;
     }
 }
 PrincipledVolume.instanceSpecificDef = false;

package/dist/nodes/process/RefractionBSDF.js

@@ -32,7 +32,7 @@ export class RefractionBSDF extends ProcessNode {
         const normal = this._inputs.normal.isConnected()
             ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name)
             : 'normalize(vNormal)';
-        return `vec3 ${ctx.outputVar(this, 'BSDF')} = _st_refractionBSDF(${color}, ${roughness}, ${ior}, ${normal});`;
+        return `vec4 ${ctx.outputVar(this, 'BSDF')} = vec4(_st_refractionBSDF(${color}, ${roughness}, ${ior}, ${normal}), 1.0);`;
     }
 }
 RefractionBSDF.instanceSpecificDef = false;

package/dist/nodes/process/ShaderScript.d.ts

@@ -7,7 +7,7 @@ import type { OutputSocket } from '../../core/OutputSocket.js';
  *   'float'  → float   (uniform or literal)
  *   'color'  → vec3    (uniform or literal hex / [r,g,b])
  *   'vector' → vec2    (UV coordinates)
- *   'shader' → vec3    (BSDF connection)
+ *   'shader' → vec4    (BSDF connection, rgb + alpha)
  */
 export type ScriptInputDecl = ['float' | 'color' | 'vector' | 'shader', unknown];
 /** Output socket type map: socketName → glslType */
@@ -49,7 +49,7 @@ export interface ShaderScriptConfig {
  * Inside the GLSL body:
  *   • Input sockets are available as local variables with the exact name you declared.
  *   • Output sockets must be assigned by name before the block ends.
- *   • GLSL types: 'float' → float, 'color'/'shader' → vec3, 'vector' → vec2
+ *   • GLSL types: 'float' → float, 'color' → vec3, 'shader' → vec4, 'vector' → vec2
  *
  * @example
  * const ripple = new ShaderScript({

package/dist/nodes/process/ShaderScript.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShaderScript.d.ts","sourceRoot":"","sources":["../../../src/nodes/process/ShaderScript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAK9D;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,EAAE,OAAO,CAAC,CAAA;AAEhF,oDAAoD;AACpD,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAA;AAEtF,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,MAAM,CAAC,EAAG,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,YAAY,CAAC,CAAA;IAExD,2CAA2C;IAC3C,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAE1B;;;;;;;;;OASG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAID;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C,IAAI,QAAQ,WAA4B;IACxC,MAAM,CAAC,mBAAmB,UAAO;IAEjC,IAAI,QAAQ,IAAI,YAAY,CAQ3B;IAED,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+E;IACvG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;gBAE/C,MAAM,EAAE,kBAAkB;IAmCtC,eAAe;IACf,gBAAgB;IAEhB,mDAAmD;IACnD,WAAW,IAAI,MAAM;IAErB;;;;;;OAMG;IACH,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM;IAkCxC,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,aAAa;CAKtB"}
+{"version":3,"file":"ShaderScript.d.ts","sourceRoot":"","sources":["../../../src/nodes/process/ShaderScript.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAEvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAClE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAA;AAK9D;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,EAAE,OAAO,CAAC,CAAA;AAEhF,oDAAoD;AACpD,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC,CAAA;AAEtF,MAAM,WAAW,kBAAkB;IACjC;;;;OAIG;IACH,MAAM,CAAC,EAAG,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,YAAY,CAAC,CAAA;IAExD,2CAA2C;IAC3C,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAE1B;;;;;;;;;OASG;IACH,IAAI,EAAE,MAAM,CAAA;IAEZ;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAID;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C,IAAI,QAAQ,WAA4B;IACxC,MAAM,CAAC,mBAAmB,UAAO;IAEjC,IAAI,QAAQ,IAAI,YAAY,CAQ3B;IAED,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;IAC/C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+E;IACvG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;gBAE/C,MAAM,EAAE,kBAAkB;IAmCtC,eAAe;IACf,gBAAgB;IAEhB,mDAAmD;IACnD,WAAW,IAAI,MAAM;IAErB;;;;;;OAMG;IACH,WAAW,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM;IAkCxC,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,aAAa;CAMtB"}

package/dist/nodes/process/ShaderScript.js

@@ -10,7 +10,7 @@ import { assertGlslIdentifier } from '../../core/glslIdentifier.js';
  * Inside the GLSL body:
  *   • Input sockets are available as local variables with the exact name you declared.
  *   • Output sockets must be assigned by name before the block ends.
- *   • GLSL types: 'float' → float, 'color'/'shader' → vec3, 'vector' → vec2
+ *   • GLSL types: 'float' → float, 'color' → vec3, 'shader' → vec4, 'vector' → vec2
  *
  * @example
  * const ripple = new ShaderScript({
@@ -111,14 +111,18 @@ export class ShaderScript extends ProcessNode {
             return 'float';
         if (type === 'vector')
             return 'vec2';
-        return 'vec3'; // 'color' | 'shader'
+        if (type === 'shader')
+            return 'vec4';
+        return 'vec3'; // 'color'
     }
     _declGlslType(type) {
         if (type === 'float')
             return 'float';
         if (type === 'vector')
             return 'vec2';
-        return 'vec3'; // 'color' | 'shader'
+        if (type === 'shader')
+            return 'vec4';
+        return 'vec3'; // 'color'
     }
 }
 ShaderScript.instanceSpecificDef = true; // every script is unique — no dedup

package/dist/nodes/process/ShaderToRGB.js

@@ -25,8 +25,8 @@ export class ShaderToRGB extends ProcessNode {
         const cv = ctx.outputVar(this, 'Color');
         const av = ctx.outputVar(this, 'Alpha');
         return [
-            `vec3  ${cv} = ${shader};`,
-            `float ${av} = 1.0;`,
+            `vec3  ${cv} = (${shader}).rgb;`,
+            `float ${av} = (${shader}).a;`,
         ].join('\n  ');
     }
 }

package/dist/nodes/process/SheenBSDF.js

@@ -30,7 +30,7 @@ export class SheenBSDF extends ProcessNode {
         const normal = this._inputs.normal.isConnected()
             ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name)
             : 'normalize(vNormal)';
-        return `vec3 ${ctx.outputVar(this, 'BSDF')} = _st_sheenBSDF(${color}, ${roughness}, ${normal});`;
+        return `vec4 ${ctx.outputVar(this, 'BSDF')} = vec4(_st_sheenBSDF(${color}, ${roughness}, ${normal}), 1.0);`;
     }
 }
 SheenBSDF.instanceSpecificDef = false;

package/dist/nodes/process/SpecularBSDF.js

@@ -32,7 +32,7 @@ export class SpecularBSDF extends ProcessNode {
         const normal = this._inputs.normal.isConnected()
             ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name)
             : 'normalize(vNormal)';
-        return `vec3 ${ctx.outputVar(this, 'BSDF')} = _st_specularBSDF(${base}, ${spec}, ${roughness}, ${normal});`;
+        return `vec4 ${ctx.outputVar(this, 'BSDF')} = vec4(_st_specularBSDF(${base}, ${spec}, ${roughness}, ${normal}), 1.0);`;
     }
 }
 SpecularBSDF.instanceSpecificDef = false;

package/dist/nodes/process/SubsurfaceScattering.js

@@ -32,7 +32,7 @@ export class SubsurfaceScattering extends ProcessNode {
         const normal = this._inputs.normal.isConnected()
             ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name)
             : 'normalize(vNormal)';
-        return `vec3 ${ctx.outputVar(this, 'BSDF')} = _st_sss(${color}, ${scale}, vec3(${r.toFixed(4)}, ${g.toFixed(4)}, ${b.toFixed(4)}), ${normal});`;
+        return `vec4 ${ctx.outputVar(this, 'BSDF')} = vec4(_st_sss(${color}, ${scale}, vec3(${r.toFixed(4)}, ${g.toFixed(4)}, ${b.toFixed(4)}), ${normal}), 1.0);`;
     }
 }
 SubsurfaceScattering.instanceSpecificDef = false;

package/dist/nodes/process/ToonBSDF.js

@@ -31,7 +31,7 @@ export class ToonBSDF extends ProcessNode {
         const normal = this._inputs.normal.isConnected()
             ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name)
             : 'normalize(vNormal)';
-        return `vec3 ${ctx.outputVar(this, 'BSDF')} = _st_toonBSDF(${color}, ${size}, ${smoothWidth}, ${normal});`;
+        return `vec4 ${ctx.outputVar(this, 'BSDF')} = vec4(_st_toonBSDF(${color}, ${size}, ${smoothWidth}, ${normal}), 1.0);`;
     }
 }
 ToonBSDF.instanceSpecificDef = false;

package/dist/nodes/process/TranslucentBSDF.js

@@ -27,7 +27,7 @@ export class TranslucentBSDF extends ProcessNode {
         const normal = this._inputs.normal.isConnected()
             ? ctx.outputVar(this._inputs.normal.connection.node, this._inputs.normal.connection.name)
             : 'normalize(vNormal)';
-        return `vec3 ${ctx.outputVar(this, 'BSDF')} = _st_translucentBSDF(${color}, ${normal});`;
+        return `vec4 ${ctx.outputVar(this, 'BSDF')} = vec4(_st_translucentBSDF(${color}, ${normal}), 1.0);`;
     }
 }
 TranslucentBSDF.instanceSpecificDef = false;

package/dist/nodes/process/VolumeAbsorption.js

@@ -26,7 +26,7 @@ export class VolumeAbsorption extends ProcessNode {
     compileCall(ctx) {
         const color = ctx.resolveInput(this._inputs.color);
         const density = ctx.resolveInput(this._inputs.density);
-        return `vec3 ${ctx.outputVar(this, 'Volume')} = _st_volumeAbsorption(${color}, ${density});`;
+        return `vec4 ${ctx.outputVar(this, 'Volume')} = vec4(_st_volumeAbsorption(${color}, ${density}), 1.0);`;
     }
 }
 VolumeAbsorption.instanceSpecificDef = false;

package/dist/nodes/process/VolumeScatter.js

@@ -28,7 +28,7 @@ export class VolumeScatter extends ProcessNode {
         const color = ctx.resolveInput(this._inputs.color);
         const density = ctx.resolveInput(this._inputs.density);
         const anisotropy = ctx.resolveInput(this._inputs.anisotropy);
-        return `vec3 ${ctx.outputVar(this, 'Volume')} = _st_volumeScatter(${color}, ${density}, ${anisotropy});`;
+        return `vec4 ${ctx.outputVar(this, 'Volume')} = vec4(_st_volumeScatter(${color}, ${density}, ${anisotropy}), 1.0);`;
     }
 }
 VolumeScatter.instanceSpecificDef = false;

package/dist/nodes/shader/RayPortal.js

@@ -50,7 +50,7 @@ export class RayPortal extends ProcessNode {
         const blend = Number.isFinite(rawBlend) ? Math.min(Math.max(rawBlend, 0.0), 1.0).toFixed(4) : '1.0000';
         // Rasterizer passthrough: BSDF = color * blend
         // Portal Transform is intentionally unused in this mode.
-        return `vec3 ${ctx.outputVar(this, 'BSDF')} = ${color} * ${blend};`;
+        return `vec4 ${ctx.outputVar(this, 'BSDF')} = vec4(${color} * ${blend}, 1.0);`;
     }
 }
 RayPortal.instanceSpecificDef = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@triforge/shader-core",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "GLSL shader library for Three.js with Blender workflow",
   "type": "module",
   "main": "./dist/index.js",