@fps-games/editor 0.2.1-beta.2 → 0.2.1-beta.4

package/node_modules/@fps-games/babylon-renderer/dist/environment/environment-texture-controller.js

@@ -1,79 +1,150 @@
 import { CubeTexture } from '@babylonjs/core/Materials/Textures/cubeTexture.js';
+import { _ENVTextureLoader } from '@babylonjs/core/Materials/Textures/Loaders/envTextureLoader.js';
+import { registerTextureLoader } from '@babylonjs/core/Materials/Textures/Loaders/textureLoaderManager.js';
 import {} from './types.js';
 import { normalizeBabylonEnvironmentTextureProfile } from './profile.js';
-export function createBabylonEnvironmentTextureController(scene, initialProfile, options = {}) {
-    return new BabylonEnvironmentTextureControllerImpl(scene, initialProfile ?? null, options.createTexture ?? createDefaultEnvironmentTexture);
+// Register the framework default during module initialization so single-file
+// bundlers cannot remove Babylon's dynamic .env loader discovery. Applications
+// remain free to register their own .env loader after importing the renderer.
+registerTextureLoader('.env', async () => new _ENVTextureLoader());
+export function readBabylonEnvironmentTextureControllerCleanup(error) {
+    if (!error || (typeof error !== 'object' && typeof error !== 'function'))
+        return null;
+    const cleanup = error
+        .babylonEnvironmentTextureControllerCleanup;
+    return typeof cleanup === 'function'
+        ? cleanup
+        : null;
+}
+export function createBabylonEnvironmentTextureController(scene, options = {}) {
+    return new BabylonEnvironmentTextureControllerImpl(scene, options.createTexture ?? createDefaultEnvironmentTexture);
 }
 class BabylonEnvironmentTextureControllerImpl {
-    constructor(scene, initialProfile, createTexture) {
+    constructor(scene, createTexture) {
         this.scene = scene;
         this.createTexture = createTexture;
         this.profile = null;
         this.texture = null;
-        this.textureUrl = '';
-        this.setProfile(initialProfile);
-    }
-    setProfile(profile) {
-        if (!profile) {
-            this.clearEnvironmentTexture();
-            this.profile = null;
-            return;
-        }
-        const nextProfile = normalizeBabylonEnvironmentTextureProfile(profile);
-        if (!nextProfile.textureUrl) {
-            this.clearEnvironmentTexture();
-            this.profile = nextProfile;
-            this.scene.environmentIntensity = nextProfile.intensity;
-            return;
-        }
-        if (!this.texture || this.textureUrl !== nextProfile.textureUrl) {
-            const previousTexture = this.texture;
-            const nextTexture = this.createEnvironmentTexture(nextProfile.textureUrl);
-            this.texture = nextTexture;
-            this.textureUrl = nextProfile.textureUrl;
-            this.scene.environmentTexture = nextTexture;
-            previousTexture?.dispose();
-        }
-        this.profile = nextProfile;
-        this.scene.environmentIntensity = nextProfile.intensity;
-        if (this.texture) {
-            this.texture.level = nextProfile.intensity;
-            this.texture.rotationY = nextProfile.rotationY;
-            if (this.scene.environmentTexture !== this.texture) {
-                this.scene.environmentTexture = this.texture;
+        this.resource = null;
+        this.generation = 0;
+        this.pendingAbort = null;
+        this.retainedCleanupTextures = new Set();
+        this.pendingSceneClearTexture = null;
+        this.disposeRequested = false;
+        this.disposed = false;
+        this.retryCleanup = () => {
+            const cleanupErrors = [];
+            const pendingSceneTexture = this.pendingSceneClearTexture;
+            if (pendingSceneTexture) {
+                try {
+                    if (this.scene.environmentTexture === pendingSceneTexture) {
+                        this.scene.environmentTexture = null;
+                    }
+                    this.pendingSceneClearTexture = null;
+                }
+                catch (error) {
+                    cleanupErrors.push(sanitizeCause(error));
+                }
             }
-        }
+            for (const texture of [...this.retainedCleanupTextures]) {
+                try {
+                    texture.dispose();
+                    this.retainedCleanupTextures.delete(texture);
+                }
+                catch (error) {
+                    cleanupErrors.push(sanitizeCause(error));
+                }
+            }
+            return Object.freeze(cleanupErrors);
+        };
     }
-    async setProfileAsync(profile, signal) {
+    async applyProfile(profile, signal) {
+        this.assertNotDisposed();
         if (signal?.aborted)
             throw createEnvironmentTextureAbortError();
-        if (!profile) {
-            this.setProfile(profile);
-            return;
-        }
-        const nextProfile = normalizeBabylonEnvironmentTextureProfile(profile);
-        if (!nextProfile.textureUrl || (this.texture && this.textureUrl === nextProfile.textureUrl)) {
-            this.setProfile(nextProfile);
-            return;
-        }
-        const nextTexture = await this.createEnvironmentTextureAsync(nextProfile.textureUrl, signal);
-        if (signal?.aborted) {
-            throwCandidateTextureFailure(nextTexture, createEnvironmentTextureAbortError());
+        const retainedCleanupErrors = this.retryCleanup();
+        if (retainedCleanupErrors.length > 0) {
+            throw createEnvironmentTextureCleanupFailure(retainedCleanupErrors, this.retryCleanup);
         }
+        const generation = ++this.generation;
+        this.pendingAbort?.abort();
+        const candidateAbort = new AbortController();
+        this.pendingAbort = candidateAbort;
+        const removeSignalListener = forwardAbort(signal, candidateAbort);
+        const isCurrent = () => !this.disposed && this.generation === generation && !candidateAbort.signal.aborted;
         try {
-            nextTexture.level = nextProfile.intensity;
-            nextTexture.rotationY = nextProfile.rotationY;
+            const nextProfile = profile ? normalizeBabylonEnvironmentTextureProfile(profile) : null;
+            if (!nextProfile?.texture) {
+                if (!isCurrent())
+                    throw createEnvironmentTextureAbortError();
+                const previousTexture = this.texture;
+                const previousSceneTexture = this.scene.environmentTexture;
+                const sceneWithIntensity = this.scene;
+                const previousIntensity = sceneWithIntensity.environmentIntensity;
+                try {
+                    if (previousTexture && previousSceneTexture === previousTexture) {
+                        this.scene.environmentTexture = null;
+                    }
+                    if (nextProfile)
+                        sceneWithIntensity.environmentIntensity = nextProfile.intensity;
+                }
+                catch (error) {
+                    restoreSceneState(this.scene, previousSceneTexture, previousIntensity);
+                    throw createSafeEnvironmentTextureError('babylon.environment-texture.profile-failed', 'Failed to apply Babylon environment texture profile.', error);
+                }
+                this.texture = null;
+                this.resource = null;
+                this.profile = nextProfile;
+                const cleanupError = this.disposeTextureOrRetain(previousTexture);
+                if (cleanupError) {
+                    throw createEnvironmentTextureCleanupFailure([cleanupError], this.retryCleanup);
+                }
+                return;
+            }
+            if (this.texture && sameResource(this.resource, nextProfile.texture)) {
+                if (!isCurrent())
+                    throw createEnvironmentTextureAbortError();
+                this.applyCommittedTextureProfile(this.texture, nextProfile);
+                this.profile = nextProfile;
+                this.resource = nextProfile.texture;
+                return;
+            }
+            const candidate = await this.createEnvironmentTextureAsync(nextProfile.texture, candidateAbort.signal);
+            if (!isCurrent())
+                this.throwCandidateTextureFailure(candidate, createEnvironmentTextureAbortError());
+            try {
+                applyCandidateTextureProperties(candidate, nextProfile);
+            }
+            catch (error) {
+                this.throwCandidateTextureFailure(candidate, createSafeEnvironmentTextureError('babylon.environment-texture.profile-failed', 'Failed to apply Babylon environment texture profile.', error));
+            }
+            if (!isCurrent())
+                this.throwCandidateTextureFailure(candidate, createEnvironmentTextureAbortError());
+            const previousTexture = this.texture;
+            const previousSceneTexture = this.scene.environmentTexture;
+            const sceneWithIntensity = this.scene;
+            const previousIntensity = sceneWithIntensity.environmentIntensity;
+            try {
+                this.scene.environmentTexture = candidate;
+                sceneWithIntensity.environmentIntensity = nextProfile.intensity;
+            }
+            catch (error) {
+                restoreSceneState(this.scene, previousSceneTexture, previousIntensity);
+                this.throwCandidateTextureFailure(candidate, createSafeEnvironmentTextureError('babylon.environment-texture.profile-failed', 'Failed to apply Babylon environment texture profile.', error));
+            }
+            this.texture = candidate;
+            this.resource = nextProfile.texture;
+            this.profile = nextProfile;
+            const cleanupError = this.disposeTextureOrRetain(previousTexture);
+            if (cleanupError) {
+                throw createEnvironmentTextureCleanupFailure([cleanupError], this.retryCleanup);
+            }
         }
-        catch (cause) {
-            throwCandidateTextureFailure(nextTexture, cause);
+        finally {
+            removeSignalListener();
+            if (this.pendingAbort === candidateAbort)
+                this.pendingAbort = null;
         }
-        const previousTexture = this.texture;
-        this.texture = nextTexture;
-        this.textureUrl = nextProfile.textureUrl;
-        this.profile = nextProfile;
-        this.scene.environmentTexture = nextTexture;
-        this.scene.environmentIntensity = nextProfile.intensity;
-        previousTexture?.dispose();
     }
     getProfile() {
         return this.profile ? { ...this.profile } : null;
@@ -82,107 +153,216 @@ class BabylonEnvironmentTextureControllerImpl {
         return this.texture;
     }
     dispose() {
-        this.clearEnvironmentTexture();
-        this.profile = null;
-    }
-    clearEnvironmentTexture() {
-        if (this.texture && this.scene.environmentTexture === this.texture) {
-            this.scene.environmentTexture = null;
+        if (this.disposed)
+            return;
+        if (!this.disposeRequested) {
+            this.disposeRequested = true;
+            this.generation += 1;
+            this.pendingAbort?.abort();
+            this.pendingAbort = null;
+            const texture = this.texture;
+            if (texture) {
+                this.retainedCleanupTextures.add(texture);
+                if (this.scene.environmentTexture === texture) {
+                    this.pendingSceneClearTexture = texture;
+                }
+            }
+            this.texture = null;
+            this.resource = null;
+            this.profile = null;
         }
-        this.texture?.dispose();
-        this.texture = null;
-        this.textureUrl = '';
+        const cleanupErrors = this.retryCleanup();
+        if (cleanupErrors.length > 0) {
+            throw createEnvironmentTextureCleanupFailure(cleanupErrors, this.retryCleanup);
+        }
+        this.disposed = true;
     }
-    createEnvironmentTexture(textureUrl) {
+    applyCommittedTextureProfile(texture, profile) {
+        const textureWithRotation = texture;
+        const sceneWithIntensity = this.scene;
+        const previousLevel = texture.level;
+        const previousRotation = textureWithRotation.rotationY;
+        const previousSceneTexture = this.scene.environmentTexture;
+        const previousIntensity = sceneWithIntensity.environmentIntensity;
         try {
-            const texture = this.createTexture(textureUrl, this.scene);
-            return texture;
+            applyCandidateTextureProperties(texture, profile);
+            if (previousSceneTexture !== texture)
+                this.scene.environmentTexture = texture;
+            sceneWithIntensity.environmentIntensity = profile.intensity;
         }
-        catch (cause) {
-            throw Object.assign(new Error(`Failed to create Babylon environment texture: ${textureUrl}`), { cause });
+        catch (error) {
+            restoreTextureProperties(texture, previousLevel, previousRotation);
+            restoreSceneState(this.scene, previousSceneTexture, previousIntensity);
+            throw createSafeEnvironmentTextureError('babylon.environment-texture.profile-failed', 'Failed to apply Babylon environment texture profile.', error);
         }
     }
-    async createEnvironmentTextureAsync(textureUrl, signal) {
+    createEnvironmentTextureAsync(resource, signal) {
         return new Promise((resolve, reject) => {
+            if (signal.aborted) {
+                reject(createEnvironmentTextureAbortError());
+                return;
+            }
             let settled = false;
             let texture = null;
             let loaded = false;
-            let pendingError = null;
-            const removeAbortListener = () => signal?.removeEventListener('abort', abort);
-            const fail = (message, exception) => {
+            let pendingFailure = null;
+            const settleFailure = (failure) => {
                 if (settled)
                     return;
                 if (!texture) {
-                    pendingError = { message, exception };
+                    pendingFailure = failure;
                     return;
                 }
                 settled = true;
-                removeAbortListener();
-                let cleanupError;
-                try {
-                    texture.dispose();
-                }
-                catch (error) {
-                    cleanupError = error;
-                }
-                reject(Object.assign(new Error(message || `Failed to load Babylon environment texture: ${textureUrl}`), { cause: exception, ...(cleanupError === undefined ? {} : { cleanupError }) }));
+                signal.removeEventListener('abort', abort);
+                const cleanupError = this.disposeTextureOrRetain(texture);
+                reject(withCleanupError(failure, cleanupError, this.retryCleanup));
             };
             const complete = () => {
-                if (settled)
-                    return;
-                loaded = true;
-                if (!texture)
+                if (settled || !texture) {
+                    loaded = true;
                     return;
+                }
                 settled = true;
-                removeAbortListener();
+                signal.removeEventListener('abort', abort);
                 resolve(texture);
             };
-            const abort = () => fail('Babylon environment texture load aborted.', createEnvironmentTextureAbortError());
-            signal?.addEventListener('abort', abort, { once: true });
+            const abort = () => settleFailure(createEnvironmentTextureAbortError());
+            const fail = (_message, exception) => {
+                settleFailure(createSafeEnvironmentTextureError('babylon.environment-texture.load-failed', 'Failed to load Babylon environment texture.', exception));
+            };
+            signal.addEventListener('abort', abort, { once: true });
             try {
-                texture = this.createTexture(textureUrl, this.scene, {
-                    onLoad: complete,
-                    onError: fail,
-                });
+                texture = this.createTexture(resource, this.scene, { onLoad: complete, onError: fail });
             }
-            catch (cause) {
+            catch (error) {
                 settled = true;
-                removeAbortListener();
-                reject(Object.assign(new Error(`Failed to create Babylon environment texture: ${textureUrl}`), { cause }));
+                signal.removeEventListener('abort', abort);
+                reject(createSafeEnvironmentTextureError('babylon.environment-texture.create-failed', 'Failed to create Babylon environment texture.', error));
                 return;
             }
-            const synchronousError = pendingError;
-            if (synchronousError) {
-                fail(synchronousError.message, synchronousError.exception);
-            }
-            else if (loaded || texture.isReady()) {
+            if (pendingFailure)
+                settleFailure(pendingFailure);
+            else if (loaded || texture.isReady())
                 complete();
-            }
         });
     }
+    assertNotDisposed() {
+        if (this.disposed || this.disposeRequested) {
+            throw new Error('Babylon environment texture controller is disposed.');
+        }
+    }
+    disposeTextureOrRetain(texture) {
+        if (!texture)
+            return null;
+        this.retainedCleanupTextures.add(texture);
+        try {
+            texture.dispose();
+            this.retainedCleanupTextures.delete(texture);
+            return null;
+        }
+        catch (error) {
+            return sanitizeCause(error);
+        }
+    }
+    throwCandidateTextureFailure(texture, failure) {
+        const cleanupError = this.disposeTextureOrRetain(texture);
+        throw withCleanupError(failure, cleanupError, this.retryCleanup);
+    }
+}
+function applyCandidateTextureProperties(texture, profile) {
+    texture.level = profile.intensity;
+    texture.rotationY = profile.rotationY;
+}
+function restoreTextureProperties(texture, level, rotationY) {
+    try {
+        texture.level = level;
+    }
+    catch {
+        // Best-effort rollback keeps the original operation error as the public diagnostic.
+    }
+    try {
+        texture.rotationY = rotationY;
+    }
+    catch {
+        // Best-effort rollback keeps the original operation error as the public diagnostic.
+    }
+}
+function restoreSceneState(scene, environmentTexture, environmentIntensity) {
+    try {
+        scene.environmentTexture = environmentTexture;
+    }
+    catch {
+        // Best-effort rollback keeps the original operation error as the public diagnostic.
+    }
+    try {
+        scene.environmentIntensity = environmentIntensity;
+    }
+    catch {
+        // Best-effort rollback keeps the original operation error as the public diagnostic.
+    }
+}
+function forwardAbort(signal, controller) {
+    if (!signal)
+        return () => undefined;
+    const onAbort = () => controller.abort();
+    signal.addEventListener('abort', onAbort, { once: true });
+    if (signal.aborted)
+        controller.abort();
+    return () => signal.removeEventListener('abort', onAbort);
+}
+function sameResource(left, right) {
+    return left?.assetId === right.assetId
+        && left?.url === right.url
+        && left?.format === right.format;
 }
 function createEnvironmentTextureAbortError() {
-    return Object.assign(new Error('Babylon environment texture load aborted.'), { name: 'AbortError' });
+    return Object.assign(new Error('Babylon environment texture update aborted.'), { name: 'AbortError' });
+}
+function createSafeEnvironmentTextureError(code, message, cause) {
+    const error = Object.assign(new Error(message), { code });
+    if (cause !== undefined) {
+        Object.assign(error, { cause: sanitizeCause(cause) });
+    }
+    return error;
+}
+function sanitizeCause(cause) {
+    const message = cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');
+    return new Error(message.replace(/(?:data|blob):[^\s)]+/giu, '[redacted-resource-url]'));
+}
+function withCleanupError(failure, cleanupError, retryCleanup) {
+    const result = failure instanceof Error ? failure : new Error('Babylon environment texture operation failed.');
+    if (cleanupError) {
+        attachEnvironmentTextureCleanup(result, [cleanupError], retryCleanup);
+    }
+    return result;
+}
+function createEnvironmentTextureCleanupFailure(cleanupErrors, retryCleanup) {
+    return attachEnvironmentTextureCleanup(Object.assign(new Error('Failed to dispose Babylon environment texture resources.'), { code: 'babylon.environment-texture.dispose-failed' }), cleanupErrors, retryCleanup);
 }
-function throwCandidateTextureFailure(texture, failure) {
-    let cleanupError;
+function attachEnvironmentTextureCleanup(failure, cleanupErrors, retryCleanup) {
+    const safeErrors = Object.freeze(cleanupErrors.map(sanitizeCause));
+    const metadata = {
+        cleanupError: safeErrors[0],
+        cleanupErrors: safeErrors,
+        babylonEnvironmentTextureControllerCleanup: retryCleanup,
+        retryCleanup,
+    };
     try {
-        texture.dispose();
+        Object.assign(failure, metadata);
+        if (readBabylonEnvironmentTextureControllerCleanup(failure) === retryCleanup)
+            return failure;
     }
-    catch (error) {
-        cleanupError = error;
+    catch {
+        // Wrap non-extensible primary failures so the owning cleanup remains reachable.
     }
-    const result = failure && typeof failure === 'object'
-        ? failure
-        : Object.assign(new Error(String(failure)), { cause: failure });
-    if (cleanupError !== undefined)
-        Object.assign(result, { cleanupError });
-    throw result;
+    return Object.assign(new Error(failure.message), { cause: failure, ...metadata });
 }
-function createDefaultEnvironmentTexture(textureUrl, scene, callbacks = {}) {
-    return new CubeTexture(textureUrl, scene, {
+function createDefaultEnvironmentTexture(resource, scene, callbacks = {}) {
+    return new CubeTexture(resource.url, scene, {
         prefiltered: true,
         createPolynomials: true,
+        forcedExtension: resource.format,
         onLoad: callbacks.onLoad,
         onError: callbacks.onError,
     });

package/node_modules/@fps-games/babylon-renderer/dist/environment/environment-texture-controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"environment-texture-controller.js","sourceRoot":"","sources":["../../src/environment/environment-texture-controller.ts"],"names":[],"mappings":"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","sourcesContent":["import { CubeTexture } from '@babylonjs/core/Materials/Textures/cubeTexture.js';\nimport type { Scene } from '@babylonjs/core/scene.js';\nimport {\n  type BabylonEnvironmentTextureController,\n  type BabylonEnvironmentTextureControllerOptions,\n  type BabylonEnvironmentTextureFactory,\n  type BabylonEnvironmentTextureProfile,\n} from './types.js';\nimport { normalizeBabylonEnvironmentTextureProfile } from './profile.js';\n\nexport function createBabylonEnvironmentTextureController(\n  scene: Scene,\n  initialProfile?: BabylonEnvironmentTextureProfile | null,\n  options: BabylonEnvironmentTextureControllerOptions = {},\n): BabylonEnvironmentTextureController {\n  return new BabylonEnvironmentTextureControllerImpl(\n    scene,\n    initialProfile ?? null,\n    options.createTexture ?? createDefaultEnvironmentTexture,\n  );\n}\n\nclass BabylonEnvironmentTextureControllerImpl implements BabylonEnvironmentTextureController {\n  private profile: BabylonEnvironmentTextureProfile | null = null;\n  private texture: CubeTexture | null = null;\n  private textureUrl = '';\n\n  constructor(\n    private readonly scene: Scene,\n    initialProfile: BabylonEnvironmentTextureProfile | null,\n    private readonly createTexture: BabylonEnvironmentTextureFactory,\n  ) {\n    this.setProfile(initialProfile);\n  }\n\n  setProfile(profile: BabylonEnvironmentTextureProfile | null | undefined): void {\n    if (!profile) {\n      this.clearEnvironmentTexture();\n      this.profile = null;\n      return;\n    }\n\n    const nextProfile = normalizeBabylonEnvironmentTextureProfile(profile);\n    if (!nextProfile.textureUrl) {\n      this.clearEnvironmentTexture();\n      this.profile = nextProfile;\n      (this.scene as unknown as { environmentIntensity?: number }).environmentIntensity = nextProfile.intensity;\n      return;\n    }\n\n    if (!this.texture || this.textureUrl !== nextProfile.textureUrl) {\n      const previousTexture = this.texture;\n      const nextTexture = this.createEnvironmentTexture(nextProfile.textureUrl);\n      this.texture = nextTexture;\n      this.textureUrl = nextProfile.textureUrl;\n      this.scene.environmentTexture = nextTexture;\n      previousTexture?.dispose();\n    }\n\n    this.profile = nextProfile;\n    (this.scene as unknown as { environmentIntensity?: number }).environmentIntensity = nextProfile.intensity;\n    if (this.texture) {\n      this.texture.level = nextProfile.intensity;\n      (this.texture as unknown as { rotationY?: number }).rotationY = nextProfile.rotationY;\n      if (this.scene.environmentTexture !== this.texture) {\n        this.scene.environmentTexture = this.texture;\n      }\n    }\n  }\n\n  async setProfileAsync(\n    profile: BabylonEnvironmentTextureProfile | null | undefined,\n    signal?: AbortSignal,\n  ): Promise<void> {\n    if (signal?.aborted) throw createEnvironmentTextureAbortError();\n    if (!profile) {\n      this.setProfile(profile);\n      return;\n    }\n    const nextProfile = normalizeBabylonEnvironmentTextureProfile(profile);\n    if (!nextProfile.textureUrl || (this.texture && this.textureUrl === nextProfile.textureUrl)) {\n      this.setProfile(nextProfile);\n      return;\n    }\n\n    const nextTexture = await this.createEnvironmentTextureAsync(nextProfile.textureUrl, signal);\n    if (signal?.aborted) {\n      throwCandidateTextureFailure(nextTexture, createEnvironmentTextureAbortError());\n    }\n    try {\n      nextTexture.level = nextProfile.intensity;\n      (nextTexture as unknown as { rotationY?: number }).rotationY = nextProfile.rotationY;\n    } catch (cause) {\n      throwCandidateTextureFailure(nextTexture, cause);\n    }\n    const previousTexture = this.texture;\n    this.texture = nextTexture;\n    this.textureUrl = nextProfile.textureUrl;\n    this.profile = nextProfile;\n    this.scene.environmentTexture = nextTexture;\n    (this.scene as unknown as { environmentIntensity?: number }).environmentIntensity = nextProfile.intensity;\n    previousTexture?.dispose();\n  }\n\n  getProfile(): BabylonEnvironmentTextureProfile | null {\n    return this.profile ? { ...this.profile } : null;\n  }\n\n  getTexture(): CubeTexture | null {\n    return this.texture;\n  }\n\n  dispose(): void {\n    this.clearEnvironmentTexture();\n    this.profile = null;\n  }\n\n  private clearEnvironmentTexture(): void {\n    if (this.texture && this.scene.environmentTexture === this.texture) {\n      this.scene.environmentTexture = null;\n    }\n    this.texture?.dispose();\n    this.texture = null;\n    this.textureUrl = '';\n  }\n\n  private createEnvironmentTexture(textureUrl: string): CubeTexture {\n    try {\n      const texture = this.createTexture(textureUrl, this.scene);\n      return texture;\n    } catch (cause) {\n      throw Object.assign(\n        new Error(`Failed to create Babylon environment texture: ${textureUrl}`),\n        { cause },\n      );\n    }\n  }\n\n  private async createEnvironmentTextureAsync(\n    textureUrl: string,\n    signal?: AbortSignal,\n  ): Promise<CubeTexture> {\n    return new Promise<CubeTexture>((resolve, reject) => {\n      let settled = false;\n      let texture: CubeTexture | null = null;\n      let loaded = false;\n      let pendingError: { message?: string; exception?: unknown } | null = null;\n      const removeAbortListener = (): void => signal?.removeEventListener('abort', abort);\n      const fail = (message?: string, exception?: unknown): void => {\n        if (settled) return;\n        if (!texture) {\n          pendingError = { message, exception };\n          return;\n        }\n        settled = true;\n        removeAbortListener();\n        let cleanupError: unknown;\n        try { texture.dispose(); } catch (error) { cleanupError = error; }\n        reject(Object.assign(\n          new Error(message || `Failed to load Babylon environment texture: ${textureUrl}`),\n          { cause: exception, ...(cleanupError === undefined ? {} : { cleanupError }) },\n        ));\n      };\n      const complete = (): void => {\n        if (settled) return;\n        loaded = true;\n        if (!texture) return;\n        settled = true;\n        removeAbortListener();\n        resolve(texture);\n      };\n      const abort = (): void => fail('Babylon environment texture load aborted.', createEnvironmentTextureAbortError());\n      signal?.addEventListener('abort', abort, { once: true });\n      try {\n        texture = this.createTexture(textureUrl, this.scene, {\n          onLoad: complete,\n          onError: fail,\n        });\n      } catch (cause) {\n        settled = true;\n        removeAbortListener();\n        reject(Object.assign(\n          new Error(`Failed to create Babylon environment texture: ${textureUrl}`),\n          { cause },\n        ));\n        return;\n      }\n      const synchronousError = pendingError as { message?: string; exception?: unknown } | null;\n      if (synchronousError) {\n        fail(synchronousError.message, synchronousError.exception);\n      } else if (loaded || texture.isReady()) {\n        complete();\n      }\n    });\n  }\n}\n\nfunction createEnvironmentTextureAbortError(): Error {\n  return Object.assign(new Error('Babylon environment texture load aborted.'), { name: 'AbortError' });\n}\n\nfunction throwCandidateTextureFailure(texture: CubeTexture, failure: unknown): never {\n  let cleanupError: unknown;\n  try { texture.dispose(); } catch (error) { cleanupError = error; }\n  const result = failure && typeof failure === 'object'\n    ? failure\n    : Object.assign(new Error(String(failure)), { cause: failure });\n  if (cleanupError !== undefined) Object.assign(result, { cleanupError });\n  throw result;\n}\n\nfunction createDefaultEnvironmentTexture(\n  textureUrl: string,\n  scene: Scene,\n  callbacks: Parameters<BabylonEnvironmentTextureFactory>[2] = {},\n): CubeTexture {\n  return new CubeTexture(textureUrl, scene, {\n    prefiltered: true,\n    createPolynomials: true,\n    onLoad: callbacks.onLoad,\n    onError: callbacks.onError,\n  });\n}\n"]}
+{"version":3,"file":"environment-texture-controller.js","sourceRoot":"","sources":["../../src/environment/environment-texture-controller.ts"],"names":[],"mappings":"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","sourcesContent":["import { CubeTexture } from '@babylonjs/core/Materials/Textures/cubeTexture.js';\nimport { _ENVTextureLoader } from '@babylonjs/core/Materials/Textures/Loaders/envTextureLoader.js';\nimport { registerTextureLoader } from '@babylonjs/core/Materials/Textures/Loaders/textureLoaderManager.js';\nimport type { Scene } from '@babylonjs/core/scene.js';\nimport type { PlayableResolvedAssetResource } from '@fps-games/playable-assets';\nimport {\n  type BabylonEnvironmentTextureController,\n  type BabylonEnvironmentTextureControllerOptions,\n  type BabylonEnvironmentTextureFactory,\n  type BabylonEnvironmentTextureLoadCallbacks,\n  type BabylonEnvironmentTextureProfile,\n} from './types.js';\nimport { normalizeBabylonEnvironmentTextureProfile } from './profile.js';\n\n// Register the framework default during module initialization so single-file\n// bundlers cannot remove Babylon's dynamic .env loader discovery. Applications\n// remain free to register their own .env loader after importing the renderer.\nregisterTextureLoader('.env', async () => new _ENVTextureLoader());\n\nexport type BabylonEnvironmentTextureControllerCleanup = () => readonly unknown[];\n\nexport function readBabylonEnvironmentTextureControllerCleanup(\n  error: unknown,\n): BabylonEnvironmentTextureControllerCleanup | null {\n  if (!error || (typeof error !== 'object' && typeof error !== 'function')) return null;\n  const cleanup = (error as { babylonEnvironmentTextureControllerCleanup?: unknown })\n    .babylonEnvironmentTextureControllerCleanup;\n  return typeof cleanup === 'function'\n    ? cleanup as BabylonEnvironmentTextureControllerCleanup\n    : null;\n}\n\nexport function createBabylonEnvironmentTextureController(\n  scene: Scene,\n  options: BabylonEnvironmentTextureControllerOptions = {},\n): BabylonEnvironmentTextureController {\n  return new BabylonEnvironmentTextureControllerImpl(\n    scene,\n    options.createTexture ?? createDefaultEnvironmentTexture,\n  );\n}\n\nclass BabylonEnvironmentTextureControllerImpl implements BabylonEnvironmentTextureController {\n  private profile: BabylonEnvironmentTextureProfile | null = null;\n  private texture: CubeTexture | null = null;\n  private resource: PlayableResolvedAssetResource | null = null;\n  private generation = 0;\n  private pendingAbort: AbortController | null = null;\n  private readonly retainedCleanupTextures = new Set<CubeTexture>();\n  private pendingSceneClearTexture: CubeTexture | null = null;\n  private disposeRequested = false;\n  private disposed = false;\n  private readonly retryCleanup: BabylonEnvironmentTextureControllerCleanup = () => {\n    const cleanupErrors: unknown[] = [];\n    const pendingSceneTexture = this.pendingSceneClearTexture;\n    if (pendingSceneTexture) {\n      try {\n        if (this.scene.environmentTexture === pendingSceneTexture) {\n          this.scene.environmentTexture = null;\n        }\n        this.pendingSceneClearTexture = null;\n      } catch (error) {\n        cleanupErrors.push(sanitizeCause(error));\n      }\n    }\n    for (const texture of [...this.retainedCleanupTextures]) {\n      try {\n        texture.dispose();\n        this.retainedCleanupTextures.delete(texture);\n      } catch (error) {\n        cleanupErrors.push(sanitizeCause(error));\n      }\n    }\n    return Object.freeze(cleanupErrors);\n  };\n\n  constructor(\n    private readonly scene: Scene,\n    private readonly createTexture: BabylonEnvironmentTextureFactory,\n  ) {}\n\n  async applyProfile(\n    profile: BabylonEnvironmentTextureProfile | null,\n    signal?: AbortSignal,\n  ): Promise<void> {\n    this.assertNotDisposed();\n    if (signal?.aborted) throw createEnvironmentTextureAbortError();\n    const retainedCleanupErrors = this.retryCleanup();\n    if (retainedCleanupErrors.length > 0) {\n      throw createEnvironmentTextureCleanupFailure(retainedCleanupErrors, this.retryCleanup);\n    }\n\n    const generation = ++this.generation;\n    this.pendingAbort?.abort();\n    const candidateAbort = new AbortController();\n    this.pendingAbort = candidateAbort;\n    const removeSignalListener = forwardAbort(signal, candidateAbort);\n    const isCurrent = (): boolean => !this.disposed && this.generation === generation && !candidateAbort.signal.aborted;\n\n    try {\n      const nextProfile = profile ? normalizeBabylonEnvironmentTextureProfile(profile) : null;\n      if (!nextProfile?.texture) {\n        if (!isCurrent()) throw createEnvironmentTextureAbortError();\n        const previousTexture = this.texture;\n        const previousSceneTexture = this.scene.environmentTexture;\n        const sceneWithIntensity = this.scene as unknown as { environmentIntensity?: number };\n        const previousIntensity = sceneWithIntensity.environmentIntensity;\n        try {\n          if (previousTexture && previousSceneTexture === previousTexture) {\n            this.scene.environmentTexture = null;\n          }\n          if (nextProfile) sceneWithIntensity.environmentIntensity = nextProfile.intensity;\n        } catch (error) {\n          restoreSceneState(this.scene, previousSceneTexture, previousIntensity);\n          throw createSafeEnvironmentTextureError(\n            'babylon.environment-texture.profile-failed',\n            'Failed to apply Babylon environment texture profile.',\n            error,\n          );\n        }\n        this.texture = null;\n        this.resource = null;\n        this.profile = nextProfile;\n        const cleanupError = this.disposeTextureOrRetain(previousTexture);\n        if (cleanupError) {\n          throw createEnvironmentTextureCleanupFailure([cleanupError], this.retryCleanup);\n        }\n        return;\n      }\n\n      if (this.texture && sameResource(this.resource, nextProfile.texture)) {\n        if (!isCurrent()) throw createEnvironmentTextureAbortError();\n        this.applyCommittedTextureProfile(this.texture, nextProfile);\n        this.profile = nextProfile;\n        this.resource = nextProfile.texture;\n        return;\n      }\n\n      const candidate = await this.createEnvironmentTextureAsync(nextProfile.texture, candidateAbort.signal);\n      if (!isCurrent()) this.throwCandidateTextureFailure(candidate, createEnvironmentTextureAbortError());\n      try {\n        applyCandidateTextureProperties(candidate, nextProfile);\n      } catch (error) {\n        this.throwCandidateTextureFailure(candidate, createSafeEnvironmentTextureError('babylon.environment-texture.profile-failed', 'Failed to apply Babylon environment texture profile.', error));\n      }\n      if (!isCurrent()) this.throwCandidateTextureFailure(candidate, createEnvironmentTextureAbortError());\n\n      const previousTexture = this.texture;\n      const previousSceneTexture = this.scene.environmentTexture;\n      const sceneWithIntensity = this.scene as unknown as { environmentIntensity?: number };\n      const previousIntensity = sceneWithIntensity.environmentIntensity;\n      try {\n        this.scene.environmentTexture = candidate;\n        sceneWithIntensity.environmentIntensity = nextProfile.intensity;\n      } catch (error) {\n        restoreSceneState(this.scene, previousSceneTexture, previousIntensity);\n        this.throwCandidateTextureFailure(candidate, createSafeEnvironmentTextureError(\n          'babylon.environment-texture.profile-failed',\n          'Failed to apply Babylon environment texture profile.',\n          error,\n        ));\n      }\n      this.texture = candidate;\n      this.resource = nextProfile.texture;\n      this.profile = nextProfile;\n      const cleanupError = this.disposeTextureOrRetain(previousTexture);\n      if (cleanupError) {\n        throw createEnvironmentTextureCleanupFailure([cleanupError], this.retryCleanup);\n      }\n    } finally {\n      removeSignalListener();\n      if (this.pendingAbort === candidateAbort) this.pendingAbort = null;\n    }\n  }\n\n  getProfile(): BabylonEnvironmentTextureProfile | null {\n    return this.profile ? { ...this.profile } : null;\n  }\n\n  getTexture(): CubeTexture | null {\n    return this.texture;\n  }\n\n  dispose(): void {\n    if (this.disposed) return;\n    if (!this.disposeRequested) {\n      this.disposeRequested = true;\n      this.generation += 1;\n      this.pendingAbort?.abort();\n      this.pendingAbort = null;\n      const texture = this.texture;\n      if (texture) {\n        this.retainedCleanupTextures.add(texture);\n        if (this.scene.environmentTexture === texture) {\n          this.pendingSceneClearTexture = texture;\n        }\n      }\n      this.texture = null;\n      this.resource = null;\n      this.profile = null;\n    }\n    const cleanupErrors = this.retryCleanup();\n    if (cleanupErrors.length > 0) {\n      throw createEnvironmentTextureCleanupFailure(cleanupErrors, this.retryCleanup);\n    }\n    this.disposed = true;\n  }\n\n  private applyCommittedTextureProfile(texture: CubeTexture, profile: BabylonEnvironmentTextureProfile): void {\n    const textureWithRotation = texture as unknown as { rotationY?: number };\n    const sceneWithIntensity = this.scene as unknown as { environmentIntensity?: number };\n    const previousLevel = texture.level;\n    const previousRotation = textureWithRotation.rotationY;\n    const previousSceneTexture = this.scene.environmentTexture;\n    const previousIntensity = sceneWithIntensity.environmentIntensity;\n    try {\n      applyCandidateTextureProperties(texture, profile);\n      if (previousSceneTexture !== texture) this.scene.environmentTexture = texture;\n      sceneWithIntensity.environmentIntensity = profile.intensity;\n    } catch (error) {\n      restoreTextureProperties(texture, previousLevel, previousRotation);\n      restoreSceneState(this.scene, previousSceneTexture, previousIntensity);\n      throw createSafeEnvironmentTextureError(\n        'babylon.environment-texture.profile-failed',\n        'Failed to apply Babylon environment texture profile.',\n        error,\n      );\n    }\n  }\n\n  private createEnvironmentTextureAsync(\n    resource: PlayableResolvedAssetResource,\n    signal: AbortSignal,\n  ): Promise<CubeTexture> {\n    return new Promise<CubeTexture>((resolve, reject) => {\n      if (signal.aborted) {\n        reject(createEnvironmentTextureAbortError());\n        return;\n      }\n      let settled = false;\n      let texture: CubeTexture | null = null;\n      let loaded = false;\n      let pendingFailure: unknown = null;\n\n      const settleFailure = (failure: unknown): void => {\n        if (settled) return;\n        if (!texture) {\n          pendingFailure = failure;\n          return;\n        }\n        settled = true;\n        signal.removeEventListener('abort', abort);\n        const cleanupError = this.disposeTextureOrRetain(texture);\n        reject(withCleanupError(failure, cleanupError, this.retryCleanup));\n      };\n      const complete = (): void => {\n        if (settled || !texture) {\n          loaded = true;\n          return;\n        }\n        settled = true;\n        signal.removeEventListener('abort', abort);\n        resolve(texture);\n      };\n      const abort = (): void => settleFailure(createEnvironmentTextureAbortError());\n      const fail = (_message?: string, exception?: unknown): void => {\n        settleFailure(createSafeEnvironmentTextureError(\n          'babylon.environment-texture.load-failed',\n          'Failed to load Babylon environment texture.',\n          exception,\n        ));\n      };\n\n      signal.addEventListener('abort', abort, { once: true });\n      try {\n        texture = this.createTexture(resource, this.scene, { onLoad: complete, onError: fail });\n      } catch (error) {\n        settled = true;\n        signal.removeEventListener('abort', abort);\n        reject(createSafeEnvironmentTextureError(\n          'babylon.environment-texture.create-failed',\n          'Failed to create Babylon environment texture.',\n          error,\n        ));\n        return;\n      }\n\n      if (pendingFailure) settleFailure(pendingFailure);\n      else if (loaded || texture.isReady()) complete();\n    });\n  }\n\n  private assertNotDisposed(): void {\n    if (this.disposed || this.disposeRequested) {\n      throw new Error('Babylon environment texture controller is disposed.');\n    }\n  }\n\n  private disposeTextureOrRetain(texture: CubeTexture | null): Error | null {\n    if (!texture) return null;\n    this.retainedCleanupTextures.add(texture);\n    try {\n      texture.dispose();\n      this.retainedCleanupTextures.delete(texture);\n      return null;\n    } catch (error) {\n      return sanitizeCause(error);\n    }\n  }\n\n  private throwCandidateTextureFailure(texture: CubeTexture, failure: unknown): never {\n    const cleanupError = this.disposeTextureOrRetain(texture);\n    throw withCleanupError(failure, cleanupError, this.retryCleanup);\n  }\n}\n\nfunction applyCandidateTextureProperties(\n  texture: CubeTexture,\n  profile: BabylonEnvironmentTextureProfile,\n): void {\n  texture.level = profile.intensity;\n  (texture as unknown as { rotationY?: number }).rotationY = profile.rotationY;\n}\n\nfunction restoreTextureProperties(\n  texture: CubeTexture,\n  level: number,\n  rotationY: number | undefined,\n): void {\n  try {\n    texture.level = level;\n  } catch {\n    // Best-effort rollback keeps the original operation error as the public diagnostic.\n  }\n  try {\n    (texture as unknown as { rotationY?: number }).rotationY = rotationY;\n  } catch {\n    // Best-effort rollback keeps the original operation error as the public diagnostic.\n  }\n}\n\nfunction restoreSceneState(\n  scene: Scene,\n  environmentTexture: Scene['environmentTexture'],\n  environmentIntensity: number | undefined,\n): void {\n  try {\n    scene.environmentTexture = environmentTexture;\n  } catch {\n    // Best-effort rollback keeps the original operation error as the public diagnostic.\n  }\n  try {\n    (scene as unknown as { environmentIntensity?: number }).environmentIntensity = environmentIntensity;\n  } catch {\n    // Best-effort rollback keeps the original operation error as the public diagnostic.\n  }\n}\n\nfunction forwardAbort(signal: AbortSignal | undefined, controller: AbortController): () => void {\n  if (!signal) return () => undefined;\n  const onAbort = (): void => controller.abort();\n  signal.addEventListener('abort', onAbort, { once: true });\n  if (signal.aborted) controller.abort();\n  return () => signal.removeEventListener('abort', onAbort);\n}\n\nfunction sameResource(\n  left: PlayableResolvedAssetResource | null,\n  right: PlayableResolvedAssetResource,\n): boolean {\n  return left?.assetId === right.assetId\n    && left?.url === right.url\n    && left?.format === right.format;\n}\n\nfunction createEnvironmentTextureAbortError(): Error {\n  return Object.assign(new Error('Babylon environment texture update aborted.'), { name: 'AbortError' });\n}\n\nfunction createSafeEnvironmentTextureError(code: string, message: string, cause: unknown): Error {\n  const error = Object.assign(new Error(message), { code });\n  if (cause !== undefined) {\n    Object.assign(error, { cause: sanitizeCause(cause) });\n  }\n  return error;\n}\n\nfunction sanitizeCause(cause: unknown): Error {\n  const message = cause instanceof Error ? cause.message : String(cause ?? 'Unknown error');\n  return new Error(message.replace(/(?:data|blob):[^\\s)]+/giu, '[redacted-resource-url]'));\n}\n\nfunction withCleanupError(\n  failure: unknown,\n  cleanupError: Error | null,\n  retryCleanup: BabylonEnvironmentTextureControllerCleanup,\n): Error {\n  const result = failure instanceof Error ? failure : new Error('Babylon environment texture operation failed.');\n  if (cleanupError) {\n    attachEnvironmentTextureCleanup(result, [cleanupError], retryCleanup);\n  }\n  return result;\n}\n\nfunction createEnvironmentTextureCleanupFailure(\n  cleanupErrors: readonly unknown[],\n  retryCleanup: BabylonEnvironmentTextureControllerCleanup,\n): Error {\n  return attachEnvironmentTextureCleanup(\n    Object.assign(\n      new Error('Failed to dispose Babylon environment texture resources.'),\n      { code: 'babylon.environment-texture.dispose-failed' },\n    ),\n    cleanupErrors,\n    retryCleanup,\n  );\n}\n\nfunction attachEnvironmentTextureCleanup(\n  failure: Error,\n  cleanupErrors: readonly unknown[],\n  retryCleanup: BabylonEnvironmentTextureControllerCleanup,\n): Error {\n  const safeErrors = Object.freeze(cleanupErrors.map(sanitizeCause));\n  const metadata = {\n    cleanupError: safeErrors[0],\n    cleanupErrors: safeErrors,\n    babylonEnvironmentTextureControllerCleanup: retryCleanup,\n    retryCleanup,\n  };\n  try {\n    Object.assign(failure, metadata);\n    if (readBabylonEnvironmentTextureControllerCleanup(failure) === retryCleanup) return failure;\n  } catch {\n    // Wrap non-extensible primary failures so the owning cleanup remains reachable.\n  }\n  return Object.assign(new Error(failure.message), { cause: failure, ...metadata });\n}\n\nfunction createDefaultEnvironmentTexture(\n  resource: PlayableResolvedAssetResource,\n  scene: Scene,\n  callbacks: BabylonEnvironmentTextureLoadCallbacks = {},\n): CubeTexture {\n  return new CubeTexture(resource.url, scene, {\n    prefiltered: true,\n    createPolynomials: true,\n    forcedExtension: resource.format,\n    onLoad: callbacks.onLoad,\n    onError: callbacks.onError,\n  });\n}\n"]}

package/node_modules/@fps-games/babylon-renderer/dist/environment/profile.js

@@ -3,7 +3,7 @@ export function normalizeBabylonEnvironmentTextureProfile(value) {
     const source = readRecord(value);
     const fallback = DEFAULT_BABYLON_ENVIRONMENT_TEXTURE_PROFILE;
     return {
-        textureUrl: readStringOrNull(source.textureUrl),
+        texture: readResourceOrNull(source.texture),
         intensity: readNonNegativeNumber(source.intensity, fallback.intensity),
         rotationY: readFiniteNumber(source.rotationY, fallback.rotationY),
     };
@@ -13,9 +13,10 @@ function readRecord(value) {
         ? value
         : {};
 }
-function readStringOrNull(value) {
-    const text = typeof value === 'string' ? value.trim() : '';
-    return text || null;
+function readResourceOrNull(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        return null;
+    return value;
 }
 function readFiniteNumber(value, fallback) {
     return typeof value === 'number' && Number.isFinite(value) ? value : fallback;

package/node_modules/@fps-games/babylon-renderer/dist/environment/profile.js.map

@@ -1 +1 @@
-{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../src/environment/profile.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2CAA2C,GAE5C,MAAM,YAAY,CAAC;AAEpB,MAAM,UAAU,yCAAyC,CACvD,KAAc;IAEd,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,QAAQ,GAAG,2CAA2C,CAAC;IAC7D,OAAO;QACL,UAAU,EAAE,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC;QAC/C,SAAS,EAAE,qBAAqB,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC;QACtE,SAAS,EAAE,gBAAgB,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC;KAClE,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChE,CAAC,CAAC,KAAgC;QAClC,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3D,OAAO,IAAI,IAAI,IAAI,CAAC;AACtB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc,EAAE,QAAgB;IACxD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AAChF,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc,EAAE,QAAgB;IAC7D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;AACxD,CAAC","sourcesContent":["import {\n  DEFAULT_BABYLON_ENVIRONMENT_TEXTURE_PROFILE,\n  type BabylonEnvironmentTextureProfile,\n} from './types.js';\n\nexport function normalizeBabylonEnvironmentTextureProfile(\n  value: unknown,\n): BabylonEnvironmentTextureProfile {\n  const source = readRecord(value);\n  const fallback = DEFAULT_BABYLON_ENVIRONMENT_TEXTURE_PROFILE;\n  return {\n    textureUrl: readStringOrNull(source.textureUrl),\n    intensity: readNonNegativeNumber(source.intensity, fallback.intensity),\n    rotationY: readFiniteNumber(source.rotationY, fallback.rotationY),\n  };\n}\n\nfunction readRecord(value: unknown): Record<string, unknown> {\n  return value && typeof value === 'object' && !Array.isArray(value)\n    ? value as Record<string, unknown>\n    : {};\n}\n\nfunction readStringOrNull(value: unknown): string | null {\n  const text = typeof value === 'string' ? value.trim() : '';\n  return text || null;\n}\n\nfunction readFiniteNumber(value: unknown, fallback: number): number {\n  return typeof value === 'number' && Number.isFinite(value) ? value : fallback;\n}\n\nfunction readNonNegativeNumber(value: unknown, fallback: number): number {\n  return Math.max(0, readFiniteNumber(value, fallback));\n}\n"]}
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../src/environment/profile.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,2CAA2C,GAE5C,MAAM,YAAY,CAAC;AAEpB,MAAM,UAAU,yCAAyC,CACvD,KAAc;IAEd,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,QAAQ,GAAG,2CAA2C,CAAC;IAC7D,OAAO;QACL,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC;QAC3C,SAAS,EAAE,qBAAqB,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC;QACtE,SAAS,EAAE,gBAAgB,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,SAAS,CAAC;KAClE,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChE,CAAC,CAAC,KAAgC;QAClC,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7E,OAAO,KAAoD,CAAC;AAC9D,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc,EAAE,QAAgB;IACxD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;AAChF,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc,EAAE,QAAgB;IAC7D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;AACxD,CAAC","sourcesContent":["import {\n  DEFAULT_BABYLON_ENVIRONMENT_TEXTURE_PROFILE,\n  type BabylonEnvironmentTextureProfile,\n} from './types.js';\n\nexport function normalizeBabylonEnvironmentTextureProfile(\n  value: unknown,\n): BabylonEnvironmentTextureProfile {\n  const source = readRecord(value);\n  const fallback = DEFAULT_BABYLON_ENVIRONMENT_TEXTURE_PROFILE;\n  return {\n    texture: readResourceOrNull(source.texture),\n    intensity: readNonNegativeNumber(source.intensity, fallback.intensity),\n    rotationY: readFiniteNumber(source.rotationY, fallback.rotationY),\n  };\n}\n\nfunction readRecord(value: unknown): Record<string, unknown> {\n  return value && typeof value === 'object' && !Array.isArray(value)\n    ? value as Record<string, unknown>\n    : {};\n}\n\nfunction readResourceOrNull(value: unknown): BabylonEnvironmentTextureProfile['texture'] {\n  if (!value || typeof value !== 'object' || Array.isArray(value)) return null;\n  return value as BabylonEnvironmentTextureProfile['texture'];\n}\n\nfunction readFiniteNumber(value: unknown, fallback: number): number {\n  return typeof value === 'number' && Number.isFinite(value) ? value : fallback;\n}\n\nfunction readNonNegativeNumber(value: unknown, fallback: number): number {\n  return Math.max(0, readFiniteNumber(value, fallback));\n}\n"]}