@codexo/exojs 0.8.3 → 0.9.0

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

@@ -0,0 +1,220 @@
+/**
+ * Signed Distance Field generator for individual glyphs.
+ *
+ * Uses the Canvas 2D API to rasterize each character, then applies a 2D
+ * Euclidean Distance Transform (Felzenszwalb & Huttenlocher, 2012) to
+ * produce a single-channel R8 SDF buffer.
+ *
+ * Output encoding: 128/255 ≈ 0.502 is the glyph edge. Values above 0.5
+ * are inside the glyph, values below 0.5 are outside. The range encoded
+ * by the SDF extends `radius` pixels beyond the geometric edge.
+ *
+ * Compatible with `cutoff = 0.5` in the shader's `smoothstep(0.5 − soft, 0.5 + soft, sd)`.
+ */
+const inf = 1e20;
+/**
+ * SDF generator for a single font variant.
+ *
+ * Maintains an internal canvas that is resized per glyph and a set of reusable
+ * EDT working arrays that grow on demand (no per-call allocations once the
+ * largest glyph has been processed).
+ * @advanced
+ */
+class GlyphSdf {
+    _buffer;
+    _radius;
+    _cutoff;
+    _font;
+    _canvasW = 0;
+    _canvasH = 0;
+    _canvas;
+    _ctx;
+    // Reusable EDT working arrays — grown lazily.
+    _gridOuter = new Float64Array(0);
+    _gridInner = new Float64Array(0);
+    _f = new Float64Array(0);
+    _d = new Float64Array(0);
+    _z = new Float64Array(0);
+    _v = new Int16Array(0);
+    _out = new Uint8ClampedArray(0);
+    constructor(options) {
+        this._buffer = options.buffer ?? 8;
+        this._radius = options.radius ?? this._buffer;
+        this._cutoff = options.cutoff ?? 0.5;
+        const stylePart = options.fontStyle && options.fontStyle !== 'normal' ? `${options.fontStyle} ` : '';
+        const weight = options.fontWeight ?? 'normal';
+        this._font = `${stylePart}${weight} ${options.fontSize}px ${options.fontFamily}`;
+        if (typeof OffscreenCanvas !== 'undefined') {
+            const c = new OffscreenCanvas(1, 1);
+            this._canvas = c;
+            this._ctx = c.getContext('2d');
+        }
+        else {
+            const c = document.createElement('canvas');
+            this._canvas = c;
+            this._ctx = c.getContext('2d');
+        }
+    }
+    /**
+     * Rasterize `char` and compute its SDF.
+     *
+     * Returns a new {@link GlyphSdfResult} each call. The `data` buffer is a
+     * fresh `Uint8ClampedArray`; the caller may hold a reference to it safely
+     * across subsequent `draw()` calls.
+     */
+    draw(char) {
+        const ctx = this._ctx;
+        const buf = this._buffer;
+        // ── Measure ──────────────────────────────────────────────────────────
+        ctx.font = this._font;
+        ctx.textBaseline = 'alphabetic';
+        const m = ctx.measureText(char);
+        const advance = m.width;
+        // Canvas 2D `actualBoundingBoxLeft` is the distance from the text's
+        // left-alignment point going LEFT to the left edge of the glyph bounding
+        // box. For most LTR characters this is 0; italic fonts may have a small
+        // positive value (left overhang).
+        const bbLeft = Math.max(0, Math.ceil(m.actualBoundingBoxLeft ?? 0));
+        const bbRight = Math.max(0, Math.ceil(m.actualBoundingBoxRight ?? advance));
+        const bbAscent = Math.max(0, Math.ceil(m.fontBoundingBoxAscent ??
+            m.actualBoundingBoxAscent ??
+            0));
+        const bbDescent = Math.max(0, Math.ceil(m.fontBoundingBoxDescent ??
+            m.actualBoundingBoxDescent ??
+            0));
+        const glyphWidth = Math.max(1, bbLeft + bbRight);
+        const glyphHeight = Math.max(1, bbAscent + bbDescent);
+        const tileW = glyphWidth + 2 * buf;
+        const tileH = glyphHeight + 2 * buf;
+        // ── Resize canvas if the tile dimensions changed ───────────────────────
+        if (this._canvasW !== tileW || this._canvasH !== tileH) {
+            this._canvas.width = tileW;
+            this._canvas.height = tileH;
+            this._canvasW = tileW;
+            this._canvasH = tileH;
+        }
+        // ── Rasterize white glyph on transparent background ───────────────────
+        ctx.clearRect(0, 0, tileW, tileH);
+        ctx.fillStyle = '#ffffff';
+        // Position so glyph's left edge lands at x = buf and baseline at y = buf + bbAscent.
+        ctx.fillText(char, buf + bbLeft, buf + bbAscent);
+        const rgba = ctx.getImageData(0, 0, tileW, tileH).data;
+        const n = tileW * tileH;
+        // ── Grow working arrays lazily ────────────────────────────────────────
+        if (n > this._gridOuter.length) {
+            const maxDim = Math.max(tileW, tileH);
+            this._gridOuter = new Float64Array(n);
+            this._gridInner = new Float64Array(n);
+            this._f = new Float64Array(maxDim);
+            this._d = new Float64Array(maxDim);
+            this._z = new Float64Array(maxDim + 1);
+            this._v = new Int16Array(maxDim);
+        }
+        if (n > this._out.length) {
+            this._out = new Uint8ClampedArray(n);
+        }
+        // ── Initialise EDT grids from the alpha channel ───────────────────────
+        //
+        // gridOuter[i]: squared distance to the nearest fully-outside pixel
+        //               (0 for inside pixels, inf for outside pixels, blended for edges)
+        // gridInner[i]: squared distance to the nearest fully-inside pixel
+        //               (inf for inside pixels, 0 for outside pixels)
+        for (let i = 0; i < n; i++) {
+            const a = rgba[i * 4 + 3] / 255; // alpha 0..1 from the R channel (white glyph)
+            if (a === 1) {
+                this._gridOuter[i] = 0;
+                this._gridInner[i] = inf;
+            }
+            else if (a === 0) {
+                this._gridOuter[i] = inf;
+                this._gridInner[i] = 0;
+            }
+            else {
+                this._gridOuter[i] = Math.max(0, 0.5 - a) ** 2;
+                this._gridInner[i] = Math.max(0, a - 0.5) ** 2;
+            }
+        }
+        // ── Apply 2D EDT ──────────────────────────────────────────────────────
+        _edt2d(this._gridOuter, tileW, tileH, this._f, this._d, this._v, this._z);
+        _edt2d(this._gridInner, tileW, tileH, this._f, this._d, this._v, this._z);
+        // ── Normalise to R8 ───────────────────────────────────────────────────
+        //
+        // SDF value d = outer_dist − inner_dist:
+        //   d < 0 → inside glyph (inner_dist > 0, outer_dist = 0)
+        //   d = 0 → at glyph edge
+        //   d > 0 → outside glyph
+        //
+        // Mapping: value = clamp(round(255 − 255 × (d / radius + cutoff)), 0, 255)
+        // With cutoff = 0.5: edge (d=0) → 128, deep inside → 255, far outside → 0.
+        for (let i = 0; i < n; i++) {
+            const d = this._gridOuter[i] - this._gridInner[i];
+            this._out[i] = Math.max(0, Math.min(255, Math.round(255 - 255 * (d / this._radius + this._cutoff))));
+        }
+        return {
+            data: this._out.slice(0, n), // fresh copy so caller may hold the reference
+            width: tileW,
+            height: tileH,
+            glyphWidth,
+            glyphHeight,
+            glyphTop: buf, // glyph content starts buf px from tile top
+            glyphLeft: buf, // glyph content starts buf px from tile left
+            glyphAdvance: advance,
+        };
+    }
+}
+// ── EDT algorithm ─────────────────────────────────────────────────────────────
+// 2D Euclidean Distance Transform (Felzenszwalb & Huttenlocher, TPAMI 2012).
+// Applied separably: one pass per column, then one pass per row + sqrt.
+function _edt2d(data, width, height, f, d, v, z) {
+    // Vertical pass: transform along each column
+    for (let x = 0; x < width; x++) {
+        for (let y = 0; y < height; y++)
+            f[y] = data[y * width + x];
+        _edt1d(f, d, v, z, height);
+        for (let y = 0; y < height; y++)
+            data[y * width + x] = d[y];
+    }
+    // Horizontal pass + sqrt: transform along each row, then take sqrt
+    for (let y = 0; y < height; y++) {
+        for (let x = 0; x < width; x++)
+            f[x] = data[y * width + x];
+        _edt1d(f, d, v, z, width);
+        for (let x = 0; x < width; x++)
+            data[y * width + x] = Math.sqrt(d[x]);
+    }
+}
+/**
+ * 1D EDT (squared Euclidean distance) via the parabola-envelope algorithm.
+ * Writes squared distances into `d[0..n−1]` for the function values in `f`.
+ */
+function _edt1d(f, d, v, z, n) {
+    let k = 0;
+    v[0] = 0;
+    z[0] = -inf;
+    z[1] = inf;
+    for (let q = 1; q < n; q++) {
+        // Find the parabola intersection s (break-point) for site q.
+        let s;
+        do {
+            const r = v[k];
+            s = (f[q] + q * q - f[r] - r * r) / (2 * (q - r));
+            if (s > z[k])
+                break;
+            k--;
+        } while (k >= 0);
+        k++;
+        v[k] = q;
+        z[k] = s;
+        z[k + 1] = inf;
+    }
+    k = 0;
+    for (let q = 0; q < n; q++) {
+        while (z[k + 1] < q)
+            k++;
+        const r = v[k];
+        d[q] = (q - r) * (q - r) + f[r];
+    }
+}
+
+export { GlyphSdf };
+//# sourceMappingURL=GlyphSdf.js.map

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

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

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

