rayzee 9.0.0 → 9.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rayzee",
-  "version": "9.0.0",
+  "version": "9.1.1",
   "type": "module",
   "description": "Real-time WebGPU path tracing engine built on Three.js",
   "main": "dist/rayzee.umd.js",

package/src/AssetConfig.js

@@ -56,6 +56,10 @@ const config = {
 	// Prefix used when the engine writes to client-side stores (IndexedDB, etc).
 	// Set to a unique value to avoid collisions when multiple apps embed the engine on the same origin.
 	cacheNamespace: 'rayzee',
+
+	// On-disk storage (origin private file system) under a directory named by cacheNamespace:
+	// 'auto' uses it where the browser has one, false turns every storage feature off.
+	storage: 'auto',
 };
 
 /**

package/src/EngineDefaults.js

@@ -1,3 +1,10 @@
+import { sunPosition, dayOfYearForMonth } from './Processor/SunPosition.js';
+
+/** The default sun as a time of day (solar hours), month and latitude; north lies along −Z. */
+export const DEFAULT_SUN_PATH = Object.freeze( { time: 10, month: 3, latitude: 40 } );
+
+const DEFAULT_SUN = sunPosition( { hours: DEFAULT_SUN_PATH.time, dayOfYear: dayOfYearForMonth( DEFAULT_SUN_PATH.month ), latitude: DEFAULT_SUN_PATH.latitude } );
+
 /**
  * Engine-owned default values and configuration constants.
  * These are used exclusively by the rendering engine (src/core/)
@@ -94,14 +101,17 @@ export const ENGINE_DEFAULTS = {
 	// Solid Color Sky
 	solidSkyColor: '#87CEEB',
 
-	// Procedural Sky Parameters (Preetham Model - Clear Morning preset)
-	skySunAzimuth: 90,
-	skySunElevation: 20,
-	skySunIntensity: 15.0,
-	skyRayleighDensity: 0.9,
-	skyTurbidity: 0.8,
-	skyMieAnisotropy: 0.76,
-	skyPreset: 'clearMorning',
+	// Physical sky (Processor/PhysicalSky.js) — the Clear Day preset
+	skySunAzimuth: 180 - DEFAULT_SUN.azimuth,
+	skySunElevation: DEFAULT_SUN.elevation,
+	skySunStrength: 1, // artistic multiplier on the disc and its light; 1 is physical
+	skySunSize: 0.53, // angular diameter, degrees
+	skyTurbidity: 2, // 1 is aerosol-free air, ~2 a clear day, 6+ hazy
+	skyOzone: 300, // Dobson units
+	skyAirDensity: 1,
+	skyGroundAlbedo: '#959595', // 0.3 linear
+	skyAltitude: 50, // metres
+	skyPreset: 'clearDay',
 
 	// Camera projection — 'perspective' | 'orthographic' | 'equirectangular'. Panorama ranges are UI-facing degrees.
 	cameraProjection: 'perspective',
@@ -427,55 +437,17 @@ export const CAMERA_RANGES = {
 	}
 };
 
+// `exposure` (EV) makes up about two thirds of the light a lower sun loses, as a photographer
+// would: a sunset still reads darker than noon.
 export const SKY_PRESETS = {
-	clearMorning: {
-		name: "Clear Morning",
-		sunAzimuth: 90,
-		sunElevation: 20,
-		sunIntensity: 15.0,
-		rayleighDensity: 0.9,
-		turbidity: 0.8,
-	},
-	clearNoon: {
-		name: "Clear Noon",
-		sunAzimuth: 0,
-		sunElevation: 75,
-		sunIntensity: 20.0,
-		rayleighDensity: 1.0,
-		turbidity: 0.3,
-	},
-	overcast: {
-		name: "Overcast",
-		sunAzimuth: 0,
-		sunElevation: 45,
-		sunIntensity: 6.0,
-		rayleighDensity: 0.6,
-		turbidity: 4.0,
-	},
-	goldenHour: {
-		name: "Golden Hour",
-		sunAzimuth: 270,
-		sunElevation: 10,
-		sunIntensity: 19.0,
-		rayleighDensity: 0.8,
-		turbidity: 1.2,
-	},
-	sunset: {
-		name: "Sunset",
-		sunAzimuth: 270,
-		sunElevation: 2,
-		sunIntensity: 18.0,
-		rayleighDensity: 0.7,
-		turbidity: 2.0,
-	},
-	dusk: {
-		name: "Dusk",
-		sunAzimuth: 270,
-		sunElevation: - 8,
-		sunIntensity: 8.0,
-		rayleighDensity: 0.5,
-		turbidity: 1.5,
-	}
+	clearDay: { name: 'Clear Day', sunAzimuth: 180 - DEFAULT_SUN.azimuth, sunElevation: DEFAULT_SUN.elevation, turbidity: 2, exposure: 0 },
+	clearMorning: { name: 'Clear Morning', sunAzimuth: 90, sunElevation: 15, turbidity: 2, exposure: 1.4 },
+	clearNoon: { name: 'Clear Noon', sunAzimuth: 180, sunElevation: 70, turbidity: 2, exposure: 0 },
+	hazyAfternoon: { name: 'Hazy Afternoon', sunAzimuth: 225, sunElevation: 35, turbidity: 4.5, exposure: 0.4 },
+	goldenHour: { name: 'Golden Hour', sunAzimuth: 270, sunElevation: 6, turbidity: 2.5, exposure: 2.7 },
+	sunset: { name: 'Sunset', sunAzimuth: 270, sunElevation: 1, turbidity: 3, exposure: 4.2 },
+	blueHour: { name: 'Blue Hour', sunAzimuth: 270, sunElevation: - 4, turbidity: 2, exposure: 7 },
+	mountain: { name: 'Mountain Air', sunAzimuth: 135, sunElevation: 40, turbidity: 1.3, altitude: 3000, exposure: 0 },
 };
 
 export const CAMERA_PRESETS = {
@@ -836,6 +808,16 @@ export const BVH_LEAF_MARKERS = {
 	FRONTIER: 0x40000002, // parallel-build placeholder, overwritten during assembly
 };
 
+/**
+ * A triangle leaf of at most this many triangles is folded into its parent: the child's slot ([3]
+ * or [7]) holds `~( first << 4 | count )`, the very value traversal pushes, so an inner node is
+ * read exactly as before and only popping a negative entry differs. Node indices stay below
+ * {@link BVH_MAX_INDEX}, leaf tags between it and 2^31, folded leaves from 2^31 up — so the count
+ * has four bits and the first triangle must stay below {@link BVH_FOLDED_FIRST_LIMIT}.
+ */
+export const BVH_FOLDED_LEAF_MAX = 15;
+export const BVH_FOLDED_FIRST_LIMIT = 1 << 27;
+
 /** A u32 view over a float buffer, for writing index fields as exact bit patterns. */
 export function bvhIndexView( f32 ) {
 

package/src/EngineEvents.js

@@ -65,4 +65,7 @@ export const EngineEvents = {
 
 	// Scene metadata
 	SCENE_METADATA_APPLIED: 'engine:sceneMetadataApplied',
+
+	// Storage (OPFS): usage or entries changed
+	STORAGE_CHANGED: 'engine:storageChanged',
 };

package/src/EngineIssues.js

@@ -24,6 +24,12 @@ export const ISSUE_CODES = Object.freeze( {
 	VIEW_TRANSFORM_DISPLAY_MISMATCH: 'viewTransform.display_mismatch',
 	VIEW_TRANSFORM_BAKE_FAILED: 'viewTransform.bake_failed',
 	COLOR_CONFIG_LOAD_FAILED: 'color.config_load_failed',
+	STORAGE_UNAVAILABLE: 'storage.unavailable',
+	STORAGE_QUOTA_EXCEEDED: 'storage.quota_exceeded',
+	STORAGE_WRITE_FAILED: 'storage.write_failed',
+	STORAGE_READ_FAILED: 'storage.read_failed',
+	STORAGE_ENTRY_CORRUPT: 'storage.entry_corrupt',
+	STORAGE_CACHE_MISMATCH: 'storage.cache_mismatch',
 } );
 
 /** Strict throws on ERROR only. */

package/src/Headless.js

@@ -81,11 +81,13 @@ export async function openHeadless( {
 	profile = 'physical',
 	deterministic = true,
 	settings = null,
+	storage = false,
 } = {} ) {
 
 	if ( ! canvas ) throw new Error( 'openHeadless: a canvas is required' );
 
-	const app = new PathTracerApp( canvas, { autoResize: false, strict, profile } );
+	// Off unless asked for: cached state from an earlier run must not change what a batch renders.
+	const app = new PathTracerApp( canvas, { autoResize: false, strict, profile, storage } );
 
 	try {
 

package/src/Passes/AIUpscaler.js

@@ -205,7 +205,7 @@ export class AIUpscaler extends EventDispatcher {
 
 				};
 
-				const { ortRuntimeUrl, ortWasmPaths, cacheNamespace } = getAssetConfig();
+				const { ortRuntimeUrl, ortWasmPaths, cacheNamespace, storage } = getAssetConfig();
 				this._worker.addEventListener( 'message', handler );
 				this._worker.postMessage( {
 					type: 'load',
@@ -214,6 +214,7 @@ export class AIUpscaler extends EventDispatcher {
 					ortRuntimeUrl,
 					ortWasmPaths,
 					cacheNamespace,
+					storage,
 				} );
 
 			} );

package/src/Passes/OIDNDenoiser.js

@@ -21,6 +21,7 @@ async function getInitUNetFromBuffer() {
 }
 
 import { getAssetConfig } from '../AssetConfig.js';
+import { sharedDownloads, DOWNLOAD_POLICY } from '../Storage/DownloadCache.js';
 
 const MODEL_CONFIG = {
 	// No cleanAux flag in oidn-web, so the blob is it — and it must match what setCleanAuxNormal
@@ -466,12 +467,8 @@ export class OIDNDenoiser extends EventDispatcher {
 		let bytes = this._weights.get( url );
 		if ( ! bytes ) {
 
-			bytes = fetch( url ).then( res => {
-
-				if ( ! res.ok ) throw new Error( `HTTP ${ res.status } fetching ${ url }` );
-				return res.arrayBuffer();
-
-			} );
+			bytes = sharedDownloads().fetch( url, { policy: DOWNLOAD_POLICY.IMMUTABLE } )
+				.then( ( { file, release } ) => file.arrayBuffer().finally( release ) );
 			bytes.catch( () => this._weights.delete( url ) );
 			this._weights.set( url, bytes );