@codexo/exojs 0.8.4 → 0.10.0

package/dist/esm/rendering/plan/RenderScope.d.ts

@@ -0,0 +1,70 @@
+import type { Rectangle } from '@/math/Rectangle';
+import type { Filter } from '@/rendering/filters/Filter';
+import type { Geometry } from '@/rendering/geometry/Geometry';
+import type { MaskSource, RenderNode } from '@/rendering/RenderNode';
+import type { BlendModes } from '@/rendering/types';
+import type { DrawCommand, RenderEntryKind } from './RenderCommand';
+/**
+ * Geometric clip kind for a {@link RenderNode}'s `clip`/`clipShape`. Distinct
+ * from `maskSource` (alpha/visibility masking): `Rect` uses the GPU scissor
+ * fast path, `Stencil` writes a {@link Geometry} silhouette into the stencil
+ * buffer. `maskSource` continues to drive the separate alpha-mask machinery.
+ * @internal
+ */
+export declare const enum ClipKind {
+    None = 0,
+    Rect = 1,
+    Stencil = 2
+}
+/** @internal */
+export interface EffectDescriptor {
+    readonly filters: readonly Filter[];
+    readonly clip: ClipKind;
+    readonly clipShape: Rectangle | Geometry | null;
+    readonly maskSource: MaskSource;
+    readonly cacheAsBitmap: boolean;
+    readonly blendMode: BlendModes;
+}
+/** @internal */
+export interface DrawScopeEntry {
+    readonly kind: RenderEntryKind.Draw;
+    readonly seq: number;
+    readonly zIndex: number;
+    readonly command: DrawCommand;
+}
+/** @internal */
+export interface GroupScopeEntry {
+    readonly kind: RenderEntryKind.Group;
+    readonly seq: number;
+    readonly zIndex: number;
+    readonly scope: GroupScope;
+}
+/** @internal */
+export interface BarrierScopeEntry {
+    readonly kind: RenderEntryKind.Barrier;
+    readonly seq: number;
+    readonly zIndex: number;
+    readonly scope: BarrierScope;
+}
+/** @internal */
+export type ScopeEntry = DrawScopeEntry | GroupScopeEntry | BarrierScopeEntry;
+/** @internal */
+export interface GroupScope {
+    readonly kind: RenderEntryKind.Group;
+    entries: ScopeEntry[];
+    hasMixedZ: boolean;
+    preserveDrawOrder: boolean;
+}
+/** @internal */
+export interface BarrierScope {
+    readonly kind: RenderEntryKind.Barrier;
+    readonly node: RenderNode;
+    readonly effect: EffectDescriptor;
+    childPlan: GroupScope | null;
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/** @internal */
+export type RenderScope = GroupScope | BarrierScope;

package/dist/esm/rendering/plan/RenderScope.js

@@ -0,0 +1,16 @@
+/**
+ * Geometric clip kind for a {@link RenderNode}'s `clip`/`clipShape`. Distinct
+ * from `maskSource` (alpha/visibility masking): `Rect` uses the GPU scissor
+ * fast path, `Stencil` writes a {@link Geometry} silhouette into the stencil
+ * buffer. `maskSource` continues to drive the separate alpha-mask machinery.
+ * @internal
+ */
+var ClipKind;
+(function (ClipKind) {
+    ClipKind[ClipKind["None"] = 0] = "None";
+    ClipKind[ClipKind["Rect"] = 1] = "Rect";
+    ClipKind[ClipKind["Stencil"] = 2] = "Stencil";
+})(ClipKind || (ClipKind = {}));
+
+export { ClipKind };
+//# sourceMappingURL=RenderScope.js.map

package/dist/esm/rendering/plan/RenderScope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RenderScope.js","sources":["../../../../../src/rendering/plan/RenderScope.ts"],"sourcesContent":[null],"names":[],"mappings":"AAQA;;;;;;AAMG;IACe;AAAlB,CAAA,UAAkB,QAAQ,EAAA;AACxB,IAAA,QAAA,CAAA,QAAA,CAAA,MAAA,CAAA,GAAA,CAAA,CAAA,GAAA,MAAI;AACJ,IAAA,QAAA,CAAA,QAAA,CAAA,MAAA,CAAA,GAAA,CAAA,CAAA,GAAA,MAAI;AACJ,IAAA,QAAA,CAAA,QAAA,CAAA,SAAA,CAAA,GAAA,CAAA,CAAA,GAAA,SAAO;AACT,CAAC,EAJiB,QAAQ,KAAR,QAAQ,GAAA,EAAA,CAAA,CAAA;;;;"}

package/dist/esm/rendering/plan/playRenderTree.d.ts

@@ -0,0 +1,4 @@
+import type { RenderBackend } from '@/rendering/RenderBackend';
+import type { RenderNode } from '@/rendering/RenderNode';
+/** @internal — single source of truth for plan build→optimize→play. */
+export declare function playRenderTree(node: RenderNode, backend: RenderBackend): void;

package/dist/esm/rendering/plan/playRenderTree.js

@@ -0,0 +1,19 @@
+import { RenderPlanBuilder } from './RenderPlanBuilder.js';
+import { RenderPlanOptimizer } from './RenderPlanOptimizer.js';
+import { RenderPlanPlayer } from './RenderPlanPlayer.js';
+
+/** @internal — single source of truth for plan build→optimize→play. */
+function playRenderTree(node, backend) {
+    const builder = RenderPlanBuilder.acquire();
+    try {
+        const plan = builder.build(node, backend);
+        RenderPlanOptimizer.optimize(plan);
+        RenderPlanPlayer.play(plan, backend);
+    }
+    finally {
+        RenderPlanBuilder.release(builder);
+    }
+}
+
+export { playRenderTree };
+//# sourceMappingURL=playRenderTree.js.map

package/dist/esm/rendering/plan/playRenderTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"playRenderTree.js","sources":["../../../../../src/rendering/plan/playRenderTree.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAOA;AACM,SAAU,cAAc,CAAC,IAAgB,EAAE,OAAsB,EAAA;AACrE,IAAA,MAAM,OAAO,GAAG,iBAAiB,CAAC,OAAO,EAAE;AAE3C,IAAA,IAAI;QACF,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC;AAEzC,QAAA,mBAAmB,CAAC,QAAQ,CAAC,IAAI,CAAC;AAClC,QAAA,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC;IACtC;YAAU;AACR,QAAA,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC;IACpC;AACF;;;;"}

package/dist/esm/rendering/shader/Shader.d.ts

@@ -24,6 +24,7 @@ export interface ShaderProgram {
  * {@link ShaderProgram} with populated {@link attributes} and {@link uniforms} maps.
  * Call {@link bind} before draw calls and {@link sync} after updating uniform values.
  * Both maps are cleared on {@link disconnect} and {@link destroy}.
+ * @advanced
  */
 export declare class Shader {
     /** Vertex attribute metadata populated by the backend after {@link connect}. */

package/dist/esm/rendering/shader/Shader.js

@@ -5,6 +5,7 @@
  * {@link ShaderProgram} with populated {@link attributes} and {@link uniforms} maps.
  * Call {@link bind} before draw calls and {@link sync} after updating uniform values.
  * Both maps are cleared on {@link disconnect} and {@link destroy}.
+ * @advanced
  */
 class Shader {
     /** Vertex attribute metadata populated by the backend after {@link connect}. */

package/dist/esm/rendering/shader/Shader.js.map

@@ -1 +1 @@
-{"version":3,"file":"Shader.js","sources":["../../../../../src/rendering/shader/Shader.ts"],"sourcesContent":[null],"names":[],"mappings":"AAqBA;;;;;;;AAOG;MACU,MAAM,CAAA;;AAED,IAAA,UAAU,GAAiC,IAAI,GAAG,EAA2B;;AAE7E,IAAA,QAAQ,GAA+B,IAAI,GAAG,EAAyB;AAEtE,IAAA,aAAa;AACb,IAAA,eAAe;IACxB,QAAQ,GAAyB,IAAI;IAE7C,WAAA,CAAmB,YAAoB,EAAE,cAAsB,EAAA;AAC7D,QAAA,IAAI,CAAC,aAAa,GAAG,YAAY;AACjC,QAAA,IAAI,CAAC,eAAe,GAAG,cAAc;IACvC;AAEA,IAAA,IAAW,YAAY,GAAA;QACrB,OAAO,IAAI,CAAC,aAAa;IAC3B;AAEA,IAAA,IAAW,cAAc,GAAA;QACvB,OAAO,IAAI,CAAC,eAAe;IAC7B;AAEA;;;AAGG;AACI,IAAA,OAAO,CAAC,OAAsB,EAAA;AACnC,QAAA,IAAI,CAAC,QAAQ,GAAG,OAAO;AACvB,QAAA,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;AAExB,QAAA,OAAO,IAAI;IACb;IAEO,UAAU,GAAA;AACf,QAAA,IAAI,CAAC,QAAQ,GAAG,IAAI;AACpB,QAAA,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE;AACvB,QAAA,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE;AAErB,QAAA,OAAO,IAAI;IACb;IAEO,IAAI,GAAA;AACT,QAAA,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC;AAEzB,QAAA,OAAO,IAAI;IACb;IAEO,MAAM,GAAA;AACX,QAAA,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC;AAE3B,QAAA,OAAO,IAAI;IACb;AAEA;;;AAGG;IACI,IAAI,GAAA;AACT,QAAA,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC;AAEzB,QAAA,OAAO,IAAI;IACb;AAEA;;;AAGG;AACI,IAAA,YAAY,CAAC,IAAY,EAAA;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;QAE3C,IAAI,CAAC,SAAS,EAAE;AACd,YAAA,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,CAAA,mBAAA,CAAqB,CAAC;QAC1D;AAEA,QAAA,OAAO,SAAS;IAClB;AAEA;;;AAGG;AACI,IAAA,UAAU,CAAC,IAAY,EAAA;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;QAEvC,IAAI,CAAC,OAAO,EAAE;AACZ,YAAA,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,CAAA,mBAAA,CAAqB,CAAC;QACxD;AAEA,QAAA,OAAO,OAAO;IAChB;IAEO,OAAO,GAAA;AACZ,QAAA,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC;AAC5B,QAAA,IAAI,CAAC,QAAQ,GAAG,IAAI;AACpB,QAAA,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE;AACvB,QAAA,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE;IACvB;AACD;;;;"}
+{"version":3,"file":"Shader.js","sources":["../../../../../src/rendering/shader/Shader.ts"],"sourcesContent":[null],"names":[],"mappings":"AAqBA;;;;;;;;AAQG;MACU,MAAM,CAAA;;AAED,IAAA,UAAU,GAAiC,IAAI,GAAG,EAA2B;;AAE7E,IAAA,QAAQ,GAA+B,IAAI,GAAG,EAAyB;AAEtE,IAAA,aAAa;AACb,IAAA,eAAe;IACxB,QAAQ,GAAyB,IAAI;IAE7C,WAAA,CAAmB,YAAoB,EAAE,cAAsB,EAAA;AAC7D,QAAA,IAAI,CAAC,aAAa,GAAG,YAAY;AACjC,QAAA,IAAI,CAAC,eAAe,GAAG,cAAc;IACvC;AAEA,IAAA,IAAW,YAAY,GAAA;QACrB,OAAO,IAAI,CAAC,aAAa;IAC3B;AAEA,IAAA,IAAW,cAAc,GAAA;QACvB,OAAO,IAAI,CAAC,eAAe;IAC7B;AAEA;;;AAGG;AACI,IAAA,OAAO,CAAC,OAAsB,EAAA;AACnC,QAAA,IAAI,CAAC,QAAQ,GAAG,OAAO;AACvB,QAAA,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;AAExB,QAAA,OAAO,IAAI;IACb;IAEO,UAAU,GAAA;AACf,QAAA,IAAI,CAAC,QAAQ,GAAG,IAAI;AACpB,QAAA,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE;AACvB,QAAA,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE;AAErB,QAAA,OAAO,IAAI;IACb;IAEO,IAAI,GAAA;AACT,QAAA,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC;AAEzB,QAAA,OAAO,IAAI;IACb;IAEO,MAAM,GAAA;AACX,QAAA,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC;AAE3B,QAAA,OAAO,IAAI;IACb;AAEA;;;AAGG;IACI,IAAI,GAAA;AACT,QAAA,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC;AAEzB,QAAA,OAAO,IAAI;IACb;AAEA;;;AAGG;AACI,IAAA,YAAY,CAAC,IAAY,EAAA;QAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;QAE3C,IAAI,CAAC,SAAS,EAAE;AACd,YAAA,MAAM,IAAI,KAAK,CAAC,cAAc,IAAI,CAAA,mBAAA,CAAqB,CAAC;QAC1D;AAEA,QAAA,OAAO,SAAS;IAClB;AAEA;;;AAGG;AACI,IAAA,UAAU,CAAC,IAAY,EAAA;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;QAEvC,IAAI,CAAC,OAAO,EAAE;AACZ,YAAA,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,CAAA,mBAAA,CAAqB,CAAC;QACxD;AAEA,QAAA,OAAO,OAAO;IAChB;IAEO,OAAO,GAAA;AACZ,QAAA,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,IAAI,CAAC;AAC5B,QAAA,IAAI,CAAC,QAAQ,GAAG,IAAI;AACpB,QAAA,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE;AACvB,QAAA,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE;IACvB;AACD;;;;"}

package/dist/esm/rendering/shader/ShaderUniform.d.ts

@@ -7,6 +7,7 @@ import type { TypedArray } from '@/core/types';
  * clears it via {@link markClean} after uploading the value to the GPU.
  * Array-type uniform names have their index suffix stripped (e.g. `uColors[0]`
  * becomes `uColors`).
+ * @advanced
  */
 export declare class ShaderUniform {
     /** Zero-based index of this uniform within the shader program. */

package/dist/esm/rendering/shader/ShaderUniform.js

@@ -6,6 +6,7 @@
  * clears it via {@link markClean} after uploading the value to the GPU.
  * Array-type uniform names have their index suffix stripped (e.g. `uColors[0]`
  * becomes `uColors`).
+ * @advanced
  */
 class ShaderUniform {
     /** Zero-based index of this uniform within the shader program. */

package/dist/esm/rendering/shader/ShaderUniform.js.map

@@ -1 +1 @@
-{"version":3,"file":"ShaderUniform.js","sources":["../../../../../src/rendering/shader/ShaderUniform.ts"],"sourcesContent":[null],"names":[],"mappings":"AAEA;;;;;;;;AAQG;MACU,aAAa,CAAA;;AAER,IAAA,KAAK;;AAEL,IAAA,IAAI;;AAEJ,IAAA,IAAI;;AAEJ,IAAA,IAAI;AAEH,IAAA,MAAM;IACf,MAAM,GAAG,IAAI;IAErB,WAAA,CAAmB,KAAa,EAAE,IAAY,EAAE,IAAY,EAAE,IAAY,EAAE,IAAgB,EAAA;QAC1F,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;AACtC,QAAA,IAAI,CAAC,KAAK,GAAG,KAAK;AAClB,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI;AAChB,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI;AAChB,QAAA,IAAI,CAAC,MAAM,GAAG,IAAI;IACpB;AAEA;;;;AAIG;AACH,IAAA,IAAW,QAAQ,GAAA;AACjB,QAAA,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5D;AAEA,IAAA,IAAW,KAAK,GAAA;QACd,OAAO,IAAI,CAAC,MAAM;IACpB;;AAGA,IAAA,IAAW,KAAK,GAAA;QACd,OAAO,IAAI,CAAC,MAAM;IACpB;AAEA;;;AAGG;AACI,IAAA,QAAQ,CAAC,KAAiB,EAAA;AAC/B,QAAA,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;AACtB,QAAA,IAAI,CAAC,MAAM,GAAG,IAAI;AAElB,QAAA,OAAO,IAAI;IACb;AAEA;;;AAGG;IACI,SAAS,GAAA;AACd,QAAA,IAAI,CAAC,MAAM,GAAG,KAAK;IACrB;IAEO,OAAO,GAAA;;IAEd;AACD;;;;"}
+{"version":3,"file":"ShaderUniform.js","sources":["../../../../../src/rendering/shader/ShaderUniform.ts"],"sourcesContent":[null],"names":[],"mappings":"AAEA;;;;;;;;;AASG;MACU,aAAa,CAAA;;AAER,IAAA,KAAK;;AAEL,IAAA,IAAI;;AAEJ,IAAA,IAAI;;AAEJ,IAAA,IAAI;AAEH,IAAA,MAAM;IACf,MAAM,GAAG,IAAI;IAErB,WAAA,CAAmB,KAAa,EAAE,IAAY,EAAE,IAAY,EAAE,IAAY,EAAE,IAAgB,EAAA;QAC1F,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;AACtC,QAAA,IAAI,CAAC,KAAK,GAAG,KAAK;AAClB,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI;AAChB,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI;AAChB,QAAA,IAAI,CAAC,MAAM,GAAG,IAAI;IACpB;AAEA;;;;AAIG;AACH,IAAA,IAAW,QAAQ,GAAA;AACjB,QAAA,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5D;AAEA,IAAA,IAAW,KAAK,GAAA;QACd,OAAO,IAAI,CAAC,MAAM;IACpB;;AAGA,IAAA,IAAW,KAAK,GAAA;QACd,OAAO,IAAI,CAAC,MAAM;IACpB;AAEA;;;AAGG;AACI,IAAA,QAAQ,CAAC,KAAiB,EAAA;AAC/B,QAAA,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;AACtB,QAAA,IAAI,CAAC,MAAM,GAAG,IAAI;AAElB,QAAA,OAAO,IAAI;IACb;AAEA;;;AAGG;IACI,SAAS,GAAA;AACd,QAAA,IAAI,CAAC,MAAM,GAAG,KAAK;IACrB;IAEO,OAAO,GAAA;;IAEd;AACD;;;;"}

package/dist/esm/rendering/sprite/Sprite.d.ts

@@ -2,6 +2,7 @@ import { Interval } from '@/math/Interval';
 import { Rectangle } from '@/math/Rectangle';
 import { Vector } from '@/math/Vector';
 import { Drawable } from '@/rendering/Drawable';
+import type { SpriteMaterial } from '@/rendering/material/SpriteMaterial';
 import type { RenderTexture } from '@/rendering/texture/RenderTexture';
 import type { Texture } from '@/rendering/texture/Texture';
 /**
@@ -37,10 +38,12 @@ export declare enum SpriteFlags {
  * or frame changes, making repeated read access free after the first evaluation.
  * Collision helpers — `contains`, `getNormals`, `project` — are overridden to
  * operate on the exact rotated quad rather than the AABB.
+ * @stable
  */
 export declare class Sprite extends Drawable {
     private _texture;
     private _textureFrame;
+    private _material;
     private _vertices;
     private _texCoords;
     private readonly _normals;
@@ -49,6 +52,16 @@ export declare class Sprite extends Drawable {
     set texture(texture: Texture | RenderTexture | null);
     get textureFrame(): Rectangle;
     set textureFrame(frame: Rectangle);
+    /**
+     * Custom material giving this sprite its own fragment program, uniforms, and
+     * extra texture bindings, or `null` for the default multi-texture sprite path.
+     *
+     * Sprites that share the same material instance and base texture still batch
+     * into a single instanced draw call; the base texture stays on the sprite and
+     * is bound per batch. Assigning a non-sprite material throws.
+     */
+    get material(): SpriteMaterial | null;
+    set material(material: SpriteMaterial | null);
     get width(): number;
     set width(value: number);
     get height(): number;
@@ -66,7 +79,16 @@ export declare class Sprite extends Drawable {
      * texture is assigned.
      */
     get texCoords(): Uint32Array;
-    /** Assign a new texture, refreshing the texture frame to the full texture dimensions. */
+    /**
+     * Assign a new texture, refreshing the texture frame to the full texture dimensions.
+     *
+     * Does **not** bump the texture's version. That signal means "the source data
+     * has been mutated"; replacing the sprite's texture reference is not that.
+     * Bumping it here would force the backend to re-allocate the GPU texture on
+     * the next bind — destroying any FBO content already rendered into a
+     * {@link RenderTexture} (the cacheAsBitmap and filter capture pipelines).
+     * Call {@link updateTexture} explicitly when you mutate the source.
+     */
     setTexture(texture: Texture | RenderTexture | null): this;
     /** Signal the GPU backend that the underlying texture source has changed and reset the frame to full dimensions. */
     updateTexture(): this;
@@ -92,8 +114,8 @@ export declare class Sprite extends Drawable {
     project(axis: Vector, result?: Interval): Interval;
     /**
      * Return `true` if the world-space point (`x`, `y`) lies inside the quad.
-     * Uses a fast AABB check when the rotation is a multiple of 90°, and the
-     * exact dot-product test for arbitrary angles.
+     * Uses a fast AABB check for axis-aligned quads, and a cross-product sign
+     * test for rotated or skewed quads.
      */
     contains(x: number, y: number): boolean;
     /** @internal */

package/dist/esm/rendering/sprite/Sprite.js

@@ -38,10 +38,12 @@ var SpriteFlags;
  * or frame changes, making repeated read access free after the first evaluation.
  * Collision helpers — `contains`, `getNormals`, `project` — are overridden to
  * operate on the exact rotated quad rather than the AABB.
+ * @stable
  */
 class Sprite extends Drawable {
     _texture = null;
     _textureFrame = new Rectangle();
+    _material = null;
     _vertices = new Float32Array(8);
     _texCoords = new Uint32Array(4);
     _normals = [new Vector(), new Vector(), new Vector(), new Vector()];
@@ -65,6 +67,24 @@ class Sprite extends Drawable {
     set textureFrame(frame) {
         this.setTextureFrame(frame);
     }
+    /**
+     * Custom material giving this sprite its own fragment program, uniforms, and
+     * extra texture bindings, or `null` for the default multi-texture sprite path.
+     *
+     * Sprites that share the same material instance and base texture still batch
+     * into a single instanced draw call; the base texture stays on the sprite and
+     * is bound per batch. Assigning a non-sprite material throws.
+     */
+    get material() {
+        return this._material;
+    }
+    set material(material) {
+        if (material !== null && material.target !== 'sprite') {
+            throw new Error(`Sprite requires a SpriteMaterial (got a ${material.target} material).`);
+        }
+        this._material = material;
+        this.invalidateCache();
+    }
     get width() {
         return Math.abs(this.scale.x) * this._textureFrame.width;
     }
@@ -130,11 +150,22 @@ class Sprite extends Drawable {
         }
         return this._texCoords;
     }
-    /** Assign a new texture, refreshing the texture frame to the full texture dimensions. */
+    /**
+     * Assign a new texture, refreshing the texture frame to the full texture dimensions.
+     *
+     * Does **not** bump the texture's version. That signal means "the source data
+     * has been mutated"; replacing the sprite's texture reference is not that.
+     * Bumping it here would force the backend to re-allocate the GPU texture on
+     * the next bind — destroying any FBO content already rendered into a
+     * {@link RenderTexture} (the cacheAsBitmap and filter capture pipelines).
+     * Call {@link updateTexture} explicitly when you mutate the source.
+     */
     setTexture(texture) {
         if (this._texture !== texture) {
             this._texture = texture;
-            this.updateTexture();
+            if (texture !== null) {
+                this.resetTextureFrame();
+            }
             this.invalidateCache();
         }
         return this;
@@ -160,7 +191,7 @@ class Sprite extends Drawable {
         const height = this.height;
         this._textureFrame.copy(frame);
         this.flags.push(SpriteFlags.TextureCoords);
-        this.localBounds.set(0, 0, frame.width, frame.height);
+        this.getLocalBounds().set(0, 0, frame.width, frame.height);
         this._invalidateBoundsCascade();
         if (resetSize) {
             this.width = frame.width;
@@ -221,22 +252,23 @@ class Sprite extends Drawable {
     }
     /**
      * Return `true` if the world-space point (`x`, `y`) lies inside the quad.
-     * Uses a fast AABB check when the rotation is a multiple of 90°, and the
-     * exact dot-product test for arbitrary angles.
+     * Uses a fast AABB check for axis-aligned quads, and a cross-product sign
+     * test for rotated or skewed quads.
      */
     contains(x, y) {
-        if (this.rotation % 90 === 0) {
+        if (this.isAlignedBox) {
             return this.getBounds().contains(x, y);
         }
-        const [x1, y1, x2, y2, x3, y3] = this.vertices;
-        const temp = Vector.temp;
-        const vecA = temp.set(x2 - x1, y2 - y1);
-        const dotA = vecA.dot(x - x1, y - y1);
-        const lenA = vecA.lengthSq;
-        const vecB = temp.set(x3 - x2, y3 - y2);
-        const dotB = vecB.dot(x - x2, y - y2);
-        const lenB = vecB.lengthSq;
-        return dotA > 0 && dotA <= lenA && dotB > 0 && dotB <= lenB;
+        const [x1, y1, x2, y2, x3, y3, x4, y4] = this.vertices;
+        // Cross-product sign consistency: all four edge × (P-vertex) cross
+        // products must share the same sign for P to lie inside the convex quad.
+        // This handles rotated rectangles and skewed parallelograms uniformly;
+        // the dual `>=0 || <=0` form also handles mirrored (negative-scale) quads.
+        const s1 = (x2 - x1) * (y - y1) - (y2 - y1) * (x - x1);
+        const s2 = (x3 - x2) * (y - y2) - (y3 - y2) * (x - x2);
+        const s3 = (x4 - x3) * (y - y3) - (y4 - y3) * (x - x3);
+        const s4 = (x1 - x4) * (y - y4) - (y1 - y4) * (x - x4);
+        return (s1 >= 0 && s2 >= 0 && s3 >= 0 && s4 >= 0) || (s1 <= 0 && s2 <= 0 && s3 <= 0 && s4 <= 0);
     }
     /** @internal */
     _invalidateSubtreeTransform() {
@@ -255,6 +287,7 @@ class Sprite extends Drawable {
         }
         this._textureFrame.destroy();
         this._texture = null;
+        this._material = null;
     }
 }
 RenderNode.setInternalSpriteFactory(() => new Sprite(null));

package/dist/esm/rendering/sprite/Sprite.js.map

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

package/dist/esm/rendering/sprite/spriteMaterialSources.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Canonical engine vertex stage for the custom {@link SpriteMaterial} path.
+ *
+ * @internal — not part of the public package surface. A custom `SpriteMaterial`
+ * customizes the **fragment** stage only; the vertex stage (quad-corner
+ * expansion, affine transform, UV unpacking) is owned by the renderer and stays
+ * instancing-critical. The sprite renderers consume these constants directly:
+ * `WebGl2SpriteRenderer` pairs {@link spriteVertexGlsl} with the material's
+ * fragment (ignoring any author-supplied `glsl.vertex`), and
+ * `WebGpuSpriteRenderer` prepends {@link spriteVertexWgsl} to the material's
+ * fragment WGSL. Both pin the per-instance attribute locations 0–5 and the
+ * projection binding exactly as the default sprite path does, so a custom
+ * material keeps the single `drawArraysInstanced` / `drawIndexed` batch.
+ *
+ * A custom fragment receives the interpolated `v_texcoord` and premultiplied
+ * `v_color`, plus the per-batch base texture bound as `u_texture` (WebGL2 unit 0
+ * / WGSL group(1) binding 0). Material uniforms and additional textures bind on
+ * top (WebGL2 units 1..N / WGSL group(2)).
+ */
+/**
+ * GLSL ES 3.00 vertex shader for the custom sprite-material path. Identical
+ * corner expansion and attribute contract to the default sprite vertex shader.
+ * @internal
+ */
+export declare const spriteVertexGlsl = "#version 300 es\nprecision highp float;\nprecision highp int;\n\n// Per-instance attributes (divisor = 1). Each Sprite contributes one entry\n// to the per-instance buffer; gl_VertexID 0..3 selects which corner of the\n// quad this invocation is computing.\nlayout(location = 0) in vec4 a_localBounds;     // left, top, right, bottom (local space)\nlayout(location = 1) in vec3 a_transformAB;     // a, b, x \u2014 first row of 2D affine\nlayout(location = 2) in vec3 a_transformCD;     // c, d, y \u2014 second row\nlayout(location = 3) in vec4 a_uvBounds;        // uMin, vMin, uMax, vMax (normalised, already flipY-swapped)\nlayout(location = 4) in vec4 a_color;           // RGBA tint\nlayout(location = 5) in uint a_textureSlot;\n\nuniform mat3 u_projection;\n\nout vec2 v_texcoord;\nout vec4 v_color;\nflat out uint v_textureSlot;\n\nvoid main(void) {\n    // gl_VertexID 0..3 \u2192 corner: 0=TL, 1=TR, 2=BL, 3=BR (TRIANGLE_STRIP order)\n    int vid = gl_VertexID;\n    int cornerX = vid & 1;\n    int cornerY = (vid >> 1) & 1;\n\n    float localX = (cornerX == 0) ? a_localBounds.x : a_localBounds.z;\n    float localY = (cornerY == 0) ? a_localBounds.y : a_localBounds.w;\n\n    float worldX = (a_transformAB.x * localX) + (a_transformAB.y * localY) + a_transformAB.z;\n    float worldY = (a_transformCD.x * localX) + (a_transformCD.y * localY) + a_transformCD.z;\n\n    gl_Position = vec4((u_projection * vec3(worldX, worldY, 1.0)).xy, 0.0, 1.0);\n\n    float u = (cornerX == 0) ? a_uvBounds.x : a_uvBounds.z;\n    float v = (cornerY == 0) ? a_uvBounds.y : a_uvBounds.w;\n    v_texcoord = vec2(u, v);\n\n    v_color = vec4(a_color.rgb * a_color.a, a_color.a);\n    v_textureSlot = a_textureSlot;\n}\n";
+/**
+ * WGSL vertex stage + shared bindings for the custom sprite-material path.
+ * Prepend to a material's fragment WGSL: it declares the per-instance
+ * `VertexInput` (locations 0–5), the `VertexOutput` a custom `@fragment`
+ * consumes, the group(0) projection uniform, the group(1) base texture and
+ * sampler (`u_texture` / `u_sampler`), and the `vertexMain` entry point. The
+ * fragment author adds their group(2) bindings and a `fragmentMain` reading
+ * `VertexOutput`.
+ * @internal
+ */
+export declare const spriteVertexWgsl = "\nstruct ProjectionUniforms {\n    matrix: mat4x4<f32>,\n};\n\n@group(0) @binding(0) var<uniform> projection: ProjectionUniforms;\n\n@group(1) @binding(0) var u_texture: texture_2d<f32>;\n@group(1) @binding(1) var u_sampler: sampler;\n\nstruct VertexInput {\n    @location(0) localBounds: vec4<f32>,\n    @location(1) transformAB: vec3<f32>,\n    @location(2) transformCD: vec3<f32>,\n    @location(3) uvBounds: vec4<f32>,\n    @location(4) color: vec4<f32>,\n    @location(5) textureSlot: u32,\n};\n\nstruct VertexOutput {\n    @builtin(position) position: vec4<f32>,\n    @location(0) texcoord: vec2<f32>,\n    @location(1) color: vec4<f32>,\n};\n\n@vertex\nfn vertexMain(input: VertexInput, @builtin(vertex_index) vid: u32) -> VertexOutput {\n    var output: VertexOutput;\n\n    let cornerX = ((vid + 1u) >> 1u) & 1u;\n    let cornerY = vid >> 1u;\n\n    let localX = select(input.localBounds.x, input.localBounds.z, cornerX == 1u);\n    let localY = select(input.localBounds.y, input.localBounds.w, cornerY == 1u);\n\n    let worldX = input.transformAB.x * localX + input.transformAB.y * localY + input.transformAB.z;\n    let worldY = input.transformCD.x * localX + input.transformCD.y * localY + input.transformCD.z;\n\n    output.position = projection.matrix * vec4<f32>(worldX, worldY, 0.0, 1.0);\n\n    let u = select(input.uvBounds.x, input.uvBounds.z, cornerX == 1u);\n    let v = select(input.uvBounds.y, input.uvBounds.w, cornerY == 1u);\n    output.texcoord = vec2<f32>(u, v);\n\n    output.color = vec4<f32>(input.color.rgb * input.color.a, input.color.a);\n\n    return output;\n}\n";

package/dist/esm/rendering/sprite/spriteMaterialSources.js

@@ -0,0 +1,128 @@
+/**
+ * Canonical engine vertex stage for the custom {@link SpriteMaterial} path.
+ *
+ * @internal — not part of the public package surface. A custom `SpriteMaterial`
+ * customizes the **fragment** stage only; the vertex stage (quad-corner
+ * expansion, affine transform, UV unpacking) is owned by the renderer and stays
+ * instancing-critical. The sprite renderers consume these constants directly:
+ * `WebGl2SpriteRenderer` pairs {@link spriteVertexGlsl} with the material's
+ * fragment (ignoring any author-supplied `glsl.vertex`), and
+ * `WebGpuSpriteRenderer` prepends {@link spriteVertexWgsl} to the material's
+ * fragment WGSL. Both pin the per-instance attribute locations 0–5 and the
+ * projection binding exactly as the default sprite path does, so a custom
+ * material keeps the single `drawArraysInstanced` / `drawIndexed` batch.
+ *
+ * A custom fragment receives the interpolated `v_texcoord` and premultiplied
+ * `v_color`, plus the per-batch base texture bound as `u_texture` (WebGL2 unit 0
+ * / WGSL group(1) binding 0). Material uniforms and additional textures bind on
+ * top (WebGL2 units 1..N / WGSL group(2)).
+ */
+/**
+ * GLSL ES 3.00 vertex shader for the custom sprite-material path. Identical
+ * corner expansion and attribute contract to the default sprite vertex shader.
+ * @internal
+ */
+const spriteVertexGlsl = `#version 300 es
+precision highp float;
+precision highp int;
+
+// Per-instance attributes (divisor = 1). Each Sprite contributes one entry
+// to the per-instance buffer; gl_VertexID 0..3 selects which corner of the
+// quad this invocation is computing.
+layout(location = 0) in vec4 a_localBounds;     // left, top, right, bottom (local space)
+layout(location = 1) in vec3 a_transformAB;     // a, b, x — first row of 2D affine
+layout(location = 2) in vec3 a_transformCD;     // c, d, y — second row
+layout(location = 3) in vec4 a_uvBounds;        // uMin, vMin, uMax, vMax (normalised, already flipY-swapped)
+layout(location = 4) in vec4 a_color;           // RGBA tint
+layout(location = 5) in uint a_textureSlot;
+
+uniform mat3 u_projection;
+
+out vec2 v_texcoord;
+out vec4 v_color;
+flat out uint v_textureSlot;
+
+void main(void) {
+    // gl_VertexID 0..3 → corner: 0=TL, 1=TR, 2=BL, 3=BR (TRIANGLE_STRIP order)
+    int vid = gl_VertexID;
+    int cornerX = vid & 1;
+    int cornerY = (vid >> 1) & 1;
+
+    float localX = (cornerX == 0) ? a_localBounds.x : a_localBounds.z;
+    float localY = (cornerY == 0) ? a_localBounds.y : a_localBounds.w;
+
+    float worldX = (a_transformAB.x * localX) + (a_transformAB.y * localY) + a_transformAB.z;
+    float worldY = (a_transformCD.x * localX) + (a_transformCD.y * localY) + a_transformCD.z;
+
+    gl_Position = vec4((u_projection * vec3(worldX, worldY, 1.0)).xy, 0.0, 1.0);
+
+    float u = (cornerX == 0) ? a_uvBounds.x : a_uvBounds.z;
+    float v = (cornerY == 0) ? a_uvBounds.y : a_uvBounds.w;
+    v_texcoord = vec2(u, v);
+
+    v_color = vec4(a_color.rgb * a_color.a, a_color.a);
+    v_textureSlot = a_textureSlot;
+}
+`;
+/**
+ * WGSL vertex stage + shared bindings for the custom sprite-material path.
+ * Prepend to a material's fragment WGSL: it declares the per-instance
+ * `VertexInput` (locations 0–5), the `VertexOutput` a custom `@fragment`
+ * consumes, the group(0) projection uniform, the group(1) base texture and
+ * sampler (`u_texture` / `u_sampler`), and the `vertexMain` entry point. The
+ * fragment author adds their group(2) bindings and a `fragmentMain` reading
+ * `VertexOutput`.
+ * @internal
+ */
+const spriteVertexWgsl = `
+struct ProjectionUniforms {
+    matrix: mat4x4<f32>,
+};
+
+@group(0) @binding(0) var<uniform> projection: ProjectionUniforms;
+
+@group(1) @binding(0) var u_texture: texture_2d<f32>;
+@group(1) @binding(1) var u_sampler: sampler;
+
+struct VertexInput {
+    @location(0) localBounds: vec4<f32>,
+    @location(1) transformAB: vec3<f32>,
+    @location(2) transformCD: vec3<f32>,
+    @location(3) uvBounds: vec4<f32>,
+    @location(4) color: vec4<f32>,
+    @location(5) textureSlot: u32,
+};
+
+struct VertexOutput {
+    @builtin(position) position: vec4<f32>,
+    @location(0) texcoord: vec2<f32>,
+    @location(1) color: vec4<f32>,
+};
+
+@vertex
+fn vertexMain(input: VertexInput, @builtin(vertex_index) vid: u32) -> VertexOutput {
+    var output: VertexOutput;
+
+    let cornerX = ((vid + 1u) >> 1u) & 1u;
+    let cornerY = vid >> 1u;
+
+    let localX = select(input.localBounds.x, input.localBounds.z, cornerX == 1u);
+    let localY = select(input.localBounds.y, input.localBounds.w, cornerY == 1u);
+
+    let worldX = input.transformAB.x * localX + input.transformAB.y * localY + input.transformAB.z;
+    let worldY = input.transformCD.x * localX + input.transformCD.y * localY + input.transformCD.z;
+
+    output.position = projection.matrix * vec4<f32>(worldX, worldY, 0.0, 1.0);
+
+    let u = select(input.uvBounds.x, input.uvBounds.z, cornerX == 1u);
+    let v = select(input.uvBounds.y, input.uvBounds.w, cornerY == 1u);
+    output.texcoord = vec2<f32>(u, v);
+
+    output.color = vec4<f32>(input.color.rgb * input.color.a, input.color.a);
+
+    return output;
+}
+`;
+
+export { spriteVertexGlsl, spriteVertexWgsl };
+//# sourceMappingURL=spriteMaterialSources.js.map

package/dist/esm/rendering/sprite/spriteMaterialSources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spriteMaterialSources.js","sources":["../../../../../src/rendering/sprite/spriteMaterialSources.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;AAkBG;AAEH;;;;AAIG;AACI,MAAM,gBAAgB,GAAG,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2ChC;;;;;;;;;AASG;AACI,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/esm/rendering/text/AbstractText.d.ts

@@ -0,0 +1,36 @@
+import { Drawable } from '@/rendering/Drawable';
+import type { TextSize } from './types';
+/**
+ * Base class for all text rendering nodes. Provides the common `text`
+ * property and the on-demand dirty protocol used by the renderer.
+ *
+ * Subclasses:
+ * - {@link Text} — runtime Canvas 2D / SDF rasterization
+ * - {@link BitmapText}  — offline pre-built atlas (BMFont / MSDF)
+ */
+export declare abstract class AbstractText extends Drawable {
+    protected _text: string;
+    constructor(text: string);
+    /** The string currently displayed by this node. */
+    get text(): string;
+    /**
+     * Pixel dimensions of the laid-out text block in local space.
+     * Used by the renderer to compute normalized gradient UVs.
+     */
+    get textBounds(): TextSize;
+    /**
+     * Consume any pending style mutations and apply them synchronously.
+     *
+     * The renderer calls this automatically before each draw, so manual
+     * calls are only needed when you require up-to-date geometry outside
+     * of a render pass (e.g. to measure bounds right after a style change).
+     */
+    syncDirty(): void;
+    /**
+     * Advance the node by `dt` milliseconds.
+     *
+     * Delegates to {@link syncDirty} — kept for manual game-loop patterns,
+     * but no longer required; the renderer applies pending changes automatically.
+     */
+    update(_dt: number): void;
+}