@@ -0,0 +1,107 @@
+import { Container } from '@/rendering/Container';
+export type FontFormat = 'woff2' | 'woff' | 'ttf' | 'otf';
+export interface HTMLTextOptions {
+    /** CSS injected inside a <style> tag within the SVG foreignObject. */
+    css?: string;
+    /** Logical width in pixels. Default: 256 */
+    width?: number;
+    /** Logical height in pixels. Default: 128 */
+    height?: number;
+    /**
+     * Device-pixel ratio applied to the backing canvas.
+     * Values >1 produce a sharper texture at the cost of a larger canvas.
+     * Default: 1
+     */
+    resolution?: number;
+}
+/**
+ * Text node that renders arbitrary HTML+CSS into a canvas texture via an
+ * SVG `<foreignObject>` pass and displays the result as a textured quad.
+ *
+ * Full CSS typography and rich markup are supported. External resources
+ * (`<img src>`, `background-image: url(...)`) are **blocked** by browsers
+ * when loading SVG blob-URIs — inline those as base-64 data URIs.
+ *
+ * Custom web fonts must be registered with {@link addFont} before use;
+ * pass the raw font bytes (from {@link BinaryAsset} or a plain `fetch`):
+ *
+ * ```ts
+ * const bytes = await loader.load(BinaryAsset, 'roboto.woff2');
+ * htmlText.addFont('Roboto', bytes, 'woff2');
+ * ```
+ *
+ * The HTML must be valid XHTML (tags closed, `&amp;` for `&`, etc.)
+ * because it is embedded inside an XML document.
+ *
+ * @example
+ * ```ts
+ * const label = new HTMLText(
+ *   '<b>Score</b>: <span style="color:gold">9999</span>',
+ *   { width: 200, height: 40, css: 'body { font: 20px Arial; color: white; }' },
+ * );
+ * scene.addChild(label);
+ * await label.ready; // optional — wait for first render
+ * ```
+ * @stable
+ */
+export declare class HTMLText extends Container {
+    private _html;
+    private _css;
+    private _width;
+    private _height;
+    private _resolution;
+    private _canvas;
+    private _ctx;
+    private _texture;
+    private _mesh;
+    private _destroyed;
+    private _renderVersion;
+    private _activeRender;
+    private readonly _fonts;
+    constructor(html: string, options?: HTMLTextOptions);
+    get html(): string;
+    set html(v: string);
+    get css(): string;
+    set css(v: string);
+    get width(): number;
+    set width(v: number);
+    get height(): number;
+    set height(v: number);
+    get resolution(): number;
+    set resolution(v: number);
+    /**
+     * Resolves when the current render pass finishes writing to the canvas.
+     * Await before adding to a scene if you need the first frame to be visible
+     * immediately.
+     */
+    get ready(): Promise<void>;
+    /**
+     * Register a font by its raw bytes for use inside this node's SVG render.
+     * The `family` name must match the `font-family` value used in your CSS.
+     *
+     * Registering the same family twice replaces the previous entry.
+     *
+     * ```ts
+     * const bytes = await loader.load(BinaryAsset, 'roboto.woff2');
+     * label.addFont('Roboto', bytes, 'woff2');
+     * ```
+     */
+    addFont(family: string, data: ArrayBuffer, format?: FontFormat): this;
+    /** Remove a previously registered font and trigger a re-render. */
+    removeFont(family: string): this;
+    /**
+     * Change the logical dimensions and rebuild the mesh.
+     * Prefer this over setting `width` and `height` individually when changing
+     * both at once — it triggers a single re-render instead of two.
+     */
+    resize(width: number, height: number): this;
+    destroy(): void;
+    private _schedule;
+    private _render;
+    private _buildSvg;
+    private _buildMesh;
+    private _rebuildMesh;
+    private _resizeCanvas;
+    private static _toBase64;
+    private static _makeCanvas;
+}

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

