@codexo/exojs 0.10.0 → 0.12.0

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

@@ -0,0 +1,61 @@
+import type { RenderingContext } from './RenderingContext';
+import { RenderPass, type RenderPassOptions } from './RenderPass';
+/**
+ * An ordered list of {@link RenderPass} steps, played once per frame against a {@link RenderingContext}.
+ *
+ * A `RenderPipeline` is **itself a `RenderPass`**, so pipelines nest freely and a disabled pipeline skips its
+ * whole subtree. It **owns** the passes added to it (exclusive ownership — a pass belongs to at most one
+ * pipeline): {@link resize} and {@link destroy} cascade to them. It never owns scene nodes or caller
+ * RenderTextures. Adding a pass that would create a direct or indirect cycle throws at add time.
+ * @advanced
+ */
+export declare class RenderPipeline extends RenderPass {
+    private readonly _passes;
+    private _executing;
+    private _destroyed;
+    constructor(options?: RenderPassOptions);
+    /** Number of registered passes (enabled and disabled). */
+    get size(): number;
+    /**
+     * Append a pass and take exclusive ownership of it. Throws if the pass already belongs to any pipeline, if
+     * adding it would create a direct/indirect cycle, during `execute`, or after `destroy`.
+     */
+    addPass(pass: RenderPass): this;
+    /** Insert a pass at `index` (clamped to `[0, size]`). Same ownership / cycle / execute / destroy throws as {@link addPass}. */
+    insertPass(pass: RenderPass, index: number): this;
+    /** Remove a pass by identity and release its ownership. Returns `false` if absent. Does not destroy it. */
+    removePass(pass: RenderPass): boolean;
+    /** Remove all passes and release their ownership. Does not destroy them. The pipeline stays usable. */
+    clear(): this;
+    /** Whether `pass` is registered in this pipeline. */
+    hasPass(pass: RenderPass): boolean;
+    /** Index of `pass` in play order, or `-1` if absent. */
+    indexOf(pass: RenderPass): number;
+    /** The pass at `index` in play order, or `undefined` if out of range. */
+    at(index: number): RenderPass | undefined;
+    /** Iterate registered passes in play order. */
+    [Symbol.iterator](): IterableIterator<RenderPass>;
+    /**
+     * Play every enabled pass in order against `context`. No-op if `this.enabled === false` (a pipeline is itself a
+     * directly-executable pass, so disabling it skips its whole subtree). Not re-entrant. Throws after `destroy`.
+     */
+    execute(context: RenderingContext): void;
+    /** Cascade `resize(width, height)` to every pass (enabled and disabled). */
+    resize(width: number, height: number): void;
+    /**
+     * Cascade `destroy()` to every pass, release their ownership, then clear the list. Idempotent. Throws during
+     * `execute` (before any teardown begins).
+     *
+     * Best-effort teardown: the pipeline is marked destroyed and detached from its passes up front, so it always
+     * ends in a single, consistent destroyed-and-empty state — every child gets a `destroy()` attempt and has its
+     * owner slot released even if an earlier child throws. If one or more children throw, the first error is
+     * re-thrown after the cascade completes.
+     */
+    destroy(): void;
+    private _admit;
+    /** Whether `target` is reachable from this pipeline (this === target, or a nested pipeline reaches it). */
+    private _reaches;
+    private _assertLive;
+    private _assertNotExecuting;
+}
+//# sourceMappingURL=RenderPipeline.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RenderPipeline.d.ts","sourceRoot":"","sources":["../../../src/rendering/RenderPipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAElE;;;;;;;;GAQG;AACH,qBAAa,cAAe,SAAQ,UAAU;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;gBAER,OAAO,CAAC,EAAE,iBAAiB;IAI9C,0DAA0D;IAC1D,IAAW,IAAI,IAAI,MAAM,CAExB;IAED;;;OAGG;IACI,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAQtC,+HAA+H;IACxH,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IASxD,2GAA2G;IACpG,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAgB5C,uGAAuG;IAChG,KAAK,IAAI,IAAI;IAapB,qDAAqD;IAC9C,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO;IAIzC,wDAAwD;IACjD,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAIxC,yEAAyE;IAClE,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAIhD,+CAA+C;IACxC,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAC,UAAU,CAAC;IAIxD;;;OAGG;IACa,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAwBxD,4EAA4E;IAC5D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAM3D;;;;;;;;OAQG;IACa,OAAO,IAAI,IAAI;IA8B/B,OAAO,CAAC,MAAM;IAad,2GAA2G;IAC3G,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,WAAW;IAMnB,OAAO,CAAC,mBAAmB;CAK5B"}

