@yali-engine/tsl 0.0.0-stage → 0.4.0

package/bin/compile.mjs

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+// The `materials` build step (ADR-0064): compiles every `*.material.ts` under <dir> (its default
+// export, named after the file; or its named exports, named after them) to WGSL, and writes
+// one module of plain data (`MaterialShader`s) for the app to register. A production build
+// ships this output, not @yali-engine/tsl's compiler.
+//
+//   node --experimental-strip-types bin/compile.mjs <dir> <out.ts> [--check]
+//
+// --check exits 1 when <out.ts> is stale (CI). Output is deterministic: files and exports in
+// sorted order, each material's WGSL as compileMaterial gives it.
+import { existsSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import { join, relative, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+const [dirArg, outArg] = process.argv.slice(2).filter((a) => !a.startsWith('--'));
+if (!dirArg || !outArg) {
+  console.error('usage: compile.mjs <materials dir> <out.ts> [--check]');
+  process.exit(2);
+}
+const dir = resolve(dirArg);
+const out = resolve(outArg);
+// In the workspace: the TypeScript source; published (no src): the built JS.
+const source = new URL('../src/index.ts', import.meta.url);
+const { compileMaterial } = await import((existsSync(source) ? source : new URL('../dist/index.js', import.meta.url)).href);
+
+const files = [];
+const walk = (d) => {
+  for (const e of readdirSync(d).sort()) {
+    const p = join(d, e);
+    if (statSync(p).isDirectory()) walk(p);
+    else if (e.endsWith('.material.ts')) files.push(p);
+  }
+};
+if (existsSync(dir)) walk(dir);
+
+const compiled = [];
+for (const f of files) {
+  const mod = await import(pathToFileURL(f).href);
+  const base = f.split(/[\\/]/).pop().replace(/\.material\.ts$/, '');
+  for (const key of Object.keys(mod).sort()) {
+    const name = key === 'default' ? base.replace(/[^a-zA-Z0-9_]/g, '_') : key;
+    if (!mod[key] || !Array.isArray(mod[key].outputs)) continue;
+    if (compiled.some((c) => c.name === name)) throw new Error(`Two node materials are named "${name}" (${relative(process.cwd(), f)}).`);
+    compiled.push(compileMaterial(name, mod[key]));
+  }
+}
+
+const rel = relative(process.cwd(), dir).split('\\').join('/');
+const text = [
+  `// GENERATED by @yali-engine/tsl (bin/compile.mjs) from ${rel}/**/*.material.ts. Do not edit.`,
+  '// Register with render.materials.registerShader(shader); ADR-0064.',
+  '',
+  ...compiled.map((c) => `export const ${c.name} = ${JSON.stringify({ name: c.name, entry: c.entry, hash: c.hash, params: c.params, textures: c.textures, wgsl: c.wgsl }, null, 2)} as const;\n`),
+  `export const all = [${compiled.map((c) => c.name).join(', ')}] as const;`,
+  '',
+].join('\n');
+
+const current = existsSync(out) ? readFileSync(out, 'utf8') : '';
+if (process.argv.includes('--check')) {
+  if (current !== text) {
+    console.error(JSON.stringify({ tsl: 'stale', out: relative(process.cwd(), out), fix: `node --experimental-strip-types packages/tsl/bin/compile.mjs ${dirArg} ${outArg}` }));
+    process.exit(1);
+  }
+  console.log(JSON.stringify({ tsl: 'up-to-date', materials: compiled.map((c) => c.name) }));
+} else {
+  if (current !== text) writeFileSync(out, text);
+  console.log(JSON.stringify({ tsl: current === text ? 'up-to-date' : 'written', materials: compiled.map((c) => ({ name: c.name, hash: c.hash, params: c.params.length, textures: c.textures })) }));
+}

package/dist/builders.d.ts

@@ -0,0 +1,64 @@
+import { Node, type NodeLike } from './node.ts';
+/** A float node (`float(0.5)`, or a node converted to a float). */
+export declare const float: (v: NodeLike) => Node;
+export declare const vec2: (...p: NodeLike[]) => Node;
+export declare const vec3: (...p: NodeLike[]) => Node;
+export declare const vec4: (...p: NodeLike[]) => Node;
+/** A colour as a vec3: `color(0xff8800)` (sRGB hex, converted to linear) or `color(r, g, b)` (linear). */
+export declare function color(r: number, g?: number, b?: number): Node;
+/** The mesh's first UV set (`uv()`). */
+export declare const uv: () => Node;
+/** The interpolated world-space normal, normalized. */
+export declare const normalWorld: Node;
+/** The fragment's position, world space but camera-relative (ADR-0008: the camera is the origin). */
+export declare const positionWorld: Node;
+/** Unit vector from the fragment towards the camera. */
+export declare const viewDirection: Node;
+/** The instance's `render.Mesh.color`, linear RGB. */
+export declare const instanceColor: Node;
+/** Seconds since the app started (the render plugin's clock). */
+export declare const time: Node;
+/**
+ * A material parameter: a named value each material made from this shader may set
+ * (`materials.add({ shader, params: { tint: [1, 0, 0] } })`), stored in the material's record
+ * (ADR-0064), so changing it never recompiles. `value` is its default.
+ */
+export declare function uniform(value: number | readonly number[], name: string): Node;
+/** Texture slots a material record holds (ADR-0060): colour slots are sRGB, data slots linear. */
+export type TextureSlot = 'baseColor' | 'normal' | 'orm' | 'emissive';
+/**
+ * Samples one of the material's texture slots (`texture('baseColor', uv())`), as RGBA: white
+ * when the material has no texture there, the magenta checker when it failed to load.
+ */
+export declare function texture(slot: TextureSlot, coords?: Node): Node;
+/** `cond ? a : b`, without a branch (TSL `select`; WGSL `select(b, a, cond)`). */
+export declare function select(cond: Node, a: NodeLike, b: NodeLike): Node;
+export declare const abs: (a: NodeLike) => Node;
+export declare const sin: (a: NodeLike) => Node;
+export declare const cos: (a: NodeLike) => Node;
+export declare const floor: (a: NodeLike) => Node;
+export declare const fract: (a: NodeLike) => Node;
+export declare const sqrt: (a: NodeLike) => Node;
+export declare const exp: (a: NodeLike) => Node;
+export declare const normalize: (a: NodeLike) => Node;
+export declare const length: (a: NodeLike) => Node;
+export declare const saturate: (a: NodeLike) => Node;
+export declare const min: (a: NodeLike, b: NodeLike) => Node;
+export declare const max: (a: NodeLike, b: NodeLike) => Node;
+export declare const pow: (a: NodeLike, b: NodeLike) => Node;
+export declare const step: (edge: NodeLike, x: NodeLike) => Node;
+export declare const dot: (a: NodeLike, b: NodeLike) => Node;
+export declare const cross: (a: NodeLike, b: NodeLike) => Node;
+export declare const reflect: (a: NodeLike, n: NodeLike) => Node;
+export declare const clamp: (x: NodeLike, lo: NodeLike, hi: NodeLike) => Node;
+export declare const mix: (a: NodeLike, b: NodeLike, t: NodeLike) => Node;
+export declare const smoothstep: (lo: NodeLike, hi: NodeLike, x: NodeLike) => Node;
+/**
+ * A reusable graph function, as TSL's `Fn`: called with nodes, it returns the node its body
+ * builds. Expanded inline (the code generator shares identical subgraphs), so it costs nothing.
+ *
+ * @example
+ * const fresnel = Fn(([power]: Node[]) => float(1).sub(normalWorld.dot(viewDirection).saturate()).pow(power));
+ * emissiveNode: color(0x3366ff).mul(fresnel(float(3)))
+ */
+export declare function Fn<A extends Node[]>(body: (args: A) => Node): (...args: A) => Node;

package/dist/builders.js

@@ -0,0 +1,99 @@
+import { YaliError } from '@yali-engine/core';
+import { call, construct, Node, nodeOf } from "./node.js";
+// Constructors (three.js TSL names).
+/** A float node (`float(0.5)`, or a node converted to a float). */
+export const float = (v) => nodeOf(v);
+export const vec2 = (...p) => construct('vec2f', p);
+export const vec3 = (...p) => construct('vec3f', p);
+export const vec4 = (...p) => construct('vec4f', p);
+/** A colour as a vec3: `color(0xff8800)` (sRGB hex, converted to linear) or `color(r, g, b)` (linear). */
+export function color(r, g, b) {
+    if (g === undefined) {
+        const lin = (c) => (c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4);
+        return vec3(lin(((r >> 16) & 255) / 255), lin(((r >> 8) & 255) / 255), lin((r & 255) / 255));
+    }
+    return vec3(r, g, b ?? 0);
+}
+// Inputs the surface stage provides (named as in three.js TSL).
+const input = (name, type) => new Node('input', type, [], name);
+/** The mesh's first UV set (`uv()`). */
+export const uv = () => input('uv', 'vec2f');
+/** The interpolated world-space normal, normalized. */
+export const normalWorld = input('normal_world', 'vec3f');
+/** The fragment's position, world space but camera-relative (ADR-0008: the camera is the origin). */
+export const positionWorld = input('position_world', 'vec3f');
+/** Unit vector from the fragment towards the camera. */
+export const viewDirection = input('view_dir', 'vec3f');
+/** The instance's `render.Mesh.color`, linear RGB. */
+export const instanceColor = input('instance_color', 'vec3f');
+/** Seconds since the app started (the render plugin's clock). */
+export const time = input('time', 'f32');
+/**
+ * A material parameter: a named value each material made from this shader may set
+ * (`materials.add({ shader, params: { tint: [1, 0, 0] } })`), stored in the material's record
+ * (ADR-0064), so changing it never recompiles. `value` is its default.
+ */
+export function uniform(value, name) {
+    if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(name))
+        throw new YaliError('TSL_UNIFORM', `"${name}" is not a valid uniform name.`, 'Use letters, digits and _, starting with a letter.');
+    const v = typeof value === 'number' ? [value] : [...value];
+    if (v.length < 1 || v.length > 4 || v.some((x) => !Number.isFinite(x)))
+        throw new YaliError('TSL_UNIFORM', `Uniform "${name}" needs 1–4 finite numbers.`, 'Pass a number or an array of up to four.');
+    const type = ['f32', 'vec2f', 'vec3f', 'vec4f'][v.length - 1];
+    return new Node('uniform', type, [], [name, ...v.map(String)].join('|'));
+}
+const SLOTS = ['baseColor', 'normal', 'orm', 'emissive'];
+/**
+ * Samples one of the material's texture slots (`texture('baseColor', uv())`), as RGBA: white
+ * when the material has no texture there, the magenta checker when it failed to load.
+ */
+export function texture(slot, coords = uv()) {
+    if (!SLOTS.includes(slot))
+        throw new YaliError('TSL_TEXTURE', `"${slot}" is not a texture slot.`, `Use one of: ${SLOTS.join(', ')}.`);
+    if (coords.type !== 'vec2f')
+        throw new YaliError('TSL_TYPE', `texture() needs vec2 coordinates, not ${coords.type}.`, 'Pass uv() or a vec2 node.');
+    return new Node('texture', 'vec4f', [coords], slot);
+}
+/** `cond ? a : b`, without a branch (TSL `select`; WGSL `select(b, a, cond)`). */
+export function select(cond, a, b) {
+    const [x, y] = [nodeOf(a), nodeOf(b)];
+    if (cond.type !== 'bool')
+        throw new YaliError('TSL_TYPE', `select() needs a bool condition, not ${cond.type}.`, 'Use a comparison: a.lessThan(b).');
+    const type = x.type === y.type ? x.type : x.type === 'f32' ? y.type : y.type === 'f32' ? x.type : null;
+    if (!type)
+        throw new YaliError('TSL_TYPE', `select() branches are ${x.type} and ${y.type}.`, 'Make both branches the same type.');
+    return new Node('select', type, [cond, x.type === type ? x : construct(type, [x]), y.type === type ? y : construct(type, [y])], 'select');
+}
+// Functions (WGSL built-ins under their TSL names).
+export const abs = (a) => call('abs', [a]);
+export const sin = (a) => call('sin', [a]);
+export const cos = (a) => call('cos', [a]);
+export const floor = (a) => call('floor', [a]);
+export const fract = (a) => call('fract', [a]);
+export const sqrt = (a) => call('sqrt', [a]);
+export const exp = (a) => call('exp', [a]);
+export const normalize = (a) => call('normalize', [a]);
+export const length = (a) => call('length', [a]);
+export const saturate = (a) => call('saturate', [a]);
+export const min = (a, b) => call('min', [a, b]);
+export const max = (a, b) => call('max', [a, b]);
+export const pow = (a, b) => call('pow', [a, b]);
+export const step = (edge, x) => call('step', [edge, x]);
+export const dot = (a, b) => call('dot', [a, b]);
+export const cross = (a, b) => call('cross', [a, b]);
+export const reflect = (a, n) => call('reflect', [a, n]);
+export const clamp = (x, lo, hi) => call('clamp', [x, lo, hi]);
+export const mix = (a, b, t) => call('mix', [a, b, t]);
+export const smoothstep = (lo, hi, x) => call('smoothstep', [lo, hi, x]);
+/**
+ * A reusable graph function, as TSL's `Fn`: called with nodes, it returns the node its body
+ * builds. Expanded inline (the code generator shares identical subgraphs), so it costs nothing.
+ *
+ * @example
+ * const fresnel = Fn(([power]: Node[]) => float(1).sub(normalWorld.dot(viewDirection).saturate()).pow(power));
+ * emissiveNode: color(0x3366ff).mul(fresnel(float(3)))
+ */
+export function Fn(body) {
+    return (...args) => body(args);
+}
+//# sourceMappingURL=builders.js.map

package/dist/builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builders.js","sourceRoot":"","sources":["../src/builders.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `@yali-engine/tsl`: materials as node graphs with three.js TSL's names (ADR-0007, ADR-0064).
+ * Graphs are plain data; `compileMaterial` turns one into a WGSL function the scene's draw
+ * shader calls, and the `materials` build step does that for every `*.material.ts` file, so a
+ * production build ships WGSL, not this compiler.
+ *
+ * @example
+ * // src/materials/lava.material.ts
+ * import { color, mix, nodeMaterial, sin, time, uniform, uv } from '@yali-engine/tsl';
+ * export default nodeMaterial({
+ *   colorNode: mix(color(0x220000), color(0xff5500), sin(time.mul(2).add(uv().x.mul(9))).mul(0.5).add(0.5)),
+ *   emissiveNode: color(0xff3300).mul(uniform(1.5, 'glow')),
+ * });
+ */
+export * from './builders.ts';
+export { type CompiledMaterial, compileMaterial, type MaterialParam, type NodeMaterial, type NodeMaterialDef, nodeMaterial, PARAM_FLOATS } from './material.ts';
+export { call, construct, lanesOf, Node, type NodeLike, nodeOf, type NodeType } from './node.ts';

package/dist/index.js

@@ -0,0 +1,18 @@
+/**
+ * `@yali-engine/tsl`: materials as node graphs with three.js TSL's names (ADR-0007, ADR-0064).
+ * Graphs are plain data; `compileMaterial` turns one into a WGSL function the scene's draw
+ * shader calls, and the `materials` build step does that for every `*.material.ts` file, so a
+ * production build ships WGSL, not this compiler.
+ *
+ * @example
+ * // src/materials/lava.material.ts
+ * import { color, mix, nodeMaterial, sin, time, uniform, uv } from '@yali-engine/tsl';
+ * export default nodeMaterial({
+ *   colorNode: mix(color(0x220000), color(0xff5500), sin(time.mul(2).add(uv().x.mul(9))).mul(0.5).add(0.5)),
+ *   emissiveNode: color(0xff3300).mul(uniform(1.5, 'glow')),
+ * });
+ */
+export * from "./builders.js";
+export { compileMaterial, nodeMaterial, PARAM_FLOATS } from "./material.js";
+export { call, construct, lanesOf, Node, nodeOf } from "./node.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAyB,eAAe,EAA+D,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAChK,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAiB,MAAM,EAAiB,MAAM,WAAW,CAAC"}

