@codexo/exojs 0.8.3 → 0.9.0

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

@@ -0,0 +1,347 @@
+import { Signal } from '../../core/Signal.js';
+import { DataTexture } from '../texture/DataTexture.js';
+import { Texture } from '../texture/Texture.js';
+import { GlyphSdf } from './GlyphSdf.js';
+
+/**
+ * SDF buffer radius in pixels — the maximum distance outside a glyph that the
+ * SDF field encodes. Determines the maximum usable outline/shadow reach.
+ * Exported so applications can import this constant when computing shader uniforms.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const SDF_RADIUS = 8;
+const glyphPadding = 2;
+class ShelfPacker {
+    _shelves = [];
+    _width;
+    _height;
+    constructor(width, height) {
+        this._width = width;
+        this._height = height;
+    }
+    insert(width, height) {
+        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 };
+            }
+        }
+        const last = this._shelves[this._shelves.length - 1];
+        const bottomY = last === undefined ? 0 : last.y + last.height;
+        if (bottomY + height > this._height) {
+            return null;
+        }
+        this._shelves.push({ y: bottomY, height, cursorX: width });
+        return { x: 0, y: bottomY };
+    }
+    reset() {
+        this._shelves.length = 0;
+    }
+}
+function makeCtx(width, height) {
+    if (typeof OffscreenCanvas !== 'undefined') {
+        const canvas = new OffscreenCanvas(width, height);
+        const ctx = canvas.getContext('2d');
+        if (!ctx)
+            throw new Error('GlyphAtlas: could not obtain OffscreenCanvas 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('GlyphAtlas: could not obtain canvas 2D context.');
+    return { canvas, ctx };
+}
+/**
+ * A single texture page within a {@link GlyphAtlas}. Glyphs are packed into
+ * the page using a shelf-bin algorithm.
+ *
+ * In `'sdf'` mode the page owns a `DataTexture` (`r8`) populated by tiny-sdf
+ * output. In `'color'` mode a Canvas 2D context preserves full glyph colours
+ * for emoji.
+ * @advanced
+ */
+class AtlasPage {
+    texture;
+    index;
+    mode;
+    _packer;
+    _width;
+    _height;
+    // SDF mode
+    _sdfBuffer = null;
+    _sdfTexture = null;
+    // Canvas mode
+    _ctx = null;
+    _colorGlyphs;
+    constructor(index, width, height, mode) {
+        this.index = index;
+        this.mode = mode;
+        this._width = width;
+        this._height = height;
+        this._colorGlyphs = mode === 'color';
+        this._packer = new ShelfPacker(width, height);
+        if (mode === 'sdf') {
+            this._sdfBuffer = new Uint8Array(width * height);
+            this._sdfTexture = new DataTexture({ width, height, format: 'r8', data: this._sdfBuffer });
+            this._sdfTexture.setSize(width, height);
+            this.texture = this._sdfTexture;
+        }
+        else {
+            const { canvas, ctx } = makeCtx(width, height);
+            this._ctx = ctx;
+            this.texture = new Texture(canvas);
+            this.texture.setSize(width, height);
+        }
+    }
+    insert(w, h) {
+        return this._packer.insert(w, h);
+    }
+    /**
+     * Copy R8 SDF data into the page buffer at the given slot origin.
+     * Only valid in `'sdf'` mode.
+     *
+     * `data` is a `Uint8ClampedArray` of single-channel SDF values as produced
+     * by {@link GlyphSdf.draw}. Each value is one byte (0 = far outside the
+     * glyph, 255 = deep inside, ~128 = glyph edge).
+     */
+    writeSdf(data, slotX, slotY, srcW, srcH) {
+        const buf = this._sdfBuffer;
+        const dstW = this._width;
+        for (let row = 0; row < srcH; row++) {
+            const srcOff = row * srcW;
+            const dstOff = (slotY + row) * dstW + slotX;
+            buf.set(data.subarray(srcOff, srcOff + srcW), dstOff);
+        }
+        this._sdfTexture.commitRect(slotX, slotY, srcW, srcH);
+    }
+    measureGlyph(char, font) {
+        if (this._ctx !== null) {
+            this._ctx.font = font;
+            this._ctx.textBaseline = 'alphabetic';
+            return this._ctx.measureText(char);
+        }
+        const c = typeof OffscreenCanvas !== 'undefined' ? new OffscreenCanvas(1, 1) : document.createElement('canvas');
+        const ctx = c.getContext('2d');
+        ctx.font = font;
+        ctx.textBaseline = 'alphabetic';
+        return ctx.measureText(char);
+    }
+    /** Rasterize a white glyph into the canvas at the given padded slot origin (canvas mode only). */
+    rasterize(char, slotX, slotY, ascent, bbLeft, font) {
+        const ctx = this._ctx;
+        ctx.font = font;
+        ctx.textBaseline = 'alphabetic';
+        if (!this._colorGlyphs) {
+            ctx.fillStyle = '#ffffff';
+        }
+        ctx.fillText(char, slotX + glyphPadding + bbLeft, slotY + glyphPadding + ascent);
+    }
+    uploadDirtyRegion() {
+        if (this._sdfTexture !== null) {
+            this._sdfTexture.commit();
+        }
+        else {
+            this.texture.updateSource();
+        }
+    }
+    reset() {
+        this._packer.reset();
+        if (this._sdfBuffer !== null && this._sdfTexture !== null) {
+            this._sdfBuffer.fill(0);
+            this._sdfTexture.commit();
+        }
+        else if (this._ctx !== null) {
+            this._ctx.clearRect(0, 0, this._width, this._height);
+            this.texture.updateSource();
+        }
+    }
+}
+// ── GlyphAtlas ───────────────────────────────────────────────────────────────
+/**
+ * A per-font-variant glyph atlas with automatic multi-page growth.
+ *
+ * In `'sdf'` mode (default) each atlas page is a single-channel R8
+ * `DataTexture` populated by {@link GlyphSdf}. One `GlyphSdf` instance is kept per
+ * font size so the atlas can mix sizes efficiently.
+ *
+ * In `'color'` mode pages are RGBA canvas textures that preserve full glyph
+ * colour data for emoji and colour fonts.
+ * @advanced
+ */
+class GlyphAtlas {
+    _pages = [];
+    _cache = new Map();
+    _kerningCache = new Map();
+    _pageSize;
+    _family;
+    _fontStyle;
+    _fontWeight;
+    _mode;
+    _sdfRadius;
+    /**
+     * Dispatched whenever a new atlas page is allocated.
+     *
+     * Listen here to detect unexpected atlas growth (e.g. many unique CJK glyphs
+     * or an oversized font size). The payload is the zero-based page index.
+     *
+     * ```ts
+     * const atlas = pool.getAtlas('Roboto', 'normal', '400');
+     * atlas.onPageAdded.on(idx => console.warn(`Atlas page ${idx} added`));
+     * ```
+     */
+    onPageAdded = new Signal();
+    /** {@link GlyphSdf} instances keyed by font size — only used in SDF mode. */
+    _sdfInstances = new Map();
+    constructor(family, fontStyle, fontWeight, pageSize = 1024, mode = 'sdf', sdfRadius = SDF_RADIUS) {
+        this._family = family;
+        this._fontStyle = fontStyle;
+        this._fontWeight = fontWeight;
+        this._pageSize = pageSize;
+        this._mode = mode;
+        this._sdfRadius = sdfRadius;
+        this._addPage();
+    }
+    get pages() {
+        return this._pages;
+    }
+    get mode() {
+        return this._mode;
+    }
+    getGlyph(char, size) {
+        const key = `${char}:${size}`;
+        const cached = this._cache.get(key);
+        if (cached !== undefined)
+            return cached;
+        return this._mode === 'sdf' ? this._rasterizeSdf(char, size, key) : this._rasterizeCanvas(char, size, key);
+    }
+    getKerning(prev, next, fontSize) {
+        const key = `${prev}${next}:${fontSize}`;
+        const cached = this._kerningCache.get(key);
+        if (cached !== undefined)
+            return cached;
+        const font = this._cssFont(fontSize);
+        const page = this._pages[0];
+        const pair = page.measureGlyph(prev + next, font).width;
+        const a = page.measureGlyph(prev, font).width;
+        const b = page.measureGlyph(next, font).width;
+        const kerning = pair - a - b;
+        this._kerningCache.set(key, kerning);
+        return kerning;
+    }
+    clear() {
+        this._cache.clear();
+        this._kerningCache.clear();
+        this._sdfInstances.clear();
+        for (const page of this._pages) {
+            page.reset();
+        }
+        this._pages = [];
+        this._addPage();
+    }
+    // ── Private ──────────────────────────────────────────────────────────────
+    _addPage() {
+        const index = this._pages.length;
+        const page = new AtlasPage(index, this._pageSize, this._pageSize, this._mode);
+        this._pages.push(page);
+        if (index > 0)
+            this.onPageAdded.dispatch(index);
+        return page;
+    }
+    _cssFont(size) {
+        const style = this._fontStyle !== 'normal' ? `${this._fontStyle} ` : '';
+        return `${style}${this._fontWeight} ${size}px ${this._family}`;
+    }
+    _getSdf(fontSize) {
+        let instance = this._sdfInstances.get(fontSize);
+        if (instance === undefined) {
+            instance = new GlyphSdf({
+                fontSize,
+                fontFamily: this._family,
+                fontWeight: this._fontWeight,
+                fontStyle: this._fontStyle,
+                buffer: this._sdfRadius,
+                radius: this._sdfRadius,
+                cutoff: 0.5,
+            });
+            this._sdfInstances.set(fontSize, instance);
+        }
+        return instance;
+    }
+    _rasterizeSdf(char, size, key) {
+        const result = this._getSdf(size).draw(char);
+        const { page, slot } = this._allocateSlot(result.width, result.height);
+        page.writeSdf(result.data, slot.x, slot.y, result.width, result.height);
+        const ps = this._pageSize;
+        const info = {
+            x: slot.x,
+            y: slot.y,
+            width: result.width,
+            height: result.height,
+            advance: result.glyphAdvance,
+            ascent: result.glyphTop + result.glyphHeight, // distance from tile top to glyph bottom
+            page: page.index,
+            uvLeft: slot.x / ps,
+            uvTop: slot.y / ps,
+            uvRight: (slot.x + result.width) / ps,
+            uvBottom: (slot.y + result.height) / ps,
+            // Shift the quad left/up by the SDF buffer so the glyph content aligns
+            // with the logical cursor position (bearing = −buffer on both axes).
+            xBearing: -result.glyphLeft,
+            yBearing: -result.glyphTop,
+        };
+        this._cache.set(key, info);
+        return info;
+    }
+    _rasterizeCanvas(char, size, key) {
+        const font = this._cssFont(size);
+        const metrics = this._pages[0].measureGlyph(char, font);
+        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 bbLeft = metrics.actualBoundingBoxLeft ?? 0;
+        const bbRight = metrics.actualBoundingBoxRight ?? 0;
+        const glyphWidth = Math.max(1, Math.ceil(bbLeft + bbRight) || Math.ceil(advance));
+        const glyphHeight = Math.max(1, ascent + descent);
+        const slotW = glyphWidth + glyphPadding * 2;
+        const slotH = glyphHeight + glyphPadding * 2;
+        const { page, slot } = this._allocateSlot(slotW, slotH);
+        page.rasterize(char, slot.x, slot.y, ascent, bbLeft, font);
+        page.uploadDirtyRegion();
+        const ps = this._pageSize;
+        const info = {
+            x: slot.x,
+            y: slot.y,
+            width: glyphWidth,
+            height: glyphHeight,
+            advance,
+            ascent,
+            page: page.index,
+            uvLeft: slot.x / ps,
+            uvTop: slot.y / ps,
+            uvRight: (slot.x + slotW) / ps,
+            uvBottom: (slot.y + slotH) / ps,
+        };
+        this._cache.set(key, info);
+        return info;
+    }
+    _allocateSlot(w, h) {
+        for (const page of this._pages) {
+            const slot = page.insert(w, h);
+            if (slot !== null)
+                return { page, slot };
+        }
+        const newPage = this._addPage();
+        const slot = newPage.insert(w, h);
+        if (slot === null) {
+            throw new Error(`GlyphAtlas: glyph (${w}×${h}px) exceeds page size (${this._pageSize}px).`);
+        }
+        return { page: newPage, slot };
+    }
+}
+
+export { AtlasPage, GlyphAtlas, SDF_RADIUS };
+//# sourceMappingURL=GlyphAtlas.js.map

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

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

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