@@ -0,0 +1,284 @@
+import { Container } from '../Container.js';
+import { Mesh } from '../mesh/Mesh.js';
+import { Texture } from '../texture/Texture.js';
+
+const fontMime = {
+    woff2: 'font/woff2',
+    woff: 'font/woff',
+    ttf: 'font/ttf',
+    otf: 'font/otf',
+};
+/**
+ * Text node that renders arbitrary HTML+CSS into a canvas texture via an
+ * SVG `<foreignObject>` pass and displays the result as a textured quad.
+ *
+ * Full CSS typography and rich markup are supported. External resources
+ * (`<img src>`, `background-image: url(...)`) are **blocked** by browsers
+ * when loading SVG blob-URIs — inline those as base-64 data URIs.
+ *
+ * Custom web fonts must be registered with {@link addFont} before use;
+ * pass the raw font bytes (from {@link BinaryAsset} or a plain `fetch`):
+ *
+ * ```ts
+ * const bytes = await loader.load(BinaryAsset, 'roboto.woff2');
+ * htmlText.addFont('Roboto', bytes, 'woff2');
+ * ```
+ *
+ * The HTML must be valid XHTML (tags closed, `&amp;` for `&`, etc.)
+ * because it is embedded inside an XML document.
+ *
+ * @example
+ * ```ts
+ * const label = new HTMLText(
+ *   '<b>Score</b>: <span style="color:gold">9999</span>',
+ *   { width: 200, height: 40, css: 'body { font: 20px Arial; color: white; }' },
+ * );
+ * scene.addChild(label);
+ * await label.ready; // optional — wait for first render
+ * ```
+ * @stable
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+class HTMLText extends Container {
+    _html;
+    _css;
+    _width;
+    _height;
+    _resolution;
+    _canvas;
+    _ctx;
+    _texture;
+    _mesh;
+    _destroyed = false;
+    _renderVersion = 0;
+    _activeRender = null;
+    _fonts = [];
+    constructor(html, options = {}) {
+        super();
+        this._html = html;
+        this._css = options.css ?? '';
+        this._width = options.width ?? 256;
+        this._height = options.height ?? 128;
+        this._resolution = options.resolution ?? 1;
+        const [canvas, ctx] = HTMLText._makeCanvas(Math.ceil(this._width * this._resolution), Math.ceil(this._height * this._resolution));
+        this._canvas = canvas;
+        this._ctx = ctx;
+        this._texture = new Texture(canvas);
+        this._texture.setSize(this._width, this._height);
+        this._mesh = this._buildMesh();
+        this.addChild(this._mesh);
+        if (html.length > 0) {
+            this._schedule();
+        }
+    }
+    // ── Properties ────────────────────────────────────────────────────────────
+    get html() {
+        return this._html;
+    }
+    set html(v) {
+        if (this._html === v)
+            return;
+        this._html = v;
+        this._schedule();
+    }
+    get css() {
+        return this._css;
+    }
+    set css(v) {
+        if (this._css === v)
+            return;
+        this._css = v;
+        this._schedule();
+    }
+    get width() {
+        return this._width;
+    }
+    set width(v) {
+        this.resize(v, this._height);
+    }
+    get height() {
+        return this._height;
+    }
+    set height(v) {
+        this.resize(this._width, v);
+    }
+    get resolution() {
+        return this._resolution;
+    }
+    set resolution(v) {
+        if (this._resolution === v)
+            return;
+        this._resolution = v;
+        this._resizeCanvas();
+        this._schedule();
+    }
+    /**
+     * Resolves when the current render pass finishes writing to the canvas.
+     * Await before adding to a scene if you need the first frame to be visible
+     * immediately.
+     */
+    get ready() {
+        return this._activeRender ?? Promise.resolve();
+    }
+    // ── Font registration ─────────────────────────────────────────────────────
+    /**
+     * Register a font by its raw bytes for use inside this node's SVG render.
+     * The `family` name must match the `font-family` value used in your CSS.
+     *
+     * Registering the same family twice replaces the previous entry.
+     *
+     * ```ts
+     * const bytes = await loader.load(BinaryAsset, 'roboto.woff2');
+     * label.addFont('Roboto', bytes, 'woff2');
+     * ```
+     */
+    addFont(family, data, format = 'woff2') {
+        const dataUri = `data:${fontMime[format]};base64,${HTMLText._toBase64(data)}`;
+        const existing = this._fonts.findIndex(f => f.family === family);
+        if (existing >= 0) {
+            this._fonts[existing] = { family, dataUri };
+        }
+        else {
+            this._fonts.push({ family, dataUri });
+        }
+        this._schedule();
+        return this;
+    }
+    /** Remove a previously registered font and trigger a re-render. */
+    removeFont(family) {
+        const idx = this._fonts.findIndex(f => f.family === family);
+        if (idx >= 0) {
+            this._fonts.splice(idx, 1);
+            this._schedule();
+        }
+        return this;
+    }
+    // ── Dimensions ────────────────────────────────────────────────────────────
+    /**
+     * Change the logical dimensions and rebuild the mesh.
+     * Prefer this over setting `width` and `height` individually when changing
+     * both at once — it triggers a single re-render instead of two.
+     */
+    resize(width, height) {
+        if (this._width === width && this._height === height)
+            return this;
+        this._width = width;
+        this._height = height;
+        this._resizeCanvas();
+        this._rebuildMesh();
+        this._schedule();
+        return this;
+    }
+    destroy() {
+        this._destroyed = true;
+        this._renderVersion++;
+        this._activeRender = null;
+        this._texture.destroy();
+        super.destroy();
+    }
+    // ── Private ───────────────────────────────────────────────────────────────
+    _schedule() {
+        const version = ++this._renderVersion;
+        this._activeRender = this._render(version).catch(error => {
+            // eslint-disable-next-line no-console -- SVG/HTML render failures are meaningful dev-time diagnostics
+            console.warn('[ExoJS] HTMLText render failed.', error);
+        });
+    }
+    async _render(version) {
+        if (typeof Blob === 'undefined' || typeof Image === 'undefined')
+            return; // SSR / Node.js
+        // Blob URL avoids the size and encoding overhead of a data URI,
+        // which matters when large base-64 fonts are inlined.
+        const blob = new Blob([this._buildSvg()], { type: 'image/svg+xml;charset=utf-8' });
+        const url = URL.createObjectURL(blob);
+        const img = new Image();
+        try {
+            await new Promise((resolve, reject) => {
+                img.onload = () => resolve();
+                img.onerror = () => reject(new Error('HTMLText: SVG render failed'));
+                img.src = url;
+            });
+        }
+        finally {
+            URL.revokeObjectURL(url);
+        }
+        if (this._destroyed || version !== this._renderVersion)
+            return;
+        const cw = Math.ceil(this._width * this._resolution);
+        const ch = Math.ceil(this._height * this._resolution);
+        this._ctx.clearRect(0, 0, cw, ch);
+        this._ctx.drawImage(img, 0, 0, cw, ch);
+        this._texture.updateSource();
+    }
+    _buildSvg() {
+        const w = this._width;
+        const h = this._height;
+        const fontFaceRules = this._fonts
+            .map(({ family, dataUri }) => {
+            const escaped = family.replaceAll('\\', '\\\\').replaceAll("'", "\\'");
+            return `@font-face{font-family:'${escaped}';src:url('${dataUri}');}`;
+        })
+            .join('');
+        // Guard against the user's CSS accidentally closing the <style> tag early.
+        const userCss = this._css.replaceAll(/<\/style>/gi, '<\\/style>');
+        const styleBlock = fontFaceRules || userCss ? `<style>${fontFaceRules}${userCss}</style>` : '';
+        return (`<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${h}">` +
+            `<foreignObject width="100%" height="100%">` +
+            `<div xmlns="http://www.w3.org/1999/xhtml"` +
+            ` style="width:${w}px;height:${h}px;overflow:hidden;box-sizing:border-box;">${styleBlock}${this._html}</div>` +
+            `</foreignObject>` +
+            `</svg>`);
+    }
+    _buildMesh() {
+        const w = this._width;
+        const h = this._height;
+        return new Mesh({
+            vertices: new Float32Array([0, 0, w, 0, w, h, 0, h]),
+            uvs: new Float32Array([0, 0, 1, 0, 1, 1, 0, 1]),
+            indices: new Uint16Array([0, 1, 2, 0, 2, 3]),
+            texture: this._texture,
+        });
+    }
+    _rebuildMesh() {
+        this.removeChild(this._mesh);
+        this._mesh.destroy();
+        this._mesh = this._buildMesh();
+        this.addChild(this._mesh);
+    }
+    _resizeCanvas() {
+        const cw = Math.ceil(this._width * this._resolution);
+        const ch = Math.ceil(this._height * this._resolution);
+        this._canvas.width = cw;
+        this._canvas.height = ch;
+        // Canvas is blank after resize; the scheduled render fills it.
+        // updateSource() bumps the texture version so the GPU re-uploads.
+        this._texture.updateSource();
+    }
+    static _toBase64(buffer) {
+        const bytes = new Uint8Array(buffer);
+        let binary = '';
+        for (let i = 0; i < bytes.length; i++) {
+            binary += String.fromCharCode(bytes[i]);
+        }
+        return btoa(binary);
+    }
+    static _makeCanvas(width, height) {
+        if (typeof OffscreenCanvas !== 'undefined') {
+            const canvas = new OffscreenCanvas(width, height);
+            const ctx = canvas.getContext('2d');
+            if (!ctx)
+                throw new Error('HTMLText: could not obtain 2D context.');
+            return [canvas, ctx];
+        }
+        const canvas = document.createElement('canvas');
+        canvas.width = width;
+        canvas.height = height;
+        const ctx = canvas.getContext('2d');
+        if (!ctx)
+            throw new Error('HTMLText: could not obtain 2D context.');
+        return [canvas, ctx];
+    }
+}
+
+export { HTMLText };
+//# sourceMappingURL=HTMLText.js.map

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

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

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

