@codexo/exojs 0.8.3 → 0.9.0

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

@@ -1,32 +1,101 @@
-import { Container } from '@/rendering/Container';
+import { AbstractText } from './AbstractText';
+import type { AtlasMode } from './GlyphAtlas';
+import type { GlyphAtlas } from './GlyphAtlas';
+import { SDF_RADIUS } from './GlyphAtlas';
+import type { LayoutOptions } from './LayoutOptions';
 import type { TextStyleOptions } from './TextStyle';
 import { TextStyle } from './TextStyle';
+import type { TextPageQuads, TextSize } from './types';
+export type { TextPageQuads };
 /**
  * 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).
+ * per-font-variant {@link GlyphAtlas} using the SDF (Signed Distance Field)
+ * technique and renders them through the `text-sdf` shader.
  *
- * 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.
+ * Style mutations are applied automatically before the next draw — no manual
+ * `update()` call required. Mutating `text.style` any number of times in the
+ * same frame is cheap; the geometry is rebuilt at most once, on demand.
  *
- * 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}.
+ * ```ts
+ * const label = new Text('Hello', { fontSize: 24 });
+ * scene.addChild(label);
+ *
+ * label.style.fillColor = new Color(255, 0, 0);   // cheap — no atlas work
+ * label.style.outlineWidth = 0.08;     // cheap — only shader uniforms
+ * // changes are picked up automatically on the next render pass
+ * ```
+ *
+ * **FontFace-first:** load fonts via {@link FontFactory} before constructing
+ * the node, then pass the loaded `FontFace` via the `font` style option. The
+ * label renders immediately with the correct glyphs — no async waiting needed.
+ *
+ * ```ts
+ * const face = await loader.load(FontFactory, 'roboto.woff2', { family: 'Roboto' });
+ * const label = new Text('Score: 0', { font: face, fontSize: 24 });
+ * scene.addChild(label); // renders immediately with Roboto
+ * ```
+ *
+ * Enable colour-glyph (emoji) mode via `colorGlyphs: true` in the constructor
+ * options. Colour-glyph nodes use the `text-color` shader instead of `text-sdf`.
+ * @stable
  */
