@codexo/exojs 0.13.0 → 0.15.0

package/dist/esm/rendering/GpuResourceAccountant.js

@@ -0,0 +1,130 @@
+/**
+ * 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
+ */
+class GpuResourceAccountant {
+    _stats;
+    _liveBytes = 0;
+    constructor(stats) {
+        this._stats = stats;
+        this._stats.gpuMemoryBytes = 0;
+    }
+    /** Current running total of live GPU resource bytes (textures + buffers). */
+    get liveBytes() {
+        return this._liveBytes;
+    }
+    /**
+     * 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) {
+        if (bytes <= 0) {
+            return;
+        }
+        this._liveBytes += bytes;
+        this._stats.gpuMemoryBytes = this._liveBytes;
+    }
+    /**
+     * 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) {
+        if (bytes <= 0) {
+            return;
+        }
+        this._liveBytes = Math.max(0, this._liveBytes - bytes);
+        this._stats.gpuMemoryBytes = this._liveBytes;
+    }
+    /**
+     * 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, nextBytes) {
+        this.free(previousBytes);
+        this.allocate(nextBytes);
+        return nextBytes;
+    }
+    /** Record `bytes` of content-texture pixel data uploaded this frame (CPU → GPU). */
+    recordTextureUpload(bytes) {
+        if (bytes <= 0) {
+            return;
+        }
+        this._stats.textureUploadBytes += bytes;
+    }
+    /** Record `bytes` of buffer data uploaded this frame (CPU → GPU). */
+    recordBufferUpload(bytes) {
+        if (bytes <= 0) {
+            return;
+        }
+        this._stats.bufferUploadBytes += bytes;
+    }
+    /** Record a GPU → CPU readback of `bytes` this frame (e.g. `mapAsync`, `readPixels`). */
+    recordDownload(bytes) {
+        if (bytes <= 0) {
+            return;
+        }
+        this._stats.downloadBytes += bytes;
+        this._stats.downloadCount++;
+    }
+}
+/**
+ * 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
+ */
+const estimateTextureBytes = (width, height, bytesPerPixel, mipLevelCount = 1) => {
+    const baseWidth = Math.max(1, Math.floor(width));
+    const baseHeight = Math.max(1, Math.floor(height));
+    const levels = Math.max(1, Math.floor(mipLevelCount));
+    let total = 0;
+    let levelWidth = baseWidth;
+    let levelHeight = baseHeight;
+    for (let level = 0; level < levels; level++) {
+        total += levelWidth * levelHeight * bytesPerPixel;
+        if (levelWidth === 1 && levelHeight === 1) {
+            break;
+        }
+        levelWidth = Math.max(1, levelWidth >> 1);
+        levelHeight = Math.max(1, levelHeight >> 1);
+    }
+    return total;
+};
+/** Bytes per pixel for the {@link DataTexture} formats (shared by both backends). @internal */
+const dataTextureBytesPerPixel = (format) => {
+    switch (format) {
+        case 'r8':
+            return 1;
+        case 'r32f':
+            return 4;
+        case 'rgba8':
+            return 4;
+        case 'rgba32f':
+            return 16;
+    }
+};
+
+export { GpuResourceAccountant, dataTextureBytesPerPixel, estimateTextureBytes };
+//# sourceMappingURL=GpuResourceAccountant.js.map

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

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

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

