@codexo/exojs 0.6.8 → 0.6.9

package/CHANGELOG.md

@@ -4,6 +4,74 @@ All notable changes to ExoJS are documented in this file.
 
 The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.9] - 2026-05-02
+
+> **Heads-up — breaking change despite the patch number.** `Text`'s
+> internal architecture changed completely: glyph-quad meshing
+> against a runtime atlas instead of canvas2d-rasterize-as-Sprite.
+> The user-facing API for `text.text`, `text.style`, and standard
+> Drawable transforms (`position`, `rotation`, `scale`, etc.) is
+> unchanged, but `text.canvas`, `text.setCanvas`, `text.textureFrame`,
+> `text.getWordWrappedText`, and the `Text instanceof Sprite` check
+> are gone. Text is now `Text extends Container`, not Sprite.
+
+GPU font glyphs (Pixi-style runtime cache). Replaces the prior
+canvas-rasterize-the-whole-string-as-Sprite path with: rasterize
+each glyph once into a shared atlas Texture, build a single Mesh
+per Text whose quads sample the atlas. All Texts in the page share
+one atlas — memory-efficient at scale, single drawcall per Text.
+
+### Added
+
+- **`DynamicGlyphAtlas`** — public class. Constructor takes
+  `width = 1024, height = 1024`. Has `getGlyph(char, family, size,
+  weight, style) → GlyphInfo` (cached or rasterizes), `clear()` to
+  reset, and `texture` for binding to a Mesh. Internal shelf
+  bin-packing; throws on atlas-full (LRU eviction is V2).
+- **`layoutText(text, style, atlas)`** — pure function. Returns
+  `readonly GlyphPlacement[]` with one quad per visible glyph.
+  Handles `\n` line breaks and `align: 'left' | 'center' | 'right'`
+  alignment per `style.align`. Empty text returns `[]`.
+- **Types: `GlyphInfo`, `GlyphPlacement`, `GlyphKey`,
+  `TextAlignment`** — all exported for users who want to compose
+  their own atlas / layout pipelines.
+- **TextStyle gets `fillColor: Color`** (defaults to white, used
+  via mesh.tint after glyph rasterization), **`fontStyle: 'normal'
+  | 'italic'`**, and **`lineHeight: number`** (multiplied by
+  fontSize for line spacing, defaults to 1.2). `align` field is
+  now strongly typed as `TextAlignment`.
+
+### Changed
+
+- **`Text` extends `Container`** (was `Sprite`). It internally
+  manages a single `Mesh` child whose vertices/uvs/indices are
+  rebuilt on every `text` / `style` setter call. Empty string =
+  no internal mesh (no children).
+- **Glyphs always rasterize white**; `style.fillColor` becomes
+  `mesh.tint`. Changing fillColor is cheap (mesh-tint update only,
+  no atlas re-rasterization).
+
+### Removed
+
+- `Text.canvas` getter / setter, `Text.setCanvas(...)`,
+  `Text.textureFrame`, `Text.updateTexture(...)`,
+  `Text.getWordWrappedText(...)` — the old canvas2d path is gone.
+  Word-wrapping is V2; for now use `\n` for explicit line breaks.
+
+### Notes
+
+- Atlas is a process-wide singleton via `getDefaultGlyphAtlas()`
+  (internal helper, not a public function). All `Text` instances
+  share one atlas. Tests can reset it via `atlas.clear()`.
+- The atlas uses `OffscreenCanvas` when available, falls back to
+  `document.createElement('canvas')` (works in jsdom / older
+  browsers).
+- First-render of a never-seen glyph costs one canvas2d round-trip
+  + texture re-upload. Cached glyphs are zero-cost on subsequent
+  renders.
+- Per-character animation, MSDF rendering, word-wrap, BiDi, and
+  text outlines / drop-shadows are all V2.
+
 ## [0.6.8] - 2026-05-02
 
 > **Heads-up — breaking change despite the patch number.** Removes

