rayzee 8.5.0 → 8.6.1

package/README.md

@@ -26,6 +26,7 @@ A real-time WebGPU path tracing engine built on Three.js. Framework-agnostic —
   - [engine.lightManager](#enginelightmanager)
   - [engine.animationManager](#engineanimationmanager)
   - [Materials](#materials)
+  - [Colour Management](#colour-management)
   - [engine.environmentManager](#engineenvironmentmanager)
   - [engine.denoisingManager](#enginedenoisingmanager)
   - [engine.interactionManager](#engineinteractionmanager)
@@ -287,10 +288,10 @@ configureAssets({
   oidnWeightsBaseUrl:    '/oidn-tzas/',
   upscalerModelBaseUrl:  '/upscaler-onnx/',
 
-  // DLSS. The runtime is a plain script the host must serve — it installs
-  // `globalThis.DLSSRuntime` as a side effect and cannot be imported.
-  dlssRuntimeUrl:    '/dlss/dlss-runtime.js',
-  dlssAssetBaseUrl:  '/dlss/',
+  // OpenColorIO runtime (~6 MB of WebAssembly) — the engine never names the package, so a host
+  // that loads colour configs supplies it, bundled or served. Unset, colour management stays inert.
+  ocioRuntimeFactory: () => import('@bb-studio/ocio'),   // or: ocioRuntimeUrl: '/vendor/ocio/index.js'
+  ocioWasmUrl: '/vendor/ocio/ocio-wasm.wasm',            // optional override for the .wasm
 
   // Prefix for engine-managed IndexedDB stores. Set to a unique value if multiple
   // apps embed the engine on the same origin to avoid cache collisions.
@@ -414,13 +415,14 @@ Key settings:
 | `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 |
+| `saturation` | `number` | 1.0 | Color saturation (1 = no grade) |
 | `enableEnvironment` | `boolean` | true | Use environment lighting |
 | `environmentIntensity` | `number` | 1.0 | Environment light strength |
-| `environmentRotation` | `number` | 270 | Environment Y-rotation (degrees) |
+| `environmentRotation` | `number` | 0 | Environment Y-rotation (degrees); 0 shows the HDRI as authored, as Blender's unmapped world does |
 | `showBackground` | `boolean` | true | Show the environment as a visible backdrop for camera-miss rays (vs. a solid/transparent background) |
 | `samplingTechnique` | `number` | 2 | Sampler: `0` PCG, `1` scrambled Halton, `2` Owen-scrambled Sobol |
 | `fireflyThreshold` | `number` | 3.0 | Firefly clamping threshold |
+| `shadowTerminatorOffset` | `number` | 0.1 | Cycles' Shadow Terminator → Geometry Offset: near the light's terminator on a smooth-shaded low-poly mesh, light and environment shadow rays start on the smooth surface the vertex normals describe, not the flat facet. Blender's default; `0` disables |
 | `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')`) |
@@ -429,7 +431,8 @@ Key settings:
 | `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 |
+| `interactionModeEnabled` | `boolean` | true | Render at lower resolution while the camera moves, keeping the full bounce budget ("Fast Navigation" in the app) |
+| `interactionRenderScale` | `number` | 0.5 | Per-axis render scale while the camera moves (0.5 = a quarter of the pixels); `1` turns the drop off. Ignored while OIDN is the live denoiser |
 | `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 |
@@ -445,7 +448,7 @@ Key settings:
 | `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.
+See `ENGINE_DEFAULTS` for the full list with default values. The default look is AgX (`toneMapping: 6`) at neutral saturation; tone mapping is chosen through [Colour Management](#colour-management) (`engine.color.setActiveView( id )`), not `settings`.
 
 #### Rendering Modes
 
@@ -552,8 +555,43 @@ engine.updateAllMeshVisibility()                  // re-sync after manual object
 
 // Read access to the active scene (returns the mesh-bearing scene)
 engine.getScene()
+
+// Where a packed value came from: 'material' | 'mapped' | 'default' | 'host'
+engine.getMaterialPropertySource(index, 'ior')
+```
+
+A property a three.js material lacks falls back to `MATERIAL_DEFAULTS` (exported) — MeshPhysicalMaterial's own values, so a glTF metallic material gets IOR 1.5, not a guess derived from its metalness. Weights and roughnesses (metalness, roughness, transmission, opacity, clearcoat, sheen, iridescence, …) are clamped to [0, 1] on upload and on `setMaterialProperty`.
+
+### Colour Management
+
+`engine.color` is an OpenColorIO pipeline: what textures and lights mean, what the render happens in, and what it is shown and saved as. **It is inert until a config is loaded** — the render stays linear Rec.709 and the view transforms are three.js's own seven, so a host that never loads one sees no change. The host supplies the runtime (`ocioRuntimeFactory` or `ocioRuntimeUrl` in [`configureAssets`](#configuring-assets-cdn-urls--cache-namespace)).
+
+```js
+configureAssets({ ocioRuntimeFactory: () => import('@bb-studio/ocio') });
+
+await engine.loadColorConfig({ builtin: 'ocio://cg-config-v4.0.0_aces-v2.0_ocio-v2.5' }); // a runtime built-in
+await engine.loadColorConfig({ files, configPath: 'config.ocio', id: 'studio' });  // or a folder: [{ relativePath, data }]
+
+engine.color.setView({ display: 'sRGB - Display', view: 'ACES 2.0 - SDR 100 nits (Rec.709)', look: null });
+engine.color.setLook(look);                  // a look from status().config.looks, on the active view
+engine.color.setActiveView(id);              // any registered view, OCIO or built-in (three.js constant)
+engine.color.setContext({ SHOT: '010' });    // $SHOT in the config resolves to this
+engine.color.status();                       // config, working space, active view, registered views
+
+engine.color.setWorkingSpace('ACEScg');      // render in the config's space…
+await engine.applyColorWorkingSpace();       // …which rebuilds textures, materials and the environment
+
+await engine.setTextureColorSpace(texture, 'srgb');   // null (auto), 'srgb', 'linear' or a config space
+const { data } = await engine.renderToBuffer({ colorSpace: 'ACES2065-1', source: 'display' }); // float delivery buffer
+await engine.unloadColorConfig();
 ```
 
+- **Load and unload through `engine.loadColorConfig()` / `unloadColorConfig()`** once a scene exists: they undo an adopted working space while the config that converted the environment is still loaded.
+- A view is baked to a log2 shaper and a 65³ table, interpolated tetrahedrally; the same table drives the canvas, the GPU and CPU readbacks and the menu (`listViewTransforms()`, `onRegistryChange()`). An OCIO view returns display-encoded colour, so the engine switches the output pass to linear while one is active.
+- **Baked views.** `await engine.color.saveBakedView(id)` writes a view's table to a file (157 KB gzip for 65³), and `await engine.color.loadBakedView(bytes, { expect })` registers it with no runtime and no config — show the look on the first frame, load the config later. When that config loads, a baked view whose files match the fingerprint it was baked from is kept as is: no rebake, no new id, no restart.
+- `renderToBuffer({ colorSpace })` takes `'srgb'` (display bytes through the active view), `'linear'` (the working-space accumulation) or a config colour space; `source: 'display'` reads what the viewport shows, denoised, instead of the raw accumulation.
+- Degradations (a view that cannot bake, a display the canvas cannot show) are recorded as warnings in the [degradation contract](#degradation-contract).
+
 ### engine.environmentManager
 
 Environment maps, sky modes, and procedural generation.
@@ -593,10 +631,8 @@ engine.denoisingManager.setOIDNQuality('high')
 engine.denoisingManager.setStrategy('oidn')              // OIDN owns the live view; see below
 engine.denoisingManager.continuousDenoiseInterval = 250   // cap refreshes at 4/sec (default 8 = uncapped)
 engine.denoisingManager.setUpscalerEnabled(true)
-engine.denoisingManager.setUpscalerBackend('dlss')        // 'esrgan' (default) | 'dlss'
-engine.denoisingManager.setUpscalerScaleFactor(2)         // ESRGAN only; DLSS is fixed at 2x
+engine.denoisingManager.setUpscalerScaleFactor(2)         // 2 or 4
 engine.denoisingManager.setUpscalerQuality('high')        // ESRGAN only
-engine.denoisingManager.setNeuralRendering(true, { intensity: 1, colorStrength: 0 })
 ```
 
 ### engine.interactionManager
@@ -954,6 +990,18 @@ import {
   PRODUCTION_RENDER_CONFIG,
   INTERACTIVE_RENDER_CONFIG,
   MAX_RESERVABLE_RENDER_SIZE,
+  RENDER_PROFILES,
+  MATERIAL_DEFAULTS,
+} from 'rayzee';
+
+// Colour management — engine.color is the instance a host normally uses; these build UI against
+// it, or reach the view-transform registry without an app
+import {
+  ColorManagement, getActiveColorManagement, isColorManaged, DEFAULT_WORKING_SPACE,
+  listViewTransforms, getViewTransform, addViewTransform, removeViewTransform, onRegistryChange,
+  buildOcioView, addOcioView, addAllOcioViews,
+  convertColor, convertPixelsF32, extractMatrix, hasColorSpace,
+  displayCanvasFit,
 } from 'rayzee';
 
 // Leveled/namespaced logging, shared with the workers
@@ -1017,6 +1065,7 @@ import { setBindingAudit, getBindingAuditFindings, clearBindingAuditFindings } f
 |---|---|---|
 | `oidn-web` | Intel Open Image Denoise for high-quality final renders | Yes — `npm install oidn-web` (**>=0.4.0**) |
 | `onnxruntime-web` | AI-powered upscaling | No — loaded from CDN at runtime |
+| `@bb-studio/ocio` | OpenColorIO runtime for [Colour Management](#colour-management) (~6 MB WebAssembly) | Only to load colour configs — `npm install @bb-studio/ocio`, then pass it as `ocioRuntimeFactory` |
 
 > **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.
 
@@ -1204,51 +1253,6 @@ engine.addEventListener(EngineEvents.UPSCALING_END,      () => console.log('Upsc
 
 **Chaining with OIDN:** Upscaling and OIDN **can** run together — on render completion, OIDN runs first, then its denoised output is fed into the upscaler. Enable both; no manual coordination required.
 
-### The DLSS passes
-
-Two further neural passes, ported from NVIDIA's DLSS weights. Both run once when a render finishes
-and both need a denoised frame — on raw Monte-Carlo noise they measurably lose to a plain resize, so
-enable OIDN alongside them.
-
-Unlike the ONNX upscaler these are **not fetched from a CDN**: `dlss-runtime.js` installs
-`globalThis.DLSSRuntime` as a side effect and cannot be imported, so the host serves it and points
-`configureAssets` at it (see above). It lives at `app/public/dlss/` in this repo, and the local edits
-it carries are written up in `app/public/dlss/PATCHES.md` — re-vendoring it without re-applying them
-breaks the retouch pass with an explanatory throw.
-
-```js
-// Super resolution, as a second AI Upscaler backend
-engine.denoisingManager.setUpscalerEnabled(true);
-engine.denoisingManager.setUpscalerBackend('dlss');
-
-// The retouch pass — appearance, not resolution. Independent of the upscaler.
-engine.denoisingManager.setNeuralRendering(true, {
-  intensity: 1,        // 0..1   how much of the pass reaches the image
-  localTone: 1,        // 0..2   local light shaping; 1 is neutral
-  localStructure: 1,   // 0..2   fine surface detail; 1 is neutral
-  colorStrength: 0,    // 0..1   0 keeps the render's chroma, 1 takes the model's
-});
-```
-
-The chain is **denoise → retouch (at render size) → super resolution (2x) → tone map**, scene-referred
-throughout. The retouch pass runs *before* the upscale deliberately: it sees a quarter of the pixels
-there, and above `DLSS_NR_MAX_PIXELS` (4.19 MP) it takes minutes and then loses every GPU device in
-the page. `DenoisingManager` skips it above that size rather than letting it run.
-
-| | Super resolution | Retouch |
-|---|---|---|
-| What it changes | Resolution, fixed 2x | Appearance only |
-| Weights | 3.2 MB | 141 MB, fetched on first use |
-| Cost (1.9M-tri interior, warm) | 260 ms at 1024²→2048², 947 ms at 2048²→4096² | ~6 s at 2048² |
-| Against a native render | Ties Real-ESRGAN on accuracy, 3x faster, sharper than native | Close to a no-op on path-traced images |
-
-Exported for building UI against: `SR_SCALE`, `SR_MAX_INPUT`, `DLSS_NR_DEFAULTS`, `DLSS_NR_RANGES`,
-`DLSS_NR_MAX_PIXELS`, and `renderUpscaled( app, { outputWidth, outputHeight, samples } )` — the
-offline entry point that drives a half-size render, denoise and upscale in one call.
-
-⚠️ Each model brings **its own `GPUDevice`**, built by the runtime and not shareable. With both on,
-the page holds three: the renderer's and one each.
-
 ## Troubleshooting
 
 **OIDN: `Cannot find module './tza'` (webpack)**

package/dist/{DLSSNeural-BNSJ8V3z.js → NeuralRetouch-CYOJ21Wn.js}

@@ -1,12 +1,12 @@
 import { t as e } from "./rolldown-runtime-CAFD8bLK.js";
-import { o as t, r as n, t as r } from "./ToneMapGPU-DzqSyzTx.js";
-//#region src/dlss/DLSSNeural.js
+import { S as t, t as n, y as r } from "./ToneMapGPU-BVE852iN.js";
+//#region src/neural/NeuralRetouch.js
 var i = /* @__PURE__ */ e({
-	DLSSNeural: () => m,
-	DLSS_NR_COLOR_STRENGTH: () => 0,
-	DLSS_NR_DEFAULTS: () => a,
-	DLSS_NR_MAX_PIXELS: () => c,
-	DLSS_NR_RANGES: () => l,
+	NeuralRetouch: () => m,
+	RETOUCH_COLOR_STRENGTH: () => 0,
+	RETOUCH_DEFAULTS: () => a,
+	RETOUCH_MAX_PIXELS: () => c,
+	RETOUCH_RANGES: () => l,
 	enhanceFrame: () => g
 }), a = Object.freeze({
 	enabled: !0,
@@ -29,7 +29,7 @@ function o(e = {}) {
 		colorStrength: t
 	};
 }
-var s = t("dlss"), c = 2048 * 2048, l = Object.freeze({
+var s = t("neural"), c = 2048 * 2048, l = Object.freeze({
 	intensity: [0, 1],
 	localTone: [0, 2],
 	localStructure: [0, 2],
@@ -39,16 +39,16 @@ var s = t("dlss"), c = 2048 * 2048, l = Object.freeze({
 }), u = null;
 function d() {
 	if (u) return u;
-	let { dlssRuntimeUrl: e, dlssAssetBaseUrl: t } = n();
-	return globalThis.__DLSS5_ASSET_BASE__ = t, u = new Promise((t, n) => {
-		if (globalThis.DLSSRuntime?.getSrNrChain) return t(globalThis.DLSSRuntime.getSrNrChain());
+	let { neuralRuntimeUrl: e, neuralAssetBaseUrl: t } = r();
+	return t ? (globalThis.__NEURAL_ASSET_BASE__ = t, u = new Promise((t, n) => {
+		if (globalThis.NeuralRuntime?.getSrNrChain) return t(globalThis.NeuralRuntime.getSrNrChain());
 		let r = document.createElement("script");
 		r.src = e, r.onload = () => {
-			let e = globalThis.DLSSRuntime?.getSrNrChain;
-			if (!e) return n(/* @__PURE__ */ Error("DLSS runtime loaded but exposed no neural-rendering entry"));
+			let e = globalThis.NeuralRuntime?.getSrNrChain;
+			if (!e) return n(/* @__PURE__ */ Error("Neural runtime loaded but exposed no retouch entry"));
 			t(e());
-		}, r.onerror = () => n(/* @__PURE__ */ Error(`Failed to load the DLSS runtime from ${e}`)), document.head.appendChild(r);
-	}), u;
+		}, r.onerror = () => n(/* @__PURE__ */ Error(`Failed to load the neural runtime from ${e}`)), document.head.appendChild(r);
+	}), u) : Promise.reject(/* @__PURE__ */ Error("No neural model location: set neuralAssetBaseUrl with configureAssets()"));
 }
 var f = "\n@group(0) @binding(0) var src: texture_2d<f32>;\n@group(0) @binding(1) var<storage, read_write> dst: array<u32>;\n\n@compute @workgroup_size(8, 8)\nfn main(@builtin(global_invocation_id) gid: vec3<u32>) {\n	let size = textureDimensions(src);\n	if ( gid.x >= size.x || gid.y >= size.y ) { return; }\n	let c = textureLoad(src, vec2<i32>(gid.xy), 0);\n	let r = u32(clamp(c.r, 0.0, 1.0) * 255.0 + 0.5);\n	let g = u32(clamp(c.g, 0.0, 1.0) * 255.0 + 0.5);\n	let b = u32(clamp(c.b, 0.0, 1.0) * 255.0 + 0.5);\n	dst[gid.y * size.x + gid.x] = r | (g << 8u) | (b << 16u) | (255u << 24u);\n}\n", p = "\n@group(0) @binding(0) var src: texture_2d<f32>;\n@group(0) @binding(1) var<storage, read_write> dst: array<u32>;\n\n@compute @workgroup_size(8, 8)\nfn main(@builtin(global_invocation_id) gid: vec3<u32>) {\n	let size = textureDimensions(src);\n	if ( gid.x >= size.x || gid.y >= size.y ) { return; }\n	let c = textureLoad(src, vec2<i32>(gid.xy), 0);\n	let a = (gid.y * size.x + gid.x) * 2u;\n	dst[a] = pack2x16float(c.rg);\n	dst[a + 1u] = pack2x16float(vec2<f32>(c.b, 1.0));\n}\n", m = class e {
 	constructor(e, t) {
@@ -64,8 +64,8 @@ var f = "\n@group(0) @binding(0) var src: texture_2d<f32>;\n@group(0) @binding(1
 		return this.chain.pipeline.geometry.validHeight;
 	}
 	static async create({ width: t, height: n, canvas: r = null, settings: i = {}, onProgress: a = () => {} }) {
-		if (!Number.isInteger(t) || !Number.isInteger(n) || t < 1 || n < 1) throw Error("DLSSNeural.create: width and height must be positive integers");
-		if (t * n > 4194304) throw Error(`DLSSNeural.create: ${t}x${n} is ${(t * n / 1e6).toFixed(1)} MP, above the ${(c / 1e6).toFixed(1)} MP this pass survives. Past it the run takes minutes and then loses every GPU device in the page.`);
+		if (!Number.isInteger(t) || !Number.isInteger(n) || t < 1 || n < 1) throw Error("NeuralRetouch.create: width and height must be positive integers");
+		if (t * n > 4194304) throw Error(`NeuralRetouch.create: ${t}x${n} is ${(t * n / 1e6).toFixed(1)} MP, above the ${(c / 1e6).toFixed(1)} MP this pass survives. Past it the run takes minutes and then loses every GPU device in the page.`);
 		let s = r ?? document.createElement("canvas");
 		r || (s.style.cssText = "position:fixed;left:-10000px;top:0;pointer-events:none");
 		let l = new e(await (await d()).create(s, t, n, a, o(i).runtime), s);
@@ -74,21 +74,21 @@ var f = "\n@group(0) @binding(0) var src: texture_2d<f32>;\n@group(0) @binding(1
 	_allocate() {
 		let { validWidth: e, validHeight: t } = this.chain.pipeline.geometry;
 		this.source = this.device.createBuffer({
-			label: "rayzee:dlss-nr-source",
+			label: "rayzee:retouch-source",
 			size: e * t * 8,
 			usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_DST
 		}), this.staging = new Uint16Array(e * t * 4);
 		let n = e * t * 4;
 		this._readbackStorage = this.device.createBuffer({
-			label: "rayzee:dlss-nr-readback",
+			label: "rayzee:retouch-readback",
 			size: n,
 			usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_SRC
 		}), this._readbackMap = this.device.createBuffer({
-			label: "rayzee:dlss-nr-readback-map",
+			label: "rayzee:retouch-readback-map",
 			size: n,
 			usage: GPUBufferUsage.COPY_DST | GPUBufferUsage.MAP_READ
 		}), this._readbackPipeline = this.device.createComputePipeline({
-			label: "rayzee:dlss-nr-readback",
+			label: "rayzee:retouch-readback",
 			layout: "auto",
 			compute: {
 				module: this.device.createShaderModule({ code: f }),
@@ -97,15 +97,15 @@ var f = "\n@group(0) @binding(0) var src: texture_2d<f32>;\n@group(0) @binding(1
 		});
 		let r = e * t * 8;
 		this._hdrStorage = this.device.createBuffer({
-			label: "rayzee:dlss-nr-hdr",
+			label: "rayzee:retouch-hdr",
 			size: r,
 			usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_SRC
 		}), this._hdrMap = this.device.createBuffer({
-			label: "rayzee:dlss-nr-hdr-map",
+			label: "rayzee:retouch-hdr-map",
 			size: r,
 			usage: GPUBufferUsage.COPY_DST | GPUBufferUsage.MAP_READ
 		}), this._hdrPipeline = this.device.createComputePipeline({
-			label: "rayzee:dlss-nr-hdr",
+			label: "rayzee:retouch-hdr",
 			layout: "auto",
 			compute: {
 				module: this.device.createShaderModule({ code: p }),
@@ -115,7 +115,7 @@ var f = "\n@group(0) @binding(0) var src: texture_2d<f32>;\n@group(0) @binding(1
 	}
 	async _packHDR(e, t, n = !1) {
 		let r = this.chain.pipeline.slots[this.slot]?.hdrOutput;
-		if (!r) throw Error("DLSSNeural: the runtime has no scene-referred output. Either no frame has been produced yet, or dlss-runtime.js was re-vendored without the patch described in its PATCHES.md.");
+		if (!r) throw Error("NeuralRetouch: the runtime has no scene-referred output. Either no frame has been produced yet, or neural-runtime.js was re-vendored without its `rayzee-patch` edits.");
 		let i = this.device.createBindGroup({
 			layout: this._hdrPipeline.getBindGroupLayout(0),
 			entries: [{
@@ -125,7 +125,7 @@ var f = "\n@group(0) @binding(0) var src: texture_2d<f32>;\n@group(0) @binding(1
 				binding: 1,
 				resource: { buffer: this._hdrStorage }
 			}]
-		}), a = this.device.createCommandEncoder({ label: "rayzee:dlss-nr-hdr" }), o = a.beginComputePass();
+		}), a = this.device.createCommandEncoder({ label: "rayzee:retouch-hdr" }), o = a.beginComputePass();
 		o.setPipeline(this._hdrPipeline), o.setBindGroup(0, i), o.dispatchWorkgroups(Math.ceil(e / 8), Math.ceil(t / 8)), o.end(), n && a.copyBufferToBuffer(this._hdrStorage, 0, this._hdrMap, 0, e * t * 8), this.device.queue.submit([a.finish()]);
 	}
 	async readOutputHDR() {
@@ -139,20 +139,20 @@ var f = "\n@group(0) @binding(0) var src: texture_2d<f32>;\n@group(0) @binding(1
 		};
 	}
 	async readOutputToned(e) {
-		let { validWidth: t, validHeight: n } = this.chain.pipeline.geometry;
-		return await this._packHDR(t, n), this._toneMapper ??= new r(this.device, "rayzee:dlss-nr-tonemap"), this._toneMapper.ensureSize(t, n), {
+		let { validWidth: t, validHeight: r } = this.chain.pipeline.geometry;
+		return await this._packHDR(t, r), this._toneMapper ??= new n(this.device, "rayzee:retouch-tonemap"), this._toneMapper.ensureSize(t, r), {
 			rgba8: await this._toneMapper.toRGBA8(this._hdrStorage, {
 				exposure: e.exposure ?? 1,
 				toneMapping: e.toneMapping ?? 0,
 				saturation: e.saturation ?? 1
 			}),
 			width: t,
-			height: n
+			height: r
 		};
 	}
 	async readOutput() {
 		let { validWidth: e, validHeight: t } = this.chain.pipeline.geometry, n = this.chain.pipeline.slots[this.slot]?.output;
-		if (!n) throw Error("DLSSNeural.readOutput: the pass has not produced a frame yet");
+		if (!n) throw Error("NeuralRetouch.readOutput: the pass has not produced a frame yet");
 		let r = this.device.createBindGroup({
 			layout: this._readbackPipeline.getBindGroupLayout(0),
 			entries: [{
@@ -162,7 +162,7 @@ var f = "\n@group(0) @binding(0) var src: texture_2d<f32>;\n@group(0) @binding(1
 				binding: 1,
 				resource: { buffer: this._readbackStorage }
 			}]
-		}), i = this.device.createCommandEncoder({ label: "rayzee:dlss-nr-readback" }), a = i.beginComputePass();
+		}), i = this.device.createCommandEncoder({ label: "rayzee:retouch-readback" }), a = i.beginComputePass();
 		a.setPipeline(this._readbackPipeline), a.setBindGroup(0, r), a.dispatchWorkgroups(Math.ceil(e / 8), Math.ceil(t / 8)), a.end(), i.copyBufferToBuffer(this._readbackStorage, 0, this._readbackMap, 0, e * t * 4), this.device.queue.submit([i.finish()]), await this._readbackMap.mapAsync(GPUMapMode.READ);
 		let o = new Uint8ClampedArray(this._readbackMap.getMappedRange().slice(0));
 		return this._readbackMap.unmap(), o;
@@ -187,9 +187,9 @@ async function g({ source: e, settings: t = {}, instance: n = null, exposure: r
 		onProgress: a
 	});
 	let { runtime: c, colorStrength: l } = o(t), u = s.staging;
-	if (!e.half || e.half.length !== u.length) throw Error(`DLSSNeural: expected ${u.length} packed halfs, got ${e.half?.length}`);
+	if (!e.half || e.half.length !== u.length) throw Error(`NeuralRetouch: expected ${u.length} packed halfs, got ${e.half?.length}`);
 	u.set(e.half), s.device.queue.writeBuffer(s.source, 0, u), s.chain.pipeline.paperWhite = 1 / Math.min(Math.max(r, 1 / h), h), s.chain.pipeline.colorStrength = l;
-	let d = performance.now(), f = s.device.createCommandEncoder({ label: "rayzee:dlss-nr" });
+	let d = performance.now(), f = s.device.createCommandEncoder({ label: "rayzee:retouch" });
 	await s.chain.encode(f, s.slot, { buffer: s.source }, c, () => {}, { reset: !0 }), s.device.queue.submit([f.finish()]), await s.device.queue.onSubmittedWorkDone();
 	let p = i ? await s.readOutputToned(i) : await s.readOutputHDR();
 	return {

package/dist/{DLSSSuperRes-BoEW89Cl.js → NeuralSuperRes-Dc6jRYke.js}

@@ -1,5 +1,5 @@
 import { t as e } from "./rolldown-runtime-CAFD8bLK.js";
-import { o as t, r as n, t as r } from "./ToneMapGPU-DzqSyzTx.js";
+import { S as t, t as n, y as r } from "./ToneMapGPU-BVE852iN.js";
 //#region src/EngineEvents.js
 var i = {
 	RENDER_COMPLETE: "engine:renderComplete",
@@ -35,26 +35,26 @@ var i = {
 	ISSUE: "engine:issue",
 	SCENE_METADATA_APPLIED: "engine:sceneMetadataApplied"
 }, a = /* @__PURE__ */ e({
-	DLSSSuperRes: () => g,
+	NeuralSuperRes: () => g,
 	SR_MAX_INPUT: () => c,
 	SR_SCALE: () => 2,
 	presentRGBA8: () => b,
 	readDenoisedHalf: () => h,
 	releaseDenoisedReader: () => m,
 	renderUpscaled: () => v
-}), o = 2, s = t("dlss"), c = 2048, l = null;
+}), o = 2, s = t("neural"), c = 2048, l = null;
 function u() {
 	if (l) return l;
-	let { dlssRuntimeUrl: e, dlssAssetBaseUrl: t } = n();
-	return globalThis.__DLSS5_ASSET_BASE__ = t, l = new Promise((t, n) => {
-		if (globalThis.DLSSRuntime?.getNativeSR) return t(globalThis.DLSSRuntime.getNativeSR());
+	let { neuralRuntimeUrl: e, neuralAssetBaseUrl: t } = r();
+	return t ? (globalThis.__NEURAL_ASSET_BASE__ = t, l = new Promise((t, n) => {
+		if (globalThis.NeuralRuntime?.getNativeSR) return t(globalThis.NeuralRuntime.getNativeSR());
 		let r = document.createElement("script");
 		r.src = e, r.onload = () => {
-			let e = globalThis.DLSSRuntime?.getNativeSR;
-			if (!e) return n(/* @__PURE__ */ Error("DLSS runtime loaded but exposed no super-resolution entry"));
+			let e = globalThis.NeuralRuntime?.getNativeSR;
+			if (!e) return n(/* @__PURE__ */ Error("Neural runtime loaded but exposed no super-resolution entry"));
 			t(e());
-		}, r.onerror = () => n(/* @__PURE__ */ Error(`Failed to load the DLSS runtime from ${e}`)), document.head.appendChild(r);
-	}), l;
+		}, r.onerror = () => n(/* @__PURE__ */ Error(`Failed to load the neural runtime from ${e}`)), document.head.appendChild(r);
+	}), l) : Promise.reject(/* @__PURE__ */ Error("No neural model location: set neuralAssetBaseUrl with configureAssets()"));
 }
 var d = "\n@group(0) @binding(0) var src: texture_2d<f32>;\n@group(0) @binding(1) var<storage, read_write> dst: array<u32>;\n\n@compute @workgroup_size(8, 8)\nfn main( @builtin(global_invocation_id) gid: vec3<u32> ) {\n	let size = textureDimensions( src );\n	if ( gid.x >= size.x || gid.y >= size.y ) { return; }\n	let c = textureLoad( src, vec2<i32>( gid.xy ), 0 ).rgb;\n	let a = ( gid.y * size.x + gid.x ) * 2u;\n	dst[ a ] = pack2x16float( c.rg );\n	dst[ a + 1u ] = pack2x16float( vec2<f32>( c.b, 1.0 ) );\n}\n", f = null;
 function p(e, t, n) {
@@ -65,21 +65,21 @@ function p(e, t, n) {
 		width: t,
 		height: n,
 		storage: e.createBuffer({
-			label: "rayzee:dlss-sr-pack",
+			label: "rayzee:neural-sr-pack",
 			size: r,
 			usage: GPUBufferUsage.STORAGE | GPUBufferUsage.COPY_SRC
 		}),
 		map: e.createBuffer({
-			label: "rayzee:dlss-sr-pack-map",
+			label: "rayzee:neural-sr-pack-map",
 			size: r,
 			usage: GPUBufferUsage.COPY_DST | GPUBufferUsage.MAP_READ
 		}),
 		pipeline: e.createComputePipeline({
-			label: "rayzee:dlss-sr-pack",
+			label: "rayzee:neural-sr-pack",
 			layout: "auto",
 			compute: {
 				module: e.createShaderModule({
-					label: "rayzee:dlss-sr-pack",
+					label: "rayzee:neural-sr-pack",
 					code: d
 				}),
 				entryPoint: "main"
@@ -92,7 +92,7 @@ function m() {
 }
 async function h(e) {
 	let t = e?._outGPUTexture;
-	if (!t) throw Error("DLSSSuperRes: no denoised frame — enable OIDN and finish a render first");
+	if (!t) throw Error("NeuralSuperRes: no denoised frame — enable OIDN and finish a render first");
 	let n = e.gpuDevice, { width: r, height: i } = e._outTexSize, a = p(n, r, i), o = n.createBindGroup({
 		layout: a.pipeline.getBindGroupLayout(0),
 		entries: [{
@@ -102,7 +102,7 @@ async function h(e) {
 			binding: 1,
 			resource: { buffer: a.storage }
 		}]
-	}), s = n.createCommandEncoder({ label: "rayzee:dlss-sr-pack" }), c = s.beginComputePass();
+	}), s = n.createCommandEncoder({ label: "rayzee:neural-sr-pack" }), c = s.beginComputePass();
 	c.setPipeline(a.pipeline), c.setBindGroup(0, o), c.dispatchWorkgroups(Math.ceil(r / 8), Math.ceil(i / 8)), c.end(), s.copyBufferToBuffer(a.storage, 0, a.map, 0, r * i * 8), n.queue.submit([s.finish()]), await a.map.mapAsync(GPUMapMode.READ);
 	let l = new Uint16Array(a.map.getMappedRange().slice(0));
 	return a.map.unmap(), {
@@ -131,8 +131,8 @@ var g = class e {
 		return this.sr.geometry.outputHeight;
 	}
 	static async create({ width: t, height: n, onProgress: r = () => {} } = {}) {
-		if (!Number.isInteger(t) || !Number.isInteger(n) || t < 1 || n < 1) throw Error("DLSSSuperRes.create: width and height must be positive integers");
-		if (t > 2048 || n > 2048) throw Error(`DLSSSuperRes.create: input capped at ${c}px per side (${c * 2}px output), got ${t}x${n}. Above that the runtime's history plane exceeds maxTextureDimension2D and it fails later with an unrelated bind-group error.`);
+		if (!Number.isInteger(t) || !Number.isInteger(n) || t < 1 || n < 1) throw Error("NeuralSuperRes.create: width and height must be positive integers");
+		if (t > 2048 || n > 2048) throw Error(`NeuralSuperRes.create: input capped at ${c}px per side (${c * 2}px output), got ${t}x${n}. Above that the runtime's history plane exceeds maxTextureDimension2D and it fails later with an unrelated bind-group error.`);
 		let i = await u(), a = document.createElement("canvas");
 		a.style.cssText = "position:fixed;left:-10000px;top:0;pointer-events:none", document.body.appendChild(a);
 		let o;
@@ -155,11 +155,11 @@ var g = class e {
 		this._color = new Uint16Array(e * t * 4), this._depth = new Float32Array(e * t), this._motion = new Uint16Array(e * t * 2);
 	}
 	async _run(e) {
-		if (this.disposed) throw Error("DLSSSuperRes: disposed");
+		if (this.disposed) throw Error("NeuralSuperRes: disposed");
 		let t = this.inputWidth, n = this.inputHeight;
-		if (e.width !== t || e.height !== n) throw Error(`DLSSSuperRes: expected a ${t}x${n} source, got ${e.width}x${e.height}`);
+		if (e.width !== t || e.height !== n) throw Error(`NeuralSuperRes: expected a ${t}x${n} source, got ${e.width}x${e.height}`);
 		let r = this._color;
-		if (!e.half || e.half.length !== r.length) throw Error(`DLSSSuperRes: expected ${r.length} packed halfs from readDenoisedHalf, got ${e.half?.length}`);
+		if (!e.half || e.half.length !== r.length) throw Error(`NeuralSuperRes: expected ${r.length} packed halfs from readDenoisedHalf, got ${e.half?.length}`);
 		r.set(e.half), this._depth.fill(.5), this._motion.fill(0);
 		let i = performance.now(), a = await this.sr.render(this.slot, {
 			color: r,
@@ -174,11 +174,11 @@ var g = class e {
 		};
 	}
 	async upscaleToRGBA8(e, t = {}) {
-		let { result: n, ms: i } = await this._run(e), { outputWidth: a, outputHeight: o } = this.geometry;
-		this._toneMapper ??= new r(this.sr.device, "rayzee:dlss-sr-tonemap"), this._toneMapper.ensureSize(a, o);
+		let { result: r, ms: i } = await this._run(e), { outputWidth: a, outputHeight: o } = this.geometry;
+		this._toneMapper ??= new n(this.sr.device, "rayzee:neural-sr-tonemap"), this._toneMapper.ensureSize(a, o);
 		let s = performance.now();
 		return {
-			rgba8: await this._toneMapper.toRGBA8(n.hdr.buffer ?? n.hdr, {
+			rgba8: await this._toneMapper.toRGBA8(r.hdr.buffer ?? r.hdr, {
 				exposure: t.exposure ?? 1,
 				toneMapping: t.toneMapping ?? 0,
 				saturation: t.saturation ?? 1,
@@ -211,7 +211,7 @@ function _(e, t, n) {
 		e.addEventListener(i.DENOISING_END, l);
 		let u = setInterval(() => {
 			c && s(!0);
-		}, 200), d = setTimeout(() => s(!1, /* @__PURE__ */ Error("DLSSSuperRes: timed out waiting for the render to finish")), n);
+		}, 200), d = setTimeout(() => s(!1, /* @__PURE__ */ Error("NeuralSuperRes: timed out waiting for the render to finish")), n);
 	});
 }
 async function v(e, { outputWidth: t, outputHeight: n, samples: r = 64, upscaler: i = null, timeoutMs: a = 6e5, present: o = !0, onProgress: s = () => {} } = {}) {