package/dist/material.d.ts

@@ -0,0 +1,65 @@
+import { type TextureSlot } from './builders.ts';
+import { type Node, type NodeLike } from './node.ts';
+/** A material's surface outputs, named as three.js's MeshStandardNodeMaterial properties. */
+export interface NodeMaterialDef {
+    /** Linear base colour (vec3). Default: the instance's colour. */
+    readonly colorNode?: NodeLike;
+    /** 0–1. Default 1. */
+    readonly opacityNode?: NodeLike;
+    /** 0–1. Default 0. */
+    readonly metalnessNode?: NodeLike;
+    /** 0–1. Default 1. */
+    readonly roughnessNode?: NodeLike;
+    /** Linear emitted colour (vec3). Default black. */
+    readonly emissiveNode?: NodeLike;
+    /** World-space shading normal (vec3, normalized by the lighting). Default: the mesh's. */
+    readonly normalNode?: NodeLike;
+    /** Ambient occlusion 0–1. Default 1. */
+    readonly aoNode?: NodeLike;
+}
+/** Floats of per-material parameters in a material record (two vec4s; ADR-0064). */
+export declare const PARAM_FLOATS = 8;
+/** One material parameter's place in the record. */
+export interface MaterialParam {
+    readonly name: string;
+    readonly lanes: number;
+    /** Float index in the record's parameter block (0–7). */
+    readonly offset: number;
+    readonly default: readonly number[];
+}
+/** A material compiled to WGSL (what `materials.gen.ts` holds; ADR-0064). */
+export interface CompiledMaterial {
+    readonly name: string;
+    /** The WGSL function's name: `material_<name>`. */
+    readonly entry: string;
+    /** The function, `fn material_<name>(in: SurfaceInput, p: array<vec4f, 2>) -> Surface`. */
+    readonly wgsl: string;
+    /** FNV-1a of `wgsl`, hex: equal materials share a shader. */
+    readonly hash: string;
+    readonly params: readonly MaterialParam[];
+    /** Texture slots it samples. */
+    readonly textures: readonly TextureSlot[];
+}
+/** A material graph: its outputs, ready to compile. */
+export interface NodeMaterial {
+    readonly outputs: readonly Node[];
+}
+/**
+ * Declares a node material from its outputs, as three.js's `MeshStandardNodeMaterial`
+ * properties name them. Compile it with `compileMaterial` (the `materials` build step does).
+ *
+ * @example
+ * export const lava = nodeMaterial({
+ *   colorNode: mix(color(0x220000), color(0xff5500), sin(time.mul(2).add(uv().x.mul(9))).mul(0.5).add(0.5)),
+ *   emissiveNode: color(0xff3300).mul(uniform(1.5, 'glow')),
+ *   roughnessNode: float(0.6),
+ * });
+ */
+export declare function nodeMaterial(def: NodeMaterialDef): NodeMaterial;
+/**
+ * Compiles a node material to a WGSL function (ADR-0064). Identical subgraphs are computed
+ * once; variables are numbered in a fixed post-order from the outputs, so the same graph
+ * always gives the same text. Material parameters (`uniform`) are packed into the record's
+ * 8 floats without crossing a vec4; more is an error.
+ */
+export declare function compileMaterial(name: string, material: NodeMaterial): CompiledMaterial;

