@aura3d/rendering 3.0.1 → 4.0.2

package/dist/webgl2/ContextLifecycle.js

@@ -0,0 +1,189 @@
+// PR 0b-2 carve-out (CONTRACTS.md §3.3) — verbatim move from WebGL2Device.ts; 0 changed logic lines.
+import { RenderDeviceError } from "../RenderDevice.js";
+export class WebGL2ContextLifecycle {
+    host;
+    canvas;
+    constructor(host, canvas) {
+        this.host = host;
+        this.canvas = canvas;
+        if ("addEventListener" in canvas) {
+            this.contextLostListener = ((event) => {
+                event.preventDefault();
+                this.host.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.host.contextLost = false;
+                this.lastError = null;
+                // PRD 11 Phase 5: registered restore hooks (GPU object invalidation,
+                // C-29 ResourceRegistry.rebuild, C-02 precompile) must resolve BEFORE
+                // onDeviceRestored listeners fire (C-29 semantics). With no hooks the
+                // notification stays synchronous and byte-identical to the carve-out.
+                const hooks = [...this.restoredHooks];
+                if (hooks.length === 0) {
+                    this.notifyRestoredListeners();
+                    return;
+                }
+                const notify = () => this.notifyRestoredListeners();
+                void (async () => {
+                    for (const hook of hooks) {
+                        try {
+                            await hook();
+                        }
+                        catch {
+                            // A failed hook must not starve the restore notification; the
+                            // resource owners report their own failures via rebuild stats.
+                        }
+                    }
+                })().then(notify, notify);
+            });
+            canvas.addEventListener("webglcontextlost", this.contextLostListener);
+            canvas.addEventListener("webglcontextrestored", this.contextRestoredListener);
+        }
+    }
+    contextLostListener;
+    contextRestoredListener;
+    deviceLostListeners = new Set();
+    deviceRestoredListeners = new Set();
+    /** Phase 5: hooks resolved before `deviceRestoredListeners` notify (§6.9). */
+    restoredHooks = new Set();
+    frameActive = false;
+    lastError = null;
+    viewportHeight = 0;
+    viewportWidth = 0;
+    onDeviceLost(listener) {
+        this.deviceLostListeners.add(listener);
+        return () => this.deviceLostListeners.delete(listener);
+    }
+    onDeviceRestored(listener) {
+        this.deviceRestoredListeners.add(listener);
+        return () => this.deviceRestoredListeners.delete(listener);
+    }
+    /** Register a restore hook; it must resolve before restored listeners fire. */
+    onRestoredHook(hook) {
+        this.restoredHooks.add(hook);
+        return () => this.restoredHooks.delete(hook);
+    }
+    notifyRestoredListeners() {
+        for (const listener of [...this.deviceRestoredListeners]) {
+            try {
+                listener();
+            }
+            catch {
+                // A listener that throws is the listener's problem; the device stays consistent.
+            }
+        }
+    }
+    isDeviceLost() {
+        return this.host.contextLost;
+    }
+    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.host.counters.drawCalls = 0;
+        this.host.counters.nativeEnvironmentBindings = 0;
+        this.host.counters.nativeShadowMapBindings = 0;
+        this.host.samplers.activeTextureUnitIndex = -1;
+        this.host.samplers.textureUnitBindings.clear();
+        this.host.stateCache.invalidate();
+        this.viewportWidth = width;
+        this.viewportHeight = height;
+        this.host.stateCache.bindFramebuffer(this.host.gl.FRAMEBUFFER, this.host.activeRenderTarget?.framebuffer ?? null, () => this.host.gl.bindFramebuffer(this.host.gl.FRAMEBUFFER, this.host.activeRenderTarget?.framebuffer ?? null));
+        this.host.stateCache.viewport(0, 0, width, height, () => this.host.gl.viewport(0, 0, width, height));
+        this.host.stateCache.setEnabled(this.host.gl.DEPTH_TEST, true, () => this.host.gl.enable(this.host.gl.DEPTH_TEST));
+        this.host.stateCache.depthFunc(this.host.gl.LEQUAL, () => this.host.gl.depthFunc(this.host.gl.LEQUAL));
+    }
+    clear(color) {
+        this.assertFrame();
+        this.host.gl.clearColor(color[0], color[1], color[2], color[3]);
+        this.host.stateCache.depthMask(true, () => this.host.gl.depthMask(true));
+        this.host.gl.clearDepth(1);
+        this.host.gl.clear(this.host.gl.COLOR_BUFFER_BIT | this.host.gl.DEPTH_BUFFER_BIT);
+        if (this.host.activeRenderTarget?.sampleCount && this.host.activeRenderTarget.sampleCount > 1)
+            this.host.activeRenderTarget.needsResolve = true;
+    }
+    clearRenderTarget(color, attachment) {
+        this.assertFrame();
+        if (attachment !== undefined) {
+            // MRT (lane 03 Q-01-2): clear a single draw buffer, leaving depth and the
+            // other attachments untouched. Normalized and float formats both take
+            // clearBufferfv (normalized formats are floating-point clears).
+            this.host.gl.clearBufferfv(this.host.gl.COLOR, attachment, new Float32Array(color));
+            return;
+        }
+        this.host.gl.clearColor(color[0], color[1], color[2], color[3]);
+        this.host.stateCache.depthMask(true, () => this.host.gl.depthMask(true));
+        this.host.gl.clearDepth(1);
+        this.host.gl.clear(this.host.gl.COLOR_BUFFER_BIT | this.host.gl.DEPTH_BUFFER_BIT);
+        if (this.host.activeRenderTarget?.sampleCount && this.host.activeRenderTarget.sampleCount > 1)
+            this.host.activeRenderTarget.needsResolve = true;
+    }
+    endFrame() {
+        this.assertFrame();
+        this.frameActive = false;
+        this.lastError = this.readError();
+    }
+    captureTextureUnit0() {
+        const activeTexture = this.host.gl.getParameter(this.host.gl.ACTIVE_TEXTURE);
+        this.host.gl.activeTexture(this.host.gl.TEXTURE0);
+        return {
+            activeTexture,
+            texture2d: this.host.gl.getParameter(this.host.gl.TEXTURE_BINDING_2D),
+            sampler: this.host.gl.getParameter(this.host.gl.SAMPLER_BINDING)
+        };
+    }
+    restoreTextureUnit0(snapshot) {
+        this.host.gl.activeTexture(this.host.gl.TEXTURE0);
+        this.host.gl.bindTexture(this.host.gl.TEXTURE_2D, snapshot.texture2d);
+        this.host.gl.bindSampler(0, snapshot.sampler);
+        this.host.gl.activeTexture(snapshot.activeTexture);
+    }
+    captureTextureUnitBinding(unit) {
+        this.host.gl.activeTexture(this.host.gl.TEXTURE0 + unit);
+        return {
+            texture2d: this.host.gl.getParameter(this.host.gl.TEXTURE_BINDING_2D),
+            sampler: this.host.gl.getParameter(this.host.gl.SAMPLER_BINDING)
+        };
+    }
+    restoreTextureUnitBinding(unit, snapshot) {
+        this.host.gl.activeTexture(this.host.gl.TEXTURE0 + unit);
+        this.host.gl.bindTexture(this.host.gl.TEXTURE_2D, snapshot.texture2d);
+        this.host.gl.bindSampler(unit, snapshot.sampler);
+    }
+    assertAlive() {
+        if (this.host.disposed) {
+            throw new RenderDeviceError("Render device is disposed", "DISPOSED_DEVICE");
+        }
+        if (this.host.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.host.gl.getError();
+        return error === this.host.gl.NO_ERROR ? null : `0x${error.toString(16)}`;
+    }
+}
+//# sourceMappingURL=ContextLifecycle.js.map

