@skenora/runtime 0.1.2

package/dist/systems/environment-texture.js

@@ -0,0 +1,57 @@
+import { CubeTexture } from "@babylonjs/core/Materials/Textures/cubeTexture";
+import { EXRCubeTexture } from "@babylonjs/core/Materials/Textures/exrCubeTexture";
+import { HDRCubeTexture } from "@babylonjs/core/Materials/Textures/hdrCubeTexture";
+/** Loads a GPU-ready environment texture without assigning it to the scene. */
+export function loadEnvironmentTexture(scene, url, sourceName, requestedFormat = "auto") {
+    const format = resolveEnvironmentTextureFormat(sourceName, requestedFormat);
+    if (format === "hdr") {
+        return loadTexture((onLoad, onError) => new HDRCubeTexture(url, scene, 512, false, true, false, true, onLoad, onError));
+    }
+    if (format === "exr") {
+        return loadTexture((onLoad, onError) => new EXRCubeTexture(url, scene, 512, false, true, false, true, onLoad, onError));
+    }
+    return loadTexture((onLoad, onError) => new CubeTexture(url, scene, {
+        forcedExtension: `.${format}`,
+        prefiltered: true,
+        createPolynomials: true,
+        onLoad,
+        onError,
+    }));
+}
+export function resolveEnvironmentTextureFormat(sourceName, requestedFormat) {
+    if (requestedFormat !== "auto")
+        return requestedFormat;
+    const path = sourceName.split(/[?#]/, 1)[0]?.toLowerCase() ?? "";
+    for (const format of ["env", "dds", "hdr", "exr"]) {
+        if (path.endsWith(`.${format}`))
+            return format;
+    }
+    // V1 treated every non-HDR environment as Babylon prefiltered data. Keep
+    // that fallback for provider keys without a file extension.
+    return "env";
+}
+function loadTexture(create) {
+    return new Promise((resolve, reject) => {
+        let texture = null;
+        let settled = false;
+        const onLoad = () => {
+            if (!texture || settled)
+                return;
+            settled = true;
+            resolve(texture);
+        };
+        const onError = (message, exception) => {
+            if (settled)
+                return;
+            settled = true;
+            texture?.dispose();
+            reject(exception instanceof Error
+                ? exception
+                : new Error(message || "Environment texture could not be loaded"));
+        };
+        texture = create(onLoad, onError);
+        if (texture.isReady())
+            onLoad();
+    });
+}
+//# sourceMappingURL=environment-texture.js.map

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

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

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

@@ -0,0 +1,12 @@
+import type { Scene } from "@babylonjs/core/scene";
+import type { FogConfig } from "@skenora/contracts";
+/** Owns the global fog state applied by the scene document. */
+export declare class FogController {
+    #private;
+    readonly scene: Scene;
+    constructor(scene: Scene);
+    apply(config: Readonly<FogConfig>): void;
+    capture(): FogConfig;
+    dispose(): void;
+}
+//# sourceMappingURL=fog-controller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fog-controller.d.ts","sourceRoot":"","sources":["../../src/systems/fog-controller.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,+DAA+D;AAC/D,qBAAa,aAAa;;IACxB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;gBAGV,KAAK,EAAE,KAAK;IAIxB,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,IAAI;IAmBxC,OAAO,IAAI,SAAS;IAqBpB,OAAO,IAAI,IAAI;CAWhB"}

package/dist/systems/fog-controller.js

@@ -0,0 +1,60 @@
+/** Projects document fog settings onto the Babylon scene. */
+import { Color3 } from "@babylonjs/core/Maths/math.color";
+/** Owns the global fog state applied by the scene document. */
+export class FogController {
+    scene;
+    #disposed = false;
+    constructor(scene) {
+        this.scene = scene;
+    }
+    apply(config) {
+        this.#assertActive();
+        this.scene.fogEnabled = config.enabled;
+        this.scene.fogColor = new Color3(config.color.r, config.color.g, config.color.b);
+        this.scene.fogStart = config.start;
+        this.scene.fogEnd = config.end;
+        this.scene.fogDensity = config.density;
+        this.scene.fogMode =
+            config.mode === "exp"
+                ? SceneFogMode.EXP
+                : config.mode === "exp2"
+                    ? SceneFogMode.EXP2
+                    : SceneFogMode.LINEAR;
+    }
+    capture() {
+        this.#assertActive();
+        return {
+            enabled: this.scene.fogEnabled,
+            mode: this.scene.fogMode === SceneFogMode.EXP
+                ? "exp"
+                : this.scene.fogMode === SceneFogMode.EXP2
+                    ? "exp2"
+                    : "linear",
+            color: {
+                r: this.scene.fogColor.r,
+                g: this.scene.fogColor.g,
+                b: this.scene.fogColor.b,
+            },
+            start: this.scene.fogStart,
+            end: this.scene.fogEnd,
+            density: this.scene.fogDensity,
+        };
+    }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        this.scene.fogEnabled = false;
+    }
+    #assertActive() {
+        if (this.#disposed) {
+            throw new Error("FogController has been disposed");
+        }
+    }
+}
+const SceneFogMode = {
+    LINEAR: 3,
+    EXP: 1,
+    EXP2: 2,
+};
+//# sourceMappingURL=fog-controller.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fog-controller.js","sourceRoot":"","sources":["../../src/systems/fog-controller.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAI1D,+DAA+D;AAC/D,MAAM,OAAO,aAAa;IACf,KAAK,CAAQ;IACtB,SAAS,GAAG,KAAK,CAAC;IAElB,YAAY,KAAY;QACtB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,MAA2B;QAC/B,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,MAAM,CAC9B,MAAM,CAAC,KAAK,CAAC,CAAC,EACd,MAAM,CAAC,KAAK,CAAC,CAAC,EACd,MAAM,CAAC,KAAK,CAAC,CAAC,CACf,CAAC;QACF,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC;QACnC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC;QACvC,IAAI,CAAC,KAAK,CAAC,OAAO;YAChB,MAAM,CAAC,IAAI,KAAK,KAAK;gBACnB,CAAC,CAAC,YAAY,CAAC,GAAG;gBAClB,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM;oBACtB,CAAC,CAAC,YAAY,CAAC,IAAI;oBACnB,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,OAAO;QACL,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU;YAC9B,IAAI,EACF,IAAI,CAAC,KAAK,CAAC,OAAO,KAAK,YAAY,CAAC,GAAG;gBACrC,CAAC,CAAC,KAAK;gBACP,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,KAAK,YAAY,CAAC,IAAI;oBACxC,CAAC,CAAC,MAAM;oBACR,CAAC,CAAC,QAAQ;YAChB,KAAK,EAAE;gBACL,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACxB,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;gBACxB,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;aACzB;YACD,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ;YAC1B,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;YACtB,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU;SAC/B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC;IAChC,CAAC;IAED,aAAa;QACX,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;CACF;AAED,MAAM,YAAY,GAAG;IACnB,MAAM,EAAE,CAAC;IACT,GAAG,EAAE,CAAC;IACN,IAAI,EAAE,CAAC;CACC,CAAC"}

