@skenora/runtime 0.1.2

package/dist/systems/camera-path-controller.d.ts

@@ -0,0 +1,39 @@
+import type { CameraPathRecord, Vector3Value } from "@skenora/contracts";
+import type { CameraController } from "./camera-controller.js";
+export interface CameraPathPlaybackOptions {
+    loop?: boolean;
+    playbackRate?: number;
+    startProgress?: number;
+    restoreCameraOnStop?: boolean;
+    signal?: AbortSignal;
+}
+export interface CameraPathPlaybackState {
+    status: "idle" | "playing" | "paused";
+    pathId: string | null;
+    progress: number;
+    elapsedMs: number;
+}
+export interface CameraPathPose {
+    position: Vector3Value;
+    target: Vector3Value;
+}
+/** Smooth, dependency-free camera path playback with pause/seek/state support. */
+export declare class CameraPathController {
+    #private;
+    readonly camera: CameraController;
+    constructor(camera: CameraController, paths?: Readonly<Record<string, CameraPathRecord>>);
+    get state(): CameraPathPlaybackState;
+    get paths(): Readonly<Record<string, CameraPathRecord>>;
+    setPaths(paths: Readonly<Record<string, CameraPathRecord>>): void;
+    subscribe(listener: (state: CameraPathPlaybackState) => void): () => void;
+    play(pathId: string, options?: CameraPathPlaybackOptions): Promise<void>;
+    pause(): boolean;
+    resume(): boolean;
+    stop(restoreCamera?: boolean): void;
+    seek(pathId: string, progress: number): void;
+    jumpToKeyframe(pathId: string, keyframeId: string): void;
+    dispose(): void;
+}
+/** Evaluates a path without mutating a camera, useful for previews and tools. */
+export declare function evaluateCameraPath(path: Readonly<CameraPathRecord>, timeMs: number): CameraPathPose | null;
+//# sourceMappingURL=camera-path-controller.d.ts.map

package/dist/systems/camera-path-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-path-controller.d.ts","sourceRoot":"","sources":["../../src/systems/camera-path-controller.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,gBAAgB,EAChB,YAAY,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;IACtC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,YAAY,CAAC;CACtB;AAmBD,kFAAkF;AAClF,qBAAa,oBAAoB;;IAC/B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;gBAchC,MAAM,EAAE,gBAAgB,EACxB,KAAK,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAM;IAMxD,IAAI,KAAK,IAAI,uBAAuB,CAEnC;IAED,IAAI,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAEtD;IAED,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,GAAG,IAAI;IAKjE,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,IAAI,GAAG,MAAM,IAAI;IAMzE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,yBAA8B,GAAG,OAAO,CAAC,IAAI,CAAC;IA+C5E,KAAK,IAAI,OAAO;IAUhB,MAAM,IAAI,OAAO;IAWjB,IAAI,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI;IAInC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAqB5C,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAUxD,OAAO,IAAI,IAAI;CAiGhB;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,QAAQ,CAAC,gBAAgB,CAAC,EAChC,MAAM,EAAE,MAAM,GACb,cAAc,GAAG,IAAI,CAwCvB"}

package/dist/systems/camera-path-controller.js

