rayzee 7.14.0 → 7.15.1

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.1%20KB-blue)](https://www.npmjs.com/package/rayzee)
+[![minzipped size](https://img.shields.io/badge/minzipped-169.6%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

@@ -11650,10 +11650,10 @@ var Yu = class extends lc {
 	}
 }, Cd = class extends st {
 	constructor({ scene: e, camera: t, canvas: n, assetLoader: r, pathTracer: i, floorPlane: a }) {
-		super(), this.scene = e, this.camera = t, this.canvas = n, this.assetLoader = r, this.pathTracer = i, this.floorPlane = a, this.raycaster = new zt(), this.focusMode = !1, this.focusPointIndicator = null, this.afPointPlacementMode = !1, this.handleAFPointClick = this.handleAFPointClick.bind(this), this.selectedObject = null, this.selectMode = !1, this.clickTimeout = null, this.mouseDownPosition = null, this.dragThreshold = 5, this.handleFocusClick = this.handleFocusClick.bind(this), this.handleSelectClick = this.handleSelectClick.bind(this), this.handleSelectDoubleClick = this.handleSelectDoubleClick.bind(this), this.handleMouseDown = this.handleMouseDown.bind(this), this.handleMouseUp = this.handleMouseUp.bind(this), this.handleContextMenu = this.handleContextMenu.bind(this), this.handleContextPointerDown = this.handleContextPointerDown.bind(this), this.handleContextPointerUp = this.handleContextPointerUp.bind(this), this.contextPointerDownPosition = null, this.canvas.addEventListener("pointerdown", this.handleContextPointerDown), this.canvas.addEventListener("pointerup", this.handleContextPointerUp), this.canvas.addEventListener("contextmenu", this.handleContextMenu), this._overlayManager = null, this._transformManager = null, this._appDispatch = null, this._orbitControls = null;
+		super(), this.scene = e, this.camera = t, this.canvas = n, this.assetLoader = r, this.pathTracer = i, this.floorPlane = a, this.raycaster = new zt(), this.focusMode = !1, this.focusPointIndicator = null, this.afPointPlacementMode = !1, this.handleAFPointClick = this.handleAFPointClick.bind(this), this.selectedObject = null, this.selectMode = !1, this.clickTimeout = null, this.mouseDownPosition = null, this.dragThreshold = 5, this.handleFocusClick = this.handleFocusClick.bind(this), this.handleSelectClick = this.handleSelectClick.bind(this), this.handleSelectDoubleClick = this.handleSelectDoubleClick.bind(this), this.handleMouseDown = this.handleMouseDown.bind(this), this.handleMouseUp = this.handleMouseUp.bind(this), this.handleContextMenu = this.handleContextMenu.bind(this), this.handleContextPointerDown = this.handleContextPointerDown.bind(this), this.handleContextPointerUp = this.handleContextPointerUp.bind(this), this.contextPointerDownPosition = null, this.canvas.addEventListener("pointerdown", this.handleContextPointerDown), this.canvas.addEventListener("pointerup", this.handleContextPointerUp), this.canvas.addEventListener("contextmenu", this.handleContextMenu), this._overlayManager = null, this._transformManager = null, this._appDispatch = null, this._orbitControls = null, this._helperScene = null;
 	}
-	setDependencies({ overlayManager: e, transformManager: t, appDispatch: n, orbitControls: r }) {
-		this._overlayManager = e || null, this._transformManager = t || null, this._appDispatch = n || null, this._orbitControls = r || null;
+	setDependencies({ overlayManager: e, transformManager: t, appDispatch: n, orbitControls: r, helperScene: i }) {
+		this._overlayManager = e || null, this._transformManager = t || null, this._appDispatch = n || null, this._orbitControls = r || null, this._helperScene = i || null;
 	}
 	select(e) {
 		let t = this._overlayManager?.getHelper("outline");
@@ -11753,17 +11753,17 @@ var Yu = class extends lc {
 			this.clickTimeout = null;
 			let t = this.getMouseCoordinates(e);
 			this.raycaster.setFromCamera(t, this.camera);
-			let n = this.raycaster.intersectObjects(this.scene.children, !0), r = this.filterValidIntersects(n);
-			if (r.length > 0) {
-				let e = r[0].object, t = this.selectedObject;
-				t && t.uuid === e.uuid ? this.dispatchEvent({
+			let n = this.raycaster.intersectObjects(this.scene.children, !0), r = this.filterValidIntersects(n), i = this._pickLightHelper(), a = null;
+			if (r.length > 0 && i ? a = r[0].distance <= i.distance ? r[0].object : i.light : r.length > 0 ? a = r[0].object : i && (a = i.light), a) {
+				let e = this.selectedObject;
+				e && e.uuid === a.uuid ? this.dispatchEvent({
 					type: "objectDeselected",
-					object: e,
-					uuid: e.uuid
+					object: a,
+					uuid: a.uuid
 				}) : this.dispatchEvent({
 					type: "objectSelected",
-					object: e,
-					uuid: e.uuid
+					object: a,
+					uuid: a.uuid
 				});
 			} else this.dispatchEvent({ type: "objectDeselected" });
 		}, 250);
@@ -11827,6 +11827,21 @@ var Yu = class extends lc {
 			return t !== this.focusPointIndicator && t !== this.floorPlane && !t.name.includes("Helper") && t.type === "Mesh";
 		});
 	}
+	_pickLightHelper() {
+		if (!this._helperScene || this._helperScene.children.length === 0) return null;
+		let e = this.raycaster.intersectObjects(this._helperScene.children, !0);
+		for (let t of e) {
+			let e = t.object;
+			for (; e;) {
+				if (e.light) return {
+					distance: t.distance,
+					light: e.light
+				};
+				e = e.parent;
+			}
+		}
+		return null;
+	}
 	updateDependencies({ scene: e, camera: t, floorPlane: n }) {
 		e && (this.scene = e), t && (this.camera = t), n && (this.floorPlane = n);
 	}
@@ -16024,9 +16039,9 @@ var Yf = {
 	dispose() {
 		this.mixer &&= (this.mixer.stopAllAction(), this.mixer.uncacheRoot(this._mixerRoot), null), this.actions = [], this.isPlaying = !1, this.timer.reset(), this._scene = null, this._mixerRoot = null, this._meshes = null, this._meshTriRanges = null, this._posBuffer = null, this._skinnedCache = null, this._clipsCache = null;
 	}
-}, np = class {
+}, np = new rn(0, 0, -1), rp = class {
 	constructor({ camera: e, canvas: t, orbitControls: n, app: r }) {
-		this._app = r, this._orbitControls = n, this._camera = e, this._controls = new vn(e, t), this._gizmoScene = new Gt(), this._gizmoScene.add(this._controls.getHelper()), this._attached = null, this._isDragging = !1, this._meshes = null, this._meshTriRanges = null, this._posBuffer = null, this._normalBuffer = null, this._skinnedCache = null, this._normalCache = null, this._tempVec = new rn(), this._normalMatrix = new yt(), this._refitInFlight = !1, this._baselineComputed = !1, this._onDraggingChanged = this._onDraggingChanged.bind(this), this._onObjectChange = this._onObjectChange.bind(this), this._controls.addEventListener("dragging-changed", this._onDraggingChanged), this._controls.addEventListener("objectChange", this._onObjectChange);
+		this._app = r, this._orbitControls = n, this._camera = e, this._controls = new vn(e, t), this._gizmoScene = new Gt(), this._gizmoScene.add(this._controls.getHelper()), this._attached = null, this._isDragging = !1, this._meshes = null, this._meshTriRanges = null, this._posBuffer = null, this._normalBuffer = null, this._skinnedCache = null, this._normalCache = null, this._tempVec = new rn(), this._normalMatrix = new yt(), this._refitInFlight = !1, this._baselineComputed = !1, this._tempForward = new rn(), this._lightTargetDistance = null, this._lastLightPosition = null, this._onDraggingChanged = this._onDraggingChanged.bind(this), this._onObjectChange = this._onObjectChange.bind(this), this._controls.addEventListener("dragging-changed", this._onDraggingChanged), this._controls.addEventListener("objectChange", this._onObjectChange);
 	}
 	setMeshData(e) {
 		this._meshes = e, this._meshTriRanges = [], this._skinnedCache = [], this._normalCache = [];
@@ -16043,19 +16058,22 @@ var Yf = {
 		this._posBuffer = new Float32Array(t * 9), this._normalBuffer = new Float32Array(t * 9), this._baselineComputed = !1;
 	}
 	attach(e) {
-		this._attached !== e && (this._controls.attach(e), this._attached = e);
+		if (this._attached !== e && (this._controls.attach(e), this._attached = e, this._lightTargetDistance = null, this._lastLightPosition = null, e.isLight && e.target)) {
+			let t = e.target.position.clone().sub(e.position), n = t.length();
+			n > 1e-4 ? (e.quaternion.setFromUnitVectors(np, t.normalize()), this._lightTargetDistance = n) : this._lightTargetDistance = 1, this._lastLightPosition = e.position.clone();
+		}
 	}
 	detach() {
-		this._attached &&= (this._controls.detach(), null);
+		this._attached && (this._controls.detach(), this._attached = null, this._lightTargetDistance = null, this._lastLightPosition = null);
 	}
 	setMode(e) {
 		this._controls.setMode(e), this._app?.dispatchEvent({
 			type: Y.TRANSFORM_MODE_CHANGED,
 			mode: e
-		});
+		}), this._app?.refreshFrame();
 	}
 	setSpace(e) {
-		this._controls.setSpace(e);
+		this._controls.setSpace(e), this._app?.refreshFrame();
 	}
 	get isDragging() {
 		return this._isDragging;
@@ -16072,10 +16090,29 @@ var Yf = {
 		e.autoClear = !1, e.clearDepth(), e.setRenderTarget(null), e.render(this._gizmoScene, this._camera), e.autoClear = t;
 	}
 	_onDraggingChanged(e) {
-		this._isDragging = e.value, this._orbitControls && (this._orbitControls.enabled = !e.value), e.value ? this._app.dispatchEvent({ type: Y.OBJECT_TRANSFORM_START }) : (this._recomputeAndRefit(), this._app.dispatchEvent({ type: Y.OBJECT_TRANSFORM_END }));
+		this._isDragging = e.value, this._orbitControls && (this._orbitControls.enabled = !e.value), e.value ? this._app.dispatchEvent({ type: Y.OBJECT_TRANSFORM_START }) : (this._attached?.isLight ? this._finalizeLightTransform() : this._recomputeAndRefit(), this._app.dispatchEvent({ type: Y.OBJECT_TRANSFORM_END }));
 	}
 	_onObjectChange() {
-		this._app.needsReset = !0, this._app.wake();
+		this._app.needsReset = !0, this._app.wake(), this._attached?.isLight && this._syncLightDuringDrag();
+	}
+	_syncLightDuringDrag() {
+		let e = this._attached;
+		if (e.target) {
+			let t = this._controls.mode;
+			if (t === "translate" && this._lastLightPosition) {
+				let t = this._tempForward.copy(e.position).sub(this._lastLightPosition);
+				e.target.position.add(t), e.target.updateMatrixWorld(!0);
+			} else if (t === "rotate" && this._lightTargetDistance != null) {
+				let t = this._tempForward.set(0, 0, -1).applyQuaternion(e.quaternion);
+				e.target.position.copy(e.position).addScaledVector(t, this._lightTargetDistance), e.target.updateMatrixWorld(!0);
+			}
+			this._lastLightPosition.copy(e.position);
+		}
+		this._app.lightManager?.updateLights();
+	}
+	_finalizeLightTransform() {
+		let e = this._attached;
+		e.isRectAreaLight && (e.scale.x !== 1 || e.scale.y !== 1) && (e.width *= e.scale.x, e.height *= e.scale.y, e.scale.set(1, 1, 1)), this._app.lightManager?.updateLights();
 	}
 	_recomputeAndRefit() {
 		if (!this._meshes || !this._posBuffer || this._refitInFlight || !this._attached) return;
@@ -16133,17 +16170,17 @@ var Yf = {
 		}
 	}
 	dispose() {
-		this._controls.removeEventListener("dragging-changed", this._onDraggingChanged), this._controls.removeEventListener("objectChange", this._onObjectChange), this.detach(), this._gizmoScene.remove(this._controls.getHelper()), this._controls.dispose(), this._meshes = null, this._meshTriRanges = null, this._posBuffer = null, this._normalBuffer = null, this._skinnedCache = null, this._normalCache = null, this._baselineComputed = !1, this._app = null, this._orbitControls = null, this._camera = null, this._controls = null, this._gizmoScene = null;
+		this._controls.removeEventListener("dragging-changed", this._onDraggingChanged), this._controls.removeEventListener("objectChange", this._onObjectChange), this.detach(), this._gizmoScene.remove(this._controls.getHelper()), this._controls.dispose(), this._meshes = null, this._meshTriRanges = null, this._posBuffer = null, this._normalBuffer = null, this._skinnedCache = null, this._normalCache = null, this._baselineComputed = !1, this._tempForward = null, this._lightTargetDistance = null, this._lastLightPosition = null, this._app = null, this._orbitControls = null, this._camera = null, this._controls = null, this._gizmoScene = null;
 	}
-}, rp = /* @__PURE__ */ new WeakMap(), ip = class extends st {
+}, ip = /* @__PURE__ */ new WeakMap(), ap = class extends st {
 	constructor(e, t = {}) {
 		super();
 		try {
-			rp.get(e)?.dispose();
+			ip.get(e)?.dispose();
 		} catch (e) {
 			console.warn("PathTracerApp: prior canvas owner dispose failed", e);
 		}
-		rp.set(e, this), this.canvas = e, this._autoResize = t.autoResize !== !1, this._container = t.container || null, this.settings = new cf(X), this.renderer = null, this.scene = null, this.meshScene = null, this._sceneHelpers = null, this.assetLoader = null, this._sdf = null, this._animRefitInFlight = !1, this._maxTextureSize = X.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 tp(), 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 Sd(), this._resizeDebounceTimer = null, this._trackedListeners = [], this._disposed = !1, this._deviceLost = !1;
+		ip.set(e, this), this.canvas = e, this._autoResize = t.autoResize !== !1, this._container = t.container || null, this.settings = new cf(X), this.renderer = null, this.scene = null, this.meshScene = null, this._sceneHelpers = null, this.assetLoader = null, this._sdf = null, this._animRefitInFlight = !1, this._maxTextureSize = X.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 tp(), 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 Sd(), this._resizeDebounceTimer = null, this._trackedListeners = [], this._disposed = !1, this._deviceLost = !1;
 	}
 	_addTrackedListener(e, t, n) {
 		e && (e.addEventListener(t, n), this._trackedListeners.push({
@@ -16596,7 +16633,7 @@ var Yf = {
 			assetLoader: this.assetLoader,
 			pathTracer: null,
 			floorPlane: this.assetLoader.floorPlane
-		}), this.interactionManager.wireAppEvents(this), this.cameraManager.setInteractionManager(this.interactionManager), this.lightManager = new uf(this.scene, this._sceneHelpers, this.stages.pathTracer, { onReset: () => this.reset() }), this.goboManager = new df(this.stages.pathTracer, { onReset: () => this.reset() }), this.iesManager = new Sf(this.stages.pathTracer, { onReset: () => this.reset() }), this._setupDenoisingManager(), this._setupOverlayManager(), this.transformManager = new np({
+		}), this.interactionManager.wireAppEvents(this), this.cameraManager.setInteractionManager(this.interactionManager), this.lightManager = new uf(this.scene, this._sceneHelpers, this.stages.pathTracer, { onReset: () => this.reset() }), this.goboManager = new df(this.stages.pathTracer, { onReset: () => this.reset() }), this.iesManager = new Sf(this.stages.pathTracer, { onReset: () => this.reset() }), this._setupDenoisingManager(), this._setupOverlayManager(), this.transformManager = new rp({
 			camera: this.cameraManager.camera,
 			canvas: this.canvas,
 			orbitControls: this.cameraManager.controls,
@@ -16605,7 +16642,8 @@ var Yf = {
 			overlayManager: this.overlayManager,
 			transformManager: this.transformManager,
 			appDispatch: (e) => this.dispatchEvent(e),
-			orbitControls: this.cameraManager.controls
+			orbitControls: this.cameraManager.controls,
+			helperScene: this._sceneHelpers.scene
 		}), this.denoisingManager.setOverlayManager(this.overlayManager), this.denoisingManager.setResetCallback(() => this.reset()), this.denoisingManager.setSettings(this.settings), this.environmentManager = this.stages.pathTracer.environment, this.environmentManager.callbacks.onAutoExposureReset = () => this.pipeline.eventBus.emit("autoexposure:resetHistory");
 	}
 	_wireEvents() {
@@ -16740,7 +16778,7 @@ var Yf = {
 	_forwardEvents(e, t) {
 		if (e) for (let n of t) this._addTrackedListener(e, n, (e) => this.dispatchEvent(e));
 	}
-}, ap = class {
+}, op = class {
 	constructor(e) {
 		this._app = e, this._cancelled = !1, this._rendering = !1;
 	}
@@ -16838,6 +16876,6 @@ var Yf = {
 	}
 };
 //#endregion
-export { xr as AF_DEFAULTS, gr as ASVGF_QUALITY_PRESETS, br as AUTO_FOCUS_MODES, tp as AnimationManager, Sr as BVH_LEAF_MARKERS, yr as CAMERA_PRESETS, _r as CAMERA_RANGES, lf as CameraManager, Dr as DEFAULT_TEXTURE_MATRIX, Zf as DenoisingManager, X as ENGINE_DEFAULTS, Y as EngineEvents, df as GoboManager, Sf as IESManager, kr as INTERACTIVE_RENDER_CONFIG, Cd as InteractionManager, uf as LightManager, Ar as MEMORY_CONSTANTS, ep as OverlayManager, Or as PRODUCTION_RENDER_CONFIG, ip as PathTracerApp, yd as PipelineContext, xd as RenderPipeline, cf as RenderSettings, $n as RenderStage, vr as SKY_PRESETS, Qn as StageExecutionMode, Cr as TEXTURE_CONSTANTS, Z as TRIANGLE_DATA_LAYOUT, np as TransformManager, $c as VRAMTracker, ap as VideoRenderManager, Zc as bufferBytes, oc as configureAssets, sc as getAssetConfig, Qc as textureBytes };
+export { xr as AF_DEFAULTS, gr as ASVGF_QUALITY_PRESETS, br as AUTO_FOCUS_MODES, tp as AnimationManager, Sr as BVH_LEAF_MARKERS, yr as CAMERA_PRESETS, _r as CAMERA_RANGES, lf as CameraManager, Dr as DEFAULT_TEXTURE_MATRIX, Zf as DenoisingManager, X as ENGINE_DEFAULTS, Y as EngineEvents, df as GoboManager, Sf as IESManager, kr as INTERACTIVE_RENDER_CONFIG, Cd as InteractionManager, uf as LightManager, Ar as MEMORY_CONSTANTS, ep as OverlayManager, Or as PRODUCTION_RENDER_CONFIG, ap as PathTracerApp, yd as PipelineContext, xd as RenderPipeline, cf as RenderSettings, $n as RenderStage, vr as SKY_PRESETS, Qn as StageExecutionMode, Cr as TEXTURE_CONSTANTS, Z as TRIANGLE_DATA_LAYOUT, rp as TransformManager, $c as VRAMTracker, op as VideoRenderManager, Zc as bufferBytes, oc as configureAssets, sc as getAssetConfig, Qc as textureBytes };
 
 //# sourceMappingURL=rayzee.es.js.map