rayzee 7.19.1 → 7.20.0

package/README.md

@@ -1,7 +1,7 @@
 # Rayzee Engine
 
 [![npm](https://img.shields.io/npm/v/rayzee?label=npm)](https://www.npmjs.com/package/rayzee)
-[![minzipped size](https://img.shields.io/badge/minzipped-174.9%20KB-blue)](https://www.npmjs.com/package/rayzee)
+[![minzipped size](https://img.shields.io/badge/minzipped-176%20KB-blue)](https://www.npmjs.com/package/rayzee)
 [![downloads](https://img.shields.io/npm/dw/rayzee?label=downloads)](https://www.npmjs.com/package/rayzee)
 [![jsDelivr](https://img.shields.io/jsdelivr/npm/hm/rayzee?label=jsDelivr)](https://www.jsdelivr.com/package/npm/rayzee)
 

package/dist/rayzee.es.js

@@ -6789,6 +6789,9 @@ var Ec = Qr("emissive"), Dc = class {
 	}
 	async refitBVH(e, t) {
 		if (!this.bvhData || !this.triangleData || !this.originalToBvhMap) throw Error("No BVH data available for refit. Run buildBVH() first.");
+		let n = this.triangleCount * 9;
+		if (e?.length !== n) throw Error(`SceneProcessor.refitBVH: expected ${n} position floats (${this.triangleCount} triangles × 9), got ${e?.length ?? "none"}. Positions must cover every triangle in the scene, meshes in this.meshes order.`);
+		if (t && t.length !== n) throw Error(`SceneProcessor.refitBVH: expected ${n} normal floats, got ${t.length}.`);
 		if (!this._refitWorker) try {
 			this._refitWorker = new Worker(kc, { type: "module" });
 		} catch (e) {
@@ -6825,13 +6828,16 @@ var Ec = Qr("emissive"), Dc = class {
 	}
 	refitBLASes(e, t, n) {
 		if (!this.instanceTable || !this.bvhData || !this.triangleData) throw Error("No TLAS/BLAS data available. Run buildBVH() first.");
-		let r = performance.now();
+		let r = this.triangleCount * 9;
+		if (t?.length !== r) throw Error(`SceneProcessor.refitBLASes: expected ${r} position floats (${this.triangleCount} triangles × 9, full scene), got ${t?.length ?? "none"}.`);
+		if (n && n.length !== r) throw Error(`SceneProcessor.refitBLASes: expected ${r} normal floats, got ${n.length}.`);
+		let i = performance.now();
 		this._blasRefitter ||= new ec();
 		for (let r of e) {
 			let e = this.instanceTable.entries[r];
 			e && (this._updateMeshTrianglePositions(e, t), n && this._patchMeshSmoothNormals(e, n), this._blasRefitter.refitRange(this.bvhData, this.triangleData, e.blasOffset, e.blasNodeCount), this.instanceTable.recomputeAABB(r, this.bvhData, this.triangleData));
 		}
-		return this._refitTLAS(), { refitTimeMs: performance.now() - r };
+		return this._refitTLAS(), { refitTimeMs: performance.now() - i };
 	}
 	computeBLASDirtyRanges(e) {
 		let t = X.FLOATS_PER_TRIANGLE, n = [], r = [];
@@ -7343,7 +7349,7 @@ var Hc = Qr("pathtracer"), Uc = 4, Wc = class extends nr {
 		}, this.environment = new Gi(this.scene, this.uniforms), this.environment.callbacks.onReset = () => this.reset(), this.environment.callbacks.getSceneTextureNodes = () => this.shaderBuilder.getSceneTextureNodes(), this.shaderBuilder = new zs(), this._initRenderingState(), this.setupBlueNoise(), this.tempVector2 = new on(), this.lastCameraMatrix = new St(), this.lastProjectionMatrix = new St(), this.lastRenderMode = -1, this.renderModeChangeTimeout = null, this.renderModeChangeDelay = 50, this.pendingRenderMode = null, this.lastInteractionModeState = !1, this.cameraChanged = !1, this.updateCompletionThreshold();
 	}
 	_initDataTextures() {
-		this.triangleStorageAttr = null, this.triangleStorageNode = null, this.triangleCount = 0, this.bvhStorageAttr = null, this.bvhStorageNode = null, this.bvhNodeCount = 0, this.directionalLightsData = null, this.pointLightsData = null, this.spotLightsData = null, this.areaLightsData = null, this.goboMaps = null, this.iesProfiles = null, this.stbnScalarTexture = null, this.stbnVec2Texture = null, this.lightStorageAttr = new o(new Float32Array(16), 4), this.lightStorageNode = Ce(this.lightStorageAttr, "vec4", 1).toReadOnly(), this._lightBufferRealloc = !1, this._lbvhDataCache = null, this._emissiveDataCache = null, this._bitTrailMapCache = null, this._instanceTable = null, this.spheres = [];
+		this.triangleStorageAttr = null, this.triangleStorageNode = null, this.triangleCount = 0, this.bvhStorageAttr = null, this.bvhStorageNode = null, this.bvhNodeCount = 0, this.directionalLightsData = null, this.pointLightsData = null, this.spotLightsData = null, this.areaLightsData = null, this.goboMaps = null, this.iesProfiles = null, this.stbnScalarTexture = null, this.stbnVec2Texture = null, this.blueNoiseReady = Promise.resolve(), this.lightStorageAttr = new o(new Float32Array(16), 4), this.lightStorageNode = Ce(this.lightStorageAttr, "vec4", 1).toReadOnly(), this._lightBufferRealloc = !1, this._lbvhDataCache = null, this._emissiveDataCache = null, this._bitTrailMapCache = null, this._instanceTable = null, this.spheres = [];
 	}
 	_defineUniformGetters() {
 		let e = this.uniforms;
@@ -7419,12 +7425,14 @@ var Hc = Qr("pathtracer"), Uc = 4, Wc = class extends nr {
 	setupBlueNoise() {
 		let e = new en();
 		e.setCrossOrigin("anonymous");
-		let t = (e) => (e.minFilter = Dt, e.magFilter = Dt, e.wrapS = Kt, e.wrapT = Kt, e.generateMipmaps = !1, e), { stbnScalarAtlas: n, stbnVec2Atlas: r } = Vc();
-		e.load(n, (e) => {
+		let t = (e) => (e.minFilter = Dt, e.magFilter = Dt, e.wrapS = Kt, e.wrapT = Kt, e.generateMipmaps = !1, e), { stbnScalarAtlas: n, stbnVec2Atlas: r } = Vc(), i = e.loadAsync(n).then((e) => {
 			this.stbnScalarTexture = t(e), Rn.value = e, Hc.debug(`STBN scalar atlas ${Q.px(e.image.width, e.image.height)}`);
-		}), e.load(r, (e) => {
+		}), a = e.loadAsync(r).then((e) => {
 			this.stbnVec2Texture = t(e), zn.value = e, Hc.debug(`STBN vec2 atlas ${Q.px(e.image.width, e.image.height)}`);
 		});
+		this.blueNoiseReady = Promise.allSettled([i, a]).then((e) => {
+			for (let t of e) t.status === "rejected" && Hc.warn("STBN atlas failed to load", t.reason);
+		});
 	}
 	setupEventListeners() {
 		this.on("pipeline:reset", () => {
@@ -16595,7 +16603,7 @@ var qp = 4096, Jp = class {
 		} catch (e) {
 			rm.warn("prior canvas owner dispose failed", e);
 		}
-		nm.set(e, this), this.canvas = e, this._autoResize = t.autoResize !== !1, this._container = t.container || null, this.settings = new Qf(J), this.renderer = null, this.scene = null, this.meshScene = null, this._sceneHelpers = null, this.assetLoader = null, this._sdf = null, this._animRefitInFlight = !1, this._maxTextureSize = J.maxTextureSize, this.pipeline = null, this.stages = {}, this.cameraManager = null, this.lightManager = null, this.goboManager = null, this.iesManager = null, this.denoisingManager = null, this.overlayManager = null, this.interactionManager = null, this.transformManager = null, this.animationManager = new Qp(), this.environmentManager = null, this.isInitialized = !1, this.pauseRendering = !1, this.pathTracerEnabled = !0, this.animationManagerId = null, this.needsReset = !1, this._loadingInProgress = !1, this._needsDisplayRefresh = !1, this._paused = !1, this._emissiveSamplingUserSet = !1, this.completion = new pf(), this._resizeDebounceTimer = null, this._trackedListeners = [], this._disposed = !1, this._deviceLost = !1;
+		nm.set(e, this), this.canvas = e, this._autoResize = t.autoResize !== !1, this._container = t.container || null, this.settings = new Qf(J), this.renderer = null, this.scene = null, this.meshScene = null, this._sceneHelpers = null, this.assetLoader = null, this._sdf = null, this._animRefitInFlight = !1, this._maxTextureSize = J.maxTextureSize, this.pipeline = null, this.stages = {}, this.cameraManager = null, this.lightManager = null, this.goboManager = null, this.iesManager = null, this.denoisingManager = null, this.overlayManager = null, this.interactionManager = null, this.transformManager = null, this.animationManager = new Qp(), this.environmentManager = null, this.isInitialized = !1, this.pauseRendering = !1, this.pathTracerEnabled = !0, this.animationManagerId = null, this.needsReset = !1, this._loadingInProgress = !1, this._needsDisplayRefresh = !1, this._paused = !1, this._emissiveSamplingUserSet = !1, this.completion = new pf(), this._resizeDebounceTimer = null, this._trackedListeners = [], this._disposed = !1, this._deviceLost = !1, this._deterministic = !1, this._dispatchPinned = !1, this._deterministicRestore = null;
 	}
 	_addTrackedListener(e, t, n) {
 		e && (e.addEventListener(t, n), this._trackedListeners.push({
@@ -16883,6 +16891,9 @@ var qp = 4096, Jp = class {
 			cameraNames: this.cameraManager.getCameraNames()
 		});
 	}
+	get sceneMeshes() {
+		return this._sdf?.meshes ?? [];
+	}
 	async refitBVH(e, t) {
 		let n = await this._sdf.refitBVH(e, t);
 		return this.stages.pathTracer.updateTriangleData(this._sdf.triangleData), this.stages.pathTracer.updateBVHData(this._sdf.bvhData), this.reset(), n;
@@ -16963,6 +16974,71 @@ var qp = 4096, Jp = class {
 	refreshFrame() {
 		this._needsDisplayRefresh = !0, this.wake();
 	}
+	setDeterministicMode(e = !0, { pinDispatch: t = !0 } = {}) {
+		let n = this.stages.pathTracer;
+		if (!n) return !1;
+		if (e) this._deterministicRestore ||= {
+			settings: {
+				useAdaptiveSampling: this.settings.get("useAdaptiveSampling"),
+				usePixelFreeze: this.settings.get("usePixelFreeze"),
+				interactionModeEnabled: this.settings.get("interactionModeEnabled"),
+				renderLimitMode: this.settings.get("renderLimitMode"),
+				renderTimeLimit: this.settings.get("renderTimeLimit")
+			},
+			bounceEarlyExit: n._bounceEarlyExitThreshold,
+			dynamicDispatch: n._useDynamicDispatch,
+			autoFocusMode: this.cameraManager?.autoFocusMode,
+			autoExposure: this.stages.autoExposure?.enabled
+		}, this.settings.setMany({
+			useAdaptiveSampling: !1,
+			usePixelFreeze: !1,
+			interactionModeEnabled: !1,
+			renderLimitMode: "frames",
+			renderTimeLimit: 0
+		}, { silent: !0 }), t ? (n._bounceEarlyExitThreshold = -1, n._useDynamicDispatch = !1) : (n._bounceEarlyExitThreshold = this._deterministicRestore.bounceEarlyExit, n._useDynamicDispatch = this._deterministicRestore.dynamicDispatch), this.cameraManager?.setAutoFocusMode("manual"), this.stages.autoExposure && (this.stages.autoExposure.enabled = !1), this._deterministic = !0, this._dispatchPinned = t;
+		else if (this._deterministicRestore) {
+			let e = this._deterministicRestore;
+			this.settings.setMany(e.settings, { silent: !0 }), n._bounceEarlyExitThreshold = e.bounceEarlyExit, n._useDynamicDispatch = e.dynamicDispatch, e.autoFocusMode !== void 0 && this.cameraManager?.setAutoFocusMode(e.autoFocusMode), this.stages.autoExposure && e.autoExposure !== void 0 && (this.stages.autoExposure.enabled = e.autoExposure), this._deterministicRestore = null, this._deterministic = !1, this._dispatchPinned = !1;
+		}
+		return this.reset(), this.stopAnimation(), this._deterministic;
+	}
+	get isDeterministic() {
+		return this._deterministic && this._dispatchPinned;
+	}
+	async renderFrames(e, { reset: t = !0, yieldEvery: n = 8, onProgress: r } = {}) {
+		let i = this.stages.pathTracer;
+		if (!i) throw Error("renderFrames: app is not initialized");
+		if (!(e > 0)) throw Error(`renderFrames: count must be positive, got ${e}`);
+		await i.blueNoiseReady;
+		let a = (t ? 0 : i.frameCount) + e;
+		this.settings.get("maxSamples") < a && this.settings.set("maxSamples", a, {
+			silent: !0,
+			reset: !1
+		}), t && this.reset(), this.stopAnimation();
+		let o = e + 64, s = 0;
+		for (; i.frameCount < a && s < o;) {
+			if (this._deviceLost) throw Error("renderFrames: WebGPU device lost");
+			if (!i.isReady) throw Error("renderFrames: path tracer stage is not ready");
+			this.pipeline.render(), s++, r?.(i.frameCount), n > 0 && s % n === 0 && await new Promise((e) => setTimeout(e, 0));
+		}
+		if (i.frameCount < a) throw Error(`renderFrames: stalled at ${i.frameCount}/${a} samples after ${s} passes — something retired the render (maxSamples, a stray reset, or a canvas resize)`);
+		return i.frameCount;
+	}
+	enableGPUTiming(e = !0) {
+		let t = this.renderer?.backend;
+		return !t || e && t.hasFeature?.("timestamp-query") !== !0 ? !1 : (t.trackTimestamp = e, t.trackTimestamp === e);
+	}
+	async getGPUTimings() {
+		let e = this.renderer;
+		if (!e?.backend?.trackTimestamp) return null;
+		await e.resolveTimestampsAsync("compute"), await e.resolveTimestampsAsync("render");
+		let t = e.info.compute.timestamp || 0, n = e.info.render.timestamp || 0;
+		return {
+			compute: t,
+			render: n,
+			total: t + n
+		};
+	}
 	getCanvas() {
 		if (!this.renderer?.domElement) return null;
 		let e = this.denoisingManager;