package/dist/webgl2/ContextLifecycle.js.map

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

package/dist/webgl2/Counters.d.ts

@@ -0,0 +1,58 @@
+export declare class WebGL2Counters {
+    bufferUpdateCount: number;
+    drawCalls: number;
+    /** #180: `multiDrawElementsInstancedWEBGL` calls (each also counts one draw call). */
+    multiDrawSubmissions: number;
+    /** #180: entries folded into those multi-draw calls. */
+    multiDrawMembers: number;
+    inactiveUniformBindCount: number;
+    nativeEnvironmentBindings: number;
+    nativeInstancedSubmissions: number;
+    nativeShadowMapBindings: number;
+    nativeTemporalBindings: number;
+    nativeTemporalPasses: number;
+    programCompiles: number;
+    readbacks: number;
+    releasedTextureHandles: number;
+    samplerAnisotropyUploadCount: number;
+    samplerParameterUploadCount: number;
+    shaderProgramCreateCount: number;
+    shadowRenderTargetsAllocated: number;
+    textureBindCount: number;
+    uniformLocationLookupCount: number;
+    vertexArrayCreateCount: number;
+}
+import type { RenderDevice } from "../RenderDevice.js";
+import type { WebGL2DeviceHost } from "./DeviceHost.js";
+export declare function registerWebGL2DeviceHost(host: WebGL2DeviceHost): void;
+export declare function webgl2DeviceHost(device: RenderDevice): WebGL2DeviceHost | null;
+interface Prd11CounterState {
+    drawCalls: number;
+    bufferCreates: number;
+    textureUploads: number;
+    readbacks: number;
+    renderTargetsCreated: number;
+    programCompiles: number;
+}
+/**
+ * Wraps a device's public methods so every C-28 counter field is measured.
+ * Idempotent; the second call on the same device is a no-op. Also binds a
+ * `WeakMap`-keyed counter state so per-frame reset clears measured fields
+ * without touching `host.counters` (lane-01 counters keep their semantics).
+ */
+export declare function installPrd11DeviceCounters(device: RenderDevice): void;
+/** Live gauges are re-sampled at least once per this many `counters()` reads. */
+export declare const PRD11_LIVE_GAUGE_SAMPLE_INTERVAL = 30;
+/**
+ * T11-RESET (PRD-16 T0-35): lane-11 frame boundary. Zeroes only the lane's own
+ * per-frame counter state and snapshots the host's per-frame counters; it never
+ * calls the device's `resetFrameCounters()`, so lane-01 host `drawCalls` /
+ * `readbacks` keep their flag-off values mid-frame. No-op before install.
+ */
+export declare function beginPrd11CounterFrame(device: RenderDevice): void;
+/** Test/audit read: how many full `getDiagnostics()` walks `counters()` has taken. */
+export declare function prd11LiveGaugeSamples(device: RenderDevice): number;
+/** Test/audit read of the installed per-frame state; `null` when not installed. */
+export declare function prd11CounterState(device: RenderDevice): Prd11CounterState | null;
+export {};
+//# sourceMappingURL=Counters.d.ts.map

