@codexo/exojs 0.13.0 → 0.15.0

package/dist/esm/rendering/CallbackRenderPass.d.ts

@@ -1,29 +1,31 @@
 import type { Color } from '#core/Color';
 import type { RenderTexture } from '#rendering/texture/RenderTexture';
+import { PassContext } from './PassContext';
 import type { RenderingContext } from './RenderingContext';
 import { RenderPass, type RenderPassOptions } from './RenderPass';
 import type { View } from './View';
 /** Options for {@link CallbackRenderPass}. @advanced */
 export interface CallbackRenderPassOptions extends RenderPassOptions {
-    /** View applied while the callback runs. Only meaningful with `target`. Default: `target.view`. */
+    /** View applied while the callback runs. Default: `target.view` (with `target`) else the active view. */
     readonly view?: View;
     /**
-     * Off-screen destination. When set, the callback runs redirected into this {@link RenderTexture} (save / restore).
-     * `null` / omitted → the active target. Inside a target redirect, draw via `context.backend` (the active view is
-     * the target's); `context.render(node)` would reset the view to `context.camera`. Caller-owned and stable; never
-     * allocated, pooled, resized, or destroyed by the pass.
+     * Off-screen destination. When set, the callback runs redirected into this {@link RenderTexture} (save / restore);
+     * `null` / omitted → the active target. The callback's {@link PassContext} is scoped to whichever target is
+     * active, so `pass.clear()` / `pass.render()` act on it and never leak. Caller-owned and stable; never allocated,
+     * pooled, resized, or destroyed by the pass.
      */
     readonly target?: RenderTexture | null;
     /** Clear the destination to this colour immediately before the callback runs. */
     readonly clear?: Color;
 }
 /**
- * Runs a user callback as one pass. The callback receives the {@link RenderingContext} (high-level:
- * `context.render(node)`, `context.backend` immediate draws, etc.). Set `options.target` to redirect the callback's
- * output into an off-screen {@link RenderTexture} (immediate-mode "scene" → texture).
+ * Runs a user callback as one pass. The callback receives a {@link PassContext} scoped to the active target:
+ * `pass.render(node)`, `pass.clear(color)`, `pass.drawGeometry(...)`, `pass.renderTo(...)`, and `pass.backend` for
+ * raw draws. Set `options.target` to redirect the callback's output into an off-screen {@link RenderTexture}
+ * (immediate-mode "scene" → texture); inside that redirect every `pass.*` verb operates on the texture.
  *
  * To run a low-level {@link BackendRenderPass} inside a pipeline, bridge it here:
- * `new CallbackRenderPass((context) => context.backend.execute(myBackendPass))`.
+ * `new CallbackRenderPass((pass) => pass.backend.execute(myBackendPass))`.
  *
  * `view`/`target`/`clear` are fixed at construction; the off-screen redirect is built once and reused every frame
  * (no per-frame allocation). `execute` is not re-entrant — a callback must not re-run the same pass instance; the
@@ -34,10 +36,12 @@ export interface CallbackRenderPassOptions extends RenderPassOptions {
 export declare class CallbackRenderPass extends RenderPass {
     private readonly _callback;
     private readonly _clear;
+    private readonly _target;
+    private readonly _view;
     private readonly _redirect;
     private _activeContext;
     private _executing;
-    constructor(callback: (context: RenderingContext) => void, options?: CallbackRenderPassOptions);
+    constructor(callback: (pass: PassContext) => void, options?: CallbackRenderPassOptions);
     execute(context: RenderingContext): void;
     private _runCallback;
 }

package/dist/esm/rendering/CallbackRenderPass.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CallbackRenderPass.d.ts","sourceRoot":"","sources":["../../../src/rendering/CallbackRenderPass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC,wDAAwD;AACxD,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAClE,mGAAmG;IACnG,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IACrB;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACvC,iFAAiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;IAChE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;IACrD,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,UAAU,CAAS;gBAER,QAAQ,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,yBAAyB;IAkBrF,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAgCxD,OAAO,CAAC,YAAY;CAKrB"}
+{"version":3,"file":"CallbackRenderPass.d.ts","sourceRoot":"","sources":["../../../src/rendering/CallbackRenderPass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAGtE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC,wDAAwD;AACxD,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAClE,yGAAyG;IACzG,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC;IACrB;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACvC,iFAAiF;IACjF,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,kBAAmB,SAAQ,UAAU;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA8B;IACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuB;IAC/C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA2B;IACrD,OAAO,CAAC,cAAc,CAAiC;IACvD,OAAO,CAAC,UAAU,CAAS;gBAER,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,EAAE,OAAO,CAAC,EAAE,yBAAyB;IAkB7E,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAgCxD,OAAO,CAAC,YAAY;CAKrB"}

package/dist/esm/rendering/CallbackRenderPass.js

@@ -1,13 +1,15 @@
 import { BackendTargetPass } from './BackendTargetPass.js';
+import { PassContext } from './PassContext.js';
 import { RenderPass } from './RenderPass.js';
 
 /**
- * Runs a user callback as one pass. The callback receives the {@link RenderingContext} (high-level:
- * `context.render(node)`, `context.backend` immediate draws, etc.). Set `options.target` to redirect the callback's
- * output into an off-screen {@link RenderTexture} (immediate-mode "scene" → texture).
+ * Runs a user callback as one pass. The callback receives a {@link PassContext} scoped to the active target:
+ * `pass.render(node)`, `pass.clear(color)`, `pass.drawGeometry(...)`, `pass.renderTo(...)`, and `pass.backend` for
+ * raw draws. Set `options.target` to redirect the callback's output into an off-screen {@link RenderTexture}
+ * (immediate-mode "scene" → texture); inside that redirect every `pass.*` verb operates on the texture.
  *
  * To run a low-level {@link BackendRenderPass} inside a pipeline, bridge it here:
- * `new CallbackRenderPass((context) => context.backend.execute(myBackendPass))`.
+ * `new CallbackRenderPass((pass) => pass.backend.execute(myBackendPass))`.
  *
  * `view`/`target`/`clear` are fixed at construction; the off-screen redirect is built once and reused every frame
  * (no per-frame allocation). `execute` is not re-entrant — a callback must not re-run the same pass instance; the
@@ -18,6 +20,8 @@ import { RenderPass } from './RenderPass.js';
 class CallbackRenderPass extends RenderPass {
     _callback;
     _clear;
+    _target;
+    _view;
     _redirect;
     _activeContext = null;
     _executing = false;
@@ -25,13 +29,14 @@ class CallbackRenderPass extends RenderPass {
         super(options);
         this._callback = callback;
         this._clear = options?.clear ?? null;
-        const target = options?.target ?? null;
+        this._target = options?.target ?? null;
+        this._view = options?.view ?? null;
         this._redirect =
-            target !== null
+            this._target !== null
                 ? new BackendTargetPass(() => this._runCallback(), {
-                    target,
-                    view: options?.view ?? target.view,
-                    clearColor: this._clear ?? undefined,
+                    target: this._target,
+                    view: this._view ?? this._target.view,
+                    ...(this._clear !== null && { clearColor: this._clear }),
                 })
                 : null;
     }
@@ -56,15 +61,15 @@ class CallbackRenderPass extends RenderPass {
             if (this._clear !== null) {
                 context.backend.clear(this._clear);
             }
-            this._callback(context);
+            this._callback(new PassContext(context, context.backend.renderTarget, context.backend.view));
         }
         finally {
             this._executing = false;
         }
     }
     _runCallback() {
-        if (this._activeContext !== null) {
-            this._callback(this._activeContext);
+        if (this._activeContext !== null && this._target !== null) {
+            this._callback(new PassContext(this._activeContext, this._target, this._view ?? this._target.view));
         }
     }
 }

package/dist/esm/rendering/CallbackRenderPass.js.map

@@ -1 +1 @@
-{"version":3,"file":"CallbackRenderPass.js","sources":["../../../../src/rendering/CallbackRenderPass.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAuBA;;;;;;;;;;;;;AAaG;AACG,MAAO,kBAAmB,SAAQ,UAAU,CAAA;AAC/B,IAAA,SAAS;AACT,IAAA,MAAM;AACN,IAAA,SAAS;IAClB,cAAc,GAA4B,IAAI;IAC9C,UAAU,GAAG,KAAK;IAE1B,WAAA,CAAmB,QAA6C,EAAE,OAAmC,EAAA;QACnG,KAAK,CAAC,OAAO,CAAC;AAEd,QAAA,IAAI,CAAC,SAAS,GAAG,QAAQ;QACzB,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,KAAK,IAAI,IAAI;AAEpC,QAAA,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,IAAI,IAAI;AAEtC,QAAA,IAAI,CAAC,SAAS;AACZ,YAAA,MAAM,KAAK;kBACP,IAAI,iBAAiB,CAAC,MAAM,IAAI,CAAC,YAAY,EAAE,EAAE;oBAC/C,MAAM;AACN,oBAAA,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI;AAClC,oBAAA,UAAU,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS;iBACrC;kBACD,IAAI;IACZ;AAEgB,IAAA,OAAO,CAAC,OAAyB,EAAA;AAC/C,QAAA,IAAI,IAAI,CAAC,UAAU,EAAE;AACnB,YAAA,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC;QAClE;AAEA,QAAA,IAAI,CAAC,UAAU,GAAG,IAAI;AAEtB,QAAA,IAAI;AACF,YAAA,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE;;;AAG3B,gBAAA,IAAI,CAAC,cAAc,GAAG,OAAO;AAE7B,gBAAA,IAAI;oBACF,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;gBACzC;wBAAU;AACR,oBAAA,IAAI,CAAC,cAAc,GAAG,IAAI;gBAC5B;gBAEA;YACF;AAEA,YAAA,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE;gBACxB,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;YACpC;AAEA,YAAA,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;QACzB;gBAAU;AACR,YAAA,IAAI,CAAC,UAAU,GAAG,KAAK;QACzB;IACF;IAEQ,YAAY,GAAA;AAClB,QAAA,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI,EAAE;AAChC,YAAA,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC;QACrC;IACF;AACD;;;;"}
+{"version":3,"file":"CallbackRenderPass.js","sources":["../../../../src/rendering/CallbackRenderPass.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAwBA;;;;;;;;;;;;;;AAcG;AACG,MAAO,kBAAmB,SAAQ,UAAU,CAAA;AAC/B,IAAA,SAAS;AACT,IAAA,MAAM;AACN,IAAA,OAAO;AACP,IAAA,KAAK;AACL,IAAA,SAAS;IAClB,cAAc,GAA4B,IAAI;IAC9C,UAAU,GAAG,KAAK;IAE1B,WAAA,CAAmB,QAAqC,EAAE,OAAmC,EAAA;QAC3F,KAAK,CAAC,OAAO,CAAC;AAEd,QAAA,IAAI,CAAC,SAAS,GAAG,QAAQ;QACzB,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,KAAK,IAAI,IAAI;QACpC,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,MAAM,IAAI,IAAI;QACtC,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,IAAI,IAAI,IAAI;AAElC,QAAA,IAAI,CAAC,SAAS;YACZ,IAAI,CAAC,OAAO,KAAK;kBACb,IAAI,iBAAiB,CAAC,MAAM,IAAI,CAAC,YAAY,EAAE,EAAE;oBAC/C,MAAM,EAAE,IAAI,CAAC,OAAO;oBACpB,IAAI,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI;AACrC,oBAAA,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;iBACzD;kBACD,IAAI;IACZ;AAEgB,IAAA,OAAO,CAAC,OAAyB,EAAA;AAC/C,QAAA,IAAI,IAAI,CAAC,UAAU,EAAE;AACnB,YAAA,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC;QAClE;AAEA,QAAA,IAAI,CAAC,UAAU,GAAG,IAAI;AAEtB,QAAA,IAAI;AACF,YAAA,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE;;;AAG3B,gBAAA,IAAI,CAAC,cAAc,GAAG,OAAO;AAE7B,gBAAA,IAAI;oBACF,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;gBACzC;wBAAU;AACR,oBAAA,IAAI,CAAC,cAAc,GAAG,IAAI;gBAC5B;gBAEA;YACF;AAEA,YAAA,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE;gBACxB,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;YACpC;YAEA,IAAI,CAAC,SAAS,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9F;gBAAU;AACR,YAAA,IAAI,CAAC,UAAU,GAAG,KAAK;QACzB;IACF;IAEQ,YAAY,GAAA;AAClB,QAAA,IAAI,IAAI,CAAC,cAAc,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE;YACzD,IAAI,CAAC,SAAS,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrG;IACF;AACD;;;;"}

package/dist/esm/rendering/Container.d.ts

@@ -1,3 +1,4 @@
+import type { Stage } from '#core/Stage';
 import type { RenderPlanBuilder } from '#rendering/plan/RenderPlanBuilder';
 import { RenderNode } from './RenderNode';
 /**
@@ -52,6 +53,8 @@ export declare class Container extends RenderNode {
      * the entire child list. Throws if the range is invalid.
      */
     removeChildren(begin?: number, end?: number): this;
