@aura3d/engine 3.0.0 → 4.0.0

package/dist/rendering/WebGL2Device.js

@@ -1,12 +1,56 @@
+import { temporalAccumulationWeight } from "./TemporalMath.js";
+import { invertSsrProjection } from "./ProjectionMath.js";
 import { RenderDeviceError, resolveGpuTargetOwner, spreadGpuTargetInventory, } from "./RenderDevice.js";
 import { Texture, isCompressedTextureFormat, isFloatColorTextureFormat } from "./Texture.js";
 import { isTextureBinding, TextureBinding } from "./TextureBinding.js";
 import {} from "./VertexFormat.js";
 import { WebGL2StateCache } from "./WebGL2StateCache.js";
 import { BLOOM_BRIGHT_LUT_HEIGHT, BLOOM_BRIGHT_LUT_WIDTH, BLOOM_COMPOSITE_LUT_SIZE, OUTLINE_BLEND_LUT_WIDTH, OUTLINE_LIMB_RADIX, createOutlineBlendLut, createOutlineGradientBound, createBloomBrightThresholdLut, createBloomCompositeLut } from "./postprocess/NativeLdrEffectLuts.js";
-import { normalizeBloomQualityPreset, resolveBloomPyramidPlan, } from "./postprocess/NativeBloomPyramid.js";
-const WEBGL_CUBE_FACES = ["px", "nx", "py", "ny", "pz", "nz"];
-class WebGL2Buffer {
+import { normalizeBloomQualityPreset, resolveBloomPyramidBlurRadii, resolveBloomPyramidPlan, resolveBloomPyramidResponseGain, } from "./postprocess/NativeBloomPyramid.js";
+import { WebGL2Counters } from "./webgl2/Counters.js";
+import { createWebGL2DeviceProbe } from "./webgl2/Probe.js";
+import { WebGL2ContextLifecycle } from "./webgl2/ContextLifecycle.js";
+import { WebGL2TextureRegistry } from "./webgl2/TextureUpload.js";
+import { WebGL2SamplerRegistry } from "./webgl2/Samplers.js";
+import { WebGL2DrawCallBinder } from "./webgl2/MultiDraw.js";
+import { AURA_FRAME_BINDING, AURA_LIGHTS_BINDING } from "./resources/UniformBlock.js";
+import { WebGL2ReadbackProbe } from "./webgl2/Probe.js";
+import { WebGL2LegacyPostPipeline } from "./webgl2/LegacyPost.js";
+import { cubeFaceTarget, rgba8TextureInternalFormat, textureUploadFormat, resolveRenderTargetFormat, resolveCompressedTextureFormat, magFilter, minFilter, addressMode } from "./webgl2/TextureFormats.js";
+export const WEBGL_CUBE_FACES = ["px", "nx", "py", "ny", "pz", "nz"];
+/**
+ * #621 (01-RTARRAY): immutable storage (`texStorage2D/3D`) only accepts SIZED
+ * internal formats. `resolveRenderTargetFormat("rgba8")` returns unsized
+ * `gl.RGBA`, which is valid for the `texImage2D` 2d path but makes
+ * texStorage raise INVALID_ENUM and allocate nothing, so cube/array colour
+ * framebuffers come out incomplete (GPU run 38143556299: "array: WebGL render
+ * target framebuffer status is invalid"). Float formats are already sized.
+ */
+export function renderTargetStorageFormat(gl, internalFormat) {
+    return internalFormat === gl.RGBA ? gl.RGBA8 : internalFormat;
+}
+/**
+ * Attachment-0 color format of a single-attachment 2d target: an explicit
+ * `colorAttachments[0].format` wins over the legacy `format` field.
+ */
+export function renderTargetColorFormat(descriptor) {
+    return descriptor.colorAttachments?.[0]?.format ?? descriptor.format ?? "rgba8";
+}
+/**
+ * MAX_TEXTURE_SIZE of the canvas's WebGL2 context (4096 when unavailable).
+ * Lives in the device owner file so callers never touch getContext
+ * themselves (single-renderer gate). Moved from the engine's deleted
+ * safe-basic webglRuntime in Live Fix E6.
+ */
+export function webGL2MaxTextureSize(canvas) {
+    return Number(canvas.getContext("webgl2")?.getParameter(WebGL2RenderingContext.MAX_TEXTURE_SIZE) ?? 4096);
+}
+/** C-08 named uniform-block → binding-point assignment applied post-link (T0-02). */
+const NAMED_UNIFORM_BLOCK_BINDINGS = [
+    ["AuraFrame", AURA_FRAME_BINDING],
+    ["AuraLights", AURA_LIGHTS_BINDING]
+];
+export class WebGL2Buffer {
     id;
     usage;
     byteLength;
@@ -14,6 +58,8 @@ class WebGL2Buffer {
     handle;
     gl;
     disposed = false;
+    /** PRD-01 Phase 6 (CONTRACTS §6.1): device-side cleanup hook — VAO eviction. */
+    onDispose;
     constructor(id, usage, byteLength, target, handle, gl) {
         this.id = id;
         this.usage = usage;
@@ -24,12 +70,14 @@ class WebGL2Buffer {
     }
     dispose() {
         if (!this.disposed) {
-            this.gl.deleteBuffer(this.handle);
             this.disposed = true;
+            // Evict VAOs referencing this buffer before the GL object goes away.
+            this.onDispose?.();
+            this.gl.deleteBuffer(this.handle);
         }
     }
 }
-class WebGL2ShaderProgram {
+export class WebGL2ShaderProgram {
     id;
     label;
     marker;
@@ -52,7 +100,7 @@ class WebGL2ShaderProgram {
         }
     }
 }
-class WebGL2RenderTarget {
+export class WebGL2RenderTarget {
     id;
     width;
     height;
@@ -69,7 +117,14 @@ class WebGL2RenderTarget {
     gl;
     disposed = false;
     needsResolve = false;
-    constructor(id, width, height, label, colorTexture, depthTexture, framebuffer, colorHandle, depthHandle, depthTextureHandle, sampleCount, drawFramebuffer, multisampleColorHandle, gl) {
+    dimension;
+    layers;
+    colorTextures;
+    layerTargets;
+    extraColorHandles;
+    layerFramebuffers;
+    layerChild;
+    constructor(id, width, height, label, colorTexture, depthTexture, framebuffer, colorHandle, depthHandle, depthTextureHandle, sampleCount, drawFramebuffer, multisampleColorHandle, gl, options = {}) {
         this.id = id;
         this.width = width;
         this.height = height;
@@ -84,13 +139,31 @@ class WebGL2RenderTarget {
         this.drawFramebuffer = drawFramebuffer;
         this.multisampleColorHandle = multisampleColorHandle;
         this.gl = gl;
+        this.dimension = options.dimension ?? "2d";
+        this.layers = options.layers;
+        this.colorTextures = options.colorTextures;
+        this.layerTargets = options.layerTargets;
+        this.extraColorHandles = options.extraColorHandles ?? [];
+        this.layerFramebuffers = options.layerFramebuffers ?? [];
+        this.layerChild = options.layerChild === true;
     }
     dispose() {
         if (!this.disposed) {
+            if (this.layerChild) {
+                this.disposed = true;
+                return;
+            }
+            for (const framebuffer of this.layerFramebuffers) {
+                if (framebuffer !== this.framebuffer)
+                    this.gl.deleteFramebuffer(framebuffer);
+            }
             this.gl.deleteFramebuffer(this.framebuffer);
             if (this.drawFramebuffer !== this.framebuffer)
                 this.gl.deleteFramebuffer(this.drawFramebuffer);
             this.gl.deleteTexture(this.colorHandle);
+            for (const handle of this.extraColorHandles) {
+                this.gl.deleteTexture(handle);
+            }
             if (this.depthHandle)
                 this.gl.deleteRenderbuffer(this.depthHandle);
             if (this.multisampleColorHandle)
@@ -98,7 +171,14 @@ class WebGL2RenderTarget {
             if (this.depthTextureHandle)
                 this.gl.deleteTexture(this.depthTextureHandle);
             this.colorTexture.dispose();
+            for (const texture of this.colorTextures ?? []) {
+                if (texture !== this.colorTexture)
+                    texture.dispose();
+            }
             this.depthTexture?.dispose();
+            for (const child of this.layerTargets ?? []) {
+                child.disposed = true;
+            }
             this.disposed = true;
         }
     }
@@ -107,73 +187,13 @@ export class WebGL2Device {
     errorCheckMode;
     kind = "webgl2";
     info;
-    disposed = false;
-    contextLost = false;
     gl;
     nextId = 1;
-    drawCalls = 0;
     buffers = new Set();
+    disposedBufferCount = 0;
     shaders = new Set();
     renderTargets = new Set();
-    activeRenderTarget = null;
-    textures = new Map();
-    textureUploadModes = new Map();
-    fallbackTexture = null;
-    fallbackCubeTexture = null;
-    samplerObjectCache = new Map();
-    presentationProgram = null;
-    ldrPostprocessProgram = null;
-    bloomBrightExtractProgram = null;
-    bloomBlurProgram = null;
-    bloomCompositeProgram = null;
-    bloomDownsampleProgram = null;
-    bloomAccumulateProgram = null;
-    bloomPyramidResources = null;
-    outlineProgram = null;
-    ssaoProgram = null;
-    ssrProgram = null;
-    depthOfFieldProgram = null;
-    motionBlurProgram = null;
-    motionBlurVelocityTexture = null;
-    motionBlurVelocitySize = null;
-    taaProgram = null;
-    taaHistoryTexture = null;
-    taaHistorySize = null;
-    bloomPingPongResources = null;
-    bloomBrightLutTexture = null;
-    bloomBrightLutThreshold = null;
-    bloomCompositeLutTexture = null;
-    bloomCompositeLutIntensity = null;
-    bloomCompositeLutShoulder = null;
-    lastBloomDiagnostics = null;
-    outlineBlendLutTexture = null;
-    outlineBlendLutKey = null;
-    depthReadbackProgram = null;
-    uniformLocationCache = new WeakMap();
-    textureSamplerParameterCache = new WeakMap();
     stateCache = new WebGL2StateCache({ label: "webgl2-device-state-cache" });
-    textureUnitBindings = new Map();
-    vertexArrayCache = new Map();
-    vertexFormatIds = new WeakMap();
-    presentationVertexArray = null;
-    activeTextureUnitIndex = -1;
-    shaderProgramCreateCount = 0;
-    uniformLocationLookupCount = 0;
-    bufferUpdateCount = 0;
-    textureBindCount = 0;
-    samplerParameterUploadCount = 0;
-    samplerAnisotropyUploadCount = 0;
-    vertexArrayCreateCount = 0;
-    nativeInstancedSubmissions = 0;
-    nextVertexFormatId = 1;
-    releasedTextureHandles = 0;
-    nativeEnvironmentBindings = 0;
-    nativeShadowMapBindings = 0;
-    shadowRenderTargetsAllocated = 0;
-    lastError = null;
-    frameActive = false;
-    viewportWidth = 0;
-    viewportHeight = 0;
     maxVertexAttributes;
     anisotropicFilteringExtension;
     maxTextureAnisotropy;
@@ -185,16 +205,15 @@ export class WebGL2Device {
      * why the parity table listed context-loss recovery as a gap while the listeners existed — the
      * device layer was never the gap, the absence of a public signal was.
      */
-    deviceLostListeners = new Set();
-    deviceRestoredListeners = new Set();
-    contextLostListener;
-    contextRestoredListener;
-    canvas;
+    host;
+    /** C-28: device capability probe, filled from extension detection in the ctor. */
+    probe;
     static create(options) {
         const gl = options.canvas.getContext("webgl2", {
             antialias: options.antialias ?? true,
             alpha: options.alpha ?? false,
-            preserveDrawingBuffer: options.preserveDrawingBuffer ?? false
+            preserveDrawingBuffer: options.preserveDrawingBuffer ?? false,
+            ...(options.powerPreference !== undefined ? { powerPreference: options.powerPreference } : {})
         });
         if (!gl) {
             throw new RenderDeviceError("WebGL2 is not available for the provided canvas", "WEBGL2_UNAVAILABLE");
@@ -251,39 +270,34 @@ export class WebGL2Device {
                 ...(gl.getExtension("EXT_color_buffer_float") ? ["hdr-render-targets", "float-readback"] : [])
             ]
         };
-        this.canvas = canvas;
-        if ("addEventListener" in canvas) {
-            this.contextLostListener = ((event) => {
-                event.preventDefault();
-                this.contextLost = true;
-                this.lastError = "CONTEXT_LOST";
-                this.frameActive = false;
-                // WS-2.6: notify subscribers. Errors in a listener must not prevent the others from running,
-                // nor leave the device in a half-notified state during an already-degraded condition.
-                for (const listener of [...this.deviceLostListeners]) {
-                    try {
-                        listener();
-                    }
-                    catch {
-                        // A listener that throws is the listener's problem; the device stays consistent.
-                    }
-                }
-            });
-            this.contextRestoredListener = (() => {
-                this.contextLost = false;
-                this.lastError = null;
-                for (const listener of [...this.deviceRestoredListeners]) {
-                    try {
-                        listener();
-                    }
-                    catch {
-                        // As above.
-                    }
-                }
-            });
-            canvas.addEventListener("webglcontextlost", this.contextLostListener);
-            canvas.addEventListener("webglcontextrestored", this.contextRestoredListener);
-        }
+        const host = {
+            gl,
+            stateCache: this.stateCache,
+            counters: new WebGL2Counters(),
+            buffers: this.buffers,
+            shaders: this.shaders,
+            renderTargets: this.renderTargets,
+            activeRenderTarget: null,
+            disposed: false,
+            contextLost: false,
+            errorCheckMode: this.errorCheckMode,
+            anisotropicFilteringExtension: this.anisotropicFilteringExtension,
+            maxTextureAnisotropy: this.maxTextureAnisotropy,
+            maxVertexAttributes: this.maxVertexAttributes,
+            resolveMultisampleTarget: (target) => this.resolveMultisampleTarget(target),
+            device: this
+        };
+        host.lifecycle = new WebGL2ContextLifecycle(host, canvas);
+        host.textureRegistry = new WebGL2TextureRegistry(host);
+        host.samplers = new WebGL2SamplerRegistry(host);
+        host.drawBinder = new WebGL2DrawCallBinder(host);
+        // #94 (Q-01-1): the C-29 restore hook (`renderer/DeviceLifecycle.ts`)
+        // calls `host.invalidateGpuObjects?.()` before the registry rebuild.
+        host.invalidateGpuObjects = () => this.invalidateGpuObjects();
+        host.probe = new WebGL2ReadbackProbe(host);
+        host.post = new WebGL2LegacyPostPipeline(host);
+        this.host = host;
+        this.probe = createWebGL2DeviceProbe(gl);
     }
     /**
      * Subscribe to WebGL context loss. Returns an unsubscribe function.
@@ -292,21 +306,190 @@ export class WebGL2Device {
      * memory pressure, on driver reset, or when a tab is backgrounded too long. What a caller can do is
      * be told, so it can recreate resources rather than render nothing.
      */
+    get disposed() {
+        return this.host.disposed;
+    }
+    set disposed(value) {
+        this.host.disposed = value;
+    }
+    get contextLost() {
+        return this.host.contextLost;
+    }
+    set contextLost(value) {
+        this.host.contextLost = value;
+    }
     onDeviceLost(listener) {
-        this.deviceLostListeners.add(listener);
-        return () => this.deviceLostListeners.delete(listener);
+        return this.host.lifecycle.onDeviceLost(listener);
     }
-    /** Subscribe to context restoration. Returns an unsubscribe function. */
     onDeviceRestored(listener) {
-        this.deviceRestoredListeners.add(listener);
-        return () => this.deviceRestoredListeners.delete(listener);
+        return this.host.lifecycle.onDeviceRestored(listener);
     }
-    /** True while the WebGL context is lost. Polling alternative to {@link onDeviceLost}. */
     isDeviceLost() {
-        return this.contextLost;
+        return this.host.lifecycle.isDeviceLost();
+    }
+    beginFrame(width, height) {
+        this.host.lifecycle.beginFrame(width, height);
+    }
+    clear(color) {
+        this.host.lifecycle.clear(color);
+    }
+    clearRenderTarget(color, attachment) {
+        this.host.lifecycle.clearRenderTarget(color, attachment);
+    }
+    endFrame() {
+        this.host.lifecycle.endFrame();
+    }
+    draw(command) {
+        this.host.drawBinder.draw(command);
+    }
+    readPixels(x, y, width, height, attachment) {
+        return this.host.probe.readPixels(x, y, width, height, attachment);
+    }
+    readFloatPixels(x, y, width, height) {
+        return this.host.probe.readFloatPixels(x, y, width, height);
+    }
+    readDepthPixels(x, y, width, height) {
+        return this.host.probe.readDepthPixels(x, y, width, height);
+    }
+    writeRenderTargetPixels(target, pixels) {
+        this.host.probe.writeRenderTargetPixels(target, pixels);
+    }
+    presentRenderTarget(source) {
+        this.host.post.presentRenderTarget(source);
+    }
+    presentLdrPostprocess(source, options) {
+        this.host.post.presentLdrPostprocess(source, options);
+    }
+    executeReflectionSurfaceSsr(source, normalMask, output, options) {
+        this.host.post.executeReflectionSurfaceSsr(source, normalMask, output, options);
+    }
+    getBloomDiagnostics() {
+        return this.host.post.getBloomDiagnostics();
+    }
+    /** C-28: partial counters from existing diagnostics and the wrapped counter fields. */
+    counters() {
+        const diagnostics = this.getDiagnostics();
+        return {
+            drawCalls: this.host.counters.drawCalls,
+            bufferCreates: diagnostics.buffers,
+            textureUploads: diagnostics.textures ?? 0,
+            readbacks: this.host.counters.readbacks,
+            renderTargetsCreated: diagnostics.renderTargets ?? 0,
+            programCompiles: this.host.counters.programCompiles,
+            liveBuffers: diagnostics.buffers,
+            liveVertexArrays: this.host.drawBinder.vertexArrayCache.size,
+            textureBytes: diagnostics.textureBytes ?? 0,
+            renderTargetBytes: 0
+        };
+    }
+    resetFrameCounters() {
+        this.host.counters.drawCalls = 0;
+        this.host.counters.readbacks = 0;
+    }
+    /**
+     * PRD-01 §6.4 / 01-S7: with `KHR_parallel_shader_compile`, compile and
+     * link are issued without querying status, and the promise resolves once
+     * `COMPLETION_STATUS_KHR` reports done (polled per animation frame), so
+     * the caller's frame is not blocked. Without the extension this is the
+     * synchronous `createShaderProgram` wrapped in a resolved promise.
+     */
+    compileAsync(sources) {
+        const ext = this.parallelShaderCompileExtension();
+        if (!ext)
+            return Promise.resolve(this.createShaderProgram(sources));
+        this.host.lifecycle.assertAlive();
+        this.assertShaderMarker(sources);
+        const vertexShader = this.issueShaderCompile(this.gl.VERTEX_SHADER, sources.vertex, sources.label);
+        const fragmentShader = this.issueShaderCompile(this.gl.FRAGMENT_SHADER, sources.fragment, sources.label);
+        const program = this.gl.createProgram();
+        if (!program) {
+            throw new RenderDeviceError("Failed to allocate WebGL shader program", "WEBGL_ALLOCATION_FAILED");
+        }
+        this.host.counters.shaderProgramCreateCount += 1;
+        this.gl.attachShader(program, vertexShader);
+        this.gl.attachShader(program, fragmentShader);
+        this.gl.linkProgram(program);
+        this.host.counters.programCompiles += 1;
+        this.parallelCompilesPending += 1;
+        return new Promise((resolve, reject) => {
+            const poll = () => {
+                if (this.host.disposed || this.host.contextLost) {
+                    this.parallelCompilesPending -= 1;
+                    reject(new RenderDeviceError("Device lost during parallel shader compile", "DEVICE_LOST", { label: sources.label }));
+                    return;
+                }
+                if (this.gl.getProgramParameter(program, ext.COMPLETION_STATUS_KHR) !== true) {
+                    scheduleParallelCompilePoll(poll);
+                    return;
+                }
+                this.parallelCompilesPending -= 1;
+                try {
+                    for (const [shader, type] of [[vertexShader, "vertex"], [fragmentShader, "fragment"]]) {
+                        if (!this.gl.getShaderParameter(shader, this.gl.COMPILE_STATUS)) {
+                            const log = this.gl.getShaderInfoLog(shader) ?? "Unknown shader compile error";
+                            this.gl.deleteShader(vertexShader);
+                            this.gl.deleteShader(fragmentShader);
+                            this.gl.deleteProgram(program);
+                            throw new RenderDeviceError("WebGL shader compile failed", "SHADER_COMPILE_FAILED", { label: sources.label, log, stage: type });
+                        }
+                    }
+                    this.gl.deleteShader(vertexShader);
+                    this.gl.deleteShader(fragmentShader);
+                    resolve(this.finalizeLinkedProgram(program, sources));
+                }
+                catch (error) {
+                    reject(error);
+                }
+            };
+            scheduleParallelCompilePoll(poll);
+        });
+    }
+    /** Programs issued through `compileAsync`'s parallel path that have not completed yet. */
+    parallelCompilesPending = 0;
+    parallelCompileExt;
+    parallelShaderCompileExtension() {
+        if (this.parallelCompileExt === undefined) {
+            this.parallelCompileExt = this.gl.getExtension("KHR_parallel_shader_compile") ?? null;
+        }
+        return this.parallelCompileExt;
+    }
+    issueShaderCompile(type, source, label) {
+        const shader = this.gl.createShader(type);
+        if (!shader) {
+            throw new RenderDeviceError("Failed to allocate WebGL shader", "WEBGL_ALLOCATION_FAILED", { label });
+        }
+        this.gl.shaderSource(shader, source);
+        this.gl.compileShader(shader);
+        return shader;
+    }
+    assertShaderMarker(sources) {
+        if (!sources.vertex.includes(sources.marker) || !sources.fragment.includes(sources.marker)) {
+            throw new RenderDeviceError("Shader source marker is missing from compiled sources", "SHADER_MARKER_MISSING", {
+                label: sources.label,
+                marker: sources.marker
+            });
+        }
+    }
+    multiDrawElementsInstanced(draws) {
+        this.host.drawBinder.multiDrawElementsInstanced(draws);
+    }
+    /**
+     * #94 (Q-01-1, C-28/C-29): forget every GL object name and uploaded value
+     * cached against the lost context — VAOs, uniform locations, last-value
+     * uniform snapshots, the GL state shadow and texture-unit bindings — so
+     * they recreate lazily on the next draw after `webglcontextrestored`.
+     * `counters().liveVertexArrays` reads 0 afterwards. Buffers, textures and
+     * programs are recreated by the C-29 ResourceRegistry rebuild that runs
+     * right after this in the restore hook.
+     */
+    invalidateGpuObjects() {
+        this.host.drawBinder.invalidateGpuObjects();
+        this.host.stateCache.invalidate();
+        this.host.samplers.activeTextureUnitIndex = -1;
+        this.host.samplers.textureUnitBindings.clear();
     }
     createBuffer(usage, byteLength, initialData) {
-        this.assertAlive();
+        this.host.lifecycle.assertAlive();
         if (byteLength <= 0 || !Number.isInteger(byteLength)) {
             throw new RenderDeviceError("Buffer byteLength must be a positive integer", "INVALID_BUFFER_SIZE", { byteLength });
         }
@@ -314,8 +497,12 @@ export class WebGL2Device {
         if (!handle) {
             throw new RenderDeviceError("Failed to allocate WebGL buffer", "WEBGL_ALLOCATION_FAILED");
         }
-        const target = usage === "index" ? this.gl.ELEMENT_ARRAY_BUFFER : this.gl.ARRAY_BUFFER;
-        this.bindNoVertexArray();
+        const target = usage === "index"
+            ? this.gl.ELEMENT_ARRAY_BUFFER
+            : usage === "uniform"
+                ? this.gl.UNIFORM_BUFFER
+                : this.gl.ARRAY_BUFFER;
+        this.host.drawBinder.bindNoVertexArray();
         this.stateCache.bindBuffer(target, handle, () => this.gl.bindBuffer(target, handle));
         this.gl.bufferData(target, byteLength, this.gl.DYNAMIC_DRAW);
         if (initialData) {
@@ -328,12 +515,20 @@ export class WebGL2Device {
             this.gl.bufferSubData(target, 0, initialData);
         }
         const buffer = new WebGL2Buffer(this.nextId++, usage, byteLength, target, handle, this.gl);
+        buffer.onDispose = () => {
+            // §6.1 declared leak fix: cached VAOs key on buffer ids; a dead buffer's
+            // entries must die with it, and the live-buffer set drops the corpse
+            // (`disposedBuffers` stays meaningful via the monotonic counter).
+            this.host.drawBinder.evictVertexArraysForBuffer(buffer.id);
+            this.buffers.delete(buffer);
+            this.disposedBufferCount += 1;
+        };
         this.buffers.add(buffer);
         return buffer;
     }
     updateBuffer(buffer, byteOffset, data) {
-        this.assertAlive();
-        const webglBuffer = this.requireBuffer(buffer);
+        this.host.lifecycle.assertAlive();
+        const webglBuffer = this.host.drawBinder.requireBuffer(buffer);
         if (byteOffset < 0 || byteOffset + data.byteLength > webglBuffer.byteLength) {
             throw new RenderDeviceError("Buffer update range is out of bounds", "BUFFER_RANGE_OUT_OF_BOUNDS", {
                 byteOffset,
@@ -341,14 +536,22 @@ export class WebGL2Device {
                 byteLength: webglBuffer.byteLength
             });
         }
-        this.bindNoVertexArray();
+        this.host.drawBinder.bindNoVertexArray();
         this.stateCache.bindBuffer(webglBuffer.target, webglBuffer.handle, () => this.gl.bindBuffer(webglBuffer.target, webglBuffer.handle));
         this.gl.bufferSubData(webglBuffer.target, byteOffset, data);
-        this.bufferUpdateCount += 1;
+        this.host.counters.bufferUpdateCount += 1;
+    }
+    bindUniformBuffer(buffer, binding) {
+        this.host.lifecycle.assertAlive();
+        const webglBuffer = this.host.drawBinder.requireBuffer(buffer);
+        if (webglBuffer.target !== this.gl.UNIFORM_BUFFER) {
+            throw new RenderDeviceError("Buffer was not created with usage 'uniform'", "INVALID_BUFFER_USAGE", { bufferId: buffer.id });
+        }
+        this.gl.bindBufferBase(this.gl.UNIFORM_BUFFER, binding, webglBuffer.handle);
     }
     readBuffer(buffer, byteOffset = 0, byteLength = buffer.byteLength - byteOffset) {
-        this.assertAlive();
-        const webglBuffer = this.requireBuffer(buffer);
+        this.host.lifecycle.assertAlive();
+        const webglBuffer = this.host.drawBinder.requireBuffer(buffer);
         if (byteOffset < 0 || byteLength < 0 || byteOffset + byteLength > webglBuffer.byteLength) {
             throw new RenderDeviceError("Buffer read range is out of bounds", "BUFFER_RANGE_OUT_OF_BOUNDS", {
                 byteOffset,
@@ -357,42 +560,59 @@ export class WebGL2Device {
             });
         }
         const output = new Uint8Array(byteLength);
-        this.bindNoVertexArray();
+        this.host.drawBinder.bindNoVertexArray();
         this.stateCache.bindBuffer(webglBuffer.target, webglBuffer.handle, () => this.gl.bindBuffer(webglBuffer.target, webglBuffer.handle));
         this.gl.getBufferSubData(webglBuffer.target, byteOffset, output);
         return output;
     }
     createShaderProgram(sources) {
-        this.assertAlive();
-        if (!sources.vertex.includes(sources.marker) || !sources.fragment.includes(sources.marker)) {
-            throw new RenderDeviceError("Shader source marker is missing from compiled sources", "SHADER_MARKER_MISSING", {
-                label: sources.label,
-                marker: sources.marker
-            });
-        }
+        this.host.lifecycle.assertAlive();
+        this.assertShaderMarker(sources);
         const vertexShader = this.compileShader(this.gl.VERTEX_SHADER, sources.vertex, sources.label);
         const fragmentShader = this.compileShader(this.gl.FRAGMENT_SHADER, sources.fragment, sources.label);
         const program = this.gl.createProgram();
         if (!program) {
             throw new RenderDeviceError("Failed to allocate WebGL shader program", "WEBGL_ALLOCATION_FAILED");
         }
-        this.shaderProgramCreateCount += 1;
+        this.host.counters.shaderProgramCreateCount += 1;
         this.gl.attachShader(program, vertexShader);
         this.gl.attachShader(program, fragmentShader);
         this.gl.linkProgram(program);
+        this.host.counters.programCompiles += 1;
         this.gl.deleteShader(vertexShader);
         this.gl.deleteShader(fragmentShader);
+        return this.finalizeLinkedProgram(program, sources);
+    }
+    /** LINK_STATUS check, named-block bindings and reflection for a linked program. */
+    finalizeLinkedProgram(program, sources) {
         if (!this.gl.getProgramParameter(program, this.gl.LINK_STATUS)) {
             const log = this.gl.getProgramInfoLog(program) ?? "Unknown shader link error";
             this.gl.deleteProgram(program);
             throw new RenderDeviceError("WebGL shader link failed", "SHADER_LINK_FAILED", { label: sources.label, log });
         }
+        // T0-02/C-08: generated blocks declare `layout(std140)` with no baked
+        // `binding=`; the named-block → binding-point assignment is fixed here so
+        // every linked program gets AuraFrame→0 and AuraLights→1 regardless of
+        // declaration order. Programs that do not declare a block are skipped.
+        for (const [blockName, binding] of NAMED_UNIFORM_BLOCK_BINDINGS) {
+            const index = this.gl.getUniformBlockIndex(program, blockName);
+            if (index !== this.gl.INVALID_INDEX) {
+                this.gl.uniformBlockBinding(program, index, binding);
+            }
+        }
         const shader = new WebGL2ShaderProgram(this.nextId++, sources.label, sources.marker, this.reflectProgram(program), program, this.gl);
         this.shaders.add(shader);
         return shader;
     }
     createRenderTarget(descriptor) {
-        this.assertAlive();
+        this.host.lifecycle.assertAlive();
+        if ((descriptor.dimension !== undefined && descriptor.dimension !== "2d") ||
+            descriptor.layers !== undefined ||
+            descriptor.depthOnly === true ||
+            descriptor.depthCompare === true ||
+            (descriptor.colorAttachments?.length ?? 0) > 1) {
+            return this.createFeatureRenderTarget(descriptor);
+        }
         if (!Number.isInteger(descriptor.width) ||
             descriptor.width <= 0 ||
             !Number.isInteger(descriptor.height) ||
@@ -457,8 +677,15 @@ export class WebGL2Device {
         this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_MAG_FILTER, this.gl.LINEAR);
         this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_WRAP_S, this.gl.CLAMP_TO_EDGE);
         this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_WRAP_T, this.gl.CLAMP_TO_EDGE);
-        const format = descriptor.format ?? "rgba8";
-        const textureFormat = this.resolveRenderTargetFormat(format);
+        // A single `colorAttachments` entry is the attachment-0 format (CONTRACTS
+        // §3.4) and wins over the legacy `format` field. Before this, the 2d path
+        // ignored it, so `createHdrTarget` ({ format: "rgba8", colorAttachments:
+        // [{ format: "rgba16f" }] }) without coverage allocated an RGBA8 "HDR"
+        // scene target: linear radiance clamped at 1.0 and 8-bit dark banding
+        // before tone mapping (GPU run 38190015020: device ACES of 4.0 = 226 vs
+        // three 250; tonemap-ramp dark swatches ΔE2000 13-30).
+        const format = renderTargetColorFormat(descriptor);
+        const textureFormat = resolveRenderTargetFormat(this.gl, format);
         this.gl.texImage2D(this.gl.TEXTURE_2D, 0, textureFormat.internalFormat, descriptor.width, descriptor.height, 0, this.gl.RGBA, textureFormat.type, null);
         this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, framebuffer);
         this.gl.framebufferTexture2D(this.gl.FRAMEBUFFER, this.gl.COLOR_ATTACHMENT0, this.gl.TEXTURE_2D, colorHandle, 0);
@@ -516,563 +743,376 @@ export class WebGL2Device {
         this.renderTargets.add(target);
         // Shadow passes label their depth target after the shadow map texture, so the
         // label is the device-side signal that a shadow depth target was allocated.
-        if ((descriptor.label ?? "").toLowerCase().includes("shadow"))
-            this.shadowRenderTargetsAllocated += 1;
-        this.textures.set(target.colorTexture, colorHandle);
-        this.textureUploadModes.set(target.colorTexture, "rgba8");
+        // Cascaded maps use the established renderer-csm-cascade-* labels.
+        // Count their actual allocation too, including the first shadow frame.
+        if (/shadow|(?:^|-)csm(?:-|$)/i.test(descriptor.label ?? ""))
+            this.host.counters.shadowRenderTargetsAllocated += 1;
+        this.host.textureRegistry.textures.set(target.colorTexture, colorHandle);
+        this.host.textureRegistry.textureUploadModes.set(target.colorTexture, "rgba8");
         if (depthTexture && depthTextureHandle) {
-            this.textures.set(depthTexture, depthTextureHandle);
-            this.textureUploadModes.set(depthTexture, "depth-render-target");
+            this.host.textureRegistry.textures.set(depthTexture, depthTextureHandle);
+            this.host.textureRegistry.textureUploadModes.set(depthTexture, "depth-render-target");
         }
         return target;
     }
-    setRenderTarget(target) {
-        this.assertAlive();
-        if (this.activeRenderTarget && this.activeRenderTarget !== target) {
-            this.resolveMultisampleTarget(this.activeRenderTarget);
-        }
-        if (target === null) {
-            this.activeRenderTarget = null;
-            this.stateCache.bindFramebuffer(this.gl.FRAMEBUFFER, null, () => this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, null));
-            this.stateCache.viewport(0, 0, this.viewportWidth || this.gl.drawingBufferWidth, this.viewportHeight || this.gl.drawingBufferHeight, () => this.gl.viewport(0, 0, this.viewportWidth || this.gl.drawingBufferWidth, this.viewportHeight || this.gl.drawingBufferHeight));
-            return;
-        }
-        if (!(target instanceof WebGL2RenderTarget) || !this.renderTargets.has(target) || target.disposed) {
-            throw new RenderDeviceError("Render target is not a live WebGL2 resource owned by this device", "INVALID_RESOURCE", {
-                targetId: target.id
-            });
-        }
-        this.activeRenderTarget = target;
-        this.stateCache.bindFramebuffer(this.gl.FRAMEBUFFER, target.drawFramebuffer, () => this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, target.drawFramebuffer));
-        this.stateCache.viewport(0, 0, target.width, target.height, () => this.gl.viewport(0, 0, target.width, target.height));
-    }
-    resolveMultisampleTarget(target) {
-        if (target.sampleCount <= 1 || !target.needsResolve)
-            return;
-        const previousFramebuffer = this.gl.getParameter(this.gl.FRAMEBUFFER_BINDING);
-        this.gl.bindFramebuffer(this.gl.READ_FRAMEBUFFER, target.drawFramebuffer);
-        this.gl.bindFramebuffer(this.gl.DRAW_FRAMEBUFFER, target.framebuffer);
-        let mask = this.gl.COLOR_BUFFER_BIT;
-        if (target.depthTextureHandle)
-            mask |= this.gl.DEPTH_BUFFER_BIT;
-        this.gl.blitFramebuffer(0, 0, target.width, target.height, 0, 0, target.width, target.height, mask, this.gl.NEAREST);
-        this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, previousFramebuffer);
-        target.needsResolve = false;
-        this.stateCache.invalidate();
-    }
-    writeRenderTargetPixels(target, pixels) {
-        this.assertAlive();
-        if (!(target instanceof WebGL2RenderTarget) || !this.renderTargets.has(target) || target.disposed) {
-            throw new RenderDeviceError("Render target is not a live WebGL2 resource owned by this device", "INVALID_RESOURCE", {
-                targetId: target.id
-            });
-        }
-        if (target.colorTexture.format !== "rgba8") {
-            throw new RenderDeviceError("Byte pixel uploads are only supported for rgba8 WebGL2 render targets", "INVALID_PIXEL_UPLOAD_FORMAT", {
-                targetId: target.id,
-                format: target.colorTexture.format
-            });
-        }
-        if (pixels.length !== target.width * target.height * 4) {
-            throw new RenderDeviceError("Render-target pixel upload must contain width * height * 4 bytes", "INVALID_PIXEL_UPLOAD_SIZE", {
-                targetId: target.id,
-                byteLength: pixels.length,
-                expectedByteLength: target.width * target.height * 4
-            });
-        }
-        const textureUnit0 = this.captureTextureUnit0();
-        try {
-            this.gl.bindTexture(this.gl.TEXTURE_2D, target.colorHandle);
-            this.gl.texSubImage2D(this.gl.TEXTURE_2D, 0, 0, 0, target.width, target.height, this.gl.RGBA, this.gl.UNSIGNED_BYTE, pixels);
-            target.needsResolve = false;
-        }
-        finally {
-            this.restoreTextureUnit0(textureUnit0);
-        }
-        this.lastError = this.readError();
-        if (this.lastError) {
-            throw new RenderDeviceError("WebGL2 render-target pixel upload failed", "WEBGL_PIXEL_UPLOAD_FAILED", {
-                targetId: target.id,
-                error: this.lastError
-            });
-        }
-    }
-    presentRenderTarget(source) {
-        this.assertAlive();
-        if (!(source instanceof WebGL2RenderTarget) || !this.renderTargets.has(source) || source.disposed) {
-            throw new RenderDeviceError("Render target is not a live WebGL2 resource owned by this device", "INVALID_RESOURCE", {
-                targetId: source.id
+    /**
+     * PR 0a render-target fields (CONTRACTS §3.4): `dimension`/`layers` (cube +
+     * 2d-array layered targets rendered through `layerTargets`), `depthOnly`
+     * (no color attachment), `depthCompare` (comparison-sampler depth texture)
+     * and `colorAttachments` (MRT, per-layer `drawBuffers` state).
+     */
+    createFeatureRenderTarget(descriptor) {
+        const gl = this.gl;
+        if (!Number.isInteger(descriptor.width) ||
+            descriptor.width <= 0 ||
+            !Number.isInteger(descriptor.height) ||
+            descriptor.height <= 0) {
+            throw new RenderDeviceError("Render target dimensions must be positive integers", "INVALID_RENDER_TARGET_SIZE", {
+                width: descriptor.width,
+                height: descriptor.height,
+                label: descriptor.label
             });
         }
-        this.resolveMultisampleTarget(source);
-        const outputWidth = this.viewportWidth || this.gl.drawingBufferWidth;
-        const outputHeight = this.viewportHeight || this.gl.drawingBufferHeight;
-        this.drawRenderTargetToBackbuffer(source, outputWidth, outputHeight);
-        this.activeRenderTarget = null;
-        this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, null);
-        this.lastError = this.readError();
-        if (this.lastError) {
-            throw new RenderDeviceError(`WebGL2 render-target presentation failed: ${this.lastError}`, "WEBGL_PRESENT_FAILED", {
-                targetId: source.id,
-                error: this.lastError
+        const dimension = descriptor.dimension ?? "2d";
+        if (descriptor.layers !== undefined && (!Number.isInteger(descriptor.layers) || descriptor.layers < 1)) {
+            throw new RenderDeviceError("Render target layer count must be a positive integer", "INVALID_RENDER_TARGET_SIZE", {
+                layers: descriptor.layers,
+                label: descriptor.label
             });
         }
-    }
-    presentLdrPostprocess(source, options) {
-        this.assertAlive();
-        if (!(source instanceof WebGL2RenderTarget) || !this.renderTargets.has(source) || source.disposed) {
-            throw new RenderDeviceError("Render target is not a live WebGL2 resource owned by this device", "INVALID_RESOURCE", {
-                targetId: source.id
+        if (descriptor.layers !== undefined && dimension !== "2d-array") {
+            throw new RenderDeviceError("Render target `layers` only applies to dimension \"2d-array\"", "INVALID_RENDER_TARGET_SIZE", {
+                dimension,
+                layers: descriptor.layers,
+                label: descriptor.label
             });
         }
-        this.resolveMultisampleTarget(source);
-        const tonePass = options.passes.find((pass) => pass.name === "tone-mapping");
-        const bloomPass = options.passes.find((pass) => pass.name === "bloom");
-        const depthOfFieldPass = options.passes.find((pass) => pass.name === "depth-of-field");
-        const motionBlurPass = options.passes.find((pass) => pass.name === "motion-blur");
-        const ssaoPass = options.passes.find((pass) => pass.name === "ssao");
-        const ssrPass = options.passes.find((pass) => pass.name === "ssr");
-        const taaPass = options.passes.find((pass) => pass.name === "taa");
-        const outlinePass = options.passes.find((pass) => pass.name === "outline");
-        if (source.colorTexture.format !== "rgba8" && !tonePass) {
-            throw new RenderDeviceError("WebGL2 HDR postprocess presentation requires a tone-mapping pass before LDR output.", "WEBGL_LDR_POSTPROCESS_FORMAT_UNSUPPORTED", {
-                targetId: source.id,
-                format: source.colorTexture.format
+        const layerCount = dimension === "cube" ? 6 : dimension === "2d-array" ? descriptor.layers ?? 1 : 1;
+        const depthOnly = descriptor.depthOnly === true;
+        if (depthOnly && (descriptor.colorAttachments?.length ?? 0) > 0) {
+            throw new RenderDeviceError("Render target cannot combine `depthOnly` with `colorAttachments`", "INVALID_RENDER_TARGET_SIZE", {
+                label: descriptor.label
             });
         }
-        if (source.colorTexture.format !== "rgba8" && (depthOfFieldPass || motionBlurPass || ssaoPass || ssrPass || taaPass || outlinePass) && !tonePass) {
-            throw new RenderDeviceError("WebGL2 byte-kernel postprocess requires rgba8 input or a preceding tone-mapping pass.", "WEBGL_LDR_POSTPROCESS_FORMAT_UNSUPPORTED", {
-                targetId: source.id,
-                format: source.colorTexture.format,
-                pass: depthOfFieldPass ? "depth-of-field" : motionBlurPass ? "motion-blur" : ssaoPass ? "ssao" : ssrPass ? "ssr" : taaPass ? "taa" : "outline"
+        if (depthOnly && descriptor.depth === false) {
+            throw new RenderDeviceError("Render target cannot combine `depthOnly` with `depth: false`", "INVALID_RENDER_TARGET_SIZE", {
+                label: descriptor.label
             });
         }
-        if ((depthOfFieldPass || ssaoPass || ssrPass) && !source.depthTextureHandle) {
-            throw new RenderDeviceError("WebGL2 native depth postprocess requires a renderer-owned sampleable depth texture.", "WEBGL_LDR_POSTPROCESS_DEPTH_REQUIRED", {
-                targetId: source.id,
-                pass: depthOfFieldPass ? "depth-of-field" : ssaoPass ? "ssao" : "ssr"
+        const sampleCount = descriptor.sampleCount ?? 1;
+        const colorAttachmentCount = depthOnly ? 0 : Math.max(1, descriptor.colorAttachments?.length ?? 1);
+        if (sampleCount > 1 && (depthOnly || descriptor.depthCompare === true || (descriptor.colorAttachments?.length ?? 0) > 1 || layerCount > 1)) {
+            throw new RenderDeviceError("Multisample render targets do not support layered, depth-only, compare or MRT descriptors", "INVALID_RENDER_TARGET_SAMPLE_COUNT", {
+                sampleCount,
+                label: descriptor.label
             });
         }
-        // Raw GL depth is nonlinear (0.1/1000 defaults park the play area past
-        // 0.97), which blinded every depth-gated native pass. SSR and DOF compare
-        // linearized depth; SSAO keeps its legacy response (documented partial).
-        const depthRange = normalizeLdrDepthRange(options.depthRange);
-        const outputTarget = options.outputTarget;
-        if (outputTarget && (!(outputTarget instanceof WebGL2RenderTarget) || !this.renderTargets.has(outputTarget) || outputTarget.disposed)) {
-            throw new RenderDeviceError("Output render target is not a live WebGL2 resource owned by this device", "INVALID_RESOURCE", {
-                targetId: outputTarget.id
+        const maxSamples = Number(gl.getParameter(gl.MAX_SAMPLES) ?? 1);
+        if (!Number.isInteger(sampleCount) || sampleCount < 1 || sampleCount > maxSamples) {
+            throw new RenderDeviceError("WebGL2 render-target sampleCount must be an integer supported by MAX_SAMPLES.", "INVALID_RENDER_TARGET_SAMPLE_COUNT", {
+                sampleCount,
+                maxSamples,
+                label: descriptor.label
             });
         }
-        if (outputTarget && outputTarget.colorTexture.format !== "rgba8") {
-            throw new RenderDeviceError("WebGL2 LDR postprocess output target must be rgba8.", "WEBGL_LDR_POSTPROCESS_OUTPUT_FORMAT_UNSUPPORTED", {
-                targetId: outputTarget.id,
-                format: outputTarget.colorTexture.format
-            });
+        const label = descriptor.label ?? "render-target";
+        const textureTarget = dimension === "cube" ? gl.TEXTURE_CUBE_MAP : dimension === "2d-array" ? gl.TEXTURE_2D_ARRAY : gl.TEXTURE_2D;
+        const depthMode = depthOnly || descriptor.depth === "texture" || (layerCount > 1 && descriptor.depth !== false) ? "texture" : descriptor.depth === false ? "none" : "renderbuffer";
+        const depthCompare = descriptor.depthCompare === true;
+        const colorFormats = depthOnly
+            ? []
+            : colorAttachmentCount === 1 && !descriptor.colorAttachments
+                ? [descriptor.format ?? "rgba8"]
+                : (descriptor.colorAttachments ?? [{ format: descriptor.format ?? "rgba8" }]).map((attachment) => attachment.format);
+        const colorHandles = [];
+        const colorTextures = [];
+        let depthTextureHandle = null;
+        const layerFramebuffers = [];
+        const cleanup = () => {
+            for (const handle of colorHandles)
+                gl.deleteTexture(handle);
+            if (depthTextureHandle)
+                gl.deleteTexture(depthTextureHandle);
+            for (const framebuffer of layerFramebuffers)
+                gl.deleteFramebuffer(framebuffer);
+        };
+        const previousActiveTexture = gl.getParameter(gl.ACTIVE_TEXTURE);
+        gl.activeTexture(gl.TEXTURE0);
+        const previousTexture = gl.getParameter(gl.TEXTURE_BINDING_2D);
+        const previousCubeTexture = gl.getParameter(gl.TEXTURE_BINDING_CUBE_MAP);
+        const previousArrayTexture = gl.getParameter(gl.TEXTURE_BINDING_2D_ARRAY);
+        const previousFramebuffer = gl.getParameter(gl.FRAMEBUFFER_BINDING);
+        for (let attachment = 0; attachment < colorFormats.length; attachment += 1) {
+            const format = colorFormats[attachment];
+            const textureFormat = resolveRenderTargetFormat(gl, format);
+            const handle = gl.createTexture();
+            if (!handle) {
+                cleanup();
+                throw new RenderDeviceError("Failed to allocate WebGL render target", "WEBGL_ALLOCATION_FAILED", { label });
+            }
+            colorHandles.push(handle);
+            colorTextures.push(new Texture({ width: descriptor.width, height: descriptor.height, format, label: colorAttachmentCount > 1 ? `${label}-color-${attachment}` : descriptor.label ?? "render-target-color", dimension, layers: dimension === "2d" ? undefined : layerCount, renderAttachment: true }));
+            gl.bindTexture(textureTarget, handle);
+            gl.texParameteri(textureTarget, gl.TEXTURE_MIN_FILTER, gl.LINEAR);
+            gl.texParameteri(textureTarget, gl.TEXTURE_MAG_FILTER, gl.LINEAR);
+            gl.texParameteri(textureTarget, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);
+            gl.texParameteri(textureTarget, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
+            if (dimension === "2d") {
+                gl.texImage2D(textureTarget, 0, textureFormat.internalFormat, descriptor.width, descriptor.height, 0, gl.RGBA, textureFormat.type, null);
+            }
+            else if (dimension === "cube") {
+                gl.texStorage2D(textureTarget, 1, renderTargetStorageFormat(gl, textureFormat.internalFormat), descriptor.width, descriptor.height);
+            }
+            else {
+                gl.texStorage3D(textureTarget, 1, renderTargetStorageFormat(gl, textureFormat.internalFormat), descriptor.width, descriptor.height, layerCount);
+            }
         }
-        if (outputTarget && (outputTarget.width !== source.width || outputTarget.height !== source.height)) {
-            throw new RenderDeviceError("WebGL2 LDR postprocess source and output dimensions must match.", "WEBGL_LDR_POSTPROCESS_SIZE_MISMATCH", {
-                sourceWidth: source.width,
-                sourceHeight: source.height,
-                targetWidth: outputTarget.width,
-                targetHeight: outputTarget.height
+        let depthTexture;
+        if (depthMode === "texture") {
+            depthTextureHandle = gl.createTexture();
+            if (!depthTextureHandle) {
+                cleanup();
+                throw new RenderDeviceError("Failed to allocate WebGL render target", "WEBGL_ALLOCATION_FAILED", { label });
+            }
+            depthTexture = new Texture({
+                width: descriptor.width,
+                height: descriptor.height,
+                format: "depth24",
+                label: `${label}-depth`,
+                dimension,
+                layers: dimension === "2d" ? undefined : layerCount,
+                renderAttachment: true
             });
+            gl.bindTexture(textureTarget, depthTextureHandle);
+            gl.texParameteri(textureTarget, gl.TEXTURE_MIN_FILTER, gl.NEAREST);
+            gl.texParameteri(textureTarget, gl.TEXTURE_MAG_FILTER, gl.NEAREST);
+            gl.texParameteri(textureTarget, gl.TEXTURE_WRAP_S, gl.CLAMP_TO_EDGE);
+            gl.texParameteri(textureTarget, gl.TEXTURE_WRAP_T, gl.CLAMP_TO_EDGE);
+            if (depthCompare) {
+                gl.texParameteri(textureTarget, gl.TEXTURE_COMPARE_MODE, gl.COMPARE_REF_TO_TEXTURE);
+                gl.texParameteri(textureTarget, gl.TEXTURE_COMPARE_FUNC, gl.LEQUAL);
+            }
+            if (dimension === "2d-array") {
+                gl.texImage3D(textureTarget, 0, gl.DEPTH_COMPONENT24, descriptor.width, descriptor.height, layerCount, 0, gl.DEPTH_COMPONENT, gl.UNSIGNED_INT, null);
+            }
+            else if (dimension === "cube") {
+                gl.texStorage2D(textureTarget, 1, gl.DEPTH_COMPONENT24, descriptor.width, descriptor.height);
+            }
+            else {
+                gl.texImage2D(textureTarget, 0, gl.DEPTH_COMPONENT24, descriptor.width, descriptor.height, 0, gl.DEPTH_COMPONENT, gl.UNSIGNED_INT, null);
+            }
         }
-        const webglOutputTarget = outputTarget;
-        const colorPass = options.passes.find((pass) => pass.name === "color-grade");
-        const fxaaPass = options.passes.find((pass) => pass.name === "fxaa");
-        const bloomOptions = bloomPass ? normalizeNativeBloomOptions(bloomPass.options) : undefined;
-        const depthOfFieldOptions = depthOfFieldPass ? normalizeNativeDepthOfFieldOptions(depthOfFieldPass.options) : undefined;
-        const motionBlurOptions = motionBlurPass
-            ? normalizeNativeMotionBlurOptions(motionBlurPass.options, source.width, source.height)
-            : undefined;
-        const ssaoOptions = ssaoPass ? normalizeNativeSsaoOptions(ssaoPass.options) : undefined;
-        const ssrOptions = ssrPass ? normalizeNativeSsrOptions(ssrPass.options) : undefined;
-        const taaOptions = taaPass ? normalizeNativeTaaOptions(taaPass.options, source.width, source.height) : undefined;
-        const outlineOptions = outlinePass ? normalizeNativeOutlineOptions(outlinePass.options) : undefined;
-        const program = this.ensureLdrPostprocessProgram();
-        const vertexArray = this.ensurePresentationVertexArray();
-        const sourceIsHdr = source.colorTexture.format !== "rgba8";
-        const bloomResources = bloomOptions || depthOfFieldOptions || motionBlurOptions || ssaoOptions || ssrOptions || taaOptions || outlineOptions
-            ? this.ensureBloomPingPongResources(source.width, source.height, sourceIsHdr && Boolean(bloomOptions))
-            : undefined;
-        if (bloomOptions && !sourceIsHdr) {
-            this.ensureBloomLutTextures(bloomOptions);
-        }
-        if (outlineOptions) {
-            this.ensureOutlineBlendLutTexture(outlineOptions);
-        }
-        if (motionBlurOptions) {
-            this.ensureMotionBlurVelocityTexture(source.width, source.height, motionBlurOptions.velocity);
-        }
-        if (taaOptions) {
-            this.ensureTaaHistoryTexture(source.width, source.height, taaOptions.history);
-        }
-        const outputWidth = webglOutputTarget?.width ?? (this.viewportWidth || this.gl.drawingBufferWidth);
-        const outputHeight = webglOutputTarget?.height ?? (this.viewportHeight || this.gl.drawingBufferHeight);
-        const previousState = this.prepareFullscreenPresentation(webglOutputTarget?.framebuffer ?? null, outputWidth, outputHeight);
-        try {
-            let ldrSourceHandle = source.colorHandle;
-            let temporarySourceIndex = -1;
-            if (bloomOptions && bloomResources) {
-                if (bloomOptions.quality === "performance") {
-                    ldrSourceHandle = this.executeNativeBloomPasses(ldrSourceHandle, bloomResources, bloomOptions, vertexArray, sourceIsHdr);
-                    temporarySourceIndex = 1;
-                    this.recordBloomDiagnostics(bloomOptions, source.width, source.height, sourceIsHdr, 1);
-                }
-                else {
-                    const plan = resolveBloomPyramidPlan(source.width, source.height, bloomOptions.quality, sourceIsHdr);
-                    const pyramid = this.ensureBloomPyramidResources(plan, sourceIsHdr);
-                    const pyramidResult = this.executeNativeBloomPyramidPasses(ldrSourceHandle, source.width, source.height, pyramid, {
-                        textureA: bloomResources.textures[0],
-                        framebufferA: bloomResources.framebuffers[0],
-                        textureB: bloomResources.textures[1],
-                        framebufferB: bloomResources.framebuffers[1]
-                    }, bloomOptions, vertexArray, sourceIsHdr);
-                    // The pyramid sum lands in ping-pong texture A; composite it with the
-                    // source through the proven single-scale composite program.
-                    this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, bloomResources.framebuffers[1]);
-                    this.gl.viewport(0, 0, source.width, source.height);
-                    const pyramidComposite = this.ensureBloomCompositeProgram();
-                    this.gl.useProgram(pyramidComposite);
-                    this.gl.bindVertexArray(vertexArray);
-                    this.bindFullscreenTexture(0, ldrSourceHandle);
-                    this.bindFullscreenTexture(1, pyramidResult);
-                    if (this.bloomCompositeLutTexture)
-                        this.bindFullscreenTexture(2, this.bloomCompositeLutTexture);
-                    this.gl.uniform1i(this.gl.getUniformLocation(pyramidComposite, "u_source"), 0);
-                    this.gl.uniform1i(this.gl.getUniformLocation(pyramidComposite, "u_blurred"), 1);
-                    this.gl.uniform1i(this.gl.getUniformLocation(pyramidComposite, "u_compositeLut"), 2);
-                    this.gl.uniform1i(this.gl.getUniformLocation(pyramidComposite, "u_hdr"), sourceIsHdr ? 1 : 0);
-                    this.gl.uniform1f(this.gl.getUniformLocation(pyramidComposite, "u_intensity"), bloomOptions.intensity);
-                    this.gl.drawArrays(this.gl.TRIANGLES, 0, 3);
-                    ldrSourceHandle = bloomResources.textures[1];
-                    // The composited result lives in texture B, so subsequent passes
-                    // must write texture A (index 0) to avoid sampling a bound target.
-                    temporarySourceIndex = 0;
-                    this.recordBloomDiagnostics(bloomOptions, source.width, source.height, sourceIsHdr, plan.mipCount);
-                }
+        let depthRenderbufferHandle = null;
+        if (depthMode === "renderbuffer") {
+            depthRenderbufferHandle = gl.createRenderbuffer();
+            if (!depthRenderbufferHandle) {
+                cleanup();
+                throw new RenderDeviceError("Failed to allocate WebGL render target", "WEBGL_ALLOCATION_FAILED", { label });
+            }
+            const previousRenderbuffer = gl.getParameter(gl.RENDERBUFFER_BINDING);
+            gl.bindRenderbuffer(gl.RENDERBUFFER, depthRenderbufferHandle);
+            gl.renderbufferStorage(gl.RENDERBUFFER, gl.DEPTH_COMPONENT16, descriptor.width, descriptor.height);
+            gl.bindRenderbuffer(gl.RENDERBUFFER, previousRenderbuffer);
+        }
+        const drawBuffers = depthOnly
+            ? [gl.NONE]
+            : colorFormats.map((_, attachment) => gl.COLOR_ATTACHMENT0 + attachment);
+        const attachLayer = (framebuffer, layer) => {
+            gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer);
+            if (depthOnly) {
+                gl.drawBuffers([gl.NONE]);
+                gl.readBuffer(gl.NONE);
+            }
+            else if (drawBuffers.length > 1) {
+                gl.drawBuffers(drawBuffers);
             }
-            if ((depthOfFieldOptions || motionBlurOptions || ssaoOptions || ssrOptions || taaOptions || outlineOptions) && bloomResources) {
-                if (tonePass || colorPass) {
-                    const baseTargetIndex = 0;
-                    this.drawNativeLdrStage(ldrSourceHandle, bloomResources.framebuffers[baseTargetIndex], source.width, source.height, program, vertexArray, tonePass, colorPass, undefined, options.toneMappingDefaults);
-                    ldrSourceHandle = bloomResources.textures[baseTargetIndex];
-                    temporarySourceIndex = baseTargetIndex;
+            for (let attachment = 0; attachment < colorHandles.length; attachment += 1) {
+                if (dimension === "cube") {
+                    gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0 + attachment, gl.TEXTURE_CUBE_MAP_POSITIVE_X + layer, colorHandles[attachment], 0);
                 }
-                if (depthOfFieldOptions && source.depthTextureHandle) {
-                    const depthOfFieldTargetIndex = temporarySourceIndex === 0 ? 1 : 0;
-                    ldrSourceHandle = this.executeNativeDepthOfFieldPass(ldrSourceHandle, source.depthTextureHandle, bloomResources, depthOfFieldOptions, vertexArray, depthOfFieldTargetIndex, depthRange);
-                    temporarySourceIndex = depthOfFieldTargetIndex;
+                else if (dimension === "2d-array") {
+                    gl.framebufferTextureLayer(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0 + attachment, colorHandles[attachment], 0, layer);
                 }
-                if (motionBlurOptions) {
-                    const motionBlurTargetIndex = temporarySourceIndex === 0 ? 1 : 0;
-                    ldrSourceHandle = this.executeNativeMotionBlurPass(ldrSourceHandle, bloomResources, motionBlurOptions, vertexArray, motionBlurTargetIndex);
-                    temporarySourceIndex = motionBlurTargetIndex;
+                else {
+                    gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0 + attachment, gl.TEXTURE_2D, colorHandles[attachment], 0);
                 }
-                if (ssaoOptions && source.depthTextureHandle) {
-                    const ssaoTargetIndex = temporarySourceIndex === 0 ? 1 : 0;
-                    ldrSourceHandle = this.executeNativeSsaoPass(ldrSourceHandle, source.depthTextureHandle, bloomResources, ssaoOptions, vertexArray, ssaoTargetIndex);
-                    temporarySourceIndex = ssaoTargetIndex;
+            }
+            if (depthTextureHandle) {
+                if (dimension === "cube") {
+                    gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.DEPTH_ATTACHMENT, gl.TEXTURE_CUBE_MAP_POSITIVE_X + layer, depthTextureHandle, 0);
                 }
-                if (ssrOptions && source.depthTextureHandle) {
-                    const ssrTargetIndex = temporarySourceIndex === 0 ? 1 : 0;
-                    ldrSourceHandle = this.executeNativeSsrPass(ldrSourceHandle, source.depthTextureHandle, bloomResources, ssrOptions, vertexArray, ssrTargetIndex, depthRange);
-                    temporarySourceIndex = ssrTargetIndex;
+                else if (dimension === "2d-array") {
+                    gl.framebufferTextureLayer(gl.FRAMEBUFFER, gl.DEPTH_ATTACHMENT, depthTextureHandle, 0, layer);
                 }
-                if (taaOptions) {
-                    const taaTargetIndex = temporarySourceIndex === 0 ? 1 : 0;
-                    ldrSourceHandle = this.executeNativeTaaPass(ldrSourceHandle, bloomResources, taaOptions, vertexArray, taaTargetIndex);
-                    temporarySourceIndex = taaTargetIndex;
+                else {
+                    gl.framebufferTexture2D(gl.FRAMEBUFFER, gl.DEPTH_ATTACHMENT, gl.TEXTURE_2D, depthTextureHandle, 0);
                 }
             }
-            if (outlineOptions && bloomResources) {
-                const outlineTargetIndex = temporarySourceIndex === 0 ? 1 : 0;
-                ldrSourceHandle = this.executeNativeOutlinePasses(ldrSourceHandle, bloomResources, outlineOptions, vertexArray, outlineTargetIndex);
-                temporarySourceIndex = outlineTargetIndex;
+            if (depthRenderbufferHandle) {
+                gl.framebufferRenderbuffer(gl.FRAMEBUFFER, gl.DEPTH_ATTACHMENT, gl.RENDERBUFFER, depthRenderbufferHandle);
+            }
+            return gl.checkFramebufferStatus(gl.FRAMEBUFFER) === gl.FRAMEBUFFER_COMPLETE;
+        };
+        for (let layer = 0; layer < layerCount; layer += 1) {
+            const framebuffer = gl.createFramebuffer();
+            if (!framebuffer) {
+                cleanup();
+                throw new RenderDeviceError("Failed to allocate WebGL render target", "WEBGL_ALLOCATION_FAILED", { label });
+            }
+            layerFramebuffers.push(framebuffer);
+            if (!attachLayer(framebuffer, layer)) {
+                const status = gl.checkFramebufferStatus(gl.FRAMEBUFFER);
+                cleanup();
+                if (depthRenderbufferHandle)
+                    gl.deleteRenderbuffer(depthRenderbufferHandle);
+                gl.bindFramebuffer(gl.FRAMEBUFFER, previousFramebuffer);
+                gl.bindTexture(gl.TEXTURE_2D, previousTexture);
+                if (previousCubeTexture !== null)
+                    gl.bindTexture(gl.TEXTURE_CUBE_MAP, previousCubeTexture);
+                if (previousArrayTexture !== null)
+                    gl.bindTexture(gl.TEXTURE_2D_ARRAY, previousArrayTexture);
+                gl.activeTexture(previousActiveTexture);
+                this.stateCache.invalidate();
+                throw new RenderDeviceError("WebGL render target framebuffer status is invalid", "FRAMEBUFFER_INVALID", { status, layer, label });
             }
-            this.drawNativeLdrStage(ldrSourceHandle, webglOutputTarget?.framebuffer ?? null, outputWidth, outputHeight, program, vertexArray, depthOfFieldOptions || motionBlurOptions || ssaoOptions || ssrOptions || taaOptions || outlineOptions ? undefined : tonePass, depthOfFieldOptions || motionBlurOptions || ssaoOptions || ssrOptions || taaOptions || outlineOptions ? undefined : colorPass, fxaaPass, options.toneMappingDefaults);
-            this.gl.flush();
-        }
-        finally {
-            this.restoreFullscreenPresentationState(previousState, outputWidth, outputHeight);
         }
-        this.lastError = this.readError();
-        if (this.lastError) {
-            throw new RenderDeviceError(`WebGL2 LDR postprocess presentation failed: ${this.lastError}`, "WEBGL_LDR_POSTPROCESS_FAILED", {
-                targetId: source.id,
-                error: this.lastError
-            });
+        gl.bindFramebuffer(gl.FRAMEBUFFER, previousFramebuffer);
+        gl.bindTexture(gl.TEXTURE_2D, previousTexture);
+        if (previousCubeTexture !== null)
+            gl.bindTexture(gl.TEXTURE_CUBE_MAP, previousCubeTexture);
+        if (previousArrayTexture !== null)
+            gl.bindTexture(gl.TEXTURE_2D_ARRAY, previousArrayTexture);
+        gl.activeTexture(previousActiveTexture);
+        this.stateCache.invalidate();
+        const colorTexture = colorTextures[0] ?? new Texture({ width: descriptor.width, height: descriptor.height, format: "rgba8", label: `${label}-colorless`, dimension, renderAttachment: true });
+        let parentColorHandle = colorHandles[0];
+        if (!parentColorHandle) {
+            // Depth-only targets keep a placeholder Texture in `colorTexture`; give it a
+            // real (never-attached, never-registered) GL handle so dispose stays sound.
+            parentColorHandle = gl.createTexture();
+            if (!parentColorHandle) {
+                cleanup();
+                if (depthRenderbufferHandle)
+                    gl.deleteRenderbuffer(depthRenderbufferHandle);
+                throw new RenderDeviceError("Failed to allocate WebGL render target", "WEBGL_ALLOCATION_FAILED", { label });
+            }
         }
-        this.setRenderTarget(webglOutputTarget ?? null);
-    }
-    readPixels(x, y, width, height) {
-        this.assertAlive();
-        if (![x, y, width, height].every(Number.isInteger) || x < 0 || y < 0 || width <= 0 || height <= 0) {
-            throw new RenderDeviceError("Readback rectangle must be positive and in bounds", "INVALID_READBACK_RECT", { x, y, width, height });
-        }
-        const boundsWidth = this.activeRenderTarget?.width ?? this.gl.drawingBufferWidth;
-        const boundsHeight = this.activeRenderTarget?.height ?? this.gl.drawingBufferHeight;
-        if (x + width > boundsWidth || y + height > boundsHeight) {
-            throw new RenderDeviceError("Readback rectangle exceeds framebuffer bounds", "READBACK_OUT_OF_BOUNDS", {
-                x,
-                y,
-                width,
-                height,
-                boundsWidth,
-                boundsHeight
-            });
+        const target = new WebGL2RenderTarget(this.nextId++, descriptor.width, descriptor.height, label, colorTexture, depthTexture, layerFramebuffers[0], parentColorHandle, depthRenderbufferHandle, depthTextureHandle, 1, layerFramebuffers[0], null, gl, {
+            dimension,
+            layers: layerCount > 1 ? layerCount : undefined,
+            colorTextures: colorTextures.length > 1 ? colorTextures : undefined,
+            extraColorHandles: colorHandles.slice(1),
+            layerFramebuffers,
+            layerChild: false
+        });
+        if (layerCount > 1) {
+            const children = layerFramebuffers.map((framebuffer, layer) => new WebGL2RenderTarget(this.nextId++, descriptor.width, descriptor.height, `${label}-layer-${layer}`, colorTexture, depthTexture, framebuffer, colorHandles[0], null, depthTextureHandle, 1, framebuffer, null, gl, { dimension, layers: 1, colorTextures: target.colorTextures, layerChild: true }));
+            // layerTargets shares parent GL resources; children only mark dispose.
+            target.layerTargets = children;
+            for (const child of children) {
+                this.renderTargets.add(child);
+            }
         }
-        const readTarget = this.activeRenderTarget;
-        if (readTarget) {
-            this.resolveMultisampleTarget(readTarget);
-            this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, readTarget.framebuffer);
+        this.renderTargets.add(target);
+        if (/shadow|(?:^|-)csm(?:-|$)/i.test(label))
+            this.host.counters.shadowRenderTargetsAllocated += 1;
+        for (let attachment = 0; attachment < colorHandles.length; attachment += 1) {
+            this.host.textureRegistry.textures.set(colorTextures[attachment], colorHandles[attachment]);
+            this.host.textureRegistry.textureUploadModes.set(colorTextures[attachment], colorFormats[attachment]);
         }
-        const pixels = new Uint8Array(width * height * 4);
-        this.gl.readPixels(x, y, width, height, this.gl.RGBA, this.gl.UNSIGNED_BYTE, pixels);
-        if (readTarget && readTarget.sampleCount > 1) {
-            this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, readTarget.drawFramebuffer);
-            this.stateCache.invalidate();
+        if (depthTexture && depthTextureHandle) {
+            this.host.textureRegistry.textures.set(depthTexture, depthTextureHandle);
+            this.host.textureRegistry.textureUploadModes.set(depthTexture, "depth-render-target");
         }
-        return pixels;
+        return target;
     }
-    readFloatPixels(x, y, width, height) {
-        this.assertAlive();
-        if (![x, y, width, height].every(Number.isInteger) || x < 0 || y < 0 || width <= 0 || height <= 0) {
-            throw new RenderDeviceError("Float readback rectangle must be positive and in bounds", "INVALID_READBACK_RECT", { x, y, width, height });
-        }
-        const boundsWidth = this.activeRenderTarget?.width ?? this.gl.drawingBufferWidth;
-        const boundsHeight = this.activeRenderTarget?.height ?? this.gl.drawingBufferHeight;
-        if (x + width > boundsWidth || y + height > boundsHeight) {
-            throw new RenderDeviceError("Float readback rectangle exceeds framebuffer bounds", "READBACK_OUT_OF_BOUNDS", {
-                x,
-                y,
-                width,
-                height,
-                boundsWidth,
-                boundsHeight
-            });
-        }
-        const readTarget = this.activeRenderTarget;
-        if (readTarget) {
-            this.resolveMultisampleTarget(readTarget);
-            this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, readTarget.framebuffer);
-        }
-        const pixels = new Float32Array(width * height * 4);
-        this.gl.readPixels(x, y, width, height, this.gl.RGBA, this.gl.FLOAT, pixels);
-        if (readTarget && readTarget.sampleCount > 1) {
-            this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, readTarget.drawFramebuffer);
-            this.stateCache.invalidate();
+    setRenderTarget(target) {
+        this.host.lifecycle.assertAlive();
+        if (this.host.activeRenderTarget && this.host.activeRenderTarget !== target) {
+            this.resolveMultisampleTarget(this.host.activeRenderTarget);
         }
-        return pixels;
-    }
-    readDepthPixels(x, y, width, height) {
-        this.assertAlive();
-        if (![x, y, width, height].every(Number.isInteger) || x < 0 || y < 0 || width <= 0 || height <= 0) {
-            throw new RenderDeviceError("Depth readback rectangle must be positive and in bounds", "INVALID_READBACK_RECT", { x, y, width, height });
-        }
-        const target = this.activeRenderTarget;
-        if (!target?.depthTextureHandle) {
-            throw new RenderDeviceError("Depth readback requires an active WebGL2 render target with a sampleable depth texture.", "DEPTH_READBACK_UNAVAILABLE", {
-                renderTarget: target?.label ?? null
-            });
+        if (target === null) {
+            this.host.activeRenderTarget = null;
+            this.stateCache.bindFramebuffer(this.gl.FRAMEBUFFER, null, () => this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, null));
+            this.stateCache.viewport(0, 0, this.host.lifecycle.viewportWidth || this.gl.drawingBufferWidth, this.host.lifecycle.viewportHeight || this.gl.drawingBufferHeight, () => this.gl.viewport(0, 0, this.host.lifecycle.viewportWidth || this.gl.drawingBufferWidth, this.host.lifecycle.viewportHeight || this.gl.drawingBufferHeight));
+            return;
         }
-        if (x + width > target.width || y + height > target.height) {
-            throw new RenderDeviceError("Depth readback rectangle exceeds framebuffer bounds", "READBACK_OUT_OF_BOUNDS", {
-                x,
-                y,
-                width,
-                height,
-                boundsWidth: target.width,
-                boundsHeight: target.height
+        if (!(target instanceof WebGL2RenderTarget) || !this.renderTargets.has(target) || target.disposed) {
+            throw new RenderDeviceError("Render target is not a live WebGL2 resource owned by this device", "INVALID_RESOURCE", {
+                targetId: target.id
             });
         }
-        this.resolveMultisampleTarget(target);
-        const encoded = this.copyDepthTextureToBytes(target, x, y, width, height);
-        const pixels = new Float32Array(width * height);
-        for (let index = 0; index < pixels.length; index += 1) {
-            const byteIndex = index * 4;
-            const r = encoded[byteIndex] ?? 255;
-            const g = encoded[byteIndex + 1] ?? 255;
-            const b = encoded[byteIndex + 2] ?? 255;
-            pixels[index] = Math.max(0, Math.min(1, r / 255 + g / 65025 + b / 16581375));
-        }
-        return pixels;
+        this.host.activeRenderTarget = target;
+        this.stateCache.bindFramebuffer(this.gl.FRAMEBUFFER, target.drawFramebuffer, () => this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, target.drawFramebuffer));
+        this.stateCache.viewport(0, 0, target.width, target.height, () => this.gl.viewport(0, 0, target.width, target.height));
     }
-    beginFrame(width, height) {
-        this.assertAlive();
-        if (this.frameActive) {
-            throw new RenderDeviceError("Frame is already active", "FRAME_ALREADY_ACTIVE");
-        }
-        if (width <= 0 || height <= 0) {
-            throw new RenderDeviceError("Frame dimensions must be positive", "INVALID_FRAME_SIZE", { width, height });
-        }
-        this.frameActive = true;
-        this.drawCalls = 0;
-        this.nativeEnvironmentBindings = 0;
-        this.nativeShadowMapBindings = 0;
-        this.activeTextureUnitIndex = -1;
-        this.textureUnitBindings.clear();
+    resolveMultisampleTarget(target) {
+        if (target.sampleCount <= 1 || !target.needsResolve)
+            return;
+        const previousFramebuffer = this.gl.getParameter(this.gl.FRAMEBUFFER_BINDING);
+        this.gl.bindFramebuffer(this.gl.READ_FRAMEBUFFER, target.drawFramebuffer);
+        this.gl.bindFramebuffer(this.gl.DRAW_FRAMEBUFFER, target.framebuffer);
+        let mask = this.gl.COLOR_BUFFER_BIT;
+        if (target.depthTextureHandle)
+            mask |= this.gl.DEPTH_BUFFER_BIT;
+        this.gl.blitFramebuffer(0, 0, target.width, target.height, 0, 0, target.width, target.height, mask, this.gl.NEAREST);
+        this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, previousFramebuffer);
+        target.needsResolve = false;
         this.stateCache.invalidate();
-        this.viewportWidth = width;
-        this.viewportHeight = height;
-        this.stateCache.bindFramebuffer(this.gl.FRAMEBUFFER, this.activeRenderTarget?.framebuffer ?? null, () => this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, this.activeRenderTarget?.framebuffer ?? null));
-        this.stateCache.viewport(0, 0, width, height, () => this.gl.viewport(0, 0, width, height));
-        this.stateCache.setEnabled(this.gl.DEPTH_TEST, true, () => this.gl.enable(this.gl.DEPTH_TEST));
-        this.stateCache.depthFunc(this.gl.LEQUAL, () => this.gl.depthFunc(this.gl.LEQUAL));
-    }
-    clear(color) {
-        this.assertFrame();
-        this.gl.clearColor(color[0], color[1], color[2], color[3]);
-        this.stateCache.depthMask(true, () => this.gl.depthMask(true));
-        this.gl.clearDepth(1);
-        this.gl.clear(this.gl.COLOR_BUFFER_BIT | this.gl.DEPTH_BUFFER_BIT);
-        if (this.activeRenderTarget?.sampleCount && this.activeRenderTarget.sampleCount > 1)
-            this.activeRenderTarget.needsResolve = true;
-    }
-    clearRenderTarget(color) {
-        this.assertFrame();
-        this.gl.clearColor(color[0], color[1], color[2], color[3]);
-        this.stateCache.depthMask(true, () => this.gl.depthMask(true));
-        this.gl.clearDepth(1);
-        this.gl.clear(this.gl.COLOR_BUFFER_BIT | this.gl.DEPTH_BUFFER_BIT);
-        if (this.activeRenderTarget?.sampleCount && this.activeRenderTarget.sampleCount > 1)
-            this.activeRenderTarget.needsResolve = true;
-    }
-    draw(command) {
-        this.assertFrame();
-        const vertexBuffer = this.requireBuffer(command.vertexBuffer);
-        this.applyRenderState(command.renderState);
-        let shader;
-        if (command.shader) {
-            const activeShader = this.requireShader(command.shader);
-            shader = activeShader;
-            this.stateCache.useProgram(activeShader.handle, () => this.gl.useProgram(activeShader.handle));
-            if (command.uniforms) {
-                this.uploadUniforms(activeShader, command.uniforms);
-                if (this.errorCheckMode === "strict") {
-                    const uniformError = this.readError();
-                    if (uniformError) {
-                        throw new RenderDeviceError(`WebGL2 uniform upload failed for draw ${command.label ?? "unnamed"}: ${uniformError}`, "WEBGL_DRAW_FAILED", {
-                            label: command.label,
-                            stage: "uniforms",
-                            error: uniformError
-                        });
-                    }
-                }
-            }
-        }
-        if (shader && command.vertexFormat) {
-            this.bindVertexArrayForCommand(command, shader, vertexBuffer);
-            if (this.errorCheckMode === "strict") {
-                const vertexFormatError = this.readError();
-                if (vertexFormatError) {
-                    throw new RenderDeviceError(`WebGL2 vertex format binding failed for draw ${command.label ?? "unnamed"}: ${vertexFormatError}`, "WEBGL_DRAW_FAILED", {
-                        label: command.label,
-                        stage: "vertex-format",
-                        error: vertexFormatError
-                    });
-                }
-            }
-        }
-        else {
-            this.bindNoVertexArray();
-            this.stateCache.bindBuffer(this.gl.ARRAY_BUFFER, vertexBuffer.handle, () => this.gl.bindBuffer(this.gl.ARRAY_BUFFER, vertexBuffer.handle));
-        }
-        if (command.indexBuffer) {
-            const indexBuffer = this.requireBuffer(command.indexBuffer);
-            if (!shader || !command.vertexFormat) {
-                this.stateCache.bindBuffer(this.gl.ELEMENT_ARRAY_BUFFER, indexBuffer.handle, () => this.gl.bindBuffer(this.gl.ELEMENT_ARRAY_BUFFER, indexBuffer.handle));
-            }
-            const type = command.indexType === "uint32" ? this.gl.UNSIGNED_INT : this.gl.UNSIGNED_SHORT;
-            const indexByteSize = command.indexType === "uint32" ? 4 : 2;
-            const indexOffset = (command.firstIndex ?? 0) * indexByteSize;
-            if ((command.instanceCount ?? 1) > 1) {
-                this.gl.drawElementsInstanced(this.primitive(command.topology), command.indexCount ?? 0, type, indexOffset, command.instanceCount ?? 1);
-                this.nativeInstancedSubmissions += 1;
-            }
-            else {
-                this.gl.drawElements(this.primitive(command.topology), command.indexCount ?? 0, type, indexOffset);
-            }
-        }
-        else {
-            if ((command.instanceCount ?? 1) > 1) {
-                this.gl.drawArraysInstanced(this.primitive(command.topology), command.firstVertex ?? 0, command.vertexCount, command.instanceCount ?? 1);
-                this.nativeInstancedSubmissions += 1;
-            }
-            else {
-                this.gl.drawArrays(this.primitive(command.topology), command.firstVertex ?? 0, command.vertexCount);
-            }
-        }
-        this.drawCalls += 1;
-        if (this.activeRenderTarget?.sampleCount && this.activeRenderTarget.sampleCount > 1)
-            this.activeRenderTarget.needsResolve = true;
-        if (this.errorCheckMode === "strict") {
-            const drawError = this.readError();
-            if (drawError) {
-                throw new RenderDeviceError(`WebGL2 draw failed for ${command.label ?? "unnamed"}: ${drawError}`, "WEBGL_DRAW_FAILED", {
-                    label: command.label,
-                    stage: "draw",
-                    error: drawError
-                });
-            }
-        }
-    }
-    endFrame() {
-        this.assertFrame();
-        this.frameActive = false;
-        this.lastError = this.readError();
     }
     captureState() {
         const viewport = this.gl.getParameter(this.gl.VIEWPORT);
         return new Map([
             ["backend", this.kind],
-            ["disposed", this.disposed],
-            ["contextLost", this.contextLost],
-            ["frameActive", this.frameActive],
+            ["disposed", this.host.disposed],
+            ["contextLost", this.host.contextLost],
+            ["frameActive", this.host.lifecycle.frameActive],
             ["depthTest", this.gl.isEnabled(this.gl.DEPTH_TEST)],
             ["blend", this.gl.isEnabled(this.gl.BLEND)],
             ["cullFace", this.gl.isEnabled(this.gl.CULL_FACE)],
             ["program", this.gl.getParameter(this.gl.CURRENT_PROGRAM) ? "bound" : null],
             ["arrayBuffer", this.gl.getParameter(this.gl.ARRAY_BUFFER_BINDING) ? "bound" : null],
             ["elementArrayBuffer", this.gl.getParameter(this.gl.ELEMENT_ARRAY_BUFFER_BINDING) ? "bound" : null],
-            ["viewportWidth", this.viewportWidth],
-            ["viewportHeight", this.viewportHeight],
+            ["viewportWidth", this.host.lifecycle.viewportWidth],
+            ["viewportHeight", this.host.lifecycle.viewportHeight],
             ["actualViewportWidth", viewport[2] ?? 0],
             ["actualViewportHeight", viewport[3] ?? 0],
-            ["renderTarget", this.activeRenderTarget?.label ?? null],
-            ["drawCalls", this.drawCalls],
-            ["shaderProgramCreates", this.shaderProgramCreateCount],
-            ["uniformLocationLookups", this.uniformLocationLookupCount],
-            ["bufferUpdates", this.bufferUpdateCount],
-            ["textureBinds", this.textureBindCount],
-            ["samplerParameterUploads", this.samplerParameterUploadCount],
-            ["vertexArrayCreates", this.vertexArrayCreateCount],
-            ["samplerObjects", this.samplerObjectCache.size],
-            ["samplerAnisotropyUploads", this.samplerAnisotropyUploadCount],
+            ["renderTarget", this.host.activeRenderTarget?.label ?? null],
+            ["drawCalls", this.host.counters.drawCalls],
+            ["nativeTemporalPasses", this.host.counters.nativeTemporalPasses],
+            ["nativeTemporalBindings", this.host.counters.nativeTemporalBindings],
+            ["shaderProgramCreates", this.host.counters.shaderProgramCreateCount],
+            ["uniformLocationLookups", this.host.counters.uniformLocationLookupCount],
+            ["bufferUpdates", this.host.counters.bufferUpdateCount],
+            ["textureBinds", this.host.counters.textureBindCount],
+            ["samplerParameterUploads", this.host.counters.samplerParameterUploadCount],
+            ["vertexArrayCreates", this.host.counters.vertexArrayCreateCount],
+            ["samplerObjects", this.host.samplers.samplerObjectCache.size],
+            ["samplerAnisotropyUploads", this.host.counters.samplerAnisotropyUploadCount],
             ["maxTextureAnisotropy", this.maxTextureAnisotropy],
-            ["nativeEnvironmentBindings", this.nativeEnvironmentBindings],
-            ["nativeShadowMapBindings", this.nativeShadowMapBindings],
-            ["nativeInstancedSubmissions", this.nativeInstancedSubmissions],
+            ["nativeEnvironmentBindings", this.host.counters.nativeEnvironmentBindings],
+            ["nativeShadowMapBindings", this.host.counters.nativeShadowMapBindings],
+            ["nativeInstancedSubmissions", this.host.counters.nativeInstancedSubmissions],
             ["stateCacheIssued", this.stateCache.stats().issued],
             ["stateCacheSkipped", this.stateCache.stats().skipped]
         ]);
     }
     getDiagnostics() {
-        this.releaseDisposedTextureHandles();
+        this.host.textureRegistry.releaseDisposedTextureHandles();
         const liveRenderTargets = [...this.renderTargets].filter((target) => !target.disposed);
         const liveTextures = new Set([
             ...liveRenderTargets.map((target) => target.colorTexture),
-            ...[...this.textures.keys()].filter((texture) => !texture.disposed)
+            ...[...this.host.textureRegistry.textures.keys()].filter((texture) => !texture.disposed)
         ]);
         const liveTextureList = [...liveTextures];
         const compressedTextures = liveTextureList.filter((texture) => isCompressedTextureFormat(texture.format));
-        const fallbackTextures = liveTextureList.filter((texture) => this.textureUploadModes.get(texture) === "fallback");
+        const fallbackTextures = liveTextureList.filter((texture) => this.host.textureRegistry.textureUploadModes.get(texture) === "fallback");
         const stateCacheStats = this.stateCache.stats();
         const bufferBytes = [...this.buffers].filter((buffer) => !buffer.disposed).reduce((total, buffer) => total + buffer.byteLength, 0);
         const textureBytes = liveTextureList.reduce((total, texture) => total + texture.byteLength, 0);
-        const gpuTargetEntries = this.describeGpuTargetInventory(liveRenderTargets);
+        const gpuTargetEntries = this.host.post.describeGpuTargetInventory(liveRenderTargets);
         return {
-            drawCalls: this.drawCalls,
+            drawCalls: this.host.counters.drawCalls,
             buffers: [...this.buffers].filter((buffer) => !buffer.disposed).length,
             shaders: [...this.shaders].filter((shader) => !shader.disposed).length,
             renderTargets: liveRenderTargets.length,
@@ -1085,12 +1125,14 @@ export class WebGL2Device {
             compressedTextureBytes: compressedTextures.reduce((total, texture) => total + texture.byteLength, 0),
             textureFallbacks: fallbackTextures.length,
             textureFallbackBytes: fallbackTextures.reduce((total, texture) => total + texture.fallbackByteLength, 0),
-            nativeEnvironmentBindings: this.nativeEnvironmentBindings,
-            nativeShadowMapBindings: this.nativeShadowMapBindings,
-            shadowRenderTargetsAllocated: this.shadowRenderTargetsAllocated,
-            nativeInstancedSubmissions: this.nativeInstancedSubmissions,
-            bloom: this.lastBloomDiagnostics,
-            samplerAnisotropyUploads: this.samplerAnisotropyUploadCount,
+            nativeEnvironmentBindings: this.host.counters.nativeEnvironmentBindings,
+            nativeShadowMapBindings: this.host.counters.nativeShadowMapBindings,
+            shadowRenderTargetsAllocated: this.host.counters.shadowRenderTargetsAllocated,
+            nativeInstancedSubmissions: this.host.counters.nativeInstancedSubmissions,
+            bloom: this.host.post.lastBloomDiagnostics,
+            nativeTemporalPasses: this.host.counters.nativeTemporalPasses,
+            nativeTemporalBindings: this.host.counters.nativeTemporalBindings,
+            samplerAnisotropyUploads: this.host.counters.samplerAnisotropyUploadCount,
             maxTextureAnisotropy: this.maxTextureAnisotropy,
             stateCacheIssued: stateCacheStats.issued,
             stateCacheSkipped: stateCacheStats.skipped,
@@ -1099,23 +1141,25 @@ export class WebGL2Device {
             stateCacheBufferBinds: stateCacheStats.byOperation.bindBuffer?.issued ?? 0,
             stateCacheVertexArrayBinds: stateCacheStats.byOperation.bindVertexArray?.issued ?? 0,
             stateCacheSamplerBinds: stateCacheStats.byOperation.bindSampler?.issued ?? 0,
-            disposedBuffers: [...this.buffers].filter((buffer) => buffer.disposed).length,
+            disposedBuffers: this.disposedBufferCount + [...this.buffers].filter((buffer) => buffer.disposed).length,
             disposedShaders: [...this.shaders].filter((shader) => shader.disposed).length,
             disposedRenderTargets: [...this.renderTargets].filter((target) => target.disposed).length,
-            disposedTextures: [...this.renderTargets].filter((target) => target.colorTexture.disposed).length + this.releasedTextureHandles,
+            disposedTextures: [...this.renderTargets].filter((target) => target.colorTexture.disposed).length + this.host.counters.releasedTextureHandles,
             ...spreadGpuTargetInventory(gpuTargetEntries),
-            lastError: this.lastError,
-            contextLost: this.contextLost
+            programCompileCount: this.host.counters.programCompiles,
+            readPixelsCalls: this.host.counters.readbacks,
+            lastError: this.host.lifecycle.lastError,
+            contextLost: this.host.contextLost
         };
     }
     dispose() {
-        if (this.canvas && "removeEventListener" in this.canvas) {
-            this.deviceLostListeners.clear();
-            this.deviceRestoredListeners.clear();
-            if (this.contextLostListener)
-                this.canvas.removeEventListener("webglcontextlost", this.contextLostListener);
-            if (this.contextRestoredListener)
-                this.canvas.removeEventListener("webglcontextrestored", this.contextRestoredListener);
+        if (this.host.lifecycle.canvas && "removeEventListener" in this.host.lifecycle.canvas) {
+            this.host.lifecycle.deviceLostListeners.clear();
+            this.host.lifecycle.deviceRestoredListeners.clear();
+            if (this.host.lifecycle.contextLostListener)
+                this.host.lifecycle.canvas.removeEventListener("webglcontextlost", this.host.lifecycle.contextLostListener);
+            if (this.host.lifecycle.contextRestoredListener)
+                this.host.lifecycle.canvas.removeEventListener("webglcontextrestored", this.host.lifecycle.contextRestoredListener);
         }
         for (const buffer of this.buffers) {
             buffer.dispose();
@@ -1126,1853 +1170,120 @@ export class WebGL2Device {
         for (const target of this.renderTargets) {
             target.dispose();
         }
-        for (const entry of this.vertexArrayCache.values()) {
+        for (const entry of this.host.drawBinder.vertexArrayCache.values()) {
             this.gl.deleteVertexArray(entry.handle);
         }
-        this.vertexArrayCache.clear();
-        for (const sampler of this.samplerObjectCache.values()) {
+        this.host.drawBinder.vertexArrayCache.clear();
+        for (const sampler of this.host.samplers.samplerObjectCache.values()) {
             this.gl.deleteSampler(sampler);
         }
-        this.samplerObjectCache.clear();
-        for (const texture of this.textures.values()) {
-            this.gl.deleteTexture(texture);
-        }
-        this.textureUploadModes.clear();
-        if (this.fallbackTexture) {
-            this.gl.deleteTexture(this.fallbackTexture);
-            this.fallbackTexture = null;
-        }
-        if (this.fallbackCubeTexture) {
-            this.gl.deleteTexture(this.fallbackCubeTexture);
-            this.fallbackCubeTexture = null;
-        }
-        if (this.presentationProgram) {
-            this.gl.deleteProgram(this.presentationProgram);
-            this.presentationProgram = null;
-        }
-        if (this.ldrPostprocessProgram) {
-            this.gl.deleteProgram(this.ldrPostprocessProgram);
-            this.ldrPostprocessProgram = null;
-        }
-        if (this.bloomBrightExtractProgram) {
-            this.gl.deleteProgram(this.bloomBrightExtractProgram);
-            this.bloomBrightExtractProgram = null;
-        }
-        if (this.bloomBlurProgram) {
-            this.gl.deleteProgram(this.bloomBlurProgram);
-            this.bloomBlurProgram = null;
-        }
-        if (this.bloomCompositeProgram) {
-            this.gl.deleteProgram(this.bloomCompositeProgram);
-            this.bloomCompositeProgram = null;
-        }
-        if (this.bloomDownsampleProgram) {
-            this.gl.deleteProgram(this.bloomDownsampleProgram);
-            this.bloomDownsampleProgram = null;
-        }
-        if (this.bloomAccumulateProgram) {
-            this.gl.deleteProgram(this.bloomAccumulateProgram);
-            this.bloomAccumulateProgram = null;
-        }
-        if (this.outlineProgram) {
-            this.gl.deleteProgram(this.outlineProgram);
-            this.outlineProgram = null;
-        }
-        if (this.ssaoProgram) {
-            this.gl.deleteProgram(this.ssaoProgram);
-            this.ssaoProgram = null;
-        }
-        if (this.ssrProgram) {
-            this.gl.deleteProgram(this.ssrProgram);
-            this.ssrProgram = null;
-        }
-        if (this.depthOfFieldProgram) {
-            this.gl.deleteProgram(this.depthOfFieldProgram);
-            this.depthOfFieldProgram = null;
-        }
-        if (this.motionBlurProgram) {
-            this.gl.deleteProgram(this.motionBlurProgram);
-            this.motionBlurProgram = null;
-        }
-        if (this.motionBlurVelocityTexture) {
-            this.gl.deleteTexture(this.motionBlurVelocityTexture);
-            this.motionBlurVelocityTexture = null;
-            this.motionBlurVelocitySize = null;
-        }
-        if (this.taaProgram) {
-            this.gl.deleteProgram(this.taaProgram);
-            this.taaProgram = null;
-        }
-        if (this.taaHistoryTexture) {
-            this.gl.deleteTexture(this.taaHistoryTexture);
-            this.taaHistoryTexture = null;
-            this.taaHistorySize = null;
-        }
-        this.disposeBloomPingPongResources();
-        this.disposeBloomPyramidResources();
-        if (this.bloomBrightLutTexture) {
-            this.gl.deleteTexture(this.bloomBrightLutTexture);
-            this.bloomBrightLutTexture = null;
-            this.bloomBrightLutThreshold = null;
-        }
-        if (this.bloomCompositeLutTexture) {
-            this.gl.deleteTexture(this.bloomCompositeLutTexture);
-            this.bloomCompositeLutTexture = null;
-            this.bloomCompositeLutIntensity = null;
-            this.bloomCompositeLutShoulder = null;
-        }
-        if (this.outlineBlendLutTexture) {
-            this.gl.deleteTexture(this.outlineBlendLutTexture);
-            this.outlineBlendLutTexture = null;
-            this.outlineBlendLutKey = null;
-        }
-        if (this.presentationVertexArray) {
-            this.gl.deleteVertexArray(this.presentationVertexArray);
-            this.presentationVertexArray = null;
-        }
-        if (this.depthReadbackProgram) {
-            this.gl.deleteProgram(this.depthReadbackProgram);
-            this.depthReadbackProgram = null;
-        }
-        this.textures.clear();
-        this.disposed = true;
-    }
-    copyDepthTextureToBytes(source, x, y, width, height) {
-        const colorHandle = this.gl.createTexture();
-        const framebuffer = this.gl.createFramebuffer();
-        if (!colorHandle || !framebuffer) {
-            if (colorHandle)
-                this.gl.deleteTexture(colorHandle);
-            if (framebuffer)
-                this.gl.deleteFramebuffer(framebuffer);
-            throw new RenderDeviceError("Failed to allocate WebGL2 depth readback target", "WEBGL_ALLOCATION_FAILED", {
-                renderTarget: source.label
-            });
-        }
-        const previousFramebuffer = this.gl.getParameter(this.gl.FRAMEBUFFER_BINDING);
-        const previousProgram = this.gl.getParameter(this.gl.CURRENT_PROGRAM);
-        const textureUnit0 = this.captureTextureUnit0();
-        const viewport = this.gl.getParameter(this.gl.VIEWPORT);
-        const depthTestEnabled = this.gl.isEnabled(this.gl.DEPTH_TEST);
-        const depthMask = this.gl.getParameter(this.gl.DEPTH_WRITEMASK);
-        const cullFaceEnabled = this.gl.isEnabled(this.gl.CULL_FACE);
-        const blendEnabled = this.gl.isEnabled(this.gl.BLEND);
-        const pixels = new Uint8Array(width * height * 4);
-        try {
-            this.gl.activeTexture(this.gl.TEXTURE0);
-            this.gl.bindTexture(this.gl.TEXTURE_2D, colorHandle);
-            this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_MIN_FILTER, this.gl.NEAREST);
-            this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_MAG_FILTER, this.gl.NEAREST);
-            this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_WRAP_S, this.gl.CLAMP_TO_EDGE);
-            this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_WRAP_T, this.gl.CLAMP_TO_EDGE);
-            this.gl.texImage2D(this.gl.TEXTURE_2D, 0, this.gl.RGBA8, width, height, 0, this.gl.RGBA, this.gl.UNSIGNED_BYTE, null);
-            this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, framebuffer);
-            this.gl.framebufferTexture2D(this.gl.FRAMEBUFFER, this.gl.COLOR_ATTACHMENT0, this.gl.TEXTURE_2D, colorHandle, 0);
-            const status = this.gl.checkFramebufferStatus(this.gl.FRAMEBUFFER);
-            if (status !== this.gl.FRAMEBUFFER_COMPLETE) {
-                throw new RenderDeviceError("WebGL2 depth readback framebuffer status is invalid", "FRAMEBUFFER_INVALID", {
-                    renderTarget: source.label,
-                    status
-                });
-            }
-            this.gl.viewport(0, 0, width, height);
-            this.gl.disable(this.gl.DEPTH_TEST);
-            this.gl.disable(this.gl.CULL_FACE);
-            this.gl.disable(this.gl.BLEND);
-            this.gl.depthMask(false);
-            this.gl.useProgram(this.ensureDepthReadbackProgram());
-            this.gl.activeTexture(this.gl.TEXTURE0);
-            this.gl.bindTexture(this.gl.TEXTURE_2D, source.depthTextureHandle);
-            this.gl.bindSampler(0, null);
-            this.gl.uniform1i(this.gl.getUniformLocation(this.ensureDepthReadbackProgram(), "u_depth"), 0);
-            this.gl.uniform4f(this.gl.getUniformLocation(this.ensureDepthReadbackProgram(), "u_sourceRect"), x / source.width, y / source.height, width / source.width, height / source.height);
-            this.gl.drawArrays(this.gl.TRIANGLES, 0, 3);
-            this.gl.readPixels(0, 0, width, height, this.gl.RGBA, this.gl.UNSIGNED_BYTE, pixels);
-            const error = this.readError();
-            if (error) {
-                throw new RenderDeviceError("WebGL2 depth texture readback failed", "WEBGL_DEPTH_READBACK_FAILED", {
-                    renderTarget: source.label,
-                    error
-                });
-            }
-            return pixels;
-        }
-        finally {
-            this.restoreTextureUnit0(textureUnit0);
-            this.gl.useProgram(previousProgram);
-            if (depthTestEnabled)
-                this.gl.enable(this.gl.DEPTH_TEST);
-            else
-                this.gl.disable(this.gl.DEPTH_TEST);
-            if (cullFaceEnabled)
-                this.gl.enable(this.gl.CULL_FACE);
-            else
-                this.gl.disable(this.gl.CULL_FACE);
-            if (blendEnabled)
-                this.gl.enable(this.gl.BLEND);
-            else
-                this.gl.disable(this.gl.BLEND);
-            this.gl.depthMask(depthMask);
-            this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, previousFramebuffer);
-            this.gl.viewport(viewport[0] ?? 0, viewport[1] ?? 0, viewport[2] ?? this.viewportWidth, viewport[3] ?? this.viewportHeight);
-            this.gl.deleteTexture(colorHandle);
-            this.gl.deleteFramebuffer(framebuffer);
-            this.stateCache.invalidate();
-        }
-    }
-    drawRenderTargetToBackbuffer(source, outputWidth, outputHeight) {
-        const program = this.ensurePresentationProgram();
-        const vertexArray = this.ensurePresentationVertexArray();
-        const previousState = this.prepareFullscreenPresentation(null, outputWidth, outputHeight);
-        this.gl.useProgram(program);
-        this.gl.bindVertexArray(vertexArray);
-        this.gl.activeTexture(this.gl.TEXTURE0);
-        this.gl.bindTexture(this.gl.TEXTURE_2D, source.colorHandle);
-        this.gl.bindSampler(0, null);
-        try {
-            const uniformLocation = this.gl.getUniformLocation(program, "u_source");
-            this.gl.uniform1i(uniformLocation, 0);
-            this.gl.drawArrays(this.gl.TRIANGLES, 0, 3);
-            this.gl.flush();
-        }
-        finally {
-            this.restoreFullscreenPresentationState(previousState, outputWidth, outputHeight);
-        }
-    }
-    ensureBloomPingPongResources(width, height, hdr = false) {
-        const current = this.bloomPingPongResources;
-        if (current && current.width === width && current.height === height && current.hdr === hdr) {
-            return current;
-        }
-        this.disposeBloomPingPongResources();
-        this.disposeBloomPyramidResources();
-        const textureUnit0 = this.captureTextureUnit0();
-        const previousFramebuffer = this.gl.getParameter(this.gl.FRAMEBUFFER_BINDING);
-        const textures = [];
-        const framebuffers = [];
-        try {
-            for (let index = 0; index < 2; index += 1) {
-                const texture = this.gl.createTexture();
-                const framebuffer = this.gl.createFramebuffer();
-                if (!texture || !framebuffer) {
-                    if (texture)
-                        this.gl.deleteTexture(texture);
-                    if (framebuffer)
-                        this.gl.deleteFramebuffer(framebuffer);
-                    throw new RenderDeviceError("Failed to allocate WebGL2 bloom ping-pong resources", "WEBGL_ALLOCATION_FAILED", {
-                        width,
-                        height,
-                        index
-                    });
-                }
-                textures.push(texture);
-                framebuffers.push(framebuffer);
-                this.gl.bindTexture(this.gl.TEXTURE_2D, texture);
-                this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_MIN_FILTER, this.gl.NEAREST);
-                this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_MAG_FILTER, this.gl.NEAREST);
-                this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_WRAP_S, this.gl.CLAMP_TO_EDGE);
-                this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_WRAP_T, this.gl.CLAMP_TO_EDGE);
-                this.gl.texImage2D(this.gl.TEXTURE_2D, 0, hdr ? this.gl.RGBA16F : this.gl.RGBA8, width, height, 0, this.gl.RGBA, hdr ? this.gl.HALF_FLOAT : this.gl.UNSIGNED_BYTE, null);
-                this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, framebuffer);
-                this.gl.framebufferTexture2D(this.gl.FRAMEBUFFER, this.gl.COLOR_ATTACHMENT0, this.gl.TEXTURE_2D, texture, 0);
-                const status = this.gl.checkFramebufferStatus(this.gl.FRAMEBUFFER);
-                if (status !== this.gl.FRAMEBUFFER_COMPLETE) {
-                    throw new RenderDeviceError("WebGL2 bloom ping-pong framebuffer status is invalid", "FRAMEBUFFER_INVALID", {
-                        width,
-                        height,
-                        index,
-                        status
-                    });
-                }
-            }
-            const resources = {
-                width,
-                height,
-                hdr,
-                textures: [textures[0], textures[1]],
-                framebuffers: [framebuffers[0], framebuffers[1]]
-            };
-            this.bloomPingPongResources = resources;
-            return resources;
-        }
-        catch (error) {
-            for (const texture of textures)
-                this.gl.deleteTexture(texture);
-            for (const framebuffer of framebuffers)
-                this.gl.deleteFramebuffer(framebuffer);
-            throw error;
-        }
-        finally {
-            this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, previousFramebuffer);
-            this.restoreTextureUnit0(textureUnit0);
-            this.stateCache.invalidate();
-        }
-    }
-    ensureBloomLutTextures(options) {
-        const updateBright = this.bloomBrightLutThreshold !== options.threshold;
-        const updateComposite = this.bloomCompositeLutIntensity !== options.intensity ||
-            this.bloomCompositeLutShoulder !== options.shoulder;
-        if (this.bloomBrightLutTexture && this.bloomCompositeLutTexture && !updateBright && !updateComposite) {
-            return;
-        }
-        const textureUnit0 = this.captureTextureUnit0();
-        try {
-            if (!this.bloomBrightLutTexture) {
-                this.bloomBrightLutTexture = this.createNativeBloomDataTexture();
-            }
-            if (updateBright) {
-                const pixels = createBloomBrightThresholdLut(options.threshold);
-                this.gl.bindTexture(this.gl.TEXTURE_2D, this.bloomBrightLutTexture);
-                this.gl.texImage2D(this.gl.TEXTURE_2D, 0, this.gl.RGBA8, BLOOM_BRIGHT_LUT_WIDTH, BLOOM_BRIGHT_LUT_HEIGHT, 0, this.gl.RGBA, this.gl.UNSIGNED_BYTE, pixels);
-                this.bloomBrightLutThreshold = options.threshold;
-            }
-            if (!this.bloomCompositeLutTexture) {
-                this.bloomCompositeLutTexture = this.createNativeBloomDataTexture();
-            }
-            if (updateComposite) {
-                const pixels = createBloomCompositeLut(options.intensity, { shoulder: options.shoulder });
-                this.gl.bindTexture(this.gl.TEXTURE_2D, this.bloomCompositeLutTexture);
-                this.gl.texImage2D(this.gl.TEXTURE_2D, 0, this.gl.RGBA8, BLOOM_COMPOSITE_LUT_SIZE, BLOOM_COMPOSITE_LUT_SIZE, 0, this.gl.RGBA, this.gl.UNSIGNED_BYTE, pixels);
-                this.bloomCompositeLutIntensity = options.intensity;
-                this.bloomCompositeLutShoulder = options.shoulder;
-            }
-        }
-        finally {
-            this.restoreTextureUnit0(textureUnit0);
-            this.stateCache.invalidate();
-        }
-    }
-    createNativeBloomDataTexture() {
-        const texture = this.gl.createTexture();
-        if (!texture) {
-            throw new RenderDeviceError("Failed to allocate WebGL2 bloom lookup texture", "WEBGL_ALLOCATION_FAILED");
-        }
-        this.gl.bindTexture(this.gl.TEXTURE_2D, texture);
-        this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_MIN_FILTER, this.gl.NEAREST);
-        this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_MAG_FILTER, this.gl.NEAREST);
-        this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_WRAP_S, this.gl.CLAMP_TO_EDGE);
-        this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_WRAP_T, this.gl.CLAMP_TO_EDGE);
-        return texture;
-    }
-    ensureOutlineBlendLutTexture(options) {
-        const combinedAlpha = options.opacity * (options.color[3] / 255);
-        const key = `${options.color.join(",")}|${combinedAlpha}`;
-        if (this.outlineBlendLutTexture && this.outlineBlendLutKey === key)
-            return;
-        const textureUnit0 = this.captureTextureUnit0();
-        try {
-            if (!this.outlineBlendLutTexture) {
-                this.outlineBlendLutTexture = this.createNativeBloomDataTexture();
-            }
-            this.gl.bindTexture(this.gl.TEXTURE_2D, this.outlineBlendLutTexture);
-            this.gl.texImage2D(this.gl.TEXTURE_2D, 0, this.gl.RGBA8, OUTLINE_BLEND_LUT_WIDTH, 1, 0, this.gl.RGBA, this.gl.UNSIGNED_BYTE, createOutlineBlendLut(options.color, combinedAlpha));
-            this.outlineBlendLutKey = key;
-        }
-        finally {
-            this.restoreTextureUnit0(textureUnit0);
-            this.stateCache.invalidate();
-        }
-    }
-    ensureMotionBlurVelocityTexture(width, height, velocity) {
-        const textureUnit0 = this.captureTextureUnit0();
-        try {
-            if (!this.motionBlurVelocityTexture) {
-                this.motionBlurVelocityTexture = this.createNativeBloomDataTexture();
-            }
-            this.motionBlurVelocitySize = { width, height };
-            this.gl.bindTexture(this.gl.TEXTURE_2D, this.motionBlurVelocityTexture);
-            this.gl.texImage2D(this.gl.TEXTURE_2D, 0, this.gl.RG32F, width, height, 0, this.gl.RG, this.gl.FLOAT, velocity);
-        }
-        finally {
-            this.restoreTextureUnit0(textureUnit0);
-            this.stateCache.invalidate();
-        }
-    }
-    ensureTaaHistoryTexture(width, height, history) {
-        const textureUnit0 = this.captureTextureUnit0();
-        try {
-            if (!this.taaHistoryTexture) {
-                this.taaHistoryTexture = this.createNativeBloomDataTexture();
-            }
-            this.taaHistorySize = { width, height };
-            this.gl.bindTexture(this.gl.TEXTURE_2D, this.taaHistoryTexture);
-            this.gl.texImage2D(this.gl.TEXTURE_2D, 0, this.gl.RGBA8, width, height, 0, this.gl.RGBA, this.gl.UNSIGNED_BYTE, history);
-        }
-        finally {
-            this.restoreTextureUnit0(textureUnit0);
-            this.stateCache.invalidate();
-        }
-    }
-    drawNativeLdrStage(sourceTexture, framebuffer, width, height, program, vertexArray, tonePass, colorPass, fxaaPass, toneMappingDefaults) {
-        const toneOptions = { ...(toneMappingDefaults ?? {}), ...(tonePass?.options ?? {}) };
-        const colorOptions = colorPass?.options ?? {};
-        const fxaaOptions = fxaaPass?.options ?? {};
-        this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, framebuffer);
-        this.gl.viewport(0, 0, width, height);
-        this.gl.useProgram(program);
-        this.gl.bindVertexArray(vertexArray);
-        this.bindFullscreenTexture(0, sourceTexture);
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_source"), 0);
-        this.gl.uniform2f(this.gl.getUniformLocation(program, "u_texelSize"), 1 / width, 1 / height);
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_hasToneMapping"), tonePass ? 1 : 0);
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_toneOperator"), toneMappingOperatorId(stringOption(toneOptions, "operator", "reinhard")));
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_inputColorSpace"), colorSpaceId(stringOption(toneOptions, "inputColorSpace", "linear")));
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_outputColorSpace"), colorSpaceId(stringOption(toneOptions, "outputColorSpace", "linear")));
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_exposure"), numberOption(toneOptions, "exposure", 1));
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_whitePoint"), Math.max(0.0001, numberOption(toneOptions, "whitePoint", 1)));
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_gamma"), Math.max(0.0001, numberOption(toneOptions, "gamma", 2.2)));
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_hasColorGrade"), colorPass ? 1 : 0);
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_contrast"), numberOption(colorOptions, "contrast", 1));
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_temperature"), numberOption(colorOptions, "temperature", 0));
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_tint"), numberOption(colorOptions, "tint", 0));
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_saturation"), numberOption(colorOptions, "saturation", 1));
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_vibrance"), numberOption(colorOptions, "vibrance", 0));
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_vignette"), numberOption(colorOptions, "vignette", 0));
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_sharpening"), numberOption(colorOptions, "sharpening", 0));
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_hasFxaa"), fxaaPass ? 1 : 0);
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_edgeThreshold"), numberOption(fxaaOptions, "edgeThreshold", 0.125));
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_subpixelBlend"), numberOption(fxaaOptions, "subpixelBlend", 0.75));
-        this.gl.drawArrays(this.gl.TRIANGLES, 0, 3);
-    }
-    executeNativeBloomPasses(sourceTexture, resources, options, vertexArray, hdr) {
-        const brightLut = this.bloomBrightLutTexture;
-        const compositeLut = this.bloomCompositeLutTexture;
-        if (!hdr && (!brightLut || !compositeLut)) {
-            throw new RenderDeviceError("WebGL2 bloom lookup textures were not initialized", "WEBGL_ALLOCATION_FAILED");
-        }
-        const [textureA, textureB] = resources.textures;
-        const [framebufferA, framebufferB] = resources.framebuffers;
-        const brightProgram = this.ensureBloomBrightExtractProgram();
-        this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, framebufferA);
-        this.gl.viewport(0, 0, resources.width, resources.height);
-        this.gl.useProgram(brightProgram);
-        this.gl.bindVertexArray(vertexArray);
-        this.bindFullscreenTexture(0, sourceTexture);
-        if (brightLut)
-            this.bindFullscreenTexture(1, brightLut);
-        this.gl.uniform1i(this.gl.getUniformLocation(brightProgram, "u_source"), 0);
-        this.gl.uniform1i(this.gl.getUniformLocation(brightProgram, "u_brightLut"), 1);
-        this.gl.uniform1i(this.gl.getUniformLocation(brightProgram, "u_hdr"), hdr ? 1 : 0);
-        this.gl.uniform1f(this.gl.getUniformLocation(brightProgram, "u_threshold"), options.threshold);
-        this.gl.uniform1f(this.gl.getUniformLocation(brightProgram, "u_softKnee"), options.softKnee);
-        this.gl.drawArrays(this.gl.TRIANGLES, 0, 3);
-        const blurProgram = this.ensureBloomBlurProgram();
-        this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, framebufferB);
-        this.gl.useProgram(blurProgram);
-        this.bindFullscreenTexture(0, textureA);
-        this.gl.uniform1i(this.gl.getUniformLocation(blurProgram, "u_source"), 0);
-        this.gl.uniform2i(this.gl.getUniformLocation(blurProgram, "u_size"), resources.width, resources.height);
-        this.gl.uniform1i(this.gl.getUniformLocation(blurProgram, "u_radius"), options.radius);
-        this.gl.uniform1i(this.gl.getUniformLocation(blurProgram, "u_horizontal"), 1);
-        this.gl.uniform1i(this.gl.getUniformLocation(blurProgram, "u_hdr"), hdr ? 1 : 0);
-        this.gl.drawArrays(this.gl.TRIANGLES, 0, 3);
-        this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, framebufferA);
-        this.bindFullscreenTexture(0, textureB);
-        this.gl.uniform1i(this.gl.getUniformLocation(blurProgram, "u_horizontal"), 0);
-        this.gl.drawArrays(this.gl.TRIANGLES, 0, 3);
-        const compositeProgram = this.ensureBloomCompositeProgram();
-        this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, framebufferB);
-        this.gl.useProgram(compositeProgram);
-        this.bindFullscreenTexture(0, sourceTexture);
-        this.bindFullscreenTexture(1, textureA);
-        if (compositeLut)
-            this.bindFullscreenTexture(2, compositeLut);
-        this.gl.uniform1i(this.gl.getUniformLocation(compositeProgram, "u_source"), 0);
-        this.gl.uniform1i(this.gl.getUniformLocation(compositeProgram, "u_blurred"), 1);
-        this.gl.uniform1i(this.gl.getUniformLocation(compositeProgram, "u_compositeLut"), 2);
-        this.gl.uniform1i(this.gl.getUniformLocation(compositeProgram, "u_hdr"), hdr ? 1 : 0);
-        this.gl.uniform1f(this.gl.getUniformLocation(compositeProgram, "u_intensity"), options.intensity);
-        this.gl.drawArrays(this.gl.TRIANGLES, 0, 3);
-        return textureB;
-    }
-    /**
-     * Balanced/cinematic bloom: bright-extract once, then a half-resolution mip
-     * chain where every level is downsampled, separably blurred, and accumulated
-     * with its energy-preserving weight. Returns a full-resolution bloom texture
-     * holding the weighted sum, ready for the existing composite program.
-     */
-    executeNativeBloomPyramidPasses(sourceTexture, sourceWidth, sourceHeight, resources, fullResStaging, options, vertexArray, hdr) {
-        const plan = resources.plan;
-        const mipCount = plan.mips.length;
-        const downsampleProgram = this.ensureBloomDownsampleProgram();
-        const brightProgram = this.ensureBloomBrightExtractProgram();
-        const blurProgram = this.ensureBloomBlurProgram();
-        const accumulateProgram = this.ensureBloomAccumulateProgram();
-        const brightLut = this.bloomBrightLutTexture;
-        const mipTexture = (level, slot) => resources.textures[level * 2 + slot];
-        const mipFramebuffer = (level, slot) => resources.framebuffers[level * 2 + slot];
-        const mipSize = (level) => plan.mips[level];
-        // Blurred result settles in slot 1 for level 0, slot 0 for levels >= 1.
-        const blurredSlot = (level) => (level === 0 ? 1 : 0);
-        const drawDownsample = (fromTexture, fromWidth, fromHeight, toFramebuffer, toWidth, toHeight) => {
-            this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, toFramebuffer);
-            this.gl.viewport(0, 0, toWidth, toHeight);
-            this.gl.useProgram(downsampleProgram);
-            this.gl.bindVertexArray(vertexArray);
-            this.bindFullscreenTexture(0, fromTexture);
-            this.gl.uniform1i(this.gl.getUniformLocation(downsampleProgram, "u_source"), 0);
-            this.gl.uniform2f(this.gl.getUniformLocation(downsampleProgram, "u_texelSize"), 1 / fromWidth, 1 / fromHeight);
-            this.gl.drawArrays(this.gl.TRIANGLES, 0, 3);
-        };
-        const drawBrightExtract = (fromTexture, toFramebuffer, size) => {
-            this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, toFramebuffer);
-            this.gl.viewport(0, 0, size.width, size.height);
-            this.gl.useProgram(brightProgram);
-            this.gl.bindVertexArray(vertexArray);
-            this.bindFullscreenTexture(0, fromTexture);
-            if (brightLut)
-                this.bindFullscreenTexture(1, brightLut);
-            this.gl.uniform1i(this.gl.getUniformLocation(brightProgram, "u_source"), 0);
-            this.gl.uniform1i(this.gl.getUniformLocation(brightProgram, "u_brightLut"), 1);
-            this.gl.uniform1i(this.gl.getUniformLocation(brightProgram, "u_hdr"), hdr ? 1 : 0);
-            this.gl.uniform1f(this.gl.getUniformLocation(brightProgram, "u_threshold"), options.threshold);
-            this.gl.uniform1f(this.gl.getUniformLocation(brightProgram, "u_softKnee"), options.softKnee);
-            this.gl.drawArrays(this.gl.TRIANGLES, 0, 3);
-        };
-        const drawSeparableBlur = (readTexture, tmpTexture, tmpFramebuffer, outFramebuffer, size) => {
-            // Horizontal into the temp target, vertical back into the output target.
-            this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, tmpFramebuffer);
-            this.gl.viewport(0, 0, size.width, size.height);
-            this.gl.useProgram(blurProgram);
-            this.gl.bindVertexArray(vertexArray);
-            this.bindFullscreenTexture(0, readTexture);
-            this.gl.uniform1i(this.gl.getUniformLocation(blurProgram, "u_source"), 0);
-            this.gl.uniform2i(this.gl.getUniformLocation(blurProgram, "u_size"), size.width, size.height);
-            this.gl.uniform1i(this.gl.getUniformLocation(blurProgram, "u_radius"), options.radius);
-            this.gl.uniform1i(this.gl.getUniformLocation(blurProgram, "u_horizontal"), 1);
-            this.gl.uniform1i(this.gl.getUniformLocation(blurProgram, "u_hdr"), hdr ? 1 : 0);
-            this.gl.drawArrays(this.gl.TRIANGLES, 0, 3);
-            this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, outFramebuffer);
-            this.bindFullscreenTexture(0, tmpTexture);
-            this.gl.uniform1i(this.gl.getUniformLocation(blurProgram, "u_horizontal"), 0);
-            this.gl.drawArrays(this.gl.TRIANGLES, 0, 3);
-        };
-        // Level 0: downsample, bright-extract into slot 1, blur H into slot 0 and
-        // V back into slot 1. Blurred result settles in slot 1.
-        const level0 = mipSize(0);
-        drawDownsample(sourceTexture, sourceWidth, sourceHeight, mipFramebuffer(0, 0), level0.width, level0.height);
-        drawBrightExtract(mipTexture(0, 0), mipFramebuffer(0, 1), level0);
-        drawSeparableBlur(mipTexture(0, 1), mipTexture(0, 0), mipFramebuffer(0, 0), mipFramebuffer(0, 1), level0);
-        for (let level = 1; level < mipCount; level += 1) {
-            const size = mipSize(level);
-            const previous = mipSize(level - 1);
-            drawDownsample(mipTexture(level - 1, blurredSlot(level - 1)), previous.width, previous.height, mipFramebuffer(level, 0), size.width, size.height);
-            // H into slot 1, V back into slot 0: blurred result settles in slot 0.
-            drawSeparableBlur(mipTexture(level, 0), mipTexture(level, 1), mipFramebuffer(level, 1), mipFramebuffer(level, 0), size);
-        }
-        // Accumulate smallest-to-largest, ping-ponging between the two
-        // accumulators (a pass must never sample its own bound target).
-        const weights = plan.weights;
-        let readAccumulator = { texture: resources.accumulatorTextureA, framebuffer: resources.accumulatorFramebufferA };
-        let writeAccumulator = { texture: resources.accumulatorTextureB, framebuffer: resources.accumulatorFramebufferB };
-        // Clear both accumulators; the seed reads the cleared sibling, never the
-        // bound target (feedback loop).
-        for (const acc of [readAccumulator, writeAccumulator]) {
-            this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, acc.framebuffer);
-            this.gl.viewport(0, 0, level0.width, level0.height);
-            this.gl.clearColor(0, 0, 0, 0);
-            this.gl.clear(this.gl.COLOR_BUFFER_BIT);
-        }
-        // Seed: smallest mip onto the cleared sibling accumulator.
-        this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, writeAccumulator.framebuffer);
-        this.gl.viewport(0, 0, level0.width, level0.height);
-        this.gl.useProgram(accumulateProgram);
-        this.gl.bindVertexArray(vertexArray);
-        this.bindFullscreenTexture(0, readAccumulator.texture);
-        this.bindFullscreenTexture(1, mipTexture(mipCount - 1, blurredSlot(mipCount - 1)));
-        this.gl.uniform1i(this.gl.getUniformLocation(accumulateProgram, "u_base"), 0);
-        this.gl.uniform1i(this.gl.getUniformLocation(accumulateProgram, "u_bloom"), 1);
-        this.gl.uniform1f(this.gl.getUniformLocation(accumulateProgram, "u_weight"), weights[mipCount - 1]);
-        this.gl.drawArrays(this.gl.TRIANGLES, 0, 3);
-        for (let level = mipCount - 2; level >= 0; level -= 1) {
-            const nextRead = writeAccumulator;
-            const nextWrite = readAccumulator;
-            readAccumulator = nextRead;
-            writeAccumulator = nextWrite;
-            this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, writeAccumulator.framebuffer);
-            this.gl.viewport(0, 0, level0.width, level0.height);
-            this.gl.useProgram(accumulateProgram);
-            this.gl.bindVertexArray(vertexArray);
-            this.bindFullscreenTexture(0, readAccumulator.texture);
-            this.bindFullscreenTexture(1, mipTexture(level, blurredSlot(level)));
-            this.gl.uniform1i(this.gl.getUniformLocation(accumulateProgram, "u_base"), 0);
-            this.gl.uniform1i(this.gl.getUniformLocation(accumulateProgram, "u_bloom"), 1);
-            this.gl.uniform1f(this.gl.getUniformLocation(accumulateProgram, "u_weight"), weights[level]);
-            this.gl.drawArrays(this.gl.TRIANGLES, 0, 3);
-        }
-        // Upsample the weighted sum onto full-resolution staging target A, using
-        // the cleared staging target B as the zero base (never sample A while
-        // rendering into it).
-        this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, fullResStaging.framebufferB);
-        this.gl.viewport(0, 0, sourceWidth, sourceHeight);
-        this.gl.clearColor(0, 0, 0, 0);
-        this.gl.clear(this.gl.COLOR_BUFFER_BIT);
-        this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, fullResStaging.framebufferA);
-        this.gl.viewport(0, 0, sourceWidth, sourceHeight);
-        this.gl.useProgram(accumulateProgram);
-        this.gl.bindVertexArray(vertexArray);
-        this.bindFullscreenTexture(0, fullResStaging.textureB);
-        this.bindFullscreenTexture(1, writeAccumulator.texture);
-        this.gl.uniform1i(this.gl.getUniformLocation(accumulateProgram, "u_base"), 0);
-        this.gl.uniform1i(this.gl.getUniformLocation(accumulateProgram, "u_bloom"), 1);
-        this.gl.uniform1f(this.gl.getUniformLocation(accumulateProgram, "u_weight"), 1);
-        this.gl.drawArrays(this.gl.TRIANGLES, 0, 3);
-        return fullResStaging.textureA;
-    }
-    executeNativeOutlinePasses(sourceTexture, resources, options, vertexArray, targetIndex) {
-        const blendLut = this.outlineBlendLutTexture;
-        if (!blendLut) {
-            throw new RenderDeviceError("WebGL2 outline lookup texture was not initialized", "WEBGL_ALLOCATION_FAILED");
-        }
-        const program = this.ensureOutlineProgram();
-        const targetTexture = resources.textures[targetIndex];
-        const targetFramebuffer = resources.framebuffers[targetIndex];
-        const bound = createOutlineGradientBound(options.threshold);
-        this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, targetFramebuffer);
-        this.gl.viewport(0, 0, resources.width, resources.height);
-        this.gl.useProgram(program);
-        this.gl.bindVertexArray(vertexArray);
-        this.bindFullscreenTexture(0, sourceTexture);
-        this.bindFullscreenTexture(1, blendLut);
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_source"), 0);
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_blendLut"), 1);
-        this.gl.uniform2i(this.gl.getUniformLocation(program, "u_size"), resources.width, resources.height);
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_width"), options.width);
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_boundHigh"), bound.highWord);
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_boundLow"), bound.lowWord);
-        this.gl.drawArrays(this.gl.TRIANGLES, 0, 3);
-        return targetTexture;
-    }
-    executeNativeSsaoPass(sourceTexture, depthTexture, resources, options, vertexArray, targetIndex) {
-        const program = this.ensureSsaoProgram();
-        const targetTexture = resources.textures[targetIndex];
-        this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, resources.framebuffers[targetIndex]);
-        this.gl.viewport(0, 0, resources.width, resources.height);
-        this.gl.useProgram(program);
-        this.gl.bindVertexArray(vertexArray);
-        this.bindFullscreenTexture(0, sourceTexture);
-        this.bindFullscreenTexture(1, depthTexture);
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_source"), 0);
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_depth"), 1);
-        this.gl.uniform2i(this.gl.getUniformLocation(program, "u_size"), resources.width, resources.height);
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_radius"), options.radius);
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_intensity"), options.intensity);
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_bias"), options.bias);
-        this.gl.drawArrays(this.gl.TRIANGLES, 0, 3);
-        return targetTexture;
-    }
-    executeNativeSsrPass(sourceTexture, depthTexture, resources, options, vertexArray, targetIndex, depthRange) {
-        const program = this.ensureSsrProgram();
-        const targetTexture = resources.textures[targetIndex];
-        this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, resources.framebuffers[targetIndex]);
-        this.gl.viewport(0, 0, resources.width, resources.height);
-        this.gl.useProgram(program);
-        this.gl.bindVertexArray(vertexArray);
-        this.bindFullscreenTexture(0, sourceTexture);
-        this.bindFullscreenTexture(1, depthTexture);
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_source"), 0);
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_depth"), 1);
-        this.gl.uniform2i(this.gl.getUniformLocation(program, "u_size"), resources.width, resources.height);
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_intensity"), options.intensity);
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_maxDistance"), options.maxDistance);
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_depthNear"), depthRange.near);
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_depthFar"), depthRange.far);
-        this.gl.drawArrays(this.gl.TRIANGLES, 0, 3);
-        return targetTexture;
-    }
-    executeNativeDepthOfFieldPass(sourceTexture, depthTexture, resources, options, vertexArray, targetIndex, depthRange) {
-        const program = this.ensureDepthOfFieldProgram();
-        const targetTexture = resources.textures[targetIndex];
-        this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, resources.framebuffers[targetIndex]);
-        this.gl.viewport(0, 0, resources.width, resources.height);
-        this.gl.useProgram(program);
-        this.gl.bindVertexArray(vertexArray);
-        this.bindFullscreenTexture(0, sourceTexture);
-        this.bindFullscreenTexture(1, depthTexture);
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_source"), 0);
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_depth"), 1);
-        this.gl.uniform2i(this.gl.getUniformLocation(program, "u_size"), resources.width, resources.height);
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_focusDepth"), options.focusDepth);
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_focusRange"), options.focusRange);
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_maxRadius"), options.maxRadius);
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_depthNear"), depthRange.near);
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_depthFar"), depthRange.far);
-        this.gl.drawArrays(this.gl.TRIANGLES, 0, 3);
-        return targetTexture;
-    }
-    executeNativeMotionBlurPass(sourceTexture, resources, options, vertexArray, targetIndex) {
-        const velocityTexture = this.motionBlurVelocityTexture;
-        if (!velocityTexture) {
-            throw new RenderDeviceError("WebGL2 motion-blur velocity texture was not initialized", "WEBGL_ALLOCATION_FAILED");
-        }
-        const program = this.ensureMotionBlurProgram();
-        const targetTexture = resources.textures[targetIndex];
-        this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, resources.framebuffers[targetIndex]);
-        this.gl.viewport(0, 0, resources.width, resources.height);
-        this.gl.useProgram(program);
-        this.gl.bindVertexArray(vertexArray);
-        this.bindFullscreenTexture(0, sourceTexture);
-        this.bindFullscreenTexture(1, velocityTexture);
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_source"), 0);
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_velocity"), 1);
-        this.gl.uniform2i(this.gl.getUniformLocation(program, "u_size"), resources.width, resources.height);
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_samples"), options.samples);
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_scale"), options.scale);
-        this.gl.drawArrays(this.gl.TRIANGLES, 0, 3);
-        return targetTexture;
-    }
-    executeNativeTaaPass(sourceTexture, resources, options, vertexArray, targetIndex) {
-        const historyTexture = this.taaHistoryTexture;
-        if (!historyTexture) {
-            throw new RenderDeviceError("WebGL2 TAA history texture was not initialized", "WEBGL_ALLOCATION_FAILED");
-        }
-        const program = this.ensureTaaProgram();
-        const targetTexture = resources.textures[targetIndex];
-        this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, resources.framebuffers[targetIndex]);
-        this.gl.viewport(0, 0, resources.width, resources.height);
-        this.gl.useProgram(program);
-        this.gl.bindVertexArray(vertexArray);
-        this.bindFullscreenTexture(0, sourceTexture);
-        this.bindFullscreenTexture(1, historyTexture);
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_source"), 0);
-        this.gl.uniform1i(this.gl.getUniformLocation(program, "u_history"), 1);
-        this.gl.uniform1f(this.gl.getUniformLocation(program, "u_blend"), options.blend);
-        this.gl.drawArrays(this.gl.TRIANGLES, 0, 3);
-        return targetTexture;
-    }
-    bindFullscreenTexture(unit, texture) {
-        this.gl.activeTexture(this.gl.TEXTURE0 + unit);
-        this.gl.bindTexture(this.gl.TEXTURE_2D, texture);
-        this.gl.bindSampler(unit, null);
-    }
-    disposeBloomPingPongResources() {
-        if (!this.bloomPingPongResources)
-            return;
-        for (const texture of this.bloomPingPongResources.textures)
-            this.gl.deleteTexture(texture);
-        for (const framebuffer of this.bloomPingPongResources.framebuffers)
-            this.gl.deleteFramebuffer(framebuffer);
-        this.bloomPingPongResources = null;
-    }
-    /**
-     * Diagnostics for the most recent native bloom execution (muse3jsparity-PRD
-     * A1). Null when no native bloom pass has run yet on this device.
-     */
-    getBloomDiagnostics() {
-        return this.lastBloomDiagnostics;
-    }
-    recordBloomDiagnostics(options, sourceWidth, sourceHeight, hdr, mipCount) {
-        const plan = resolveBloomPyramidPlan(sourceWidth, sourceHeight, options.quality, hdr);
-        const pingPongBytes = sourceWidth * sourceHeight * 4 * (hdr ? 2 : 1) * 2;
-        const bytesPerChannel = plan.halfFloat ? 2 : 1;
-        const level0 = plan.mips[0];
-        const accumulatorBytes = level0.width * level0.height * 4 * bytesPerChannel;
-        this.lastBloomDiagnostics = {
-            quality: options.quality,
-            mipCount,
-            targetCount: options.quality === "performance" ? 2 : plan.mips.length * 2 + 1,
-            targetBytes: (options.quality === "performance" ? pingPongBytes : plan.targetBytes + accumulatorBytes + pingPongBytes),
-            compositeGain: options.intensity,
-            threshold: options.threshold,
-            intensity: options.intensity,
-            softKnee: options.softKnee,
-            shoulder: options.shoulder,
-            halfFloat: hdr || plan.halfFloat,
-        };
-    }
-    /**
-     * PART U: every live GPU allocation with bytes + lane owner — registry
-     * render targets (B1 shadow maps arrive labeled, B4 captures arrive as
-     * `-mirror-target`/`-scene-color-target`) plus the raw-handle residents the
-     * registry set cannot see: the A1 bloom pyramid (two targets per mip plus
-     * two level-0 accumulators), the legacy bloom ping-pong pair, the A1/A3
-     * lookup textures, and the motion-blur/taa history textures. The
-     * depth-readback scratch pair is intentionally absent: it is allocated and
-     * deleted inside one synchronous call, so it is never live at a diagnostics
-     * boundary. A5 volumetric light, C4 decals, and the G1 SDF atlas own no GPU
-     * target (forward uniforms + CPU kernel, CPU geometry, CPU atlas data), so
-     * no entry is emitted for them; a target appearing under their owner would
-     * be the signal that the lane grew one.
-     */
-    describeGpuTargetInventory(liveRenderTargets) {
-        const entries = liveRenderTargets.map((target) => ({
-            label: target.label,
-            kind: "render-target",
-            bytes: target.colorTexture.byteLength + (target.depthTexture?.byteLength ?? 0),
-            owner: resolveGpuTargetOwner(target.label)
-        }));
-        const pyramid = this.bloomPyramidResources;
-        if (pyramid) {
-            const bytesPerPixel = pyramid.hdr ? 8 : 4;
-            pyramid.plan.mips.forEach((mip, index) => {
-                for (const side of ["a", "b"]) {
-                    entries.push({
-                        label: `bloom-pyramid-mip${index}${side}`,
-                        kind: "pyramid-mip",
-                        bytes: mip.width * mip.height * bytesPerPixel,
-                        owner: "a1-bloom"
-                    });
-                }
-            });
-            const level0 = pyramid.plan.mips[0];
-            if (level0) {
-                for (const side of ["a", "b"]) {
-                    entries.push({
-                        label: `bloom-pyramid-accumulator-${side}`,
-                        kind: "pyramid-accumulator",
-                        bytes: level0.width * level0.height * bytesPerPixel,
-                        owner: "a1-bloom"
-                    });
-                }
-            }
-        }
-        const pingPong = this.bloomPingPongResources;
-        if (pingPong) {
-            const bytesPerPixel = pingPong.hdr ? 8 : 4;
-            for (const side of ["a", "b"]) {
-                entries.push({
-                    label: `bloom-ping-pong-${side}`,
-                    kind: "ping-pong",
-                    bytes: pingPong.width * pingPong.height * bytesPerPixel,
-                    owner: "a1-bloom"
-                });
-            }
-        }
-        if (this.bloomBrightLutTexture) {
-            entries.push({
-                label: "bloom-bright-lut",
-                kind: "lut",
-                bytes: BLOOM_BRIGHT_LUT_WIDTH * BLOOM_BRIGHT_LUT_HEIGHT * 4,
-                owner: "a1-bloom"
-            });
-        }
-        if (this.bloomCompositeLutTexture) {
-            entries.push({
-                label: "bloom-composite-lut",
-                kind: "lut",
-                bytes: BLOOM_COMPOSITE_LUT_SIZE * BLOOM_COMPOSITE_LUT_SIZE * 4,
-                owner: "a1-bloom"
-            });
-        }
-        if (this.outlineBlendLutTexture) {
-            entries.push({ label: "outline-blend-lut", kind: "lut", bytes: OUTLINE_BLEND_LUT_WIDTH * 4, owner: "post" });
-        }
-        if (this.motionBlurVelocityTexture && this.motionBlurVelocitySize) {
-            entries.push({
-                label: "motion-blur-velocity",
-                kind: "history",
-                bytes: this.motionBlurVelocitySize.width * this.motionBlurVelocitySize.height * 8,
-                owner: "post"
-            });
-        }
-        if (this.taaHistoryTexture && this.taaHistorySize) {
-            entries.push({
-                label: "taa-history",
-                kind: "history",
-                bytes: this.taaHistorySize.width * this.taaHistorySize.height * 4,
-                owner: "post"
-            });
-        }
-        return entries;
-    }
-    disposeBloomPyramidResources() {
-        if (!this.bloomPyramidResources)
-            return;
-        for (const texture of this.bloomPyramidResources.textures)
+        this.host.samplers.samplerObjectCache.clear();
+        for (const texture of this.host.textureRegistry.textures.values()) {
             this.gl.deleteTexture(texture);
-        for (const framebuffer of this.bloomPyramidResources.framebuffers)
-            this.gl.deleteFramebuffer(framebuffer);
-        this.gl.deleteTexture(this.bloomPyramidResources.accumulatorTextureA);
-        this.gl.deleteFramebuffer(this.bloomPyramidResources.accumulatorFramebufferA);
-        this.gl.deleteTexture(this.bloomPyramidResources.accumulatorTextureB);
-        this.gl.deleteFramebuffer(this.bloomPyramidResources.accumulatorFramebufferB);
-        this.bloomPyramidResources = null;
-    }
-    /**
-     * Mip-chain targets for the balanced/cinematic bloom pyramid. Each level is a
-     * single texture+framebuffer at the planned size with linear filtering so the
-     * downsample and accumulate passes can sample across levels. Half-float backs
-     * the chain when the source is HDR or the cinematic preset requests it.
-     */
-    ensureBloomPyramidResources(plan, hdr) {
-        const current = this.bloomPyramidResources;
-        if (current && current.plan.quality === plan.quality && current.hdr === (hdr || plan.halfFloat) &&
-            current.plan.mips.length === plan.mips.length &&
-            current.plan.mips.every((mip, index) => mip.width === plan.mips[index].width && mip.height === plan.mips[index].height)) {
-            return current;
-        }
-        this.disposeBloomPyramidResources();
-        const textureUnit0 = this.captureTextureUnit0();
-        const previousFramebuffer = this.gl.getParameter(this.gl.FRAMEBUFFER_BINDING);
-        const textures = [];
-        const framebuffers = [];
-        const useHalfFloat = hdr || plan.halfFloat;
-        const allocateTarget = (width, height, label) => {
-            const texture = this.gl.createTexture();
-            const framebuffer = this.gl.createFramebuffer();
-            if (!texture || !framebuffer) {
-                if (texture)
-                    this.gl.deleteTexture(texture);
-                if (framebuffer)
-                    this.gl.deleteFramebuffer(framebuffer);
-                throw new RenderDeviceError(`Failed to allocate WebGL2 bloom pyramid ${label}`, "WEBGL_ALLOCATION_FAILED", { width, height });
-            }
-            textures.push(texture);
-            framebuffers.push(framebuffer);
-            this.gl.bindTexture(this.gl.TEXTURE_2D, texture);
-            this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_MIN_FILTER, this.gl.LINEAR);
-            this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_MAG_FILTER, this.gl.LINEAR);
-            this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_WRAP_S, this.gl.CLAMP_TO_EDGE);
-            this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_WRAP_T, this.gl.CLAMP_TO_EDGE);
-            this.gl.texImage2D(this.gl.TEXTURE_2D, 0, useHalfFloat ? this.gl.RGBA16F : this.gl.RGBA8, width, height, 0, this.gl.RGBA, useHalfFloat ? this.gl.HALF_FLOAT : this.gl.UNSIGNED_BYTE, null);
-            this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, framebuffer);
-            this.gl.framebufferTexture2D(this.gl.FRAMEBUFFER, this.gl.COLOR_ATTACHMENT0, this.gl.TEXTURE_2D, texture, 0);
-            const status = this.gl.checkFramebufferStatus(this.gl.FRAMEBUFFER);
-            if (status !== this.gl.FRAMEBUFFER_COMPLETE) {
-                throw new RenderDeviceError("WebGL2 bloom pyramid framebuffer status is invalid", "FRAMEBUFFER_INVALID", { width, height, status });
-            }
-            return { texture, framebuffer };
-        };
-        try {
-            // Two ping-pong targets per mip (separable blur needs distinct read/write
-            // targets at the same size), plus two level-0-sized accumulators: the
-            // weighted sum ping-pongs between them so no pass ever samples the
-            // texture of its own bound framebuffer (feedback loop).
-            for (const mip of plan.mips) {
-                allocateTarget(mip.width, mip.height, "mip");
-                allocateTarget(mip.width, mip.height, "mip");
-            }
-            const level0 = plan.mips[0];
-            const accumulatorA = allocateTarget(level0.width, level0.height, "accumulator-a");
-            const accumulatorB = allocateTarget(level0.width, level0.height, "accumulator-b");
-            const finalResources = {
-                plan,
-                hdr: useHalfFloat,
-                textures,
-                framebuffers,
-                accumulatorTextureA: accumulatorA.texture,
-                accumulatorFramebufferA: accumulatorA.framebuffer,
-                accumulatorTextureB: accumulatorB.texture,
-                accumulatorFramebufferB: accumulatorB.framebuffer
-            };
-            this.bloomPyramidResources = finalResources;
-            return finalResources;
-        }
-        catch (error) {
-            for (const texture of textures)
-                this.gl.deleteTexture(texture);
-            for (const framebuffer of framebuffers)
-                this.gl.deleteFramebuffer(framebuffer);
-            throw error;
-        }
-        finally {
-            this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, previousFramebuffer);
-            this.restoreTextureUnit0(textureUnit0);
-            this.stateCache.invalidate();
-        }
-    }
-    captureTextureUnit0() {
-        const activeTexture = this.gl.getParameter(this.gl.ACTIVE_TEXTURE);
-        this.gl.activeTexture(this.gl.TEXTURE0);
-        return {
-            activeTexture,
-            texture2d: this.gl.getParameter(this.gl.TEXTURE_BINDING_2D),
-            sampler: this.gl.getParameter(this.gl.SAMPLER_BINDING)
-        };
-    }
-    restoreTextureUnit0(snapshot) {
-        this.gl.activeTexture(this.gl.TEXTURE0);
-        this.gl.bindTexture(this.gl.TEXTURE_2D, snapshot.texture2d);
-        this.gl.bindSampler(0, snapshot.sampler);
-        this.gl.activeTexture(snapshot.activeTexture);
-    }
-    captureTextureUnitBinding(unit) {
-        this.gl.activeTexture(this.gl.TEXTURE0 + unit);
-        return {
-            texture2d: this.gl.getParameter(this.gl.TEXTURE_BINDING_2D),
-            sampler: this.gl.getParameter(this.gl.SAMPLER_BINDING)
-        };
-    }
-    restoreTextureUnitBinding(unit, snapshot) {
-        this.gl.activeTexture(this.gl.TEXTURE0 + unit);
-        this.gl.bindTexture(this.gl.TEXTURE_2D, snapshot.texture2d);
-        this.gl.bindSampler(unit, snapshot.sampler);
-    }
-    prepareFullscreenPresentation(framebuffer, outputWidth, outputHeight) {
-        const textureUnit0 = this.captureTextureUnit0();
-        const textureUnit1 = this.captureTextureUnitBinding(1);
-        const textureUnit2 = this.captureTextureUnitBinding(2);
-        this.gl.activeTexture(textureUnit0.activeTexture);
-        const snapshot = {
-            framebuffer: this.gl.getParameter(this.gl.FRAMEBUFFER_BINDING),
-            program: this.gl.getParameter(this.gl.CURRENT_PROGRAM),
-            textureUnit0,
-            textureUnit1,
-            textureUnit2,
-            vertexArray: this.gl.getParameter(this.gl.VERTEX_ARRAY_BINDING),
-            viewport: this.gl.getParameter(this.gl.VIEWPORT),
-            colorMask: this.gl.getParameter(this.gl.COLOR_WRITEMASK),
-            depthTestEnabled: this.gl.isEnabled(this.gl.DEPTH_TEST),
-            cullFaceEnabled: this.gl.isEnabled(this.gl.CULL_FACE),
-            blendEnabled: this.gl.isEnabled(this.gl.BLEND),
-            scissorTestEnabled: this.gl.isEnabled(this.gl.SCISSOR_TEST),
-            stencilTestEnabled: this.gl.isEnabled(this.gl.STENCIL_TEST),
-            polygonOffsetFillEnabled: this.gl.isEnabled(this.gl.POLYGON_OFFSET_FILL),
-            depthMask: this.gl.getParameter(this.gl.DEPTH_WRITEMASK)
-        };
-        this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, framebuffer);
-        this.gl.viewport(0, 0, outputWidth, outputHeight);
-        this.gl.colorMask(true, true, true, true);
-        this.gl.disable(this.gl.SCISSOR_TEST);
-        this.gl.disable(this.gl.STENCIL_TEST);
-        this.gl.disable(this.gl.POLYGON_OFFSET_FILL);
-        this.gl.disable(this.gl.DEPTH_TEST);
-        this.gl.disable(this.gl.CULL_FACE);
-        this.gl.disable(this.gl.BLEND);
-        this.gl.depthMask(false);
-        return snapshot;
-    }
-    restoreFullscreenPresentationState(snapshot, fallbackWidth, fallbackHeight) {
-        this.gl.bindVertexArray(snapshot.vertexArray);
-        this.restoreTextureUnitBinding(2, snapshot.textureUnit2);
-        this.restoreTextureUnitBinding(1, snapshot.textureUnit1);
-        this.restoreTextureUnit0(snapshot.textureUnit0);
-        this.gl.useProgram(snapshot.program);
-        if (snapshot.depthTestEnabled)
-            this.gl.enable(this.gl.DEPTH_TEST);
-        else
-            this.gl.disable(this.gl.DEPTH_TEST);
-        if (snapshot.cullFaceEnabled)
-            this.gl.enable(this.gl.CULL_FACE);
-        else
-            this.gl.disable(this.gl.CULL_FACE);
-        if (snapshot.blendEnabled)
-            this.gl.enable(this.gl.BLEND);
-        else
-            this.gl.disable(this.gl.BLEND);
-        if (snapshot.scissorTestEnabled)
-            this.gl.enable(this.gl.SCISSOR_TEST);
-        else
-            this.gl.disable(this.gl.SCISSOR_TEST);
-        if (snapshot.stencilTestEnabled)
-            this.gl.enable(this.gl.STENCIL_TEST);
-        else
-            this.gl.disable(this.gl.STENCIL_TEST);
-        if (snapshot.polygonOffsetFillEnabled)
-            this.gl.enable(this.gl.POLYGON_OFFSET_FILL);
-        else
-            this.gl.disable(this.gl.POLYGON_OFFSET_FILL);
-        this.gl.colorMask(snapshot.colorMask[0] ?? true, snapshot.colorMask[1] ?? true, snapshot.colorMask[2] ?? true, snapshot.colorMask[3] ?? true);
-        this.gl.depthMask(snapshot.depthMask);
-        this.gl.bindFramebuffer(this.gl.FRAMEBUFFER, snapshot.framebuffer);
-        this.gl.viewport(snapshot.viewport[0] ?? 0, snapshot.viewport[1] ?? 0, snapshot.viewport[2] ?? fallbackWidth, snapshot.viewport[3] ?? fallbackHeight);
-        this.stateCache.invalidate();
-    }
-    ensurePresentationVertexArray() {
-        if (this.presentationVertexArray)
-            return this.presentationVertexArray;
-        const vertexArray = this.gl.createVertexArray();
-        if (!vertexArray) {
-            throw new RenderDeviceError("Failed to allocate WebGL presentation vertex array", "WEBGL_ALLOCATION_FAILED");
-        }
-        this.presentationVertexArray = vertexArray;
-        return vertexArray;
-    }
-    ensureDepthReadbackProgram() {
-        if (this.depthReadbackProgram) {
-            return this.depthReadbackProgram;
-        }
-        const vertex = this.compileShader(this.gl.VERTEX_SHADER, `#version 300 es
-precision highp float;
-out vec2 v_uv;
-void main() {
-  vec2 position = vec2(float((gl_VertexID << 1) & 2), float(gl_VertexID & 2));
-  v_uv = position;
-  gl_Position = vec4(position * 2.0 - 1.0, 0.0, 1.0);
-}
-`, "webgl2-depth-readback");
-        const fragment = this.compileShader(this.gl.FRAGMENT_SHADER, `#version 300 es
-precision highp float;
-uniform sampler2D u_depth;
-uniform vec4 u_sourceRect;
-in vec2 v_uv;
-out vec4 outColor;
-vec3 packDepth24(float value) {
-  value = clamp(value, 0.0, 1.0);
-  vec3 encoded = fract(value * vec3(1.0, 255.0, 65025.0));
-  encoded -= encoded.yzz * vec3(1.0 / 255.0, 1.0 / 255.0, 0.0);
-  return encoded;
-}
-void main() {
-  vec2 uv = u_sourceRect.xy + v_uv * u_sourceRect.zw;
-  outColor = vec4(packDepth24(texture(u_depth, uv).r), 1.0);
-}
-`, "webgl2-depth-readback");
-        const program = this.gl.createProgram();
-        if (!program) {
-            this.gl.deleteShader(vertex);
-            this.gl.deleteShader(fragment);
-            throw new RenderDeviceError("Failed to allocate WebGL2 depth readback shader", "WEBGL_ALLOCATION_FAILED");
-        }
-        this.gl.attachShader(program, vertex);
-        this.gl.attachShader(program, fragment);
-        this.gl.linkProgram(program);
-        this.gl.deleteShader(vertex);
-        this.gl.deleteShader(fragment);
-        if (!this.gl.getProgramParameter(program, this.gl.LINK_STATUS)) {
-            const log = this.gl.getProgramInfoLog(program) ?? "Unknown depth readback shader link error";
-            this.gl.deleteProgram(program);
-            throw new RenderDeviceError("WebGL2 depth readback shader link failed", "SHADER_LINK_FAILED", { log });
-        }
-        this.depthReadbackProgram = program;
-        return program;
-    }
-    ensurePresentationProgram() {
-        if (this.presentationProgram) {
-            return this.presentationProgram;
-        }
-        const vertex = this.compileShader(this.gl.VERTEX_SHADER, `#version 300 es
-precision highp float;
-out vec2 v_uv;
-void main() {
-  vec2 position = vec2(float((gl_VertexID << 1) & 2), float(gl_VertexID & 2));
-  v_uv = position;
-  gl_Position = vec4(position * 2.0 - 1.0, 0.0, 1.0);
-}
-`, "webgl2-present-render-target");
-        const fragment = this.compileShader(this.gl.FRAGMENT_SHADER, `#version 300 es
-precision highp float;
-uniform sampler2D u_source;
-in vec2 v_uv;
-out vec4 outColor;
-void main() {
-  outColor = texture(u_source, v_uv);
-}
-`, "webgl2-present-render-target");
-        const program = this.gl.createProgram();
-        if (!program) {
-            this.gl.deleteShader(vertex);
-            this.gl.deleteShader(fragment);
-            throw new RenderDeviceError("Failed to allocate WebGL presentation shader", "WEBGL_ALLOCATION_FAILED");
         }
-        this.gl.attachShader(program, vertex);
-        this.gl.attachShader(program, fragment);
-        this.gl.linkProgram(program);
-        this.gl.deleteShader(vertex);
-        this.gl.deleteShader(fragment);
-        if (!this.gl.getProgramParameter(program, this.gl.LINK_STATUS)) {
-            const log = this.gl.getProgramInfoLog(program) ?? "Unknown presentation shader link error";
-            this.gl.deleteProgram(program);
-            throw new RenderDeviceError("WebGL presentation shader link failed", "SHADER_LINK_FAILED", { log });
-        }
-        this.presentationProgram = program;
-        return program;
-    }
-    ensureBloomBrightExtractProgram() {
-        if (this.bloomBrightExtractProgram) {
-            return this.bloomBrightExtractProgram;
-        }
-        this.bloomBrightExtractProgram = this.createFullscreenProgram(`#version 300 es
-precision highp float;
-precision highp int;
-uniform sampler2D u_source;
-uniform sampler2D u_brightLut;
-uniform int u_hdr;
-uniform float u_threshold;
-uniform float u_softKnee;
-out vec4 outColor;
-
-uvec4 byteTexel(sampler2D source, ivec2 coordinate) {
-  return uvec4(texelFetch(source, coordinate, 0) * 255.0 + 0.5);
-}
-
-void main() {
-  ivec2 pixel = ivec2(gl_FragCoord.xy);
-  if (u_hdr == 1) {
-    vec4 source = texelFetch(u_source, pixel, 0);
-    float luma = dot(source.rgb, vec3(0.2126, 0.7152, 0.0722));
-    float kneeLow = max(u_threshold - u_softKnee, 0.0);
-    float kneeHigh = min(u_threshold + u_softKnee, 1.0);
-    float weight = u_softKnee <= 0.0
-      ? (luma >= u_threshold ? 1.0 : 0.0)
-      : smoothstep(kneeLow, kneeHigh, luma);
-    outColor = source * weight;
-    return;
-  }
-  uvec4 source = byteTexel(u_source, pixel);
-  uint colorIndex = (source.r << 16u) | (source.g << 8u) | source.b;
-  uint byteIndex = colorIndex >> 3u;
-  uint texelIndex = byteIndex >> 2u;
-  ivec2 lutCoordinate = ivec2(
-    int(texelIndex % ${BLOOM_BRIGHT_LUT_WIDTH}u),
-    int(texelIndex / ${BLOOM_BRIGHT_LUT_WIDTH}u)
-  );
-  uvec4 packed = byteTexel(u_brightLut, lutCoordinate);
-  uint component = byteIndex & 3u;
-  uint packedByte = component == 0u
-    ? packed.r
-    : component == 1u
-      ? packed.g
-      : component == 2u
-        ? packed.b
-        : packed.a;
-  bool bright = ((packedByte >> (colorIndex & 7u)) & 1u) == 1u;
-  outColor = bright ? vec4(source) / 255.0 : vec4(0.0);
-}
-`, "webgl2-bloom-bright-extract");
-        return this.bloomBrightExtractProgram;
-    }
-    ensureBloomBlurProgram() {
-        if (this.bloomBlurProgram) {
-            return this.bloomBlurProgram;
-        }
-        this.bloomBlurProgram = this.createFullscreenProgram(`#version 300 es
-precision highp float;
-precision highp int;
-uniform sampler2D u_source;
-uniform ivec2 u_size;
-uniform int u_radius;
-uniform int u_horizontal;
-uniform int u_hdr;
-out vec4 outColor;
-
-uvec4 sourceByte(ivec2 coordinate) {
-  ivec2 bounded = clamp(coordinate, ivec2(0), u_size - ivec2(1));
-  return uvec4(texelFetch(u_source, bounded, 0) * 255.0 + 0.5);
-}
-
-void main() {
-  ivec2 pixel = ivec2(gl_FragCoord.xy);
-  if (u_hdr == 1) {
-    vec4 sum = vec4(0.0);
-    for (int offset = -16; offset <= 16; offset += 1) {
-      if (abs(offset) > u_radius) continue;
-      ivec2 sampleCoordinate = pixel + (u_horizontal == 1 ? ivec2(offset, 0) : ivec2(0, offset));
-      sum += texelFetch(u_source, clamp(sampleCoordinate, ivec2(0), u_size - ivec2(1)), 0);
-    }
-    outColor = sum / float(u_radius * 2 + 1);
-    return;
-  }
-  uvec4 sum = uvec4(0u);
-  for (int offset = -16; offset <= 16; offset += 1) {
-    if (abs(offset) > u_radius) {
-      continue;
-    }
-    ivec2 sampleCoordinate = pixel + (
-      u_horizontal == 1
-        ? ivec2(offset, 0)
-        : ivec2(0, offset)
-    );
-    sum += sourceByte(sampleCoordinate);
-  }
-  uint kernelSize = uint(u_radius * 2 + 1);
-  uvec4 rounded = (sum * 2u + uvec4(kernelSize)) / uvec4(kernelSize * 2u);
-  outColor = vec4(rounded) / 255.0;
-}
-`, "webgl2-bloom-blur");
-        return this.bloomBlurProgram;
-    }
-    ensureBloomCompositeProgram() {
-        if (this.bloomCompositeProgram) {
-            return this.bloomCompositeProgram;
-        }
-        this.bloomCompositeProgram = this.createFullscreenProgram(`#version 300 es
-precision highp float;
-precision highp int;
-uniform sampler2D u_source;
-uniform sampler2D u_blurred;
-uniform sampler2D u_compositeLut;
-uniform int u_hdr;
-uniform float u_intensity;
-out vec4 outColor;
-
-uvec4 byteTexel(sampler2D source, ivec2 coordinate) {
-  return uvec4(texelFetch(source, coordinate, 0) * 255.0 + 0.5);
-}
-
-float compositeChannel(uint source, uint blurred) {
-  return texelFetch(u_compositeLut, ivec2(int(source), int(blurred)), 0).r;
-}
-
-void main() {
-  ivec2 pixel = ivec2(gl_FragCoord.xy);
-  if (u_hdr == 1) {
-    vec4 source = texelFetch(u_source, pixel, 0);
-    vec3 blurred = texelFetch(u_blurred, pixel, 0).rgb;
-    outColor = vec4(source.rgb + blurred * u_intensity, source.a);
-    return;
-  }
-  uvec4 source = byteTexel(u_source, pixel);
-  uvec4 blurred = byteTexel(u_blurred, pixel);
-  outColor = vec4(
-    compositeChannel(source.r, blurred.r),
-    compositeChannel(source.g, blurred.g),
-    compositeChannel(source.b, blurred.b),
-    float(source.a) / 255.0
-  );
-}
-`, "webgl2-bloom-composite");
-        return this.bloomCompositeProgram;
-    }
-    ensureBloomDownsampleProgram() {
-        if (this.bloomDownsampleProgram)
-            return this.bloomDownsampleProgram;
-        this.bloomDownsampleProgram = this.createFullscreenProgram(`#version 300 es
-precision highp float;
-uniform sampler2D u_source;
-uniform vec2 u_texelSize;
-out vec4 outColor;
-void main() {
-  vec2 uv = (gl_FragCoord.xy - 0.5) * u_texelSize;
-  vec2 e = u_texelSize * 0.5;
-  vec4 sum = texture(u_source, uv - e) + texture(u_source, uv + vec2(e.x, -e.y))
-    + texture(u_source, uv + vec2(-e.x, e.y)) + texture(u_source, uv + e);
-  outColor = sum * 0.25;
-}
-`, "webgl2-bloom-downsample");
-        return this.bloomDownsampleProgram;
-    }
-    ensureBloomAccumulateProgram() {
-        if (this.bloomAccumulateProgram)
-            return this.bloomAccumulateProgram;
-        this.bloomAccumulateProgram = this.createFullscreenProgram(`#version 300 es
-precision highp float;
-uniform sampler2D u_base;
-uniform sampler2D u_bloom;
-uniform float u_weight;
-out vec4 outColor;
-void main() {
-  ivec2 pixel = ivec2(gl_FragCoord.xy);
-  vec4 base = texelFetch(u_base, pixel, 0);
-  vec2 uv = (vec2(pixel) + 0.5) / vec2(textureSize(u_base, 0));
-  vec3 bloom = texture(u_bloom, uv).rgb;
-  outColor = vec4(base.rgb + bloom * u_weight, base.a);
-}
-`, "webgl2-bloom-accumulate");
-        return this.bloomAccumulateProgram;
-    }
-    ensureOutlineProgram() {
-        if (this.outlineProgram)
-            return this.outlineProgram;
-        this.outlineProgram = this.createFullscreenProgram(`#version 300 es
-precision highp float;
-precision highp int;
-uniform sampler2D u_source;
-uniform sampler2D u_blendLut;
-uniform ivec2 u_size;
-uniform int u_width;
-uniform float u_boundHigh;
-uniform float u_boundLow;
-out vec4 outColor;
-
-uvec4 sourceByte(ivec2 coordinate) {
-  ivec2 bounded = clamp(coordinate, ivec2(0), u_size - ivec2(1));
-  return uvec4(texelFetch(u_source, bounded, 0) * 255.0 + 0.5);
-}
-
-uint lumaNumerator(ivec2 coordinate) {
-  uvec3 source = sourceByte(coordinate).rgb;
-  return 2126u * source.r + 7152u * source.g + 722u * source.b;
-}
-
-uvec2 squareWords(int signedValue) {
-  uint value = uint(abs(signedValue));
-  uint high = value >> 12u;
-  uint low = value & 4095u;
-  uint middle = 2u * high * low;
-  uint lowWord = low * low + (middle & 4095u) * 4096u;
-  uint highWord = high * high + (middle >> 12u);
-  highWord += lowWord / ${OUTLINE_LIMB_RADIX}u;
-  lowWord %= ${OUTLINE_LIMB_RADIX}u;
-  return uvec2(highWord, lowWord);
-}
-
-bool edgeAt(ivec2 pixel) {
-  int nw = int(lumaNumerator(pixel + ivec2(-1, -1)));
-  int n = int(lumaNumerator(pixel + ivec2(0, -1)));
-  int ne = int(lumaNumerator(pixel + ivec2(1, -1)));
-  int w = int(lumaNumerator(pixel + ivec2(-1, 0)));
-  int e = int(lumaNumerator(pixel + ivec2(1, 0)));
-  int sw = int(lumaNumerator(pixel + ivec2(-1, 1)));
-  int s = int(lumaNumerator(pixel + ivec2(0, 1)));
-  int se = int(lumaNumerator(pixel + ivec2(1, 1)));
-  int gx = -nw - 2 * w - sw + ne + 2 * e + se;
-  int gy = -nw - 2 * n - ne + sw + 2 * s + se;
-  uvec2 x = squareWords(gx);
-  uvec2 y = squareWords(gy);
-  uint low = x.y + y.y;
-  uint high = x.x + y.x;
-  if (low >= ${OUTLINE_LIMB_RADIX}u) {
-    low -= ${OUTLINE_LIMB_RADIX}u;
-    high += 1u;
-  }
-  uint boundHigh = uint(u_boundHigh);
-  uint boundLow = uint(u_boundLow);
-  return high != boundHigh ? high > boundHigh : low >= boundLow;
-}
-
-void main() {
-  ivec2 pixel = ivec2(gl_FragCoord.xy);
-  bool outlined = false;
-  for (int offsetY = -6; offsetY <= 6 && !outlined; offsetY += 1) {
-    for (int offsetX = -6; offsetX <= 6; offsetX += 1) {
-      if (abs(offsetX) > u_width || abs(offsetY) > u_width) continue;
-      if (offsetX * offsetX + offsetY * offsetY > u_width * u_width) continue;
-      ivec2 candidate = clamp(pixel + ivec2(offsetX, offsetY), ivec2(0), u_size - ivec2(1));
-      if (edgeAt(candidate)) {
-        outlined = true;
-        break;
-      }
-    }
-  }
-  uvec4 source = sourceByte(pixel);
-  if (!outlined) {
-    outColor = vec4(source) / 255.0;
-    return;
-  }
-  outColor = vec4(
-    texelFetch(u_blendLut, ivec2(int(source.r), 0), 0).r,
-    texelFetch(u_blendLut, ivec2(int(source.g), 0), 0).g,
-    texelFetch(u_blendLut, ivec2(int(source.b), 0), 0).b,
-    float(source.a) / 255.0
-  );
-}
-`, "webgl2-outline");
-        return this.outlineProgram;
-    }
-    ensureSsaoProgram() {
-        if (this.ssaoProgram)
-            return this.ssaoProgram;
-        this.ssaoProgram = this.createFullscreenProgram(`#version 300 es
-precision highp float;
-precision highp int;
-uniform sampler2D u_source;
-uniform sampler2D u_depth;
-uniform ivec2 u_size;
-uniform int u_radius;
-uniform float u_intensity;
-uniform float u_bias;
-out vec4 outColor;
-
-float depthAt(ivec2 coordinate) {
-  return texelFetch(u_depth, clamp(coordinate, ivec2(0), u_size - ivec2(1)), 0).r;
-}
-
-void main() {
-  ivec2 pixel = ivec2(gl_FragCoord.xy);
-  float centerDepth = depthAt(pixel);
-  float occlusion = 0.0;
-  float samples = 0.0;
-  for (int stepY = -1; stepY <= 1; stepY += 1) {
-    for (int stepX = -1; stepX <= 1; stepX += 1) {
-      if (stepX == 0 && stepY == 0) continue;
-      float sampleDepth = depthAt(pixel + ivec2(stepX * u_radius, stepY * u_radius));
-      occlusion += clamp(
-        (centerDepth - sampleDepth - u_bias) / (0.14 + float(u_radius) * 0.04),
-        0.0,
-        1.0
-      );
-      samples += 1.0;
-    }
-  }
-  float factor = max(0.18, 1.0 - (occlusion / max(1.0, samples)) * u_intensity * 0.72);
-  vec4 source = texelFetch(u_source, pixel, 0);
-  outColor = vec4(source.rgb * factor, source.a);
-}
-`, "webgl2-ssao");
-        return this.ssaoProgram;
-    }
-    ensureSsrProgram() {
-        if (this.ssrProgram)
-            return this.ssrProgram;
-        this.ssrProgram = this.createFullscreenProgram(`#version 300 es
-precision highp float;
-precision highp int;
-uniform sampler2D u_source;
-uniform sampler2D u_depth;
-uniform ivec2 u_size;
-uniform float u_intensity;
-uniform int u_maxDistance;
-uniform float u_depthNear;
-uniform float u_depthFar;
-out vec4 outColor;
-
-// Raw GL depth is nonlinear (0.1/1000 defaults park the play area past 0.97),
-// so every depth-gated comparison below runs on linearized depth. The CPU
-// byte kernel keeps fixture-unit semantics; the divergence is documented at
-// normalizeLdrDepthRange.
-float a3dSsrLinearDepth(float depth) {
-  float viewZ = u_depthNear * u_depthFar / max(u_depthFar - depth * (u_depthFar - u_depthNear), 0.0001);
-  return clamp((viewZ - u_depthNear) / max(u_depthFar - u_depthNear, 0.0001), 0.0, 1.0);
-}
-
-void main() {
-  ivec2 pixel = ivec2(gl_FragCoord.xy);
-  vec4 target = texelFetch(u_source, pixel, 0);
-  float linearDepth = a3dSsrLinearDepth(texelFetch(u_depth, pixel, 0).r);
-  int rayDistance = max(1, int(round((1.0 - linearDepth) * float(u_maxDistance))));
-  int direction = pixel.x < u_size.x / 2 ? 1 : -1;
-  ivec2 samplePixel = ivec2(
-    clamp(pixel.x + direction * rayDistance, 0, u_size.x - 1),
-    clamp(u_size.y - 1 - pixel.y, 0, u_size.y - 1)
-  );
-  vec3 reflected = texelFetch(u_source, samplePixel, 0).rgb;
-  float sourceLuma = (reflected.r + reflected.g + reflected.b) / 3.0;
-  if (sourceLuma < 0.18 || linearDepth > 0.995) {
-    outColor = target;
-    return;
-  }
-  float boost = sourceLuma * u_intensity * (1.0 - linearDepth);
-  outColor = vec4(clamp(target.rgb + reflected * boost, 0.0, 1.0), target.a);
-}
-`, "webgl2-ssr");
-        return this.ssrProgram;
-    }
-    ensureDepthOfFieldProgram() {
-        if (this.depthOfFieldProgram)
-            return this.depthOfFieldProgram;
-        this.depthOfFieldProgram = this.createFullscreenProgram(`#version 300 es
-precision highp float;
-precision highp int;
-uniform sampler2D u_source;
-uniform sampler2D u_depth;
-uniform ivec2 u_size;
-uniform float u_focusDepth;
-uniform float u_focusRange;
-uniform int u_maxRadius;
-uniform float u_depthNear;
-uniform float u_depthFar;
-out vec4 outColor;
-
-// Same linearization contract as the SSR program, except focus is authored
-// directly as a linear-distance fraction (0 = near plane, 1 = far plane):
-// buffer-unit focus values are unusable once depth is linearized, because the
-// projection curve parks the whole play area inside a sliver of buffer units.
-// The CPU byte kernel keeps buffer-unit semantics; the divergence is
-// documented at normalizeLdrDepthRange.
-float a3dDofLinearDepth(float depth) {
-  float viewZ = u_depthNear * u_depthFar / max(u_depthFar - depth * (u_depthFar - u_depthNear), 0.0001);
-  return clamp((viewZ - u_depthNear) / max(u_depthFar - u_depthNear, 0.0001), 0.0, 1.0);
-}
-
-void main() {
-  ivec2 pixel = ivec2(gl_FragCoord.xy);
-  vec4 source = texelFetch(u_source, pixel, 0);
-  float linearDepth = a3dDofLinearDepth(texelFetch(u_depth, pixel, 0).r);
-  float normalizedBlur = max(0.0, abs(linearDepth - u_focusDepth) - u_focusRange)
-    / max(u_focusRange, 0.001) * float(u_maxRadius);
-  int radius = min(u_maxRadius, int(round(normalizedBlur)));
-  if (radius == 0) {
-    outColor = source;
-    return;
-  }
-  vec3 sum = vec3(0.0);
-  float samples = 0.0;
-  for (int offsetY = -8; offsetY <= 8; offsetY += 1) {
-    for (int offsetX = -8; offsetX <= 8; offsetX += 1) {
-      if (abs(offsetX) > radius || abs(offsetY) > radius) continue;
-      if (offsetX * offsetX + offsetY * offsetY > radius * radius) continue;
-      ivec2 samplePixel = clamp(pixel + ivec2(offsetX, offsetY), ivec2(0), u_size - ivec2(1));
-      sum += texelFetch(u_source, samplePixel, 0).rgb;
-      samples += 1.0;
-    }
-  }
-  outColor = vec4(sum / max(1.0, samples), source.a);
-}
-`, "webgl2-depth-of-field");
-        return this.depthOfFieldProgram;
-    }
-    ensureMotionBlurProgram() {
-        if (this.motionBlurProgram)
-            return this.motionBlurProgram;
-        this.motionBlurProgram = this.createFullscreenProgram(`#version 300 es
-precision highp float;
-precision highp int;
-uniform sampler2D u_source;
-uniform sampler2D u_velocity;
-uniform ivec2 u_size;
-uniform int u_samples;
-uniform float u_scale;
-out vec4 outColor;
-
-void main() {
-  ivec2 pixel = ivec2(gl_FragCoord.xy);
-  vec4 source = texelFetch(u_source, pixel, 0);
-  vec2 velocity = texelFetch(u_velocity, pixel, 0).rg * u_scale;
-  if (length(velocity) < 0.01) {
-    outColor = source;
-    return;
-  }
-  vec3 sum = vec3(0.0);
-  for (int sampleIndex = 0; sampleIndex < 16; sampleIndex += 1) {
-    if (sampleIndex >= u_samples) continue;
-    float t = float(sampleIndex) / float(u_samples - 1) - 0.5;
-    ivec2 samplePixel = ivec2(floor(vec2(pixel) - velocity * t + vec2(0.5)));
-    samplePixel = clamp(samplePixel, ivec2(0), u_size - ivec2(1));
-    sum += texelFetch(u_source, samplePixel, 0).rgb;
-  }
-  outColor = vec4(sum / float(u_samples), source.a);
-}
-`, "webgl2-motion-blur");
-        return this.motionBlurProgram;
-    }
-    ensureTaaProgram() {
-        if (this.taaProgram)
-            return this.taaProgram;
-        this.taaProgram = this.createFullscreenProgram(`#version 300 es
-precision highp float;
-uniform sampler2D u_source;
-uniform sampler2D u_history;
-uniform float u_blend;
-out vec4 outColor;
-
-void main() {
-  ivec2 pixel = ivec2(gl_FragCoord.xy);
-  vec4 source = texelFetch(u_source, pixel, 0);
-  vec3 history = texelFetch(u_history, pixel, 0).rgb;
-  outColor = vec4(mix(source.rgb, history, u_blend), source.a);
-}
-`, "webgl2-taa");
-        return this.taaProgram;
-    }
-    createFullscreenProgram(fragmentSource, label) {
-        const vertex = this.compileShader(this.gl.VERTEX_SHADER, `#version 300 es
-precision highp float;
-void main() {
-  vec2 position = vec2(float((gl_VertexID << 1) & 2), float(gl_VertexID & 2));
-  gl_Position = vec4(position * 2.0 - 1.0, 0.0, 1.0);
-}
-`, label);
-        const fragment = this.compileShader(this.gl.FRAGMENT_SHADER, fragmentSource, label);
-        const program = this.gl.createProgram();
-        if (!program) {
-            this.gl.deleteShader(vertex);
-            this.gl.deleteShader(fragment);
-            throw new RenderDeviceError("Failed to allocate WebGL2 fullscreen shader program", "WEBGL_ALLOCATION_FAILED", { label });
-        }
-        this.gl.attachShader(program, vertex);
-        this.gl.attachShader(program, fragment);
-        this.gl.linkProgram(program);
-        this.gl.deleteShader(vertex);
-        this.gl.deleteShader(fragment);
-        if (!this.gl.getProgramParameter(program, this.gl.LINK_STATUS)) {
-            const log = this.gl.getProgramInfoLog(program) ?? "Unknown fullscreen shader link error";
-            this.gl.deleteProgram(program);
-            throw new RenderDeviceError("WebGL2 fullscreen shader link failed", "SHADER_LINK_FAILED", { label, log });
-        }
-        return program;
-    }
-    ensureLdrPostprocessProgram() {
-        if (this.ldrPostprocessProgram) {
-            return this.ldrPostprocessProgram;
-        }
-        const vertex = this.compileShader(this.gl.VERTEX_SHADER, `#version 300 es
-precision highp float;
-out vec2 v_uv;
-void main() {
-  vec2 position = vec2(float((gl_VertexID << 1) & 2), float(gl_VertexID & 2));
-  v_uv = position;
-  gl_Position = vec4(position * 2.0 - 1.0, 0.0, 1.0);
-}
-`, "webgl2-ldr-postprocess");
-        const fragment = this.compileShader(this.gl.FRAGMENT_SHADER, `#version 300 es
-precision highp float;
-uniform sampler2D u_source;
-uniform vec2 u_texelSize;
-uniform int u_hasToneMapping;
-uniform int u_toneOperator;
-uniform int u_inputColorSpace;
-uniform int u_outputColorSpace;
-uniform float u_exposure;
-uniform float u_whitePoint;
-uniform float u_gamma;
-uniform int u_hasColorGrade;
-uniform float u_contrast;
-uniform float u_temperature;
-uniform float u_tint;
-uniform float u_saturation;
-uniform float u_vibrance;
-uniform float u_vignette;
-uniform float u_sharpening;
-uniform int u_hasFxaa;
-uniform float u_edgeThreshold;
-uniform float u_subpixelBlend;
-in vec2 v_uv;
-out vec4 outColor;
-
-float srgbToLinear(float value) {
-  return value <= 0.04045 ? value / 12.92 : pow((value + 0.055) / 1.055, 2.4);
-}
-
-float linearToSrgb(float value) {
-  return value <= 0.0031308 ? value * 12.92 : 1.055 * pow(value, 1.0 / 2.4) - 0.055;
-}
-
-vec3 decodeColor(vec3 color) {
-  return u_inputColorSpace == 1 ? vec3(srgbToLinear(color.r), srgbToLinear(color.g), srgbToLinear(color.b)) : color;
-}
-
-vec3 encodeColor(vec3 color) {
-  vec3 linear = clamp(color, 0.0, 1.0);
-  return u_outputColorSpace == 1 ? vec3(linearToSrgb(linear.r), linearToSrgb(linear.g), linearToSrgb(linear.b)) : linear;
-}
-
-vec3 acesRrtAndOdtFit(vec3 value) {
-  vec3 numerator = value * (value + 0.0245786) - 0.000090537;
-  vec3 denominator = value * (0.983729 * value + 0.4329510) + 0.238081;
-  return numerator / denominator;
-}
-
-vec3 acesFilmic(vec3 color) {
-  // Match current Three.js ACESFilmicToneMapping. ACES is a coupled RGB
-  // transform; a scalar approximation shifts hue and washes saturated colors.
-  const mat3 acesInput = mat3(
-    vec3(0.59719, 0.07600, 0.02840),
-    vec3(0.35458, 0.90834, 0.13383),
-    vec3(0.04823, 0.01566, 0.83777)
-  );
-  const mat3 acesOutput = mat3(
-    vec3(1.60475, -0.10208, -0.00327),
-    vec3(-0.53108, 1.10813, -0.07276),
-    vec3(-0.07367, -0.00605, 1.07602)
-  );
-  vec3 acesColor = acesInput * (color / 0.6);
-  acesColor = acesRrtAndOdtFit(acesColor);
-  return clamp(acesOutput * acesColor, 0.0, 1.0);
-}
-
-float filmic(float value) {
-  float x = max(0.0, value);
-  float toe = max(0.0, x - 0.004);
-  float curve = (toe * (6.2 * toe + 0.5)) / (toe * (6.2 * toe + 1.7) + 0.06);
-  return min(curve, x * 1.08);
-}
-
-float uncharted2(float value) {
-  float a = 0.15;
-  float b = 0.5;
-  float c = 0.1;
-  float d = 0.2;
-  float e = 0.02;
-  float f = 0.3;
-  float w = 11.2;
-  float x = value * 2.0;
-  float curve = ((x * (a * x + c * b) + d * e) / (x * (a * x + b) + d * f)) - e / f;
-  float wx = w;
-  float white = ((wx * (a * wx + c * b) + d * e) / (wx * (a * wx + b) + d * f)) - e / f;
-  return clamp(curve / white, 0.0, 1.0);
-}
-
-float agx(float value) {
-  float x = max(0.0, value);
-  float encoded = log2(1.0 + x) / log2(17.0);
-  return clamp(encoded * encoded * (3.0 - 2.0 * encoded), 0.0, 1.0);
-}
-
-float neutral(float value) {
-  float x = max(0.0, value);
-  return min(1.0, (x * (1.0 + x / 7.5)) / (1.0 + x));
-}
-
-float toneMapChannel(float value) {
-  float exposed = max(0.0, value * u_exposure) / max(0.0001, u_whitePoint);
-  if (u_toneOperator == 0) return min(1.0, exposed);
-  if (u_toneOperator == 1) return exposed / (1.0 + exposed);
-  if (u_toneOperator == 2) return exposed;
-  if (u_toneOperator == 3) return filmic(exposed);
-  if (u_toneOperator == 4) return uncharted2(exposed);
-  if (u_toneOperator == 5) return agx(exposed);
-  return neutral(exposed);
-}
-
-vec3 applyToneMapping(vec3 color) {
-  if (u_hasToneMapping == 0) return color;
-  vec3 decoded = decodeColor(color);
-  vec3 mapped = u_toneOperator == 2
-    ? acesFilmic(max(vec3(0.0), decoded * u_exposure) / max(0.0001, u_whitePoint))
-    : vec3(toneMapChannel(decoded.r), toneMapChannel(decoded.g), toneMapChannel(decoded.b));
-  return encodeColor(mapped);
-}
-
-vec3 applyColorGrade(vec3 color, vec2 uv) {
-  if (u_hasColorGrade == 0) return color;
-  float contrastOffset = 0.5 - 0.5 * u_contrast;
-  float redShift = u_temperature * 0.08 - u_tint * 0.02;
-  float greenShift = u_tint * 0.06;
-  float blueShift = -u_temperature * 0.08 - u_tint * 0.02;
-  float luma = dot(color, vec3(0.2126, 0.7152, 0.0722));
-  vec3 graded = color * u_contrast + vec3(contrastOffset + redShift, contrastOffset + greenShift, contrastOffset + blueShift);
-  float distanceFromLuma = min(1.0, abs(graded.r - luma) + abs(graded.g - luma) + abs(graded.b - luma));
-  float vibranceBoost = u_vibrance == 0.0 ? 0.0 : u_vibrance * (1.0 - distanceFromLuma);
-  float saturation = u_saturation + vibranceBoost;
-  graded = vec3(luma) + (graded - vec3(luma)) * saturation;
-  vec2 centered = uv * 2.0 - 1.0;
-  float vignette = 1.0 - u_vignette * clamp((length(centered) - 0.28) / 1.12, 0.0, 1.0);
-  return clamp(graded * vignette, 0.0, 1.0);
-}
-
-vec3 baseColorAt(vec2 uv) {
-  vec2 clampedUv = clamp(uv, vec2(0.0), vec2(1.0));
-  vec3 color = texture(u_source, clampedUv).rgb;
-  return applyColorGrade(applyToneMapping(color), clampedUv);
-}
-
-vec3 finalColorAt(vec2 uv) {
-  vec3 center = baseColorAt(uv);
-  if (u_hasColorGrade == 0 || u_sharpening <= 0.0) return center;
-  vec3 blur = (
-    baseColorAt(uv + vec2(-u_texelSize.x, 0.0)) +
-    baseColorAt(uv + vec2(u_texelSize.x, 0.0)) +
-    baseColorAt(uv + vec2(0.0, -u_texelSize.y)) +
-    baseColorAt(uv + vec2(0.0, u_texelSize.y))
-  ) * 0.25;
-  return clamp(center + (center - blur) * u_sharpening, 0.0, 1.0);
-}
-
-float luma(vec3 color) {
-  return dot(color, vec3(0.2126, 0.7152, 0.0722));
-}
-
-void main() {
-  vec3 center = finalColorAt(v_uv);
-  float alpha = texture(u_source, clamp(v_uv, vec2(0.0), vec2(1.0))).a;
-  if (u_hasFxaa == 0) {
-    outColor = vec4(center, alpha);
-    return;
-  }
-  vec3 north = finalColorAt(v_uv + vec2(0.0, -u_texelSize.y));
-  vec3 south = finalColorAt(v_uv + vec2(0.0, u_texelSize.y));
-  vec3 west = finalColorAt(v_uv + vec2(-u_texelSize.x, 0.0));
-  vec3 east = finalColorAt(v_uv + vec2(u_texelSize.x, 0.0));
-  float centerLuma = luma(center);
-  float minLuma = min(centerLuma, min(min(luma(north), luma(south)), min(luma(west), luma(east))));
-  float maxLuma = max(centerLuma, max(max(luma(north), luma(south)), max(luma(west), luma(east))));
-  if (maxLuma - minLuma < u_edgeThreshold) {
-    outColor = vec4(center, alpha);
-    return;
-  }
-  vec3 average = (north + south + west + east) * 0.25;
-  outColor = vec4(mix(center, average, clamp(u_subpixelBlend, 0.0, 1.0)), alpha);
-}
-`, "webgl2-ldr-postprocess");
-        const program = this.gl.createProgram();
-        if (!program) {
-            this.gl.deleteShader(vertex);
-            this.gl.deleteShader(fragment);
-            throw new RenderDeviceError("Failed to allocate WebGL2 LDR postprocess shader", "WEBGL_ALLOCATION_FAILED");
-        }
-        this.gl.attachShader(program, vertex);
-        this.gl.attachShader(program, fragment);
-        this.gl.linkProgram(program);
-        this.gl.deleteShader(vertex);
-        this.gl.deleteShader(fragment);
-        if (!this.gl.getProgramParameter(program, this.gl.LINK_STATUS)) {
-            const log = this.gl.getProgramInfoLog(program) ?? "Unknown LDR postprocess shader link error";
-            this.gl.deleteProgram(program);
-            throw new RenderDeviceError("WebGL2 LDR postprocess shader link failed", "SHADER_LINK_FAILED", { log });
-        }
-        this.ldrPostprocessProgram = program;
-        return program;
+        this.host.textureRegistry.textureUploadModes.clear();
+        if (this.host.textureRegistry.fallbackTexture) {
+            this.gl.deleteTexture(this.host.textureRegistry.fallbackTexture);
+            this.host.textureRegistry.fallbackTexture = null;
+        }
+        if (this.host.textureRegistry.fallbackCubeTexture) {
+            this.gl.deleteTexture(this.host.textureRegistry.fallbackCubeTexture);
+            this.host.textureRegistry.fallbackCubeTexture = null;
+        }
+        if (this.host.post.presentationProgram) {
+            this.gl.deleteProgram(this.host.post.presentationProgram);
+            this.host.post.presentationProgram = null;
+        }
+        if (this.host.post.ldrPostprocessProgram) {
+            this.gl.deleteProgram(this.host.post.ldrPostprocessProgram);
+            this.host.post.ldrPostprocessProgram = null;
+        }
+        if (this.host.post.bloomBrightExtractProgram) {
+            this.gl.deleteProgram(this.host.post.bloomBrightExtractProgram);
+            this.host.post.bloomBrightExtractProgram = null;
+        }
+        if (this.host.post.bloomBlurProgram) {
+            this.gl.deleteProgram(this.host.post.bloomBlurProgram);
+            this.host.post.bloomBlurProgram = null;
+        }
+        if (this.host.post.bloomCompositeProgram) {
+            this.gl.deleteProgram(this.host.post.bloomCompositeProgram);
+            this.host.post.bloomCompositeProgram = null;
+        }
+        if (this.host.post.bloomDownsampleProgram) {
+            this.gl.deleteProgram(this.host.post.bloomDownsampleProgram);
+            this.host.post.bloomDownsampleProgram = null;
+        }
+        if (this.host.post.bloomAccumulateProgram) {
+            this.gl.deleteProgram(this.host.post.bloomAccumulateProgram);
+            this.host.post.bloomAccumulateProgram = null;
+        }
+        if (this.host.post.outlineProgram) {
+            this.gl.deleteProgram(this.host.post.outlineProgram);
+            this.host.post.outlineProgram = null;
+        }
+        if (this.host.post.ssaoProgram) {
+            this.gl.deleteProgram(this.host.post.ssaoProgram);
+            this.host.post.ssaoProgram = null;
+        }
+        if (this.host.post.ssrProgram) {
+            this.gl.deleteProgram(this.host.post.ssrProgram);
+            this.host.post.ssrProgram = null;
+        }
+        if (this.host.post.depthOfFieldProgram) {
+            this.gl.deleteProgram(this.host.post.depthOfFieldProgram);
+            this.host.post.depthOfFieldProgram = null;
+        }
+        if (this.host.post.motionBlurProgram) {
+            this.gl.deleteProgram(this.host.post.motionBlurProgram);
+            this.host.post.motionBlurProgram = null;
+        }
+        if (this.host.post.motionBlurVelocityTexture) {
+            this.gl.deleteTexture(this.host.post.motionBlurVelocityTexture);
+            this.host.post.motionBlurVelocityTexture = null;
+            this.host.post.motionBlurVelocitySize = null;
+        }
+        if (this.host.post.taaProgram) {
+            this.gl.deleteProgram(this.host.post.taaProgram);
+            this.host.post.taaProgram = null;
+        }
+        if (this.host.post.taaPresentationProgram) {
+            this.gl.deleteProgram(this.host.post.taaPresentationProgram);
+            this.host.post.taaPresentationProgram = null;
+        }
+        if (this.host.post.taaHistoryTexture) {
+            this.gl.deleteTexture(this.host.post.taaHistoryTexture);
+            this.host.post.taaHistoryTexture = null;
+            this.host.post.taaHistorySize = null;
+        }
+        this.host.post.disposeBloomPingPongResources();
+        this.host.post.disposeBloomPyramidResources();
+        if (this.host.post.bloomBrightLutTexture) {
+            this.gl.deleteTexture(this.host.post.bloomBrightLutTexture);
+            this.host.post.bloomBrightLutTexture = null;
+            this.host.post.bloomBrightLutThreshold = null;
+        }
+        if (this.host.post.bloomCompositeLutTexture) {
+            this.gl.deleteTexture(this.host.post.bloomCompositeLutTexture);
+            this.host.post.bloomCompositeLutTexture = null;
+            this.host.post.bloomCompositeLutIntensity = null;
+            this.host.post.bloomCompositeLutShoulder = null;
+        }
+        if (this.host.post.outlineBlendLutTexture) {
+            this.gl.deleteTexture(this.host.post.outlineBlendLutTexture);
+            this.host.post.outlineBlendLutTexture = null;
+            this.host.post.outlineBlendLutKey = null;
+        }
+        if (this.host.post.presentationVertexArray) {
+            this.gl.deleteVertexArray(this.host.post.presentationVertexArray);
+            this.host.post.presentationVertexArray = null;
+        }
+        if (this.host.probe.depthReadbackProgram) {
+            this.gl.deleteProgram(this.host.probe.depthReadbackProgram);
+            this.host.probe.depthReadbackProgram = null;
+        }
+        this.host.textureRegistry.textures.clear();
+        this.host.disposed = true;
     }
     compileShader(type, source, label) {
         const shader = this.gl.createShader(type);
@@ -3013,790 +1324,6 @@ void main() {
         }
         return { attributes, uniforms, attributeDetails, uniformDetails };
     }
-    uploadUniforms(shader, uniforms) {
-        let textureUnit = 0;
-        for (const [name, value] of uniforms) {
-            if (!shader.reflection.uniforms.has(name)) {
-                continue;
-            }
-            const location = this.getUniformLocation(shader, name);
-            if (location === null) {
-                throw new RenderDeviceError("Material tried to bind a missing shader uniform", "MISSING_UNIFORM", { name });
-            }
-            if (isTextureBinding(value)) {
-                this.uploadTextureUniform(location, value, textureUnit);
-                textureUnit += 1;
-            }
-            else if (typeof value === "number") {
-                this.gl.uniform1f(location, value);
-            }
-            else if (Array.isArray(value) || ArrayBuffer.isView(value)) {
-                const length = value.length;
-                const floatData = value;
-                if (length === 16 || (length > 16 && length % 16 === 0 && /(?:Matrix|Matrices)$/.test(name))) {
-                    this.gl.uniformMatrix4fv(location, false, floatData);
-                }
-                else if (length > 16 && length % 4 === 0) {
-                    this.gl.uniform4fv(location, floatData);
-                }
-                else if (length === 4) {
-                    this.gl.uniform4fv(location, floatData);
-                }
-                else if (length === 3) {
-                    this.gl.uniform3fv(location, floatData);
-                }
-                else if (length === 2) {
-                    this.gl.uniform2fv(location, floatData);
-                }
-                else {
-                    throw new RenderDeviceError("Unsupported uniform array length", "UNSUPPORTED_UNIFORM", { name, length });
-                }
-            }
-            else {
-                throw new RenderDeviceError("Unsupported uniform value", "UNSUPPORTED_UNIFORM", { name, valueType: typeof value });
-            }
-            if (this.errorCheckMode === "strict") {
-                const uniformError = this.readError();
-                if (uniformError) {
-                    throw new RenderDeviceError(`WebGL2 uniform upload failed for ${name}: ${uniformError}`, "WEBGL_DRAW_FAILED", {
-                        name,
-                        stage: "uniform",
-                        error: uniformError
-                    });
-                }
-            }
-        }
-    }
-    getUniformLocation(shader, name) {
-        let cache = this.uniformLocationCache.get(shader);
-        if (!cache) {
-            cache = new Map();
-            this.uniformLocationCache.set(shader, cache);
-        }
-        if (!cache.has(name)) {
-            this.uniformLocationLookupCount += 1;
-            cache.set(name, this.gl.getUniformLocation(shader.handle, name) ?? this.gl.getUniformLocation(shader.handle, `${name}[0]`));
-        }
-        return cache.get(name) ?? null;
-    }
-    uploadTextureUniform(location, binding, textureUnit) {
-        const validation = binding.validate();
-        if (!validation.ok) {
-            throw new RenderDeviceError("Texture binding validation failed", "INVALID_TEXTURE_BINDING", {
-                diagnostics: validation.diagnostics,
-                name: binding.name
-            });
-        }
-        this.activateTextureUnit(textureUnit);
-        const dimension = binding.texture?.dimension ?? (binding.name.toLowerCase().includes("cubemap") || binding.name.toLowerCase().includes("cube") ? "cube" : "2d");
-        const target = dimension === "cube" ? this.gl.TEXTURE_CUBE_MAP : this.gl.TEXTURE_2D;
-        const handle = binding.texture ? this.getTextureHandle(binding.texture) : dimension === "cube" ? this.getFallbackCubeTextureHandle() : this.getFallbackTextureHandle();
-        if (binding.texture) {
-            const lowerName = binding.name.toLowerCase();
-            if (lowerName.includes("environment"))
-                this.nativeEnvironmentBindings += 1;
-            if (lowerName.includes("shadow"))
-                this.nativeShadowMapBindings += 1;
-        }
-        this.bindTextureForUnit(textureUnit, target, handle);
-        const samplerHandle = this.getSamplerHandle(binding.sampler, target);
-        this.stateCache.bindSampler(textureUnit, samplerHandle, () => this.gl.bindSampler(textureUnit, samplerHandle));
-        this.gl.uniform1i(location, textureUnit);
-    }
-    activateTextureUnit(textureUnit) {
-        if (this.activeTextureUnitIndex === textureUnit)
-            return;
-        this.stateCache.activeTexture(textureUnit, () => this.gl.activeTexture(this.gl.TEXTURE0 + textureUnit));
-        this.activeTextureUnitIndex = textureUnit;
-    }
-    bindTextureForUnit(textureUnit, target, handle) {
-        const key = `${textureUnit}:${target}`;
-        if (this.textureUnitBindings.get(key) === handle)
-            return;
-        this.stateCache.bindTexture(target, handle, () => this.gl.bindTexture(target, handle));
-        this.textureUnitBindings.set(key, handle);
-        this.textureBindCount += 1;
-    }
-    setTextureParameterIfNeeded(handle, target, parameter, value) {
-        let parameters = this.textureSamplerParameterCache.get(handle);
-        if (!parameters) {
-            parameters = new Map();
-            this.textureSamplerParameterCache.set(handle, parameters);
-        }
-        if (parameters.get(parameter) === value)
-            return;
-        this.gl.texParameteri(target, parameter, value);
-        parameters.set(parameter, value);
-        this.samplerParameterUploadCount += 1;
-    }
-    applySamplerAnisotropy(maxAnisotropy, target = this.gl.TEXTURE_2D) {
-        if (maxAnisotropy <= 1)
-            return;
-        if (!this.anisotropicFilteringExtension)
-            return;
-        this.gl.texParameterf(target, this.anisotropicFilteringExtension.TEXTURE_MAX_ANISOTROPY_EXT, Math.min(Math.max(1, maxAnisotropy), this.maxTextureAnisotropy));
-        this.samplerAnisotropyUploadCount += 1;
-    }
-    getSamplerHandle(sampler, target) {
-        const key = this.samplerKey(sampler, target);
-        const cached = this.samplerObjectCache.get(key);
-        if (cached)
-            return cached;
-        const handle = this.gl.createSampler();
-        if (!handle) {
-            throw new RenderDeviceError("Failed to allocate WebGL sampler", "WEBGL_ALLOCATION_FAILED");
-        }
-        this.gl.samplerParameteri(handle, this.gl.TEXTURE_MIN_FILTER, this.minFilter(sampler.minFilter));
-        this.gl.samplerParameteri(handle, this.gl.TEXTURE_MAG_FILTER, this.magFilter(sampler.magFilter));
-        this.gl.samplerParameteri(handle, this.gl.TEXTURE_WRAP_S, this.addressMode(sampler.addressU));
-        this.gl.samplerParameteri(handle, this.gl.TEXTURE_WRAP_T, this.addressMode(sampler.addressV));
-        this.samplerParameterUploadCount += 4;
-        if (target === this.gl.TEXTURE_CUBE_MAP) {
-            this.gl.samplerParameteri(handle, this.gl.TEXTURE_WRAP_R, this.addressMode(sampler.addressV));
-            this.samplerParameterUploadCount += 1;
-        }
-        if (sampler.maxAnisotropy > 1 && this.anisotropicFilteringExtension) {
-            this.gl.samplerParameterf(handle, this.anisotropicFilteringExtension.TEXTURE_MAX_ANISOTROPY_EXT, Math.min(Math.max(1, sampler.maxAnisotropy), this.maxTextureAnisotropy));
-            this.samplerAnisotropyUploadCount += 1;
-        }
-        this.samplerObjectCache.set(key, handle);
-        return handle;
-    }
-    samplerKey(sampler, target) {
-        return [
-            sampler.minFilter,
-            sampler.magFilter,
-            sampler.addressU,
-            sampler.addressV,
-            sampler.maxAnisotropy,
-            target === this.gl.TEXTURE_CUBE_MAP ? "cube" : "2d"
-        ].join("|");
-    }
-    getFallbackTextureHandle() {
-        if (this.fallbackTexture) {
-            return this.fallbackTexture;
-        }
-        const handle = this.gl.createTexture();
-        if (!handle) {
-            throw new RenderDeviceError("Failed to allocate WebGL fallback texture", "WEBGL_ALLOCATION_FAILED");
-        }
-        this.stateCache.invalidate();
-        this.gl.bindTexture(this.gl.TEXTURE_2D, handle);
-        this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_MIN_FILTER, this.gl.NEAREST);
-        this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_MAG_FILTER, this.gl.NEAREST);
-        this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_WRAP_S, this.gl.CLAMP_TO_EDGE);
-        this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_WRAP_T, this.gl.CLAMP_TO_EDGE);
-        this.gl.texImage2D(this.gl.TEXTURE_2D, 0, this.gl.RGBA, 1, 1, 0, this.gl.RGBA, this.gl.UNSIGNED_BYTE, new Uint8Array([255, 255, 255, 255]));
-        this.fallbackTexture = handle;
-        return handle;
-    }
-    getFallbackCubeTextureHandle() {
-        if (this.fallbackCubeTexture) {
-            return this.fallbackCubeTexture;
-        }
-        const handle = this.gl.createTexture();
-        if (!handle) {
-            throw new RenderDeviceError("Failed to allocate WebGL fallback cube texture", "WEBGL_ALLOCATION_FAILED");
-        }
-        this.stateCache.invalidate();
-        this.gl.bindTexture(this.gl.TEXTURE_CUBE_MAP, handle);
-        this.gl.texParameteri(this.gl.TEXTURE_CUBE_MAP, this.gl.TEXTURE_MIN_FILTER, this.gl.NEAREST);
-        this.gl.texParameteri(this.gl.TEXTURE_CUBE_MAP, this.gl.TEXTURE_MAG_FILTER, this.gl.NEAREST);
-        this.gl.texParameteri(this.gl.TEXTURE_CUBE_MAP, this.gl.TEXTURE_WRAP_S, this.gl.CLAMP_TO_EDGE);
-        this.gl.texParameteri(this.gl.TEXTURE_CUBE_MAP, this.gl.TEXTURE_WRAP_T, this.gl.CLAMP_TO_EDGE);
-        this.gl.texParameteri(this.gl.TEXTURE_CUBE_MAP, this.gl.TEXTURE_WRAP_R, this.gl.CLAMP_TO_EDGE);
-        const pixel = new Uint8Array([255, 255, 255, 255]);
-        for (const face of WEBGL_CUBE_FACES) {
-            this.gl.texImage2D(this.cubeFaceTarget(face), 0, this.gl.RGBA, 1, 1, 0, this.gl.RGBA, this.gl.UNSIGNED_BYTE, pixel);
-        }
-        this.fallbackCubeTexture = handle;
-        return handle;
-    }
-    getTextureHandle(texture) {
-        this.releaseDisposedTextureHandles();
-        if (texture.disposed) {
-            throw new RenderDeviceError("Texture is disposed", "DISPOSED_RESOURCE", { label: texture.label });
-        }
-        const cached = this.textures.get(texture);
-        if (cached) {
-            return cached;
-        }
-        const handle = this.gl.createTexture();
-        if (!handle) {
-            throw new RenderDeviceError("Failed to allocate WebGL texture", "WEBGL_ALLOCATION_FAILED", { label: texture.label });
-        }
-        this.stateCache.invalidate();
-        this.gl.pixelStorei(this.gl.UNPACK_FLIP_Y_WEBGL, false);
-        this.gl.pixelStorei(this.gl.UNPACK_PREMULTIPLY_ALPHA_WEBGL, false);
-        this.gl.pixelStorei(this.gl.UNPACK_COLORSPACE_CONVERSION_WEBGL, this.gl.NONE);
-        if (texture.dimension === "cube") {
-            this.uploadCubeTexture(texture, handle);
-            this.textureUploadModes.set(texture, "cube");
-            this.textures.set(texture, handle);
-            return handle;
-        }
-        this.gl.bindTexture(this.gl.TEXTURE_2D, handle);
-        if (isCompressedTextureFormat(texture.format)) {
-            const compressed = this.resolveCompressedTextureFormat(texture.format);
-            if (compressed) {
-                const uploadLevels = completeUploadLevels(texture.textureLevels);
-                for (const [levelIndex, level] of uploadLevels.entries()) {
-                    this.gl.compressedTexImage2D(this.gl.TEXTURE_2D, levelIndex, compressed.internalFormat, level.width, level.height, 0, level.data);
-                }
-                const compressedUploadError = this.readError();
-                if (!compressedUploadError) {
-                    this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_BASE_LEVEL, 0);
-                    this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_MAX_LEVEL, uploadLevels.length - 1);
-                    this.textureUploadModes.set(texture, "compressed");
-                    this.textures.set(texture, handle);
-                    return handle;
-                }
-            }
-            const fallbackLevels = completeUploadLevels(texture.fallbackTextureLevels);
-            if (fallbackLevels.length === 0) {
-                this.gl.deleteTexture(handle);
-                throw new RenderDeviceError("Compressed texture format is not supported and no RGBA8 fallback data was provided", "COMPRESSED_TEXTURE_UNSUPPORTED", {
-                    label: texture.label,
-                    format: texture.format
-                });
-            }
-            this.uploadRgba8FallbackTexture(texture, fallbackLevels);
-            this.textureUploadModes.set(texture, "fallback");
-            this.textures.set(texture, handle);
-            return handle;
-        }
-        if (texture.format === "depth24") {
-            throw new RenderDeviceError("Depth textures cannot be uploaded to WebGL2 color samplers", "UNSUPPORTED_TEXTURE_FORMAT", {
-                label: texture.label,
-                format: texture.format
-            });
-        }
-        if (texture.source) {
-            this.gl.texImage2D(this.gl.TEXTURE_2D, 0, this.rgba8TextureInternalFormat(texture), this.gl.RGBA, this.gl.UNSIGNED_BYTE, texture.source);
-            this.gl.generateMipmap(this.gl.TEXTURE_2D);
-        }
-        else if (texture.mipLevels.length > 0) {
-            const uploadFormat = this.textureUploadFormat(texture);
-            const uploadLevels = completeUploadLevels(texture.textureLevels);
-            for (const [levelIndex, level] of uploadLevels.entries()) {
-                this.gl.texImage2D(this.gl.TEXTURE_2D, levelIndex, uploadFormat.internalFormat, level.width, level.height, 0, uploadFormat.format, uploadFormat.type, texturePixelUploadData(level.data, texture.format));
-            }
-            this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_BASE_LEVEL, 0);
-            this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_MAX_LEVEL, uploadLevels.length - 1);
-        }
-        else {
-            const uploadFormat = this.textureUploadFormat(texture);
-            this.gl.texImage2D(this.gl.TEXTURE_2D, 0, uploadFormat.internalFormat, texture.width, texture.height, 0, uploadFormat.format, uploadFormat.type, texture.data ? texturePixelUploadData(texture.data, texture.format) : null);
-            // Float colour formats are not guaranteed mipmap-filterable in WebGL2:
-            // RGBA32F/RGBA16F are only linear-filterable with OES_texture_float_linear, and
-            // generateMipmap on a non-filterable format raises INVALID_OPERATION. Data
-            // textures such as joint palettes are point-sampled with texelFetch and never
-            // need mips, so skip generation and pin the level range instead.
-            if (isFloatColorTextureFormat(texture.format)) {
-                this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_BASE_LEVEL, 0);
-                this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_MAX_LEVEL, 0);
-                this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_MIN_FILTER, this.gl.NEAREST);
-                this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_MAG_FILTER, this.gl.NEAREST);
-            }
-            else {
-                this.gl.generateMipmap(this.gl.TEXTURE_2D);
-            }
-        }
-        this.textureUploadModes.set(texture, texture.format);
-        this.textures.set(texture, handle);
-        return handle;
-    }
-    uploadCubeTexture(texture, handle) {
-        this.gl.bindTexture(this.gl.TEXTURE_CUBE_MAP, handle);
-        const uploadFormat = this.textureUploadFormat(texture);
-        for (const face of texture.cubeFaces) {
-            const uploadLevels = completeUploadLevels(face.mipLevels);
-            for (const [levelIndex, level] of uploadLevels.entries()) {
-                this.gl.texImage2D(this.cubeFaceTarget(face.face), levelIndex, uploadFormat.internalFormat, level.width, level.height, 0, uploadFormat.format, uploadFormat.type, texturePixelUploadData(level.data, texture.format));
-            }
-        }
-        const firstFaceLevels = completeUploadLevels(texture.cubeFaces[0]?.mipLevels ?? []);
-        this.gl.texParameteri(this.gl.TEXTURE_CUBE_MAP, this.gl.TEXTURE_BASE_LEVEL, 0);
-        this.gl.texParameteri(this.gl.TEXTURE_CUBE_MAP, this.gl.TEXTURE_MAX_LEVEL, Math.max(0, firstFaceLevels.length - 1));
-        this.gl.texParameteri(this.gl.TEXTURE_CUBE_MAP, this.gl.TEXTURE_WRAP_S, this.gl.CLAMP_TO_EDGE);
-        this.gl.texParameteri(this.gl.TEXTURE_CUBE_MAP, this.gl.TEXTURE_WRAP_T, this.gl.CLAMP_TO_EDGE);
-        this.gl.texParameteri(this.gl.TEXTURE_CUBE_MAP, this.gl.TEXTURE_WRAP_R, this.gl.CLAMP_TO_EDGE);
-    }
-    uploadRgba8FallbackTexture(texture, fallbackLevels) {
-        const internalFormat = this.rgba8TextureInternalFormat(texture);
-        for (const [levelIndex, level] of fallbackLevels.entries()) {
-            this.gl.texImage2D(this.gl.TEXTURE_2D, levelIndex, internalFormat, level.width, level.height, 0, this.gl.RGBA, this.gl.UNSIGNED_BYTE, texturePixelUploadData(level.data, "rgba8"));
-        }
-        this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_BASE_LEVEL, 0);
-        this.gl.texParameteri(this.gl.TEXTURE_2D, this.gl.TEXTURE_MAX_LEVEL, fallbackLevels.length - 1);
-    }
-    cubeFaceTarget(face) {
-        switch (face) {
-            case "px": return this.gl.TEXTURE_CUBE_MAP_POSITIVE_X;
-            case "nx": return this.gl.TEXTURE_CUBE_MAP_NEGATIVE_X;
-            case "py": return this.gl.TEXTURE_CUBE_MAP_POSITIVE_Y;
-            case "ny": return this.gl.TEXTURE_CUBE_MAP_NEGATIVE_Y;
-            case "pz": return this.gl.TEXTURE_CUBE_MAP_POSITIVE_Z;
-            case "nz": return this.gl.TEXTURE_CUBE_MAP_NEGATIVE_Z;
-        }
-    }
-    rgba8TextureInternalFormat(texture) {
-        return texture.colorSpace === "srgb" ? this.gl.SRGB8_ALPHA8 : this.gl.RGBA;
-    }
-    textureUploadFormat(texture) {
-        if (texture.format === "rgba8") {
-            return { internalFormat: this.rgba8TextureInternalFormat(texture), format: this.gl.RGBA, type: this.gl.UNSIGNED_BYTE };
-        }
-        if (texture.colorSpace === "srgb") {
-            throw new RenderDeviceError("Floating-point texture uploads must use linear colorSpace", "UNSUPPORTED_TEXTURE_FORMAT", {
-                label: texture.label,
-                format: texture.format,
-                colorSpace: texture.colorSpace
-            });
-        }
-        if (texture.format === "rgba16f") {
-            return { internalFormat: this.gl.RGBA16F, format: this.gl.RGBA, type: this.gl.HALF_FLOAT };
-        }
-        if (texture.format === "rgba32f") {
-            return { internalFormat: this.gl.RGBA32F, format: this.gl.RGBA, type: this.gl.FLOAT };
-        }
-        throw new RenderDeviceError("Unsupported texture upload format", "UNSUPPORTED_TEXTURE_FORMAT", {
-            label: texture.label,
-            format: texture.format
-        });
-    }
-    resolveRenderTargetFormat(format) {
-        if (format === "rgba8") {
-            return { internalFormat: this.gl.RGBA, type: this.gl.UNSIGNED_BYTE };
-        }
-        if (!this.gl.getExtension("EXT_color_buffer_float")) {
-            throw new RenderDeviceError("Floating-point color render targets require EXT_color_buffer_float", "HDR_RENDER_TARGET_UNSUPPORTED", { format });
-        }
-        if (format === "rgba16f") {
-            return { internalFormat: this.gl.RGBA16F, type: this.gl.HALF_FLOAT };
-        }
-        return { internalFormat: this.gl.RGBA32F, type: this.gl.FLOAT };
-    }
-    releaseDisposedTextureHandles() {
-        for (const [texture, handle] of [...this.textures]) {
-            if (texture.disposed) {
-                this.gl.deleteTexture(handle);
-                this.textures.delete(texture);
-                this.textureUploadModes.delete(texture);
-                this.releasedTextureHandles += 1;
-            }
-        }
-    }
-    resolveCompressedTextureFormat(format) {
-        switch (format) {
-            case "bc1-rgba-unorm": {
-                const extension = this.gl.getExtension("WEBGL_compressed_texture_s3tc");
-                return extension ? { internalFormat: extension.COMPRESSED_RGBA_S3TC_DXT1_EXT } : null;
-            }
-            case "bc3-rgba-unorm": {
-                const extension = this.gl.getExtension("WEBGL_compressed_texture_s3tc");
-                return extension ? { internalFormat: extension.COMPRESSED_RGBA_S3TC_DXT5_EXT } : null;
-            }
-            case "etc2-rgba8unorm":
-                return { internalFormat: 0x9278 };
-            case "astc-4x4-rgba-unorm": {
-                const extension = this.gl.getExtension("WEBGL_compressed_texture_astc");
-                return extension ? { internalFormat: extension.COMPRESSED_RGBA_ASTC_4x4_KHR } : null;
-            }
-        }
-    }
-    magFilter(filter) {
-        return filter === "nearest" ? this.gl.NEAREST : this.gl.LINEAR;
-    }
-    minFilter(filter) {
-        switch (filter) {
-            case "nearest":
-                return this.gl.NEAREST;
-            case "linear":
-                return this.gl.LINEAR;
-            case "nearest-mipmap-nearest":
-                return this.gl.NEAREST_MIPMAP_NEAREST;
-            case "linear-mipmap-nearest":
-                return this.gl.LINEAR_MIPMAP_NEAREST;
-            case "nearest-mipmap-linear":
-                return this.gl.NEAREST_MIPMAP_LINEAR;
-            case "linear-mipmap-linear":
-                return this.gl.LINEAR_MIPMAP_LINEAR;
-        }
-    }
-    addressMode(mode) {
-        if (mode === "repeat")
-            return this.gl.REPEAT;
-        if (mode === "mirror-repeat")
-            return this.gl.MIRRORED_REPEAT;
-        return this.gl.CLAMP_TO_EDGE;
-    }
-    bindVertexFormat(shader, format) {
-        const boundLocations = new Set();
-        for (const attribute of format.attributes) {
-            const location = this.resolveAttributeLocation(shader, attribute);
-            if (location < 0) {
-                continue;
-            }
-            if (attribute.type !== "float32") {
-                throw new RenderDeviceError("Unsupported vertex attribute type", "UNSUPPORTED_VERTEX_ATTRIBUTE", {
-                    attribute: attribute.shaderName,
-                    type: attribute.type
-                });
-            }
-            boundLocations.add(location);
-            this.gl.enableVertexAttribArray(location);
-            this.gl.vertexAttribDivisor(location, 0);
-            this.gl.vertexAttribPointer(location, attribute.components, this.gl.FLOAT, attribute.normalized, format.stride, attribute.offset);
-        }
-        return boundLocations;
-    }
-    bindVertexArrayForCommand(command, shader, vertexBuffer) {
-        const indexBuffer = command.indexBuffer ? this.requireBuffer(command.indexBuffer) : undefined;
-        const key = this.vertexArrayCacheKey(command, shader, vertexBuffer, indexBuffer);
-        const cached = this.vertexArrayCache.get(key);
-        if (cached) {
-            this.stateCache.bindVertexArray(cached.handle, () => this.gl.bindVertexArray(cached.handle));
-            return cached;
-        }
-        const handle = this.gl.createVertexArray();
-        if (!handle) {
-            throw new RenderDeviceError("Failed to allocate WebGL vertex array", "WEBGL_ALLOCATION_FAILED");
-        }
-        this.vertexArrayCreateCount += 1;
-        this.stateCache.bindVertexArray(handle, () => this.gl.bindVertexArray(handle));
-        this.stateCache.bindBuffer(this.gl.ARRAY_BUFFER, vertexBuffer.handle, () => this.gl.bindBuffer(this.gl.ARRAY_BUFFER, vertexBuffer.handle));
-        const boundLocations = this.bindVertexFormat(shader, command.vertexFormat);
-        if (command.instanceAttributes && command.instanceAttributes.length > 0) {
-            this.bindInstanceAttributes(shader, command.instanceAttributes, boundLocations);
-        }
-        if (indexBuffer) {
-            this.stateCache.bindBuffer(this.gl.ELEMENT_ARRAY_BUFFER, indexBuffer.handle, () => this.gl.bindBuffer(this.gl.ELEMENT_ARRAY_BUFFER, indexBuffer.handle));
-        }
-        this.disableUnboundVertexAttributes(boundLocations);
-        this.applyDefaultAttributes(shader, boundLocations);
-        const entry = { key, handle, boundLocations };
-        this.vertexArrayCache.set(key, entry);
-        return entry;
-    }
-    bindNoVertexArray() {
-        this.stateCache.bindVertexArray(null, () => this.gl.bindVertexArray(null));
-    }
-    vertexArrayCacheKey(command, shader, vertexBuffer, indexBuffer) {
-        const instanceKey = (command.instanceAttributes ?? []).map((attribute) => {
-            const buffer = this.requireBuffer(attribute.buffer);
-            return `${attribute.shaderName}:${buffer.id}:${attribute.components}:${attribute.offset}:${attribute.stride}:${attribute.normalized === true ? 1 : 0}:${attribute.divisor ?? 1}`;
-        }).join(",");
-        return [
-            shader.id,
-            vertexBuffer.id,
-            this.vertexFormatId(command.vertexFormat),
-            indexBuffer?.id ?? 0,
-            instanceKey
-        ].join("|");
-    }
-    vertexFormatId(format) {
-        const existing = this.vertexFormatIds.get(format);
-        if (existing !== undefined)
-            return existing;
-        const next = this.nextVertexFormatId;
-        this.nextVertexFormatId += 1;
-        this.vertexFormatIds.set(format, next);
-        return next;
-    }
-    bindInstanceAttributes(shader, attributes, boundLocations) {
-        for (const attribute of attributes) {
-            const location = shader.reflection.attributes.get(attribute.shaderName);
-            if (location === undefined || location < 0) {
-                continue;
-            }
-            if (![1, 2, 3, 4].includes(attribute.components)) {
-                throw new RenderDeviceError("Instance vertex attribute components must be 1, 2, 3, or 4", "INVALID_DRAW_COMMAND", {
-                    attribute: attribute.shaderName,
-                    components: attribute.components
-                });
-            }
-            if (!Number.isInteger(attribute.offset) || attribute.offset < 0 || attribute.offset % 4 !== 0) {
-                throw new RenderDeviceError("Instance vertex attribute offset must be non-negative and 4-byte aligned", "INVALID_DRAW_COMMAND", {
-                    attribute: attribute.shaderName,
-                    offset: attribute.offset
-                });
-            }
-            if (!Number.isInteger(attribute.stride) || attribute.stride <= 0 || attribute.stride % 4 !== 0) {
-                throw new RenderDeviceError("Instance vertex attribute stride must be positive and 4-byte aligned", "INVALID_DRAW_COMMAND", {
-                    attribute: attribute.shaderName,
-                    stride: attribute.stride
-                });
-            }
-            if (attribute.offset + attribute.components * 4 > attribute.stride) {
-                throw new RenderDeviceError("Instance vertex attribute range must fit inside its stride", "INVALID_DRAW_COMMAND", {
-                    attribute: attribute.shaderName,
-                    offset: attribute.offset,
-                    components: attribute.components,
-                    stride: attribute.stride
-                });
-            }
-            const buffer = this.requireBuffer(attribute.buffer);
-            boundLocations.add(location);
-            this.stateCache.bindBuffer(this.gl.ARRAY_BUFFER, buffer.handle, () => this.gl.bindBuffer(this.gl.ARRAY_BUFFER, buffer.handle));
-            this.gl.enableVertexAttribArray(location);
-            this.gl.vertexAttribPointer(location, attribute.components, this.gl.FLOAT, attribute.normalized ?? false, attribute.stride, attribute.offset);
-            this.gl.vertexAttribDivisor(location, attribute.divisor ?? 1);
-        }
-    }
-    resolveAttributeLocation(shader, attribute) {
-        const reflected = shader.reflection.attributes.get(attribute.shaderName);
-        if (reflected !== undefined) {
-            return reflected;
-        }
-        return shader.reflection.attributes.get(attribute.semantic) ?? -1;
-    }
-    applyDefaultAttributes(shader, boundLocations) {
-        const colorLocation = shader.reflection.attributes.get("a_color") ?? shader.reflection.attributes.get("color");
-        if (colorLocation !== undefined && colorLocation >= 0 && !boundLocations.has(colorLocation)) {
-            this.gl.disableVertexAttribArray(colorLocation);
-            this.gl.vertexAttribDivisor(colorLocation, 0);
-            this.gl.vertexAttrib4f(colorLocation, 1, 1, 1, 1);
-        }
-        const tangentLocation = shader.reflection.attributes.get("a_tangent") ?? shader.reflection.attributes.get("tangent");
-        if (tangentLocation !== undefined && tangentLocation >= 0 && !boundLocations.has(tangentLocation)) {
-            this.gl.disableVertexAttribArray(tangentLocation);
-            this.gl.vertexAttribDivisor(tangentLocation, 0);
-            this.gl.vertexAttrib4f(tangentLocation, 1, 0, 0, 1);
-        }
-        const uv1Location = shader.reflection.attributes.get("a_uv1") ?? shader.reflection.attributes.get("uv1");
-        if (uv1Location !== undefined && uv1Location >= 0 && !boundLocations.has(uv1Location)) {
-            this.gl.disableVertexAttribArray(uv1Location);
-            this.gl.vertexAttribDivisor(uv1Location, 0);
-            this.gl.vertexAttrib2f(uv1Location, 0, 0);
-        }
-        const instanceColorLocation = shader.reflection.attributes.get("a_instanceColor") ?? shader.reflection.attributes.get("instanceColor");
-        if (instanceColorLocation !== undefined && instanceColorLocation >= 0 && !boundLocations.has(instanceColorLocation)) {
-            this.gl.disableVertexAttribArray(instanceColorLocation);
-            this.gl.vertexAttribDivisor(instanceColorLocation, 0);
-            this.gl.vertexAttrib4f(instanceColorLocation, 1, 1, 1, 1);
-        }
-    }
-    disableUnboundVertexAttributes(boundLocations) {
-        for (let location = 0; location < this.maxVertexAttributes; location += 1) {
-            if (!boundLocations.has(location)) {
-                this.gl.disableVertexAttribArray(location);
-                this.gl.vertexAttribDivisor(location, 0);
-            }
-        }
-    }
-    primitive(topology) {
-        if (topology === "lines")
-            return this.gl.LINES;
-        if (topology === "points")
-            return this.gl.POINTS;
-        return this.gl.TRIANGLES;
-    }
-    applyRenderState(state) {
-        const renderState = state ?? {
-            depthTest: true,
-            depthWrite: true,
-            cullMode: "back",
-            blend: false,
-            depthCompare: "less-equal",
-            colorWrite: [true, true, true, true],
-            scissor: null,
-            polygonOffset: null,
-            stencil: null
-        };
-        this.stateCache.setEnabled(this.gl.DEPTH_TEST, renderState.depthTest, () => {
-            if (renderState.depthTest)
-                this.gl.enable(this.gl.DEPTH_TEST);
-            else
-                this.gl.disable(this.gl.DEPTH_TEST);
-        });
-        this.stateCache.depthMask(renderState.depthWrite, () => this.gl.depthMask(renderState.depthWrite));
-        this.stateCache.depthFunc(renderState.depthCompare === "always" ? this.gl.ALWAYS : this.gl.LEQUAL, () => this.gl.depthFunc(renderState.depthCompare === "always" ? this.gl.ALWAYS : this.gl.LEQUAL));
-        const colorWrite = renderState.colorWrite ?? [true, true, true, true];
-        this.stateCache.colorMask(colorWrite[0], colorWrite[1], colorWrite[2], colorWrite[3], () => this.gl.colorMask(colorWrite[0], colorWrite[1], colorWrite[2], colorWrite[3]));
-        if (renderState.scissor) {
-            this.stateCache.setEnabled(this.gl.SCISSOR_TEST, true, () => this.gl.enable(this.gl.SCISSOR_TEST));
-            this.stateCache.scissor(renderState.scissor.x, renderState.scissor.y, renderState.scissor.width, renderState.scissor.height, () => {
-                this.gl.scissor(renderState.scissor.x, renderState.scissor.y, renderState.scissor.width, renderState.scissor.height);
-            });
-        }
-        else {
-            this.stateCache.setEnabled(this.gl.SCISSOR_TEST, false, () => this.gl.disable(this.gl.SCISSOR_TEST));
-        }
-        if (renderState.polygonOffset) {
-            this.stateCache.setEnabled(this.gl.POLYGON_OFFSET_FILL, true, () => this.gl.enable(this.gl.POLYGON_OFFSET_FILL));
-            this.stateCache.polygonOffset(renderState.polygonOffset.factor, renderState.polygonOffset.units, () => this.gl.polygonOffset(renderState.polygonOffset.factor, renderState.polygonOffset.units));
-        }
-        else {
-            this.stateCache.setEnabled(this.gl.POLYGON_OFFSET_FILL, false, () => this.gl.disable(this.gl.POLYGON_OFFSET_FILL));
-        }
-        if (renderState.stencil) {
-            const stencil = renderState.stencil;
-            const compare = this.stencilCompare(stencil.compare ?? "always");
-            const reference = stencil.reference ?? 0;
-            const readMask = stencil.readMask ?? 0xff;
-            const writeMask = stencil.writeMask ?? 0xff;
-            const fail = this.stencilOperation(stencil.fail ?? "keep");
-            const depthFail = this.stencilOperation(stencil.depthFail ?? "keep");
-            const depthPass = this.stencilOperation(stencil.depthPass ?? "keep");
-            this.stateCache.setEnabled(this.gl.STENCIL_TEST, true, () => this.gl.enable(this.gl.STENCIL_TEST));
-            this.stateCache.stencilFunc(compare, reference, readMask, () => this.gl.stencilFunc(compare, reference, readMask));
-            this.stateCache.stencilMask(writeMask, () => this.gl.stencilMask(writeMask));
-            this.stateCache.stencilOp(fail, depthFail, depthPass, () => this.gl.stencilOp(fail, depthFail, depthPass));
-        }
-        else {
-            this.stateCache.setEnabled(this.gl.STENCIL_TEST, false, () => this.gl.disable(this.gl.STENCIL_TEST));
-        }
-        if (renderState.cullMode === "none") {
-            this.stateCache.setEnabled(this.gl.CULL_FACE, false, () => this.gl.disable(this.gl.CULL_FACE));
-        }
-        else {
-            this.stateCache.setEnabled(this.gl.CULL_FACE, true, () => this.gl.enable(this.gl.CULL_FACE));
-            this.stateCache.cullFace(renderState.cullMode === "front" ? this.gl.FRONT : this.gl.BACK, () => this.gl.cullFace(renderState.cullMode === "front" ? this.gl.FRONT : this.gl.BACK));
-        }
-        if (renderState.blend) {
-            this.stateCache.setEnabled(this.gl.BLEND, true, () => this.gl.enable(this.gl.BLEND));
-            this.stateCache.blendFunc(this.gl.SRC_ALPHA, this.gl.ONE_MINUS_SRC_ALPHA, () => this.gl.blendFunc(this.gl.SRC_ALPHA, this.gl.ONE_MINUS_SRC_ALPHA));
-        }
-        else {
-            this.stateCache.setEnabled(this.gl.BLEND, false, () => this.gl.disable(this.gl.BLEND));
-        }
-    }
-    requireBuffer(buffer) {
-        if (!(buffer instanceof WebGL2Buffer) || !this.buffers.has(buffer) || buffer.disposed) {
-            throw new RenderDeviceError("Buffer is not a live WebGL2 resource owned by this device", "INVALID_RESOURCE", {
-                bufferId: buffer.id
-            });
-        }
-        return buffer;
-    }
-    stencilCompare(compare) {
-        switch (compare) {
-            case "never": return this.gl.NEVER;
-            case "less": return this.gl.LESS;
-            case "less-equal": return this.gl.LEQUAL;
-            case "greater": return this.gl.GREATER;
-            case "greater-equal": return this.gl.GEQUAL;
-            case "equal": return this.gl.EQUAL;
-            case "not-equal": return this.gl.NOTEQUAL;
-            case "always": return this.gl.ALWAYS;
-        }
-    }
-    stencilOperation(operation) {
-        switch (operation) {
-            case "keep": return this.gl.KEEP;
-            case "zero": return this.gl.ZERO;
-            case "replace": return this.gl.REPLACE;
-            case "increment": return this.gl.INCR;
-            case "decrement": return this.gl.DECR;
-            case "invert": return this.gl.INVERT;
-            case "increment-wrap": return this.gl.INCR_WRAP;
-            case "decrement-wrap": return this.gl.DECR_WRAP;
-        }
-    }
-    requireShader(shader) {
-        if (!(shader instanceof WebGL2ShaderProgram) || !this.shaders.has(shader) || shader.disposed) {
-            throw new RenderDeviceError("Shader is not a live WebGL2 resource owned by this device", "INVALID_RESOURCE", {
-                shaderId: shader.id
-            });
-        }
-        return shader;
-    }
-    assertAlive() {
-        if (this.disposed) {
-            throw new RenderDeviceError("Render device is disposed", "DISPOSED_DEVICE");
-        }
-        if (this.contextLost) {
-            throw new RenderDeviceError("Render context is lost", "CONTEXT_LOST");
-        }
-    }
-    assertFrame() {
-        this.assertAlive();
-        if (!this.frameActive) {
-            throw new RenderDeviceError("No active frame", "NO_ACTIVE_FRAME");
-        }
-    }
-    readError() {
-        const error = this.gl.getError();
-        return error === this.gl.NO_ERROR ? null : `0x${error.toString(16)}`;
-    }
-}
-function numberOption(options, key, fallback) {
-    const value = options[key];
-    return typeof value === "number" && Number.isFinite(value) ? value : fallback;
-}
-function normalizeNativeBloomOptions(options) {
-    const threshold = bloomNumberOption(options, "threshold", 0.75);
-    const intensity = bloomNumberOption(options, "intensity", 0.35);
-    const radius = bloomNumberOption(options, "radius", 1);
-    if (threshold < 0 || threshold > 1) {
-        throw new RenderDeviceError("Bloom threshold must be finite and in [0, 1].", "INVALID_POSTPROCESS_OPTIONS", { threshold });
-    }
-    if (intensity < 0) {
-        throw new RenderDeviceError("Bloom intensity must be finite and non-negative.", "INVALID_POSTPROCESS_OPTIONS", { intensity });
-    }
-    if (!Number.isInteger(radius) || radius < 0 || radius > 16) {
-        throw new RenderDeviceError("Bloom radius must be an integer in [0, 16].", "INVALID_POSTPROCESS_OPTIONS", { radius });
-    }
-    const softKnee = bloomNumberOption(options, "softKnee", 0);
-    if (!(softKnee >= 0) || softKnee > 0.5) {
-        throw new RenderDeviceError("Bloom softKnee must be finite and in [0, 0.5].", "INVALID_POSTPROCESS_OPTIONS", { softKnee });
-    }
-    const shoulder = bloomNumberOption(options, "shoulder", 0);
-    if (!(shoulder >= 0) || shoulder > 1) {
-        throw new RenderDeviceError("Bloom shoulder must be finite and in [0, 1].", "INVALID_POSTPROCESS_OPTIONS", { shoulder });
-    }
-    let quality;
-    try {
-        quality = normalizeBloomQualityPreset(options.quality);
-    }
-    catch {
-        throw new RenderDeviceError("Bloom quality must be one of performance|balanced|cinematic.", "INVALID_POSTPROCESS_OPTIONS", { quality: options.quality });
-    }
-    return { threshold, intensity, radius, quality, softKnee, shoulder };
-}
-function normalizeNativeOutlineOptions(options) {
-    const width = outlineNumberOption(options, "width", 1);
-    const threshold = outlineNumberOption(options, "threshold", 0.22);
-    const opacity = outlineNumberOption(options, "opacity", 0.85);
-    const value = options.color;
-    const sourceColor = value === undefined ? [255, 188, 64, 255] : value;
-    if (!Array.isArray(sourceColor)
-        || (sourceColor.length !== 3 && sourceColor.length !== 4)
-        || sourceColor.some((channel) => typeof channel !== "number" || !Number.isFinite(channel) || channel < 0 || channel > 255)) {
-        throw new RenderDeviceError("Outline color must contain three or four finite channels in [0, 255].", "INVALID_POSTPROCESS_OPTIONS", { color: value });
-    }
-    if (!Number.isInteger(width) || width < 1 || width > 6) {
-        throw new RenderDeviceError("Outline width must be an integer in [1, 6].", "INVALID_POSTPROCESS_OPTIONS", { width });
-    }
-    if (threshold < 0 || threshold > 4) {
-        throw new RenderDeviceError("Outline threshold must be finite and in [0, 4].", "INVALID_POSTPROCESS_OPTIONS", { threshold });
-    }
-    if (opacity < 0 || opacity > 1) {
-        throw new RenderDeviceError("Outline opacity must be finite and in [0, 1].", "INVALID_POSTPROCESS_OPTIONS", { opacity });
-    }
-    const color = [
-        sourceColor[0],
-        sourceColor[1],
-        sourceColor[2],
-        (sourceColor[3] ?? 255)
-    ];
-    return { width, threshold, opacity, color };
-}
-function normalizeNativeSsaoOptions(options) {
-    const radius = ssaoNumberOption(options, "radius", 2);
-    const intensity = ssaoNumberOption(options, "intensity", 0.38);
-    const bias = ssaoNumberOption(options, "bias", 0.015);
-    if (!Number.isInteger(radius) || radius < 1 || radius > 8) {
-        throw new RenderDeviceError("SSAO radius must be an integer in [1, 8].", "INVALID_POSTPROCESS_OPTIONS", { radius });
-    }
-    if (intensity < 0 || intensity > 2) {
-        throw new RenderDeviceError("SSAO intensity must be finite and in [0, 2].", "INVALID_POSTPROCESS_OPTIONS", { intensity });
-    }
-    if (bias < 0 || bias > 0.25) {
-        throw new RenderDeviceError("SSAO bias must be finite and in [0, 0.25].", "INVALID_POSTPROCESS_OPTIONS", { bias });
-    }
-    return { radius, intensity, bias };
 }
 /**
  * Camera depth range for linearizing sampleable GL depth in the native
@@ -3807,185 +1334,12 @@ function normalizeNativeSsaoOptions(options) {
  * keep fixture-unit depth semantics (deterministic reference); the native
  * programs document their GL-depth contract in-shader.
  */
