material-designer-runtime 0.1.0

package/dist/runtime.d.ts

@@ -0,0 +1,36 @@
+import type { WebGPURenderer } from "three/webgpu";
+import { MaterialGraphSession } from "./document";
+import { MaterialBakeService } from "./graph/bake-service";
+import { TexturedSurface } from "./graph/textured-surface";
+import type { MaterialBackend, MaterialGraphDocument } from "./graph/types";
+import { type NodeRegistry } from "./graph/registry";
+export interface MaterialGraphRuntimeOptions {
+    document?: MaterialGraphDocument;
+    registry?: NodeRegistry;
+    bakeService?: MaterialBakeService;
+    source?: string;
+}
+export declare class MaterialGraphRuntime {
+    readonly graph: MaterialGraphSession;
+    readonly surface: TexturedSurface;
+    readonly service: MaterialBakeService;
+    constructor(options?: MaterialGraphRuntimeOptions);
+    get material(): import("three/webgpu").MeshStandardNodeMaterial;
+    get lastError(): string | null;
+    setRenderer(renderer: WebGPURenderer): this;
+    setBackend(backend: MaterialBackend): this;
+    getBackend(): MaterialBackend;
+    fromDocument(document: MaterialGraphDocument): this;
+    setDocument(document: MaterialGraphDocument): this;
+    getDocument(): MaterialGraphDocument;
+    setOutputResolution(size: number): this;
+    setOutputTargets(targets: {
+        resolution?: number;
+        size?: number;
+    }): this;
+    setNodeParam(nodeId: string, key: string, value: unknown): this;
+    updateNodeParams(nodeId: string, patch: Record<string, unknown>): this;
+    refresh(): Promise<void>;
+    regenerate(): this;
+    dispose(): void;
+}

package/dist/topology.d.ts

@@ -0,0 +1,3 @@
+import { type NodeRegistry } from "./graph/registry";
+import type { MaterialGraphDocument } from "./graph/types";
+export declare function createMaterialTopologyKey(doc: MaterialGraphDocument, registry: NodeRegistry): string;

package/dist/tsl/blender-color.d.ts

@@ -0,0 +1,5 @@
+import type { MaterialValue } from "../graph/types";
+type V = MaterialValue;
+export declare function rgbToHsv(rgb: V): V;
+export declare function hsvToRgb(hsv: V): V;
+export {};

package/dist/tsl/blender-gradient.d.ts

@@ -0,0 +1,4 @@
+import type { MaterialValue } from "../graph/types";
+type V = MaterialValue;
+export declare function blenderGradient(p: V, type: number): V;
+export {};

package/dist/tsl/blender-mapping.d.ts

@@ -0,0 +1,4 @@
+import type { MaterialValue } from "../graph/types";
+type V = MaterialValue;
+export declare function blenderMapping(v: V, location: V, rotation: V, scale: V, type: number): V;
+export {};

package/dist/tsl/blender-noise.d.ts

@@ -0,0 +1,5 @@
+import type { MaterialValue } from "../graph/types";
+type V = MaterialValue;
+export declare const blenderSnoise: (p: V) => V;
+export declare function blenderFbm(p: V, octaves: number, roughness: V, lacunarity: V): V;
+export {};

package/dist/tsl/blender-voronoi.d.ts

@@ -0,0 +1,13 @@
+import type { MaterialValue } from "../graph/types";
+type V = MaterialValue;
+export declare const blenderVoronoiF1: (c: V, r: V, m: number, e: V, period?: number | V) => V;
+export declare const blenderVoronoiF1Color: (c: V, r: V, m: number, e: V, period?: number | V) => V;
+export declare const blenderVoronoiF1Pos: (c: V, r: V, m: number, e: V, period?: number | V) => V;
+export declare const blenderVoronoiF2: (c: V, r: V, m: number, e: V, period?: number | V) => V;
+export declare const blenderVoronoiF2Color: (c: V, r: V, m: number, e: V, period?: number | V) => V;
+export declare const blenderVoronoiF2Pos: (c: V, r: V, m: number, e: V, period?: number | V) => V;
+export declare const blenderVoronoiSmoothF1: (c: V, r: V, m: number, e: V, s: V, period?: number | V) => V;
+export declare const blenderVoronoiSmoothF1Color: (c: V, r: V, m: number, e: V, s: V, period?: number | V) => V;
+export declare const blenderVoronoiSmoothF1Pos: (c: V, r: V, m: number, e: V, s: V, period?: number | V) => V;
+export declare function blenderVoronoiDistanceToEdge(coord: V, randomness: V, period?: number | V): V;
+export {};