@@ -0,0 +1,40 @@
+import { type AtlasMode, GlyphAtlas } from './GlyphAtlas';
+/**
+ * Manages one {@link GlyphAtlas} per font variant + mode combination.
+ *
+ * The pool key is `"${family}:${fontStyle}:${fontWeight}:${mode}"`. All text
+ * nodes sharing the same font variant and mode draw from the same atlas pages,
+ * so identical glyphs are rasterized only once regardless of which node first
+ * requests them.
+ *
+ * Use {@link getDefaultGlyphAtlasPool} to obtain the shared process-wide
+ * instance. Tests can mock that function to inject a fake pool.
+ * @advanced
+ */
+export declare class GlyphAtlasPool {
+    private readonly _atlases;
+    private readonly _pageSize;
+    constructor(pageSize?: number);
+    /**
+     * Returns (or lazily creates) the atlas for the given font variant and mode.
+     * Defaults to `'sdf'` mode (R8 DataTexture, tiny-sdf rasterization).
+     *
+     * Nodes with different `sdfRadius` values get separate atlas instances so
+     * each can encode a different outline/shadow reach without conflict.
+     */
+    getAtlas(family: string, fontStyle: 'normal' | 'italic', fontWeight: string, mode?: AtlasMode, sdfRadius?: number): GlyphAtlas;
+    clearAll(): void;
+}
+/**
+ * Returns the shared process-wide {@link GlyphAtlasPool}, creating it lazily
+ * on first call. All {@link Text} instances use this pool by default.
+ */
+export declare function getDefaultGlyphAtlasPool(): GlyphAtlasPool;
+/**
+ * Override the default pool. Passing no argument (or `undefined`) causes the
+ * next {@link getDefaultGlyphAtlasPool} call to create a fresh instance.
+ *
+ * Intended for tests: call with a mock pool in `beforeEach` and with no
+ * argument in `afterEach` to restore default behaviour.
+ */
+export declare function resetDefaultGlyphAtlasPool(pool?: GlyphAtlasPool): void;

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