@@ -0,0 +1,42 @@
+import type { Color } from '#core/Color';
+import type { Matrix } from '#math/Matrix';
+import type { Geometry } from '#rendering/geometry/Geometry';
+import type { DrawContext, RenderToOptions } from './DrawContext';
+import type { RenderBackend } from './RenderBackend';
+import type { RenderBatch } from './RenderBatch';
+import type { DrawBatchOptions, DrawGeometryOptions, RenderingContext, RenderOptions } from './RenderingContext';
+import type { RenderNode } from './RenderNode';
+import type { RenderTarget } from './RenderTarget';
+import type { View } from './View';
+/**
+ * Pass-scoped {@link DrawContext}: the active render target and view for a
+ * {@link CallbackRenderPass} callback. `clear`/`render`/`renderTo` route through
+ * the owning {@link RenderingContext} (and its pass coordinator), so they act on
+ * THIS pass's target and never reset the active view or leak onto another
+ * target. Default view for `render`/`draw*` is the pass view — not the world
+ * view — so a callback inside an off-screen redirect renders correctly without
+ * passing `{ view }` explicitly.
+ *
+ * Use {@link backend} only for raw draws or GPU state; switching target / view /
+ * clear through it bypasses the coordinator (the leak this type prevents).
+ * @advanced
+ */
+export declare class PassContext implements DrawContext {
+    private readonly _context;
+    /** The target this pass draws into (read-only). */
+    readonly target: RenderTarget;
+    /** The view this pass renders with (read-only). */
+    readonly view: View;
+    constructor(_context: RenderingContext, 
+    /** The target this pass draws into (read-only). */
+    target: RenderTarget, 
+    /** The view this pass renders with (read-only). */
+    view: View);
+    get backend(): RenderBackend;
+    clear(color: Color): void;
+    render(node: RenderNode, options?: RenderOptions): void;
+    renderTo(node: RenderNode, options: RenderToOptions): void;
+    drawGeometry(geometry: Geometry, transform: Matrix, options?: DrawGeometryOptions): void;
+    drawBatch(batch: RenderBatch, options?: DrawBatchOptions): void;
+}
+//# sourceMappingURL=PassContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PassContext.d.ts","sourceRoot":"","sources":["../../../src/rendering/PassContext.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;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAClE,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,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACjH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC;;;;;;;;;;;;GAYG;AACH,qBAAa,WAAY,YAAW,WAAW;IAE3C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,mDAAmD;aACnC,MAAM,EAAE,YAAY;IACpC,mDAAmD;aACnC,IAAI,EAAE,IAAI;gBAJT,QAAQ,EAAE,gBAAgB;IAC3C,mDAAmD;IACnC,MAAM,EAAE,YAAY;IACpC,mDAAmD;IACnC,IAAI,EAAE,IAAI;IAG5B,IAAW,OAAO,IAAI,aAAa,CAElC;IAEM,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAIzB,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI;IAIvD,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,eAAe,GAAG,IAAI;IAI1D,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,IAAI;IAIxF,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI;CAGvE"}

package/dist/esm/rendering/PassContext.js

@@ -0,0 +1,48 @@
+/**
+ * Pass-scoped {@link DrawContext}: the active render target and view for a
+ * {@link CallbackRenderPass} callback. `clear`/`render`/`renderTo` route through
+ * the owning {@link RenderingContext} (and its pass coordinator), so they act on
+ * THIS pass's target and never reset the active view or leak onto another
+ * target. Default view for `render`/`draw*` is the pass view — not the world
+ * view — so a callback inside an off-screen redirect renders correctly without
+ * passing `{ view }` explicitly.
+ *
+ * Use {@link backend} only for raw draws or GPU state; switching target / view /
+ * clear through it bypasses the coordinator (the leak this type prevents).
+ * @advanced
+ */
+class PassContext {
+    _context;
+    target;
+    view;
+    constructor(_context, 
+    /** The target this pass draws into (read-only). */
+    target, 
+    /** The view this pass renders with (read-only). */
+    view) {
+        this._context = _context;
+        this.target = target;
+        this.view = view;
+    }
+    get backend() {
+        return this._context.backend;
+    }
+    clear(color) {
+        this._context.clear(color);
+    }
+    render(node, options) {
+        this._context.render(node, { view: options?.view ?? this.view });
+    }
+    renderTo(node, options) {
+        this._context.renderTo(node, options);
+    }
+    drawGeometry(geometry, transform, options) {
+        this._context.drawGeometry(geometry, transform, { ...options, view: options?.view ?? this.view });
+    }
+    drawBatch(batch, options) {
+        this._context.drawBatch(batch, { ...options, view: options?.view ?? this.view });
+    }
+}
+
+export { PassContext };
+//# sourceMappingURL=PassContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PassContext.js","sources":["../../../../src/rendering/PassContext.ts"],"sourcesContent":[null],"names":[],"mappings":"AAYA;;;;;;;;;;;;AAYG;MACU,WAAW,CAAA;AAEH,IAAA,QAAA;AAED,IAAA,MAAA;AAEA,IAAA,IAAA;AALlB,IAAA,WAAA,CACmB,QAA0B;;IAE3B,MAAoB;;IAEpB,IAAU,EAAA;QAJT,IAAA,CAAA,QAAQ,GAAR,QAAQ;QAET,IAAA,CAAA,MAAM,GAAN,MAAM;QAEN,IAAA,CAAA,IAAI,GAAJ,IAAI;IACnB;AAEH,IAAA,IAAW,OAAO,GAAA;AAChB,QAAA,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO;IAC9B;AAEO,IAAA,KAAK,CAAC,KAAY,EAAA;AACvB,QAAA,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC;IAC5B;IAEO,MAAM,CAAC,IAAgB,EAAE,OAAuB,EAAA;AACrD,QAAA,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IAClE;IAEO,QAAQ,CAAC,IAAgB,EAAE,OAAwB,EAAA;QACxD,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvC;AAEO,IAAA,YAAY,CAAC,QAAkB,EAAE,SAAiB,EAAE,OAA6B,EAAA;QACtF,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,QAAQ,EAAE,SAAS,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IACnG;IAEO,SAAS,CAAC,KAAkB,EAAE,OAA0B,EAAA;QAC7D,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,EAAE,EAAE,GAAG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;IAClF;AACD;;;;"}

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