package/dist/tsl/blender-wave.d.ts

@@ -0,0 +1,14 @@
+import type { MaterialValue } from "../graph/types";
+type V = MaterialValue;
+export interface WaveOpts {
+    waveType: number;
+    dir: number;
+    profile: number;
+    withDistortion: boolean;
+    detail: number;
+    tileable: boolean;
+    scaleNum: number;
+    detailScaleNum: number;
+}
+export declare function blenderWave(coord: V, scale: V, phase: V, distortion: V, detailScale: V, detailRoughness: V, opts: WaveOpts): V;
+export {};

package/dist/tsl/curve.d.ts

@@ -0,0 +1,4 @@
+import type { MaterialValue } from "../graph/types";
+type V = MaterialValue;
+export declare function curve5(t: V, p: V[]): V;
+export {};

package/dist/tsl/lloyd-points.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Relaxed seed offsets for a P×P periodic Voronoi grid.
+ * @param P            integer period (= round(scale)); tile spans [0,P) cells.
+ * @param randomness   initial jitter amount (0..1), matches the Voronoi `randomness` look.
+ * @param iterations   Lloyd iterations (0 = raw jitter, 2–4 = strongly relaxed/CVT).
+ * @param seed         jitter seed.
+ * @returns Float32Array of length P*P*3 — [ox,oy,0] per cell, index = iy*P + ix.
+ */
+export declare function relaxedCellOffsets(P: number, randomness: number, iterations: number, seed?: number): Float32Array;

package/dist/tsl/noise/cellular.d.ts

@@ -0,0 +1,5 @@
+import type { MaterialValue } from "../../graph/types";
+type V = MaterialValue;
+export declare function worleyBase01(p: V, perX: number | V, perY: number | V): V;
+export declare function voronoiSmoothBase01(p: V, perX: number | V, perY: number | V): V;
+export {};

package/dist/tsl/noise/erosion.d.ts

@@ -0,0 +1,4 @@
+import type { MaterialValue } from "../../graph/types";
+type V = MaterialValue;
+export declare function erosionBase01(p: V, per: number, _perY: number): V;
+export {};

package/dist/tsl/noise/fbm.d.ts

@@ -0,0 +1,5 @@
+import type { MaterialValue } from "../../graph/types";
+type V = MaterialValue;
+export type NoiseBase01 = (p: V, perX: number, perY: number) => V;
+export declare function periodicFbm01(uv2: V, periodX: number | V, periodY: number | V, octaves: number, gain: V, base: NoiseBase01, aa?: V, lacunarity?: number): V;
+export {};

package/dist/tsl/noise/flow.d.ts

@@ -0,0 +1,8 @@
+import type { MaterialValue } from "../../graph/types";
+type V = MaterialValue;
+export declare const curlVec2: import("three/src/nodes/TSL.js").FnNode<any[], any>;
+export declare function curlVec(p: V, per: number, _perY: number): V;
+export declare function paperBase01(p: V, per: number, _perY: number): V;
+export declare function woolBase01(p: V, per: number, _perY: number): V;
+export declare function stoneBase01(p: V, per: number, _perY: number): V;
+export {};

package/dist/tsl/noise/gabor.d.ts

@@ -0,0 +1 @@
+export declare const gaborValue2D: import("three/src/nodes/TSL.js").FnNode<any[], any>;