-export declare class Text extends Container {
-    private _text;
+export declare class Text extends AbstractText {
     private _style;
-    private _mesh;
-    constructor(text: string, style?: TextStyle | TextStyleOptions);
-    get text(): string;
-    set text(value: string);
+    private _layout;
+    private _colorGlyphs;
+    private _sdfRadius;
+    private _atlas;
+    private _destroyed;
+    private _faceLoadVersion;
+    /** Resolves when an in-flight FontFace load finishes. Null when no face load is pending. */
+    private _faceLoadPromise;
+    /** Per-page quad geometry built by `_rebuild()`. */
+    private _pageQuads;
+    private _textBounds;
+    constructor(text: string, style?: TextStyle | TextStyleOptions, layout?: LayoutOptions, options?: {
+        colorGlyphs?: boolean;
+        sdfRadius?: number;
+    });
     get style(): TextStyle;
-    set style(style: TextStyle | TextStyleOptions);
-    /** Replace the displayed string and rebuild the glyph mesh if the value changed. */
-    setText(text: string): this;
-    /** Replace the active style and rebuild the glyph mesh unconditionally. */
-    setStyle(style: TextStyle | TextStyleOptions): this;
+    set style(v: TextStyle | TextStyleOptions);
+    get text(): string;
+    set text(v: string);
+    get layout(): LayoutOptions;
+    set layout(v: LayoutOptions);
+    /**
+     * `true` if this node was constructed with `colorGlyphs: true`.
+     * Colour-glyph nodes use a RGBA atlas (emoji / colour fonts) and
+     * the `text-color` shader instead of `text-sdf`.
+     */
+    get colorGlyphs(): boolean;
+    /**
+     * SDF buffer radius (pixels) used when rasterizing glyphs for this node.
+     * Determines the maximum usable outline/shadow reach.
+     * Nodes with different radii use separate atlas instances.
+     */
+    get sdfRadius(): number;
+    /**
+     * The atlas mode used by this node: `'color'` for colour glyphs,
+     * `'sdf'` for standard text.
+     */
+    get atlasMode(): AtlasMode;
+    /** Per-page quad data consumed by the text renderer. */
+    get pageQuads(): readonly TextPageQuads[];
+    get textBounds(): TextSize;
+    /** The {@link GlyphAtlas} this node currently draws from. */
+    get atlas(): GlyphAtlas | null;
+    syncDirty(): void;
     destroy(): void;
+    /** Extract a {@link FontFace} from raw style options, or return null. */
+    private _extractFace;
+    /**
+     * Register `face` with `document.fonts` if needed, await its load, then
+     * clear the relevant atlas slice and rebuild geometry.
+     *
+     * Uses a version counter to discard stale loads when the style is replaced
+     * before the previous face finishes loading.
+     */
+    private _loadFace;
     private _rebuild;
 }
+export { SDF_RADIUS };

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

@@ -1,132 +1,207 @@
-import { Container } from '../Container.js';
-import { Mesh } from '../mesh/Mesh.js';
-import { getDefaultGlyphAtlas } from './atlas-singleton.js';
-import { layoutText } from './TextLayout.js';
+import { AbstractText } from './AbstractText.js';
+import { SDF_RADIUS } from './GlyphAtlas.js';
+import { getDefaultGlyphAtlasPool } from './GlyphAtlasPool.js';
+import { layoutText, buildTextPageQuads } from './TextLayout.js';
 import { TextStyle } from './TextStyle.js';
 
-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 indexBase = 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[indexBase + 0] = baseV + 0;
-        indices[indexBase + 1] = baseV + 1;
-        indices[indexBase + 2] = baseV + 2;
-        indices[indexBase + 3] = baseV + 0;
-        indices[indexBase + 4] = baseV + 2;
-        indices[indexBase + 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).
+ * per-font-variant {@link GlyphAtlas} using the SDF (Signed Distance Field)
+ * technique and renders them through the `text-sdf` shader.
+ *
+ * Style mutations are applied automatically before the next draw — no manual
+ * `update()` call required. Mutating `text.style` any number of times in the
+ * same frame is cheap; the geometry is rebuilt at most once, on demand.
+ *
+ * ```ts
+ * const label = new Text('Hello', { fontSize: 24 });
+ * scene.addChild(label);
+ *
+ * label.style.fillColor = new Color(255, 0, 0);   // cheap — no atlas work
+ * label.style.outlineWidth = 0.08;     // cheap — only shader uniforms
+ * // changes are picked up automatically on the next render pass
+ * ```
  *
- * 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.
+ * **FontFace-first:** load fonts via {@link FontFactory} before constructing
+ * the node, then pass the loaded `FontFace` via the `font` style option. The
+ * label renders immediately with the correct glyphs — no async waiting 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}.
+ * ```ts
+ * const face = await loader.load(FontFactory, 'roboto.woff2', { family: 'Roboto' });
+ * const label = new Text('Score: 0', { font: face, fontSize: 24 });
+ * scene.addChild(label); // renders immediately with Roboto
+ * ```
+ *
+ * Enable colour-glyph (emoji) mode via `colorGlyphs: true` in the constructor
+ * options. Colour-glyph nodes use the `text-color` shader instead of `text-sdf`.
+ * @stable
  */