package/dist/esm/rendering/RenderPipeline.js

@@ -0,0 +1,177 @@
+import { RenderPass } from './RenderPass.js';
+
+/**
+ * An ordered list of {@link RenderPass} steps, played once per frame against a {@link RenderingContext}.
+ *
+ * A `RenderPipeline` is **itself a `RenderPass`**, so pipelines nest freely and a disabled pipeline skips its
+ * whole subtree. It **owns** the passes added to it (exclusive ownership — a pass belongs to at most one
+ * pipeline): {@link resize} and {@link destroy} cascade to them. It never owns scene nodes or caller
+ * RenderTextures. Adding a pass that would create a direct or indirect cycle throws at add time.
+ * @advanced
+ */
+class RenderPipeline extends RenderPass {
+    _passes = [];
+    _executing = false;
+    _destroyed = false;
+    constructor(options) {
+        super(options);
+    }
+    /** Number of registered passes (enabled and disabled). */
+    get size() {
+        return this._passes.length;
+    }
+    /**
+     * Append a pass and take exclusive ownership of it. Throws if the pass already belongs to any pipeline, if
+     * adding it would create a direct/indirect cycle, during `execute`, or after `destroy`.
+     */
+    addPass(pass) {
+        this._admit(pass);
+        this._passes.push(pass);
+        pass._pipelineOwner = this;
+        return this;
+    }
+    /** Insert a pass at `index` (clamped to `[0, size]`). Same ownership / cycle / execute / destroy throws as {@link addPass}. */
+    insertPass(pass, index) {
+        this._admit(pass);
+        const at = Math.max(0, Math.min(index, this._passes.length));
+        this._passes.splice(at, 0, pass);
+        pass._pipelineOwner = this;
+        return this;
+    }
+    /** Remove a pass by identity and release its ownership. Returns `false` if absent. Does not destroy it. */
+    removePass(pass) {
+        this._assertLive();
+        this._assertNotExecuting();
+        const index = this._passes.indexOf(pass);
+        if (index === -1) {
+            return false;
+        }
+        this._passes.splice(index, 1);
+        pass._pipelineOwner = null;
+        return true;
+    }
+    /** Remove all passes and release their ownership. Does not destroy them. The pipeline stays usable. */
+    clear() {
+        this._assertLive();
+        this._assertNotExecuting();
+        for (const pass of this._passes) {
+            pass._pipelineOwner = null;
+        }
+        this._passes.length = 0;
+        return this;
+    }
+    /** Whether `pass` is registered in this pipeline. */
+    hasPass(pass) {
+        return pass._pipelineOwner === this;
+    }
+    /** Index of `pass` in play order, or `-1` if absent. */
+    indexOf(pass) {
+        return this._passes.indexOf(pass);
+    }
+    /** The pass at `index` in play order, or `undefined` if out of range. */
+    at(index) {
+        return this._passes[index];
+    }
+    /** Iterate registered passes in play order. */
+    [Symbol.iterator]() {
+        return this._passes[Symbol.iterator]();
+    }
+    /**
+     * Play every enabled pass in order against `context`. No-op if `this.enabled === false` (a pipeline is itself a
+     * directly-executable pass, so disabling it skips its whole subtree). Not re-entrant. Throws after `destroy`.
+     */
+    execute(context) {
+        if (!this.enabled) {
+            return;
+        }
+        this._assertLive();
+        if (this._executing) {
+            throw new Error('RenderPipeline.execute is not re-entrant.');
+        }
+        this._executing = true;
+        try {
+            for (const pass of this._passes) {
+                if (pass.enabled) {
+                    pass.execute(context);
+                }
+            }
+        }
+        finally {
+            this._executing = false;
+        }
+    }
+    /** Cascade `resize(width, height)` to every pass (enabled and disabled). */
+    resize(width, height) {
+        for (const pass of this._passes) {
+            pass.resize(width, height);
+        }
+    }
+    /**
+     * Cascade `destroy()` to every pass, release their ownership, then clear the list. Idempotent. Throws during
+     * `execute` (before any teardown begins).
+     *
+     * Best-effort teardown: the pipeline is marked destroyed and detached from its passes up front, so it always
+     * ends in a single, consistent destroyed-and-empty state — every child gets a `destroy()` attempt and has its
+     * owner slot released even if an earlier child throws. If one or more children throw, the first error is
+     * re-thrown after the cascade completes.
+     */
+    destroy() {
+        if (this._destroyed) {
+            return;
+        }
+        this._assertNotExecuting();
+        // Mark destroyed and snapshot-detach the children first, so the pipeline ends in a consistent
+        // destroyed-and-empty state regardless of whether a child's destroy() throws.
+        this._destroyed = true;
+        const passes = this._passes.splice(0, this._passes.length);
+        const errors = [];
+        for (const pass of passes) {
+            // Release ownership before destroying, so a throwing child never stays attached to this pipeline.
+            pass._pipelineOwner = null;
+            try {
+                pass.destroy();
+            }
+            catch (error) {
+                errors.push(error);
+            }
+        }
+        if (errors.length > 0) {
+            throw errors[0];
+        }
+    }
+    _admit(pass) {
+        this._assertLive();
+        this._assertNotExecuting();
+        if (pass._pipelineOwner !== null) {
+            throw new Error('RenderPass already belongs to a RenderPipeline; remove it from its current pipeline first.');
+        }
+        if (pass instanceof RenderPipeline && pass._reaches(this)) {
+            throw new Error('RenderPipeline cannot contain itself, directly or indirectly (cycle).');
+        }
+    }
+    /** Whether `target` is reachable from this pipeline (this === target, or a nested pipeline reaches it). */
+    _reaches(target) {
+        if (this === target) {
+            return true;
+        }
+        for (const pass of this._passes) {
+            if (pass instanceof RenderPipeline && pass._reaches(target)) {
+                return true;
+            }
+        }
+        return false;
+    }
+    _assertLive() {
+        if (this._destroyed) {
+            throw new Error('RenderPipeline has been destroyed and can no longer be used.');
+        }
+    }
+    _assertNotExecuting() {
+        if (this._executing) {
+            throw new Error('RenderPipeline cannot be mutated while it is executing.');
+        }
+    }
+}
+
+export { RenderPipeline };
+//# sourceMappingURL=RenderPipeline.js.map

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

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

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