@@ -2,6 +2,7 @@ import type { Color } from '#core/Color';
 import type { Matrix } from '#math/Matrix';
 import type { Rectangle } from '#math/Rectangle';
 import type { Geometry } from '#rendering/geometry/Geometry';
+import type { Mesh } from '#rendering/mesh/Mesh';
 import type { RenderTexture } from '#rendering/texture/RenderTexture';
 import type { Texture } from '#rendering/texture/Texture';
 import type { BackendRenderPass } from './BackendRenderPass';
@@ -28,10 +29,16 @@ import type { View } from './View';
  */
 export interface RenderBackend {
     readonly backendType: RenderBackendType;
-    readonly rendererRegistry: RendererRegistry<any>;
+    readonly rendererRegistry: RendererRegistry<RenderBackend>;
     readonly view: View;
     readonly renderTarget: RenderTarget;
     readonly stats: RenderStats;
+    /**
+     * The colour the canvas root target is cleared to each frame. Mutable in
+     * place (`backend.clearColor.copy(...)`) — the new value takes effect on the
+     * next frame. Both backends initialise it from `app.options.clearColor`.
+     */
+    readonly clearColor: Color;
     initialize(): Promise<this>;
     resetStats(): this;
     clear(color?: Color): this;
@@ -74,7 +81,28 @@ export interface RenderBackend {
      * non-Rectangle `MaskSource` paths on `RenderNode.mask`.
      */
     composeWithAlphaMask(content: RenderTexture, mask: Texture | RenderTexture, x: number, y: number, width: number, height: number, blendMode: BlendModes): this;
+    /**
+     * Composite `source` over the active render target under an advanced
+     * (backdrop-aware) blend mode. Captures the target's `[x, y, width, height]`
+     * region, runs the W3C blend formula in a shader, and draws the result back
+     * with normal premultiplied source-over. Used internally by the render-effect
+     * executor for modes where {@link isAdvancedBlendMode} is `true`.
+     */
+    composeWithBackdropBlend(source: RenderTexture, x: number, y: number, width: number, height: number, mode: BlendModes): this;
     draw(drawable: Drawable): this;
+    /**
+     * Submit an explicit instanced batch: draw `mesh`'s geometry once with `count`
+     * per-instance `(transform, tint)` pairs, written into fresh shared transform
+     * slots, as a single instanced draw call. `mesh` carries the geometry,
+     * material, texture and blend mode; its own transform and tint are ignored.
+     * Only the first `count` entries of `transforms` / `tints` are read.
+     *
+     * Used internally by {@link RenderingContext.drawBatch}. The geometry must use
+     * the `triangle-list` topology and the standard mesh attribute layout; a
+     * supplied material must be instancing-compatible (default mesh material, or a
+     * custom shader declaring `a_nodeIndex` + `u_transforms`).
+     */
+    drawInstanced(mesh: Mesh, transforms: readonly Matrix[], tints: readonly Color[], count: number): this;
     execute(pass: BackendRenderPass): this;
     flush(): this;
     destroy(): void;

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

@@ -1 +1 @@
-{"version":3,"file":"RenderBackend.d.ts","sourceRoot":"","sources":["../../../src/rendering/RenderBackend.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,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAE1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEnC;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAC;IAExC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACjD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,UAAU,IAAI,IAAI,CAAC;IACnB,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IAC3B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACjC,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,GAAG,IAAI,CAAC;IAEnD;;;;OAIG;IACH,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAAC;IAEzC;;OAEG;IACH,cAAc,IAAI,IAAI,CAAC;IAEvB;;;;;;;;;OASG;IACH,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1D;;;OAGG;IACH,cAAc,IAAI,IAAI,CAAC;IAEvB,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa,CAAC;IACnE,oBAAoB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAEnD;;;;;;OAMG;IACH,oBAAoB,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,GAAG,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,GAAG,IAAI,CAAC;IAE9J,IAAI,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC/B,OAAO,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACvC,KAAK,IAAI,IAAI,CAAC;IACd,OAAO,IAAI,IAAI,CAAC;CACjB"}
+{"version":3,"file":"RenderBackend.d.ts","sourceRoot":"","sources":["../../../src/rendering/RenderBackend.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,55 @@
+import { Color } from '#core/Color';
+import { Matrix } from '#math/Matrix';
+import type { Geometry } from '#rendering/geometry/Geometry';
+import type { MeshMaterial } from '#rendering/material/MeshMaterial';
+/**
+ * Explicit instanced draw submission: **one** {@link Geometry} + {@link MeshMaterial}
+ * drawn **once** with **N** per-instance `(transform, tint)` pairs — the general
+ * form of the engine's mesh-instancing model, surfaced for data-driven rendering
+ * (thousands of tiles, bullets, grass blades, procedural items as a single draw).
+ *
+ * Build it up with {@link add}, hand it to {@link RenderingContext.drawBatch},
+ * and {@link clear} it to reuse the same instance across frames without
+ * reallocating — the per-instance transform/tint storage grows on demand and is
+ * retained across `clear()`, so a steady-state batch allocates nothing.
+ *
+ * Each {@link add} **copies** the transform and tint into internal storage, so
+ * the caller may mutate or reuse the passed `Matrix`/`Color` immediately
+ * afterwards without affecting the batch.
+ *
+ * This is the explicit instanced submission path — distinct from the internal
+ * automatic sprite batcher: every instance shares the one geometry and material,
+ * and the whole batch is a single instanced draw call.
+ * @stable
+ */
+export declare class RenderBatch {
+    /** The geometry every instance in this batch draws. */
+    readonly geometry: Geometry;
+    /** The shared mesh material, or `null` for the default mesh material. */
+    readonly material: MeshMaterial | null;
+    private readonly _transforms;
+    private readonly _tints;
+    private _count;
+    constructor(geometry: Geometry, material?: MeshMaterial | null);
+    /** Number of instances currently in the batch. */
+    get count(): number;
+    /**
+     * Append one instance. `transform` is the instance's world matrix (taken as
+     * the raw `a,b,c,d,tx,ty`), `tint` modulates the geometry's vertex colors
+     * (defaults to white). Both are copied into the batch.
+     */
+    add(transform: Matrix, tint?: Color | null): this;
+    /** Reset to zero instances for reuse, retaining the pooled storage. */
+    clear(): this;
+    /**
+     * Release the pooled per-instance storage. After this the batch must not be
+     * reused. The {@link geometry} and {@link material} are owned by the caller and
+     * are not destroyed.
+     */
+    destroy(): void;
+    /** Pooled per-instance transforms; only the first {@link count} are valid. @internal */
+    get _instanceTransforms(): readonly Matrix[];
+    /** Pooled per-instance tints; only the first {@link count} are valid. @internal */
+    get _instanceTints(): readonly Color[];
+}
+//# sourceMappingURL=RenderBatch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RenderBatch.d.ts","sourceRoot":"","sources":["../../../src/rendering/RenderBatch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAErE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,WAAW;IACtB,uDAAuD;IACvD,SAAgB,QAAQ,EAAE,QAAQ,CAAC;IAEnC,yEAAyE;IACzE,SAAgB,QAAQ,EAAE,YAAY,GAAG,IAAI,CAAC;IAI9C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,MAAM,CAAK;gBAEA,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAE,YAAY,GAAG,IAAW;IAmB3E,kDAAkD;IAClD,IAAW,KAAK,IAAI,MAAM,CAEzB;IAED;;;;OAIG;IACI,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,KAAK,GAAG,IAAW,GAAG,IAAI;IAwB9D,uEAAuE;IAChE,KAAK,IAAI,IAAI;IAMpB;;;;OAIG;IACI,OAAO,IAAI,IAAI;IActB,wFAAwF;IACxF,IAAW,mBAAmB,IAAI,SAAS,MAAM,EAAE,CAElD;IAED,mFAAmF;IACnF,IAAW,cAAc,IAAI,SAAS,KAAK,EAAE,CAE5C;CACF"}

package/dist/esm/rendering/RenderBatch.js

@@ -0,0 +1,107 @@
+import { Color } from '../core/Color.js';
+import { Matrix } from '../math/Matrix.js';
+
+/**
+ * Explicit instanced draw submission: **one** {@link Geometry} + {@link MeshMaterial}
+ * drawn **once** with **N** per-instance `(transform, tint)` pairs — the general
+ * form of the engine's mesh-instancing model, surfaced for data-driven rendering
+ * (thousands of tiles, bullets, grass blades, procedural items as a single draw).
+ *
+ * Build it up with {@link add}, hand it to {@link RenderingContext.drawBatch},
+ * and {@link clear} it to reuse the same instance across frames without
+ * reallocating — the per-instance transform/tint storage grows on demand and is
+ * retained across `clear()`, so a steady-state batch allocates nothing.
+ *
+ * Each {@link add} **copies** the transform and tint into internal storage, so
+ * the caller may mutate or reuse the passed `Matrix`/`Color` immediately
+ * afterwards without affecting the batch.
+ *
+ * This is the explicit instanced submission path — distinct from the internal
+ * automatic sprite batcher: every instance shares the one geometry and material,
+ * and the whole batch is a single instanced draw call.
+ * @stable
+ */
+class RenderBatch {
+    /** The geometry every instance in this batch draws. */
+    geometry;
+    /** The shared mesh material, or `null` for the default mesh material. */
+    material;
+    // Per-instance storage grows with `add` and is reused after `clear` — only the
+    // logical `_count` resets, the pooled Matrix/Color instances are kept.
+    _transforms = [];
+    _tints = [];
+    _count = 0;
+    constructor(geometry, material = null) {
+        // The batch uploads its geometry to the GPU once and caches it by identity,
+        // so the geometry must be static (the default). dynamic/stream geometry has
+        // no persistent GPU buffer and is rejected.
+        if (geometry.usage !== 'static') {
+            throw new Error(`RenderBatch requires geometry with usage='static' (got '${geometry.usage}').`);
+        }
+        // v1 renders batches with the default mesh material; a custom material is not
+        // yet supported on the instanced path. The parameter is accepted (and stored)
+        // for the forthcoming custom-material batch support.
+        if (material !== null && material.target !== 'mesh') {
+            throw new Error(`RenderBatch material must target 'mesh' (got '${String(material.target)}').`);
+        }
+        this.geometry = geometry;
+        this.material = material;
+    }
+    /** Number of instances currently in the batch. */
+    get count() {
+        return this._count;
+    }
+    /**
+     * Append one instance. `transform` is the instance's world matrix (taken as
+     * the raw `a,b,c,d,tx,ty`), `tint` modulates the geometry's vertex colors
+     * (defaults to white). Both are copied into the batch.
+     */
+    add(transform, tint = null) {
+        let matrix = this._transforms[this._count];
+        if (matrix === undefined) {
+            matrix = new Matrix();
+            this._transforms[this._count] = matrix;
+        }
+        matrix.copy(transform);
+        let color = this._tints[this._count];
+        if (color === undefined) {
+            color = new Color();
+            this._tints[this._count] = color;
+        }
+        color.copy(tint ?? Color.white);
+        this._count++;
+        return this;
+    }
+    /** Reset to zero instances for reuse, retaining the pooled storage. */
+    clear() {
+        this._count = 0;
+        return this;
+    }
+    /**
+     * Release the pooled per-instance storage. After this the batch must not be
+     * reused. The {@link geometry} and {@link material} are owned by the caller and
+     * are not destroyed.
+     */
+    destroy() {
+        for (const matrix of this._transforms) {
+            matrix.destroy();
+        }
+        for (const color of this._tints) {
+            color.destroy();
+        }
+        this._transforms.length = 0;
+        this._tints.length = 0;
+        this._count = 0;
+    }
+    /** Pooled per-instance transforms; only the first {@link count} are valid. @internal */
+    get _instanceTransforms() {
+        return this._transforms;
+    }
+    /** Pooled per-instance tints; only the first {@link count} are valid. @internal */
+    get _instanceTints() {
+        return this._tints;
+    }
+}
+
+export { RenderBatch };
+//# sourceMappingURL=RenderBatch.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RenderBatch.js","sources":["../../../../src/rendering/RenderBatch.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAKA;;;;;;;;;;;;;;;;;;;AAmBG;MACU,WAAW,CAAA;;AAEN,IAAA,QAAQ;;AAGR,IAAA,QAAQ;;;IAIP,WAAW,GAAa,EAAE;IAC1B,MAAM,GAAY,EAAE;IAC7B,MAAM,GAAG,CAAC;IAElB,WAAA,CAAmB,QAAkB,EAAE,QAAA,GAAgC,IAAI,EAAA;;;;AAIzE,QAAA,IAAI,QAAQ,CAAC,KAAK,KAAK,QAAQ,EAAE;YAC/B,MAAM,IAAI,KAAK,CAAC,CAAA,wDAAA,EAA2D,QAAQ,CAAC,KAAK,CAAA,GAAA,CAAK,CAAC;QACjG;;;;QAKA,IAAI,QAAQ,KAAK,IAAI,IAAK,QAAQ,CAAC,MAAiB,KAAK,MAAM,EAAE;AAC/D,YAAA,MAAM,IAAI,KAAK,CAAC,CAAA,8CAAA,EAAiD,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA,GAAA,CAAK,CAAC;QAChG;AAEA,QAAA,IAAI,CAAC,QAAQ,GAAG,QAAQ;AACxB,QAAA,IAAI,CAAC,QAAQ,GAAG,QAAQ;IAC1B;;AAGA,IAAA,IAAW,KAAK,GAAA;QACd,OAAO,IAAI,CAAC,MAAM;IACpB;AAEA;;;;AAIG;AACI,IAAA,GAAG,CAAC,SAAiB,EAAE,IAAA,GAAqB,IAAI,EAAA;QACrD,IAAI,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC;AAE1C,QAAA,IAAI,MAAM,KAAK,SAAS,EAAE;AACxB,YAAA,MAAM,GAAG,IAAI,MAAM,EAAE;YACrB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,MAAM;QACxC;AAEA,QAAA,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;QAEtB,IAAI,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;AAEpC,QAAA,IAAI,KAAK,KAAK,SAAS,EAAE;AACvB,YAAA,KAAK,GAAG,IAAI,KAAK,EAAE;YACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,KAAK;QAClC;QAEA,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC;QAE/B,IAAI,CAAC,MAAM,EAAE;AAEb,QAAA,OAAO,IAAI;IACb;;IAGO,KAAK,GAAA;AACV,QAAA,IAAI,CAAC,MAAM,GAAG,CAAC;AAEf,QAAA,OAAO,IAAI;IACb;AAEA;;;;AAIG;IACI,OAAO,GAAA;AACZ,QAAA,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE;YACrC,MAAM,CAAC,OAAO,EAAE;QAClB;AAEA,QAAA,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE;YAC/B,KAAK,CAAC,OAAO,EAAE;QACjB;AAEA,QAAA,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;AAC3B,QAAA,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;AACtB,QAAA,IAAI,CAAC,MAAM,GAAG,CAAC;IACjB;;AAGA,IAAA,IAAW,mBAAmB,GAAA;QAC5B,OAAO,IAAI,CAAC,WAAW;IACzB;;AAGA,IAAA,IAAW,cAAc,GAAA;QACvB,OAAO,IAAI,CAAC,MAAM;IACpB;AACD;;;;"}

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

@@ -1,7 +1,8 @@
 import { Color } from '#core/Color';
 import { SceneNode } from '#core/SceneNode';
 import { Signal } from '#core/Signal';
-import type { InteractionEvent } from '#input/InteractionEvent';
+import type { InteractionEvent, InteractionEventType } from '#input/InteractionEvent';
+import type { KeyEvent } from '#input/KeyEvent';
 import { Rectangle } from '#math/Rectangle';
 import type { Filter } from '#rendering/filters/Filter';
 import type { Geometry } from '#rendering/geometry/Geometry';
@@ -117,18 +118,57 @@ export declare abstract class RenderNode extends SceneNode {
      * @default null
      */
     clipShape: Rectangle | Geometry | null;
-    readonly onPointerDown: Signal<[InteractionEvent]>;
-    readonly onPointerUp: Signal<[InteractionEvent]>;
-    readonly onPointerMove: Signal<[InteractionEvent]>;
-    readonly onPointerOver: Signal<[InteractionEvent]>;
-    readonly onPointerOut: Signal<[InteractionEvent]>;
-    readonly onPointerTap: Signal<[InteractionEvent]>;
+    private _signals;
+    get onPointerDown(): Signal<[InteractionEvent]>;
+    get onPointerUp(): Signal<[InteractionEvent]>;
+    get onPointerMove(): Signal<[InteractionEvent]>;
+    get onPointerOver(): Signal<[InteractionEvent]>;
+    get onPointerOut(): Signal<[InteractionEvent]>;
+    get onPointerTap(): Signal<[InteractionEvent]>;
     /** Fired once when a drag gesture begins on this node. Does not bubble. */
-    readonly onDragStart: Signal<[InteractionEvent]>;
+    get onDragStart(): Signal<[InteractionEvent]>;
     /** Fired on every pointer-move while this node is being dragged. Does not bubble. */
-    readonly onDrag: Signal<[InteractionEvent]>;
+    get onDrag(): Signal<[InteractionEvent]>;
     /** Fired when the drag gesture ends (pointer-up or cancel). Does not bubble. */
-    readonly onDragEnd: Signal<[InteractionEvent]>;
+    get onDragEnd(): Signal<[InteractionEvent]>;
+    private _interactionSignal;
+    /** @internal — the signal for `type`, or `null` if never materialized (used by the dispatch peek). */
+    _peekInteractionSignal(type: InteractionEventType): Signal<[InteractionEvent]> | null;
+    /**
+     * When `true`, this node can receive keyboard focus — via {@link focus},
+     * Tab traversal, or `app.focus.focus(node)` — and is delivered key events
+     * through {@link onKeyDown} / {@link onKeyUp} while focused.
+     *
+     * @default false
+     */
+    focusable: boolean;
+    /**
+     * Tab-traversal order among focusable nodes in the same focus scope. Lower
+     * values are visited first; equal values keep document (tree) order.
+     *
+     * @default 0
+     */
+    tabIndex: number;
+    private _onFocus;
+    private _onBlur;
+    private _onKeyDown;
+    private _onKeyUp;
+    /** Fired when this node gains keyboard focus. */
+    get onFocus(): Signal<[RenderNode]>;
+    /** Fired when this node loses keyboard focus. */
+    get onBlur(): Signal<[RenderNode]>;
+    /** Fired for each key pressed while this node holds focus. */
+    get onKeyDown(): Signal<[KeyEvent]>;
+    /** Fired for each key released while this node holds focus. */
+    get onKeyUp(): Signal<[KeyEvent]>;
+    /** @internal — the focus/blur signal if materialized, else `null` (dispatch peek). */
+    _peekFocusSignal(type: 'focus' | 'blur'): Signal<[RenderNode]> | null;
+    /** @internal — the keydown/keyup signal if materialized, else `null` (dispatch peek). */
+    _peekKeySignal(type: 'keydown' | 'keyup'): Signal<[KeyEvent]> | null;
+    /** Request keyboard focus for this node through its owning focus service. */
+    focus(): this;
+    /** Release keyboard focus from this node if it currently holds it. */
+    blur(): this;
     private readonly _filters;
     private readonly _cacheBounds;
     private _cacheSprite;

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

@@ -1 +1 @@
-{"version":3,"file":"RenderNode.d.ts","sourceRoot":"","sources":["../../../src/rendering/RenderNode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAC;AAG1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAOrC,UAAU,oBAAoB;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAAC;IAChD,YAAY,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1C,OAAO,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,OAAO,IAAI,IAAI,CAAC;CACjB;AAKD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,UAAU,GAAG,IAAI,CAAC;AAEjF;;;;;;;;;;;;;;;;GAgBG;AACH,8BAAsB,UAAW,SAAQ,SAAS;IAChD,OAAO,CAAC,MAAM,CAAC,cAAc,CAA6C;IAE1E,OAAO,CAAC,YAAY,CAAS;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEpC,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED,IAAW,WAAW,CAAC,KAAK,EAAE,OAAO,EAOpC;IAED;;;;;;;OAOG;IACI,SAAS,UAAS;IAEzB;;;;;;;;;;OAUG;IACI,iBAAiB,UAAS;IAEjC;;;;;;;;;;;;;;;;;OAiBG;IACI,IAAI,UAAS;IAEpB;;;;;;OAMG;IACI,SAAS,EAAE,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAQ;IAErD,SAAgB,aAAa,6BAAoC;IACjE,SAAgB,WAAW,6BAAoC;IAC/D,SAAgB,aAAa,6BAAoC;IACjE,SAAgB,aAAa,6BAAoC;IACjE,SAAgB,YAAY,6BAAoC;IAChE,SAAgB,YAAY,6BAAoC;IAEhE,2EAA2E;IAC3E,SAAgB,WAAW,6BAAoC;IAC/D,qFAAqF;IACrF,SAAgB,MAAM,6BAAoC;IAC1D,gFAAgF;IAChF,SAAgB,SAAS,6BAAoC;IAE7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA8B;IAC3D,OAAO,CAAC,YAAY,CAAqC;IACzD,OAAO,CAAC,YAAY,CAAqB;IACzC,OAAO,CAAC,KAAK,CAAoB;IACjC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,aAAa,CAA8B;IAEnD,IAAW,OAAO,IAAI,SAAS,MAAM,EAAE,CAEtC;IAED,IAAW,OAAO,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAI5C;IAED;;;;;;;OAOG;IACH,IAAW,IAAI,IAAI,UAAU,CAE5B;IAED,IAAW,IAAI,CAAC,IAAI,EAAE,UAAU,EAS/B;IAED;;;;;;;OAOG;IACI,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAM3C,gBAAgB;IACT,QAAQ,CAAC,OAAO,EAAE,iBAAiB,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAc/D,gBAAgB;IACT,qBAAqB,CAAC,OAAO,EAAE,iBAAiB,GAAG,IAAI;IAI9D,gBAAgB;IACT,wBAAwB,IAAI,OAAO;IAI1C,gBAAgB;IAChB,SAAS,CAAC,eAAe,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI;IAI5D,IAAW,aAAa,IAAI,OAAO,CAElC;IAED,IAAW,aAAa,CAAC,aAAa,EAAE,OAAO,EAS9C;IAEM,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAM/B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;WAW3B,wBAAwB,CAAC,OAAO,EAAE,CAAC,MAAM,oBAAoB,CAAC,GAAG,IAAI,GAAG,IAAI;IAInF,YAAY,IAAI,IAAI;IASpB,eAAe,IAAI,IAAI;IAM9B,gBAAgB;IACT,4BAA4B,IAAI,OAAO;IAI9C,gBAAgB;IACT,wBAAwB,IAAI,UAAU;IAI7C,gBAAgB;IACT,qBAAqB,IAAI,SAAS,MAAM,EAAE;IAIjD,gBAAgB;IACT,uBAAuB,IAAI,UAAU;IAI5C,gBAAgB;IACT,8BAA8B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAIxG,gBAAgB;IACT,0BAA0B,IAAI,aAAa,GAAG,IAAI;IAIzD,gBAAgB;IACT,6BAA6B,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,aAAa;IAIlF,gBAAgB;IACT,4BAA4B,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAM3H,gBAAgB;IACT,0BAA0B,CAC/B,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,aAAa,EACrB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,IAAI,GACxB,IAAI;IAIP,gBAAgB;IACT,sBAAsB,CAC3B,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,aAAa,EACtB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,UAAU,GACpB,IAAI;IAIS,OAAO,IAAI,IAAI;IA8B/B,OAAO,CAAC,uBAAuB;IA6B/B,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,mBAAmB;IAU3B,OAAO,CAAC,oBAAoB;IAS5B,OAAO,CAAC,eAAe;CAWxB"}
+{"version":3,"file":"RenderNode.d.ts","sourceRoot":"","sources":["../../../src/rendering/RenderNode.ts"],"names":[],"mappings":"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"}