package/dist/tsl/noise/hash.d.ts

@@ -0,0 +1,8 @@
+import type { MaterialValue } from "../../graph/types";
+type V = MaterialValue;
+export declare const hashInt3ToVec3: import("three/src/nodes/TSL.js").FnNode<any[], any>;
+export declare function hashCell2(ix: V, iy: V, perX: number | V, perY: number | V): V;
+export declare function hashCell2ToVec2(ix: V, iy: V, perX: number | V, perY: number | V): V;
+export declare function hashCell2ToVec3(ix: V, iy: V, perX: number | V, perY: number | V): V;
+export declare function hashCell2ToVec3Seed(ix: V, iy: V, seed: number, perX: number | V, perY: number | V): V;
+export {};

package/dist/tsl/noise/index.d.ts

@@ -0,0 +1,8 @@
+export { periodicFbm01, type NoiseBase01 } from "./fbm";
+export { valueBase01 } from "./value";
+export { worleyBase01, voronoiSmoothBase01 } from "./cellular";
+export { curlVec, paperBase01, woolBase01, stoneBase01 } from "./flow";
+export { gaborValue2D } from "./gabor";
+export { simplexBase01 } from "./simplex";
+export { waveletBase01 } from "./wavelet";
+export { erosionBase01 } from "./erosion";

package/dist/tsl/noise/screen.d.ts

@@ -0,0 +1,8 @@
+import type { MaterialValue } from "../../graph/types";
+type V = MaterialValue;
+export declare function ign12(p: V): V;
+export declare function goldenIgn12(p: V): V;
+export declare function blue12(p: V): V;
+export declare function hilbertBlue12(p: V): V;
+export declare function scratches12(uv0: V, thinness: V): V;
+export {};

package/dist/tsl/noise/simplex.d.ts

@@ -0,0 +1,4 @@
+import type { MaterialValue } from "../../graph/types";
+type V = MaterialValue;
+export declare function simplexBase01(p: V, perX: number, perY: number): V;
+export {};

package/dist/tsl/noise/value.d.ts

@@ -0,0 +1,4 @@
+import type { MaterialValue } from "../../graph/types";
+type V = MaterialValue;
+export declare function valueBase01(p: V, perX: number, perY: number): V;
+export {};

package/dist/tsl/noise/wavelet.d.ts

@@ -0,0 +1,4 @@
+import type { MaterialValue } from "../../graph/types";
+type V = MaterialValue;
+export declare function waveletBase01(p: V, perX: number, perY: number): V;
+export {};

package/dist/tsl/parallax.d.ts

@@ -0,0 +1,5 @@
+import type { Texture } from "three/webgpu";
+import type { MaterialValue } from "../graph/types";
+type V = MaterialValue;
+export declare function parallaxOcclusionUV(heightMap: Texture, baseUv: V, scale: V, layers: number): V;
+export {};

package/dist/tsl/relaxed-voronoi.d.ts

@@ -0,0 +1,7 @@
+import type { MaterialValue } from "../graph/types";
+type V = MaterialValue;
+type SeedFn = (ix: V, iy: V) => V;
+export declare function relaxedVoronoiDistanceToEdge(coord: V, seed: SeedFn): V;
+type ValueFn = (ix: V, iy: V) => V;
+export declare function relaxedVoronoiCellValue(coord: V, seed: SeedFn, value: ValueFn): V;
+export {};

package/dist/tsl/scatter.d.ts

@@ -0,0 +1,16 @@
+import type { MaterialValue } from "../graph/types";
+type V = MaterialValue;
+export interface ScatterUniforms {
+    amount: V;
+    radius: V;
+    sizeRandom: V;
+    posRandom: V;
+    rotRandom: V;
+}
+export interface ScatterResult {
+    coord: V;
+    value: V;
+    size: V;
+}
+export declare function scatterPattern(coord: V, cells: number, u: ScatterUniforms): ScatterResult;
+export {};