@@ -38,3 +38,4 @@ export declare const createRenderStats: () => RenderStats;
  * Call once at the start of each render tick before recording new data.
  */
 export declare const resetRenderStats: (stats: RenderStats) => RenderStats;
+//# sourceMappingURL=RenderStats.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RenderStats.d.ts","sourceRoot":"","sources":["../../../src/rendering/RenderStats.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,cAAc,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;OAMG;IACH,eAAe,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAO,WAUnC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,WAAW,KAAG,WAYrD,CAAC"}

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

@@ -1,6 +1,6 @@
-import { Rectangle } from '@/math/Rectangle';
-import { Size } from '@/math/Size';
-import { Vector } from '@/math/Vector';
+import { Rectangle } from '#math/Rectangle';
+import { Size } from '#math/Size';
+import { Vector } from '#math/Vector';
 import { View } from './View';
 /**
  * Renderable destination — either the on-screen canvas (the `root`
@@ -62,3 +62,4 @@ export declare class RenderTarget {
     destroy(): void;
     protected _touch(): void;
 }
+//# sourceMappingURL=RenderTarget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RenderTarget.d.ts","sourceRoot":"","sources":["../../../src/rendering/RenderTarget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB;;;;;;;;;;;OAWG;IACI,YAAY,UAAS;IAE5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAU;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAA0C;IAC5E,OAAO,CAAC,QAAQ,CAAK;IACrB,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC;IACtB,SAAS,CAAC,SAAS,EAAE,SAAS,CAAmB;IACjD,SAAS,CAAC,YAAY,EAAE,IAAI,CAAC;IAC7B,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC;gBAEH,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,UAAQ;IAO9D,IAAW,IAAI,IAAI,IAAI,CAEtB;IAED,IAAW,IAAI,CAAC,IAAI,EAAE,IAAI,EAEzB;IAED,IAAW,IAAI,IAAI,IAAI,CAEtB;IAED,IAAW,IAAI,CAAC,IAAI,EAAE,IAAI,EAEzB;IAED,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED,IAAW,KAAK,CAAC,KAAK,EAAE,MAAM,EAE7B;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,MAAM,CAAC,MAAM,EAAE,MAAM,EAE/B;IAED,IAAW,IAAI,IAAI,OAAO,CAEzB;IAED,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED;;;;;OAKG;IACI,kBAAkB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAMrD,wEAAwE;IACjE,qBAAqB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAMjD,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI;IAWhC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAS3C,WAAW,CAAC,IAAI,GAAE,IAAiB,GAAG,SAAS;IAM/C,cAAc,IAAI,IAAI;IAMtB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,IAAiB,GAAG,MAAM;IAOhE,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,IAAiB,GAAG,MAAM;IAOhE,OAAO,IAAI,IAAI;IAgBtB,SAAS,CAAC,MAAM,IAAI,IAAI;CAGzB"}

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

@@ -28,3 +28,4 @@ export interface Renderer<Runtime extends RenderBackend = RenderBackend, Target
  * Supports both concrete and abstract drawable classes.
  */
 export type DrawableConstructor<Target extends Drawable = Drawable> = abstract new (...args: never[]) => Target;
