@nodetool-ai/game-renderer 0.8.4-a24.3 → 0.8.4

package/dist/renderer3d/decals/index.js

@@ -0,0 +1,284 @@
+import * as THREE from "three";
+import { GAME_MAX_DECALS_3D } from "@nodetool-ai/protocol";
+import { GameImageCache3D } from "../assets/image-cache.js";
+import { GAME_DECAL_LIMITS_3D, GameDecalProjectionError3D, gameDecalAttributeKey3D, gameDecalProjector3D, projectGameDecalGeometry3D } from "./geometry.js";
+// Decal overlap ordering stays before ordinary transparent geometry, whose default order is zero.
+const DECAL_RENDER_ORDER_START = -(GAME_MAX_DECALS_3D * GAME_MAX_DECALS_3D);
+/** One cache per renderer. Projected meshes remain in world space and never enter the simulation. */
+export class GameDecals3D {
+    scene;
+    signal;
+    diagnostics;
+    onDiagnostic;
+    images;
+    entries = new Map();
+    loadedSlots = new Set();
+    reported = new Set();
+    onAbort = () => this.dispose();
+    disposed = false;
+    constructor(scene, sources, signal, diagnostics, onDiagnostic) {
+        this.scene = scene;
+        this.signal = signal;
+        this.diagnostics = diagnostics;
+        this.onDiagnostic = onDiagnostic;
+        this.images = new GameImageCache3D(sources, signal);
+        signal.addEventListener("abort", this.onAbort, { once: true });
+        if (signal.aborted) {
+            this.dispose();
+        }
+    }
+    get textureBytes() { return this.images.textureBytes; }
+    get geometryBytes() {
+        let bytes = 0;
+        for (const entry of this.entries.values()) {
+            for (const geometry of entry.geometries) {
+                for (const attribute of Object.values(geometry.attributes)) {
+                    bytes += attribute instanceof THREE.InterleavedBufferAttribute ? attribute.data.array.byteLength : attribute.array.byteLength;
+                }
+                bytes += geometry.index?.array.byteLength ?? 0;
+            }
+        }
+        return bytes;
+    }
+    async sync(frame, instances) {
+        this.signal.throwIfAborted();
+        if (this.disposed) {
+            throw new Error("Decal renderer is disposed");
+        }
+        const decals = frame.entities.filter((entity) => entity.decal3d);
+        const present = new Set(decals.slice(0, GAME_MAX_DECALS_3D).map((entity) => entity.entityId));
+        for (const [id, entry] of this.entries) {
+            if (!present.has(id)) {
+                this.release(id, entry);
+            }
+        }
+        const usedSlots = new Set(decals.slice(0, GAME_MAX_DECALS_3D).flatMap((entity) => entity.decal3d ? [entity.decal3d.assetId] : []));
+        for (const slot of this.loadedSlots) {
+            if (!usedSlots.has(slot)) {
+                await this.images.invalidate(slot);
+                this.loadedSlots.delete(slot);
+            }
+        }
+        if (decals.length === 0) {
+            return;
+        }
+        this.scene.updateMatrixWorld(true);
+        const receivers = new Map();
+        let cachedVertices = 0;
+        for (const entry of this.entries.values()) {
+            for (const geometry of entry.geometries) {
+                cachedVertices += geometry.getAttribute("position").count;
+            }
+        }
+        const work = { nodes: 0, sourceTriangles: 0, candidateTriangles: 0, outputVertices: cachedVertices };
+        for (const [order, entity] of decals.entries()) {
+            const settings = entity.decal3d;
+            if (!settings) {
+                continue;
+            }
+            if (order >= GAME_MAX_DECALS_3D) {
+                this.report("Scene decal count limit exceeded");
+                break;
+            }
+            const existing = this.entries.get(entity.entityId);
+            const projectorObject = instances.get(entity.entityId)?.object;
+            const receiverObject = instances.get(settings.receiverId)?.object;
+            if (!projectorObject || !receiverObject) {
+                if (existing) {
+                    this.release(entity.entityId, existing);
+                }
+                this.report(`Decal ${entity.entityId} receiver or projector is unavailable`);
+                continue;
+            }
+            if (!receiverObject.visible || !projectorObject.visible || (entity.opacity ?? 1) === 0) {
+                if (existing) {
+                    existing.group.visible = false;
+                }
+                continue;
+            }
+            try {
+                let receiver = receivers.get(settings.receiverId);
+                if (!receiver) {
+                    receiver = this.receiver(receiverObject, work);
+                    receivers.set(settings.receiverId, receiver);
+                }
+                const key = `${JSON.stringify(settings)}:${projectorObject.matrixWorld.elements.join(",")}:${receiver.signature}`;
+                if (existing?.key === key) {
+                    existing.group.visible = true;
+                    if (existing.material) {
+                        existing.material.opacity = settings.opacity * (entity.opacity ?? 1);
+                    }
+                    for (const child of existing.group.children) {
+                        child.renderOrder = DECAL_RENDER_ORDER_START + settings.renderOrder * GAME_MAX_DECALS_3D + order;
+                    }
+                    continue;
+                }
+                if (existing) {
+                    for (const geometry of existing.geometries) {
+                        work.outputVertices -= geometry.getAttribute("position").count;
+                    }
+                }
+                const next = await this.build(key, settings, projectorObject, receiver, work);
+                try {
+                    this.signal.throwIfAborted();
+                }
+                catch (error) {
+                    this.release(entity.entityId, next);
+                    throw error;
+                }
+                if (existing) {
+                    this.release(entity.entityId, existing);
+                }
+                next.group.userData.gameEntityId = entity.entityId;
+                for (const object of next.group.children) {
+                    object.renderOrder = DECAL_RENDER_ORDER_START + settings.renderOrder * GAME_MAX_DECALS_3D + order;
+                }
+                if (next.material) {
+                    next.material.opacity = settings.opacity * (entity.opacity ?? 1);
+                }
+                this.entries.set(entity.entityId, next);
+                this.scene.add(next.group);
+            }
+            catch (error) {
+                if (!(error instanceof GameDecalProjectionError3D)) {
+                    throw error;
+                }
+                if (existing) {
+                    this.release(entity.entityId, existing);
+                }
+                this.report(`Decal ${entity.entityId}: ${error.message}`);
+            }
+        }
+    }
+    receiver(root, work) {
+        const meshes = [];
+        const keys = [root.uuid];
+        const pending = [root];
+        while (pending.length > 0) {
+            const object = pending.pop();
+            if (!object) {
+                break;
+            }
+            work.nodes += 1;
+            if (work.nodes > GAME_DECAL_LIMITS_3D.sceneNodes) {
+                throw new GameDecalProjectionError3D("Scene decal receiver node work limit exceeded");
+            }
+            if (!object.visible) {
+                continue;
+            }
+            for (let index = object.children.length - 1; index >= 0; index--) {
+                const child = object.children[index];
+                if (child) {
+                    pending.push(child);
+                }
+            }
+            if (!(object instanceof THREE.Mesh)) {
+                continue;
+            }
+            if (object instanceof THREE.SkinnedMesh || object instanceof THREE.InstancedMesh || Object.keys(object.geometry.morphAttributes).length > 0) {
+                throw new GameDecalProjectionError3D("Receivers must be rigid meshes without skinning, morph targets or instancing");
+            }
+            const materials = Array.isArray(object.material) ? object.material : [object.material];
+            if (materials.some((material) => !material.visible || material.transparent || material.alphaTest > 0 || material.opacity < 1)) {
+                throw new GameDecalProjectionError3D("Receivers must use visible opaque materials without alpha masking");
+            }
+            meshes.push(object);
+            keys.push(`${object.uuid}:${Array.isArray(object.material) ? `array-${object.material.length}` : "single"}:${object.geometry.uuid}:${gameDecalAttributeKey3D(object.geometry.getAttribute("position"))}:${gameDecalAttributeKey3D(object.geometry.getAttribute("normal"))}:${gameDecalAttributeKey3D(object.geometry.index ?? undefined)}:${JSON.stringify(object.geometry.drawRange)}:${JSON.stringify(object.geometry.groups)}:${object.matrixWorld.elements.join(",")}`);
+        }
+        return { meshes, signature: keys.join(";") };
+    }
+    async build(key, settings, object, receiver, work) {
+        const projector = gameDecalProjector3D(object, settings.size);
+        const geometries = [];
+        let texture;
+        let material;
+        try {
+            for (const mesh of receiver.meshes) {
+                const geometry = projectGameDecalGeometry3D(mesh, projector, work);
+                if (geometry) {
+                    geometries.push(geometry);
+                }
+            }
+            const group = new THREE.Group();
+            group.name = "game-decal";
+            if (geometries.length === 0) {
+                return { key, assetId: settings.assetId, group, geometries };
+            }
+            this.loadedSlots.add(settings.assetId);
+            texture = (await this.images.get(settings.assetId)).clone();
+            texture.colorSpace = THREE.SRGBColorSpace;
+            texture.needsUpdate = true;
+            material = new THREE.MeshStandardMaterial({ map: texture, color: "#ffffff", roughness: 1, metalness: 0,
+                transparent: true, opacity: settings.opacity, depthTest: true, depthWrite: false,
+                polygonOffset: true, polygonOffsetFactor: -2, polygonOffsetUnits: -2 });
+            for (const geometry of geometries) {
+                const mesh = new THREE.Mesh(geometry, material);
+                mesh.castShadow = false;
+                mesh.receiveShadow = true;
+                group.add(mesh);
+            }
+            const entry = { key, assetId: settings.assetId, group, geometries, texture, material };
+            texture = undefined;
+            material = undefined;
+            return entry;
+        }
+        catch (error) {
+            for (const geometry of geometries) {
+                geometry.dispose();
+            }
+            throw error;
+        }
+        finally {
+            material?.dispose();
+            texture?.dispose();
+        }
+    }
+    release(id, entry) {
+        entry.group.removeFromParent();
+        for (const geometry of entry.geometries) {
+            geometry.dispose();
+        }
+        entry.material?.dispose();
+        entry.texture?.dispose();
+        if (this.entries.get(id) === entry) {
+            this.entries.delete(id);
+        }
+    }
+    report(message) {
+        if (this.reported.has(message) || this.reported.size >= 64) {
+            return;
+        }
+        this.reported.add(message);
+        this.diagnostics.push(message);
+        this.onDiagnostic?.(message);
+    }
+    async invalidate(slot) {
+        for (const [id, entry] of this.entries) {
+            if (entry.assetId === slot) {
+                this.release(id, entry);
+            }
+        }
+        await this.images.invalidate(slot);
+        this.loadedSlots.delete(slot);
+    }
+    async reset() {
+        for (const [id, entry] of this.entries) {
+            this.release(id, entry);
+        }
+        await Promise.all([...this.loadedSlots].map((slot) => this.images.invalidate(slot)));
+        this.loadedSlots.clear();
+    }
+    dispose() {
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        this.signal.removeEventListener("abort", this.onAbort);
+        for (const [id, entry] of this.entries) {
+            this.release(id, entry);
+        }
+        this.images.dispose();
+        this.loadedSlots.clear();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/renderer3d/decals/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/renderer3d/decals/index.ts"],"names":[],"mappings":"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"}

package/dist/renderer3d/environment/height-fog.d.ts

@@ -0,0 +1,14 @@
+import * as THREE from "three";
+import type { GameHeightFog3D as GameHeightFogSettings3D, GameVector3 } from "@nodetool-ai/protocol";
+/** Analytic segment integral. Using its lower endpoint avoids subtracting two large exponentials. */
+export declare function heightFogOpacity3D(settings: GameHeightFogSettings3D, start: GameVector3, end: GameVector3): number;
+/** Owns reversible shader hooks. Configure after particle material creation and before the scene pass. */
+export declare class GameHeightFog3D {
+    private readonly materials;
+    private readonly uniforms;
+    configure(scene: THREE.Scene, camera: THREE.Camera, settings: GameHeightFogSettings3D | undefined): void;
+    private attach;
+    private restore;
+    dispose(): void;
+}
+//# sourceMappingURL=height-fog.d.ts.map

package/dist/renderer3d/environment/height-fog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"height-fog.d.ts","sourceRoot":"","sources":["../../../src/renderer3d/environment/height-fog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,eAAe,IAAI,uBAAuB,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGrG,qGAAqG;AACrG,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,uBAAuB,EAAE,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,WAAW,GAAG,MAAM,CAOlH;AAmCD,0GAA0G;AAC1G,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAOvB;IAEF,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,uBAAuB,GAAG,SAAS,GAAG,IAAI,CAuBvG;IAED,OAAO,CAAC,MAAM;IAed,OAAO,CAAC,OAAO;IAKf,OAAO,IAAI,IAAI,CAEd;CACF"}

package/dist/renderer3d/environment/height-fog.js

@@ -0,0 +1,114 @@
+import * as THREE from "three";
+import { removeGameMaterialHook, setGameMaterialHook } from "../material-hooks.js";
+/** Analytic segment integral. Using its lower endpoint avoids subtracting two large exponentials. */
+export function heightFogOpacity3D(settings, start, end) {
+    const distance = Math.hypot(end.x - start.x, end.y - start.y, end.z - start.z);
+    const heightDelta = settings.heightFalloff * Math.abs(end.y - start.y);
+    const average = heightDelta < 0.001 ? 1 - heightDelta / 2 + heightDelta * heightDelta / 6 : -Math.expm1(-heightDelta) / heightDelta;
+    const exponent = Math.max(-60, Math.min(60, -settings.heightFalloff * (Math.min(start.y, end.y) - settings.baseHeight)));
+    const opticalDepth = Math.min(80, settings.density * distance * Math.exp(exponent) * average);
+    return Math.min(settings.maxOpacity, -Math.expm1(-opticalDepth));
+}
+const VERTEX_DECLARATIONS = `
+uniform mat4 gameHeightFogCameraWorld;
+varying vec3 vGameHeightFogPosition;
+`;
+const FRAGMENT_DECLARATIONS = `
+uniform vec3 gameHeightFogOrigin;
+uniform vec3 gameHeightFogDirection;
+uniform bool gameHeightFogOrthographic;
+uniform float gameHeightFogDensity;
+uniform float gameHeightFogBase;
+uniform float gameHeightFogFalloff;
+uniform float gameHeightFogMaxOpacity;
+varying vec3 vGameHeightFogPosition;
+`;
+const FOG_FRAGMENT = `
+#ifdef USE_FOG
+  vec3 gameFogStart = gameHeightFogOrigin;
+  if (gameHeightFogOrthographic) {
+    float gameFogDepth = max(0.0, dot(vGameHeightFogPosition - gameHeightFogOrigin, gameHeightFogDirection));
+    gameFogStart = vGameHeightFogPosition - gameHeightFogDirection * gameFogDepth;
+  }
+  float gameFogDistance = length(vGameHeightFogPosition - gameFogStart);
+  float gameFogDelta = gameHeightFogFalloff * abs(vGameHeightFogPosition.y - gameFogStart.y);
+  float gameFogAverage = gameFogDelta < 0.001
+    ? 1.0 - 0.5 * gameFogDelta + gameFogDelta * gameFogDelta / 6.0
+    : (1.0 - exp(-min(60.0, gameFogDelta))) / gameFogDelta;
+  float gameFogExponent = clamp(-gameHeightFogFalloff * (min(gameFogStart.y, vGameHeightFogPosition.y) - gameHeightFogBase), -60.0, 60.0);
+  float gameFogOpticalDepth = min(80.0, gameHeightFogDensity * gameFogDistance * exp(gameFogExponent) * gameFogAverage);
+  float gameFogOpacity = min(gameHeightFogMaxOpacity, 1.0 - exp(-gameFogOpticalDepth));
+  gl_FragColor.rgb = mix(gl_FragColor.rgb, fogColor, gameFogOpacity);
+#endif
+`;
+/** Owns reversible shader hooks. Configure after particle material creation and before the scene pass. */
+export class GameHeightFog3D {
+    materials = new Set();
+    uniforms = {
+        gameHeightFogCameraWorld: { value: new THREE.Matrix4() },
+        gameHeightFogOrigin: { value: new THREE.Vector3() },
+        gameHeightFogDirection: { value: new THREE.Vector3() },
+        gameHeightFogOrthographic: { value: false },
+        gameHeightFogDensity: { value: 0 }, gameHeightFogBase: { value: 0 },
+        gameHeightFogFalloff: { value: 1 }, gameHeightFogMaxOpacity: { value: 1 }
+    };
+    configure(scene, camera, settings) {
+        if (!settings) {
+            this.dispose();
+            return;
+        }
+        this.uniforms.gameHeightFogCameraWorld.value.copy(camera.matrixWorld);
+        camera.getWorldPosition(this.uniforms.gameHeightFogOrigin.value);
+        camera.getWorldDirection(this.uniforms.gameHeightFogDirection.value);
+        this.uniforms.gameHeightFogOrthographic.value = camera instanceof THREE.OrthographicCamera;
+        this.uniforms.gameHeightFogDensity.value = settings.density;
+        this.uniforms.gameHeightFogBase.value = settings.baseHeight;
+        this.uniforms.gameHeightFogFalloff.value = settings.heightFalloff;
+        this.uniforms.gameHeightFogMaxOpacity.value = settings.maxOpacity;
+        const present = new Set();
+        scene.traverse((object) => {
+            if (!(object instanceof THREE.Mesh || object instanceof THREE.Points || object instanceof THREE.Line)) {
+                return;
+            }
+            const materials = Array.isArray(object.material) ? object.material : [object.material];
+            for (const material of materials) {
+                if (!("fog" in material) || material.fog !== true) {
+                    continue;
+                }
+                present.add(material);
+                if (!this.materials.has(material)) {
+                    this.attach(material);
+                }
+            }
+        });
+        for (const material of this.materials) {
+            if (!present.has(material)) {
+                this.restore(material);
+            }
+        }
+    }
+    attach(material) {
+        this.materials.add(material);
+        setGameMaterialHook(material, "heightFog", (shader) => {
+            if (!shader.vertexShader.includes("#include <fog_vertex>") || !shader.vertexShader.includes("#include <fog_pars_vertex>")
+                || !shader.fragmentShader.includes("#include <fog_fragment>") || !shader.fragmentShader.includes("#include <fog_pars_fragment>")) {
+                throw new Error("Height fog requires the game material fog shader hooks");
+            }
+            Object.assign(shader.uniforms, this.uniforms);
+            shader.vertexShader = shader.vertexShader.replace("#include <fog_pars_vertex>", `#include <fog_pars_vertex>${VERTEX_DECLARATIONS}`)
+                .replace("#include <fog_vertex>", "#include <fog_vertex>\nvGameHeightFogPosition = (gameHeightFogCameraWorld * mvPosition).xyz;");
+            shader.fragmentShader = shader.fragmentShader.replace("#include <fog_pars_fragment>", `#include <fog_pars_fragment>${FRAGMENT_DECLARATIONS}`)
+                .replace("#include <fog_fragment>", FOG_FRAGMENT);
+        }, ":nodetool-height-fog-1");
+    }
+    restore(material) {
+        removeGameMaterialHook(material, "heightFog");
+        this.materials.delete(material);
+    }
+    dispose() {
+        for (const material of this.materials) {
+            this.restore(material);
+        }
+    }
+}
+//# sourceMappingURL=height-fog.js.map

package/dist/renderer3d/environment/height-fog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"height-fog.js","sourceRoot":"","sources":["../../../src/renderer3d/environment/height-fog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAEnF,qGAAqG;AACrG,MAAM,UAAU,kBAAkB,CAAC,QAAiC,EAAE,KAAkB,EAAE,GAAgB;IACxG,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/E,MAAM,WAAW,GAAG,QAAQ,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACvE,MAAM,OAAO,GAAG,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,GAAG,CAAC,GAAG,WAAW,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,GAAG,WAAW,CAAC;IACpI,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,aAAa,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACzH,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,OAAO,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,OAAO,CAAC,CAAC;IAC9F,OAAO,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,mBAAmB,GAAG;;;CAG3B,CAAC;AACF,MAAM,qBAAqB,GAAG;;;;;;;;;CAS7B,CAAC;AACF,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;CAiBpB,CAAC;AAEF,0GAA0G;AAC1G,MAAM,OAAO,eAAe;IACT,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,QAAQ,GAAG;QAC1B,wBAAwB,EAAE,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE;QACxD,mBAAmB,EAAE,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE;QACnD,sBAAsB,EAAE,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,OAAO,EAAE,EAAE;QACtD,yBAAyB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;QAC3C,oBAAoB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,iBAAiB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;QACnE,oBAAoB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,uBAAuB,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE;KAC1E,CAAC;IAEF,SAAS,CAAC,KAAkB,EAAE,MAAoB,EAAE,QAA6C;QAC/F,IAAI,CAAC,QAAQ,EAAE,CAAC;YAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAAC,OAAO;QAAC,CAAC;QAC1C,IAAI,CAAC,QAAQ,CAAC,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACtE,MAAM,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;QACjE,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC,KAAK,CAAC,CAAC;QACrE,IAAI,CAAC,QAAQ,CAAC,yBAAyB,CAAC,KAAK,GAAG,MAAM,YAAY,KAAK,CAAC,kBAAkB,CAAC;QAC3F,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC;QAC5D,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC;QAC5D,IAAI,CAAC,QAAQ,CAAC,oBAAoB,CAAC,KAAK,GAAG,QAAQ,CAAC,aAAa,CAAC;QAClE,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAAC,KAAK,GAAG,QAAQ,CAAC,UAAU,CAAC;QAClE,MAAM,OAAO,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC1C,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,EAAE;YACxB,IAAI,CAAC,CAAC,MAAM,YAAY,KAAK,CAAC,IAAI,IAAI,MAAM,YAAY,KAAK,CAAC,MAAM,IAAI,MAAM,YAAY,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAAC,OAAO;YAAC,CAAC;YAClH,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACvF,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,IAAI,CAAC,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,QAAQ,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;oBAAC,SAAS;gBAAC,CAAC;gBAChE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;gBACtB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;oBAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAAC,CAAC;YAC/D,CAAC;QACH,CAAC,CAAC,CAAC;QACH,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACtC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,QAAwB;QACrC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC7B,mBAAmB,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE;YACpD,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,uBAAuB,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,4BAA4B,CAAC;mBACpH,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,yBAAyB,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,CAAC;gBACnI,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;YAC5E,CAAC;YACD,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC9C,MAAM,CAAC,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,4BAA4B,EAAE,6BAA6B,mBAAmB,EAAE,CAAC;iBAChI,OAAO,CAAC,uBAAuB,EAAE,8FAA8F,CAAC,CAAC;YACpI,MAAM,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,8BAA8B,EAAE,+BAA+B,qBAAqB,EAAE,CAAC;iBAC1I,OAAO,CAAC,yBAAyB,EAAE,YAAY,CAAC,CAAC;QACtD,CAAC,EAAE,wBAAwB,CAAC,CAAC;IAC/B,CAAC;IAEO,OAAO,CAAC,QAAwB;QACtC,sBAAsB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC9C,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAED,OAAO;QACL,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/renderer3d/environment/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/renderer3d/environment/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,KAAK,CAAC,aAAa,EAAE,WAAW,EAAE,iBAAiB,CAAC,aAAa,CAAC,GAAG,IAAI,CAM5K"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/renderer3d/environment/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,KAAK,CAAC,aAAa,EAAE,WAAW,EAAE,iBAAiB,CAAC,aAAa,CAAC,GAAG,IAAI,CAS5K"}

package/dist/renderer3d/environment/index.js

@@ -1,9 +1,12 @@
 import * as THREE from "three";
 export function configureGameEnvironment(scene, ambient, renderer, environment) {
     scene.background = new THREE.Color(environment.background);
+    scene.backgroundIntensity = 1;
+    scene.backgroundRotation.set(0, 0, 0);
     ambient.color.set(environment.ambient.color);
     ambient.intensity = environment.ambient.intensity;
-    scene.fog = environment.fog ? new THREE.Fog(environment.fog.color, environment.fog.near, environment.fog.far) : null;
+    const fog = environment.fog;
+    scene.fog = !fog ? null : "kind" in fog ? new THREE.FogExp2(fog.color, 0) : new THREE.Fog(fog.color, fog.near, fog.far);
     renderer.shadowMap.enabled = environment.shadows.enabled;
 }
 //# sourceMappingURL=index.js.map

package/dist/renderer3d/environment/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/renderer3d/environment/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,UAAU,wBAAwB,CAAC,KAAkB,EAAE,OAA2B,EAAE,QAA6B,EAAE,WAA6C;IAClK,KAAK,CAAC,UAAU,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAC3D,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7C,OAAO,CAAC,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;IAClD,KAAK,CAAC,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrH,QAAQ,CAAC,SAAS,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC;AAC7D,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/renderer3d/environment/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,UAAU,wBAAwB,CAAC,KAAkB,EAAE,OAA2B,EAAE,QAA6B,EAAE,WAA6C;IAClK,KAAK,CAAC,UAAU,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAC3D,KAAK,CAAC,mBAAmB,GAAG,CAAC,CAAC;IAC9B,KAAK,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACtC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7C,OAAO,CAAC,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;IAClD,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,CAAC;IAC5B,KAAK,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACxH,QAAQ,CAAC,SAAS,CAAC,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC;AAC7D,CAAC"}

package/dist/renderer3d/environment/sky.d.ts

@@ -30,6 +30,7 @@ export declare class GameSkyRenderer3D {
     reset(): void;
     dispose(): void;
     private generator;
+    private detach;
     private clear;
     private applyProcedural;
     /** Renders the sky into the retained cube and PMREM targets, allocating them only on first use. */

package/dist/renderer3d/environment/sky.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sky.d.ts","sourceRoot":"","sources":["../../../src/renderer3d/environment/sky.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEvF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IACtG,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACxC;AAED,KAAK,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC;AAMlE,yGAAyG;AACzG,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,OAAO,CAInH;AAQD,2GAA2G;AAC3G,qBAAa,iBAAiB;IAQhB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAAuB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAClF,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAe,OAAO,CAAC,QAAQ,CAAC,WAAW;IARpE,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,UAAU,CAA4J;IAC9K,OAAO,CAAC,eAAe,CAA6I;IACpK,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiD;IACvE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAE9C,YAA6B,QAAQ,EAAE,KAAK,CAAC,aAAa,EAAmB,OAAO,EAAE,gBAAgB,EACnF,MAAM,EAAE,WAAW,EAAmB,WAAW,EAAE,MAAM,EAAE,EAAI;IAE5E,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAevE;IAED,qEAAqE;IAC/D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO5C;IAED,2GAA2G;IAC3G,KAAK,IAAI,IAAI,CAOZ;IAED,OAAO,IAAI,IAAI,CASd;IAED,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,KAAK;IAWb,OAAO,CAAC,eAAe;IAevB,mGAAmG;IACnG,OAAO,CAAC,gBAAgB;IA8BxB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,QAAQ;YAaF,UAAU;IAoBxB,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,WAAW;CAIpB"}
+{"version":3,"file":"sky.d.ts","sourceRoot":"","sources":["../../../src/renderer3d/environment/sky.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEvF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAAC;IACtG,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACxC;AAED,KAAK,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE;IAAE,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC,CAAC;AAMlE,yGAAyG;AACzG,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,OAAO,CAInH;AAQD,2GAA2G;AAC3G,qBAAa,iBAAiB;IAShB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAAuB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAClF,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAe,OAAO,CAAC,QAAQ,CAAC,WAAW;IATpE,OAAO,CAAC,OAAO,CACqC;IACpD,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,UAAU,CAA4J;IAC9K,OAAO,CAAC,eAAe,CAA6I;IACpK,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiD;IACvE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAE9C,YAA6B,QAAQ,EAAE,KAAK,CAAC,aAAa,EAAmB,OAAO,EAAE,gBAAgB,EACnF,MAAM,EAAE,WAAW,EAAmB,WAAW,EAAE,MAAM,EAAE,EAAI;IAE5E,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBvE;IAED,qEAAqE;IAC/D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM5C;IAED,2GAA2G;IAC3G,KAAK,IAAI,IAAI,CAOZ;IAED,OAAO,IAAI,IAAI,CASd;IAED,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,MAAM;IAiBd,OAAO,CAAC,KAAK;IAKb,OAAO,CAAC,eAAe;IAevB,mGAAmG;IACnG,OAAO,CAAC,gBAAgB;IA8BxB,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,QAAQ;YAaF,UAAU;IAoBxB,OAAO,CAAC,MAAM;IAMd,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,WAAW;CAKpB"}

package/dist/renderer3d/environment/sky.js

@@ -29,6 +29,9 @@ export class GameSkyRenderer3D {
         this.diagnostics = diagnostics;
     }
     async apply(scene, frame) {
+        if (this.applied && this.applied.scene !== scene) {
+            this.detach();
+        }
         const sky = frame.environment.sky;
         if (sky?.kind === "procedural") {
             this.applyProcedural(scene, sky, frame);
@@ -48,7 +51,7 @@ export class GameSkyRenderer3D {
                 return;
             }
         }
-        this.clear(scene);
+        this.clear();
     }
     /** Drops a cached HDRI so the next frame resolves the slot again. */
     async invalidate(slot) {
@@ -59,12 +62,10 @@ export class GameSkyRenderer3D {
         if (loaded) {
             this.releaseHdri(loaded);
         }
-        if (this.applied?.startsWith(`hdri:${slot}:`)) {
-            this.applied = undefined;
-        }
     }
     /** Regenerates GPU-built maps after a context restore. Decoded HDRI pixels are uploaded again by three. */
     reset() {
+        this.detach();
         this.releaseProcedural();
         for (const pending of this.hdris.values()) {
             void pending.then((loaded) => { if (loaded) {
@@ -74,7 +75,6 @@ export class GameSkyRenderer3D {
         this.hdris.clear();
         this.pmrem?.dispose();
         this.pmrem = undefined;
-        this.applied = undefined;
     }
     dispose() {
         this.reset();
@@ -90,18 +90,28 @@ export class GameSkyRenderer3D {
         this.pmrem ??= new THREE.PMREMGenerator(this.renderer);
         return this.pmrem;
     }
-    clear(scene) {
-        if (this.applied === undefined) {
+    detach() {
+        const applied = this.applied;
+        if (!applied) {
             return;
         }
-        scene.environment = null;
-        scene.environmentIntensity = 1;
-        scene.backgroundIntensity = 1;
-        scene.environmentRotation.set(0, 0, 0);
-        scene.backgroundRotation.set(0, 0, 0);
-        this.releaseProcedural();
+        const { scene, background, environment } = applied;
+        if (scene.environment === environment) {
+            scene.environment = null;
+            scene.environmentIntensity = 1;
+            scene.environmentRotation.set(0, 0, 0);
+        }
+        if (scene.background === background) {
+            scene.background = null;
+            scene.backgroundIntensity = 1;
+            scene.backgroundRotation.set(0, 0, 0);
+        }
         this.applied = undefined;
     }
+    clear() {
+        this.detach();
+        this.releaseProcedural();
+    }
     applyProcedural(scene, sky, frame) {
         const sun = gameSkySunDirection3D(sky, frame);
         const key = JSON.stringify([sky.turbidity, sky.rayleigh, sky.groundColor, sun.x, sun.y, sun.z]);
@@ -118,7 +128,7 @@ export class GameSkyRenderer3D {
         scene.backgroundIntensity = sky.intensity;
         scene.environmentRotation.set(0, 0, 0);
         scene.backgroundRotation.set(0, 0, 0);
-        this.applied = "procedural";
+        this.applied = { key: "procedural", scene, background: cube.texture, environment: environment.texture };
     }
     /** Renders the sky into the retained cube and PMREM targets, allocating them only on first use. */
     renderProcedural(key, sky, sun) {
@@ -154,7 +164,7 @@ export class GameSkyRenderer3D {
         this.procedural = { key, cube, camera, environment };
     }
     applyHdri(scene, sky, loaded) {
-        if (this.applied !== `hdri:${sky.assetId}:${loaded.digest}`) {
+        if (this.applied?.key !== `hdri:${sky.assetId}:${loaded.digest}`) {
             this.releaseProcedural();
         }
         scene.background = loaded.texture;
@@ -163,7 +173,7 @@ export class GameSkyRenderer3D {
         scene.backgroundIntensity = sky.intensity;
         scene.environmentRotation.set(0, sky.rotation, 0);
         scene.backgroundRotation.set(0, sky.rotation, 0);
-        this.applied = `hdri:${sky.assetId}:${loaded.digest}`;
+        this.applied = { key: `hdri:${sky.assetId}:${loaded.digest}`, scene, background: loaded.texture, environment: loaded.environment.texture };
     }
     loadHdri(sky) {
         let pending = this.hdris.get(sky.assetId);
@@ -209,11 +219,18 @@ export class GameSkyRenderer3D {
         this.diagnostics.push(message);
     }
     releaseProcedural() {
+        if (this.procedural && (this.applied?.background === this.procedural.cube.texture
+            || this.applied?.environment === this.procedural.environment.texture)) {
+            this.detach();
+        }
         this.procedural?.cube.dispose();
         this.procedural?.environment.dispose();
         this.procedural = undefined;
     }
     releaseHdri(loaded) {
+        if (this.applied?.background === loaded.texture || this.applied?.environment === loaded.environment.texture) {
+            this.detach();
+        }
         loaded.texture.dispose();
         loaded.environment.dispose();
     }