package/dist/tsl/shape.d.ts

@@ -0,0 +1,13 @@
+import type { MaterialValue } from "../graph/types";
+type V = MaterialValue;
+export interface ShapeUniforms {
+    irregularity: V;
+    dome: V;
+    edge: V;
+}
+export interface ShapeResult {
+    mask: V;
+    height: V;
+}
+export declare function shapeField(coord: V, type: string, sides: number, seedIn: V | null, u: ShapeUniforms): ShapeResult;
+export {};

package/dist/tsl/tile.d.ts

@@ -0,0 +1,23 @@
+import type { MaterialValue } from "../graph/types";
+type V = MaterialValue;
+export interface TileGrid {
+    columns: number;
+    rows: number;
+    offsetFreq: number;
+}
+export interface TileUniforms {
+    rowOffset: V;
+    gap: V;
+    roundness: V;
+    edge: V;
+    sizeRandom: V;
+    posRandom: V;
+    rotRandom: V;
+}
+export interface TileResult {
+    mask: V;
+    value: V;
+}
+export declare function tilePattern(coord: V, grid: TileGrid, u: TileUniforms): TileResult;
+export declare function hexPattern(coord: V, columns: number, rows: number, gap: V, edge: V): TileResult;
+export {};

package/dist/tsl/tileable-noise.d.ts

@@ -0,0 +1,6 @@
+import type { MaterialValue } from "../graph/types";
+type V = MaterialValue;
+export declare const pnoise2: import("three/src/nodes/TSL.js").FnNode<any[], any>;
+export declare function tileableFbm(uv2: V, // the 2D coordinate (uv tile)
+periodX: number | V, periodY: number | V, octaves: number, gain: V, aa?: V, lacunarity?: number): V;
+export {};

package/dist/tsl/triplanar-normal.d.ts

@@ -0,0 +1,5 @@
+import type { Texture } from "three/webgpu";
+import type { MaterialValue } from "../graph/types";
+type V = MaterialValue;
+export declare function triplanarNormalMap(map: Texture, scale: V, sharpness: V): V;
+export {};

package/dist/tsl/triplanar.d.ts

@@ -0,0 +1,6 @@
+import type { Texture } from "three/webgpu";
+import type { MaterialValue } from "../graph/types";
+type V = MaterialValue;
+export declare function triplanarBlendWeights(sharpness: V): V;
+export declare function triplanarColor(map: Texture, scale: V, sharpness: V): V;
+export {};

package/dist/tsl/uv-debug-material.d.ts

@@ -0,0 +1,2 @@
+import { MeshBasicNodeMaterial } from "three/webgpu";
+export declare function createUvDebugMaterial(): MeshBasicNodeMaterial;

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "material-designer-runtime",
+  "version": "0.1.0",
+  "description": "Lightweight runtime for loading and rendering Material Designer node graph documents.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Ivan Juarez",
+  "homepage": "https://github.com/vanrez-nez/material-designer-runtime#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vanrez-nez/material-designer-runtime.git"
+  },
+  "bugs": {
+    "url": "https://github.com/vanrez-nez/material-designer-runtime/issues"
+  },
+  "keywords": [
+    "three",
+    "threejs",
+    "webgpu",
+    "tsl",
+    "material",
+    "pbr",
+    "node-graph",
+    "procedural",
+    "textures",
+    "shader"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": [
+    "./dist/index.js"
+  ],
+  "scripts": {
+    "build": "vite build && tsc -p tsconfig.build.json",
+    "pack:dry-run": "npm pack --dry-run",
+    "test": "vitest run",
+    "prepublishOnly": "npm run test && npm run build && npm run pack:dry-run"
+  },
+  "peerDependencies": {
+    "three": "0.184.0"
+  },
+  "devDependencies": {
+    "@types/three": "^0.184.1",
+    "typescript": "6.0.3",
+    "vite": "8.0.16",
+    "vitest": "^4.0.0"
+  }
+}