@kvyverse/world-runtime 0.6.8 → 0.7.0

package/dist/index.d.ts

@@ -30,7 +30,9 @@ export { applyRendererConfig } from "./rendering/renderer-apply";
 export { enableSceneEmissiveMrt, SceneBloom } from "./rendering/SceneBloom";
 export { createTslNode, TslNode } from "./rendering/tsl-node";
 export type { TslNodeBuilder } from "./rendering/tsl-node";
-export { createUniformNode, isUniformType, UNIFORM_DEFAULTS, UNIFORM_TYPES, uniformType, } from "./rendering/tsl-uniforms";
+export { createMaterialShader, MaterialShader, readMaterialShaderOutputs, } from "./rendering/material-shader";
+export type { MaterialShaderBuilder, MaterialShaderOutputs, } from "./rendering/material-shader";
+export { createUniformNode, createUniformValuesView, getUniformNodeValue, isUniformType, setUniformNodeValue, UNIFORM_DEFAULTS, UNIFORM_TYPES, uniformType, } from "./rendering/tsl-uniforms";
 export type { UniformType } from "./rendering/tsl-uniforms";
 export { BUILTIN_LIB_DESCRIPTORS, LIB_DESCRIPTORS, LIB_IDS, LIBS, LibId, OPTIONAL_LIB_DESCRIPTORS, OPTIONAL_LIB_IDS, libByRequireKey, } from "./addons/lib-registry";
 export { collectRequiredLibs } from "./addons/required-libs";

package/dist/index.js

@@ -1608,7 +1608,7 @@ function isAbsoluteUrl(url) {
 }
 //#endregion
 //#region packages/world-runtime/src/version.gen.ts