@@ -0,0 +1,67 @@
+import { SDF_RADIUS, GlyphAtlas } from './GlyphAtlas.js';
+
+/**
+ * Manages one {@link GlyphAtlas} per font variant + mode combination.
+ *
+ * The pool key is `"${family}:${fontStyle}:${fontWeight}:${mode}"`. All text
+ * nodes sharing the same font variant and mode draw from the same atlas pages,
+ * so identical glyphs are rasterized only once regardless of which node first
+ * requests them.
+ *
+ * Use {@link getDefaultGlyphAtlasPool} to obtain the shared process-wide
+ * instance. Tests can mock that function to inject a fake pool.
+ * @advanced
+ */
+class GlyphAtlasPool {
+    _atlases = new Map();
+    _pageSize;
+    constructor(pageSize = 1024) {
+        this._pageSize = pageSize;
+    }
+    /**
+     * Returns (or lazily creates) the atlas for the given font variant and mode.
+     * Defaults to `'sdf'` mode (R8 DataTexture, tiny-sdf rasterization).
+     *
+     * Nodes with different `sdfRadius` values get separate atlas instances so
+     * each can encode a different outline/shadow reach without conflict.
+     */
+    getAtlas(family, fontStyle, fontWeight, mode = 'sdf', sdfRadius = SDF_RADIUS) {
+        const key = `${family}:${fontStyle}:${fontWeight}:${mode}:${sdfRadius}`;
+        let atlas = this._atlases.get(key);
+        if (atlas === undefined) {
+            atlas = new GlyphAtlas(family, fontStyle, fontWeight, this._pageSize, mode, sdfRadius);
+            this._atlases.set(key, atlas);
+        }
+        return atlas;
+    }
+    clearAll() {
+        for (const atlas of this._atlases.values()) {
+            atlas.clear();
+        }
+    }
+}
+// ── Module-level default pool ────────────────────────────────────────────────
+let _defaultPool = null;
+/**
+ * Returns the shared process-wide {@link GlyphAtlasPool}, creating it lazily
+ * on first call. All {@link Text} instances use this pool by default.
+ */
+function getDefaultGlyphAtlasPool() {
+    if (_defaultPool === null) {
+        _defaultPool = new GlyphAtlasPool();
+    }
+    return _defaultPool;
+}
+/**
+ * Override the default pool. Passing no argument (or `undefined`) causes the
+ * next {@link getDefaultGlyphAtlasPool} call to create a fresh instance.
+ *
+ * Intended for tests: call with a mock pool in `beforeEach` and with no
+ * argument in `afterEach` to restore default behaviour.
+ */
+function resetDefaultGlyphAtlasPool(pool) {
+    _defaultPool = pool ?? null;
+}
+
+export { GlyphAtlasPool, getDefaultGlyphAtlasPool, resetDefaultGlyphAtlasPool };
+//# sourceMappingURL=GlyphAtlasPool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GlyphAtlasPool.js","sources":["../../../../../src/rendering/text/GlyphAtlasPool.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA;;;;;;;;;;;AAWG;MACU,cAAc,CAAA;AACR,IAAA,QAAQ,GAAG,IAAI,GAAG,EAAsB;AACxC,IAAA,SAAS;IAE1B,WAAA,CAAmB,QAAQ,GAAG,IAAI,EAAA;AAChC,QAAA,IAAI,CAAC,SAAS,GAAG,QAAQ;IAC3B;AAEA;;;;;;AAMG;AACI,IAAA,QAAQ,CAAC,MAAc,EAAE,SAA8B,EAAE,UAAkB,EAAE,IAAA,GAAkB,KAAK,EAAE,SAAS,GAAG,UAAU,EAAA;AACjI,QAAA,MAAM,GAAG,GAAG,CAAA,EAAG,MAAM,CAAA,CAAA,EAAI,SAAS,CAAA,CAAA,EAAI,UAAU,CAAA,CAAA,EAAI,IAAI,CAAA,CAAA,EAAI,SAAS,EAAE;QACvE,IAAI,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;AAElC,QAAA,IAAI,KAAK,KAAK,SAAS,EAAE;AACvB,YAAA,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC;YACtF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC;QAC/B;AAEA,QAAA,OAAO,KAAK;IACd;IAEO,QAAQ,GAAA;QACb,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,EAAE;YAC1C,KAAK,CAAC,KAAK,EAAE;QACf;IACF;AACD;AAED;AAEA,IAAI,YAAY,GAA0B,IAAI;AAE9C;;;AAGG;SACa,wBAAwB,GAAA;AACtC,IAAA,IAAI,YAAY,KAAK,IAAI,EAAE;AACzB,QAAA,YAAY,GAAG,IAAI,cAAc,EAAE;IACrC;AACA,IAAA,OAAO,YAAY;AACrB;AAEA;;;;;;AAMG;AACG,SAAU,0BAA0B,CAAC,IAAqB,EAAA;AAC9D,IAAA,YAAY,GAAG,IAAI,IAAI,IAAI;AAC7B;;;;"}

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