@@ -0,0 +1,287 @@
+/** Owns transient playback of serialized camera paths. */
+import { Vector3 } from "@babylonjs/core/Maths/math.vector";
+/** Smooth, dependency-free camera path playback with pause/seek/state support. */
+export class CameraPathController {
+    camera;
+    #listeners = new Set();
+    #paths;
+    #frame = null;
+    #playback = null;
+    #status = "idle";
+    #lastState = {
+        status: "idle",
+        pathId: null,
+        progress: 0,
+        elapsedMs: 0,
+    };
+    constructor(camera, paths = {}) {
+        this.camera = camera;
+        this.#paths = paths;
+    }
+    get state() {
+        return { ...this.#lastState };
+    }
+    get paths() {
+        return this.#paths;
+    }
+    setPaths(paths) {
+        if (this.#playback && !paths[this.#playback.path.id])
+            this.stop();
+        this.#paths = paths;
+    }
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        listener(this.state);
+        return () => this.#listeners.delete(listener);
+    }
+    play(pathId, options = {}) {
+        const path = this.#paths[pathId];
+        if (!path)
+            return Promise.reject(new Error(`Camera path not found: ${pathId}`));
+        if (path.keyframes.length < 2) {
+            return Promise.reject(new Error(`Camera path requires at least two keyframes: ${pathId}`));
+        }
+        if ((options.playbackRate ?? 1) <= 0) {
+            return Promise.reject(new Error("Camera path playbackRate must be positive"));
+        }
+        this.#finish(true, false);
+        return new Promise((resolve) => {
+            const progress = clamp01(options.startProgress ?? 0);
+            const controller = new AbortController();
+            const externalAbort = () => this.#finish(true, true);
+            options.signal?.addEventListener("abort", externalAbort, { once: true });
+            const now = performance.now();
+            this.#playback = {
+                path,
+                loop: options.loop ?? path.loop,
+                playbackRate: options.playbackRate ?? 1,
+                restoreCameraOnStop: options.restoreCameraOnStop ?? path.restoreCameraOnStop ?? false,
+                startedAt: now - (progress * path.durationMs) / (options.playbackRate ?? 1),
+                elapsedMs: progress * path.durationMs,
+                controller,
+                ...(options.signal ? { externalSignal: options.signal } : {}),
+                ...(options.signal ? { externalAbort } : {}),
+                initial: {
+                    position: this.camera.camera.position.clone(),
+                    target: this.camera.camera.getTarget().clone(),
+                },
+                resolve,
+            };
+            this.#status = "playing";
+            this.#apply(path, progress * path.durationMs);
+            this.#emit();
+            this.#frame = requestAnimationFrame(this.#tick);
+        });
+    }
+    pause() {
+        const playback = this.#playback;
+        if (!playback || this.#status !== "playing")
+            return false;
+        playback.elapsedMs = this.#elapsedAt(performance.now());
+        this.#cancelFrame();
+        this.#status = "paused";
+        this.#emit();
+        return true;
+    }
+    resume() {
+        const playback = this.#playback;
+        if (!playback || this.#status !== "paused")
+            return false;
+        playback.startedAt =
+            performance.now() - playback.elapsedMs / playback.playbackRate;
+        this.#status = "playing";
+        this.#emit();
+        this.#frame = requestAnimationFrame(this.#tick);
+        return true;
+    }
+    stop(restoreCamera) {
+        this.#finish(true, restoreCamera);
+    }
+    seek(pathId, progress) {
+        const path = this.#paths[pathId];
+        if (!path)
+            throw new Error(`Camera path not found: ${pathId}`);
+        const next = clamp01(progress) * path.durationMs;
+        this.#apply(path, next);
+        if (this.#playback?.path.id === pathId) {
+            this.#playback.elapsedMs = next;
+            this.#playback.startedAt =
+                performance.now() - next / this.#playback.playbackRate;
+            this.#emit();
+        }
+        else {
+            this.#lastState = {
+                status: "idle",
+                pathId,
+                progress: clamp01(progress),
+                elapsedMs: next,
+            };
+            this.#notify();
+        }
+    }
+    jumpToKeyframe(pathId, keyframeId) {
+        const path = this.#paths[pathId];
+        if (!path)
+            throw new Error(`Camera path not found: ${pathId}`);
+        const keyframe = path.keyframes.find((item) => item.id === keyframeId);
+        if (!keyframe) {
+            throw new Error(`Camera keyframe not found: ${pathId}/${keyframeId}`);
+        }
+        this.seek(pathId, keyframe.timeMs / path.durationMs);
+    }
+    dispose() {
+        this.#finish(false, false);
+        this.#paths = {};
+        this.#listeners.clear();
+    }
+    #tick = (now) => {
+        const playback = this.#playback;
+        if (!playback || this.#status !== "playing")
+            return;
+        if (playback.controller.signal.aborted ||
+            playback.externalSignal?.aborted) {
+            this.#finish(true, true);
+            return;
+        }
+        const rawElapsed = this.#elapsedAt(now);
+        const duration = playback.path.durationMs;
+        if (rawElapsed >= duration) {
+            if (!playback.loop) {
+                playback.elapsedMs = duration;
+                this.#apply(playback.path, duration);
+                this.#emit();
+                this.#finish(false, false);
+                return;
+            }
+            playback.elapsedMs = rawElapsed % duration;
+            playback.startedAt = now - playback.elapsedMs / playback.playbackRate;
+        }
+        else {
+            playback.elapsedMs = rawElapsed;
+        }
+        this.#apply(playback.path, playback.elapsedMs);
+        this.#emit();
+        this.#frame = requestAnimationFrame(this.#tick);
+    };
+    #elapsedAt(now) {
+        const playback = this.#playback;
+        if (!playback)
+            return 0;
+        return Math.max(0, (now - playback.startedAt) * playback.playbackRate);
+    }
+    #apply(path, timeMs) {
+        const pose = evaluateCameraPath(path, timeMs);
+        if (!pose)
+            return;
+        this.camera.camera.setPosition(toVector(pose.position));
+        this.camera.camera.setTarget(toVector(pose.target));
+    }
+    #finish(abort, restoreCamera) {
+        const playback = this.#playback;
+        this.#cancelFrame();
+        if (!playback)
+            return;
+        if (abort)
+            playback.controller.abort();
+        if (playback.externalSignal && playback.externalAbort) {
+            playback.externalSignal.removeEventListener("abort", playback.externalAbort);
+        }
+        if (restoreCamera ?? playback.restoreCameraOnStop) {
+            this.camera.camera.setPosition(playback.initial.position);
+            this.camera.camera.setTarget(playback.initial.target);
+        }
+        playback.resolve();
+        this.#playback = null;
+        this.#status = "idle";
+        this.#lastState = {
+            status: "idle",
+            pathId: playback.path.id,
+            progress: abort ? this.#lastState.progress : 1,
+            elapsedMs: abort ? this.#lastState.elapsedMs : playback.path.durationMs,
+        };
+        this.#notify();
+    }
+    #cancelFrame() {
+        if (this.#frame !== null)
+            cancelAnimationFrame(this.#frame);
+        this.#frame = null;
+    }
+    #emit() {
+        const playback = this.#playback;
+        if (!playback)
+            return;
+        this.#lastState = {
+            status: this.#status,
+            pathId: playback.path.id,
+            progress: clamp01(playback.elapsedMs / playback.path.durationMs),
+            elapsedMs: playback.elapsedMs,
+        };
+        this.#notify();
+    }
+    #notify() {
+        const state = this.state;
+        for (const listener of this.#listeners)
+            listener(state);
+    }
+}
+/** Evaluates a path without mutating a camera, useful for previews and tools. */
+export function evaluateCameraPath(path, timeMs) {
+    const frames = [...path.keyframes].sort((left, right) => left.timeMs - right.timeMs);
+    if (frames.length === 0)
+        return null;
+    const clampedTime = Math.max(0, Math.min(path.durationMs, timeMs));
+    const rightIndex = frames.findIndex((frame) => frame.timeMs >= clampedTime);
+    const right = rightIndex < 0 ? frames.at(-1) : frames[rightIndex];
+    const left = rightIndex <= 0 ? frames[0] : frames[rightIndex - 1];
+    if (!left || !right)
+        return null;
+    const duration = Math.max(right.timeMs - left.timeMs, 1);
+    const amount = ease((clampedTime - left.timeMs) / duration, right.easing ?? left.easing);
+    const leftIndex = Math.max(0, rightIndex - 1);
+    const p0 = frames[Math.max(0, leftIndex - 1)] ?? left;
+    const p3 = frames[Math.min(frames.length - 1, rightIndex + 1)] ?? right;
+    const interpolate = path.interpolation === "catmull-rom" ? catmullRom : linear;
+    return {
+        position: toValue(interpolate(toVector(p0.position), toVector(left.position), toVector(right.position), toVector(p3.position), amount)),
+        target: toValue(interpolate(toVector(p0.target), toVector(left.target), toVector(right.target), toVector(p3.target), amount)),
+    };
+}
+const linear = (_p0, p1, p2, _p3, amount) => Vector3.Lerp(p1, p2, amount);
+const catmullRom = (p0, p1, p2, p3, amount) => {
+    const t2 = amount * amount;
+    const t3 = t2 * amount;
+    return new Vector3(0.5 *
+        (2 * p1.x +
+            (-p0.x + p2.x) * amount +
+            (2 * p0.x - 5 * p1.x + 4 * p2.x - p3.x) * t2 +
+            (-p0.x + 3 * p1.x - 3 * p2.x + p3.x) * t3), 0.5 *
+        (2 * p1.y +
+            (-p0.y + p2.y) * amount +
+            (2 * p0.y - 5 * p1.y + 4 * p2.y - p3.y) * t2 +
+            (-p0.y + 3 * p1.y - 3 * p2.y + p3.y) * t3), 0.5 *
+        (2 * p1.z +
+            (-p0.z + p2.z) * amount +
+            (2 * p0.z - 5 * p1.z + 4 * p2.z - p3.z) * t2 +
+            (-p0.z + 3 * p1.z - 3 * p2.z + p3.z) * t3));
+};
+function toVector(value) {
+    return new Vector3(value.x, value.y, value.z);
+}
+function toValue(value) {
+    return { x: value.x, y: value.y, z: value.z };
+}
+function ease(value, easing) {
+    const t = clamp01(value);
+    if (easing === "easeIn")
+        return t * t * t;
+    if (easing === "easeOut")
+        return 1 - (1 - t) ** 3;
+    if (easing === "easeInOut") {
+        return t < 0.5 ? 4 * t ** 3 : 1 - (-2 * t + 2) ** 3 / 2;
+    }
+    return t;
+}
+function clamp01(value) {
+    return Math.max(0, Math.min(1, value));
+}
+//# sourceMappingURL=camera-path-controller.js.map