package/dist/webgl2/Counters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Counters.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/webgl2/Counters.ts"],"names":[],"mappings":"AAIA,qBAAa,cAAc;IACzB,iBAAiB,SAAK;IACtB,SAAS,SAAK;IACd,sFAAsF;IACtF,oBAAoB,SAAK;IACzB,wDAAwD;IACxD,gBAAgB,SAAK;IACrB,wBAAwB,SAAK;IAC7B,yBAAyB,SAAK;IAC9B,0BAA0B,SAAK;IAC/B,uBAAuB,SAAK;IAC5B,sBAAsB,SAAK;IAC3B,oBAAoB,SAAK;IACzB,eAAe,SAAK;IACpB,SAAS,SAAK;IACd,sBAAsB,SAAK;IAC3B,4BAA4B,SAAK;IACjC,2BAA2B,SAAK;IAChC,wBAAwB,SAAK;IAC7B,4BAA4B,SAAK;IACjC,gBAAgB,SAAK;IACrB,0BAA0B,SAAK;IAC/B,sBAAsB,SAAK;CAC5B;AAuBD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAWrD,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAErE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,GAAG,IAAI,CAE9E;AAED,UAAU,iBAAiB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;CACzB;AAsBD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAqHrE;AAkBD,iFAAiF;AACjF,eAAO,MAAM,gCAAgC,KAAK,CAAC;AAgBnD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAEjE;AAED,sFAAsF;AACtF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAElE;AAED,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,iBAAiB,GAAG,IAAI,CAEhF"}

package/dist/webgl2/Counters.js