package/dist/material.js

@@ -0,0 +1,164 @@
+import { YaliError } from '@yali-engine/core';
+import { instanceColor, normalWorld } from "./builders.js";
+import { lanesOf, nodeOf } from "./node.js";
+/** The outputs in the order the generated `Surface` takes them, with their types and defaults. */
+const OUTPUTS = [
+    { key: 'colorNode', field: 'base_color', type: 'vec3f', fallback: () => instanceColor },
+    { key: 'opacityNode', field: 'opacity', type: 'f32', fallback: () => nodeOf(1) },
+    { key: 'metalnessNode', field: 'metalness', type: 'f32', fallback: () => nodeOf(0) },
+    { key: 'roughnessNode', field: 'roughness', type: 'f32', fallback: () => nodeOf(1) },
+    { key: 'emissiveNode', field: 'emissive', type: 'vec3f', fallback: () => nodeOf(0) },
+    { key: 'normalNode', field: 'normal', type: 'vec3f', fallback: () => normalWorld },
+    { key: 'aoNode', field: 'occlusion', type: 'f32', fallback: () => nodeOf(1) },
+];
+/** Floats of per-material parameters in a material record (two vec4s; ADR-0064). */
+export const PARAM_FLOATS = 8;
+/**
+ * Declares a node material from its outputs, as three.js's `MeshStandardNodeMaterial`
+ * properties name them. Compile it with `compileMaterial` (the `materials` build step does).
+ *
+ * @example
+ * export const lava = nodeMaterial({
+ *   colorNode: mix(color(0x220000), color(0xff5500), sin(time.mul(2).add(uv().x.mul(9))).mul(0.5).add(0.5)),
+ *   emissiveNode: color(0xff3300).mul(uniform(1.5, 'glow')),
+ *   roughnessNode: float(0.6),
+ * });
+ */
+export function nodeMaterial(def) {
+    const outputs = OUTPUTS.map((o) => {
+        const v = def[o.key];
+        const n = v === undefined ? o.fallback() : nodeOf(v);
+        if (n.type === o.type)
+            return n;
+        if (n.type === 'f32' && o.type !== 'f32')
+            return n; // splatted by the generator
+        throw new YaliError('TSL_OUTPUT', `${o.key} is ${n.type}; it must be ${o.type === 'f32' ? 'a float' : 'a vec3'}.`, `Swizzle or build a ${o.type} (e.g. vec3(x) or v.xyz).`);
+    });
+    return { outputs };
+}
+const GRAD_INPUT = 'uv';
+/**
+ * Compiles a node material to a WGSL function (ADR-0064). Identical subgraphs are computed
+ * once; variables are numbered in a fixed post-order from the outputs, so the same graph
+ * always gives the same text. Material parameters (`uniform`) are packed into the record's
+ * 8 floats without crossing a vec4; more is an error.
+ */
+export function compileMaterial(name, material) {
+    if (!/^[a-zA-Z][a-zA-Z0-9_]*$/.test(name))
+        throw new YaliError('TSL_NAME', `"${name}" is not a valid material name.`, 'Use letters, digits and _, starting with a letter.');
+    const lines = [];
+    const names = new Map();
+    const params = [];
+    const textures = new Set();
+    let next = 0;
+    const param = (n) => {
+        const [pname, ...vals] = String(n.value).split('|');
+        const existing = params.find((p) => p.name === pname);
+        if (existing) {
+            if (existing.lanes !== lanesOf(n.type))
+                throw new YaliError('TSL_UNIFORM', `Uniform "${pname}" is used with two sizes.`, 'Give each uniform one type.');
+            return existing;
+        }
+        const lanes = lanesOf(n.type);
+        let at = params.reduce((o, p) => Math.max(o, p.offset + p.lanes), 0);
+        if ((at % 4) + lanes > 4)
+            at = Math.ceil(at / 4) * 4;
+        if (at + lanes > PARAM_FLOATS) {
+            throw new YaliError('TSL_UNIFORMS', `Material "${name}" needs more than ${PARAM_FLOATS} uniform floats.`, 'Pack uniforms (a vec4 for four floats) or bake constants: a material record holds 8.');
+        }
+        const p = { name: pname, lanes, offset: at, default: vals.map(Number) };
+        params.push(p);
+        return p;
+    };
+    const lit = (v, type) => {
+        const f = (x) => (Number.isInteger(x) ? `${x}.0` : String(x));
+        return type === 'f32' ? f(v[0]) : `${type}(${v.map(f).join(', ')})`;
+    };
+    /** Gradients for texture coordinates: the UV set's, scaled when the coordinates are a tiled uv(). */
+    const gradients = (coords) => {
+        if (coords.kind === 'input' && coords.value === GRAD_INPUT)
+            return ['in.ddx', 'in.ddy'];
+        if (coords.kind === 'op' && (coords.value === '*' || coords.value === '+' || coords.value === '-')) {
+            const [a, b] = coords.args;
+            const uvSide = [a, b].findIndex((x) => x.kind === 'input' && x.value === GRAD_INPUT);
+            if (uvSide >= 0) {
+                if (coords.value !== '*')
+                    return ['in.ddx', 'in.ddy'];
+                const k = emit(coords.args[1 - uvSide]);
+                return [`in.ddx * ${k}`, `in.ddy * ${k}`];
+            }
+        }
+        return ['in.ddx', 'in.ddy'];
+    };
+    const emit = (n) => {
+        const known = names.get(n.key);
+        if (known)
+            return known;
+        let expr;
+        switch (n.kind) {
+            case 'const':
+                return lit(n.value, n.type); // inline, never a variable
+            case 'input':
+                return `in.${n.value}`;
+            case 'uniform': {
+                const p = param(n);
+                const comps = 'xyzw'.slice(p.offset % 4, (p.offset % 4) + p.lanes);
+                expr = `p[${Math.floor(p.offset / 4)}].${comps}`;
+                break;
+            }
+            case 'op': {
+                if (n.value === 'neg')
+                    expr = `-(${emit(n.args[0])})`;
+                else
+                    expr = `(${emit(n.args[0])} ${n.value} ${emit(n.args[1])})`;
+                break;
+            }
+            case 'call':
+                expr = `${n.value}(${n.args.map(emit).join(', ')})`;
+                break;
+            case 'swizzle':
+                expr = `${emit(n.args[0])}.${n.value}`;
+                break;
+            case 'construct':
+                expr = `${n.type}(${n.args.map(emit).join(', ')})`;
+                break;
+            case 'select':
+                expr = `select(${emit(n.args[2])}, ${emit(n.args[1])}, ${emit(n.args[0])})`;
+                break;
+            case 'texture': {
+                const slot = n.value;
+                textures.add(slot);
+                const [dx, dy] = gradients(n.args[0]);
+                const lane = { baseColor: 'x', normal: 'y', orm: 'z', emissive: 'w' }[slot];
+                const fn = slot === 'baseColor' || slot === 'emissive' ? 'sample_srgb' : 'sample_linear';
+                expr = `${fn}(in.maps.${lane}, ${emit(n.args[0])}, ${dx}, ${dy})`;
+                break;
+            }
+        }
+        const v = `v${next++}`;
+        lines.push(`  let ${v}: ${n.type} = ${expr};`);
+        names.set(n.key, v);
+        return v;
+    };
+    const outs = material.outputs.map((n, i) => {
+        const e = emit(n);
+        return OUTPUTS[i].type !== 'f32' && n.type === 'f32' ? `vec3f(${e})` : e;
+    });
+    const entry = `material_${name}`;
+    const wgsl = [
+        `fn ${entry}(in: SurfaceInput, p: array<vec4f, 2>) -> Surface {`,
+        ...lines,
+        `  return Surface(${outs.join(', ')});`,
+        '}',
+    ].join('\n');
+    return { name, entry, wgsl, hash: fnv1a(wgsl), params, textures: [...textures].sort() };
+}
+function fnv1a(s) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return (h >>> 0).toString(16).padStart(8, '0');
+}
+//# sourceMappingURL=material.js.map