package/dist/systems/generated-texture-cache.d.ts

@@ -0,0 +1,33 @@
+import { RawTexture } from "@babylonjs/core/Materials/Textures/rawTexture";
+import type { Scene } from "@babylonjs/core/scene";
+import type { TextureProgram } from "@skenora/contracts";
+import { type CompiledTextureProgram } from "@skenora/procedural";
+export interface GeneratedTextureLease {
+    readonly key: string;
+    readonly hit: boolean;
+    readonly texture: RawTexture;
+    readonly compiled: CompiledTextureProgram;
+    release(): void;
+}
+export interface GeneratedTextureCacheSnapshot {
+    readonly maxEntries: number;
+    readonly size: number;
+    readonly hits: number;
+    readonly misses: number;
+    readonly evictions: number;
+    readonly entries: readonly Readonly<{
+        key: string;
+        references: number;
+        width: number;
+        height: number;
+    }>[];
+}
+/** Runtime-owned cache for deterministic generated texture resources. */
+export declare class GeneratedTextureCache {
+    #private;
+    constructor(scene: Scene, maxEntries?: number);
+    acquire(program: Readonly<TextureProgram>): GeneratedTextureLease;
+    snapshot(): GeneratedTextureCacheSnapshot;
+    dispose(): void;
+}
+//# sourceMappingURL=generated-texture-cache.d.ts.map

package/dist/systems/generated-texture-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generated-texture-cache.d.ts","sourceRoot":"","sources":["../../src/systems/generated-texture-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,+CAA+C,CAAC;AAE3E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;IAC1C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,SAAS,QAAQ,CAAC;QAClC,GAAG,EAAE,MAAM,CAAC;QACZ,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,EAAE,CAAC;CACN;AAQD,yEAAyE;AACzE,qBAAa,qBAAqB;;gBASpB,KAAK,EAAE,KAAK,EAAE,UAAU,SAAK;IAOzC,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,cAAc,CAAC,GAAG,qBAAqB;IAuDjE,QAAQ,IAAI,6BAA6B;IAoBzC,OAAO,IAAI,IAAI;CAiBhB"}