package/dist/esm/index.js

@@ -70,7 +70,9 @@ export { ShaderUniform } from './rendering/shader/ShaderUniform.js';
 export { Sprite, SpriteFlags } from './rendering/sprite/Sprite.js';
 export { Spritesheet } from './rendering/sprite/Spritesheet.js';
 export { AnimatedSprite } from './rendering/sprite/AnimatedSprite.js';
+export { DynamicGlyphAtlas } from './rendering/text/DynamicGlyphAtlas.js';
 export { Text } from './rendering/text/Text.js';
+export { layoutText } from './rendering/text/TextLayout.js';
 export { TextStyle } from './rendering/text/TextStyle.js';
 export { RenderTexture } from './rendering/texture/RenderTexture.js';
 export { Sampler } from './rendering/texture/Sampler.js';

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

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

@@ -6,8 +6,11 @@ export * from './shader/ShaderUniform';
 export * from './sprite/Sprite';
 export * from './sprite/Spritesheet';
 export * from './sprite/AnimatedSprite';
+export * from './text/DynamicGlyphAtlas';
 export * from './text/Text';
+export * from './text/TextLayout';
 export * from './text/TextStyle';
+export * from './text/types';
 export * from './texture/RenderTexture';
 export * from './texture/Sampler';
 export * from './texture/Texture';

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

@@ -0,0 +1,33 @@
+import { Texture } from '@/rendering/texture/Texture';
+import type { GlyphInfo } from './types';
+/**
+ * A shared atlas that rasterizes glyphs on demand into an offscreen canvas
+ * and wraps it as a Texture for use by the Mesh-based Text renderer.
+ *
+ * Glyphs are always rasterized in white so that runtime tinting via
+ * `Mesh.tint` applies the fill color without requiring re-rasterization.
+ *
+ * Use `getDefaultGlyphAtlas()` from `atlas-singleton.ts` rather than
+ * constructing directly.
+ */
+export declare class DynamicGlyphAtlas {
+    readonly texture: Texture;
+    private readonly _canvas;
+    private readonly _ctx;
+    private readonly _packer;
+    private readonly _cache;
+    private readonly _width;
+    private readonly _height;
+    constructor(width?: number, height?: number);
+    /**
+     * Returns the cached GlyphInfo for the given character + font parameters,
+     * rasterizing it into the atlas if not already present.
+     */
+    getGlyph(char: string, family: string, size: number, weight: string | number, style: 'normal' | 'italic'): GlyphInfo;
+    /**
+     * Clears all cached glyphs and resets the atlas packer.
+     * The underlying canvas pixels are also cleared.
+     */
+    clear(): void;
+    private _rasterize;
+}

package/dist/esm/rendering/text/DynamicGlyphAtlas.js