package/dist/systems/camera-path-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera-path-controller.js","sourceRoot":"","sources":["../../src/systems/camera-path-controller.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AA6C5D,kFAAkF;AAClF,MAAM,OAAO,oBAAoB;IACtB,MAAM,CAAmB;IACzB,UAAU,GAAG,IAAI,GAAG,EAA4C,CAAC;IAC1E,MAAM,CAA6C;IACnD,MAAM,GAAkB,IAAI,CAAC;IAC7B,SAAS,GAAoB,IAAI,CAAC;IAClC,OAAO,GAAsC,MAAM,CAAC;IACpD,UAAU,GAA4B;QACpC,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,IAAI;QACZ,QAAQ,EAAE,CAAC;QACX,SAAS,EAAE,CAAC;KACb,CAAC;IAEF,YACE,MAAwB,EACxB,QAAoD,EAAE;QAEtD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,IAAI,KAAK;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;IAChC,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,QAAQ,CAAC,KAAiD;QACxD,IAAI,IAAI,CAAC,SAAS,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAClE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,SAAS,CAAC,QAAkD;QAC1D,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,CAAC,MAAc,EAAE,UAAqC,EAAE;QAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI;YACP,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAC,CAAC;QACvE,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CAAC,gDAAgD,MAAM,EAAE,CAAC,CACpE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CAAC,2CAA2C,CAAC,CACvD,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAE1B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC,CAAC;YACrD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;YACzC,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACrD,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACzE,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YAC9B,IAAI,CAAC,SAAS,GAAG;gBACf,IAAI;gBACJ,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI;gBAC/B,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,CAAC;gBACvC,mBAAmB,EACjB,OAAO,CAAC,mBAAmB,IAAI,IAAI,CAAC,mBAAmB,IAAI,KAAK;gBAClE,SAAS,EACP,GAAG,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC;gBAClE,SAAS,EAAE,QAAQ,GAAG,IAAI,CAAC,UAAU;gBACrC,UAAU;gBACV,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7D,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5C,OAAO,EAAE;oBACP,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE;oBAC7C,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE;iBAC/C;gBACD,OAAO;aACR,CAAC;YACF,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;YAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;YACb,IAAI,CAAC,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC1D,QAAQ,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC;QACxD,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC;QACxB,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM;QACJ,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,KAAK,QAAQ;YAAE,OAAO,KAAK,CAAC;QACzD,QAAQ,CAAC,SAAS;YAChB,WAAW,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,YAAY,CAAC;QACjE,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC,aAAuB;QAC1B,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,CAAC,MAAc,EAAE,QAAgB;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAC;QAC/D,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACxB,IAAI,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;YACvC,IAAI,CAAC,SAAS,CAAC,SAAS,GAAG,IAAI,CAAC;YAChC,IAAI,CAAC,SAAS,CAAC,SAAS;gBACtB,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;YACzD,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,UAAU,GAAG;gBAChB,MAAM,EAAE,MAAM;gBACd,MAAM;gBACN,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC;gBAC3B,SAAS,EAAE,IAAI;aAChB,CAAC;YACF,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;IACH,CAAC;IAED,cAAc,CAAC,MAAc,EAAE,UAAkB;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAC;QAC/D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,UAAU,CAAC,CAAC;QACvE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,IAAI,UAAU,EAAE,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC;IACvD,CAAC;IAED,OAAO;QACL,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,KAAK,GAAG,CAAC,GAAW,EAAQ,EAAE;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;YAAE,OAAO;QACpD,IACE,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,OAAO;YAClC,QAAQ,CAAC,cAAc,EAAE,OAAO,EAChC,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACzB,OAAO;QACT,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACxC,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC;QAC1C,IAAI,UAAU,IAAI,QAAQ,EAAE,CAAC;YAC3B,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnB,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC;gBAC9B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBACrC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACb,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAC3B,OAAO;YACT,CAAC;YACD,QAAQ,CAAC,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;YAC3C,QAAQ,CAAC,SAAS,GAAG,GAAG,GAAG,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,YAAY,CAAC;QACxE,CAAC;aAAM,CAAC;YACN,QAAQ,CAAC,SAAS,GAAG,UAAU,CAAC;QAClC,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC,CAAC;IAEF,UAAU,CAAC,GAAW;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,QAAQ;YAAE,OAAO,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,CAAC,IAAsB,EAAE,MAAc;QAC3C,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,CAAC,KAAc,EAAE,aAAkC;QACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,IAAI,KAAK;YAAE,QAAQ,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACvC,IAAI,QAAQ,CAAC,cAAc,IAAI,QAAQ,CAAC,aAAa,EAAE,CAAC;YACtD,QAAQ,CAAC,cAAc,CAAC,mBAAmB,CACzC,OAAO,EACP,QAAQ,CAAC,aAAa,CACvB,CAAC;QACJ,CAAC;QACD,IAAI,aAAa,IAAI,QAAQ,CAAC,mBAAmB,EAAE,CAAC;YAClD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YAC1D,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACxD,CAAC;QACD,QAAQ,CAAC,OAAO,EAAE,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,UAAU,GAAG;YAChB,MAAM,EAAE,MAAM;YACd,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE;YACxB,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;YAC9C,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU;SACxE,CAAC;QACF,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,YAAY;QACV,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI;YAAE,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAED,KAAK;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,QAAQ;YAAE,OAAO;QACtB,IAAI,CAAC,UAAU,GAAG;YAChB,MAAM,EAAE,IAAI,CAAC,OAAO;YACpB,MAAM,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE;YACxB,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC;YAChE,SAAS,EAAE,QAAQ,CAAC,SAAS;SAC9B,CAAC;QACF,IAAI,CAAC,OAAO,EAAE,CAAC;IACjB,CAAC;IAED,OAAO;QACL,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU;YAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC1D,CAAC;CACF;AAED,iFAAiF;AACjF,MAAM,UAAU,kBAAkB,CAChC,IAAgC,EAChC,MAAc;IAEd,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CACrC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAC5C,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IACnE,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,IAAI,WAAW,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAClE,MAAM,IAAI,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAClE,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,IAAI,CACjB,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,QAAQ,EACtC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAC5B,CAAC;IACF,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC;IAC9C,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;IACtD,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,UAAU,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC;IACxE,MAAM,WAAW,GACf,IAAI,CAAC,aAAa,KAAK,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC;IAC7D,OAAO;QACL,QAAQ,EAAE,OAAO,CACf,WAAW,CACT,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,EACrB,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,EACvB,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,EACxB,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,EACrB,MAAM,CACP,CACF;QACD,MAAM,EAAE,OAAO,CACb,WAAW,CACT,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,EACnB,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EACrB,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,EACtB,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,EACnB,MAAM,CACP,CACF;KACF,CAAC;AACJ,CAAC;AAUD,MAAM,MAAM,GAAiB,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,CACxD,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;AAE/B,MAAM,UAAU,GAAiB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE;IAC1D,MAAM,EAAE,GAAG,MAAM,GAAG,MAAM,CAAC;IAC3B,MAAM,EAAE,GAAG,EAAE,GAAG,MAAM,CAAC;IACvB,OAAO,IAAI,OAAO,CAChB,GAAG;QACD,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACP,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM;YACvB,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE;YAC5C,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,EAC9C,GAAG;QACD,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACP,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM;YACvB,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE;YAC5C,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,EAC9C,GAAG;QACD,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;YACP,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,MAAM;YACvB,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE;YAC5C,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAC/C,CAAC;AACJ,CAAC,CAAC;AAEF,SAAS,QAAQ,CAAC,KAA0C;IAC1D,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;AAChD,CAAC;AAED,SAAS,IAAI,CAAC,KAAa,EAAE,MAAoC;IAC/D,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IACzB,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1C,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;IAClD,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,OAAO,CAAC,KAAa;IAC5B,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/systems/environment-controller.d.ts