@@ -0,0 +1,207 @@
+// PR 0b-2 carve-out (CONTRACTS.md §3.3) — verbatim move from WebGL2Device.ts; 0 changed logic lines.
+export class WebGL2Counters {
+    bufferUpdateCount = 0;
+    drawCalls = 0;
+    /** #180: `multiDrawElementsInstancedWEBGL` calls (each also counts one draw call). */
+    multiDrawSubmissions = 0;
+    /** #180: entries folded into those multi-draw calls. */
+    multiDrawMembers = 0;
+    inactiveUniformBindCount = 0;
+    nativeEnvironmentBindings = 0;
+    nativeInstancedSubmissions = 0;
+    nativeShadowMapBindings = 0;
+    nativeTemporalBindings = 0;
+    nativeTemporalPasses = 0;
+    programCompiles = 0;
+    readbacks = 0;
+    releasedTextureHandles = 0;
+    samplerAnisotropyUploadCount = 0;
+    samplerParameterUploadCount = 0;
+    shaderProgramCreateCount = 0;
+    shadowRenderTargetsAllocated = 0;
+    textureBindCount = 0;
+    uniformLocationLookupCount = 0;
+    vertexArrayCreateCount = 0;
+}
+/**
+ * PRD 11 Phase 0 — device → host seam. `WebGL2Device` constructs
+ * `WebGL2ReadbackProbe` with `host.device` already assigned, so the lane can
+ * recover the GL context (and counters bag) from any `RenderDevice` instance
+ * without a lane-01 edit. Inert bookkeeping only: populated even with
+ * `A3D_QR_TIERS` off, never read by the render path.
+ */
+const deviceHosts = new WeakMap();
+export function registerWebGL2DeviceHost(host) {
+    deviceHosts.set(host.device, host);
+}
+export function webgl2DeviceHost(device) {
+    return deviceHosts.get(device) ?? null;
+}
+const counterStates = new WeakMap();
+const installedDevices = new WeakSet();
+function increment(device, field, amount = 1) {
+    const state = counterStates.get(device);
+    if (state) {
+        state[field] += amount;
+    }
+}
+function wrap0(device, name, field) {
+    const owner = device;
+    const original = owner[name];
+    if (typeof original !== "function")
+        return;
+    owner[name] = function wrapped(...args) {
+        increment(device, field);
+        return original.apply(this, args);
+    };
+}
+/**
+ * Wraps a device's public methods so every C-28 counter field is measured.
+ * Idempotent; the second call on the same device is a no-op. Also binds a
+ * `WeakMap`-keyed counter state so per-frame reset clears measured fields
+ * without touching `host.counters` (lane-01 counters keep their semantics).
+ */
+export function installPrd11DeviceCounters(device) {
+    if (installedDevices.has(device)) {
+        return;
+    }
+    installedDevices.add(device);
+    const state = {
+        drawCalls: 0, bufferCreates: 0, textureUploads: 0,
+        readbacks: 0, renderTargetsCreated: 0, programCompiles: 0
+    };
+    counterStates.set(device, state);
+    wrap0(device, "createBuffer", "bufferCreates");
+    wrap0(device, "createRenderTarget", "renderTargetsCreated");
+    wrap0(device, "writeRenderTargetPixels", "textureUploads");
+    wrap0(device, "createShaderProgram", "programCompiles");
+    wrap0(device, "compileAsync", "programCompiles");
+    wrap0(device, "draw", "drawCalls");
+    wrap0(device, "drawInstanced", "drawCalls");
+    wrap0(device, "multiDrawElementsInstanced", "drawCalls");
+    wrap0(device, "readPixels", "readbacks");
+    wrap0(device, "readFloatPixels", "readbacks");
+    wrap0(device, "readDepthPixels", "readbacks");
+    wrap0(device, "readPixelsAsync", "readbacks");
+    wrap0(device, "readFloatPixelsAsync", "readbacks");
+    const originalCounters = typeof device.counters === "function" ? device.counters.bind(device) : null;
+    const originalReset = typeof device.resetFrameCounters === "function" ? device.resetFrameCounters.bind(device) : null;
+    const originalDiagnostics = typeof device.getDiagnostics === "function" ? device.getDiagnostics.bind(device) : null;
+    const host = webgl2DeviceHost(device);
+    // T11-COUNTERS (PRD-16 T0-35): per-frame fields are O(1) — WebGL2 devices read
+    // the lane-01 host counters directly instead of the native `counters()`, which
+    // runs the full `getDiagnostics()` resource walk. The live gauges (which need
+    // that walk) are sampled: refreshed after a wrapped create call or every
+    // `PRD11_LIVE_GAUGE_SAMPLE_INTERVAL` reads, so disposals show within that window.
+    const gauges = {
+        liveBuffers: 0, textureBytes: 0, renderTargetBytes: 0,
+        dirty: true, readsSinceSample: 0, samples: 0
+    };
+    gaugeStates.set(device, gauges);
+    for (const name of ["createBuffer", "createRenderTarget", "createTexture"]) {
+        wrapDirty(device, name, gauges);
+    }
+    const hostPerFrame = () => {
+        if (host) {
+            return {
+                drawCalls: host.counters.drawCalls,
+                readbacks: host.counters.readbacks,
+                programCompiles: host.counters.programCompiles
+            };
+        }
+        const base = originalCounters ? originalCounters() : null;
+        return base ? { drawCalls: base.drawCalls, readbacks: base.readbacks, programCompiles: base.programCompiles } : null;
+    };
+    frameBegins.set(device, () => {
+        state.drawCalls = 0;
+        state.bufferCreates = 0;
+        state.textureUploads = 0;
+        state.readbacks = 0;
+        state.renderTargetsCreated = 0;
+        state.programCompiles = 0;
+        baselines.set(device, hostPerFrame());
+    });
+    const sampleGauges = () => {
+        gauges.readsSinceSample += 1;
+        if (!gauges.dirty && gauges.readsSinceSample < PRD11_LIVE_GAUGE_SAMPLE_INTERVAL)
+            return;
+        const diag = originalDiagnostics
+            ? originalDiagnostics()
+            : null;
+        gauges.liveBuffers = diag?.buffers ?? 0;
+        gauges.textureBytes = diag?.textureBytes ?? 0;
+        gauges.renderTargetBytes = diag?.gpuTargetBytes ?? 0;
+        gauges.dirty = false;
+        gauges.readsSinceSample = 0;
+        gauges.samples += 1;
+    };
+    device.counters = () => {
+        const base = hostPerFrame();
+        const baseline = baselines.get(device) ?? null;
+        sampleGauges();
+        // T11-RESET: host counters are never zeroed by lane 11; the per-frame host
+        // value is the delta since the lane's frame-begin snapshot (or the raw value
+        // if lane-01 reset it in between, e.g. `beginFrame` zeroing drawCalls).
+        const hostDelta = (field) => {
+            const now = base?.[field] ?? 0;
+            const start = baseline?.[field] ?? 0;
+            return now >= start ? now - start : now;
+        };
+        // Overlapping fields are counted both at lane-01 call sites (host) and by
+        // these wrappers (state); `Math.max` merges them without double-counting.
+        const merged = (field) => Math.max(state[field], hostDelta(field));
+        return {
+            drawCalls: merged("drawCalls"),
+            bufferCreates: state.bufferCreates,
+            textureUploads: state.textureUploads,
+            readbacks: merged("readbacks"),
+            renderTargetsCreated: state.renderTargetsCreated,
+            programCompiles: merged("programCompiles"),
+            liveBuffers: gauges.liveBuffers,
+            // Measured by lane-01 code today (draw-binder VAO cache); 0 when a device
+            // has no host. C-28 types this `number`, so a null "unmeasured" sentinel
+            // is not available here.
+            liveVertexArrays: host ? host.drawBinder.vertexArrayCache.size : 0,
+            textureBytes: gauges.textureBytes,
+            renderTargetBytes: gauges.renderTargetBytes
+        };
+    };
+    device.resetFrameCounters = () => {
+        originalReset?.();
+        frameBegins.get(device)();
+        baselines.set(device, null);
+    };
+}
+/** Live gauges are re-sampled at least once per this many `counters()` reads. */
+export const PRD11_LIVE_GAUGE_SAMPLE_INTERVAL = 30;
+const gaugeStates = new WeakMap();
+const baselines = new WeakMap();
+const frameBegins = new WeakMap();
+function wrapDirty(device, name, gauges) {
+    const owner = device;
+    const original = owner[name];
+    if (typeof original !== "function")
+        return;
+    owner[name] = function wrapped(...args) {
+        gauges.dirty = true;
+        return original.apply(this, args);
+    };
+}
+/**
+ * T11-RESET (PRD-16 T0-35): lane-11 frame boundary. Zeroes only the lane's own
+ * per-frame counter state and snapshots the host's per-frame counters; it never
+ * calls the device's `resetFrameCounters()`, so lane-01 host `drawCalls` /
+ * `readbacks` keep their flag-off values mid-frame. No-op before install.
+ */
+export function beginPrd11CounterFrame(device) {
+    frameBegins.get(device)?.();
+}
+/** Test/audit read: how many full `getDiagnostics()` walks `counters()` has taken. */
+export function prd11LiveGaugeSamples(device) {
+    return gaugeStates.get(device)?.samples ?? 0;
+}
+/** Test/audit read of the installed per-frame state; `null` when not installed. */
+export function prd11CounterState(device) {
+    return counterStates.get(device) ?? null;
+}
+//# sourceMappingURL=Counters.js.map