@@ -0,0 +1,140 @@
+import { Texture } from '../texture/Texture.js';
+
+const glyphPadding = 2;
+class ShelfPacker {
+    _shelves = [];
+    _width;
+    _height;
+    constructor(width, height) {
+        this._width = width;
+        this._height = height;
+    }
+    insert(width, height) {
+        // Try existing shelves in order (ascending y)
+        for (const shelf of this._shelves) {
+            if (shelf.height >= height && shelf.cursorX + width <= this._width) {
+                const x = shelf.cursorX;
+                shelf.cursorX += width;
+                return { x, y: shelf.y };
+            }
+        }
+        // Create a new shelf at the bottom
+        const last = this._shelves[this._shelves.length - 1];
+        const bottomY = last === undefined ? 0 : last.y + last.height;
+        if (bottomY + height > this._height) {
+            throw new Error(`GlyphAtlas full — clear() and re-render, or instantiate with larger dims`);
+        }
+        this._shelves.push({ y: bottomY, height, cursorX: width });
+        return { x: 0, y: bottomY };
+    }
+    reset() {
+        this._shelves.length = 0;
+    }
+}
+/**
+ * A shared atlas that rasterizes glyphs on demand into an offscreen canvas
+ * and wraps it as a Texture for use by the Mesh-based Text renderer.
+ *
+ * Glyphs are always rasterized in white so that runtime tinting via
+ * `Mesh.tint` applies the fill color without requiring re-rasterization.
+ *
+ * Use `getDefaultGlyphAtlas()` from `atlas-singleton.ts` rather than
+ * constructing directly.
+ */
+class DynamicGlyphAtlas {
+    texture;
+    _canvas;
+    _ctx;
+    _packer;
+    _cache = new Map();
+    _width;
+    _height;
+    constructor(width = 1024, height = 1024) {
+        this._width = width;
+        this._height = height;
+        // Use OffscreenCanvas when available, fall back to HTMLCanvasElement.
+        // In jsdom / Node the global may be absent; createCanvas falls through
+        // to document.createElement which jsdom provides.
+        const canvas = typeof OffscreenCanvas !== 'undefined'
+            ? new OffscreenCanvas(width, height)
+            : document.createElement('canvas');
+        if ('width' in canvas) {
+            canvas.width = width;
+            canvas.height = height;
+        }
+        this._canvas = canvas;
+        const ctx = canvas.getContext('2d');
+        if (ctx === null) {
+            throw new Error('DynamicGlyphAtlas: could not obtain a 2D context.');
+        }
+        this._ctx = ctx;
+        this._packer = new ShelfPacker(width, height);
+        this.texture = new Texture(canvas);
+        this.texture.setSize(width, height);
+    }
+    /**
+     * Returns the cached GlyphInfo for the given character + font parameters,
+     * rasterizing it into the atlas if not already present.
+     */
+    getGlyph(char, family, size, weight, style) {
+        const key = `${char}:${family}:${size}:${weight}:${style}`;
+        const cached = this._cache.get(key);
+        if (cached !== undefined) {
+            return cached;
+        }
+        const info = this._rasterize(char, family, size, weight, style, key);
+        this._cache.set(key, info);
+        // Bump texture version so GPU backends re-upload the canvas data.
+        this.texture.updateSource();
+        return info;
+    }
+    /**
+     * Clears all cached glyphs and resets the atlas packer.
+     * The underlying canvas pixels are also cleared.
+     */
+    clear() {
+        this._cache.clear();
+        this._packer.reset();
+        this._ctx.clearRect(0, 0, this._width, this._height);
+        this.texture.updateSource();
+    }
+    // -----------------------------------------------------------------------
+    _rasterize(char, family, size, weight, fontStyle, _key) {
+        const ctx = this._ctx;
+        const padding = glyphPadding;
+        ctx.font = `${fontStyle} ${weight} ${size}px ${family}`;
+        ctx.textBaseline = 'alphabetic';
+        ctx.fillStyle = '#ffffff';
+        const metrics = ctx.measureText(char);
+        const ascent = Math.ceil(metrics.fontBoundingBoxAscent
+            ?? metrics.actualBoundingBoxAscent
+            ?? size * 0.8);
+        const descent = Math.ceil(metrics.fontBoundingBoxDescent
+            ?? metrics.actualBoundingBoxDescent
+            ?? size * 0.2);
+        const advance = metrics.width;
+        const glyphWidth = Math.max(1, Math.ceil((metrics.actualBoundingBoxLeft ?? 0) + (metrics.actualBoundingBoxRight ?? 0)) || Math.ceil(advance));
+        const glyphHeight = Math.max(1, ascent + descent);
+        const slotW = glyphWidth + padding * 2;
+        const slotH = glyphHeight + padding * 2;
+        const slot = this._packer.insert(slotW, slotH);
+        // Draw the glyph white into the atlas slot
+        ctx.fillText(char, slot.x + padding + (metrics.actualBoundingBoxLeft ?? 0), slot.y + padding + ascent);
+        const info = {
+            x: slot.x,
+            y: slot.y,
+            width: glyphWidth,
+            height: glyphHeight,
+            advance,
+            ascent,
+            uvLeft: slot.x / this._width,
+            uvTop: slot.y / this._height,
+            uvRight: (slot.x + slotW) / this._width,
+            uvBottom: (slot.y + slotH) / this._height,
+        };
+        return info;
+    }
+}
+
+export { DynamicGlyphAtlas };
+//# sourceMappingURL=DynamicGlyphAtlas.js.map