+//# sourceMappingURL=Renderer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Renderer.d.ts","sourceRoot":"","sources":["../../../src/rendering/Renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,MAAM,WAAW,QAAQ,CAAC,OAAO,SAAS,aAAa,GAAG,aAAa,EAAE,MAAM,SAAS,QAAQ,GAAG,QAAQ;IACzG,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IAExC,sEAAsE;IACtE,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IAChC,uDAAuD;IACvD,UAAU,IAAI,IAAI,CAAC;IACnB,uDAAuD;IACvD,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gDAAgD;IAChD,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,CAAC,MAAM,SAAS,QAAQ,GAAG,QAAQ,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,MAAM,CAAC"}

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

@@ -17,6 +17,7 @@ import type { DrawableConstructor, Renderer } from './Renderer';
  */
 export declare class RendererRegistry<Runtime extends RenderBackend> {
     private readonly _renderers;
+    private readonly _resolved;
     private _backend;
     /**
      * Register a renderer for a specific drawable type.
@@ -28,6 +29,13 @@ export declare class RendererRegistry<Runtime extends RenderBackend> {
      * @throws Error if a renderer is already registered for this drawable type.
      */
     registerRenderer<Target extends Drawable>(drawableType: DrawableConstructor<Target>, renderer: Renderer<Runtime, Target>): void;
+    /**
+     * Atomically bind all `targets` to `renderer`.
+     * Validates every target before mutating any map entry.
+     * Clears the resolution cache exactly once after all entries are written.
+     * @internal
+     */
+    bindRenderer(targets: readonly DrawableConstructor[], renderer: Renderer<Runtime>): void;
     /**
      * Iterate all registered renderers. Used by managers to dispatch
      * lifecycle hooks (e.g. WebGPU pipeline pre-warmup) to whichever
@@ -36,8 +44,8 @@ export declare class RendererRegistry<Runtime extends RenderBackend> {
     renderers(): Iterable<Renderer<Runtime>>;
     /**
      * Find the renderer responsible for `drawable`.
-     * Walks the prototype chain so subclasses inherit their parent's renderer
-     * without requiring an explicit registration.
+     * Uses a first-resolution cache — after warm-up, a single Map.get.
+     * Falls back to prototype-chain walk on cache miss.
      *
      * @throws Error if no renderer is found for the drawable's type.
      */
@@ -52,6 +60,9 @@ export declare class RendererRegistry<Runtime extends RenderBackend> {
     disconnect(): void;
     /**
      * Disconnect all registered renderers and clear the registry.
+     * Deduplicates across multi-target bindings so each shared renderer
+     * instance is disconnected and destroyed exactly once.
      */
     destroy(): void;
 }
+//# sourceMappingURL=RendererRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RendererRegistry.d.ts","sourceRoot":"","sources":["../../../src/rendering/RendererRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEhE;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAgB,CAAC,OAAO,SAAS,aAAa;IACzD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqD;IAChF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqD;IAC/E,OAAO,CAAC,QAAQ,CAAwB;IAExC;;;;;;;;OAQG;IACI,gBAAgB,CAAC,MAAM,SAAS,QAAQ,EAAE,YAAY,EAAE,mBAAmB,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,IAAI;IAetI;;;;;OAKG;IACI,YAAY,CAAC,OAAO,EAAE,SAAS,mBAAmB,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI;IAqC/F;;;;OAIG;IACI,SAAS,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAI/C;;;;;;OAMG;IACI,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC;IAkCrD;;OAEG;IACI,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAQtC;;OAEG;IACI,UAAU,IAAI,IAAI;IAQzB;;;;OAIG;IACI,OAAO,IAAI,IAAI;CAkBvB"}

package/dist/esm/rendering/RendererRegistry.js

@@ -14,6 +14,7 @@
  */
 class RendererRegistry {
     _renderers = new Map();
+    _resolved = new Map();
     _backend = null;
     /**
      * Register a renderer for a specific drawable type.
@@ -31,6 +32,42 @@ class RendererRegistry {
         // Widen TDrawable to Drawable for storage. Safe because the map key
         // guarantees the correct drawable type is always paired at lookup.
         this._renderers.set(drawableType, renderer);
+        this._resolved.clear();
+        if (this._backend !== null) {
+            renderer.connect(this._backend);
+        }
+    }
+    /**
+     * Atomically bind all `targets` to `renderer`.
+     * Validates every target before mutating any map entry.
+     * Clears the resolution cache exactly once after all entries are written.
+     * @internal
+     */
+    bindRenderer(targets, renderer) {
+        if (targets.length === 0) {
+            throw new Error('A RendererBinding must declare at least one target.');
+        }
+        // Validate: no duplicate targets within this call
+        const seen = new Set();
+        for (const target of targets) {
+            if (seen.has(target)) {
+                throw new Error(`A RendererBinding declares the same target ${target.name} more than once.`);
+            }
+            seen.add(target);
+        }
+        // Validate: no target already registered — throw before any mutation
+        for (const target of targets) {
+            if (this._renderers.has(target)) {
+                throw new Error(`A renderer is already registered for ${target.name}.`);
+            }
+        }
+        // All validation passed — atomically install all mappings
+        for (const target of targets) {
+            this._renderers.set(target, renderer);
+        }
+        // Invalidate resolution cache once
+        this._resolved.clear();
+        // Connect renderer if already connected
         if (this._backend !== null) {
             renderer.connect(this._backend);
         }
@@ -45,13 +82,18 @@ class RendererRegistry {
     }
     /**
      * Find the renderer responsible for `drawable`.
-     * Walks the prototype chain so subclasses inherit their parent's renderer
-     * without requiring an explicit registration.
+     * Uses a first-resolution cache — after warm-up, a single Map.get.
+     * Falls back to prototype-chain walk on cache miss.
      *
      * @throws Error if no renderer is found for the drawable's type.
      */
     resolve(drawable) {
-        let constructor = drawable.constructor;
+        const ctor = drawable.constructor;
+        const cached = this._resolved.get(ctor);
+        if (cached !== undefined) {
+            return cached;
+        }
+        let constructor = ctor;
         let renderer;
         while (constructor !== null && !renderer) {
             renderer = this._renderers.get(constructor);
@@ -61,8 +103,11 @@ class RendererRegistry {
             }
         }
         if (!renderer) {
-            throw new Error(`No renderer registered for ${drawable.constructor.name}. ` + 'Register one with registry.registerRenderer() before the first draw call.');
+            throw new Error(`No renderer registered for ${drawable.constructor.name}. ` +
+                'If it comes from an ExoJS extension, import that package before creating the Application, ' +
+                'or pass the extension via ApplicationOptions.extensions.');
         }
+        this._resolved.set(ctor, renderer);
         return renderer;
     }
     /**
@@ -85,15 +130,23 @@ class RendererRegistry {
     }
     /**
      * Disconnect all registered renderers and clear the registry.
+     * Deduplicates across multi-target bindings so each shared renderer
+     * instance is disconnected and destroyed exactly once.
      */
     destroy() {
-        this.disconnect();
+        const seen = new Set();
         for (const renderer of this._renderers.values()) {
-            if ('destroy' in renderer && typeof renderer.destroy === 'function') {
-                renderer.destroy();
+            if (!seen.has(renderer)) {
+                seen.add(renderer);
+                renderer.disconnect();
+                if ('destroy' in renderer && typeof renderer.destroy === 'function') {
+                    renderer.destroy();
+                }
             }
         }
         this._renderers.clear();
+        this._resolved.clear();
+        this._backend = null;
     }
 }
 

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

@@ -1 +1 @@
-{"version":3,"file":"RendererRegistry.js","sources":["../../../../src/rendering/RendererRegistry.ts"],"sourcesContent":[null],"names":[],"mappings":"AAIA;;;;;;;;;;;;;AAaG;MACU,gBAAgB,CAAA;AACV,IAAA,UAAU,GAAG,IAAI,GAAG,EAA0C;IACvE,QAAQ,GAAmB,IAAI;AAEvC;;;;;;;;AAQG;IACI,gBAAgB,CAA0B,YAAyC,EAAE,QAAmC,EAAA;QAC7H,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE;YACrC,MAAM,IAAI,KAAK,CAAC,CAAA,qCAAA,EAAwC,YAAY,CAAC,IAAI,CAAA,CAAA,CAAG,CAAC;QAC/E;;;QAIA,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAC;AAE3C,QAAA,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE;AACzB,YAAA,QAA8B,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;QACxD;IACF;AAEA;;;;AAIG;IACI,SAAS,GAAA;AACd,QAAA,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE;IACjC;AAEA;;;;;;AAMG;AACI,IAAA,OAAO,CAAC,QAAkB,EAAA;AAC/B,QAAA,IAAI,WAAW,GAAG,QAAQ,CAAC,WAAyC;AACpE,QAAA,IAAI,QAAuC;AAE3C,QAAA,OAAO,WAAW,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE;YACxC,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC;YAE3C,IAAI,CAAC,QAAQ,EAAE;gBACb,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,WAAW,CAAC,SAAS,CAAiD;AAE9G,gBAAA,WAAW,GAAG,SAAS,EAAE,WAAW,IAAI,IAAI;YAC9C;QACF;QAEA,IAAI,CAAC,QAAQ,EAAE;AACb,YAAA,MAAM,IAAI,KAAK,CACb,CAAA,2BAAA,EAA8B,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAA,EAAA,CAAI,GAAG,2EAA2E,CAC1I;QACH;AAEA,QAAA,OAAO,QAAQ;IACjB;AAEA;;AAEG;AACI,IAAA,OAAO,CAAC,OAAgB,EAAA;AAC7B,QAAA,IAAI,CAAC,QAAQ,GAAG,OAAO;QAEvB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE;AAC/C,YAAA,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC;QAC3B;IACF;AAEA;;AAEG;IACI,UAAU,GAAA;QACf,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE;YAC/C,QAAQ,CAAC,UAAU,EAAE;QACvB;AAEA,QAAA,IAAI,CAAC,QAAQ,GAAG,IAAI;IACtB;AAEA;;AAEG;IACI,OAAO,GAAA;QACZ,IAAI,CAAC,UAAU,EAAE;QAEjB,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE;YAC/C,IAAI,SAAS,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,UAAU,EAAE;gBAClE,QAAoD,CAAC,OAAO,EAAE;YACjE;QACF;AAEA,QAAA,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE;IACzB;AACD;;;;"}
+{"version":3,"file":"RendererRegistry.js","sources":["../../../../src/rendering/RendererRegistry.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

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

@@ -1,10 +1,10 @@
-import type { Color } from '@/core/Color';
-import { type RenderBackend } from '@/rendering/RenderBackend';
-import { type RenderNode } from '@/rendering/RenderNode';
-import { type RenderStats } from '@/rendering/RenderStats';
-import { RenderTexture } from '@/rendering/texture/RenderTexture';
-import { View } from '@/rendering/View';
+import type { Color } from '#core/Color';
+import { RenderTexture } from '#rendering/texture/RenderTexture';
 import { Camera } from './Camera';
+import { type RenderBackend } from './RenderBackend';
+import { type RenderNode } from './RenderNode';
+import { type RenderStats } from './RenderStats';
+import { View } from './View';
 export interface RenderToOptions {
     width: number;
     height: number;
@@ -85,3 +85,4 @@ export declare class RenderingContext {
      */
     get backend(): RenderBackend;
 }
+//# sourceMappingURL=RenderingContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RenderingContext.d.ts","sourceRoot":"","sources":["../../../src/rendering/RenderingContext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAIzC,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEjE,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,KAAK,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,4FAA4F;IAC5F,IAAI,CAAC,EAAE,IAAI,CAAC;CACb;AAED;;;;;;;;;;GAUG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAO;gBAEhB,OAAO,EAAE,aAAa;IAezC;;;;OAIG;IACH,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,MAAM,CAAC,MAAM,EAAE,MAAM,EAQ/B;IAED;;;;;;;OAOG;IACH,IAAW,UAAU,IAAI,IAAI,CAE5B;IAED,qEAAqE;IACrE,IAAW,IAAI,IAAI,IAAI,CAEtB;IAED;;;OAGG;IACI,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIpC;;;OAGG;IACI,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAMlD;;;;;;OAMG;IACI,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,GAAE,aAAkB,GAAG,IAAI;IAOlE;;;;;;;;OAQG;IACI,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,GAAG,aAAa;IA2C1E,iEAAiE;IACjE,IAAW,KAAK,IAAI,WAAW,CAE9B;IAED;;;;OAIG;IACH,IAAW,OAAO,IAAI,aAAa,CAElC;CACF"}

package/dist/esm/rendering/RenderingContext.js

@@ -1,16 +1,16 @@
+import { StencilAttachmentMode } from './pass/RenderPassDescriptor.js';
+import { playRenderTree } from './plan/playRenderTree.js';
+import { RenderTexture } from './texture/RenderTexture.js';
+import { Camera } from './Camera.js';
 import '../core/Color.js';
 import '../core/SceneNode.js';
-import '../core/Time.js';
 import '../math/Size.js';
+import '../core/Time.js';
 import '../math/Rectangle.js';
-import { playRenderTree } from './plan/playRenderTree.js';
 import './plan/RenderCommand.js';
 import './plan/RenderScope.js';
-import { StencilAttachmentMode } from './pass/RenderPassDescriptor.js';
-import { RenderTexture } from './texture/RenderTexture.js';
 import './types.js';
 import { View } from './View.js';
-import { Camera } from './Camera.js';
 
 /**
  * Owns rendering orchestration: builds, optimizes and plays the internal

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

@@ -1,5 +1,5 @@
-import type { Color } from '@/core/Color';
-import type { Matrix } from '@/math/Matrix';
+import type { Color } from '#core/Color';
+import type { Matrix } from '#math/Matrix';
 /** @internal */
 export interface TransformBufferFrameSnapshot {
     readonly count: number;
@@ -24,15 +24,60 @@ export declare class TransformBuffer {
     private _frameHash;
     private _lastCommittedHash;
     private _lastCommittedCount;
+    private _writeCount;
+    private _skippedWriteCount;
+    private _uploadCount;
+    private _uploadedRecordCount;
     get count(): number;
+    /**
+     * Number of transform rows written into the buffer (via {@link write} /
+     * {@link push}) since the last {@link begin}. Internal stat for profiling and
+     * regression guards; does not affect packing.
+     * @internal
+     */
+    get writeCount(): number;
+    /**
+     * Number of draw commands whose transform write was skipped since the last
+     * {@link begin} — recorded by the backend for renderers that opt out of the
+     * shared transform storage (`_consumesSharedTransform === false`).
+     * @internal
+     */
+    get skippedWriteCount(): number;
+    /**
+     * Number of GPU uploads (texture / storage writes) issued for this buffer
+     * since the last {@link begin}. Recorded by the backend at its upload
+     * boundary; an unchanged frame uploads zero times.
+     * @internal
+     */
+    get uploadCount(): number;
+    /**
+     * Total transform rows pushed to the GPU across all uploads since the last
+     * {@link begin}.
+     * @internal
+     */
+    get uploadedRecordCount(): number;
     get capacity(): number;
     get data(): Float32Array;
     get version(): number;
     begin(expectedCount?: number): this;
     push(transform: Matrix, tint: Color): number;
     write(slot: number, transform: Matrix, tint: Color): this;
+    /**
+     * Record that a draw command's transform write was intentionally skipped
+     * because its renderer opts out of the shared transform storage. Counts
+     * toward {@link skippedWriteCount} only — buffer contents are untouched.
+     * @internal
+     */
+    recordSkippedWrite(): this;
+    /**
+     * Record a GPU upload of `recordCount` transform rows. Called by the backend
+     * at its upload boundary after committing a snapshot; affects stats only.
+     * @internal
+     */
+    recordUpload(recordCount: number): this;
     commitSnapshot(minCount?: number): TransformBufferFrameSnapshot;
     private _ensureCapacity;
     private _hashFloat;
     private _mix;
 }
+//# sourceMappingURL=TransformBuffer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TransformBuffer.d.ts","sourceRoot":"","sources":["../../../src/rendering/TransformBuffer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAU3C,gBAAgB;AAChB,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAmE;IAChF,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,mBAAmB,CAAM;IACjC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,kBAAkB,CAAK;IAC/B,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,oBAAoB,CAAK;IAEjC,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED;;;;;OAKG;IACH,IAAW,UAAU,IAAI,MAAM,CAE9B;IAED;;;;;OAKG;IACH,IAAW,iBAAiB,IAAI,MAAM,CAErC;IAED;;;;;OAKG;IACH,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED;;;;OAIG;IACH,IAAW,mBAAmB,IAAI,MAAM,CAEvC;IAED,IAAW,QAAQ,IAAI,MAAM,CAE5B;IAED,IAAW,IAAI,IAAI,YAAY,CAE9B;IAED,IAAW,OAAO,IAAI,MAAM,CAE3B;IAEM,KAAK,CAAC,aAAa,SAAI,GAAG,IAAI;IAe9B,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,MAAM;IAQ5C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI;IAsChE;;;;;OAKG;IACI,kBAAkB,IAAI,IAAI;IAMjC;;;;OAIG;IACI,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAOvC,cAAc,CAAC,QAAQ,SAAI,GAAG,4BAA4B;IAmBjE,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,UAAU;IAMlB,OAAO,CAAC,IAAI;CAGb"}