@@ -0,0 +1,18 @@
+import type { Scene } from "@babylonjs/core/scene";
+import type { EnvironmentConfig, SceneDocumentData } from "@skenora/contracts";
+import type { ResourceResolver } from "@skenora/resources";
+import { SkyboxController } from "./skybox-controller.js";
+/** Compatibility facade for IBL, image backgrounds, and the visible sky. */
+export declare class EnvironmentController {
+    #private;
+    readonly scene: Scene;
+    readonly resources: ResourceResolver;
+    readonly skybox: SkyboxController;
+    constructor(scene: Scene, resources: ResourceResolver);
+    get backgroundVisible(): boolean;
+    setBackgroundVisible(visible: boolean): void;
+    apply(document: Readonly<SceneDocumentData>, config?: Readonly<EnvironmentConfig>, isCurrent?: () => boolean): Promise<void>;
+    capture(fallback: Readonly<EnvironmentConfig>): EnvironmentConfig;
+    dispose(): void;
+}
+//# sourceMappingURL=environment-controller.d.ts.map

package/dist/systems/environment-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-controller.d.ts","sourceRoot":"","sources":["../../src/systems/environment-controller.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAEV,iBAAiB,EACjB,iBAAiB,EAElB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,oBAAoB,CAAC;AAE1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,4EAA4E;AAC5E,qBAAa,qBAAqB;;IAChC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;gBActB,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,gBAAgB;IAMrD,IAAI,iBAAiB,IAAI,OAAO,CAE/B;IAED,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAOtC,KAAK,CACT,QAAQ,EAAE,QAAQ,CAAC,iBAAiB,CAAC,EACrC,MAAM,GAAE,QAAQ,CAAC,iBAAiB,CAAwB,EAC1D,SAAS,GAAE,MAAM,OAA+B,GAC/C,OAAO,CAAC,IAAI,CAAC;IAmBhB,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,iBAAiB;IAoBjE,OAAO,IAAI,IAAI;CA0KhB"}