package/dist/esm/rendering/text/DynamicGlyphAtlas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DynamicGlyphAtlas.js","sources":["../../../../../src/rendering/text/DynamicGlyphAtlas.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAGA,MAAM,YAAY,GAAG,CAAC;AAatB,MAAM,WAAW,CAAA;IACI,QAAQ,GAAiB,EAAE;AAC3B,IAAA,MAAM;AACN,IAAA,OAAO;IAExB,WAAA,CAAmB,KAAa,EAAE,MAAc,EAAA;AAC5C,QAAA,IAAI,CAAC,MAAM,GAAG,KAAK;AACnB,QAAA,IAAI,CAAC,OAAO,GAAG,MAAM;IACzB;IAEO,MAAM,CAAC,KAAa,EAAE,MAAc,EAAA;;AAEvC,QAAA,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE;AAC/B,YAAA,IAAI,KAAK,CAAC,MAAM,IAAI,MAAM,IAAI,KAAK,CAAC,OAAO,GAAG,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE;AAChE,gBAAA,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO;AAEvB,gBAAA,KAAK,CAAC,OAAO,IAAI,KAAK;gBAEtB,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE;YAC5B;QACJ;;AAGA,QAAA,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;AACpD,QAAA,MAAM,OAAO,GAAG,IAAI,KAAK,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM;QAE7D,IAAI,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE;AACjC,YAAA,MAAM,IAAI,KAAK,CACX,CAAA,wEAAA,CAA0E,CAC7E;QACL;AAEA,QAAA,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAE1D,OAAO,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE;IAC/B;IAEO,KAAK,GAAA;AACR,QAAA,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;IAC5B;AACH;AAED;;;;;;;;;AASG;MACU,iBAAiB,CAAA;AAEV,IAAA,OAAO;AAEN,IAAA,OAAO;AACP,IAAA,IAAI;AACJ,IAAA,OAAO;AACP,IAAA,MAAM,GAA6B,IAAI,GAAG,EAAE;AAC5C,IAAA,MAAM;AACN,IAAA,OAAO;AAExB,IAAA,WAAA,CAAmB,KAAK,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,EAAA;AAC1C,QAAA,IAAI,CAAC,MAAM,GAAG,KAAK;AACnB,QAAA,IAAI,CAAC,OAAO,GAAG,MAAM;;;;AAKrB,QAAA,MAAM,MAAM,GAAG,OAAO,eAAe,KAAK;AACtC,cAAE,IAAI,eAAe,CAAC,KAAK,EAAE,MAAM;AACnC,cAAE,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC;AAEtC,QAAA,IAAI,OAAO,IAAI,MAAM,EAAE;AAClB,YAAA,MAA4B,CAAC,KAAK,GAAG,KAAK;AAC1C,YAAA,MAA4B,CAAC,MAAM,GAAG,MAAM;QACjD;AAEA,QAAA,IAAI,CAAC,OAAO,GAAG,MAA2B;QAE1C,MAAM,GAAG,GAAI,MAA4B,CAAC,UAAU,CAAC,IAAI,CAA6B;AAEtF,QAAA,IAAI,GAAG,KAAK,IAAI,EAAE;AACd,YAAA,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC;QACxE;AAEA,QAAA,IAAI,CAAC,IAAI,GAAG,GAAG;QACf,IAAI,CAAC,OAAO,GAAG,IAAI,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC;QAC7C,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,MAA2B,CAAC;QACvD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;IACvC;AAEA;;;AAGG;IACI,QAAQ,CACX,IAAY,EACZ,MAAc,EACd,IAAY,EACZ,MAAuB,EACvB,KAA0B,EAAA;AAE1B,QAAA,MAAM,GAAG,GAAa,CAAA,EAAG,IAAI,CAAA,CAAA,EAAI,MAAM,CAAA,CAAA,EAAI,IAAI,CAAA,CAAA,EAAI,MAAM,CAAA,CAAA,EAAI,KAAK,EAAE;QACpE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;AAEnC,QAAA,IAAI,MAAM,KAAK,SAAS,EAAE;AACtB,YAAA,OAAO,MAAM;QACjB;AAEA,QAAA,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC;QAEpE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC;;AAG1B,QAAA,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE;AAE3B,QAAA,OAAO,IAAI;IACf;AAEA;;;AAGG;IACI,KAAK,GAAA;AACR,QAAA,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE;AACnB,QAAA,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE;AACpB,QAAA,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC;AACpD,QAAA,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE;IAC/B;;IAIQ,UAAU,CACd,IAAY,EACZ,MAAc,EACd,IAAY,EACZ,MAAuB,EACvB,SAA8B,EAC9B,IAAc,EAAA;AAEd,QAAA,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI;QACrB,MAAM,OAAO,GAAG,YAAY;AAE5B,QAAA,GAAG,CAAC,IAAI,GAAG,CAAA,EAAG,SAAS,CAAA,CAAA,EAAI,MAAM,CAAA,CAAA,EAAI,IAAI,CAAA,GAAA,EAAM,MAAM,CAAA,CAAE;AACvD,QAAA,GAAG,CAAC,YAAY,GAAG,YAAY;AAC/B,QAAA,GAAG,CAAC,SAAS,GAAG,SAAS;QAEzB,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC;QAErC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CACnB,OAA4D,CAAC;AAC3D,eAAA,OAAO,CAAC;eACR,IAAI,GAAG,GAAG,CAChB;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CACpB,OAA6D,CAAC;AAC5D,eAAA,OAAO,CAAC;eACR,IAAI,GAAG,GAAG,CAChB;AACD,QAAA,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK;AAC7B,QAAA,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CACvB,CAAC,EACD,IAAI,CAAC,IAAI,CACL,CAAC,OAAO,CAAC,qBAAqB,IAAI,CAAC,KAAK,OAAO,CAAC,sBAAsB,IAAI,CAAC,CAAC,CAC/E,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAC1B;AACD,QAAA,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;AAEjD,QAAA,MAAM,KAAK,GAAG,UAAU,GAAG,OAAO,GAAG,CAAC;AACtC,QAAA,MAAM,KAAK,GAAG,WAAW,GAAG,OAAO,GAAG,CAAC;AACvC,QAAA,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC;;QAG9C,GAAG,CAAC,QAAQ,CACR,IAAI,EACJ,IAAI,CAAC,CAAC,GAAG,OAAO,IAAI,OAAO,CAAC,qBAAqB,IAAI,CAAC,CAAC,EACvD,IAAI,CAAC,CAAC,GAAG,OAAO,GAAG,MAAM,CAC5B;AAED,QAAA,MAAM,IAAI,GAAc;YACpB,CAAC,EAAE,IAAI,CAAC,CAAC;YACT,CAAC,EAAE,IAAI,CAAC,CAAC;AACT,YAAA,KAAK,EAAE,UAAU;AACjB,YAAA,MAAM,EAAE,WAAW;YACnB,OAAO;YACP,MAAM;AACN,YAAA,MAAM,EAAE,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM;AAC5B,YAAA,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO;YAC5B,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,MAAM;YACvC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,KAAK,IAAI,IAAI,CAAC,OAAO;SAC5C;AAED,QAAA,OAAO,IAAI;IACf;AACH;;;;"}

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

