@womp/spark-agent 5.6.1 → 5.7.1

package/dist/materials/recipes.js

@@ -1,284 +1,284 @@
 import { MATERIAL_RECIPE_RELIEF_GUIDANCE } from "./surface-recipes.js";
-const ENUM_RECIPE = `const enumValue = (op, slot, label) => {
-  const value = catalogue.nodes[op]?.inputs[slot]?.values?.indexOf(label) ?? -1;
-  if (value < 0) throw new Error(op + ' input ' + slot + ' has no option: ' + label);
-  return value;
+const ENUM_RECIPE = `const enumValue = (op, slot, label) => {
+  const value = catalogue.nodes[op]?.inputs[slot]?.values?.indexOf(label) ?? -1;
+  if (value < 0) throw new Error(op + ' input ' + slot + ' has no option: ' + label);
+  return value;
 };`;
 // Compose terminal-free helpers or custom scalar graphs through the shared API.
-export const MATERIALS_FIELD_COMPOSITION_SNIPPET = `const graph = await womp.materials.compose({
-  fields,
-  color:{low:colorLow,high:colorHigh,weights:colorWeights},
-  roughness:{low:roughnessLow,high:roughnessHigh,weights:roughnessWeights},
-  relief:{mode:'height',scale:reliefScale,weights:reliefWeights}
+export const MATERIALS_FIELD_COMPOSITION_SNIPPET = `const graph = await womp.materials.compose({
+  fields,
+  color:{low:colorLow,high:colorHigh,weights:colorWeights},
+  roughness:{low:roughnessLow,high:roughnessHigh,weights:roughnessWeights},
+  relief:{mode:'height',scale:reliefScale,weights:reliefWeights}
 });`;
 // Rotate position and normal mapping together.
-export const MATERIALS_PROJECTION_RECIPE = `const catalogue = await womp.materials.catalog({
-  operations:['InputPosition','InputNormal','Mapping','Projection','PredefinedTexture','OutputMaterial'],
-  includeTextures:true, refreshTextures:true
-});
-if (!catalogue.textures?.includes(textureName)) throw new Error('Texture is not listed: ' + textureName);
-${ENUM_RECIPE}
-const rotation = {x:0,y:90,z:0};
-const graph = {
-  nodes:[
-    womp.materials.node({op:'InputPosition'}),
-    womp.materials.node({op:'InputNormal'}),
-    womp.materials.node({op:'Mapping',inputs:{1:0,2:rotation,3:1}}),
-    womp.materials.node({op:'Mapping',inputs:{1:0,2:rotation,3:1}}),
-    womp.materials.node({op:'Projection',inputs:{0:enumValue('Projection',0,projectionName),3:4,4:{x:0.13,y:0.21,z:0.07},5:0}}),
-    womp.materials.node({op:'PredefinedTexture',texture:textureName,inputs:{3:0,4:enumValue('PredefinedTexture',4,'sRGB (Color)'),5:0,6:0}}),
-    womp.materials.node({op:'OutputMaterial'})
-  ],
-  connections:[
-    {input_node:0,input_slot:0,output_node:2,output_slot:0,flags:0},
-    {input_node:1,input_slot:0,output_node:3,output_slot:0,flags:0},
-    {input_node:2,input_slot:0,output_node:4,output_slot:1,flags:0},
-    {input_node:3,input_slot:0,output_node:4,output_slot:2,flags:0},
-    {input_node:4,input_slot:0,output_node:5,output_slot:0,flags:0},
-    {input_node:5,input_slot:0,output_node:6,output_slot:0,flags:0}
-  ]
+export const MATERIALS_PROJECTION_RECIPE = `const catalogue = await womp.materials.catalog({
+  operations:['InputPosition','InputNormal','Mapping','Projection','PredefinedTexture','OutputMaterial'],
+  includeTextures:true, refreshTextures:true
+});
+if (!catalogue.textures?.includes(textureName)) throw new Error('Texture is not listed: ' + textureName);
+${ENUM_RECIPE}
+const rotation = {x:0,y:90,z:0};
+const graph = {
+  nodes:[
+    womp.materials.node({op:'InputPosition'}),
+    womp.materials.node({op:'InputNormal'}),
+    womp.materials.node({op:'Mapping',inputs:{1:0,2:rotation,3:1}}),
+    womp.materials.node({op:'Mapping',inputs:{1:0,2:rotation,3:1}}),
+    womp.materials.node({op:'Projection',inputs:{0:enumValue('Projection',0,projectionName),3:4,4:{x:0.13,y:0.21,z:0.07},5:0}}),
+    womp.materials.node({op:'PredefinedTexture',texture:textureName,inputs:{3:0,4:enumValue('PredefinedTexture',4,'sRGB (Color)'),5:0,6:0}}),
+    womp.materials.node({op:'OutputMaterial'})
+  ],
+  connections:[
+    {input_node:0,input_slot:0,output_node:2,output_slot:0,flags:0},
+    {input_node:1,input_slot:0,output_node:3,output_slot:0,flags:0},
+    {input_node:2,input_slot:0,output_node:4,output_slot:1,flags:0},
+    {input_node:3,input_slot:0,output_node:4,output_slot:2,flags:0},
+    {input_node:4,input_slot:0,output_node:5,output_slot:0,flags:0},
+    {input_node:5,input_slot:0,output_node:6,output_slot:0,flags:0}
+  ]
 };`;
 // Decode a texture as a tangent-space normal map.
-export const MATERIALS_NORMAL_MAP_RECIPE = `const catalogue = await womp.materials.catalog({
-  operations:['Constant','Passthrough','OutputMaterial','InputPosition','InputNormal','Projection','Mapping','PredefinedTexture','OutputSurfaceNormal'],
-  includeTextures:true, refreshTextures:true
-});
-if (!catalogue.textures?.includes(textureName)) throw new Error('Texture is not listed: ' + textureName);
-${ENUM_RECIPE}
-const graph = {
-  nodes:[
-    womp.materials.node({op:'Constant',inputs:{2:0.5}}),
-    womp.materials.node({op:'Passthrough',inputs:{0:0.3}}),
-    womp.materials.node({op:'OutputMaterial'}),
-    womp.materials.node({op:'InputPosition'}),
-    womp.materials.node({op:'InputNormal'}),
-    womp.materials.node({op:'Projection',inputs:{0:enumValue('Projection',0,'Equirectangular'),3:1,4:0,5:0}}),
-    womp.materials.node({op:'Mapping',inputs:{1:0,2:0,3:1}}),
-    womp.materials.node({op:'PredefinedTexture',texture:textureName,inputs:{3:0,4:enumValue('PredefinedTexture',4,'Normal'),5:0,6:0}}),
-    womp.materials.node({op:'OutputSurfaceNormal'})
-  ],
-  connections:[
-    {input_node:0,input_slot:2,output_node:2,output_slot:0,flags:0},
-    {input_node:1,input_slot:0,output_node:2,output_slot:3,flags:0},
-    {input_node:1,input_slot:0,output_node:2,output_slot:4,flags:0},
-    {input_node:3,input_slot:0,output_node:5,output_slot:1,flags:0},
-    {input_node:4,input_slot:0,output_node:5,output_slot:2,flags:0},
-    {input_node:5,input_slot:0,output_node:6,output_slot:0,flags:0},
-    {input_node:6,input_slot:0,output_node:7,output_slot:0,flags:0},
-    {input_node:7,input_slot:0,output_node:8,output_slot:0,flags:0}
-  ]
+export const MATERIALS_NORMAL_MAP_RECIPE = `const catalogue = await womp.materials.catalog({
+  operations:['Constant','Passthrough','OutputMaterial','InputPosition','InputNormal','Projection','Mapping','PredefinedTexture','OutputSurfaceNormal'],
+  includeTextures:true, refreshTextures:true
+});
+if (!catalogue.textures?.includes(textureName)) throw new Error('Texture is not listed: ' + textureName);
+${ENUM_RECIPE}
+const graph = {
+  nodes:[
+    womp.materials.node({op:'Constant',inputs:{2:0.5}}),
+    womp.materials.node({op:'Passthrough',inputs:{0:0.3}}),
+    womp.materials.node({op:'OutputMaterial'}),
+    womp.materials.node({op:'InputPosition'}),
+    womp.materials.node({op:'InputNormal'}),
+    womp.materials.node({op:'Projection',inputs:{0:enumValue('Projection',0,'Equirectangular'),3:1,4:0,5:0}}),
+    womp.materials.node({op:'Mapping',inputs:{1:0,2:0,3:1}}),
+    womp.materials.node({op:'PredefinedTexture',texture:textureName,inputs:{3:0,4:enumValue('PredefinedTexture',4,'Normal'),5:0,6:0}}),
+    womp.materials.node({op:'OutputSurfaceNormal'})
+  ],
+  connections:[
+    {input_node:0,input_slot:2,output_node:2,output_slot:0,flags:0},
+    {input_node:1,input_slot:0,output_node:2,output_slot:3,flags:0},
+    {input_node:1,input_slot:0,output_node:2,output_slot:4,flags:0},
+    {input_node:3,input_slot:0,output_node:5,output_slot:1,flags:0},
+    {input_node:4,input_slot:0,output_node:5,output_slot:2,flags:0},
+    {input_node:5,input_slot:0,output_node:6,output_slot:0,flags:0},
+    {input_node:6,input_slot:0,output_node:7,output_slot:0,flags:0},
+    {input_node:7,input_slot:0,output_node:8,output_slot:0,flags:0}
+  ]
 };`;
-export const MATERIALS_HEIGHT_MAP_RECIPE = `const catalogue = await womp.materials.catalog({
-  operations:['Constant','Passthrough','OutputMaterial','InputPosition','InputNormal','Projection','Mapping','PredefinedTexture','OutputHeight'],
-  includeTextures:true, refreshTextures:true
-});
-if (!catalogue.textures?.includes(textureName)) throw new Error('Texture is not listed: ' + textureName);
-if (!Number.isFinite(heightScale) || heightScale <= 0) throw new Error('Choose a finite positive heightScale');
-${ENUM_RECIPE}
-const graph = {
-  nodes:[
-    womp.materials.node({op:'Constant',inputs:{2:0.5}}),
-    womp.materials.node({op:'Passthrough',inputs:{0:0.3}}),
-    womp.materials.node({op:'OutputMaterial'}),
-    womp.materials.node({op:'InputPosition'}),
-    womp.materials.node({op:'InputNormal'}),
-    womp.materials.node({op:'Projection',inputs:{0:enumValue('Projection',0,'Equirectangular'),3:1,4:0,5:0}}),
-    womp.materials.node({op:'Mapping',inputs:{1:0,2:0,3:1}}),
-    womp.materials.node({op:'PredefinedTexture',texture:textureName,inputs:{3:0,4:enumValue('PredefinedTexture',4,'No transform'),5:0,6:0}}),
-    womp.materials.node({op:'OutputHeight',inputs:{2:heightScale}})
-  ],
-  connections:[
-    {input_node:0,input_slot:2,output_node:2,output_slot:0,flags:0},
-    {input_node:1,input_slot:0,output_node:2,output_slot:3,flags:0},
-    {input_node:1,input_slot:0,output_node:2,output_slot:4,flags:0},
-    {input_node:3,input_slot:0,output_node:5,output_slot:1,flags:0},
-    {input_node:4,input_slot:0,output_node:5,output_slot:2,flags:0},
-    {input_node:5,input_slot:0,output_node:6,output_slot:0,flags:0},
-    {input_node:6,input_slot:0,output_node:7,output_slot:0,flags:0},
-    {input_node:7,input_slot:0,output_node:8,output_slot:0,flags:0}
-  ]
+export const MATERIALS_HEIGHT_MAP_RECIPE = `const catalogue = await womp.materials.catalog({
+  operations:['Constant','Passthrough','OutputMaterial','InputPosition','InputNormal','Projection','Mapping','PredefinedTexture','OutputHeight'],
+  includeTextures:true, refreshTextures:true
+});
+if (!catalogue.textures?.includes(textureName)) throw new Error('Texture is not listed: ' + textureName);
+if (!Number.isFinite(heightScale) || heightScale <= 0) throw new Error('Choose a finite positive heightScale');
+${ENUM_RECIPE}
+const graph = {
+  nodes:[
+    womp.materials.node({op:'Constant',inputs:{2:0.5}}),
+    womp.materials.node({op:'Passthrough',inputs:{0:0.3}}),
+    womp.materials.node({op:'OutputMaterial'}),
+    womp.materials.node({op:'InputPosition'}),
+    womp.materials.node({op:'InputNormal'}),
+    womp.materials.node({op:'Projection',inputs:{0:enumValue('Projection',0,'Equirectangular'),3:1,4:0,5:0}}),
+    womp.materials.node({op:'Mapping',inputs:{1:0,2:0,3:1}}),
+    womp.materials.node({op:'PredefinedTexture',texture:textureName,inputs:{3:0,4:enumValue('PredefinedTexture',4,'No transform'),5:0,6:0}}),
+    womp.materials.node({op:'OutputHeight',inputs:{2:heightScale}})
+  ],
+  connections:[
+    {input_node:0,input_slot:2,output_node:2,output_slot:0,flags:0},
+    {input_node:1,input_slot:0,output_node:2,output_slot:3,flags:0},
+    {input_node:1,input_slot:0,output_node:2,output_slot:4,flags:0},
+    {input_node:3,input_slot:0,output_node:5,output_slot:1,flags:0},
+    {input_node:4,input_slot:0,output_node:5,output_slot:2,flags:0},
+    {input_node:5,input_slot:0,output_node:6,output_slot:0,flags:0},
+    {input_node:6,input_slot:0,output_node:7,output_slot:0,flags:0},
+    {input_node:7,input_slot:0,output_node:8,output_slot:0,flags:0}
+  ]
 };`;
-export const MATERIALS_GENERATOR_RECIPE = `const settings = {
-  Noise1D:{inputs:{1:5,2:1,3:1,4:0}, ramp:[0.2,0.8,0.025,0.92]},
-  Noise3D:{inputs:{1:5,2:1,3:1,4:0}},
-  NoiseFBM:{inputs:{1:4,2:2,3:1,4:0}, ramp:[0.25,0.75,0.018,0.95]},
-  NoiseVoronoi:{inputs:{1:4}},
-  WavesTexture:{inputs:{1:{x:10,y:0,z:0},2:1,3:0}, ramp:[0,1]},
-  CheckerTexture:{inputs:{1:3,2:1}, ramp:[0,1]},
-  MagicTexture:{inputs:{1:5,2:2,3:1}}
-};
-if (!Object.hasOwn(settings,generatorName)) throw new Error('No recipe for: ' + generatorName);
-const preset = settings[generatorName];
-const catalogue = await womp.materials.catalog({operations:['InputPosition','Mapping',generatorName,...(preset.ramp ? ['ColorRamp'] : []),'OutputMaterial']});
-if (!catalogue.nodes[generatorName]) throw new Error('Generator is not listed: ' + generatorName);
-${ENUM_RECIPE}
-if (generatorName === 'NoiseVoronoi') {
-  preset.inputs[2] = enumValue('NoiseVoronoi',2,'Color');
-  preset.inputs[3] = enumValue('NoiseVoronoi',3,'Euclidean');
-}
-const gray = value => ({x:value,y:value,z:value});
-const nodes = [
-  womp.materials.node({op:'InputPosition'}),
-  womp.materials.node({op:'Mapping',inputs:{1:0,2:{x:generatorName === 'WavesTexture' ? 45 : 0,y:90,z:0},3:1}}),
-  womp.materials.node({op:generatorName,inputs:preset.inputs})
-];
-if (preset.ramp) {
-  const [start,end,dark,light] = preset.ramp;
-  nodes.push(womp.materials.node({op:'ColorRamp',inputs:{3:enumValue('ColorRamp',3,'Linear')},ramp:[
-    {position:start,color:dark === undefined ? {x:0.018,y:0.04,z:0.085} : gray(dark)},
-    {position:end,color:light === undefined ? {x:0.94,y:0.78,z:0.36} : gray(light)}
-  ]}));
-}
-nodes.push(womp.materials.node({op:'OutputMaterial'}));
+export const MATERIALS_GENERATOR_RECIPE = `const settings = {
+  Noise1D:{inputs:{1:5,2:1,3:1,4:0}, ramp:[0.2,0.8,0.025,0.92]},
+  Noise3D:{inputs:{1:5,2:1,3:1,4:0}},
+  NoiseFBM:{inputs:{1:4,2:2,3:1,4:0}, ramp:[0.25,0.75,0.018,0.95]},
+  NoiseVoronoi:{inputs:{1:4}},
+  WavesTexture:{inputs:{1:{x:10,y:0,z:0},2:1,3:0}, ramp:[0,1]},
+  CheckerTexture:{inputs:{1:3,2:1}, ramp:[0,1]},
+  MagicTexture:{inputs:{1:5,2:2,3:1}}
+};
+if (!Object.hasOwn(settings,generatorName)) throw new Error('No recipe for: ' + generatorName);
+const preset = settings[generatorName];
+const catalogue = await womp.materials.catalog({operations:['InputPosition','Mapping',generatorName,...(preset.ramp ? ['ColorRamp'] : []),'OutputMaterial']});
+if (!catalogue.nodes[generatorName]) throw new Error('Generator is not listed: ' + generatorName);
+${ENUM_RECIPE}
+if (generatorName === 'NoiseVoronoi') {
+  preset.inputs[2] = enumValue('NoiseVoronoi',2,'Color');
+  preset.inputs[3] = enumValue('NoiseVoronoi',3,'Euclidean');
+}
+const gray = value => ({x:value,y:value,z:value});
+const nodes = [
+  womp.materials.node({op:'InputPosition'}),
+  womp.materials.node({op:'Mapping',inputs:{1:0,2:{x:generatorName === 'WavesTexture' ? 45 : 0,y:90,z:0},3:1}}),
+  womp.materials.node({op:generatorName,inputs:preset.inputs})
+];
+if (preset.ramp) {
+  const [start,end,dark,light] = preset.ramp;
+  nodes.push(womp.materials.node({op:'ColorRamp',inputs:{3:enumValue('ColorRamp',3,'Linear')},ramp:[
+    {position:start,color:dark === undefined ? {x:0.018,y:0.04,z:0.085} : gray(dark)},
+    {position:end,color:light === undefined ? {x:0.94,y:0.78,z:0.36} : gray(light)}
+  ]}));
+}
+nodes.push(womp.materials.node({op:'OutputMaterial'}));
 const graph = {nodes,connections:nodes.slice(1).map((_,i) => ({input_node:i,input_slot:0,output_node:i+1,output_slot:0,flags:0}))};`;
 // Append to MATERIALS_NORMAL_MAP_RECIPE before writing.
-export const MATERIALS_COMBINED_NORMAL_RECIPE = `const extra = await womp.materials.catalog({operations:['NoiseFBM','Bump','SplitValues','CombineValues','Math']});
-Object.assign(catalogue.nodes,extra.nodes);
-graph.nodes.pop();
-graph.connections.pop();
-graph.nodes.push(
-  womp.materials.node({op:'NoiseFBM',inputs:{1:4,2:3,3:1,4:0}}),
-  womp.materials.node({op:'Bump',inputs:{1:0.08}}),
-  womp.materials.node({op:'SplitValues'}),
-  womp.materials.node({op:'SplitValues'}),
-  womp.materials.node({op:'Math',inputs:{0:enumValue('Math',0,'Add'),3:0}}),
-  womp.materials.node({op:'Math',inputs:{0:enumValue('Math',0,'Mulitiply'),3:0}}),
-  womp.materials.node({op:'SplitValues'}),
-  womp.materials.node({op:'CombineValues'}),
-  womp.materials.node({op:'Math',inputs:{0:enumValue('Math',0,'Normalize'),3:0}}),
-  womp.materials.node({op:'OutputSurfaceNormal'})
-);
-graph.connections.push(
-  {input_node:3,input_slot:0,output_node:8,output_slot:0,flags:0},
-  {input_node:8,input_slot:0,output_node:9,output_slot:0,flags:0},
-  {input_node:7,input_slot:0,output_node:10,output_slot:0,flags:0},
-  {input_node:9,input_slot:0,output_node:11,output_slot:0,flags:0},
-  {input_node:7,input_slot:0,output_node:12,output_slot:1,flags:0},
-  {input_node:9,input_slot:0,output_node:12,output_slot:2,flags:0},
-  {input_node:10,input_slot:2,output_node:13,output_slot:1,flags:0},
-  {input_node:11,input_slot:2,output_node:13,output_slot:2,flags:0},
-  {input_node:12,input_slot:0,output_node:14,output_slot:0,flags:0},
-  {input_node:14,input_slot:0,output_node:15,output_slot:0,flags:0},
-  {input_node:14,input_slot:1,output_node:15,output_slot:1,flags:0},
-  {input_node:13,input_slot:0,output_node:15,output_slot:2,flags:0},
-  {input_node:15,input_slot:0,output_node:16,output_slot:1,flags:0},
-  {input_node:16,input_slot:0,output_node:17,output_slot:0,flags:0}
+export const MATERIALS_COMBINED_NORMAL_RECIPE = `const extra = await womp.materials.catalog({operations:['NoiseFBM','Bump','SplitValues','CombineValues','Math']});
+Object.assign(catalogue.nodes,extra.nodes);
+graph.nodes.pop();
+graph.connections.pop();
+graph.nodes.push(
+  womp.materials.node({op:'NoiseFBM',inputs:{1:4,2:3,3:1,4:0}}),
+  womp.materials.node({op:'Bump',inputs:{1:0.08}}),
+  womp.materials.node({op:'SplitValues'}),
+  womp.materials.node({op:'SplitValues'}),
+  womp.materials.node({op:'Math',inputs:{0:enumValue('Math',0,'Add'),3:0}}),
+  womp.materials.node({op:'Math',inputs:{0:enumValue('Math',0,'Mulitiply'),3:0}}),
+  womp.materials.node({op:'SplitValues'}),
+  womp.materials.node({op:'CombineValues'}),
+  womp.materials.node({op:'Math',inputs:{0:enumValue('Math',0,'Normalize'),3:0}}),
+  womp.materials.node({op:'OutputSurfaceNormal'})
+);
+graph.connections.push(
+  {input_node:3,input_slot:0,output_node:8,output_slot:0,flags:0},
+  {input_node:8,input_slot:0,output_node:9,output_slot:0,flags:0},
+  {input_node:7,input_slot:0,output_node:10,output_slot:0,flags:0},
+  {input_node:9,input_slot:0,output_node:11,output_slot:0,flags:0},
+  {input_node:7,input_slot:0,output_node:12,output_slot:1,flags:0},
+  {input_node:9,input_slot:0,output_node:12,output_slot:2,flags:0},
+  {input_node:10,input_slot:2,output_node:13,output_slot:1,flags:0},
+  {input_node:11,input_slot:2,output_node:13,output_slot:2,flags:0},
+  {input_node:12,input_slot:0,output_node:14,output_slot:0,flags:0},
+  {input_node:14,input_slot:0,output_node:15,output_slot:0,flags:0},
+  {input_node:14,input_slot:1,output_node:15,output_slot:1,flags:0},
+  {input_node:13,input_slot:0,output_node:15,output_slot:2,flags:0},
+  {input_node:15,input_slot:0,output_node:16,output_slot:1,flags:0},
+  {input_node:16,input_slot:0,output_node:17,output_slot:0,flags:0}
 );`;
-export const MATERIALS_SCALAR_RGB_RECIPE = `await womp.materials.catalog({operations:['GetComponent','CombineValues']});
-const colorEdge = graph.connections.find(edge => graph.nodes[edge.output_node].op === 'OutputMaterial' && edge.output_slot === 0);
-if (!colorEdge) throw new Error('Scalar-to-RGB requires an existing primary-color connection');
-const component = graph.nodes.length;
-graph.nodes.push(
-  womp.materials.node({op:'GetComponent',inputs:{1:0}}),
-  womp.materials.node({op:'CombineValues'})
-);
-graph.connections.push(
-  {input_node:colorEdge.input_node,input_slot:colorEdge.input_slot,output_node:component,output_slot:0,flags:0},
-  ...[0,1,2].map(slot => ({input_node:component,input_slot:0,output_node:component+1,output_slot:slot,flags:0}))
-);
-colorEdge.input_node = component+1;
+export const MATERIALS_SCALAR_RGB_RECIPE = `await womp.materials.catalog({operations:['GetComponent','CombineValues']});
+const colorEdge = graph.connections.find(edge => graph.nodes[edge.output_node].op === 'OutputMaterial' && edge.output_slot === 0);
+if (!colorEdge) throw new Error('Scalar-to-RGB requires an existing primary-color connection');
+const component = graph.nodes.length;
+graph.nodes.push(
+  womp.materials.node({op:'GetComponent',inputs:{1:0}}),
+  womp.materials.node({op:'CombineValues'})
+);
+graph.connections.push(
+  {input_node:colorEdge.input_node,input_slot:colorEdge.input_slot,output_node:component,output_slot:0,flags:0},
+  ...[0,1,2].map(slot => ({input_node:component,input_slot:0,output_node:component+1,output_slot:slot,flags:0}))
+);
+colorEdge.input_node = component+1;
 colorEdge.input_slot = 0;`;
-export const MATERIALS_HSL_RECIPE = `await womp.materials.catalog({operations:['HSL']});
-const hslEdge = graph.connections.find(edge => graph.nodes[edge.output_node].op === 'OutputMaterial' && edge.output_slot === 0);
-if (!hslEdge) throw new Error('HSL adjustment requires an existing primary-color connection');
-const hsl = graph.nodes.length;
-graph.nodes.push(womp.materials.node({op:'HSL',inputs:{1:0.33,2:0.8,3:0}}));
-graph.connections.push({input_node:hslEdge.input_node,input_slot:hslEdge.input_slot,output_node:hsl,output_slot:0,flags:0});
-hslEdge.input_node = hsl;
+export const MATERIALS_HSL_RECIPE = `await womp.materials.catalog({operations:['HSL']});
+const hslEdge = graph.connections.find(edge => graph.nodes[edge.output_node].op === 'OutputMaterial' && edge.output_slot === 0);
+if (!hslEdge) throw new Error('HSL adjustment requires an existing primary-color connection');
+const hsl = graph.nodes.length;
+graph.nodes.push(womp.materials.node({op:'HSL',inputs:{1:0.33,2:0.8,3:0}}));
+graph.connections.push({input_node:hslEdge.input_node,input_slot:hslEdge.input_slot,output_node:hsl,output_slot:0,flags:0});
+hslEdge.input_node = hsl;
 hslEdge.input_slot = 0;`;
-export const MATERIALS_COORDINATE_SPACE_RECIPE = `if (!['InputPosition','InputWorldPosition'].includes(positionOp)) throw new Error('Choose InputPosition or InputWorldPosition');
-const coordinateCatalogue = await womp.materials.catalog({operations:[positionOp]});
-if (!coordinateCatalogue.nodes[positionOp]) throw new Error('Position source is not listed: ' + positionOp);
-const positionNodes = graph.nodes.filter(node => ['InputPosition','InputWorldPosition'].includes(node.op));
-if (positionNodes.length !== 1) throw new Error('Choose a specific position source in this graph before changing space');
-if (positionNodes[0].op !== positionOp && graph.nodes.some(node => node.op === 'Projection')) throw new Error('Projection position and normal spaces must be changed together; build that mapping explicitly');
+export const MATERIALS_COORDINATE_SPACE_RECIPE = `if (!['InputPosition','InputWorldPosition'].includes(positionOp)) throw new Error('Choose InputPosition or InputWorldPosition');
+const coordinateCatalogue = await womp.materials.catalog({operations:[positionOp]});
+if (!coordinateCatalogue.nodes[positionOp]) throw new Error('Position source is not listed: ' + positionOp);
+const positionNodes = graph.nodes.filter(node => ['InputPosition','InputWorldPosition'].includes(node.op));
+if (positionNodes.length !== 1) throw new Error('Choose a specific position source in this graph before changing space');
+if (positionNodes[0].op !== positionOp && graph.nodes.some(node => node.op === 'Projection')) throw new Error('Projection position and normal spaces must be changed together; build that mapping explicitly');
 positionNodes[0].op = positionOp;`;
-export const MATERIALS_CLONE_COLOR_RECIPE = `const sourceMaterial = await womp.materials.read(materialId);
-const sourceConstant = sourceMaterial.material.layers.flatMap(layer => layer?.nodes ?? []).find(node => node.op === 'Constant' && node.reference_id === referenceId);
-if (!sourceConstant) throw new Error('No Constant with reference ' + referenceId + ' in material ' + materialId);
-const cloned = await womp.materials.write({cloneFrom:materialId,objectIds:[objectId]});
-const clonedReference = cloned.referenceIdChanges[String(referenceId)] ?? referenceId;
-print({clonedMaterialId:cloned.materialId,referenceId:clonedReference});
-const cloneState = await womp.materials.read(cloned.materialId);
-const cloneConstant = cloneState.material.layers.flatMap(layer => layer?.nodes ?? []).find(node => node.op === 'Constant' && node.reference_id === clonedReference);
-if (!cloneConstant) throw new Error('Cloned Constant changed; inspect material ' + cloned.materialId + ' before editing');
-const override = cloneState.material.data.constants?.[String(clonedReference)];
-const zero = {x:0,y:0,z:0};
-const preservedValue = override === undefined ? (cloneConstant.in1 ?? zero) : (override.value ?? zero);
+export const MATERIALS_CLONE_COLOR_RECIPE = `const sourceMaterial = await womp.materials.read(materialId);
+const sourceConstant = sourceMaterial.material.layers.flatMap(layer => layer?.nodes ?? []).find(node => node.op === 'Constant' && node.reference_id === referenceId);
+if (!sourceConstant) throw new Error('No Constant with reference ' + referenceId + ' in material ' + materialId);
+const cloned = await womp.materials.write({cloneFrom:materialId,objectIds:[objectId]});
+const clonedReference = cloned.referenceIdChanges[String(referenceId)] ?? referenceId;
+print({clonedMaterialId:cloned.materialId,referenceId:clonedReference});
+const cloneState = await womp.materials.read(cloned.materialId);
+const cloneConstant = cloneState.material.layers.flatMap(layer => layer?.nodes ?? []).find(node => node.op === 'Constant' && node.reference_id === clonedReference);
+if (!cloneConstant) throw new Error('Cloned Constant changed; inspect material ' + cloned.materialId + ' before editing');
+const override = cloneState.material.data.constants?.[String(clonedReference)];
+const zero = {x:0,y:0,z:0};
+const preservedValue = override === undefined ? (cloneConstant.in1 ?? zero) : (override.value ?? zero);
 print(await womp.materials.write({materialId:cloned.materialId,constants:{[clonedReference]:{value:preservedValue,color:newColor}}}));`;
-export const MATERIALS_RESET_CONSTANT_RECIPE = `const reset = await womp.materials.write({materialId,constants:{[referenceId]:null}});
-print(reset);
-const afterReset = await womp.materials.read(materialId);
-const resetReference = reset.referenceIdChanges[String(referenceId)];
+export const MATERIALS_RESET_CONSTANT_RECIPE = `const reset = await womp.materials.write({materialId,constants:{[referenceId]:null}});
+print(reset);
+const afterReset = await womp.materials.read(materialId);
+const resetReference = reset.referenceIdChanges[String(referenceId)];
 print({materialId,referenceId:resetReference,material:afterReset.material});`;
-export const MATERIALS_RECIPES = `
-The graph examples construct one shader layer with womp.materials; the clone and reset examples perform writes. recipe() resolves its own live selectors; use these known starting patterns without requesting their descriptors. For custom graphs, discover only unfamiliar operations and required texture resource names. The graph snippets leave a variable named graph for assignment.
-
-Reusable surface graphs
-const settings = {
-  coordinateSpace:'object', featureSize:1,
-  colorA:{x:0.45,y:0.35,z:0.2}, colorB:{x:0.02,y:0.02,z:0.02},
-  roughnessA:0.45, roughnessB:0.45, relief:'height', reliefScale:0.0003
-};
-const graph = await womp.materials.recipe({pattern:'grid',...settings});
-// This single probe includes 1-unit major cells and 0.1-unit minor cells.
-const isolated = await womp.materials.write({cloneFrom:materialId,layers:[graph],objectIds});
-// Inspect complementary views together before replacing the probe on this isolated material.
-// Choose noise for irregular grain/pores, grain for elongated structure, woven for crossed threads.
-// Set colors, finish and feature size from the requested surface, rather than retaining probe values.
-const surface = await womp.materials.recipe({pattern, ...surfaceSettings});
-print(await womp.materials.write({materialId:isolated.materialId,layers:[surface],objectIds}));
-
-featureSize is the repeat scale in object coordinates, or physical mm with coordinateSpace:'world'. Colors in settings are linear RGB; convert display palettes before using them. An axis vector gives deliberate anisotropy; grain stretches along the largest component. Object coordinates belong to the carrier and can differ across primitives and meshes. Check the probe against actual geometry dimensions and transforms before translating its spacing into physical dimensions. World coordinates give consistent physical spacing across differently scaled carriers, but remain anchored to the scene. These graphs are editable starting structures: add the target's distinctive pores, loops, knots or irregular threads when required. Strongly stretched noise alone can look smeared; separate directional structure from broad color variation and fine roughness/relief.
-${MATERIAL_RECIPE_RELIEF_GUIDANCE}
-
-Compose generic scalar fields
-Build broad variation, defining structure and fine detail with field(), using independent scales and contrast. Custom generators, domain warping, periodic profiles or masks can supply the same {graph,source:{node,slot}} contract. Retrieve unfamiliar descriptors together. compose() remaps imported node indices and wires weighted channels; it does not prescribe a material family.
-Set fields to terminal-free fields and colorWeights, roughnessWeights and reliefWeights to arrays with one weight per field. Omitted or all-zero channels inherit the incoming material. Normalized color/roughness fields use nonnegative weights summing to at most 1 and valid linear colorLow/colorHigh and roughnessLow/roughnessHigh endpoints. Relief weights may be signed; choose reliefScale from the actual gradient. Combined scalar height is converted to normals once. Keep coordinates compatible and preserve fine detail's own scale and contrast. Named Constant handles from write() permit parameter-only refinement without rebuilding these graphs.
-${MATERIALS_FIELD_COMPOSITION_SNIPPET}
-
-Texture projection
-Set textureName to a listed RGB color resource and projectionName to a listed Projection mode. Position and normal rotations stay paired. Choose Planar, Cubic, Cylindrical, Equirectangular, Triplanar or a normalized mode for the carrier, then inspect its seams and transitions at the intended size.
-${MATERIALS_PROJECTION_RECIPE}
-
-Tangent normal texture
-Set textureName to a known normal-map resource. The graph uses Normal decoding and Equirectangular projection; adapt projection and map convention to the carrier. It changes shading normals, not geometry.
-${MATERIALS_NORMAL_MAP_RECIPE}
-
-Height texture
-Set textureName to a known scalar resource and heightScale to a finite positive value. This uses No transform decoding and OutputHeight Scale; it is not numerically equivalent to tangent-normal strength.
-${MATERIALS_HEIGHT_MAP_RECIPE}
-
-Combine normal texture and procedural bump
-Append this immediately after the tangent-normal graph above, before writing. Its node indices depend on that graph. The whiteout composition is approximate; inspect the combined result and each component under the same light.
-${MATERIALS_COMBINED_NORMAL_RECIPE}
-
-Scalar texture to neutral RGB
-Append this to a graph with an existing primary-color connection only when the sampled texture is known to be single-channel. It copies X/R to all three color channels.
-${MATERIALS_SCALAR_RGB_RECIPE}
-
-HSL adjustment
-Append this to a graph with an existing primary-color connection. Lightness 0 leaves that component unchanged.
-${MATERIALS_HSL_RECIPE}
-
-Local or world coordinates
-Set positionOp to InputPosition or InputWorldPosition. This changes one position source in a simple mapping graph; a Projection graph also needs a matching normal-space change.
-${MATERIALS_COORDINATE_SPACE_RECIPE}
-
-Generators
-Set generatorName to Noise1D, Noise3D, NoiseFBM, NoiseVoronoi, WavesTexture, CheckerTexture or MagicTexture. The settings are starting examples, not a complete operation catalogue; adjust one control at a time.
-${MATERIALS_GENERATOR_RECIPE}
-
-Assign the selected graph
-print(await womp.materials.write({layers:[graph],objectIds:[objectId]}));
-
-Clone a material and edit one Constant
-Set materialId, objectId and referenceId from a current read, with newColor as a 0..1 RGB vector. The workflow retains the source material and the Constant's numeric value. Inspect the printed clone ID before any retry.
-${MATERIALS_CLONE_COLOR_RECIPE}
-
-Reset a Constant override
-Set materialId and referenceId to the current IDs. The reset returns a new reference ID; use a fresh read before further edits.
-${MATERIALS_RESET_CONSTANT_RECIPE}
-
-A successful write is a scene commit, not evidence that shader compilation or texture loading completed. Check status() and an inspected image separately; status() observations can be null when a query fails.
+export const MATERIALS_RECIPES = `
+The graph examples construct one shader layer with womp.materials; the clone and reset examples perform writes. recipe() resolves its own live selectors; use these known starting patterns without requesting their descriptors. For custom graphs, discover only unfamiliar operations and required texture resource names. The graph snippets leave a variable named graph for assignment.
+
+Reusable surface graphs
+const settings = {
+  coordinateSpace:'object', featureSize:1,
+  colorA:{x:0.45,y:0.35,z:0.2}, colorB:{x:0.02,y:0.02,z:0.02},
+  roughnessA:0.45, roughnessB:0.45, relief:'height', reliefScale:0.0003
+};
+const graph = await womp.materials.recipe({pattern:'grid',...settings});
+// This single probe includes 1-unit major cells and 0.1-unit minor cells.
+const isolated = await womp.materials.write({cloneFrom:materialId,layers:[graph],objectIds});
+// Inspect complementary views together before replacing the probe on this isolated material.
+// Choose noise for irregular grain/pores, grain for elongated structure, woven for crossed threads.
+// Set colors, finish and feature size from the requested surface, rather than retaining probe values.
+const surface = await womp.materials.recipe({pattern, ...surfaceSettings});
+print(await womp.materials.write({materialId:isolated.materialId,layers:[surface],objectIds}));
+
+featureSize is the repeat scale in object coordinates, or physical mm with coordinateSpace:'world'. Colors in settings are linear RGB; convert display palettes before using them. An axis vector gives deliberate anisotropy; grain stretches along the largest component. Object coordinates belong to the carrier and can differ across primitives and meshes. Check the probe against actual geometry dimensions and transforms before translating its spacing into physical dimensions. World coordinates give consistent physical spacing across differently scaled carriers, but remain anchored to the scene. These graphs are editable starting structures: add the target's distinctive pores, loops, knots or irregular threads when required. Strongly stretched noise alone can look smeared; separate directional structure from broad color variation and fine roughness/relief.
+${MATERIAL_RECIPE_RELIEF_GUIDANCE}
+
+Compose generic scalar fields
+Build broad variation, defining structure and fine detail with field(), using independent scales and contrast. Custom generators, domain warping, periodic profiles or masks can supply the same {graph,source:{node,slot}} contract. Retrieve unfamiliar descriptors together. compose() remaps imported node indices and wires weighted channels; it does not prescribe a material family.
+Set fields to terminal-free fields and colorWeights, roughnessWeights and reliefWeights to arrays with one weight per field. Omitted or all-zero channels inherit the incoming material. Normalized color/roughness fields use nonnegative weights summing to at most 1 and valid linear colorLow/colorHigh and roughnessLow/roughnessHigh endpoints. Relief weights may be signed; choose reliefScale from the actual gradient. Combined scalar height is converted to normals once. Keep coordinates compatible and preserve fine detail's own scale and contrast. Named Constant handles from write() permit parameter-only refinement without rebuilding these graphs.
+${MATERIALS_FIELD_COMPOSITION_SNIPPET}
+
+Texture projection
+Set textureName to a listed RGB color resource and projectionName to a listed Projection mode. Position and normal rotations stay paired. Choose Planar, Cubic, Cylindrical, Equirectangular, Triplanar or a normalized mode for the carrier, then inspect its seams and transitions at the intended size.
+${MATERIALS_PROJECTION_RECIPE}
+
+Tangent normal texture
+Set textureName to a known normal-map resource. The graph uses Normal decoding and Equirectangular projection; adapt projection and map convention to the carrier. It changes shading normals, not geometry.
+${MATERIALS_NORMAL_MAP_RECIPE}
+
+Height texture
+Set textureName to a known scalar resource and heightScale to a finite positive value. This uses No transform decoding and OutputHeight Scale; it is not numerically equivalent to tangent-normal strength.
+${MATERIALS_HEIGHT_MAP_RECIPE}
+
+Combine normal texture and procedural bump
+Append this immediately after the tangent-normal graph above, before writing. Its node indices depend on that graph. The whiteout composition is approximate; inspect the combined result and each component under the same light.
+${MATERIALS_COMBINED_NORMAL_RECIPE}
+
+Scalar texture to neutral RGB
+Append this to a graph with an existing primary-color connection only when the sampled texture is known to be single-channel. It copies X/R to all three color channels.
+${MATERIALS_SCALAR_RGB_RECIPE}
+
+HSL adjustment
+Append this to a graph with an existing primary-color connection. Lightness 0 leaves that component unchanged.
+${MATERIALS_HSL_RECIPE}
+
+Local or world coordinates
+Set positionOp to InputPosition or InputWorldPosition. This changes one position source in a simple mapping graph; a Projection graph also needs a matching normal-space change.
+${MATERIALS_COORDINATE_SPACE_RECIPE}
+
+Generators
+Set generatorName to Noise1D, Noise3D, NoiseFBM, NoiseVoronoi, WavesTexture, CheckerTexture or MagicTexture. The settings are starting examples, not a complete operation catalogue; adjust one control at a time.
+${MATERIALS_GENERATOR_RECIPE}
+
+Assign the selected graph
+print(await womp.materials.write({layers:[graph],objectIds:[objectId]}));
+
+Clone a material and edit one Constant
+Set materialId, objectId and referenceId from a current read, with newColor as a 0..1 RGB vector. The workflow retains the source material and the Constant's numeric value. Inspect the printed clone ID before any retry.
+${MATERIALS_CLONE_COLOR_RECIPE}
+
+Reset a Constant override
+Set materialId and referenceId to the current IDs. The reset returns a new reference ID; use a fresh read before further edits.
+${MATERIALS_RESET_CONSTANT_RECIPE}
+
+A successful write is a scene commit, not evidence that shader compilation or texture loading completed. Check status() and an inspected image separately; status() observations can be null when a query fails.
 `;