package/dist/material.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"material.js","sourceRoot":"","sources":["../src/material.ts"],"names":[],"mappings":"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"}

package/dist/node.d.ts

@@ -0,0 +1,61 @@
+/** Value types a node can have (WGSL's names). */
+export type NodeType = 'f32' | 'vec2f' | 'vec3f' | 'vec4f' | 'bool' | 'u32';
+/** Lanes of a type (1 for scalars). */
+export declare const lanesOf: (t: NodeType) => number;
+/**
+ * One node of a material graph (ADR-0064): plain data (`kind`, `type`, `args`, a `value` for
+ * constants and inputs), so a graph serialises, diffs and edits like any data; the methods
+ * only build new nodes, mirroring three.js TSL (`a.mul(b).add(c)`, `v.xyz`).
+ */
+export declare class Node {
+    #private;
+    readonly kind: 'const' | 'input' | 'uniform' | 'op' | 'call' | 'swizzle' | 'construct' | 'texture' | 'select';
+    readonly type: NodeType;
+    readonly args: readonly Node[];
+    /** Constant values, an input's or uniform's name, a call's function, a swizzle mask. */
+    readonly value: string | readonly number[];
+    constructor(kind: Node['kind'], type: NodeType, args: readonly Node[], value: Node['value']);
+    /** A structural key: equal graphs have equal keys (the code generator shares them). */
+    get key(): string;
+    add(o: NodeLike): Node;
+    sub(o: NodeLike): Node;
+    mul(o: NodeLike): Node;
+    div(o: NodeLike): Node;
+    negate(): Node;
+    lessThan(o: NodeLike): Node;
+    greaterThan(o: NodeLike): Node;
+    lessThanEqual(o: NodeLike): Node;
+    greaterThanEqual(o: NodeLike): Node;
+    normalize(): Node;
+    length(): Node;
+    abs(): Node;
+    sin(): Node;
+    cos(): Node;
+    fract(): Node;
+    saturate(): Node;
+    clamp(lo: NodeLike, hi: NodeLike): Node;
+    pow(e: NodeLike): Node;
+    dot(o: NodeLike): Node;
+    mix(b: NodeLike, t: NodeLike): Node;
+    get x(): Node;
+    get y(): Node;
+    get z(): Node;
+    get w(): Node;
+    get xy(): Node;
+    get xyz(): Node;
+    get rgb(): Node;
+    get r(): Node;
+    get g(): Node;
+    get b(): Node;
+    get a(): Node;
+    /** Components by mask (`xyz`, `rgba`, `yx`…). */
+    swizzle(mask: string): Node;
+}
+/** What a builder accepts: a node or a plain number (a float constant). */
+export type NodeLike = Node | number;
+/** A node from a node or a number. */
+export declare function nodeOf(v: NodeLike): Node;
+/** A call of a WGSL built-in (`call('mix', [a, b, t])`). Scalars broadcast to the vector argument's type. */
+export declare function call(fn: string, args: readonly NodeLike[]): Node;
+/** A typed vector or scalar from components (`vec3(1, 0, 0)`, `vec4(rgb, 1)`, `vec3(0.5)` splats). */
+export declare function construct(type: NodeType, parts: readonly NodeLike[]): Node;