@@ -0,0 +1,92 @@
+/**
+ * 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)`.
+ */
+export interface GlyphSdfOptions {
+    /** Font size in pixels used for rasterization. */
+    fontSize: number;
+    /** CSS font-family string. */
+    fontFamily: string;
+    fontWeight?: string;
+    fontStyle?: string;
+    /**
+     * Pixels of SDF padding added around the glyph bounding box on each side.
+     * Determines the maximum reach of outline and shadow effects.
+     * Defaults to 8.
+     */
+    buffer?: number;
+    /**
+     * EDT search radius. Values above `radius` pixels from the edge are
+     * clamped. Must be ≥ `buffer` for full-range SDF coverage.
+     * Defaults to `buffer`.
+     */
+    radius?: number;
+    /**
+     * SDF normalisation cutoff (0..1). Value at the glyph edge = 1 − cutoff.
+     * Use `0.5` so the shader's threshold of 0.5 matches the edge exactly.
+     * Defaults to 0.5.
+     */
+    cutoff?: number;
+}
+/** Result of {@link GlyphSdf.draw}. */
+export interface GlyphSdfResult {
+    /** R8 SDF values: 0 = far outside, 255 = deep inside, ~128 = edge. */
+    data: Uint8ClampedArray;
+    /** Tile width in pixels (= glyphWidth + 2 × buffer). */
+    width: number;
+    /** Tile height in pixels (= glyphHeight + 2 × buffer). */
+    height: number;
+    /** Actual glyph width in pixels (bounding box, no padding). */
+    glyphWidth: number;
+    /** Actual glyph height in pixels (ascent + descent, no padding). */
+    glyphHeight: number;
+    /** Pixels from tile top to glyph top = buffer. */
+    glyphTop: number;
+    /** Pixels from tile left to glyph left = buffer. */
+    glyphLeft: number;
+    /** Logical horizontal advance for cursor movement. */
+    glyphAdvance: number;
+}
+/**
+ * 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
+ */
+export declare class GlyphSdf {
+    private readonly _buffer;
+    private readonly _radius;
+    private readonly _cutoff;
+    private readonly _font;
+    private _canvasW;
+    private _canvasH;
+    private readonly _canvas;
+    private readonly _ctx;
+    private _gridOuter;
+    private _gridInner;
+    private _f;
+    private _d;
+    private _z;
+    private _v;
+    private _out;
+    constructor(options: GlyphSdfOptions);
+    /**
+     * 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: string): GlyphSdfResult;
+}