package/dist/systems/environment-controller.js

@@ -0,0 +1,251 @@
+/** Coordinates independent environment lighting and visible background owners. */
+import { Layer } from "@babylonjs/core/Layers/layer";
+import { Color3, Color4 } from "@babylonjs/core/Maths/math.color";
+import { loadEnvironmentTexture } from "./environment-texture.js";
+import { SkyboxController } from "./skybox-controller.js";
+/** Compatibility facade for IBL, image backgrounds, and the visible sky. */
+export class EnvironmentController {
+    scene;
+    resources;
+    skybox;
+    #environmentTexture = null;
+    #environmentAsset = null;
+    #environmentScope = null;
+    #stagingEnvironmentScope = null;
+    #backgroundLayer = null;
+    #backgroundAsset = null;
+    #backgroundScope = null;
+    #stagingBackgroundScope = null;
+    #environmentConfig = null;
+    #backgroundVisible = true;
+    #revision = 0;
+    #disposed = false;
+    constructor(scene, resources) {
+        this.scene = scene;
+        this.resources = resources;
+        this.skybox = new SkyboxController(scene, resources);
+    }
+    get backgroundVisible() {
+        return this.#backgroundVisible;
+    }
+    setBackgroundVisible(visible) {
+        this.#assertActive();
+        this.#backgroundVisible = visible;
+        this.skybox.setVisible(visible);
+        if (this.#backgroundLayer)
+            this.#backgroundLayer.isEnabled = visible;
+    }
+    async apply(document, config = document.environment, isCurrent = () => !this.#disposed) {
+        this.#assertActive();
+        const revision = ++this.#revision;
+        const current = () => isCurrent() && revision === this.#revision;
+        this.#cancelStagingScopes();
+        this.scene.environmentIntensity = config.intensity;
+        this.scene.clearColor = parseColor4(config.background.color, config.background.mode === "transparent" ? 0 : 1);
+        await this.#applyVisibleBackground(document, config, current);
+        if (!current())
+            return;
+        await this.#applyEnvironmentLighting(document, config, current);
+        if (!current())
+            return;
+        this.#environmentConfig = structuredClone(config);
+    }
+    capture(fallback) {
+        const source = this.#environmentConfig ?? fallback;
+        const rotation = this.#environmentTexture;
+        return {
+            ...structuredClone(source),
+            enabled: this.scene.environmentTexture !== null,
+            intensity: this.scene.environmentIntensity,
+            rotationY: rotation?.rotationY ?? source.rotationY,
+            background: {
+                ...structuredClone(source.background),
+                color: new Color3(this.scene.clearColor.r, this.scene.clearColor.g, this.scene.clearColor.b).toHexString(),
+            },
+        };
+    }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        this.#revision += 1;
+        this.#cancelStagingScopes();
+        this.skybox.dispose();
+        this.#releaseBackgroundLayer();
+        this.#releaseEnvironmentLighting();
+        this.#environmentConfig = null;
+    }
+    async #applyVisibleBackground(document, config, isCurrent) {
+        if (config.background.mode === "image" && config.background.assetId) {
+            const asset = document.assets[config.background.assetId];
+            if (!asset) {
+                throw new Error(`Background asset not found: ${config.background.assetId}`);
+            }
+            if (this.#backgroundLayer &&
+                this.#backgroundAsset &&
+                assetsEqual(this.#backgroundAsset, asset)) {
+                await this.skybox.apply(document, null, isCurrent);
+                return;
+            }
+            const scope = this.resources.createScope();
+            this.#stagingBackgroundScope = scope;
+            try {
+                const resource = await scope.acquire(asset);
+                if (!isCurrent()) {
+                    scope.dispose();
+                    return;
+                }
+                const layer = new Layer("skenora-background", resource.objectUrl, this.scene, true);
+                layer.isEnabled = this.#backgroundVisible;
+                const previousLayer = this.#backgroundLayer;
+                const previousScope = this.#backgroundScope;
+                this.#backgroundLayer = layer;
+                this.#backgroundAsset = structuredClone(asset);
+                this.#backgroundScope = scope;
+                await this.skybox.apply(document, null, isCurrent);
+                previousLayer?.dispose();
+                previousScope?.dispose();
+                return;
+            }
+            catch (error) {
+                scope.dispose();
+                if (!isCurrent())
+                    return;
+                throw error;
+            }
+            finally {
+                if (this.#stagingBackgroundScope === scope) {
+                    this.#stagingBackgroundScope = null;
+                }
+            }
+        }
+        await this.skybox.apply(document, resolveSkyboxConfig(config), isCurrent);
+        if (isCurrent())
+            this.#releaseBackgroundLayer();
+    }
+    async #applyEnvironmentLighting(document, config, isCurrent) {
+        if (!config.enabled || !config.assetId) {
+            if (isCurrent())
+                this.#releaseEnvironmentLighting();
+            return;
+        }
+        const asset = document.assets[config.assetId];
+        if (!asset || asset.kind !== "environment") {
+            throw new Error(`Environment asset not found: ${config.assetId}`);
+        }
+        if (this.#environmentTexture &&
+            this.#environmentAsset &&
+            assetsEqual(this.#environmentAsset, asset)) {
+            setTextureRotation(this.#environmentTexture, config.rotationY);
+            return;
+        }
+        const scope = this.resources.createScope();
+        this.#stagingEnvironmentScope = scope;
+        let texture = null;
+        try {
+            const resource = await scope.acquire(asset, {
+                expectedKind: "environment",
+            });
+            if (!isCurrent()) {
+                scope.dispose();
+                return;
+            }
+            texture = await loadEnvironmentTexture(this.scene, resource.objectUrl, resource.name);
+            if (!isCurrent()) {
+                texture.dispose();
+                scope.dispose();
+                return;
+            }
+            setTextureRotation(texture, config.rotationY);
+            texture.name = `skenora-environment:${asset.id}`;
+            texture.metadata = {
+                skenora: { managed: true, assetId: asset.id, role: "ibl" },
+            };
+            const previousTexture = this.#environmentTexture;
+            const previousScope = this.#environmentScope;
+            this.scene.environmentTexture = texture;
+            this.#environmentTexture = texture;
+            this.#environmentAsset = structuredClone(asset);
+            this.#environmentScope = scope;
+            previousTexture?.dispose();
+            previousScope?.dispose();
+        }
+        catch (error) {
+            texture?.dispose();
+            scope.dispose();
+            if (!isCurrent())
+                return;
+            throw error;
+        }
+        finally {
+            if (this.#stagingEnvironmentScope === scope) {
+                this.#stagingEnvironmentScope = null;
+            }
+        }
+    }
+    #cancelStagingScopes() {
+        this.#stagingBackgroundScope?.dispose();
+        this.#stagingBackgroundScope = null;
+        this.#stagingEnvironmentScope?.dispose();
+        this.#stagingEnvironmentScope = null;
+    }
+    #releaseBackgroundLayer() {
+        this.#backgroundLayer?.dispose();
+        this.#backgroundLayer = null;
+        this.#backgroundAsset = null;
+        this.#backgroundScope?.dispose();
+        this.#backgroundScope = null;
+    }
+    #releaseEnvironmentLighting() {
+        if (this.scene.environmentTexture === this.#environmentTexture) {
+            this.scene.environmentTexture = null;
+        }
+        this.#environmentTexture?.dispose();
+        this.#environmentTexture = null;
+        this.#environmentAsset = null;
+        this.#environmentScope?.dispose();
+        this.#environmentScope = null;
+    }
+    #assertActive() {
+        if (this.#disposed) {
+            throw new Error("EnvironmentController has been disposed");
+        }
+    }
+}
+function resolveSkyboxConfig(config) {
+    if (config.background.mode === "skybox") {
+        return config.background.skybox ?? null;
+    }
+    if (config.background.mode !== "environment")
+        return null;
+    const assetId = config.assetId;
+    if (!assetId)
+        return null;
+    return {
+        source: { kind: "environment", assetId, format: "auto" },
+        rotationY: config.rotationY,
+        blur: config.background.blur,
+        fogParticipation: "disabled",
+    };
+}
+function setTextureRotation(texture, rotationY) {
+    const rotatable = texture;
+    if ("rotationY" in rotatable)
+        rotatable.rotationY = rotationY;
+}
+function assetsEqual(left, right) {
+    return JSON.stringify(left) === JSON.stringify(right);
+}
+function parseColor3(value, fallback) {
+    try {
+        return Color3.FromHexString(value);
+    }
+    catch {
+        return fallback;
+    }
+}
+function parseColor4(value, alpha) {
+    const color = parseColor3(value, new Color3(0.125, 0.13, 0.14));
+    return new Color4(color.r, color.g, color.b, alpha);
+}
+//# sourceMappingURL=environment-controller.js.map

