@needle-tools/engine 5.1.0-canary.e9062c0 → 5.1.0-canary.fbdfce3

package/plugins/vite/reload.js

@@ -7,6 +7,7 @@ import { existsSync, readFileSync, statSync } from 'fs';
 import { fileURLToPath } from 'url';
 import { needleLog } from './logging.js';
 
+const pluginName = "needle-reload";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
@@ -39,7 +40,7 @@ export function needleReload(_command, config, userSettings) {
     const buildDirectory = projectConfig?.buildDirectory?.length ? process.cwd().replaceAll("\\", "/") + "/" + projectConfig?.buildDirectory : "";
     if (buildDirectory?.length) {
         const relativeBuildDirectory = path.relative(process.cwd(), buildDirectory).replaceAll("\\", "/") || ".";
-        setTimeout(() => needleLog("needle-reload", "Build directory: " + relativeBuildDirectory), 100);
+        setTimeout(() => needleLog(pluginName, "Build directory: " + relativeBuildDirectory), 100);
     }
 
     // These ignore patterns will be injected into user config to better control vite reloading
@@ -59,7 +60,7 @@ export function needleReload(_command, config, userSettings) {
                 // @ts-ignore - watch.ignored is guaranteed to be string[] by the guards above
                 config.server.watch.ignored.push(pattern);
             if (userSettings?.debug === true)
-                setTimeout(() => needleLog("needle-reload", "Updated server ignore patterns: " + JSON.stringify(config.server?.watch?.ignored)), 100);
+                setTimeout(() => needleLog(pluginName, "Updated server ignore patterns: " + JSON.stringify(config.server?.watch?.ignored)), 100);
         },
         /** @param {import('vite').HmrContext & {buildDirectory?: string}} args */
         handleHotUpdate(args) {
@@ -118,7 +119,7 @@ function getHot(server) {
 
 /** @param {import('vite').ViteDevServer} server @param {string} [file] */
 function notifyClientWillReload(server, file) {
-    console.log("Send reload notification");
+    needleLog(pluginName, "Send reload notification");
     getHot(server).send('needle:reload', { type: 'will-reload', file: file });
 }
 
@@ -134,7 +135,7 @@ async function handleReload({ file, server, modules: _modules, read, buildDirect
 
     // Dont reload the whole server when a file that is using hot reload changes
     if (filesUsingHotReload.has(file)) {
-        console.log("File is using hot reload: " + file);
+        needleLog(pluginName, "File is using hot reload: " + file);
         return null;
     }
 
@@ -153,7 +154,7 @@ async function handleReload({ file, server, modules: _modules, read, buildDirect
     // instead of relying on the vite server watch ignore array
     // we could here also match paths that we know we dont want to track
     if (ignorePatterns.length > 0 && ignoreRegex.test(file)) {
-        console.log("Ignore change in file: " + getFileNameLog(file));
+        needleLog(pluginName, "Ignore change in file: " + getFileNameLog(file));
         return [];
     }
 
@@ -163,7 +164,7 @@ async function handleReload({ file, server, modules: _modules, read, buildDirect
     if (buildDirectory?.length) {
         const dir = path.dirname(file).replaceAll("\\", "/");
         if (dir.startsWith(buildDirectory)) {
-            console.log("Ignore change in build directory: " + getFileNameLog(file));
+            needleLog(pluginName, "Ignore change in build directory: " + getFileNameLog(file));
             return [];
         }
     }
@@ -178,13 +179,13 @@ async function handleReload({ file, server, modules: _modules, read, buildDirect
             return [];
         }
         if (await testIfFileContentChanged(file, read) === false) {
-            console.log("File content didnt change: " + getFileNameLog(file));
+            needleLog(pluginName, "File content didnt change: " + getFileNameLog(file));
             return [];
         }
     }
 
     // these are known file types we export from integrations
-    const knownExportFileTypes = [ ".glb", ".gltf", ".bin", "exr", ".ktx2", ".mp3", ".ogg", ".mp4", ".webm" ];
+    const knownExportFileTypes = [".glb", ".gltf", ".bin", "exr", ".ktx2", ".mp3", ".ogg", ".mp4", ".webm"];
     if (!knownExportFileTypes.some((type) => file.endsWith(type)))
         return null;
 
@@ -208,7 +209,7 @@ async function handleReload({ file, server, modules: _modules, read, buildDirect
         }
     }
 
-    console.log("> Detected file change: ", getFileNameLog(file) + " (" + ((fileSize / (1024 * 1024)).toFixed(1)) + " MB)");
+    needleLog(pluginName, "> Detected file change: " + getFileNameLog(file) + " (" + ((fileSize / (1024 * 1024)).toFixed(1)) + " MB)");
     notifyClientWillReload(server);
     scheduleReload(server);
     return [];
@@ -223,7 +224,7 @@ async function scheduleReload(server, level = 0) {
     const lockFile = path.join(process.cwd(), lockFileName);
     if (existsSync(lockFile)) {
         if (level === 0)
-            console.log("Lock file exists, waiting for export to finish...");
+            needleLog(pluginName, "Lock file exists, waiting for export to finish...");
         setTimeout(() => scheduleReload(server, level += 1), 300);
         return;
     }
@@ -234,13 +235,13 @@ async function scheduleReload(server, level = 0) {
     if (timeDiff < 1000) {
         // Sometimes file changes happen immediately after triggering a reload 
         // we dont want to reload again in that case
-        console.log("Ignoring reload, last reload was too recent", timeDiff);
+        needleLog(pluginName, "Ignoring reload, last reload was too recent" + timeDiff + "ms ago");
         return;
     }
 
     lastReloadTime = Date.now();
     const readableTime = new Date(lastReloadTime).toLocaleTimeString();
-    console.log("< Reloading... " + readableTime)
+    needleLog(pluginName, "< Reloading... " + readableTime);
     getHot(server).send({
         type: 'full-reload',
         path: '*'
@@ -299,10 +300,10 @@ function removeVersionQueryArgument(content) {
 function insertScriptRegisterHotReloadCode(src, filePath) {
 
     // We only want to inject the hot reload code in the needle-engine root file
-    if(!filePath.includes("/src/needle-engine.ts")) {
+    if (!filePath.includes("/src/needle-engine.ts")) {
         return src;
     }
-    console.log("[Needle HMR] Hot reload is enabled");
+    needleLog(pluginName, "[Needle HMR] Hot reload is enabled");
     // this code let's the engine know that we are in hot reload mode
     const code = `
 globalThis.NEEDLE_HOT_RELOAD_ENABLED = true;
@@ -338,12 +339,12 @@ function insertScriptHotReloadCode(src, filePath) {
             return undefined;
         // make import path from engine package
         const fullPathToHotReload = process.cwd() + "/node_modules/@needle-tools/engine/src/engine/engine_hot_reload.ts";
-        // console.log(fullPathToHotReload);
+        // needleLog(pluginName, fullPathToHotReload);
         const fileDirectory = path.dirname(filePath);
-        // console.log("DIR", fileDirectory)
+        // needleLog(pluginName, "DIR", fileDirectory)
         const relativePath = path.relative(fileDirectory, fullPathToHotReload);
         importPath = relativePath.replace(/\\/g, "/");
-        // console.log("importPath: ", importPath);
+        // needleLog(pluginName, "importPath: ", importPath);
     }
 
     // console.log(importPath, ">", filePath);

package/src/engine/debug/debug_spatial_console.ts

@@ -12,13 +12,16 @@ import { onError } from "./debug_overlay.js";
 
 let _isActive = false;
 
-// enable the spatial console if we receive an error while in dev session and in XR
-onError((...args: any[]) => {
-    if (isDevEnvironment() && ContextRegistry.Current?.isInXR) {
-        enableSpatialConsole(true);
-        onLog("error", ...args);
-    }
-})
+/** @internal */
+export function initSpatialConsole() {
+    // enable the spatial console if we receive an error while in dev session and in XR
+    onError((...args: any[]) => {
+        if (isDevEnvironment() && ContextRegistry.Current?.isInXR) {
+            enableSpatialConsole(true);
+            onLog("error", ...args);
+        }
+    });
+}
 
 
 /** Enable a spatial debug console that follows the camera */

package/src/engine/engine_addressables.ts

@@ -567,7 +567,6 @@ class AddressableSerializer extends TypeSerializer {
     }
 
 }
-new AddressableSerializer();
 
 
 
@@ -703,7 +702,6 @@ export class ImageReferenceSerializer extends TypeSerializer {
         return undefined;
     }
 }
-new ImageReferenceSerializer();
 
 
 
@@ -772,4 +770,9 @@ export class FileReferenceSerializer extends TypeSerializer {
         return undefined;
     }
 }
-new FileReferenceSerializer();
+/** @internal */
+export function initAddressableSerializers() {
+    new AddressableSerializer();
+    new ImageReferenceSerializer();
+    new FileReferenceSerializer();
+}

package/src/engine/engine_context.ts

@@ -478,13 +478,14 @@ export class Context implements IContext {
 	 * Use `setCurrentCamera` for updating the main camera.
 	 */
 	/**
-	 * Typed proxy providing direct access to scene components by node and component name.
-	 * Types are auto-generated from your GLB assets by the `needle:dts-generator` Vite plugin
-	 * and written to `src/generated/needle-bindings.d.ts` on every dev-server start and GLB change.
+	 * Access your scene's full hierarchy, objects, and components directly by name — with full autocomplete.
+	 * Types are generated automatically from your GLB files when the dev server starts.
 	 *
-	 * Each property access traverses the live scene graph on demand — no caching, always fresh.
-	 * This is a convenience shorthand for `getComponent` lookups; the same result can be
-	 * achieved manually via `scene.getObjectByName(name)` + `getComponent(node, Type)`.
+	 * You can store references to objects or components for later use.
+	 * Note that the scene hierarchy can change at runtime (e.g. when objects are added, removed, or re-parented),
+	 * in which case stored references may become stale.
+	 *
+	 * @experimental This API may change in future versions.
 	 *
 	 * @example
 	 * // Toggle auto-rotate on the orbit camera
@@ -493,12 +494,6 @@ export class Context implements IContext {
 	 * @example
 	 * // Change the background color
 	 * ctx.sceneData.Camera.Camera.backgroundColor = new RGBAColor(1, 0, 0, 1);
-	 *
-	 * @example
-	 * // Equivalent manual approach (without sceneData)
-	 * const node = ctx.scene.getObjectByName("Camera");
-	 * const orbit = getComponent(node, OrbitControls);
-	 * if (orbit) orbit.autoRotate = true;
 	 */
 	get sceneData(): SceneData {
 		return getSceneData(this);
@@ -543,8 +538,10 @@ export class Context implements IContext {
 	/**  @deprecated AssetDatabase is deprecated */
 	assets: AssetDatabase;
 
-	/** All registered lights in the scene, maintained by the Light component */
-	readonly lights: Set<ILight> = new Set();
+	/** All registered lights in the scene, maintained by the Light component. 
+	 * @see mainLight for accessing the main directional light in the scene
+	 */
+	readonly lights = new Array<ILight>();
 
 	/** The brightest registered directional light, or null if none are registered
 	 * @see lights
@@ -559,12 +556,13 @@ export class Context implements IContext {
 	}
 
 	/** @deprecated Use sceneLighting */
-	get rendererData() { return this.sceneLighting }
+	private get rendererData() { return this.sceneLighting }
+
 	/** Access the scene lighting manager to control lighting settings in the context */
-	sceneLighting: SceneLighting;
-	addressables: Addressables;
-	lightmaps: ILightDataRegistry;
-	players: PlayerViewManager;
+	readonly sceneLighting: SceneLighting;
+	readonly addressables: Addressables;
+	readonly lightmaps: ILightDataRegistry;
+	readonly players: PlayerViewManager;
 
 	/** Access the LODs manager to control LOD behavior in the context */
 	readonly lodsManager: LODsManager;
@@ -872,7 +870,7 @@ export class Context implements IContext {
 		this._onBeforeRenderListeners.clear();
 		this._onAfterRenderListeners.clear();
 
-		this.lights.clear();
+		this.lights.length = 0;
 
 		if (!this.isManagedExternally) {
 			if (this.renderer) {

package/src/engine/engine_init.ts

@@ -1,10 +1,14 @@
+import { initAnimatorControllerSerializer } from "../engine-components/AnimatorController.js";
 import { initAnimationAutoplay } from "../engine-components/AnimationUtilsAutoplay.js";
 import { initCameraUtils } from "../engine-components/CameraUtils.js";
+import { initVolumeParameterSerializer } from "../engine-components/postprocessing/VolumeParameter.js";
 import { initSceneSwitcherAttributes } from "../engine-components/SceneSwitcher.js";
 import { initSkyboxAttributes } from "../engine-components/Skybox.js";
+import { initAddressableSerializers } from "./engine_addressables.js";
 import { initBuiltinTypes } from "./codegen/register_types.js";
 import { ensureAudioContextIsResumed } from "./engine_audio.js";
 import { initNeedleLoader } from "./engine_loaders.js";
+import { initBuiltinSerializers } from "./engine_serialization_builtin_serializer.js";
 import { initShims } from "./engine_shims.js";
 import { patchTonemapping } from "./engine_tonemapping.js";
 import { initCameraExtensions } from "./js-extensions/Camera.js";
@@ -15,6 +19,7 @@ import { SSR } from "./engine_ssr.js";
 import { initLicense } from "./engine_license.js";
 import { initWebComponents } from "./webcomponents/init.js";
 import { initPhysics } from "./engine_physics_rapier.js";
+import { initSpatialConsole } from "./debug/debug_spatial_console.js";
 import { initXR } from "./xr/init.js";
 
 let initialized = false;
@@ -35,6 +40,10 @@ export function initEngine() {
 
     initWebComponents();
     initShims();
+    initBuiltinSerializers();
+    initAddressableSerializers();
+    initAnimatorControllerSerializer();
+    initVolumeParameterSerializer();
     patchTonemapping();
     patchLayers();
     initCameraExtensions();
@@ -49,5 +58,6 @@ export function initEngine() {
     initSceneSwitcherAttributes();
     initPhysics();
     initXR();
+    initSpatialConsole();
     initLicense();
 }

package/src/engine/engine_scenedata.ts

@@ -7,15 +7,13 @@ import { isDevEnvironment } from "./debug/index.js";
 import { ContextRegistry } from "./engine_context_registry.js";
 
 /**
- * Global proxy for the primary Needle Engine context.
- * Resolves lazily on property access via `ContextRegistry.Current` —
- * safe to import at module level, including in SSR environments
- * (returns a silent error proxy when no context is active).
+ * Quick access to the current Needle Engine context from anywhere — no need to pass `ctx` around.
+ * Use it in React/Svelte/Vue components, button handlers, or plain JavaScript.
  *
- * Use this outside of Needle component lifecycle (e.g. in Svelte/React/Vue
- * components, button handlers, or vanilla JS) instead of threading `ctx` around.
+ * Safe to import at module level, including in SSR environments.
+ * For pages with multiple `<needle-engine>` elements, use `ctx` directly instead.
  *
- * For multiple `<needle-engine>` elements on the same page, use `ctx` directly.
+ * @experimental This API may change in future releases.
  *
  * @example
  * import { needle } from "@needle-tools/engine";
@@ -29,7 +27,7 @@ export const needle: IContext = new Proxy({} as IContext, {
         const ctx = ContextRegistry.Current;
         if (!ctx) {
             const fn = isDevEnvironment() ? console.error : console.warn;
-            fn(`[needle] needle.${prop} accessed before scene started`);
+            fn(`[needle] needle.${prop} was accessed before the scene started. Use "needle" inside event handlers or callbacks, not at module top-level. For setup code use: onStart(ctx => { ... })`);
             return makeErrorProxy(`needle not ready — scene hasn't started yet`);
         }
         const val = (ctx as any)[prop];
@@ -39,7 +37,7 @@ export const needle: IContext = new Proxy({} as IContext, {
         const ctx = ContextRegistry.Current;
         if (!ctx) {
             const fn = isDevEnvironment() ? console.error : console.warn;
-            fn(`[needle] needle.${prop} set before scene started`);
+            fn(`[needle] needle.${prop} was set before the scene started. Use "needle" inside event handlers or callbacks, not at module top-level. For setup code use: onStart(ctx => { ... })`);
             return true;
         }
         (ctx as any)[prop] = value;
@@ -91,9 +89,14 @@ function makeNodeProxy(ctx: IContext, node: import("three").Object3D): object {
                     }
                 });
             }
+            if (prop === "then") return undefined; // not a Promise
             // Child node lookup by name
             const child = node.children.find(c => c.name === prop) ?? null;
-            if (!child) return makeErrorProxy(`Child "${prop}" not found on node "${node.name}"`);
+            if (!child) {
+                const fn = isDevEnvironment() ? console.error : console.warn;
+                fn(`[SceneData] "${prop}" is not a child of "${node.name}". Use .$object to get the Three.js object or .$components.Name to access a component.`);
+                return makeErrorProxy(`"${prop}" not found on node "${node.name}"`);
+            }
             return makeNodeProxy(ctx, child);
         }
     });

package/src/engine/engine_serialization_builtin_serializer.ts

@@ -11,24 +11,6 @@ import { IComponent } from "./engine_types.js";
 import { resolveUrl } from "./engine_utils.js";
 import { RGBAColor } from "./js-extensions/index.js";
 
-// export class SourcePath {
-//     src?:string
-// };
-
-// class SourcePathSerializer extends TypeSerializer{
-//     constructor(){
-//         super(SourcePath);
-//     }
-//     onDeserialize(data: any, _context: SerializationContext) {
-//         if(data.src && typeof data.src === "string"){
-//             return data.src;
-//         }
-//     }
-//     onSerialize(_data: any, _context: SerializationContext) {
-
-//     }
-// }
-// new SourcePathSerializer();
 
 class ColorSerializer extends TypeSerializer {
     constructor() {
@@ -52,7 +34,6 @@ class ColorSerializer extends TypeSerializer {
             return { r: data.r, g: data.g, b: data.b }
     }
 }
-export const colorSerializer = new ColorSerializer();
 
 class EulerSerializer extends TypeSerializer {
     constructor() {
@@ -72,7 +53,6 @@ class EulerSerializer extends TypeSerializer {
         return { x: data.x, y: data.y, z: data.z, order: data.order };
     }
 }
-export const euler = new EulerSerializer();
 
 declare type ObjectData = {
     node?: number;
@@ -107,16 +87,6 @@ class ObjectSerializer extends TypeSerializer {
                 console.warn(`Wrong usage of @serializable detected in your script \"${scriptname}\"\n\nIt looks like you used @serializable(Object3D) or @serializable(GameObject) for a prefab or scene reference which is exported to a separate glTF file.\n\nTo fix this please change your code to:\n\n@serializable(AssetReference)\n${context.path}! : AssetReference;\n\0`);
             }
             // ACTUALLY: this is already handled by the extension_utils where we resolve json pointers recursively
-            // if(data.startsWith("/nodes/")){
-            //     const node = parseInt(data.substring("/nodes/".length));
-            //     if (context.nodeToObject) {
-            //         const res = context.nodeToObject[node];
-            //         if (debugExtension)
-            //             console.log("Deserialized object reference?", data, res, context?.nodeToObject);
-            //         if (!res) console.warn("Did not find node: " + data, context.nodeToObject, context.object);
-            //         return res;
-            //     }
-            // }
             return undefined;
         }
 
@@ -166,7 +136,6 @@ class ObjectSerializer extends TypeSerializer {
         return undefined;
     }
 }
-export const objectSerializer = new ObjectSerializer();
 
 
 class ComponentSerializer extends TypeSerializer {
@@ -241,7 +210,6 @@ class ComponentSerializer extends TypeSerializer {
         }
     }
 }
-export const componentSerializer = new ComponentSerializer();
 
 
 declare class EventListData {
@@ -396,21 +364,12 @@ class EventListSerializer extends TypeSerializer {
     //     };
     // }
 }
-export const eventListSerializer = new EventListSerializer();
 
 
 /** Map<Clone, Original> texture. This is used for compressed textures (or when the GLTFLoader is cloning RenderTextures)
  * It's a weak map so we don't have to worry about memory leaks
  */
 const cloneOriginalMap = new WeakMap<Texture, Texture>();
-const textureClone = Texture.prototype.clone;
-Texture.prototype.clone = function () {
-    const clone = textureClone.call(this);
-    if (!cloneOriginalMap.has(clone)) {
-        cloneOriginalMap.set(clone, this);
-    }
-    return clone;
-}
 
 export class RenderTextureSerializer extends TypeSerializer {
     constructor() {
@@ -452,7 +411,6 @@ export class RenderTextureSerializer extends TypeSerializer {
         return undefined;
     }
 }
-new RenderTextureSerializer();
 
 
 export class UriSerializer extends TypeSerializer {
@@ -471,4 +429,35 @@ export class UriSerializer extends TypeSerializer {
         return undefined;
     }
 }
-new UriSerializer();
+
+
+// Module-level references used by EventListSerializer internally
+export let colorSerializer: ColorSerializer;
+export let objectSerializer: ObjectSerializer;
+export let componentSerializer: ComponentSerializer;
+export let eventListSerializer: EventListSerializer;
+
+/** Register all builtin serializers and prototype patches.
+ * Must be called from {@link initEngine} so the registrations survive tree-shaking
+ * when the package declares `sideEffects: false`.
+ */
+export function initBuiltinSerializers() {
+    // Prototype patches
+    const textureClone = Texture.prototype.clone;
+    Texture.prototype.clone = function () {
+        const clone = textureClone.call(this);
+        if (!cloneOriginalMap.has(clone)) {
+            cloneOriginalMap.set(clone, this);
+        }
+        return clone;
+    }
+
+    // Register all serializers
+    colorSerializer = new ColorSerializer();
+    new EulerSerializer();
+    objectSerializer = new ObjectSerializer();
+    componentSerializer = new ComponentSerializer();
+    eventListSerializer = new EventListSerializer();
+    new RenderTextureSerializer();
+    new UriSerializer();
+}

package/src/engine/webcomponents/jsx.d.ts

@@ -3,8 +3,15 @@
  *
  * Covers both the global JSX namespace (Preact, SolidJS, Svelte, vanilla TS)
  * and React's module-scoped JSX namespace (react-jsx / react-jsxdev transform).
+ *
+ * IMPORTANT: This file must be a module (has a top-level import/export) so that
+ * `declare module "react"` is treated as a *module augmentation* (merging into
+ * the existing React types) rather than an *ambient module declaration* (which
+ * would shadow/replace @types/react).
  */
 
+import type { NeedleEngineAttributes } from "./needle-engine.js";
+
 interface NeedleButtonJSXAttributes extends Partial<Omit<HTMLElement, "style" | "children">> {
     style?: Partial<CSSStyleDeclaration>;
     ar?: boolean | string;
@@ -23,7 +30,7 @@ interface NeedleLogoElementJSXAttributes extends Partial<Omit<HTMLElement, "styl
 }
 
 interface NeedleElements {
-    "needle-engine": import("./needle-engine.js").NeedleEngineAttributes;
+    "needle-engine": Partial<NeedleEngineAttributes>;
     "needle-button": NeedleButtonJSXAttributes;
     "needle-menu": NeedleMenuJSXAttributes;
     "needle-logo-element": NeedleLogoElementJSXAttributes;
@@ -36,7 +43,7 @@ declare global {
     }
 }
 
-// React module-scoped JSX namespace
+// React module-scoped JSX namespace (module augmentation, not ambient declaration)
 declare module "react" {
     namespace JSX {
         interface IntrinsicElements extends NeedleElements {}

package/src/engine-components/AnimatorController.ts

@@ -1586,4 +1586,7 @@ class AnimatorControllerSerializator extends TypeSerializer {
         return undefined;
     }
 }
-new AnimatorControllerSerializator(AnimatorController);
+/** @internal */
+export function initAnimatorControllerSerializer() {
+    new AnimatorControllerSerializator(AnimatorController);
+}

package/src/engine-components/Light.ts

@@ -401,12 +401,13 @@ export class Light extends Behaviour implements ILight {
             else if (this.light.parent !== this.gameObject)
                 this.gameObject.add(this.light);
         }
-        this.context.lights.add(this);
+        this.context.lights.push(this);
     }
 
     onDisable() {
         if (debug) console.log("DISABLE LIGHT", this.name);
-        this.context.lights.delete(this);
+        const index = this.context.lights.indexOf(this);
+        if (index !== -1) this.context.lights.splice(index, 1);
         if (this.light) {
             if (this.selfIsLight)
                 this.light.intensity = 0;

package/src/engine-components/ReflectionProbe.ts

@@ -290,6 +290,8 @@ export class ReflectionProbe extends Behaviour {
             const current = block.getOverride("envMap")?.value;
             if (current === this.texture) {
                 block.removeOveride("envMap");
+                block.removeOveride("envMapRotation");
+                block.removeOveride("envMapIntensity");
             }
         }
     }

package/src/engine-components/postprocessing/VolumeParameter.ts

@@ -156,4 +156,7 @@ class VolumeParameterSerializer extends TypeSerializer {
         return parameter;
     }
 }
-new VolumeParameterSerializer();
+/** @internal */
+export function initVolumeParameterSerializer() {
+    new VolumeParameterSerializer();
+}