package/dist/webgl2/Counters.js.map

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

package/dist/webgl2/DeviceHost.d.ts

@@ -0,0 +1,41 @@
+import type { WebGL2StateCache } from "../WebGL2StateCache.js";
+import type { WebGL2Device } from "../WebGL2Device.js";
+import type { TextureFilterAnisotropicExtension, WebGL2Buffer, WebGL2ErrorCheckMode, WebGL2RenderTarget, WebGL2ShaderProgram } from "../WebGL2Device.js";
+import type { WebGL2Counters } from "./Counters.js";
+import type { WebGL2ContextLifecycle } from "./ContextLifecycle.js";
+import type { WebGL2TextureRegistry } from "./TextureUpload.js";
+import type { WebGL2SamplerRegistry } from "./Samplers.js";
+import type { WebGL2DrawCallBinder } from "./MultiDraw.js";
+import type { WebGL2ReadbackProbe } from "./Probe.js";
+import type { WebGL2LegacyPostPipeline } from "./LegacyPost.js";
+/**
+ * The shared seam bag: everything extracted subsystem code used to reach via
+ * `this.` on WebGL2Device. Constructed once in the device constructor; the
+ * subsystems are attached after the bag fields exist, so cross-subsystem refs
+ * (host.samplers, host.post, ...) resolve lazily at call time.
+ */
+export interface WebGL2DeviceHost {
+    gl: WebGL2RenderingContext;
+    readonly stateCache: WebGL2StateCache;
+    readonly counters: WebGL2Counters;
+    readonly buffers: Set<WebGL2Buffer>;
+    readonly shaders: Set<WebGL2ShaderProgram>;
+    readonly renderTargets: Set<WebGL2RenderTarget>;
+    activeRenderTarget: WebGL2RenderTarget | null;
+    disposed: boolean;
+    contextLost: boolean;
+    readonly errorCheckMode: WebGL2ErrorCheckMode;
+    readonly anisotropicFilteringExtension: TextureFilterAnisotropicExtension | null;
+    readonly maxTextureAnisotropy: number;
+    readonly maxVertexAttributes: number;
+    lifecycle: WebGL2ContextLifecycle;
+    textureRegistry: WebGL2TextureRegistry;
+    samplers: WebGL2SamplerRegistry;
+    drawBinder: WebGL2DrawCallBinder;
+    probe: WebGL2ReadbackProbe;
+    post: WebGL2LegacyPostPipeline;
+    readonly resolveMultisampleTarget: (target: WebGL2RenderTarget) => void;
+    readonly device: WebGL2Device;
+    readonly textureBudgetPolicy?: import("../textures/TextureBudget.js").TextureBudgetPolicy;
+}
+//# sourceMappingURL=DeviceHost.d.ts.map