package/dist/systems/environment-controller.js.map

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

package/dist/systems/environment-texture.d.ts

@@ -0,0 +1,7 @@
+import type { BaseTexture } from "@babylonjs/core/Materials/Textures/baseTexture";
+import type { Scene } from "@babylonjs/core/scene";
+export type EnvironmentTextureFormat = "auto" | "env" | "dds" | "hdr" | "exr";
+/** Loads a GPU-ready environment texture without assigning it to the scene. */
+export declare function loadEnvironmentTexture(scene: Scene, url: string, sourceName: string, requestedFormat?: EnvironmentTextureFormat): Promise<BaseTexture>;
+export declare function resolveEnvironmentTextureFormat(sourceName: string, requestedFormat: EnvironmentTextureFormat): Exclude<EnvironmentTextureFormat, "auto">;
+//# sourceMappingURL=environment-texture.d.ts.map

package/dist/systems/environment-texture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment-texture.d.ts","sourceRoot":"","sources":["../../src/systems/environment-texture.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gDAAgD,CAAC;AAIlF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD,MAAM,MAAM,wBAAwB,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAE9E,+EAA+E;AAC/E,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,eAAe,GAAE,wBAAiC,GACjD,OAAO,CAAC,WAAW,CAAC,CA4CtB;AAED,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,wBAAwB,GACxC,OAAO,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAS3C"}