package/dist/systems/generated-texture-cache.js

@@ -0,0 +1,101 @@
+import { RawTexture } from "@babylonjs/core/Materials/Textures/rawTexture";
+import { Texture } from "@babylonjs/core/Materials/Textures/texture";
+import { compileTextureProgram, } from "@skenora/procedural";
+/** Runtime-owned cache for deterministic generated texture resources. */
+export class GeneratedTextureCache {
+    #scene;
+    #maxEntries;
+    #entries = new Map();
+    #hits = 0;
+    #misses = 0;
+    #evictions = 0;
+    #disposed = false;
+    constructor(scene, maxEntries = 16) {
+        if (!Number.isInteger(maxEntries) || maxEntries < 1)
+            throw new Error("Generated texture cache maxEntries must be positive");
+        this.#scene = scene;
+        this.#maxEntries = maxEntries;
+    }
+    acquire(program) {
+        if (this.#disposed)
+            throw new Error("Generated texture cache has been disposed");
+        const compiled = compileTextureProgram(program);
+        const key = `${compiled.contentSignature}:${compiled.width}x${compiled.height}:${compiled.colorSpace}`;
+        let entry = this.#entries.get(key);
+        const hit = !!entry;
+        if (entry) {
+            this.#hits += 1;
+            this.#entries.delete(key);
+            this.#entries.set(key, entry);
+        }
+        else {
+            this.#misses += 1;
+            const texture = RawTexture.CreateRGBATexture(compiled.bytes, compiled.width, compiled.height, this.#scene, true, false, Texture.TRILINEAR_SAMPLINGMODE, undefined, undefined, compiled.colorSpace === "srgb");
+            texture.name = `skenora-generated:${key}`;
+            texture.wrapU = Texture.WRAP_ADDRESSMODE;
+            texture.wrapV = Texture.CLAMP_ADDRESSMODE;
+            texture.metadata = {
+                skenora: {
+                    generated: true,
+                    signature: compiled.contentSignature,
+                    lifecycle: compiled.lifecycle,
+                },
+            };
+            entry = { texture, compiled, references: 0 };
+            this.#entries.set(key, entry);
+        }
+        entry.references += 1;
+        this.#evictUnused();
+        let released = false;
+        return Object.freeze({
+            key,
+            hit,
+            texture: entry.texture,
+            compiled: entry.compiled,
+            release: () => {
+                if (released)
+                    return;
+                released = true;
+                entry.references = Math.max(0, entry.references - 1);
+                this.#evictUnused();
+            },
+        });
+    }
+    snapshot() {
+        return Object.freeze({
+            maxEntries: this.#maxEntries,
+            size: this.#entries.size,
+            hits: this.#hits,
+            misses: this.#misses,
+            evictions: this.#evictions,
+            entries: Object.freeze([...this.#entries].map(([key, entry]) => Object.freeze({
+                key,
+                references: entry.references,
+                width: entry.compiled.width,
+                height: entry.compiled.height,
+            }))),
+        });
+    }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        for (const entry of this.#entries.values())
+            entry.texture.dispose();
+        this.#entries.clear();
+    }
+    #evictUnused() {
+        if (this.#entries.size <= this.#maxEntries)
+            return;
+        for (const [key, entry] of this.#entries) {
+            if (entry.references !== 0)
+                continue;
+            entry.texture.dispose();
+            this.#entries.delete(key);
+            this.#evictions += 1;
+            if (this.#entries.size <= this.#maxEntries)
+                return;
+        }
+    }
+}
+//# sourceMappingURL=generated-texture-cache.js.map

package/dist/systems/generated-texture-cache.js.map

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

package/dist/systems/glass-transmission-controller.d.ts

@@ -0,0 +1,21 @@
+import type { PBRMaterial } from "@babylonjs/core/Materials/PBR/pbrMaterial";
+import type { AbstractMesh } from "@babylonjs/core/Meshes/abstractMesh";
+import type { Scene } from "@babylonjs/core/scene";
+import type { RenderGraphProgram } from "@skenora/contracts";
+export interface GlassTransmissionSnapshot {
+    readonly topologySignature: string;
+    readonly targetIds: readonly string[];
+    readonly passIds: readonly string[];
+    readonly width: number;
+    readonly height: number;
+    readonly resizeReplacements: number;
+    readonly disposed: boolean;
+}
+/** Owns one bounded Babylon capture/blur chain for an attached glass surface. */
+export declare class GlassTransmissionController {
+    #private;
+    constructor(scene: Scene, material: PBRMaterial, excluded: AbstractMesh, graph: Readonly<RenderGraphProgram>);
+    snapshot(): GlassTransmissionSnapshot;
+    dispose(): void;
+}
+//# sourceMappingURL=glass-transmission-controller.d.ts.map

package/dist/systems/glass-transmission-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glass-transmission-controller.d.ts","sourceRoot":"","sources":["../../src/systems/glass-transmission-controller.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAI7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAM7D,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,iFAAiF;AACjF,qBAAa,2BAA2B;;gBAWpC,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,WAAW,EACrB,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,QAAQ,CAAC,kBAAkB,CAAC;IAoBrC,QAAQ,IAAI,yBAAyB;IAarC,OAAO,IAAI,IAAI;CA6GhB"}

package/dist/systems/glass-transmission-controller.js

@@ -0,0 +1,119 @@
+import { BlurPostProcess } from "@babylonjs/core/PostProcesses/blurPostProcess";
+import { RenderTargetTexture } from "@babylonjs/core/Materials/Textures/renderTargetTexture";
+import { Texture } from "@babylonjs/core/Materials/Textures/texture";
+import { Color3 } from "@babylonjs/core/Maths/math.color";
+import { Color4 } from "@babylonjs/core/Maths/math.color";
+import { Vector2 } from "@babylonjs/core/Maths/math.vector";
+import { compileRenderGraph, } from "@skenora/procedural";
+/** Owns one bounded Babylon capture/blur chain for an attached glass surface. */
+export class GlassTransmissionController {
+    #scene;
+    #material;
+    #excluded;
+    #compiled;
+    #resizeObserver;
+    #target;
+    #resizeReplacements = 0;
+    #disposed = false;
+    constructor(scene, material, excluded, graph) {
+        this.#scene = scene;
+        this.#material = material;
+        this.#excluded = excluded;
+        this.#compiled = compileRenderGraph(graph);
+        this.#target = this.#createTarget();
+        this.#activateTarget(this.#target);
+        this.#applyGlassParameters();
+        this.#resizeObserver = scene.getEngine().onResizeObservable.add(() => {
+            if (this.#disposed)
+                return;
+            const next = this.#createTarget();
+            const previous = this.#target;
+            this.#target = next;
+            this.#activateTarget(next);
+            this.#resizeReplacements += 1;
+            if (previous)
+                this.#releaseTarget(previous);
+        });
+    }
+    snapshot() {
+        const target = this.#target;
+        return Object.freeze({
+            topologySignature: this.#compiled.topologySignature,
+            targetIds: Object.freeze(this.#compiled.targets.map(({ id }) => id)),
+            passIds: Object.freeze(this.#compiled.passes.map(({ id }) => id)),
+            width: target?.getRenderWidth() ?? 0,
+            height: target?.getRenderHeight() ?? 0,
+            resizeReplacements: this.#resizeReplacements,
+            disposed: this.#disposed,
+        });
+    }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        const observable = this.#scene.getEngine().onResizeObservable;
+        observable.remove(this.#resizeObserver);
+        if (this.#target)
+            this.#releaseTarget(this.#target);
+        this.#target = undefined;
+        this.#material.subSurface.refractionTexture = null;
+        this.#material.subSurface.isRefractionEnabled = false;
+    }
+    #createTarget() {
+        const capture = this.#compiled.passes.find((pass) => pass.type === "scene.capture");
+        if (!capture || capture.type !== "scene.capture")
+            throw new Error("Compiled render graph has no scene capture pass");
+        const target = this.#compiled.targets.find(({ id }) => id === capture.output);
+        const engine = this.#scene.getEngine();
+        const width = Math.max(1, Math.floor(engine.getRenderWidth() * target.scale));
+        const height = Math.max(1, Math.floor(engine.getRenderHeight() * target.scale));
+        const texture = new RenderTargetTexture(`skenora:render-graph:${this.#compiled.topologySignature}`, { width, height }, this.#scene, true, true, undefined, false, Texture.BILINEAR_SAMPLINGMODE, target.depth, false, false, undefined, false, target.samples);
+        texture.renderListPredicate = (mesh) => mesh !== this.#excluded && !mesh.isDescendantOf(this.#excluded);
+        texture.activeCamera = this.#scene.activeCamera;
+        texture.coordinatesMode = Texture.PROJECTION_MODE;
+        texture.ignoreCameraViewport = true;
+        texture.forceLayerMaskCheck = true;
+        texture.gammaSpace = false;
+        texture.disableImageProcessing = true;
+        const captureColor = capture.clearColor ?? "#000000";
+        texture.clearColor = Color4.FromHexString(`${captureColor}00`);
+        texture.refreshRate = 1;
+        for (const pass of this.#compiled.passes) {
+            if (pass.type !== "blur.gaussian")
+                continue;
+            texture.addPostProcess(new BlurPostProcess(`skenora:${pass.id}`, pass.direction === "horizontal"
+                ? new Vector2(1, 0)
+                : new Vector2(0, 1), pass.radius, 1, null, Texture.BILINEAR_SAMPLINGMODE, engine, false));
+        }
+        return texture;
+    }
+    #activateTarget(target) {
+        if (!this.#scene.customRenderTargets.includes(target))
+            this.#scene.customRenderTargets.push(target);
+        this.#material.subSurface.refractionTexture = target;
+        this.#material.subSurface.isRefractionEnabled = true;
+    }
+    #releaseTarget(target) {
+        const index = this.#scene.customRenderTargets.indexOf(target);
+        if (index >= 0)
+            this.#scene.customRenderTargets.splice(index, 1);
+        target.dispose();
+    }
+    #applyGlassParameters() {
+        const pass = this.#compiled.passes.find((candidate) => candidate.type === "glass.transmission");
+        if (!pass || pass.type !== "glass.transmission")
+            throw new Error("Compiled render graph has no glass transmission pass");
+        const surface = this.#material.subSurface;
+        surface.indexOfRefraction = pass.indexOfRefraction;
+        surface.refractionIntensity = pass.intensity;
+        surface.linkRefractionWithTransparency = false;
+        surface.minimumThickness = 0.05;
+        surface.maximumThickness = 1.5;
+        surface.isDispersionEnabled = pass.dispersion > 0;
+        surface.dispersion = Math.max(1, 100 - pass.dispersion * 80);
+        surface.useAlbedoToTintRefraction = true;
+        surface.tintColor = new Color3(pass.tint.r, pass.tint.g, pass.tint.b);
+        surface.tintColorAtDistance = 2;
+    }
+}
+//# sourceMappingURL=glass-transmission-controller.js.map

package/dist/systems/glass-transmission-controller.js.map

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

package/dist/systems/gpu-program-cache.d.ts

@@ -0,0 +1,19 @@
+import { type GpuProgramCacheSnapshot, type GpuProgramIdentity, type MaterialProgram, type RuntimeBackendId } from "@skenora/contracts";
+import { type MaterialProgramGlslArtifact } from "@skenora/procedural/emitters";
+import { type CompiledMaterialProgram } from "@skenora/procedural";
+export interface PreparedGpuProgram {
+    readonly identity: GpuProgramIdentity;
+    readonly key: string;
+    readonly hit: boolean;
+    readonly compiled: CompiledMaterialProgram;
+    readonly artifact: MaterialProgramGlslArtifact;
+}
+/** Runtime-owned bounded LRU over generated structural GPU artifacts. */
+export declare class GpuProgramCache {
+    #private;
+    constructor(backend: RuntimeBackendId, maxEntries: number);
+    prepare(program: Readonly<MaterialProgram>): PreparedGpuProgram;
+    snapshot(): GpuProgramCacheSnapshot;
+    dispose(): void;
+}
+//# sourceMappingURL=gpu-program-cache.d.ts.map

package/dist/systems/gpu-program-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gpu-program-cache.d.ts","sourceRoot":"","sources":["../../src/systems/gpu-program-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAGL,KAAK,2BAA2B,EACjC,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;CAChD;AAMD,yEAAyE;AACzE,qBAAa,eAAe;;gBASd,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM;IASzD,OAAO,CAAC,OAAO,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,kBAAkB;IAmD/D,QAAQ,IAAI,uBAAuB;IAYnC,OAAO,IAAI,IAAI;CAKhB"}

package/dist/systems/gpu-program-cache.js

@@ -0,0 +1,95 @@
+import { MATERIAL_PROGRAM_CAPABILITY_ID, } from "@skenora/contracts";
+import { emitMaterialProgramGlsl, materialProgramGlslEmitter, } from "@skenora/procedural/emitters";
+import { compileMaterialProgram, } from "@skenora/procedural";
+/** Runtime-owned bounded LRU over generated structural GPU artifacts. */
+export class GpuProgramCache {
+    #backend;
+    #maxEntries;
+    #entries = new Map();
+    #hits = 0;
+    #misses = 0;
+    #evictions = 0;
+    #disposed = false;
+    constructor(backend, maxEntries) {
+        if (!Number.isInteger(maxEntries) || maxEntries < 1)
+            throw new Error("GPU program cache maxEntries must be a positive integer");
+        this.#backend = backend;
+        this.#maxEntries = maxEntries;
+    }
+    prepare(program) {
+        if (this.#disposed)
+            throw new Error("GPU program cache has been disposed");
+        const compiled = compileMaterialProgram(program);
+        const variantSignature = fnv1a([
+            MATERIAL_PROGRAM_CAPABILITY_ID,
+            materialProgramGlslEmitter.id,
+            materialProgramGlslEmitter.version,
+            this.#backend,
+            compiled.topologySignature,
+        ].join("|"));
+        const key = `${materialProgramGlslEmitter.id}@${materialProgramGlslEmitter.version}:${this.#backend}:${variantSignature}`;
+        const cached = this.#entries.get(key);
+        let artifact;
+        let hit = false;
+        if (cached) {
+            this.#hits += 1;
+            hit = true;
+            artifact = cached.artifact;
+            this.#entries.delete(key);
+            this.#entries.set(key, cached);
+        }
+        else {
+            this.#misses += 1;
+            artifact = emitMaterialProgramGlsl(compiled);
+            this.#entries.set(key, Object.freeze({ artifact }));
+            if (this.#entries.size > this.#maxEntries) {
+                const oldest = this.#entries.keys().next().value;
+                if (oldest !== undefined) {
+                    this.#entries.delete(oldest);
+                    this.#evictions += 1;
+                }
+            }
+        }
+        return Object.freeze({
+            identity: Object.freeze({
+                version: 1,
+                capability: MATERIAL_PROGRAM_CAPABILITY_ID,
+                backend: this.#backend,
+                shaderLanguage: "glsl",
+                topologySignature: compiled.topologySignature,
+                contentSignature: compiled.contentSignature,
+                variantSignature,
+            }),
+            key,
+            hit,
+            compiled,
+            artifact,
+        });
+    }
+    snapshot() {
+        return Object.freeze({
+            version: 1,
+            maxEntries: this.#maxEntries,
+            size: this.#entries.size,
+            hits: this.#hits,
+            misses: this.#misses,
+            evictions: this.#evictions,
+            keys: Object.freeze([...this.#entries.keys()]),
+        });
+    }
+    dispose() {
+        if (this.#disposed)
+            return;
+        this.#disposed = true;
+        this.#entries.clear();
+    }
+}
+function fnv1a(value) {
+    let hash = 0x811c9dc5;
+    for (let index = 0; index < value.length; index += 1) {
+        hash ^= value.charCodeAt(index);
+        hash = Math.imul(hash, 0x01000193);
+    }
+    return `fnv1a:${(hash >>> 0).toString(16).padStart(8, "0")}`;
+}
+//# sourceMappingURL=gpu-program-cache.js.map

package/dist/systems/gpu-program-cache.js.map

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

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

@@ -0,0 +1,14 @@
+import type { Mesh } from "@babylonjs/core/Meshes/mesh";
+import type { Scene } from "@babylonjs/core/scene";
+import type { GroundConfig } from "@skenora/contracts";
+/** Owns the document-created ground mesh and its material. */
+export declare class GroundController {
+    #private;
+    readonly scene: Scene;
+    constructor(scene: Scene);
+    get ground(): Mesh | null;
+    apply(config: Readonly<GroundConfig>): void;
+    capture(fallback: Readonly<GroundConfig>): GroundConfig;
+    dispose(): void;
+}
+//# sourceMappingURL=ground-controller.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ground-controller.d.ts","sourceRoot":"","sources":["../../src/systems/ground-controller.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,6BAA6B,CAAC;AAExD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGvD,8DAA8D;AAC9D,qBAAa,gBAAgB;;IAC3B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;gBAKV,KAAK,EAAE,KAAK;IAIxB,IAAI,MAAM,IAAI,IAAI,GAAG,IAAI,CAExB;IAED,KAAK,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,IAAI;IAiC3C,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,YAAY;IAkBvD,OAAO,IAAI,IAAI;CAiBhB"}