package/dist/node.js

@@ -0,0 +1,199 @@
+import { YaliError } from '@yali-engine/core';
+const LANES = { f32: 1, vec2f: 2, vec3f: 3, vec4f: 4, bool: 1, u32: 1 };
+const VEC = ['f32', 'f32', 'vec2f', 'vec3f', 'vec4f'];
+/** Lanes of a type (1 for scalars). */
+export const lanesOf = (t) => LANES[t];
+/**
+ * One node of a material graph (ADR-0064): plain data (`kind`, `type`, `args`, a `value` for
+ * constants and inputs), so a graph serialises, diffs and edits like any data; the methods
+ * only build new nodes, mirroring three.js TSL (`a.mul(b).add(c)`, `v.xyz`).
+ */
+export class Node {
+    kind;
+    type;
+    args;
+    /** Constant values, an input's or uniform's name, a call's function, a swizzle mask. */
+    value;
+    #key = null;
+    constructor(kind, type, args, value) {
+        this.kind = kind;
+        this.type = type;
+        this.args = args;
+        this.value = value;
+    }
+    /** A structural key: equal graphs have equal keys (the code generator shares them). */
+    get key() {
+        this.#key ??= `${this.kind}:${this.type}:${JSON.stringify(this.value)}(${this.args.map((a) => a.key).join(',')})`;
+        return this.#key;
+    }
+    add(o) {
+        return binary('+', this, o);
+    }
+    sub(o) {
+        return binary('-', this, o);
+    }
+    mul(o) {
+        return binary('*', this, o);
+    }
+    div(o) {
+        return binary('/', this, o);
+    }
+    negate() {
+        return new Node('op', this.type, [this], 'neg');
+    }
+    lessThan(o) {
+        return compare('<', this, o);
+    }
+    greaterThan(o) {
+        return compare('>', this, o);
+    }
+    lessThanEqual(o) {
+        return compare('<=', this, o);
+    }
+    greaterThanEqual(o) {
+        return compare('>=', this, o);
+    }
+    // Common functions as methods, as TSL allows (`v.normalize()`, `t.clamp(0, 1)`).
+    normalize() {
+        return call('normalize', [this]);
+    }
+    length() {
+        return call('length', [this]);
+    }
+    abs() {
+        return call('abs', [this]);
+    }
+    sin() {
+        return call('sin', [this]);
+    }
+    cos() {
+        return call('cos', [this]);
+    }
+    fract() {
+        return call('fract', [this]);
+    }
+    saturate() {
+        return call('saturate', [this]);
+    }
+    clamp(lo, hi) {
+        return call('clamp', [this, lo, hi]);
+    }
+    pow(e) {
+        return call('pow', [this, e]);
+    }
+    dot(o) {
+        return call('dot', [this, o]);
+    }
+    mix(b, t) {
+        return call('mix', [this, b, t]);
+    }
+    // Swizzles (the common ones; any mask through `swizzle`).
+    get x() {
+        return this.swizzle('x');
+    }
+    get y() {
+        return this.swizzle('y');
+    }
+    get z() {
+        return this.swizzle('z');
+    }
+    get w() {
+        return this.swizzle('w');
+    }
+    get xy() {
+        return this.swizzle('xy');
+    }
+    get xyz() {
+        return this.swizzle('xyz');
+    }
+    get rgb() {
+        return this.swizzle('xyz');
+    }
+    get r() {
+        return this.swizzle('x');
+    }
+    get g() {
+        return this.swizzle('y');
+    }
+    get b() {
+        return this.swizzle('z');
+    }
+    get a() {
+        return this.swizzle('w');
+    }
+    /** Components by mask (`xyz`, `rgba`, `yx`…). */
+    swizzle(mask) {
+        const m = mask.replace(/[rgba]/g, (c) => ({ r: 'x', g: 'y', b: 'z', a: 'w' })[c]);
+        const n = lanesOf(this.type);
+        if (!/^[xyzw]{1,4}$/.test(m) || [...m].some((c) => 'xyzw'.indexOf(c) >= n) || this.type === 'bool' || this.type === 'u32') {
+            throw new YaliError('TSL_SWIZZLE', `.${mask} does not apply to a ${this.type}.`, 'Swizzle vectors only, with components the vector has.');
+        }
+        return new Node('swizzle', VEC[m.length], [this], m);
+    }
+}
+/** A node from a node or a number. */
+export function nodeOf(v) {
+    if (v instanceof Node)
+        return v;
+    if (typeof v === 'number' && Number.isFinite(v))
+        return new Node('const', 'f32', [], [v]);
+    throw new YaliError('TSL_VALUE', `${String(v)} is not a node or a finite number.`, 'Pass a node (float(), vec3(), uniform()…) or a finite number.');
+}
+function binary(op, a, b) {
+    const [x, y] = [nodeOf(a), nodeOf(b)];
+    return new Node('op', resultOf(op, x.type, y.type), [x, y], op);
+}
+function compare(op, a, b) {
+    const [x, y] = [nodeOf(a), nodeOf(b)];
+    if (x.type !== 'f32' || y.type !== 'f32')
+        throw new YaliError('TSL_TYPE', `Comparison ${op} takes two floats, not ${x.type} and ${y.type}.`, 'Compare components (`.x`) or lengths.');
+    return new Node('op', 'bool', [x, y], op);
+}
+/** The type of `a op b`: equal types, or a vector with a scalar (WGSL broadcasts). */
+function resultOf(op, a, b) {
+    if (a === b && a !== 'bool')
+        return a;
+    if (a === 'f32' && b.startsWith('vec'))
+        return b;
+    if (b === 'f32' && a.startsWith('vec'))
+        return a;
+    throw new YaliError('TSL_TYPE', `${a} ${op} ${b} has no type.`, 'Combine equal types, or a vector with a float.');
+}
+/** WGSL built-in functions the DSL exposes, with how their result type follows the arguments. */
+const FUNCTIONS = {
+    ...Object.fromEntries(['abs', 'sin', 'cos', 'tan', 'floor', 'ceil', 'fract', 'sqrt', 'exp', 'exp2', 'log', 'log2', 'normalize', 'saturate', 'sign'].map((f) => [f, (a) => a[0]])),
+    ...Object.fromEntries(['min', 'max', 'pow', 'step', 'reflect'].map((f) => [f, (a) => a.find((t) => t !== 'f32') ?? 'f32'])),
+    ...Object.fromEntries(['clamp', 'mix', 'smoothstep'].map((f) => [f, (a) => a.find((t) => t !== 'f32') ?? 'f32'])),
+    dot: () => 'f32',
+    length: () => 'f32',
+    distance: () => 'f32',
+    cross: () => 'vec3f',
+};
+/** A call of a WGSL built-in (`call('mix', [a, b, t])`). Scalars broadcast to the vector argument's type. */
+export function call(fn, args) {
+    const rule = FUNCTIONS[fn];
+    if (!rule)
+        throw new YaliError('TSL_FUNCTION', `${fn} is not a function @yali-engine/tsl knows.`, `Use one of: ${Object.keys(FUNCTIONS).join(', ')}.`);
+    let nodes = args.map(nodeOf);
+    const type = rule(nodes.map((n) => n.type));
+    // WGSL wants every argument of a vector call to be that vector type; only mix may take a
+    // scalar blend factor. Splat the other scalar operands.
+    if (type.startsWith('vec'))
+        nodes = nodes.map((n, i) => (n.type === 'f32' && !(fn === 'mix' && i === 2) ? construct(type, [n]) : n));
+    return new Node('call', type, nodes, fn);
+}
+/** A typed vector or scalar from components (`vec3(1, 0, 0)`, `vec4(rgb, 1)`, `vec3(0.5)` splats). */
+export function construct(type, parts) {
+    const nodes = parts.map(nodeOf);
+    const want = lanesOf(type);
+    const have = nodes.reduce((n, p) => n + lanesOf(p.type), 0);
+    if (!(have === want || (nodes.length === 1 && nodes[0].type === 'f32'))) {
+        throw new YaliError('TSL_CONSTRUCT', `${type}(…) got ${have} components; it needs ${want} (or one float to splat).`, 'Pass the right number of components.');
+    }
+    if (nodes.every((n) => n.kind === 'const')) {
+        const flat = nodes.flatMap((n) => n.value);
+        return new Node('const', type, [], flat.length === 1 ? Array(want).fill(flat[0]) : flat);
+    }
+    return new Node('construct', type, nodes, type);
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,34 @@
 {
   "name": "@yali-engine/tsl",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.4.0",
+  "description": "Yali's material DSL: three.js TSL names, a node graph as plain data, compiled to WGSL at build time (ADR-0007, ADR-0064).",
+  "license": "MIT OR Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "yali-tsl": "./bin/compile.mjs"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "dependencies": {
+    "@yali-engine/core": "0.4.0"
+  },
+  "devDependencies": {
+    "@webgpu/types": "^0.1.60"
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json",
+    "test": "node --experimental-strip-types --no-warnings --test \"test/*.test.ts\""
+  }
 }

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.