+    /** @internal — propagate the owning stage down the whole subtree. */
+    _setStage(stage: Stage | null): void;
     /** @internal */
     protected _collectContent(builder: RenderPlanBuilder): void;
     contains(x: number, y: number): boolean;

package/dist/esm/rendering/Container.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Container.d.ts","sourceRoot":"","sources":["../../../src/rendering/Container.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,SAAU,SAAQ,UAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAE9C,IAAW,QAAQ,IAAI,UAAU,EAAE,CAElC;IAED,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAE7B;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,MAAM,CAAC,KAAK,EAAE,MAAM,EAE9B;IAED,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,GAAG,IAAI,MAAM,CAEvB;IAED,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED;;;OAGG;IACI,QAAQ,CAAC,GAAG,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI;IAQhD;;;;OAIG;IACI,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAyBlD,YAAY,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,GAAG,IAAI;IAanE,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;IAUxC,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAarD,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAQ5C,gEAAgE;IACzD,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAUpC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAkBzC;;;OAGG;IACI,cAAc,CAAC,KAAK,SAAI,EAAE,GAAG,GAAE,MAA8B,GAAG,IAAI;IA4B3E,gBAAgB;cACG,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAUpD,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;cAIpC,4BAA4B,IAAI,IAAI;IAMvC,YAAY,IAAI,IAAI;IAYpB,OAAO,IAAI,IAAI;CAKhC"}
+{"version":3,"file":"Container.d.ts","sourceRoot":"","sources":["../../../src/rendering/Container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,SAAU,SAAQ,UAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAE9C,IAAW,QAAQ,IAAI,UAAU,EAAE,CAElC;IAED,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAE7B;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,MAAM,CAAC,KAAK,EAAE,MAAM,EAE9B;IAED,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,GAAG,IAAI,MAAM,CAEvB;IAED,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED;;;OAGG;IACI,QAAQ,CAAC,GAAG,QAAQ,EAAE,UAAU,EAAE,GAAG,IAAI;IAQhD;;;;OAIG;IACI,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IA0BlD,YAAY,CAAC,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,GAAG,IAAI;IAanE,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;IAUxC,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAarD,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU;IAS5C,gEAAgE;IACzD,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAUpC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAoBzC;;;OAGG;IACI,cAAc,CAAC,KAAK,SAAI,EAAE,GAAG,GAAE,MAA8B,GAAG,IAAI;IA8B3E,qEAAqE;IACrD,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI;IAYpD,gBAAgB;cACG,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAWpD,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;cAapC,4BAA4B,IAAI,IAAI;IAMvC,YAAY,IAAI,IAAI;IAYpB,OAAO,IAAI,IAAI;CAKhC"}

package/dist/esm/rendering/Container.js

@@ -1,5 +1,4 @@
 import { removeArrayItems } from '../core/utils.js';
-import { getActiveInteractionManager } from '../input/internal/interactionManagerRegistry.js';
 import { RenderNode } from './RenderNode.js';
 
 /**
@@ -79,7 +78,8 @@ class Container extends RenderNode {
         this.invalidateCache();
         child._invalidateSubtreeTransform();
         this._invalidateBoundsCascade();
-        getActiveInteractionManager()?._notifyNodeAdded(child);
+        child._setStage(this._stage);
+        this._stage?.interaction._notifyNodeAdded(child);
         return this;
     }
     swapChildren(firstChild, secondChild) {
@@ -112,6 +112,7 @@ class Container extends RenderNode {
         if (index < 0 || index >= this._children.length) {
             throw new Error(`getChildAt: Index (${index}) does not exist.`);
         }
+        // Bounds-checked above.
         return this._children[index];
     }
     /** Remove `child` from this container. No-op if not present. */
@@ -130,7 +131,9 @@ class Container extends RenderNode {
             this._invalidateBoundsCascade();
             child.parent = null;
             child._invalidateSubtreeTransform();
-            getActiveInteractionManager()?._notifyNodeRemoved(child);
+            this._stage?.interaction._notifyNodeRemoved(child);
+            this._stage?.focus._notifyNodeRemoved(child);
+            child._setStage(null);
         }
         this.invalidateCache();
         return this;
@@ -153,24 +156,44 @@ class Container extends RenderNode {
             if (child?.parent === this) {
                 child.parent = null;
                 child._invalidateSubtreeTransform();
-                getActiveInteractionManager()?._notifyNodeRemoved(child);
+                this._stage?.interaction._notifyNodeRemoved(child);
+                this._stage?.focus._notifyNodeRemoved(child);
+                child._setStage(null);
             }
         }
         removeArrayItems(this._children, begin, range);
         this.invalidateCache();
         return this;
     }
