@codexo/exojs 0.11.0 → 0.13.0

package/dist/esm/rendering/RenderNodePass.js

@@ -0,0 +1,48 @@
+import { playRenderTree } from './plan/playRenderTree.js';
+import { BackendTargetPass } from './BackendTargetPass.js';
+import { RenderPass } from './RenderPass.js';
+
+/**
+ * Renders a scene subtree (a {@link RenderNode}) as one pass — into the active target, or off-screen when
+ * `options.target` is set. The most common pass: world, HUD overlay, an off-screen scene capture.
+ *
+ * `view`/`target`/`clear` are fixed at construction; only `enabled`/`label` are mutable. The off-screen redirect is
+ * built once and reused every frame (no per-frame allocation). The node and any caller `target` are NOT owned by
+ * this pass — `destroy()` never frees them.
+ * @advanced
+ */
+class RenderNodePass extends RenderPass {
+    _node;
+    _target;
+    _clear;
+    _renderOptions;
+    _redirect;
+    constructor(node, options) {
+        super(options);
+        this._node = node;
+        this._target = options?.target ?? null;
+        this._clear = options?.clear ?? null;
+        this._renderOptions = { view: options?.view };
+        this._redirect =
+            this._target !== null
+                ? new BackendTargetPass(backend => playRenderTree(this._node, backend), {
+                    target: this._target,
+                    view: options?.view ?? this._target.view,
+                    clearColor: this._clear ?? undefined,
+                })
+                : null;
+    }
+    execute(context) {
+        if (this._redirect !== null) {
+            context.backend.execute(this._redirect);
+            return;
+        }
+        if (this._clear !== null) {
+            context.backend.clear(this._clear);
+        }
+        context.render(this._node, this._renderOptions);
+    }
+}
+
+export { RenderNodePass };
+//# sourceMappingURL=RenderNodePass.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RenderNodePass.js","sources":["../../../../src/rendering/RenderNodePass.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAwBA;;;;;;;;AAQG;AACG,MAAO,cAAe,SAAQ,UAAU,CAAA;AAC3B,IAAA,KAAK;AACL,IAAA,OAAO;AACP,IAAA,MAAM;AACN,IAAA,cAAc;AACd,IAAA,SAAS;IAE1B,WAAA,CAAmB,IAAgB,EAAE,OAA+B,EAAA;QAClE,KAAK,CAAC,OAAO,CAAC;AAEd,QAAA,IAAI,CAAC,KAAK,GAAG,IAAI;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,MAAM,IAAI,IAAI;QACtC,IAAI,CAAC,MAAM,GAAG,OAAO,EAAE,KAAK,IAAI,IAAI;QACpC,IAAI,CAAC,cAAc,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE;AAC7C,QAAA,IAAI,CAAC,SAAS;YACZ,IAAI,CAAC,OAAO,KAAK;AACf,kBAAE,IAAI,iBAAiB,CAAC,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE;oBACpE,MAAM,EAAE,IAAI,CAAC,OAAO;oBACpB,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI;AACxC,oBAAA,UAAU,EAAE,IAAI,CAAC,MAAM,IAAI,SAAS;iBACrC;kBACD,IAAI;IACZ;AAEgB,IAAA,OAAO,CAAC,OAAyB,EAAA;AAC/C,QAAA,IAAI,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE;YAC3B,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC;YAEvC;QACF;AAEA,QAAA,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE;YACxB,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC;QACpC;QAEA,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,CAAC;IACjD;AACD;;;;"}

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

@@ -1,13 +1,58 @@
-import type { RenderBackend } from './RenderBackend';
+import type { RenderingContext } from './RenderingContext';
+import type { RenderPipeline } from './RenderPipeline';
 /**
- * A single node in the render graph.
+ * Options shared by every {@link RenderPass}.
+ * @advanced
+ */
+export interface RenderPassOptions {
+    /** Initial enabled state. Default `true`. Toggle later via the {@link RenderPass.enabled} field. */
+    readonly enabled?: boolean;
+    /** Optional debug label for the inspector / logging. Default: the constructor name. Display only — not an identity. */
+    readonly label?: string;
+}
+/**
+ * One high-level phase of a frame. Subclass and implement {@link execute}, or use a stock subclass
+ * ({@link RenderNodePass}, {@link CallbackRenderPass}, {@link RenderPipeline}).
+ *
+ * `enabled`, `label`, {@link resize}, and {@link destroy} are part of the contract so every pass — including
+ * resource-owning effect passes — composes uniformly inside a {@link RenderPipeline}.
  *
- * Concrete implementations include {@link CallbackRenderPass} for arbitrary
- * draw logic and {@link RenderTargetPass} for off-screen rendering to a
- * {@link RenderTarget}. Passes are executed in order each frame by the backend.
+ * **Exclusive ownership:** a `RenderPass` belongs to at most one {@link RenderPipeline} at a time (tracked via an
+ * internal slot). `removePass`/`clear`/`destroy` release it. This is what makes add-time cycle detection and safe
+ * cascade-destroy possible, and prevents a pass's `enabled`/`resize`/`destroy` state from being shared.
  * @advanced
  */