@@ -0,0 +1,30 @@
+/**
+ * Controls text flow and overflow — separate from {@link TextStyle} which
+ * describes visual appearance. Pass to {@link Text} or {@link layoutText}.
+ */
+export interface LayoutOptions {
+    /** Word-wrap boundary in pixels. Lines exceeding this width are broken at word boundaries. */
+    maxWidth?: number;
+    /** Clip boundary in pixels. Text beyond this height is clipped or ellipsized. */
+    maxHeight?: number;
+    /** What to do when text overflows `maxHeight`. Defaults to `'visible'`. */
+    overflow?: 'visible' | 'clip' | 'ellipsis';
+    /** Additional gap in pixels between glyphs (on top of the font's advance). */
+    letterSpacing?: number;
+    /** Text direction. Defaults to `'ltr'`. RTL is not fully implemented. */
+    direction?: 'ltr' | 'rtl';
+    /**
+     * Break individual words that are wider than `maxWidth` at character boundaries.
+     * Only applies when `maxWidth` is set. Defaults to `false`.
+     */
+    breakWords?: boolean;
+    /**
+     * Whitespace handling mode:
+     * - `'normal'`   — Consecutive spaces collapse to one; `\n` becomes a space (standard wrap).
+     * - `'pre'`      — Spaces and newlines preserved verbatim.
+     * - `'pre-line'` — Spaces collapse; `\n` preserved (default when no explicit mode).
+     *
+     * Defaults to `'pre-line'` (current historical behaviour).
+     */
+    whiteSpace?: 'normal' | 'pre' | 'pre-line';
+}