-var RUNTIME_VERSION = "0.6.8";
+var RUNTIME_VERSION = "0.7.0";
 //#endregion
 //#region packages/world-runtime/src/version.ts
 /**
@@ -2009,49 +2009,6 @@ async function createVideo(url, name) {
 	return source;
 }
 //#endregion
-//#region packages/world-runtime/src/rendering/tsl-node.ts
-/**
-* World TSL node: the built graph node + its uniform nodes. This is what
-* `require("/Shaders/....tsl")` returns, so the method set matches the editor's
-* `TslNodeSource` (`setUniformValue` / `getUniformValue` / `uniformValues`).
-*/
-var TslNode = class {
-	uniforms;
-	node;
-	_uniformValuesView;
-	constructor(uniforms, build, name = "TslNode") {
-		this.uniforms = uniforms;
-		let node;
-		try {
-			node = build(TSL, uniforms);
-		} catch (error) {
-			console.warn(`TSL node "${name}" build failed`, error);
-		}
-		this.node = node ?? TSL.float(1);
-	}
-	/** Flat view of uniform values: reads and writes go straight to `node.value`. */
-	get uniformValues() {
-		return this._uniformValuesView ??= new Proxy({}, {
-			get: (_target, key) => typeof key === "string" ? this.getUniformValue(key) : void 0,
-			set: (_target, key, value) => {
-				if (typeof key === "string") this.setUniformValue(key, value);
-				return true;
-			}
-		});
-	}
-	setUniformValue(key, value) {
-		const node = this.uniforms[key];
-		if (node) node.value = value;
-	}
-	getUniformValue(key) {
-		return this.uniforms[key]?.value;
-	}
-};
-/** Factory for the generated code: builds the node and wraps it. */
-function createTslNode(uniforms, build, name) {
-	return new TslNode(uniforms, build, name);
-}
-//#endregion
 //#region packages/world-runtime/src/rendering/tsl-uniforms.ts
 var UNIFORM_TYPES = [
 	"float",
@@ -2112,6 +2069,118 @@ var UNIFORM_DEFAULTS = {
 	bool: () => false,
 	texture: () => getDefaultResource(DefaultResourceId.Texture)
 };
+/** Writes a uniform value by key; an unknown key is a no-op. */
+function setUniformNodeValue(uniforms, key, value) {
+	const node = uniforms[key];
+	if (node) node.value = value;
+}
+/** Reads a uniform value by key; `undefined` for an unknown key. */
+function getUniformNodeValue(uniforms, key) {
+	return uniforms[key]?.value;
+}
+/** Flat view of uniform values: reads and writes go straight to `node.value`,
+* so values live only in the nodes (no copy, no sync step). */
+function createUniformValuesView(uniforms) {
+	return new Proxy({}, {
+		get: (_target, key) => typeof key === "string" ? getUniformNodeValue(uniforms, key) : void 0,
+		set: (_target, key, value) => {
+			if (typeof key === "string") setUniformNodeValue(uniforms, key, value);
+			return true;
+		}
+	});
+}
+//#endregion
+//#region packages/world-runtime/src/rendering/tsl-node.ts
+/**
+* World TSL node: the built graph node + its uniform nodes. This is what
+* `require("/Shaders/....tsl")` returns, so the method set matches the editor's
+* `TslNodeSource` (`setUniformValue` / `getUniformValue` / `uniformValues`).
+*/
+var TslNode = class {
+	uniforms;
+	node;
+	_uniformValuesView;
+	constructor(uniforms, build, name = "TslNode") {
+		this.uniforms = uniforms;
+		let node;
+		try {
+			node = build(TSL, uniforms);
+		} catch (error) {
+			console.warn(`TSL node "${name}" build failed`, error);
+		}
+		this.node = node ?? TSL.float(1);
+	}
+	/** Flat view of uniform values: reads and writes go straight to `node.value`. */
+	get uniformValues() {
+		return this._uniformValuesView ??= createUniformValuesView(this.uniforms);
+	}
+	setUniformValue(key, value) {
+		setUniformNodeValue(this.uniforms, key, value);
+	}
+	getUniformValue(key) {
+		return getUniformNodeValue(this.uniforms, key);
+	}
+};
+/** Factory for the generated code: builds the node and wraps it. */
+function createTslNode(uniforms, build, name) {
+	return new TslNode(uniforms, build, name);
+}
+//#endregion
+//#region packages/world-runtime/src/rendering/material-shader.ts
+var EMPTY_OUTPUTS = Object.freeze({});
+/**
+* Validates what a material shader assigned to `output`: a plain object whose
+* values are TSL nodes (`null`/`undefined` entries are skipped). Throws otherwise.
+*/
+function readMaterialShaderOutputs(raw) {
+	if (!isPlainObject(raw)) throw new Error("material shader must assign an object of node inputs to `output`, e.g. { colorNode, emissiveNode }");
+	const outputs = {};
+	for (const key of Object.keys(raw)) {
+		const value = raw[key];
+		if (value === null || value === void 0) continue;
+		if (!value.isNode) throw new Error(`material shader output "${key}" is not a TSL node`);
+		outputs[key] = value;
+	}
+	return outputs;
+}
+/**
+* World material shader: one script that builds several material node inputs
+* with shared uniforms. `require("/Shaders/....")` returns it, so the method set
+* matches the editor's `MaterialShaderSource`.
+*/
+var MaterialShader = class {
+	uniforms;
+	/** Built outputs; empty when the build failed (the material keeps its own inputs). */
+	outputs;
+	_uniformValuesView;
+	constructor(uniforms, build, name = "MaterialShader") {
+		this.uniforms = uniforms;
+		let outputs = EMPTY_OUTPUTS;
+		try {
+			outputs = readMaterialShaderOutputs(build(TSL, uniforms));
+		} catch (error) {
+			console.warn(`material shader "${name}" build failed`, error);
+		}
+		this.outputs = outputs;
+	}
+	/** Flat view of uniform values: reads and writes go straight to `node.value`. */
+	get uniformValues() {
+		return this._uniformValuesView ??= createUniformValuesView(this.uniforms);
+	}
+	setUniformValue(key, value) {
+		setUniformNodeValue(this.uniforms, key, value);
+	}
+	getUniformValue(key) {
+		return getUniformNodeValue(this.uniforms, key);
+	}
+};
+/** Factory for the generated code: builds the shader and wraps it. */
+function createMaterialShader(uniforms, build, name) {
+	return new MaterialShader(uniforms, build, name);
+}
+function isPlainObject(x) {
+	return typeof x === "object" && x !== null && Object.getPrototypeOf(x) === Object.prototype;
+}
 //#endregion
 //#region packages/world-runtime/src/addons/externals.ts
 var EXTERNAL_TYPES = ["umd", "module"];
@@ -2139,4 +2208,4 @@ var TONE_MAPPING_NAMES = [
 	"Neutral"
 ];
 //#endregion
-export { AddonsRuntime, AssetLoaders, AudioSource, BLOOM_MODES, BUILTIN_BEHAVIOURS, BUILTIN_BEHAVIOUR_LIST, BUILTIN_LIB_DESCRIPTORS, CHAT_INPUT_MODES, DEFAULT_RESOURCE_IDS, DefaultResourceId, EXTERNAL_TYPES, EnvModule, FontSource, HtmlHudModule, InputSystemModule, LIBS, LIB_DESCRIPTORS, LIB_IDS, LOADING_MANAGER, LibId, NullPlatformModule, OPTIONAL_LIB_DESCRIPTORS, OPTIONAL_LIB_IDS, OPTIONAL_MODULES, OPTIONAL_MODULE_IDS, OptionalModuleId, PHYSICS_ENGINES, RUNTIME_VERSION, SHADOW_MAP_TYPES, SceneBloom, SoundsModule, TONE_MAPPING_NAMES, TslNode, UNIFORM_DEFAULTS, UNIFORM_TYPES, UtilsModule, VideoSource, WORLD_FORMAT_VERSION, World, WorldEvent, WorldStores, applyRendererConfig, applyTextureDefaults, collectModelSubResources, collectRequiredLibs, configureAssetLoaders, createAudio, createFont, createTslNode, createUniformNode, createVideo, createWorldModules, defineWorld, enableSceneEmissiveMrt, fontFormatFromMime, getBuiltinBehaviour, getDefaultResource, getHalfheightRadiusScale, getOptionalModuleDescriptor, getRadiusScale, isDefaultResourceId, isMobileDevice, isUniformType, lazyProxy, libByRequireKey, loadGeometry, loadHdr, loadModel, loadTexture, normalizeChat, normalizePhysics, parseGeometryJson, parseHdr, parseModel, rapierPhysicsPatch, setColor, uniformType };
+export { AddonsRuntime, AssetLoaders, AudioSource, BLOOM_MODES, BUILTIN_BEHAVIOURS, BUILTIN_BEHAVIOUR_LIST, BUILTIN_LIB_DESCRIPTORS, CHAT_INPUT_MODES, DEFAULT_RESOURCE_IDS, DefaultResourceId, EXTERNAL_TYPES, EnvModule, FontSource, HtmlHudModule, InputSystemModule, LIBS, LIB_DESCRIPTORS, LIB_IDS, LOADING_MANAGER, LibId, MaterialShader, NullPlatformModule, OPTIONAL_LIB_DESCRIPTORS, OPTIONAL_LIB_IDS, OPTIONAL_MODULES, OPTIONAL_MODULE_IDS, OptionalModuleId, PHYSICS_ENGINES, RUNTIME_VERSION, SHADOW_MAP_TYPES, SceneBloom, SoundsModule, TONE_MAPPING_NAMES, TslNode, UNIFORM_DEFAULTS, UNIFORM_TYPES, UtilsModule, VideoSource, WORLD_FORMAT_VERSION, World, WorldEvent, WorldStores, applyRendererConfig, applyTextureDefaults, collectModelSubResources, collectRequiredLibs, configureAssetLoaders, createAudio, createFont, createMaterialShader, createTslNode, createUniformNode, createUniformValuesView, createVideo, createWorldModules, defineWorld, enableSceneEmissiveMrt, fontFormatFromMime, getBuiltinBehaviour, getDefaultResource, getHalfheightRadiusScale, getOptionalModuleDescriptor, getRadiusScale, getUniformNodeValue, isDefaultResourceId, isMobileDevice, isUniformType, lazyProxy, libByRequireKey, loadGeometry, loadHdr, loadModel, loadTexture, normalizeChat, normalizePhysics, parseGeometryJson, parseHdr, parseModel, rapierPhysicsPatch, readMaterialShaderOutputs, setColor, setUniformNodeValue, uniformType };

package/dist/rendering/material-shader.d.ts

@@ -0,0 +1,29 @@
+import * as TSL from "three/tsl";
+import type { Node } from "three/webgpu";
+/** Material shader outputs: material node input name (`colorNode`, …) → node. */
+export type MaterialShaderOutputs = Readonly<Record<string, Node>>;
+/** Material shader body: returns the `output` value, receiving `TSL` and the uniform nodes. */
+export type MaterialShaderBuilder = (tsl: typeof TSL, uniforms: Record<string, Node>) => unknown;
+/**
+ * Validates what a material shader assigned to `output`: a plain object whose
+ * values are TSL nodes (`null`/`undefined` entries are skipped). Throws otherwise.
+ */
+export declare function readMaterialShaderOutputs(raw: unknown): MaterialShaderOutputs;
+/**
+ * World material shader: one script that builds several material node inputs
+ * with shared uniforms. `require("/Shaders/....")` returns it, so the method set
+ * matches the editor's `MaterialShaderSource`.
+ */
+export declare class MaterialShader {
+    readonly uniforms: Record<string, Node>;
+    /** Built outputs; empty when the build failed (the material keeps its own inputs). */
+    readonly outputs: MaterialShaderOutputs;
+    private _uniformValuesView?;
+    constructor(uniforms: Record<string, Node>, build: MaterialShaderBuilder, name?: string);
+    /** Flat view of uniform values: reads and writes go straight to `node.value`. */
+    get uniformValues(): Record<string, unknown>;
+    setUniformValue(key: string, value: unknown): void;
+    getUniformValue(key: string): unknown;
+}
+/** Factory for the generated code: builds the shader and wraps it. */
+export declare function createMaterialShader(uniforms: Record<string, Node>, build: MaterialShaderBuilder, name?: string): MaterialShader;

package/dist/rendering/tsl-uniforms.d.ts

@@ -16,3 +16,10 @@ export declare function createUniformNode(type: UniformType): Node;
 /** Default value per type — for `Property.setDefault` (value==default is not
  * serialized, restored on load). Factories, since Color/Vec are mutable. */
 export declare const UNIFORM_DEFAULTS: Record<UniformType, () => unknown>;
+/** Writes a uniform value by key; an unknown key is a no-op. */
+export declare function setUniformNodeValue(uniforms: Record<string, Node>, key: string, value: unknown): void;
+/** Reads a uniform value by key; `undefined` for an unknown key. */
+export declare function getUniformNodeValue(uniforms: Record<string, Node>, key: string): unknown;
+/** Flat view of uniform values: reads and writes go straight to `node.value`,
+ * so values live only in the nodes (no copy, no sync step). */
+export declare function createUniformValuesView(uniforms: Record<string, Node>): Record<string, unknown>;

package/dist/version.gen.d.ts

@@ -1 +1 @@
-export declare const RUNTIME_VERSION = "0.6.8";
+export declare const RUNTIME_VERSION = "0.7.0";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@kvyverse/world-runtime",
-	"version": "0.6.8",
+	"version": "0.7.0",
 	"description": "Runtime for worlds exported from the Kvyverse platform for self-hosting",
 	"license": "SEE LICENSE IN LICENSE.md",
 	"author": "Kvyverse, Inc.",