-export interface RenderPass {
-    /** Execute this pass, issuing draw calls through `backend`. */
-    execute(backend: RenderBackend): void;
+export declare abstract class RenderPass {
+    /**
+     * When `false`, the containing {@link RenderPipeline} skips this pass during `execute`. Default `true`.
+     * Evaluated by the parent — a direct {@link execute} call runs the pass regardless.
+     */
+    enabled: boolean;
+    /** Debug label (inspector / logging). Defaults to the constructor name. Display only — not an identity. */
+    label: string;
+    /**
+     * The owning pipeline, or `null`. Set by {@link RenderPipeline.addPass}/`insertPass`, cleared by
+     * `removePass`/`clear`/`destroy`. Used to enforce exclusive ownership and detect composition cycles.
+     * @internal
+     */
+    _pipelineOwner: RenderPipeline | null;
+    protected constructor(options?: RenderPassOptions);
+    /**
+     * Run this pass against `context`. The active render target is the canvas unless a parent redirected it.
+     *
+     * Called directly, this runs **regardless of `enabled`** — `enabled` is evaluated by the containing
+     * {@link RenderPipeline}, not self-checked here. Subclasses must not begin `execute` with `if (!this.enabled)`.
+     */
+    abstract execute(context: RenderingContext): void;
+    /**
+     * React to a surface / target size change. No-op by default; size-dependent passes (effects with scratch
+     * targets) override. Called by {@link RenderPipeline.resize}, which the caller wires to `app.onResize`.
+     */
+    resize(_width: number, _height: number): void;
+    /**
+     * Release resources this pass allocated internally. No-op by default; idempotent. Never frees injected scene
+     * nodes or caller-provided RenderTextures — those are owned by the caller / scene.
+     */
+    destroy(): void;
 }
+//# sourceMappingURL=RenderPass.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RenderPass.d.ts","sourceRoot":"","sources":["../../../src/rendering/RenderPass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,oGAAoG;IACpG,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,uHAAuH;IACvH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,8BAAsB,UAAU;IAC9B;;;OAGG;IACI,OAAO,EAAE,OAAO,CAAC;IAExB,2GAA2G;IACpG,KAAK,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACI,cAAc,EAAE,cAAc,GAAG,IAAI,CAAQ;IAEpD,SAAS,aAAa,OAAO,CAAC,EAAE,iBAAiB;IAKjD;;;;;OAKG;aACa,OAAO,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI;IAExD;;;OAGG;IACI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAIpD;;;OAGG;IACI,OAAO,IAAI,IAAI;CAGvB"}

package/dist/esm/rendering/RenderPass.js

@@ -0,0 +1,48 @@
+/**
+ * One high-level phase of a frame. Subclass and implement {@link execute}, or use a stock subclass
+ * ({@link RenderNodePass}, {@link CallbackRenderPass}, {@link RenderPipeline}).
+ *
+ * `enabled`, `label`, {@link resize}, and {@link destroy} are part of the contract so every pass — including
+ * resource-owning effect passes — composes uniformly inside a {@link RenderPipeline}.
+ *
+ * **Exclusive ownership:** a `RenderPass` belongs to at most one {@link RenderPipeline} at a time (tracked via an
+ * internal slot). `removePass`/`clear`/`destroy` release it. This is what makes add-time cycle detection and safe
+ * cascade-destroy possible, and prevents a pass's `enabled`/`resize`/`destroy` state from being shared.
+ * @advanced
+ */
+class RenderPass {
+    /**
+     * When `false`, the containing {@link RenderPipeline} skips this pass during `execute`. Default `true`.
+     * Evaluated by the parent — a direct {@link execute} call runs the pass regardless.
+     */
+    enabled;
+    /** Debug label (inspector / logging). Defaults to the constructor name. Display only — not an identity. */
+    label;
+    /**
+     * The owning pipeline, or `null`. Set by {@link RenderPipeline.addPass}/`insertPass`, cleared by
+     * `removePass`/`clear`/`destroy`. Used to enforce exclusive ownership and detect composition cycles.
+     * @internal
+     */
+    _pipelineOwner = null;
+    constructor(options) {
+        this.enabled = options?.enabled ?? true;
+        this.label = options?.label ?? new.target.name;
+    }
+    /**
+     * React to a surface / target size change. No-op by default; size-dependent passes (effects with scratch
+     * targets) override. Called by {@link RenderPipeline.resize}, which the caller wires to `app.onResize`.
+     */
+    resize(_width, _height) {
+        // no-op by default; size-dependent passes override.
+    }
+    /**
+     * Release resources this pass allocated internally. No-op by default; idempotent. Never frees injected scene
+     * nodes or caller-provided RenderTextures — those are owned by the caller / scene.
+     */
+    destroy() {
+        // no-op by default; resource-owning passes override.
+    }
+}
+
+export { RenderPass };
+//# sourceMappingURL=RenderPass.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RenderPass.js","sources":["../../../../src/rendering/RenderPass.ts"],"sourcesContent":[null],"names":[],"mappings":"AAcA;;;;;;;;;;;AAWG;MACmB,UAAU,CAAA;AAC9B;;;AAGG;AACI,IAAA,OAAO;;AAGP,IAAA,KAAK;AAEZ;;;;AAIG;IACI,cAAc,GAA0B,IAAI;AAEnD,IAAA,WAAA,CAAsB,OAA2B,EAAA;QAC/C,IAAI,CAAC,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,IAAI;AACvC,QAAA,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI;IAChD;AAUA;;;AAGG;IACI,MAAM,CAAC,MAAc,EAAE,OAAe,EAAA;;IAE7C;AAEA;;;AAGG;IACI,OAAO,GAAA;;IAEd;AACD;;;;"}

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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"}