+    /** @internal — propagate the owning stage down the whole subtree. */
+    _setStage(stage) {
+        if (this._stage === stage) {
+            return;
+        }
+        this._stage = stage;
+        for (const child of this._children) {
+            child._setStage(stage);
+        }
+    }
     /** @internal */
     _collectContent(builder) {
         if (this._children.length === 0) {
             return;
         }
         for (let index = 0; index < this._children.length; index++) {
+            // In-bounds: index < length.
             this._children[index]._collect(builder, index);
         }
     }
     contains(x, y) {
-        return this._children.some(child => child.contains(x, y));
+        const children = this._children;
+        for (let i = 0; i < children.length; i++) {
+            // In-bounds: i < length.
+            if (children[i].contains(x, y)) {
+                return true;
+            }
+        }
+        return false;
     }
     _invalidateChildrenTransform() {
         for (const child of this._children) {

package/dist/esm/rendering/Container.js.map

@@ -1 +1 @@
-{"version":3,"file":"Container.js","sources":["../../../../src/rendering/Container.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}
+{"version":3,"file":"Container.js","sources":["../../../../src/rendering/Container.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/rendering/DrawContext.d.ts

@@ -0,0 +1,48 @@
+import type { Color } from '#core/Color';
+import type { Matrix } from '#math/Matrix';
+import type { Geometry } from '#rendering/geometry/Geometry';
+import type { RenderTexture } from '#rendering/texture/RenderTexture';
+import type { RenderBackend } from './RenderBackend';
+import type { RenderBatch } from './RenderBatch';
+import type { DrawBatchOptions, DrawGeometryOptions, RenderOptions } from './RenderingContext';
+import type { RenderNode } from './RenderNode';
+import type { View } from './View';
+/**
+ * Caller-owned, per-frame off-screen render target. Unlike
+ * {@link RenderingContext.capture}, the {@link RenderTexture} is supplied by the
+ * caller and reused across frames (no per-call allocation).
+ */
+export interface RenderToOptions {
+    /** Destination texture, owned and kept stable by the caller. */
+    target: RenderTexture;
+    /** View to render with. Defaults to the target's own view. */
+    view?: View;
+    /** Clear the target to this colour before rendering; omitted preserves its contents. */
+    clear?: Color;
+}
+/**
+ * The shared rendering verbs that act on the active render target. Implemented
+ * by the frame-level {@link RenderingContext} (active target = the canvas by
+ * default) and the pass-scoped `PassContext` (active target = the pass target).
+ *
+ * Every verb operates on the *active* target and never resets the active view,
+ * so it is safe inside a pass redirect. Use {@link backend} only for raw draws
+ * or GPU state — never to switch target/view/clear, which would bypass the
+ * coordinator's clear-vs-load handling.
+ * @stable
+ */
+export interface DrawContext {
+    /** Render `node` into the active target with `options.view` (default: the active view). */
+    render(node: RenderNode, options?: RenderOptions): void;
+    /** Render `node` into a caller-owned off-screen target (nested when called inside a pass). */
+    renderTo(node: RenderNode, options: RenderToOptions): void;
+    /** Clear the active target to `color` (coordinator-routed; no leak). */
+    clear(color: Color): void;
+    /** Immediately draw a single geometry with `transform` as its world matrix. */
+    drawGeometry(geometry: Geometry, transform: Matrix, options?: DrawGeometryOptions): void;
+    /** Immediately draw an instanced batch. */
+    drawBatch(batch: RenderBatch, options?: DrawBatchOptions): void;
+    /** @advanced Raw backend — draws/state only; do NOT switch target/view/clear here. */
+    readonly backend: RenderBackend;
+}
+//# sourceMappingURL=DrawContext.d.ts.map

package/dist/esm/rendering/DrawContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DrawContext.d.ts","sourceRoot":"","sources":["../../../src/rendering/DrawContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC/F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,MAAM,EAAE,aAAa,CAAC;IACtB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,wFAAwF;IACxF,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,WAAW;IAC1B,2FAA2F;IAC3F,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;IACxD,8FAA8F;IAC9F,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI,CAAC;IAC3D,wEAAwE;IACxE,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC1B,+EAA+E;IAC/E,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACzF,2CAA2C;IAC3C,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAChE,sFAAsF;IACtF,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;CACjC"}

package/dist/esm/rendering/Drawable.d.ts

@@ -1,5 +1,7 @@
 import { Color } from '#core/Color';
+import { type MaterialKey } from '#rendering/plan/RenderCommand';
 import type { RenderPlanBuilder } from '#rendering/plan/RenderPlanBuilder';
+import type { RenderBackend } from '#rendering/RenderBackend';
 import { type PixelSnapMode } from './pixelSnap';
 import { RenderNode } from './RenderNode';
 import { BlendModes } from './types';
@@ -14,6 +16,15 @@ export declare class Drawable extends RenderNode {
     private _tint;
     private _blendMode;
     private _pixelSnapMode;
+    /**
+     * Cached material key (Slice 2b). `null` until first computed or after
+     * {@link invalidateCache}. Bound to {@link _materialKeyBackend} so a backend
+     * switch (multi-app / multi-backend) recomputes rather than returning stale
+     * renderer ids. Drawables that carry their own {@link Material} bypass this
+     * cache entirely (the material can mutate its keys without notifying us).
+     */
+    private _materialKey;
+    private _materialKeyBackend;
     get tint(): Color;
     set tint(tint: Color);
     get blendMode(): BlendModes;
@@ -55,6 +66,19 @@ export declare class Drawable extends RenderNode {
     _isDrawableForRenderPlan(): boolean;
     /** @internal */
     _renderPlanGetBlendMode(): BlendModes;
+    /**
+     * Resolve this drawable's {@link MaterialKey}, reusing a cached key when valid
+     * (Slice 2b). The cache busts on any tint/blend/texture/material/shader/
+     * pixel-snap mutation via {@link invalidateCache}, and on a backend switch.
+     *
+     * Drawables that own a {@link Material} are never cached — the material can
+     * change its `pipelineKey`/`bindKey` internally without notifying the node —
+     * so they recompute into the held key (still zero per-frame allocation).
+     *
+     * @internal
+     */
+    _getOrComputeMaterialKey(backend: RenderBackend): MaterialKey;
+    invalidateCache(): this;
     destroy(): void;
 }
 //# sourceMappingURL=Drawable.d.ts.map

package/dist/esm/rendering/Drawable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Drawable.d.ts","sourceRoot":"","sources":["../../../src/rendering/Drawable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC;;;;;;GAMG;AACH,qBAAa,QAAS,SAAQ,UAAU;IACtC,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,cAAc,CAAyB;IAE/C,IAAW,IAAI,IAAI,KAAK,CAEvB;IAED,IAAW,IAAI,CAAC,IAAI,EAAE,KAAK,EAE1B;IAED,IAAW,SAAS,IAAI,UAAU,CAEjC;IAED,IAAW,SAAS,CAAC,SAAS,EAAE,UAAU,EAEzC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,IAAW,aAAa,IAAI,aAAa,CAExC;IAED,IAAW,aAAa,CAAC,IAAI,EAAE,aAAa,EAW3C;IAED;;;OAGG;IACI,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IASlC;;;OAGG;IACI,YAAY,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI;IAShD,gBAAgB;cACG,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAIpE,gBAAgB;IACA,wBAAwB,IAAI,OAAO;IAInD,gBAAgB;IACA,uBAAuB,IAAI,UAAU;IAIrC,OAAO,IAAI,IAAI;CAKhC"}
+{"version":3,"file":"Drawable.d.ts","sourceRoot":"","sources":["../../../src/rendering/Drawable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAA0B,KAAK,WAAW,EAAwB,MAAM,+BAA+B,CAAC;AAC/G,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAmB,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC;;;;;;GAMG;AACH,qBAAa,QAAS,SAAQ,UAAU;IACtC,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,cAAc,CAAyB;IAE/C;;;;;;OAMG;IACH,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,mBAAmB,CAA8B;IAEzD,IAAW,IAAI,IAAI,KAAK,CAEvB;IAED,IAAW,IAAI,CAAC,IAAI,EAAE,KAAK,EAE1B;IAED,IAAW,SAAS,IAAI,UAAU,CAEjC;IAED,IAAW,SAAS,CAAC,SAAS,EAAE,UAAU,EAEzC;IAED;;;;;;;;;;;;;;;;;;OAkBG;IACH,IAAW,aAAa,IAAI,aAAa,CAExC;IAED,IAAW,aAAa,CAAC,IAAI,EAAE,aAAa,EAW3C;IAED;;;OAGG;IACI,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IASlC;;;OAGG;IACI,YAAY,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI;IAShD,gBAAgB;cACG,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAIpE,gBAAgB;IACA,wBAAwB,IAAI,OAAO;IAInD,gBAAgB;IACA,uBAAuB,IAAI,UAAU;IAIrD;;;;;;;;;;OAUG;IACI,wBAAwB,CAAC,OAAO,EAAE,aAAa,GAAG,WAAW;IAsCpD,eAAe,IAAI,IAAI;IASvB,OAAO,IAAI,IAAI;CAKhC"}

package/dist/esm/rendering/Drawable.js

@@ -1,4 +1,5 @@
 import { Color } from '../core/Color.js';
+import { drawableHasOwnMaterial, writeMaterialKeyInto } from './plan/RenderCommand.js';
 import { isPixelSnapMode } from './pixelSnap.js';
 import { RenderNode } from './RenderNode.js';
 import { BlendModes } from './types.js';
@@ -14,6 +15,15 @@ class Drawable extends RenderNode {
     _tint = Color.white.clone();
     _blendMode = BlendModes.Normal;
     _pixelSnapMode = 'none';
+    /**
+     * Cached material key (Slice 2b). `null` until first computed or after
+     * {@link invalidateCache}. Bound to {@link _materialKeyBackend} so a backend
+     * switch (multi-app / multi-backend) recomputes rather than returning stale
+     * renderer ids. Drawables that carry their own {@link Material} bypass this
+     * cache entirely (the material can mutate its keys without notifying us).
+     */
+    _materialKey = null;
+    _materialKeyBackend = null;
     get tint() {
         return this._tint;
     }
@@ -92,6 +102,50 @@ class Drawable extends RenderNode {
     _renderPlanGetBlendMode() {
         return this._blendMode;
     }
+    /**
+     * Resolve this drawable's {@link MaterialKey}, reusing a cached key when valid
+     * (Slice 2b). The cache busts on any tint/blend/texture/material/shader/
+     * pixel-snap mutation via {@link invalidateCache}, and on a backend switch.
+     *
+     * Drawables that own a {@link Material} are never cached — the material can
+     * change its `pipelineKey`/`bindKey` internally without notifying the node —
+     * so they recompute into the held key (still zero per-frame allocation).
+     *
+     * @internal
+     */
+    _getOrComputeMaterialKey(backend) {
+        const cached = this._materialKey;
+        if (cached !== null) {
+            if (drawableHasOwnMaterial(this)) {
+                // Own-material path: never trust the cache, but reuse the held object.
+                return writeMaterialKeyInto(cached, this, backend);
+            }
+            if (this._materialKeyBackend === backend) {
+                return cached;
+            }
+            // Backend switched: recompute into the held key, rebind to the backend.
+            this._materialKeyBackend = backend;
+            return writeMaterialKeyInto(cached, this, backend);
+        }
+        const key = writeMaterialKeyInto({
+            rendererId: 0,
+            blendMode: this._blendMode,
+            textureId: -1,
+            shaderId: -1,
+            pipelineKey: 0,
+            bindKey: 0,
+        }, this, backend);
+        this._materialKey = key;
+        this._materialKeyBackend = backend;
+        return key;
+    }
+    invalidateCache() {
+        super.invalidateCache();
+        // Bust the cached material key; next emitDraw recomputes it. The held object
+        // is kept and rewritten in place on the next miss (no re-allocation).
+        this._materialKeyBackend = null;
+        return this;
+    }
     destroy() {
         super.destroy();
         this._tint.destroy();

package/dist/esm/rendering/Drawable.js.map

@@ -1 +1 @@
-{"version":3,"file":"Drawable.js","sources":["../../../../src/rendering/Drawable.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAOA;;;;;;AAMG;AACG,MAAO,QAAS,SAAQ,UAAU,CAAA;AAC9B,IAAA,KAAK,GAAU,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE;AAClC,IAAA,UAAU,GAAe,UAAU,CAAC,MAAM;IAC1C,cAAc,GAAkB,MAAM;AAE9C,IAAA,IAAW,IAAI,GAAA;QACb,OAAO,IAAI,CAAC,KAAK;IACnB;IAEA,IAAW,IAAI,CAAC,IAAW,EAAA;AACzB,QAAA,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IACpB;AAEA,IAAA,IAAW,SAAS,GAAA;QAClB,OAAO,IAAI,CAAC,UAAU;IACxB;IAEA,IAAW,SAAS,CAAC,SAAqB,EAAA;AACxC,QAAA,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC;IAC9B;AAEA;;;;;;;;;;;;;;;;;;AAkBG;AACH,IAAA,IAAW,aAAa,GAAA;QACtB,OAAO,IAAI,CAAC,cAAc;IAC5B;IAEA,IAAW,aAAa,CAAC,IAAmB,EAAA;AAC1C,QAAA,IAAI,IAAI,KAAK,IAAI,CAAC,cAAc,EAAE;YAChC;QACF;AAEA,QAAA,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE;YAC1B,MAAM,IAAI,KAAK,CAAC,CAAA,sEAAA,EAAyE,MAAM,CAAC,IAAI,CAAC,CAAA,EAAA,CAAI,CAAC;QAC5G;AAEA,QAAA,IAAI,CAAC,cAAc,GAAG,IAAI;QAC1B,IAAI,CAAC,eAAe,EAAE;IACxB;AAEA;;;AAGG;AACI,IAAA,OAAO,CAAC,KAAY,EAAA;QACzB,IAAI,KAAK,EAAE;AACT,YAAA,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;YACtB,IAAI,CAAC,eAAe,EAAE;QACxB;AAEA,QAAA,OAAO,IAAI;IACb;AAEA;;;AAGG;AACI,IAAA,YAAY,CAAC,SAAqB,EAAA;AACvC,QAAA,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE;AACjC,YAAA,IAAI,CAAC,UAAU,GAAG,SAAS;YAC3B,IAAI,CAAC,eAAe,EAAE;QACxB;AAEA,QAAA,OAAO,IAAI;IACb;;AAGmB,IAAA,eAAe,CAAC,OAA0B,EAAA;AAC3D,QAAA,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IACxB;;IAGgB,wBAAwB,GAAA;AACtC,QAAA,OAAO,IAAI;IACb;;IAGgB,uBAAuB,GAAA;QACrC,OAAO,IAAI,CAAC,UAAU;IACxB;IAEgB,OAAO,GAAA;QACrB,KAAK,CAAC,OAAO,EAAE;AAEf,QAAA,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE;IACtB;AACD;;;;"}
+{"version":3,"file":"Drawable.js","sources":["../../../../src/rendering/Drawable.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/esm/rendering/GpuResourceAccountant.d.ts

@@ -0,0 +1,65 @@
+import type { RenderStats } from './RenderStats';
+/**
+ * Per-backend GPU resource accountant (Slice 2g — Resource-Accounting).
+ *
+ * The GPU exposes no way to query VRAM usage (neither WebGL2 nor WebGPU report
+ * it — a deliberate security boundary), so the engine keeps its own running
+ * tally by booking every allocation (`+`) and every free (`−`) at the points
+ * where the backend creates or destroys a GPU texture / buffer. The same
+ * bookkeeping runs against the Node fake-context, so it is fully deterministic
+ * and CI-testable.
+ *
+ * The accountant owns the authoritative running total ({@link liveBytes}) and
+ * mirrors it into {@link RenderStats.gpuMemoryBytes}. Unlike the per-frame
+ * counters, that total is **not** zeroed by {@link resetRenderStats} — live
+ * resources outlive frames. The per-frame upload / download accumulators are
+ * written straight into the stats object and reset each tick.
+ *
+ * One accountant per backend instance (never module-global) so that multiple
+ * concurrent {@link Application}s keep independent tallies.
+ *
+ * @internal
+ */
+export declare class GpuResourceAccountant {
+    private readonly _stats;
+    private _liveBytes;
+    constructor(stats: RenderStats);
+    /** Current running total of live GPU resource bytes (textures + buffers). */
+    get liveBytes(): number;
+    /**
+     * Record an allocation of `bytes` GPU memory (texture storage or buffer).
+     * Pass a non-negative value; the running total and the mirrored
+     * `stats.gpuMemoryBytes` both increase.
+     */
+    allocate(bytes: number): void;
+    /**
+     * Record a free of `bytes` GPU memory. Clamped at zero so a double-free or a
+     * missed allocation can never drive the tally negative. To avoid transient
+     * spikes on resize, book the free **before** the matching re-allocation.
+     */
+    free(bytes: number): void;
+    /**
+     * Re-book a resource whose byte size changed in place (e.g. a texture resize):
+     * frees the previous size and allocates the next, never dipping below zero.
+     * Returns the new size so callers can stash it for the next free.
+     */
+    reallocate(previousBytes: number, nextBytes: number): number;
+    /** Record `bytes` of content-texture pixel data uploaded this frame (CPU → GPU). */
+    recordTextureUpload(bytes: number): void;
+    /** Record `bytes` of buffer data uploaded this frame (CPU → GPU). */
+    recordBufferUpload(bytes: number): void;
+    /** Record a GPU → CPU readback of `bytes` this frame (e.g. `mapAsync`, `readPixels`). */
+    recordDownload(bytes: number): void;
+}
+/**
+ * Estimated bytes for a 2D texture of `width × height` at `bytesPerPixel`,
+ * including the mip chain when `mipLevelCount > 1`. A full mip chain adds
+ * roughly ¹⁄₃ over the base level; this sums the exact per-level footprint
+ * (each level a quarter of the previous, floored at 1×1).
+ *
+ * @internal
+ */
+export declare const estimateTextureBytes: (width: number, height: number, bytesPerPixel: number, mipLevelCount?: number) => number;
+/** Bytes per pixel for the {@link DataTexture} formats (shared by both backends). @internal */
+export declare const dataTextureBytesPerPixel: (format: "r8" | "r32f" | "rgba8" | "rgba32f") => number;
+//# sourceMappingURL=GpuResourceAccountant.d.ts.map

package/dist/esm/rendering/GpuResourceAccountant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GpuResourceAccountant.d.ts","sourceRoot":"","sources":["../../../src/rendering/GpuResourceAccountant.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,UAAU,CAAK;gBAEJ,KAAK,EAAE,WAAW;IAKrC,6EAA6E;IAC7E,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED;;;;OAIG;IACI,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IASpC;;;;OAIG;IACI,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAShC;;;;OAIG;IACI,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM;IAOnE,oFAAoF;IAC7E,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ/C,qEAAqE;IAC9D,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ9C,yFAAyF;IAClF,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;CAQ3C;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,EAAE,QAAQ,MAAM,EAAE,eAAe,MAAM,EAAE,sBAAiB,KAAG,MAqB9G,CAAC;AAEF,+FAA+F;AAC/F,eAAO,MAAM,wBAAwB,GAAI,QAAQ,IAAI,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,KAAG,MAWtF,CAAC"}