-class Text extends Container {
-    _text;
+class Text extends AbstractText {
     _style;
-    _mesh = null;
-    constructor(text, style) {
-        super();
-        this._text = text;
-        this._style = style && style instanceof TextStyle ? style : new TextStyle(style);
-        this._rebuild();
+    _layout;
+    _colorGlyphs;
+    _sdfRadius;
+    _atlas = null;
+    _destroyed = false;
+    _faceLoadVersion = 0;
+    /** Resolves when an in-flight FontFace load finishes. Null when no face load is pending. */
+    _faceLoadPromise = null;
+    /** Per-page quad geometry built by `_rebuild()`. */
+    _pageQuads = [];
+    _textBounds = { width: 0, height: 0 };
+    constructor(text, style, layout, options = {}) {
+        super(text);
+        this._style = style instanceof TextStyle ? style : new TextStyle(style);
+        this._layout = layout ?? {};
+        this._colorGlyphs = options.colorGlyphs ?? false;
+        this._sdfRadius = options.sdfRadius ?? SDF_RADIUS;
+        if (!(style instanceof TextStyle) && style !== undefined) {
+            const face = this._extractFace(style);
+            if (face !== null)
+                this._faceLoadPromise = this._loadFace(face);
+        }
+        this._rebuild('font');
+    }
+    get style() {
+        return this._style;
+    }
+    set style(v) {
+        this._style = v instanceof TextStyle ? v : new TextStyle(v);
+        if (!(v instanceof TextStyle)) {
+            const face = this._extractFace(v);
+            if (face !== null)
+                this._faceLoadPromise = this._loadFace(face);
+        }
+        this._rebuild('font');
     }
     get text() {
         return this._text;
     }
-    set text(value) {
-        this.setText(value);
+    set text(v) {
+        if (this._text === v)
+            return;
+        this._text = v;
+        this._rebuild('layout');
     }
-    get style() {
-        return this._style;
+    get layout() {
+        return this._layout;
     }
-    set style(style) {
-        this.setStyle(style);
+    set layout(v) {
+        this._layout = v;
+        this._rebuild('layout');
     }
-    /** Replace the displayed string and rebuild the glyph mesh if the value changed. */
-    setText(text) {
-        if (this._text !== text) {
-            this._text = text;
-            this._rebuild();
-        }
-        return this;
+    /**
+     * `true` if this node was constructed with `colorGlyphs: true`.
+     * Colour-glyph nodes use a RGBA atlas (emoji / colour fonts) and
+     * the `text-color` shader instead of `text-sdf`.
+     */
+    get colorGlyphs() {
+        return this._colorGlyphs;
     }
-    /** Replace the active style and rebuild the glyph mesh unconditionally. */
-    setStyle(style) {
-        this._style = style instanceof TextStyle ? style : new TextStyle(style);
-        this._rebuild();
-        return this;
+    /**
+     * SDF buffer radius (pixels) used when rasterizing glyphs for this node.
+     * Determines the maximum usable outline/shadow reach.
+     * Nodes with different radii use separate atlas instances.
+     */
+    get sdfRadius() {
+        return this._sdfRadius;
     }
-    destroy() {
-        if (this._mesh !== null) {
-            this._mesh.destroy();
-            this._mesh = null;
+    /**
+     * The atlas mode used by this node: `'color'` for colour glyphs,
+     * `'sdf'` for standard text.
+     */
+    get atlasMode() {
+        return this._colorGlyphs ? 'color' : 'sdf';
+    }
+    /** Per-page quad data consumed by the text renderer. */
+    get pageQuads() {
+        return this._pageQuads;
+    }
+    get textBounds() {
+        return this._textBounds;
+    }
+    /** The {@link GlyphAtlas} this node currently draws from. */
+    get atlas() {
+        return this._atlas;
+    }
+    syncDirty() {
+        const hint = this._style.consumeDirty();
+        if (hint !== null && hint !== 'tint') {
+            this._rebuild(hint);
         }
+    }
+    destroy() {
+        this._destroyed = true;
+        this._faceLoadVersion++;
+        this._faceLoadPromise = null;
+        this._pageQuads = [];
+        this._atlas = null;
         super.destroy();
     }
-    // -----------------------------------------------------------------------
-    _rebuild() {
-        // Remove and discard the old mesh (if any).
-        if (this._mesh !== null) {
-            this.removeChild(this._mesh);
-            this._mesh.destroy();
-            this._mesh = null;
+    // ── Private ──────────────────────────────────────────────────────────────
+    /** Extract a {@link FontFace} from raw style options, or return null. */
+    _extractFace(opts) {
+        if (typeof FontFace === 'undefined')
+            return null;
+        if (opts.font instanceof FontFace)
+            return opts.font;
+        return null;
+    }
+    /**
+     * Register `face` with `document.fonts` if needed, await its load, then
+     * clear the relevant atlas slice and rebuild geometry.
+     *
+     * Uses a version counter to discard stale loads when the style is replaced
+     * before the previous face finishes loading.
+     */
+    async _loadFace(face) {
+        if (typeof document === 'undefined' || !document.fonts)
+            return;
+        const version = ++this._faceLoadVersion;
+        if (!document.fonts.has(face)) {
+            document.fonts.add(face);
+        }
+        try {
+            await face.load();
+        }
+        catch {
+            return;
         }
+        if (this._destroyed || version !== this._faceLoadVersion)
+            return;
+        const pool = getDefaultGlyphAtlasPool();
+        pool.getAtlas(this._style.fontFamily, this._style.fontStyle, this._style.fontWeight, this.atlasMode, this._sdfRadius).clear();
+        this._rebuild('font');
+    }
+    _rebuild(_hint) {
+        this._pageQuads = [];
+        this._textBounds = { width: 0, height: 0 };
         if (this._text.length === 0) {
+            this._style.consumeDirty();
             return;
         }
-        const atlas = getDefaultGlyphAtlas();
-        const placements = layoutText(this._text, this._style, atlas);
+        const pool = getDefaultGlyphAtlasPool();
+        const atlas = pool.getAtlas(this._style.fontFamily, this._style.fontStyle, this._style.fontWeight, this.atlasMode, this._sdfRadius);
+        this._atlas = atlas;
+        const placements = layoutText(this._text, this._style, this._layout, atlas);
         if (placements.length === 0) {
+            this._style.consumeDirty();
             return;
         }
-        this._mesh = buildMesh(placements, this._style);
-        this.addChild(this._mesh);
+        let maxX = 0, maxY = 0;
+        for (const p of placements) {
+            const px = p.x + p.width;
+            const py = p.y + p.height;
+            if (px > maxX)
+                maxX = px;
+            if (py > maxY)
+                maxY = py;
+        }
+        this._textBounds = { width: maxX, height: maxY };
+        this._pageQuads = buildTextPageQuads(placements);
+        this._style.consumeDirty();
     }
 }
 
-export { Text };
+export { SDF_RADIUS, Text };
 //# sourceMappingURL=Text.js.map

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

@@ -1,13 +1,25 @@
-import type { DynamicGlyphAtlas } from './DynamicGlyphAtlas';
-import type { TextStyle } from './TextStyle';
-import type { GlyphPlacement } from './types';
+import type { LayoutOptions } from './LayoutOptions';
+import type { GlyphPlacement, GlyphProvider, TextLayoutStyle, TextPageQuads, TextSize } from './types';
 /**
- * Computes per-glyph quad placements for the given text and style.
+ * Compute the bounding pixel dimensions of `text` without allocating quad
+ * placements. Returns `{ width: 0, height: 0 }` for empty text.
+ */
+export declare function measureText(text: string, style: TextLayoutStyle, provider: GlyphProvider): TextSize;
+/**
+ * Computes per-glyph quad placements for the given text, style, and layout
+ * options.
  *
- * 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`.
+ * Handles `\n` line breaks, left/center/right/justify alignment, `letterSpacing`,
+ * `leading`, `breakWords`, `whiteSpace` preprocessing, and optional kerning
+ * (if the provider implements `getKerning`). RTL and ligature shaping are out
+ * of scope; Unicode/diacritics are delegated to the browser's canvas engine.
  *
  * Returns an empty array for empty text.
  */
-export declare function layoutText(text: string, style: TextStyle, atlas: DynamicGlyphAtlas): readonly GlyphPlacement[];
+export declare function layoutText(text: string, style: TextLayoutStyle, layout: LayoutOptions, provider: GlyphProvider): readonly GlyphPlacement[];
+/**
+ * Convert {@link GlyphPlacement} arrays into per-atlas-page quad geometry
+ * ready for GPU upload. Zero-size placements (e.g. whitespace glyphs that
+ * have no atlas entry) are skipped.
+ */
+export declare function buildTextPageQuads(placements: readonly GlyphPlacement[]): TextPageQuads[];