rayzee 7.15.0 → 7.15.2

package/README.md

@@ -1,19 +1,53 @@
 # 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-169.6%20KB-blue)](https://www.npmjs.com/package/rayzee)
+[![minzipped size](https://img.shields.io/badge/minzipped-170.1%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)
 
 A real-time WebGPU path tracing engine built on Three.js. Framework-agnostic — use it with React, Vue, vanilla JS, or any other setup.
 
+🌐 **[Live Demo](https://atul-mourya.github.io/RayTracing/)** — the same demo app linked from the root monorepo README, built on this engine.
+
+## Table of Contents
+
+- [Installation](#installation)
+- [Getting Started](#getting-started)
+  - [Vanilla JS with Vite](#vanilla-js-with-vite)
+  - [Vanilla JS (no bundler)](#vanilla-js-no-bundler)
+  - [React](#react)
+  - [Integrating Alongside an Existing Three.js App](#integrating-alongside-an-existing-threejs-app)
+  - [Vite tip](#vite-tip)
+- [API Reference](#api-reference)
+  - [Configuring Assets (CDN URLs & cache namespace)](#configuring-assets-cdn-urls--cache-namespace)
+  - [PathTracerApp](#pathtracerapp)
+  - [engine.cameraManager](#enginecameramanager)
+  - [engine.lightManager](#enginelightmanager)
+  - [engine.animationManager](#engineanimationmanager)
+  - [Materials](#materials)
+  - [engine.environmentManager](#engineenvironmentmanager)
+  - [engine.denoisingManager](#enginedenoisingmanager)
+  - [engine.interactionManager](#engineinteractionmanager)
+  - [engine.transformManager](#enginetransformmanager)
+  - [Output Methods](#output-methods)
+  - [Memory Monitoring](#memory-monitoring)
+  - [Events](#events)
+  - [Advanced: Custom Pipeline Stages](#advanced-custom-pipeline-stages)
+  - [All Exports](#all-exports)
+- [Browser Requirements](#browser-requirements)
+- [Optional Dependencies](#optional-dependencies)
+  - [Enabling OIDN (Intel Open Image Denoise)](#enabling-oidn-intel-open-image-denoise)
+  - [Enabling the AI Upscaler](#enabling-the-ai-upscaler)
+- [Troubleshooting](#troubleshooting)
+- [License](#license)
+
 ## Installation
 
 ```bash
 npm install rayzee three
 ```
 
-`three` (>=0.183.0) is a required peer dependency.
+`three` (>=0.185.0) is a required peer dependency.
 
 ## Getting Started
 
@@ -65,7 +99,7 @@ npm install rayzee three
    });
 
    // Tweak settings
-   engine.settings.set('bounces', 8);
+   engine.settings.set('maxBounces', 8);
    engine.settings.set('exposure', 1.2);
 
    // Use namespaced APIs and direct methods
@@ -95,10 +129,10 @@ A single HTML file — no Node.js, no build step. Uses [ES module import maps](h
   <script type="importmap">
   {
     "imports": {
-      "three": "https://cdn.jsdelivr.net/npm/three@0.183.0/build/three.webgpu.js",
-      "three/tsl": "https://cdn.jsdelivr.net/npm/three@0.183.0/build/three.tsl.js",
-      "three/webgpu": "https://cdn.jsdelivr.net/npm/three@0.183.0/build/three.webgpu.js",
-      "three/addons/": "https://cdn.jsdelivr.net/npm/three@0.183.0/examples/jsm/",
+      "three": "https://cdn.jsdelivr.net/npm/three@0.185.0/build/three.webgpu.js",
+      "three/tsl": "https://cdn.jsdelivr.net/npm/three@0.185.0/build/three.tsl.js",
+      "three/webgpu": "https://cdn.jsdelivr.net/npm/three@0.185.0/build/three.webgpu.js",
+      "three/addons/": "https://cdn.jsdelivr.net/npm/three@0.185.0/examples/jsm/",
       "oidn-web": "https://cdn.jsdelivr.net/npm/oidn-web@0.3.5/dist/oidn.js",
       "rayzee": "https://cdn.jsdelivr.net/npm/rayzee/dist/rayzee.es.js"
     }
@@ -291,21 +325,33 @@ Constructing a new `PathTracerApp` on a canvas that already has an active instan
 #### Loading Assets
 
 ```js
-await engine.loadModel(url)           // Load GLB/GLTF/FBX/OBJ/STL/PLY/DAE/3MF/USDZ/ZIP
-await engine.loadObject3D(object3d)   // Load a Three.js Object3D directly
-await engine.loadEnvironment(url)     // Load HDR/EXR environment map
+await engine.loadModel(url)                  // Load GLB/GLTF/FBX/OBJ/STL/PLY/DAE/3MF/USDZ/ZIP
+await engine.loadObject3D(object3d, name?)    // Load a Three.js Object3D directly (name is optional, defaults to 'object3d')
+await engine.loadEnvironment(url)             // Load HDR/EXR environment map
+engine.cancelLoad()                           // Abort an in-flight download (network phase only; no-op once processing starts)
+```
+
+`loadModel` / `loadObject3D` **replace** the current scene. To add or remove objects from a live scene without a full reload (and without reframing the camera):
+
+```js
+const id = await engine.addModel(url, { name })                  // Append a model, rebuild in place
+const id = await engine.addModelFromObject3D(object3d, { name })  // Append a caller-owned Object3D (caller retains ownership)
+await engine.removeSceneObject(id)                                // Remove by id — returns false if not found
+engine.setSceneObjectVisibility(id, visible)                      // Toggle visibility with an O(1) BVH-leaf patch, no rebuild
 ```
 
+`id` is the appended root's `Object3D.uuid`, returned by `addModel`/`addModelFromObject3D`. The built-in ground plane is permanent and can't be removed.
+
 #### Settings
 
 ```js
-engine.settings.set('bounces', 8)              // Set a single parameter
+engine.settings.set('maxBounces', 8)           // Set a single parameter
 engine.settings.setMany({                      // Set multiple parameters at once
-  bounces: 8,
+  maxBounces: 8,
   maxSamples: 60,
   exposure: 1.0
 })
-engine.settings.get('bounces')                 // Read a parameter
+engine.settings.get('maxBounces')              // Read a parameter
 engine.settings.getAll()                       // Get all current settings
 ```
 
@@ -313,30 +359,43 @@ Key settings:
 
 | Setting | Type | Default | Description |
 |---|---|---|---|
-| `bounces` | `number` | 3 | Max ray bounce depth |
+| `maxBounces` | `number` | 3 | Max ray bounce depth |
 | `maxSamples` | `number` | 60 | Max accumulated samples before stopping |
 | `exposure` | `number` | 1.0 | Exposure value |
 | `saturation` | `number` | 1.2 | Color saturation |
 | `enableEnvironment` | `boolean` | true | Use environment lighting |
 | `environmentIntensity` | `number` | 1.0 | Environment light strength |
 | `environmentRotation` | `number` | 270 | Environment Y-rotation (degrees) |
+| `showBackground` | `boolean` | true | Show the environment as a visible backdrop for camera-miss rays (vs. a solid/transparent background) |
+| `samplingTechnique` | `number` | 3 | Light-sampling / MIS technique selector |
 | `fireflyThreshold` | `number` | 3.0 | Firefly clamping threshold |
 | `transmissiveBounces` | `number` | 5 | Max bounces for transmissive materials |
+| `maxSubsurfaceSteps` | `number` | 8 | Max random-walk steps for subsurface scattering (raised to 64 by `configureForMode('production')`) |
+| `enableAlphaShadows` | `boolean` | false | Alpha-tested shadow rays (enabled by `configureForMode('production')`) |
 | `enableDOF` | `boolean` | false | Enable depth of field |
 | `focusDistance` | `number` | 0.8 | DOF focus distance |
 | `aperture` | `number` | 5.6 | DOF aperture (f-stop) |
 | `focalLength` | `number` | 50 | DOF focal length (mm) |
 | `transparentBackground` | `boolean` | false | Transparent canvas background |
 | `interactionModeEnabled` | `boolean` | true | Lower quality during camera movement for smoother navigation |
-| `debugMode` | `number` | 0 | Debug visualization mode (0 = off) |
-| `environmentMode` | `string` | 'hdri' | Sky mode: `'hdri'` \| `'procedural'` \| `'gradient'` \| `'color'` |
+| `renderMode` | `number` | 0 | Internal preview(0)/production(1) flag driving accumulation & ASVGF behavior — normally set via `configureForMode()`, not written directly |
+| `visMode` | `number` | 0 | Debug visualization mode (0 = off) |
+| `environmentMode` | `string` | 'hdri' | Sky mode: `'hdri'` \| `'procedural'` \| `'gradient'` \| `'color'` — not routed through `engine.settings`; use `engine.environmentManager.setMode()` instead |
+| `useAdaptiveSampling` | `boolean` | true | Whole-frame early-stop once convergence reaches `adaptiveStopFraction` |
+| `noiseThreshold` | `number` | 0.02 | Relative-error threshold below which a pixel is considered converged |
+| `darkNoiseFloor` | `number` | 0.003 | Absolute-error floor so dim pixels don't stall convergence |
+| `adaptiveMinSamples` | `number` | 8 | Minimum samples before adaptive sampling can trigger |
+| `adaptiveStopFraction` | `number` | 0.95 | Fraction of pixels that must converge before the frame retires |
+| `usePixelFreeze` | `boolean` | false | Per-pixel freeze (Tier-2): skip individually-converged pixels via active-list compaction |
+| `pixelFreezeThreshold` | `number` | 0.02 | Relative-error threshold for a pixel to become a freeze candidate |
+| `pixelFreezeStability` | `number` | 8 | Consecutive candidate frames required before a pixel freezes |
 
 See `ENGINE_DEFAULTS` for the full list with default values.
 
 #### Rendering Modes
 
 ```js
-engine.configureForMode('production')   // High quality (tiled, 20 bounces, OIDN, controls disabled)
+engine.configureForMode('production')   // High quality (full-frame, 20 bounces, OIDN, controls disabled)
 engine.configureForMode('interactive')  // Real-time navigation (3 bounces, controls enabled)
 ```
 
@@ -396,6 +455,11 @@ engine.reset()                        // Re-upload all material data to GPU
 engine.stages.pathTracer.materialData.updateMaterial(index, mat)  // Replace a material
 await engine.rebuildMaterials(scene)  // Full rebuild (after texture changes)
 
+// Cap the longest edge of processed material textures (clamped to the hardware max).
+// Larger = sharper textures, ~quadratic VRAM. Reprocesses the current scene by default.
+await engine.setMaxTextureSize(2048)
+await engine.setMaxTextureSize(4096, { reprocess: false })
+
 // Per-mesh visibility — recommended UUID-based API (handles lookup + sync internally)
 engine.setMeshVisibilityByUuid(uuid, true)             // explicit set
 engine.setMeshVisibilityByUuid(uuid, prev => !prev)    // toggle via updater fn
@@ -550,6 +614,7 @@ engine.addEventListener(EngineEvents.RENDER_COMPLETE, (e) => {
 | `AF_POINT_PLACED` | Focus point placed on screen |
 | `ANIMATION_STARTED` / `ANIMATION_PAUSED` / `ANIMATION_STOPPED` / `ANIMATION_FINISHED` | Animation lifecycle |
 | `VIDEO_RENDER_PROGRESS` / `VIDEO_RENDER_COMPLETE` | Video export progress |
+| `DEVICE_LOST` | The GPU device was lost (driver crash/reset) — rendering halts instead of throwing into a dead device |
 | `DISPOSE` | Engine is being disposed (fires before teardown begins, so listeners can release their own references) |
 
 ### Advanced: Custom Pipeline Stages
@@ -604,6 +669,8 @@ import {
   RenderSettings,
   CameraManager,
   LightManager,
+  GoboManager,
+  IESManager,
   DenoisingManager,
   OverlayManager,
   AnimationManager,
@@ -632,6 +699,8 @@ import { VRAMTracker, bufferBytes, textureBytes } from 'rayzee';
 | `oidn-web` | Intel Open Image Denoise for high-quality final renders | Yes — `npm install oidn-web` |
 | `onnxruntime-web` | AI-powered upscaling | No — loaded from CDN at runtime |
 
+> **Note:** `onnxruntime-web` is also listed in `package.json` under `optionalDependencies` for bundler compatibility, but the engine's own runtime path always fetches it from a CDN (see `ortRuntimeUrl` / `ortWasmPaths` in [Configuring Assets](#configuring-assets-cdn-urls--cache-namespace)) rather than importing the installed package — installing it locally has no effect unless you also override those URLs to point at your own copy.
+
 ### Enabling OIDN (Intel Open Image Denoise)
 
 OIDN provides high-quality AI denoising for final renders. It runs automatically after the render converges (reaches `maxSamples`).

package/dist/rayzee.es.js

@@ -6026,48 +6026,49 @@ function qs(e, t) {
 //#region src/Processor/EmissiveTriangleBuilder.js
 var Js = class {
 	constructor() {
-		this.emissiveTriangles = [], this.emissiveCount = 0, this.totalEmissivePower = 0, this.emissiveIndicesArray = null, this.emissivePowerArray = null, this.cdfArray = null, this.lightBVHNodeData = null, this.lightBVHNodeCount = 0, this.emissiveBitTrailMap = null, this._totalTriangleCount = 0;
+		this.emissiveTriangles = [], this.emissiveCount = 0, this.totalEmissivePower = 0, this.emissiveIndicesArray = null, this.emissivePowerArray = null, this.cdfArray = null, this.lightBVHNodeData = null, this.lightBVHNodeCount = 0, this.emissiveBitTrailMap = null, this._totalTriangleCount = 0, this._hiddenMeshes = /* @__PURE__ */ new Set();
 	}
 	extractEmissiveTriangles(e, t, n) {
 		console.log("[EmissiveTriangleBuilder] Extracting emissive triangles..."), this.emissiveTriangles = [], this.totalEmissivePower = 0, this._totalTriangleCount = n;
-		let r = Z.FLOATS_PER_TRIANGLE, i = Z.UV_C_MAT_OFFSET + 2;
-		for (let a = 0; a < n; a++) {
-			let n = a * r, o = Math.floor(e[n + i]), s = t[o];
-			if (!s) continue;
-			let c = s.emissive || {
+		let r = Z.FLOATS_PER_TRIANGLE, i = Z.UV_C_MAT_OFFSET + 2, a = Z.UV_C_MAT_OFFSET + 3;
+		for (let o = 0; o < n; o++) {
+			let n = o * r, s = Math.floor(e[n + i]), c = Math.floor(e[n + a]), l = t[s];
+			if (!l) continue;
+			let u = l.emissive || {
 				r: 0,
 				g: 0,
 				b: 0
-			}, l = s.emissiveIntensity || 0;
-			if (l > 0 && (c.r > 0 || c.g > 0 || c.b > 0)) {
-				let t = e[n + 0], r = e[n + 1], i = e[n + 2], u = e[n + 4], d = e[n + 5], f = e[n + 6], p = e[n + 8], m = e[n + 9], h = e[n + 10], g = this._calculateTriangleArea(t, r, i, u, d, f, p, m, h), _ = (.2126 * c.r + .7152 * c.g + .0722 * c.b) * l * g, v = (d - r) * (h - i) - (f - i) * (m - r), y = (f - i) * (p - t) - (u - t) * (h - i), b = (u - t) * (m - r) - (d - r) * (p - t), x = Math.sqrt(v * v + y * y + b * b) || 1, S = s.side === 1 ? -1 : 1;
-				v = v / x * S, y = y / x * S, b = b / x * S;
-				let C = s.side === 2, w = (t + u + p) / 3, T = (r + d + m) / 3, E = (i + f + h) / 3, D = Math.min(t, u, p), O = Math.min(r, d, m), k = Math.min(i, f, h), A = Math.max(t, u, p), j = Math.max(r, d, m), M = Math.max(i, f, h);
+			}, d = l.emissiveIntensity || 0;
+			if (d > 0 && (u.r > 0 || u.g > 0 || u.b > 0)) {
+				let t = e[n + 0], r = e[n + 1], i = e[n + 2], a = e[n + 4], f = e[n + 5], p = e[n + 6], m = e[n + 8], h = e[n + 9], g = e[n + 10], _ = this._calculateTriangleArea(t, r, i, a, f, p, m, h, g), v = (.2126 * u.r + .7152 * u.g + .0722 * u.b) * d * _, y = (f - r) * (g - i) - (p - i) * (h - r), b = (p - i) * (m - t) - (a - t) * (g - i), x = (a - t) * (h - r) - (f - r) * (m - t), S = Math.sqrt(y * y + b * b + x * x) || 1, C = l.side === 1 ? -1 : 1;
+				y = y / S * C, b = b / S * C, x = x / S * C;
+				let w = l.side === 2, T = (t + a + m) / 3, E = (r + f + h) / 3, D = (i + p + g) / 3, O = Math.min(t, a, m), k = Math.min(r, f, h), A = Math.min(i, p, g), j = Math.max(t, a, m), M = Math.max(r, f, h), ee = Math.max(i, p, g);
 				this.emissiveTriangles.push({
-					triangleIndex: a,
-					materialIndex: o,
-					power: _,
-					area: g,
+					triangleIndex: o,
+					materialIndex: s,
+					meshIndex: c,
+					power: v,
+					area: _,
 					emissive: {
-						r: c.r,
-						g: c.g,
-						b: c.b
+						r: u.r,
+						g: u.g,
+						b: u.b
 					},
-					emissiveIntensity: l,
-					cx: w,
-					cy: T,
-					cz: E,
-					bMinX: D,
-					bMinY: O,
-					bMinZ: k,
-					bMaxX: A,
-					bMaxY: j,
-					bMaxZ: M,
-					nx: v,
-					ny: y,
-					nz: b,
-					twoSided: C
-				}), this.totalEmissivePower += _;
+					emissiveIntensity: d,
+					cx: T,
+					cy: E,
+					cz: D,
+					bMinX: O,
+					bMinY: k,
+					bMinZ: A,
+					bMaxX: j,
+					bMaxY: M,
+					bMaxZ: ee,
+					nx: y,
+					ny: b,
+					nz: x,
+					twoSided: w
+				}), this.totalEmissivePower += v;
 			}
 		}
 		return this.emissiveCount = this.emissiveTriangles.length, console.log(`[EmissiveTriangleBuilder] Found ${this.emissiveCount} emissive triangles (${(this.emissiveCount / n * 100).toFixed(2)}%)`), console.log(`[EmissiveTriangleBuilder] Total emissive power: ${this.totalEmissivePower.toFixed(2)}`), this._buildDataArrays(), this.emissiveCount;
@@ -6161,44 +6162,57 @@ var Js = class {
 		if (s !== this.emissiveTriangles.some((t) => t.materialIndex === e)) return this.extractEmissiveTriangles(n, r, i), !0;
 		if (!s) return !1;
 		let c = .2126 * a.r + .7152 * a.g + .0722 * a.b;
-		this.totalEmissivePower = 0;
-		for (let t = 0; t < this.emissiveCount; t++) {
-			let n = this.emissiveTriangles[t];
-			n.materialIndex === e && (n.power = c * o * n.area, n.emissive = {
-				r: a.r,
-				g: a.g,
-				b: a.b
-			}, n.emissiveIntensity = o, this.emissivePowerArray[t] = n.power), this.totalEmissivePower += this.emissiveTriangles[t].power;
+		for (let t of this.emissiveTriangles) t.materialIndex === e && (t.power = c * o * t.area, t.emissive = {
+			r: a.r,
+			g: a.g,
+			b: a.b
+		}, t.emissiveIntensity = o);
+		return !0;
+	}
+	setHiddenMeshes(e) {
+		let t = /* @__PURE__ */ new Set();
+		for (let e of this.emissiveTriangles) t.add(e.meshIndex);
+		let n = /* @__PURE__ */ new Set();
+		for (let r of e) t.has(r) && n.add(r);
+		let r = this._hiddenMeshes, i = n.size !== r.size;
+		if (!i) {
+			for (let e of n) if (!r.has(e)) {
+				i = !0;
+				break;
+			}
 		}
-		return this._buildCDF(), !0;
+		return this._hiddenMeshes = n, i;
 	}
 	buildLightBVH() {
-		if (this.emissiveCount === 0) return this.lightBVHNodeData = new Float32Array(16), this.lightBVHNodeData[7] = 1, this.lightBVHNodeData[14] = 1, this.lightBVHNodeData[15] = -1, this.lightBVHNodeCount = 1, this.emissiveBitTrailMap = new Float32Array(Math.max(this._totalTriangleCount, 1)).fill(-1), 1;
-		let { nodeData: e, nodeCount: t, sortedPerm: n, bitTrails: r } = new Gs().build(this.emissiveTriangles);
-		this.lightBVHNodeData = e, this.lightBVHNodeCount = t, this._rebuildSortedEmissiveData(n), this.emissiveBitTrailMap = new Float32Array(Math.max(this._totalTriangleCount, 1)).fill(-1);
-		for (let e = 0; e < n.length; e++) {
-			let t = this.emissiveTriangles[n[e]].triangleIndex;
-			this.emissiveBitTrailMap[t] = r[e];
+		let e = this._hiddenMeshes.size === 0 ? this.emissiveTriangles : this.emissiveTriangles.filter((e) => !this._hiddenMeshes.has(e.meshIndex));
+		this.emissiveCount = e.length, this.totalEmissivePower = 0;
+		for (let t of e) this.totalEmissivePower += t.power;
+		if (e.length === 0) return this.lightBVHNodeData = new Float32Array(16), this.lightBVHNodeData[7] = 1, this.lightBVHNodeData[14] = 1, this.lightBVHNodeData[15] = -1, this.lightBVHNodeCount = 1, this.emissiveBitTrailMap = new Float32Array(Math.max(this._totalTriangleCount, 1)).fill(-1), this.emissiveIndicesArray = new Int32Array(), this.emissivePowerArray = new Float32Array(), this._buildCDF(), this.emissiveTriangleData = new Float32Array(8), 1;
+		let { nodeData: t, nodeCount: n, sortedPerm: r, bitTrails: i } = new Gs().build(e);
+		this.lightBVHNodeData = t, this.lightBVHNodeCount = n, this._rebuildSortedEmissiveData(r, e), this.emissiveBitTrailMap = new Float32Array(Math.max(this._totalTriangleCount, 1)).fill(-1);
+		for (let t = 0; t < r.length; t++) {
+			let n = e[r[t]].triangleIndex;
+			this.emissiveBitTrailMap[n] = i[t];
 		}
-		return t;
+		return n;
 	}
-	_rebuildSortedEmissiveData(e) {
-		let t = e.length;
-		this.emissiveIndicesArray = new Int32Array(t), this.emissivePowerArray = new Float32Array(t);
-		for (let n = 0; n < t; n++) {
-			let t = e[n];
-			this.emissiveIndicesArray[n] = this.emissiveTriangles[t].triangleIndex, this.emissivePowerArray[n] = this.emissiveTriangles[t].power;
+	_rebuildSortedEmissiveData(e, t) {
+		let n = e.length;
+		this.emissiveIndicesArray = new Int32Array(n), this.emissivePowerArray = new Float32Array(n);
+		for (let r = 0; r < n; r++) {
+			let n = e[r];
+			this.emissiveIndicesArray[r] = t[n].triangleIndex, this.emissivePowerArray[r] = t[n].power;
 		}
 		this._buildCDF();
-		let n = new Float32Array(t * 8);
-		for (let r = 0; r < t; r++) {
-			let t = e[r], i = this.emissiveTriangles[t], a = r * 8;
-			n[a + 0] = i.triangleIndex, n[a + 1] = i.power, n[a + 2] = this.cdfArray[r], n[a + 3] = this.totalEmissivePower > 0 ? i.power / this.totalEmissivePower : 0, n[a + 4] = i.emissive.r * i.emissiveIntensity, n[a + 5] = i.emissive.g * i.emissiveIntensity, n[a + 6] = i.emissive.b * i.emissiveIntensity, n[a + 7] = i.area;
+		let r = new Float32Array(n * 8);
+		for (let i = 0; i < n; i++) {
+			let n = t[e[i]], a = i * 8;
+			r[a + 0] = n.triangleIndex, r[a + 1] = n.power, r[a + 2] = this.cdfArray[i], r[a + 3] = this.totalEmissivePower > 0 ? n.power / this.totalEmissivePower : 0, r[a + 4] = n.emissive.r * n.emissiveIntensity, r[a + 5] = n.emissive.g * n.emissiveIntensity, r[a + 6] = n.emissive.b * n.emissiveIntensity, r[a + 7] = n.area;
 		}
-		this.emissiveTriangleData = n, console.log(`[EmissiveTriangleBuilder] Rebuilt sorted emissive data: ${t} entries`);
+		this.emissiveTriangleData = r, console.log(`[EmissiveTriangleBuilder] Rebuilt sorted emissive data: ${n} entries`);
 	}
 	clear() {
-		this.emissiveTriangles = [], this.emissiveCount = 0, this.totalEmissivePower = 0, this.emissiveIndicesArray = null, this.emissivePowerArray = null, this.cdfArray = null, this.lightBVHNodeData = null, this.lightBVHNodeCount = 0, this.emissiveBitTrailMap = null, this._totalTriangleCount = 0;
+		this.emissiveTriangles = [], this.emissiveCount = 0, this.totalEmissivePower = 0, this.emissiveIndicesArray = null, this.emissivePowerArray = null, this.cdfArray = null, this.lightBVHNodeData = null, this.lightBVHNodeCount = 0, this.emissiveBitTrailMap = null, this._totalTriangleCount = 0, this._hiddenMeshes = /* @__PURE__ */ new Set();
 	}
 }, Ys = class {
 	constructor(e = "Build") {
@@ -6558,7 +6572,7 @@ var Js = class {
 		for (let n of this.materials) n.map = t(n.map, e.albedo), n.emissiveMap = t(n.emissiveMap, e.emissive), n.normalMap = t(n.normalMap, e.normal), n.bumpMap = t(n.bumpMap, e.bump), n.roughnessMap = t(n.roughnessMap, e.roughness), n.metalnessMap = t(n.metalnessMap, e.metalness), n.displacementMap = t(n.displacementMap, e.displacement), n.anisotropyMap = t(n.anisotropyMap, e.anisotropy), n.transmissionMap = t(n.transmissionMap, e.transmission), n.clearcoatMap = t(n.clearcoatMap, e.clearcoat), n.clearcoatRoughnessMap = t(n.clearcoatRoughnessMap, e.clearcoatRoughness), n.sheenColorMap = t(n.sheenColorMap, e.sheenColor), n.sheenRoughnessMap = t(n.sheenRoughnessMap, e.sheenRoughness), n.iridescenceMap = t(n.iridescenceMap, e.iridescence), n.iridescenceThicknessMap = t(n.iridescenceThicknessMap, e.iridescenceThickness), n.specularIntensityMap = t(n.specularIntensityMap, e.specularIntensity), n.specularColorMap = t(n.specularColorMap, e.specularColor);
 	}
 	_buildEmissiveData() {
-		this.emissiveTriangleCount = this.emissiveTriangleBuilder.extractEmissiveTriangles(this.triangleData, this.materials, this.triangleCount), this.emissiveTriangleData = this.emissiveTriangleBuilder.createEmissiveRawData(), this.emissiveTotalPower = this.emissiveTriangleBuilder.totalEmissivePower, this._log("Emissive triangle extraction complete", this.emissiveTriangleBuilder.getStats()), this.emissiveTriangleBuilder.buildLightBVH(), this.lightBVHNodeData = this.emissiveTriangleBuilder.lightBVHNodeData, this.lightBVHNodeCount = this.emissiveTriangleBuilder.lightBVHNodeCount, this.emissiveTriangleData = this.emissiveTriangleBuilder.emissiveTriangleData || this.emissiveTriangleData, this.emissiveBitTrailMap = this.emissiveTriangleBuilder.emissiveBitTrailMap;
+		this.emissiveTriangleCount = this.emissiveTriangleBuilder.extractEmissiveTriangles(this.triangleData, this.materials, this.triangleCount), this.emissiveTriangleData = this.emissiveTriangleBuilder.createEmissiveRawData(), this.emissiveTotalPower = this.emissiveTriangleBuilder.totalEmissivePower, this._log("Emissive triangle extraction complete", this.emissiveTriangleBuilder.getStats()), this.emissiveTriangleBuilder.buildLightBVH(), this.lightBVHNodeData = this.emissiveTriangleBuilder.lightBVHNodeData, this.lightBVHNodeCount = this.emissiveTriangleBuilder.lightBVHNodeCount, this.emissiveTriangleData = this.emissiveTriangleBuilder.emissiveTriangleData || this.emissiveTriangleData, this.emissiveBitTrailMap = this.emissiveTriangleBuilder.emissiveBitTrailMap, this.emissiveTriangleCount = this.emissiveTriangleBuilder.emissiveCount, this.emissiveTotalPower = this.emissiveTriangleBuilder.totalEmissivePower;
 	}
 	_createSpheres() {
 		return [];
@@ -6713,14 +6727,20 @@ var Js = class {
 	updateMaterialEmissive(e, t, n) {
 		if (!this.emissiveTriangleBuilder) return null;
 		let r = this.materials[e];
-		return !r || (t === "emissive" ? r.emissive = n : t === "emissiveIntensity" && (r.emissiveIntensity = n), !this.emissiveTriangleBuilder.updateMaterialEmissive(e, r, this.triangleData, this.materials, this.triangleCount)) ? null : (this.emissiveTriangleBuilder.buildLightBVH(), this.lightBVHNodeData = this.emissiveTriangleBuilder.lightBVHNodeData, this.lightBVHNodeCount = this.emissiveTriangleBuilder.lightBVHNodeCount, this.emissiveTriangleData = this.emissiveTriangleBuilder.emissiveTriangleData, this.emissiveBitTrailMap = this.emissiveTriangleBuilder.emissiveBitTrailMap, this.emissiveTriangleCount = this.emissiveTriangleBuilder.emissiveCount, this.emissiveTotalPower = this.emissiveTriangleBuilder.totalEmissivePower, {
-			rawData: this.emissiveTriangleBuilder.emissiveTriangleData,
-			emissiveCount: this.emissiveTriangleBuilder.emissiveCount,
-			totalPower: this.emissiveTriangleBuilder.totalEmissivePower,
+		return !r || (t === "emissive" ? r.emissive = n : t === "emissiveIntensity" && (r.emissiveIntensity = n), !this.emissiveTriangleBuilder.updateMaterialEmissive(e, r, this.triangleData, this.materials, this.triangleCount)) ? null : this._collectEmissivePayload();
+	}
+	rebuildEmissiveForVisibility(e, t = !1) {
+		return !this.emissiveTriangleBuilder || !this.emissiveTriangleBuilder.setHiddenMeshes(e) && !t ? null : this._collectEmissivePayload();
+	}
+	_collectEmissivePayload() {
+		return this.emissiveTriangleBuilder.buildLightBVH(), this.lightBVHNodeData = this.emissiveTriangleBuilder.lightBVHNodeData, this.lightBVHNodeCount = this.emissiveTriangleBuilder.lightBVHNodeCount, this.emissiveTriangleData = this.emissiveTriangleBuilder.emissiveTriangleData, this.emissiveBitTrailMap = this.emissiveTriangleBuilder.emissiveBitTrailMap, this.emissiveTriangleCount = this.emissiveTriangleBuilder.emissiveCount, this.emissiveTotalPower = this.emissiveTriangleBuilder.totalEmissivePower, {
+			rawData: this.emissiveTriangleData,
+			emissiveCount: this.emissiveTriangleCount,
+			totalPower: this.emissiveTotalPower,
 			bitTrailMap: this.emissiveBitTrailMap,
 			lightBVHNodeData: this.lightBVHNodeData,
 			lightBVHNodeCount: this.lightBVHNodeCount
-		});
+		};
 	}
 	_updateMeshTrianglePositions(e, t) {
 		let n = Z.FLOATS_PER_TRIANGLE, r = Z.POSITION_A_OFFSET, i = Z.POSITION_B_OFFSET, a = Z.POSITION_C_OFFSET, o = Z.NORMAL_A_OFFSET, s = Z.NORMAL_B_OFFSET, c = Z.NORMAL_C_OFFSET, l = e.bvhToOriginal;
@@ -7188,7 +7208,7 @@ var cc = 4, lc = class extends $n {
 		}, this.environment = new _i(this.scene, this.uniforms), this.environment.callbacks.onReset = () => this.reset(), this.environment.callbacks.getSceneTextureNodes = () => this.shaderBuilder.getSceneTextureNodes(), this.shaderBuilder = new us(), this._initRenderingState(), this.setupBlueNoise(), this.tempVector2 = new nn(), this.lastCameraMatrix = new bt(), this.lastProjectionMatrix = new bt(), 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 = Se(this.lightStorageAttr, "vec4", 1).toReadOnly(), 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.lightStorageAttr = new o(new Float32Array(16), 4), this.lightStorageNode = Se(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;
@@ -7478,8 +7498,15 @@ var cc = 4, lc = class extends $n {
 		this.stbnScalarTexture = e, e && (Fn.value = e);
 	}
 	_rebuildLightBuffer() {
-		let e = this._lbvhDataCache, t = this._emissiveDataCache, n = this._bitTrailMapCache, r = e ? e.length : 0, i = t ? t.length : 0, a = n ? Math.ceil(n.length / 4) * 4 : 0, s = Math.max(r + i + a, 4), c = new Float32Array(s);
-		e && c.set(e, 0), t && c.set(t, r), n && c.set(n, r + i), this.lightStorageAttr = new o(c, 4), this.lightStorageNode.value = this.lightStorageAttr, this.lightStorageNode.bufferCount = c.length / 4, this.emissiveVec4Offset.value = (this.lightBVHNodeCount.value || 0) * 4, this.reverseMapVec4Offset.value = (r + i) / 4;
+		let e = this._lbvhDataCache, t = this._emissiveDataCache, n = this._bitTrailMapCache, r = e ? e.length : 0, i = t ? t.length : 0, a = n ? Math.ceil(n.length / 4) * 4 : 0, s = Math.max(r + i + a, 4);
+		if (this.lightStorageAttr && s <= this.lightStorageAttr.array.length) {
+			let a = this.lightStorageAttr.array;
+			e && a.set(e, 0), t && a.set(t, r), n && a.set(n, r + i), this.lightStorageAttr.needsUpdate = !0;
+		} else {
+			let a = new Float32Array(s);
+			e && a.set(e, 0), t && a.set(t, r), n && a.set(n, r + i), this.lightStorageAttr = new o(a, 4), this.lightStorageNode.value = this.lightStorageAttr, this.lightStorageNode.bufferCount = a.length / 4, this._lightBufferRealloc = !0;
+		}
+		this.emissiveVec4Offset.value = (this.lightBVHNodeCount.value || 0) * 4, this.reverseMapVec4Offset.value = (r + i) / 4;
 	}
 	setEmissiveTriangleData(e, t, n = 0, r = null) {
 		e && (this._emissiveDataCache = e, r && (this._bitTrailMapCache = r), this.emissiveTriangleCount.value = t, this.emissiveTotalPower.value = n, this._rebuildLightBuffer(), console.log(`PathTracer: ${t} emissive triangles, totalPower=${n.toFixed(4)} (storage buffer)`));
@@ -8896,8 +8923,8 @@ var vl = /* @__PURE__ */ G("\n	fn equirectDirectionToUv( direction: vec3f, envir
 }), cu = f(([e, t, n, r]) => {
 	let i = t.sub(e), a = n.sub(e), o = n.sub(t), s = F(A(i, i), F(A(a, a), A(o, o))), c = O(i, a), l = A(c, c), u = T(!1).toVar();
 	return p(l.greaterThan(1e-20), () => {
-		let t = A(c, r.sub(e)), n = t.mul(t).div(l);
-		u.assign(s.greaterThan(n));
+		let t = A(c, r.sub(e)), n = t.mul(t).div(l), i = s.mul(s).lessThan(l.mul(64));
+		u.assign(s.greaterThan(n).and(i));
 	}), u;
 }), lu = wn({
 	direction: "vec3",
@@ -9818,7 +9845,7 @@ var Yu = class extends lc {
 		super.setupMaterial(), this.materialData?.materialCount > 0 && (this._kernelManager && this._kernelManager.dispose(), this._wavefrontReady = !1, this._buildWavefrontKernels());
 	}
 	render(e) {
-		if (!this.isReady || !this._wavefrontReady) return;
+		if (!this.isReady || !this._wavefrontReady || this._lightBufferRealloc && (this._kernelManager && this._kernelManager.dispose(), this._wavefrontReady = !1, this._buildWavefrontKernels(), !this._wavefrontReady)) return;
 		if (this.isComplete || this.frameCount >= this.completionThreshold || this._isConvergedComplete()) {
 			this.isComplete ||= !0;
 			return;
@@ -9957,6 +9984,7 @@ var Yu = class extends lc {
 	_buildWavefrontKernels() {
 		let e = this.shaderBuilder.getSceneTextureNodes();
 		if (!e) return;
+		this._lightBufferRealloc = !1;
 		let t = this.storageTextures.renderWidth, n = this.storageTextures.renderHeight, r = t * n;
 		this._bounceEarlyExitThreshold !== -1 && (this._bounceEarlyExitThreshold = Math.max(100, Math.floor(r / 1e3))), this._packedBuffers ? this._packedBuffers.resize(r) : this._packedBuffers = new hc(r, this.renderer);
 		let i = hc.requiredCapacity(r) * 1;
@@ -16360,7 +16388,7 @@ var Yf = {
 			status: "Transferring data to GPU...",
 			progress: 86
 		}), await new Promise((e) => setTimeout(e, 0)), e.start("GPU data transfer"), !this._sdf.uploadToPathTracer(this.stages.pathTracer, this.lightManager, this.meshScene, t)) return !1;
-		this.stages.pathTracer._meshRefs = this.stages.pathTracer._collectMeshRefs(this.meshScene), this.stages.pathTracer.setMeshVisibilityData(this.stages.pathTracer._meshRefs), e.end("GPU data transfer"), ir({
+		this.stages.pathTracer._meshRefs = this.stages.pathTracer._collectMeshRefs(this.meshScene), this.stages.pathTracer.setMeshVisibilityData(this.stages.pathTracer._meshRefs), this._refreshEmissiveForVisibility(), e.end("GPU data transfer"), ir({
 			status: "Compiling shaders...",
 			progress: 90
 		}), await new Promise((e) => setTimeout(e, 0)), e.start("Material setup (TSL compile)"), this.stages.pathTracer.setupMaterial(), e.end("Material setup (TSL compile)"), e.start("Pipeline precompile");
@@ -16375,7 +16403,7 @@ var Yf = {
 		}), await n, this.stages.pathTracer.environment.applyCDFResults());
 		let r = this.getSceneMinY();
 		if (this.settings.set("groundProjectionLevel", r, { reset: !1 }), this.settings.set("groundCatcherHeight", r, { reset: !1 }), !this._emissiveSamplingUserSet) {
-			let e = (this._sdf?.emissiveTriangleCount ?? 0) > 0;
+			let e = (this._sdf?.emissiveTriangleBuilder?.emissiveTriangles?.length ?? this._sdf?.emissiveTriangleCount ?? 0) > 0;
 			this.settings.set("enableEmissiveTriangleSampling", e, { reset: !1 });
 		}
 		return e.start("Apply settings"), this.settings.applyAll(), this.stages.compositor.setTransparentBackground(this.settings.get("transparentBackground")), e.end("Apply settings"), e.print(), rr(), this._initAnimationAndTransforms(), this.dispatchEvent({ type: "SceneRebuild" }), !0;
@@ -16553,23 +16581,29 @@ var Yf = {
 		return Number.isFinite(e.min.y) ? e.min.y : 0;
 	}
 	setMaterialProperty(e, t, n) {
-		if (this.stages.pathTracer?.materialData.updateMaterialProperty(e, t, n), ["emissive", "emissiveIntensity"].includes(t) && this.stages.pathTracer?.enableEmissiveTriangleSampling?.value) {
-			let r = this._sdf.updateMaterialEmissive(e, t, n);
-			r && (this.stages.pathTracer.setEmissiveTriangleData(r.rawData, r.emissiveCount, r.totalPower, r.bitTrailMap), r.lightBVHNodeData && this.stages.pathTracer.setLightBVHData(r.lightBVHNodeData, r.lightBVHNodeCount));
-		}
-		this.reset();
+		this.stages.pathTracer?.materialData.updateMaterialProperty(e, t, n), ["emissive", "emissiveIntensity"].includes(t) && this._sdf && this._uploadEmissivePayload(this._sdf.updateMaterialEmissive(e, t, n)), this.reset();
+	}
+	_uploadEmissivePayload(e) {
+		!e || !this.stages.pathTracer || (this.stages.pathTracer.setEmissiveTriangleData(e.rawData, e.emissiveCount, e.totalPower, e.bitTrailMap), e.lightBVHNodeData && this.stages.pathTracer.setLightBVHData(e.lightBVHNodeData, e.lightBVHNodeCount));
+	}
+	_refreshEmissiveForVisibility() {
+		let e = this._sdf?.instanceTable?.entries;
+		if (!e) return;
+		let t = /* @__PURE__ */ new Set();
+		for (let n of e) n && n.visible === !1 && t.add(n.meshIndex);
+		this._uploadEmissivePayload(this._sdf.rebuildEmissiveForVisibility(t));
 	}
 	setEmissiveTriangleSampling(e) {
 		this._emissiveSamplingUserSet = !0, this.settings.set("enableEmissiveTriangleSampling", e);
 	}
 	hasEmissiveGeometry() {
-		return (this._sdf?.emissiveTriangleCount ?? 0) > 0;
+		return (this._sdf?.emissiveTriangleBuilder?.emissiveTriangles?.length ?? this._sdf?.emissiveTriangleCount ?? 0) > 0;
 	}
 	setMeshVisibility(e, t) {
-		this.stages.pathTracer?.updateMeshVisibility(e, t), this.reset();
+		this.stages.pathTracer?.updateMeshVisibility(e, t), this._refreshEmissiveForVisibility(), this.reset();
 	}
 	updateAllMeshVisibility() {
-		this.stages.pathTracer?.updateAllMeshVisibility(), this.reset();
+		this.stages.pathTracer?.updateAllMeshVisibility(), this._refreshEmissiveForVisibility(), this.reset();
 	}
 	getScene() {
 		return this.meshScene || this.scene;