-function normalizeLdrDepthRange(range) {
-    const near = range && Number.isFinite(range.near) && range.near > 0 ? range.near : 0.1;
-    const far = range && Number.isFinite(range.far) && range.far > near ? range.far : 1000;
-    return { near, far };
-}
-function normalizeNativeSsrOptions(options) {
-    const intensity = ssrNumberOption(options, "intensity", 0.32);
-    const maxDistance = ssrNumberOption(options, "maxDistance", 16);
-    if (intensity < 0 || intensity > 2) {
-        throw new RenderDeviceError("SSR intensity must be finite and in [0, 2].", "INVALID_POSTPROCESS_OPTIONS", { intensity });
-    }
-    if (!Number.isInteger(maxDistance) || maxDistance < 1 || maxDistance > 64) {
-        throw new RenderDeviceError("SSR maxDistance must be an integer in [1, 64].", "INVALID_POSTPROCESS_OPTIONS", { maxDistance });
-    }
-    return { intensity, maxDistance };
-}
-function normalizeNativeDepthOfFieldOptions(options) {
-    const focusDepth = depthOfFieldNumberOption(options, "focusDepth", 0.5);
-    const focusRange = depthOfFieldNumberOption(options, "focusRange", 0.12);
-    const maxRadius = depthOfFieldNumberOption(options, "maxRadius", 2);
-    if (focusDepth < 0 || focusDepth > 1) {
-        throw new RenderDeviceError("Depth-of-field focusDepth must be finite and in [0, 1].", "INVALID_POSTPROCESS_OPTIONS", { focusDepth });
-    }
-    if (focusRange < 0.001 || focusRange > 1) {
-        throw new RenderDeviceError("Depth-of-field focusRange must be finite and in [0.001, 1].", "INVALID_POSTPROCESS_OPTIONS", { focusRange });
-    }
-    if (!Number.isInteger(maxRadius) || maxRadius < 0 || maxRadius > 8) {
-        throw new RenderDeviceError("Depth-of-field maxRadius must be an integer in [0, 8].", "INVALID_POSTPROCESS_OPTIONS", { maxRadius });
-    }
-    return { focusDepth, focusRange, maxRadius };
-}
-function normalizeNativeMotionBlurOptions(options, width, height) {
-    const samples = motionBlurNumberOption(options, "samples", 5);
-    const scale = motionBlurNumberOption(options, "scale", 1);
-    const value = options.velocity;
-    if (!(value instanceof Float32Array) && !Array.isArray(value)) {
-        throw new RenderDeviceError("Motion blur requires a velocity Float32Array or number array.", "WEBGL_LDR_POSTPROCESS_VELOCITY_REQUIRED");
-    }
-    const velocity = value instanceof Float32Array ? value : new Float32Array(value);
-    if (velocity.length !== width * height * 2) {
-        throw new RenderDeviceError("Motion blur velocity must contain width * height * 2 float samples.", "INVALID_POSTPROCESS_OPTIONS", {
-            expectedLength: width * height * 2,
-            actualLength: velocity.length
-        });
-    }
-    if (!Number.isInteger(samples) || samples < 2 || samples > 16) {
-        throw new RenderDeviceError("Motion blur samples must be an integer in [2, 16].", "INVALID_POSTPROCESS_OPTIONS", { samples });
-    }
-    if (scale < 0 || scale > 8) {
-        throw new RenderDeviceError("Motion blur scale must be finite and in [0, 8].", "INVALID_POSTPROCESS_OPTIONS", { scale });
-    }
-    return { samples, scale, velocity };
-}
-function normalizeNativeTaaOptions(options, width, height) {
-    const blend = taaNumberOption(options, "blend", 0.18);
-    const history = options.history;
-    if (!(history instanceof Uint8Array)) {
-        throw new RenderDeviceError("TAA requires a Uint8Array history buffer.", "WEBGL_LDR_POSTPROCESS_HISTORY_REQUIRED");
-    }
-    if (history.byteLength !== width * height * 4) {
-        throw new RenderDeviceError("TAA history must contain width * height * 4 RGBA bytes.", "INVALID_POSTPROCESS_OPTIONS", {
-            expectedLength: width * height * 4,
-            actualLength: history.byteLength
-        });
-    }
-    if (blend < 0 || blend > 0.95) {
-        throw new RenderDeviceError("TAA blend must be finite and in [0, 0.95].", "INVALID_POSTPROCESS_OPTIONS", { blend });
-    }
-    return { blend, history };
-}
-function bloomNumberOption(options, key, fallback) {
-    const value = options[key];
-    if (value === undefined)
-        return fallback;
-    if (typeof value !== "number" || !Number.isFinite(value)) {
-        throw new RenderDeviceError(`Bloom ${key} must be a finite number.`, "INVALID_POSTPROCESS_OPTIONS", { key, value });
-    }
-    return value;
-}
-function outlineNumberOption(options, key, fallback) {
-    const value = options[key];
-    if (value === undefined)
-        return fallback;
-    if (typeof value !== "number" || !Number.isFinite(value)) {
-        throw new RenderDeviceError(`Outline ${key} must be a finite number.`, "INVALID_POSTPROCESS_OPTIONS", { key, value });
-    }
-    return value;
-}
-function ssaoNumberOption(options, key, fallback) {
-    const value = options[key];
-    if (value === undefined)
-        return fallback;
-    if (typeof value !== "number" || !Number.isFinite(value)) {
-        throw new RenderDeviceError(`SSAO ${key} must be a finite number.`, "INVALID_POSTPROCESS_OPTIONS", { key, value });
-    }
-    return value;
-}
-function ssrNumberOption(options, key, fallback) {
-    const value = options[key];
-    if (value === undefined)
-        return fallback;
-    if (typeof value !== "number" || !Number.isFinite(value)) {
-        throw new RenderDeviceError(`SSR ${key} must be a finite number.`, "INVALID_POSTPROCESS_OPTIONS", { key, value });
-    }
-    return value;
-}
-function depthOfFieldNumberOption(options, key, fallback) {
-    const value = options[key];
-    if (value === undefined)
-        return fallback;
-    if (typeof value !== "number" || !Number.isFinite(value)) {
-        throw new RenderDeviceError(`Depth-of-field ${key} must be a finite number.`, "INVALID_POSTPROCESS_OPTIONS", { key, value });
-    }
-    return value;
-}
-function motionBlurNumberOption(options, key, fallback) {
-    const value = options[key];
-    if (value === undefined)
-        return fallback;
-    if (typeof value !== "number" || !Number.isFinite(value)) {
-        throw new RenderDeviceError(`Motion blur ${key} must be a finite number.`, "INVALID_POSTPROCESS_OPTIONS", { key, value });
-    }
-    return value;
-}
-function taaNumberOption(options, key, fallback) {
-    const value = options[key];
-    if (value === undefined)
-        return fallback;
-    if (typeof value !== "number" || !Number.isFinite(value)) {
-        throw new RenderDeviceError(`TAA ${key} must be a finite number.`, "INVALID_POSTPROCESS_OPTIONS", { key, value });
-    }
-    return value;
-}
-function stringOption(options, key, fallback) {
-    const value = options[key];
-    return typeof value === "string" ? value : fallback;
-}
-function colorSpaceId(value) {
-    return value === "srgb" ? 1 : 0;
-}
-function toneMappingOperatorId(value) {
-    if (value === "linear")
-        return 0;
-    if (value === "reinhard")
-        return 1;
-    if (value === "aces")
-        return 2;
-    if (value === "filmic")
-        return 3;
-    if (value === "uncharted2")
-        return 4;
-    if (value === "agx")
-        return 5;
-    return 6;
-}
-function completeUploadLevels(levels) {
-    const uploadLevels = [];
-    for (const level of levels) {
-        if (uploadLevels.length === 0) {
-            uploadLevels.push(level);
-            continue;
-        }
-        const previous = uploadLevels[uploadLevels.length - 1];
-        const expectedWidth = Math.max(1, Math.floor(previous.width / 2));
-        const expectedHeight = Math.max(1, Math.floor(previous.height / 2));
-        if (level.width !== expectedWidth || level.height !== expectedHeight) {
-            break;
-        }
-        uploadLevels.push(level);
-    }
-    return uploadLevels;
-}
-function texturePixelUploadData(data, format) {
-    if (format === "rgba16f" && data instanceof Uint16Array)
-        return data;
-    if (format === "rgba32f" && data instanceof Float32Array)
-        return data;
-    if (format === "rgba8" && (data instanceof Uint8Array || data instanceof Uint8ClampedArray))
-        return data;
-    throw new RenderDeviceError("Texture pixel data type does not match texture format", "UNSUPPORTED_TEXTURE_FORMAT", { format });
+/** Next animation frame when available (browser), else a macrotask. */
+function scheduleParallelCompilePoll(poll) {
+    const raf = globalThis.requestAnimationFrame;
+    if (typeof raf === "function")
+        raf(poll);
+    else
+        setTimeout(poll, 0);
 }
 //# sourceMappingURL=WebGL2Device.js.map