@@ -1,26 +1,30 @@
-import { Sprite } from '@/rendering/sprite/Sprite';
+import { Container } from '@/rendering/Container';
 import type { TextStyleOptions } from './TextStyle';
 import { TextStyle } from './TextStyle';
-import type { SamplerOptions } from '@/rendering/texture/Sampler';
-import type { RenderBackend } from '../RenderBackend';
-export declare class Text extends Sprite {
+/**
+ * GPU-accelerated text node that rasterizes individual glyphs into a shared
+ * atlas ({@link DynamicGlyphAtlas}) and renders them as a single quad-per-
+ * glyph {@link Mesh} (one draw call per Text instance).
+ *
+ * Glyphs are always rasterized in white and tinted at runtime via
+ * `Mesh.tint`; changing `style.fillColor` only updates the mesh tint —
+ * no atlas re-rasterization is needed.
+ *
+ * The internal {@link Mesh} is the sole child of this {@link Container}.
+ * All transform properties (position, rotation, scale, origin) are
+ * inherited from {@link Container} → {@link RenderNode}.
+ */
+export declare class Text extends Container {
     private _text;
     private _style;
-    private _canvas;
-    private _context;
-    private _dirty;
-    constructor(text: string, style?: TextStyle | TextStyleOptions, samplerOptions?: Partial<SamplerOptions>, canvas?: HTMLCanvasElement);
+    private _mesh;
+    constructor(text: string, style?: TextStyle | TextStyleOptions);
     get text(): string;
-    set text(text: string);
+    set text(value: string);
     get style(): TextStyle;
-    set style(style: TextStyle);
-    get canvas(): HTMLCanvasElement;
-    set canvas(canvas: HTMLCanvasElement);
+    set style(style: TextStyle | TextStyleOptions);
     setText(text: string): this;
     setStyle(style: TextStyle | TextStyleOptions): this;
-    setCanvas(canvas: HTMLCanvasElement): this;
-    updateTexture(): this;
-    getWordWrappedText(): string;
-    render(backend: RenderBackend): this;
-    private _getContext;
+    destroy(): void;
+    private _rebuild;
 }

package/dist/esm/rendering/text/Text.js

@@ -1,29 +1,84 @@
-import { Sprite } from '../sprite/Sprite.js';
-import { Texture } from '../texture/Texture.js';
+import { Container } from '../Container.js';
+import { Mesh } from '../mesh/Mesh.js';
+import { getDefaultGlyphAtlas } from './atlas-singleton.js';
+import { layoutText } from './TextLayout.js';
 import { TextStyle } from './TextStyle.js';
-import { Rectangle } from '../../math/Rectangle.js';
-import { determineFontHeight } from '../utils.js';
 
-const newLinePattern = /(?:\r\n|\r|\n)/;
-class Text extends Sprite {
+function buildMesh(placements, style) {
+    const n = placements.length;
+    const vertices = new Float32Array(n * 4 * 2);
+    const uvs = new Float32Array(n * 4 * 2);
+    const indices = new Uint16Array(n * 6);
+    for (let i = 0; i < n; i++) {
+        const p = placements[i];
+        const v = i * 8;
+        const u = i * 8;
+        const idx = i * 6;
+        const baseV = i * 4;
+        // Vertices: TL, TR, BR, BL
+        vertices[v + 0] = p.x;
+        vertices[v + 1] = p.y;
+        vertices[v + 2] = p.x + p.width;
+        vertices[v + 3] = p.y;
+        vertices[v + 4] = p.x + p.width;
+        vertices[v + 5] = p.y + p.height;
+        vertices[v + 6] = p.x;
+        vertices[v + 7] = p.y + p.height;
+        // UVs: TL, TR, BR, BL
+        uvs[u + 0] = p.uvLeft;
+        uvs[u + 1] = p.uvTop;
+        uvs[u + 2] = p.uvRight;
+        uvs[u + 3] = p.uvTop;
+        uvs[u + 4] = p.uvRight;
+        uvs[u + 5] = p.uvBottom;
+        uvs[u + 6] = p.uvLeft;
+        uvs[u + 7] = p.uvBottom;
+        // Indices: [TL, TR, BR, TL, BR, BL]
+        indices[idx + 0] = baseV + 0;
+        indices[idx + 1] = baseV + 1;
+        indices[idx + 2] = baseV + 2;
+        indices[idx + 3] = baseV + 0;
+        indices[idx + 4] = baseV + 2;
+        indices[idx + 5] = baseV + 3;
+    }
+    const atlas = getDefaultGlyphAtlas();
+    const mesh = new Mesh({
+        vertices,
+        uvs,
+        indices,
+        texture: atlas.texture,
+    });
+    mesh.tint = style.fillColor;
+    return mesh;
+}
+/**
+ * GPU-accelerated text node that rasterizes individual glyphs into a shared
+ * atlas ({@link DynamicGlyphAtlas}) and renders them as a single quad-per-
+ * glyph {@link Mesh} (one draw call per Text instance).
+ *
+ * Glyphs are always rasterized in white and tinted at runtime via
+ * `Mesh.tint`; changing `style.fillColor` only updates the mesh tint —
+ * no atlas re-rasterization is needed.
+ *
+ * The internal {@link Mesh} is the sole child of this {@link Container}.
+ * All transform properties (position, rotation, scale, origin) are
+ * inherited from {@link Container} → {@link RenderNode}.
+ */
+class Text extends Container {
     _text;
     _style;
-    _canvas;
-    _context;
-    _dirty = true;
-    constructor(text, style, samplerOptions, canvas = document.createElement('canvas')) {
-        super(new Texture(canvas, samplerOptions));
+    _mesh = null;
+    constructor(text, style) {
+        super();
         this._text = text;
         this._style = (style && style instanceof TextStyle) ? style : new TextStyle(style);
-        this._canvas = canvas;
-        this._context = canvas.getContext('2d');
-        this.updateTexture();
+        this._rebuild();
     }
     get text() {
         return this._text;
     }
-    set text(text) {
-        this.setText(text);
+    set text(value) {
+        this.setText(value);
     }
     get style() {
         return this._style;
@@ -31,98 +86,43 @@ class Text extends Sprite {
     set style(style) {
         this.setStyle(style);
     }
-    get canvas() {
-        return this._canvas;
-    }
-    set canvas(canvas) {
-        this.setCanvas(canvas);
-    }
     setText(text) {
         if (this._text !== text) {
             this._text = text;
-            this._dirty = true;
+            this._rebuild();
         }
         return this;
     }
     setStyle(style) {
         this._style = (style instanceof TextStyle) ? style : new TextStyle(style);
-        this._dirty = true;
+        this._rebuild();
         return this;
     }
-    setCanvas(canvas) {
-        if (this._canvas !== canvas) {
-            this._canvas = canvas;
-            this._context = this._getContext(canvas);
-            this._dirty = true;
-            this.texture.setSource.call(this.texture, canvas);
-            this.setTextureFrame(Rectangle.temp.set(0, 0, canvas.width, canvas.height));
+    destroy() {
+        if (this._mesh !== null) {
+            this._mesh.destroy();
+            this._mesh = null;
         }
-        return this;
+        super.destroy();
     }
-    updateTexture() {
-        if (this._style && (this._dirty || this._style.dirty)) {
-            const canvas = this._canvas, context = this._context, style = this._style.apply(context), text = style.wordWrap ? this.getWordWrappedText() : this._text, lineHeight = determineFontHeight(context.font) + style.strokeThickness, lines = text.split(newLinePattern), lineMetrics = lines.map((line) => context.measureText(line)), maxLineWidth = lineMetrics.reduce((max, measure) => Math.max(max, measure.width), 0), canvasWidth = Math.ceil((maxLineWidth + style.strokeThickness) + (style.padding * 2)), canvasHeight = Math.ceil((lineHeight * lines.length) + (style.padding * 2));
-            if (canvasWidth !== canvas.width || canvasHeight !== canvas.height) {
-                canvas.width = canvasWidth;
-                canvas.height = canvasHeight;
-                this.setTextureFrame(Rectangle.temp.set(0, 0, canvasWidth, canvasHeight));
-            }
-            else {
-                context.clearRect(0, 0, canvasWidth, canvasHeight);
-            }
-            style.apply(context);
-            for (let i = 0; i < lines.length; i++) {
-                const metrics = lineMetrics[i], lineWidth = (maxLineWidth - metrics.width), offset = (style.align === 'right') ? lineWidth : lineWidth / 2, padding = style.padding + (style.strokeThickness / 2), lineX = metrics.actualBoundingBoxLeft + (style.align === 'left' ? 0 : offset) + padding, lineY = metrics.actualBoundingBoxAscent + (lineHeight * i) + padding;
-                if (style.stroke && style.strokeThickness) {
-                    context.strokeText(lines[i], lineX, lineY);
-                }
-                if (style.fill) {
-                    context.fillText(lines[i], lineX, lineY);
-                }
-            }
-            this.texture.updateSource();
-            this._dirty = false;
-            this._style.dirty = false;
+    // -----------------------------------------------------------------------
+    _rebuild() {
+        // Remove and discard the old mesh (if any).
+        if (this._mesh !== null) {
+            this.removeChild(this._mesh);
+            this._mesh.destroy();
+            this._mesh = null;
         }
-        return this;
-    }
-    getWordWrappedText() {
-        const context = this._context, wrapWidth = this._style.wordWrapWidth, lines = this._text.split('\n'), spaceWidth = context.measureText(' ').width;
-        let spaceLeft = wrapWidth, result = '';
-        for (let y = 0; y < lines.length; y++) {
-            const words = lines[y].split(' ');
-            if (y > 0) {
-                result += '\n';
-            }
-            for (let x = 0; x < words.length; x++) {
-                const word = words[x], wordWidth = context.measureText(word).width, pairWidth = wordWidth + spaceWidth;
-                if (pairWidth > spaceLeft) {
-                    if (x > 0) {
-                        result += '\n';
-                    }
-                    spaceLeft = wrapWidth;
-                }
-                else {
-                    spaceLeft -= pairWidth;
-                }
-                result += `${word} `;
-            }
-        }
-        return result;
-    }
-    render(backend) {
-        if (this.visible) {
-            this.updateTexture();
-            super.render(backend);
+        if (this._text.length === 0) {
+            return;
         }
-        return this;
-    }
-    _getContext(canvas) {
-        const context = canvas.getContext('2d');
-        if (context === null) {
-            throw new Error('Could not create a 2D canvas context.');
+        const atlas = getDefaultGlyphAtlas();
+        const placements = layoutText(this._text, this._style, atlas);
+        if (placements.length === 0) {
+            return;
         }
-        return context;
+        this._mesh = buildMesh(placements, this._style);
+        this.addChild(this._mesh);
     }
 }
 

package/dist/esm/rendering/text/Text.js.map

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

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

@@ -0,0 +1,13 @@
+import type { DynamicGlyphAtlas } from './DynamicGlyphAtlas';
+import type { GlyphPlacement } from './types';
+import type { TextStyle } from './TextStyle';
+/**
+ * Computes per-glyph quad placements for the given text and style.
+ *
+ * Handles `\n` line breaks and left/center/right alignment. No word-wrap,
+ * no RTL, no ligature shaping — Unicode/diacritics are delegated to the
+ * browser's font engine via canvas `fillText`.
+ *
+ * Returns an empty array for empty text.
+ */
+export declare function layoutText(text: string, style: TextStyle, atlas: DynamicGlyphAtlas): ReadonlyArray<GlyphPlacement>;