package/dist/webgl2/DeviceHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceHost.d.ts","sourceRoot":"","sources":["../../../../../packages/rendering/src/webgl2/DeviceHost.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,iCAAiC,EAAE,YAAY,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtJ,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,sBAAsB,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAChD,kBAAkB,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,cAAc,EAAE,oBAAoB,CAAC;IAC9C,QAAQ,CAAC,6BAA6B,EAAE,iCAAiC,GAAG,IAAI,CAAC;IACjF,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,SAAS,EAAE,sBAAsB,CAAC;IAClC,eAAe,EAAE,qBAAqB,CAAC;IACvC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,UAAU,EAAE,oBAAoB,CAAC;IACjC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,IAAI,EAAE,wBAAwB,CAAC;IAC/B,QAAQ,CAAC,wBAAwB,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACxE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,2BAA2B,EAAE,mBAAmB,CAAC;CACxF"}

package/dist/webgl2/DeviceHost.js

@@ -0,0 +1,3 @@
+// PR 0b-2 carve-out (CONTRACTS.md §3.3) — verbatim move from WebGL2Device.ts; 0 changed logic lines.
+export {};
+//# sourceMappingURL=DeviceHost.js.map

package/dist/webgl2/DeviceHost.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeviceHost.js","sourceRoot":"","sources":["../../../../../packages/rendering/src/webgl2/DeviceHost.ts"],"names":[],"mappings":"AAAA,qGAAqG"}