@flighthq/bitmaptext 0.1.0

package/dist/bitmapText.d.ts

@@ -0,0 +1,16 @@
+import type { BitmapText, BitmapTextAlign, BitmapTextData, BitmapTextOptions, BitmapTextRuntime, GlyphSource, QuadBatch, Rectangle } from '@flighthq/types';
+export declare function computeBitmapTextLocalBoundsRectangle(out: Rectangle, source: Readonly<BitmapText>): void;
+export declare function createBitmapText(glyphSource: GlyphSource | null, options?: Readonly<BitmapTextOptions>): BitmapText;
+export declare function createBitmapTextData(data?: Readonly<Partial<BitmapTextData>>): BitmapTextData;
+export declare function createBitmapTextRuntime(): BitmapTextRuntime;
+export declare function getBitmapTextBounds(source: Readonly<BitmapText>): Rectangle;
+export declare function getBitmapTextQuadBatches(source: Readonly<BitmapText>): QuadBatch[];
+export declare function reserveBitmapText(target: BitmapText, glyphCapacity: number): void;
+export declare function setBitmapTextAlign(target: BitmapText, align: BitmapTextAlign): void;
+export declare function setBitmapTextColor(target: BitmapText, color: number): void;
+export declare function setBitmapTextGlyphSource(target: BitmapText, glyphSource: GlyphSource | null): void;
+export declare function setBitmapTextLetterSpacing(target: BitmapText, letterSpacing: number): void;
+export declare function setBitmapTextLineHeight(target: BitmapText, lineHeight: number): void;
+export declare function setBitmapTextText(target: BitmapText, text: string): void;
+export declare function setBitmapTextWrapWidth(target: BitmapText, wrapWidth: number | null): void;
+//# sourceMappingURL=bitmapText.d.ts.map

package/dist/bitmapText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bitmapText.d.ts","sourceRoot":"","sources":["../src/bitmapText.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EAGX,SAAS,EACT,SAAS,EACV,MAAM,iBAAiB,CAAC;AAQzB,wBAAgB,qCAAqC,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,CAWxG;AAQD,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,UAAU,CAenH;AAED,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,GAAG,cAAc,CAU7F;AAED,wBAAgB,uBAAuB,IAAI,iBAAiB,CAK3D;AAID,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,SAAS,CAI3E;AAID,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,SAAS,EAAE,CAElF;AAKD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAGjF;AAGD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAEnF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE1E;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAElG;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAE1F;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAEpF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAExE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAEzF"}

package/dist/bitmapText.js

@@ -0,0 +1,122 @@
+import { createDisplayObjectGeneric, createDisplayObjectRuntime, getDisplayObjectRuntime, } from '@flighthq/displayobject';
+import { copyRectangle, createRectangle } from '@flighthq/geometry';
+import { addNodeChild } from '@flighthq/node';
+import { createQuadBatch, reserveQuadBatch } from '@flighthq/sprite';
+import { createTextureAtlas } from '@flighthq/textureatlas';
+import { BitmapTextKind } from '@flighthq/types';
+// White (`0xRRGGBBAA` all-ones) — the untinted default; the backing batch stays material-free at this value.
+const BITMAP_TEXT_DEFAULT_COLOR = 0xffffffff;
+// Writes the laid-out text extent (cached by `updateBitmapText`) into `out`, or a zero rectangle when
+// the text has not been laid out yet. Alias-safe: `out` may be the cached rectangle.
+export function computeBitmapTextLocalBoundsRectangle(out, source) {
+    const runtime = getDisplayObjectRuntime(source);
+    const bounds = runtime.localBoundsRectangle;
+    if (bounds === null) {
+        out.x = 0;
+        out.y = 0;
+        out.width = 0;
+        out.height = 0;
+        return;
+    }
+    copyRectangle(out, bounds);
+}
+// Allocates a BitmapText display node bound to `glyphSource` for both layout AND pixels. The
+// `GlyphSource` seam now pairs its glyph geometry (rects, advances, kerning, metrics) with the
+// backing atlas image(s) those rects sample (`getGlyphAtlasImage(page)`), so no separate image is
+// supplied. The node owns one backing QuadBatch child per glyph-atlas page; a single-page source
+// yields exactly one (page 0), created eagerly here. Call `updateBitmapText` to lay out the current
+// `text`, which sets each page batch's atlas image and grows the set for a multi-page source.
+export function createBitmapText(glyphSource, options) {
+    const bitmapText = createDisplayObjectGeneric(BitmapTextKind, undefined, createBitmapTextData, createBitmapTextRuntime);
+    const data = bitmapText.data;
+    data.glyphSource = glyphSource;
+    if (options !== undefined)
+        applyBitmapTextOptions(data, options);
+    const quadBatch = createQuadBatch({ data: { atlas: createTextureAtlas() } });
+    const runtime = getDisplayObjectRuntime(bitmapText);
+    runtime.quadBatches.push(quadBatch);
+    addNodeChild(bitmapText, quadBatch);
+    return bitmapText;
+}
+export function createBitmapTextData(data) {
+    return {
+        align: data?.align ?? 'left',
+        color: data?.color ?? BITMAP_TEXT_DEFAULT_COLOR,
+        glyphSource: data?.glyphSource ?? null,
+        letterSpacing: data?.letterSpacing ?? 0,
+        lineHeight: data?.lineHeight ?? 1,
+        text: data?.text ?? '',
+        wrapWidth: data?.wrapWidth ?? null,
+    };
+}
+export function createBitmapTextRuntime() {
+    const runtime = createDisplayObjectRuntime(defaultMethods);
+    runtime.localBoundsRectangle = null;
+    runtime.quadBatches = [];
+    return runtime;
+}
+// Allocates a fresh Rectangle holding the laid-out text extent. Use
+// `computeBitmapTextLocalBoundsRectangle` with an owned `out` in hot paths.
+export function getBitmapTextBounds(source) {
+    const out = createRectangle();
+    computeBitmapTextLocalBoundsRectangle(out, source);
+    return out;
+}
+// The backing QuadBatches the node lays glyph quads into — the renderable children, one per
+// glyph-atlas page in page order. A single-page source yields exactly one; empty before construction.
+export function getBitmapTextQuadBatches(source) {
+    return getDisplayObjectRuntime(source).quadBatches;
+}
+// Grows each backing page QuadBatch to hold at least `glyphCapacity` glyph quads without reallocating
+// during layout. Optional — `updateBitmapText` auto-grows — but avoids incremental reallocation for
+// large strings. Reserving every page's batch over-allocates for multi-page text but never under-sizes.
+export function reserveBitmapText(target, glyphCapacity) {
+    const runtime = getDisplayObjectRuntime(target);
+    for (const quadBatch of runtime.quadBatches)
+        reserveQuadBatch(quadBatch, glyphCapacity);
+}
+// The setters below mutate node data only; call `updateBitmapText` afterward to re-lay-out the batch.
+export function setBitmapTextAlign(target, align) {
+    target.data.align = align;
+}
+export function setBitmapTextColor(target, color) {
+    target.data.color = color;
+}
+export function setBitmapTextGlyphSource(target, glyphSource) {
+    target.data.glyphSource = glyphSource;
+}
+export function setBitmapTextLetterSpacing(target, letterSpacing) {
+    target.data.letterSpacing = letterSpacing;
+}
+export function setBitmapTextLineHeight(target, lineHeight) {
+    target.data.lineHeight = lineHeight;
+}
+export function setBitmapTextText(target, text) {
+    target.data.text = text;
+}
+export function setBitmapTextWrapWidth(target, wrapWidth) {
+    target.data.wrapWidth = wrapWidth;
+}
+function applyBitmapTextOptions(data, options) {
+    if (options.align !== undefined)
+        data.align = options.align;
+    if (options.color !== undefined)
+        data.color = options.color;
+    if (options.letterSpacing !== undefined)
+        data.letterSpacing = options.letterSpacing;
+    if (options.lineHeight !== undefined)
+        data.lineHeight = options.lineHeight;
+    if (options.text !== undefined)
+        data.text = options.text;
+    if (options.wrapWidth !== undefined)
+        data.wrapWidth = options.wrapWidth;
+}
+function copyLocalBoundsRectangle(out, source) {
+    const runtime = getDisplayObjectRuntime(source);
+    if (runtime.localBoundsRectangle !== null)
+        copyRectangle(out, runtime.localBoundsRectangle);
+}
+const defaultMethods = {
+    computeLocalBoundsRectangle: copyLocalBoundsRectangle,
+};
+//# sourceMappingURL=bitmapText.js.map

package/dist/bitmapText.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './bitmapText';
+export * from './updateBitmapText';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export * from './bitmapText';
+export * from './updateBitmapText';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}

package/dist/updateBitmapText.d.ts

@@ -0,0 +1,3 @@
+import type { BitmapText } from '@flighthq/types';
+export declare function updateBitmapText(bitmapText: BitmapText): void;
+//# sourceMappingURL=updateBitmapText.d.ts.map

package/dist/updateBitmapText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateBitmapText.d.ts","sourceRoot":"","sources":["../src/updateBitmapText.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,UAAU,EAQX,MAAM,iBAAiB,CAAC;AAiBzB,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CA4E7D"}

package/dist/updateBitmapText.js

@@ -0,0 +1,238 @@
+import { createColorTransformAdjustment } from '@flighthq/adjustments';
+import { getDisplayObjectRuntime, setDisplayObjectColorAdjustments } from '@flighthq/displayobject';
+import { createRectangle } from '@flighthq/geometry';
+import { createColorTransform } from '@flighthq/materials';
+import { addNodeChild, invalidateNodeLocalBounds } from '@flighthq/node';
+import { appendQuadBatchInstance, clearQuadBatch, createQuadBatch } from '@flighthq/sprite';
+import { addTextureAtlasRegion, createTextureAtlas } from '@flighthq/textureatlas';
+// White (`0xRRGGBBAA` all-ones) leaves the backing batch material-free — the untinted path.
+const BITMAP_TEXT_DEFAULT_COLOR = 0xffffffff;
+const CARRIAGE_RETURN = 0x0d;
+const SPACE = 0x20;
+// Lays out `bitmapText`'s current string and rewrites its backing QuadBatches: one quad per visible
+// glyph, partitioned by the glyph's atlas page into one QuadBatch per page, positioned by the glyph
+// source's advances and kerning, broken on explicit newlines and (when `wrapWidth` is set) at word
+// boundaries, stacked by the metric line advance, and aligned per line. Each page batch's atlas image
+// is bound from `getGlyphAtlasImage(page)` and its regions rebuilt from that page's encountered glyph
+// rects each call, so a dynamic glyph source whose rects shift between layouts stays correct. A
+// single-page source produces exactly one batch (page 0). A page whose `getGlyphAtlasImage` returns
+// null cannot be sampled, so its glyphs are skipped. Missing glyphs (`getGlyphEntry` → null) are
+// omitted entirely — no quad and no advance — since a null entry carries no advance to honor. Bounds
+// span every drawn glyph across all pages.
+export function updateBitmapText(bitmapText) {
+    const data = bitmapText.data;
+    const runtime = getDisplayObjectRuntime(bitmapText);
+    const bounds = ensureBoundsRectangle(runtime);
+    // Clear and recolor every existing page batch; pages with glyphs this layout are refilled below,
+    // pages that fall silent stay as empty children drawing nothing.
+    for (const quadBatch of runtime.quadBatches) {
+        clearQuadBatch(quadBatch);
+        if (quadBatch.data.atlas !== null)
+            quadBatch.data.atlas.regions.length = 0;
+        applyBitmapTextColor(quadBatch, data.color);
+    }
+    const glyphSource = data.glyphSource;
+    if (glyphSource === null || data.text.length === 0) {
+        setEmptyRectangle(bounds);
+        invalidateNodeLocalBounds(bitmapText);
+        return;
+    }
+    const metrics = glyphSource.getGlyphMetrics();
+    const lineAdvance = (metrics.ascent + metrics.descent + metrics.lineGap) * data.lineHeight;
+    const lines = layoutBitmapTextLines(glyphSource, data);
+    const refWidth = data.wrapWidth ?? maxLineWidth(lines);
+    const pages = new Map();
+    let minX = Infinity;
+    let minY = Infinity;
+    let maxX = -Infinity;
+    let maxY = -Infinity;
+    for (let li = 0; li < lines.length; li++) {
+        const line = lines[li];
+        const baselineY = metrics.ascent + li * lineAdvance;
+        let startX = 0;
+        let gapExtra = 0;
+        if (data.align === 'center')
+            startX = (refWidth - line.width) / 2;
+        else if (data.align === 'right')
+            startX = refWidth - line.width;
+        else if (data.align === 'justify' && data.wrapWidth !== null && !line.paragraphEnd && line.gaps.length > 0) {
+            gapExtra = (data.wrapWidth - line.width) / line.gaps.length;
+        }
+        let penX = startX;
+        for (let wi = 0; wi < line.words.length; wi++) {
+            if (wi > 0)
+                penX += line.gaps[wi - 1] + gapExtra;
+            const word = line.words[wi];
+            for (const glyph of word.glyphs) {
+                const entry = glyph.entry;
+                const page = ensureBitmapTextPageBatch(bitmapText, runtime, glyphSource, data.color, pages, entry.page);
+                if (page === null)
+                    continue;
+                const quadX = penX + glyph.penWithinWord + entry.bearingX;
+                const quadY = baselineY - entry.bearingY;
+                let regionId = page.regionByCodepoint.get(glyph.codepoint);
+                if (regionId === undefined) {
+                    addTextureAtlasRegion(page.atlas, entry.x, entry.y, entry.width, entry.height);
+                    regionId = page.atlas.regions.length - 1;
+                    page.regionByCodepoint.set(glyph.codepoint, regionId);
+                }
+                appendQuadBatchInstance(page.quadBatch, regionId, quadX, quadY);
+                if (quadX < minX)
+                    minX = quadX;
+                if (quadY < minY)
+                    minY = quadY;
+                if (quadX + entry.width > maxX)
+                    maxX = quadX + entry.width;
+                if (quadY + entry.height > maxY)
+                    maxY = quadY + entry.height;
+            }
+            penX += word.width;
+        }
+    }
+    if (minX === Infinity) {
+        setEmptyRectangle(bounds);
+    }
+    else {
+        bounds.x = minX;
+        bounds.y = minY;
+        bounds.width = maxX - minX;
+        bounds.height = maxY - minY;
+    }
+    invalidateNodeLocalBounds(bitmapText);
+}
+// Sets (or clears) the backing batch's node-level color transform from a packed-RGBA color, as a
+// single-entry color-adjustment stack on the batch's runtime slot. White clears it. Every glyph of the
+// batch shares this one tint (whole-batch, not per-glyph), so it resolves to one value and folds into the
+// glyph draw as a single whole-batch color-transform uniform.
+function applyBitmapTextColor(quadBatch, color) {
+    if (color === BITMAP_TEXT_DEFAULT_COLOR) {
+        setDisplayObjectColorAdjustments(quadBatch, null);
+        return;
+    }
+    const colorTransform = createColorTransform({
+        redMultiplier: ((color >>> 24) & 0xff) / 255,
+        greenMultiplier: ((color >>> 16) & 0xff) / 255,
+        blueMultiplier: ((color >>> 8) & 0xff) / 255,
+        alphaMultiplier: (color & 0xff) / 255,
+    });
+    setDisplayObjectColorAdjustments(quadBatch, [createColorTransformAdjustment(colorTransform)]);
+}
+// Measures one paragraph (a newline-free run) into words separated by whitespace gaps. Intra-word
+// kerning and letter spacing are baked into each glyph's `penWithinWord` and the word width; kerning
+// does not cross a space. Zero-size glyphs advance the pen but produce no quad; missing glyphs are skipped.
+function buildBitmapTextWords(glyphSource, paragraph, letterSpacing) {
+    const tokens = [];
+    let pendingGap = 0;
+    let glyphs = [];
+    let pen = 0;
+    let previousCodepoint = -1;
+    let inWord = false;
+    const flush = () => {
+        if (!inWord)
+            return;
+        tokens.push({ gap: pendingGap, word: { glyphs, width: pen } });
+        pendingGap = 0;
+        glyphs = [];
+        pen = 0;
+        previousCodepoint = -1;
+        inWord = false;
+    };
+    for (const character of paragraph) {
+        const codepoint = character.codePointAt(0);
+        if (codepoint === undefined || codepoint === CARRIAGE_RETURN)
+            continue;
+        if (codepoint === SPACE) {
+            flush();
+            const spaceEntry = glyphSource.getGlyphEntry(SPACE);
+            pendingGap += (spaceEntry !== null ? spaceEntry.advance : 0) + letterSpacing;
+            continue;
+        }
+        const entry = glyphSource.getGlyphEntry(codepoint);
+        if (entry === null)
+            continue;
+        if (previousCodepoint >= 0)
+            pen += glyphSource.getGlyphKerning(previousCodepoint, codepoint);
+        if (entry.width > 0 && entry.height > 0)
+            glyphs.push({ codepoint, entry, penWithinWord: pen });
+        pen += entry.advance + letterSpacing;
+        previousCodepoint = codepoint;
+        inWord = true;
+    }
+    flush();
+    return tokens;
+}
+// Ensures a backing QuadBatch exists for glyph-atlas `page` (page-indexed in `runtime.quadBatches`,
+// growing and parenting fresh batches as needed) and binds it to that page's atlas image, returning
+// the per-layout page context (batch + atlas + region cache). Returns null when the page has no atlas
+// image to sample — its glyphs are then skipped. Newly grown gap pages get an empty batch bound to
+// their own image; the common single-page source touches only page 0 (created by `createBitmapText`).
+function ensureBitmapTextPageBatch(bitmapText, runtime, glyphSource, color, pages, page) {
+    const cached = pages.get(page);
+    if (cached !== undefined)
+        return cached;
+    const image = glyphSource.getGlyphAtlasImage(page);
+    if (image === null)
+        return null;
+    while (runtime.quadBatches.length <= page) {
+        const created = createQuadBatch({ data: { atlas: createTextureAtlas() } });
+        applyBitmapTextColor(created, color);
+        runtime.quadBatches.push(created);
+        addNodeChild(bitmapText, created);
+    }
+    const quadBatch = runtime.quadBatches[page];
+    const atlas = quadBatch.data.atlas;
+    atlas.image = image;
+    const pageBatch = { atlas, quadBatch, regionByCodepoint: new Map() };
+    pages.set(page, pageBatch);
+    return pageBatch;
+}
+function ensureBoundsRectangle(runtime) {
+    if (runtime.localBoundsRectangle === null)
+        runtime.localBoundsRectangle = createRectangle();
+    return runtime.localBoundsRectangle;
+}
+// Greedy line fill: split the text on explicit newlines into paragraphs, then within each paragraph
+// pack words onto lines, breaking before a word when `wrapWidth` is set and it would overflow. A word
+// wider than `wrapWidth` occupies its own overflowing line (no mid-word breaking).
+function layoutBitmapTextLines(glyphSource, data) {
+    const lines = [];
+    const paragraphs = data.text.split('\n');
+    for (let pi = 0; pi < paragraphs.length; pi++) {
+        const tokens = buildBitmapTextWords(glyphSource, paragraphs[pi], data.letterSpacing);
+        let current = { words: [], gaps: [], width: 0, paragraphEnd: false };
+        for (const token of tokens) {
+            const wraps = data.wrapWidth !== null &&
+                current.words.length > 0 &&
+                current.width + token.gap + token.word.width > data.wrapWidth;
+            if (wraps) {
+                lines.push(current);
+                current = { words: [token.word], gaps: [], width: token.word.width, paragraphEnd: false };
+            }
+            else {
+                if (current.words.length > 0) {
+                    current.gaps.push(token.gap);
+                    current.width += token.gap;
+                }
+                current.words.push(token.word);
+                current.width += token.word.width;
+            }
+        }
+        current.paragraphEnd = true;
+        lines.push(current);
+    }
+    return lines;
+}
+function maxLineWidth(lines) {
+    let max = 0;
+    for (const line of lines)
+        if (line.width > max)
+            max = line.width;
+    return max;
+}
+function setEmptyRectangle(out) {
+    out.x = 0;
+    out.y = 0;
+    out.width = 0;
+    out.height = 0;
+}
+//# sourceMappingURL=updateBitmapText.js.map

package/dist/updateBitmapText.js.map

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

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@flighthq/bitmaptext",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/adjustments": "0.1.0",
+    "@flighthq/displayobject": "0.1.0",
+    "@flighthq/geometry": "0.1.0",
+    "@flighthq/materials": "0.1.0",
+    "@flighthq/node": "0.1.0",
+    "@flighthq/sprite": "0.1.0",
+    "@flighthq/textureatlas": "0.1.0",
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "QuadBatch-backed bitmap text display node laying out glyphs from a GlyphSource",
+  "sideEffects": false
+}

package/src/bitmapText.test.ts

@@ -0,0 +1,222 @@
+import { getDisplayObjectRuntime } from '@flighthq/displayobject';
+import { createRectangle } from '@flighthq/geometry';
+import { getQuadBatchCapacity } from '@flighthq/sprite';
+import type { BitmapTextRuntime, GlyphEntry, GlyphSource, ImageResource } from '@flighthq/types';
+import { BitmapTextKind } from '@flighthq/types';
+import { describe, expect, it } from 'vitest';
+
+import {
+  computeBitmapTextLocalBoundsRectangle,
+  createBitmapText,
+  createBitmapTextData,
+  createBitmapTextRuntime,
+  getBitmapTextBounds,
+  getBitmapTextQuadBatches,
+  reserveBitmapText,
+  setBitmapTextAlign,
+  setBitmapTextColor,
+  setBitmapTextGlyphSource,
+  setBitmapTextLetterSpacing,
+  setBitmapTextLineHeight,
+  setBitmapTextText,
+  setBitmapTextWrapWidth,
+} from './bitmapText';
+import { updateBitmapText } from './updateBitmapText';
+
+// A single-page glyph source: A/B are 6x8, a space advances 5, and page 0 is a stub `ImageResource`.
+function createTestGlyphSource(): GlyphSource {
+  const entries = new Map<number, GlyphEntry>();
+  const add = (cp: number, x: number): void => {
+    entries.set(cp, { advance: 10, bearingX: 0, bearingY: 8, height: 8, page: 0, width: 6, x, y: 0 });
+  };
+  add(0x41, 0); // A
+  add(0x42, 6); // B
+  entries.set(0x20, { advance: 5, bearingX: 0, bearingY: 0, height: 0, page: 0, width: 0, x: 0, y: 0 }); // space
+  const image = {} as ImageResource;
+  return {
+    getGlyphAtlasImage: (page = 0) => (page === 0 ? image : null),
+    getGlyphEntry: (cp) => entries.get(cp) ?? null,
+    getGlyphKerning: () => 0,
+    getGlyphMetrics: () => ({ ascent: 8, descent: 2, lineGap: 0 }),
+  };
+}
+
+describe('computeBitmapTextLocalBoundsRectangle', () => {
+  it('writes the laid-out text extent into a distinct out rectangle', () => {
+    const text = createBitmapText(createTestGlyphSource(), { text: 'A' });
+    updateBitmapText(text);
+    const out = createRectangle();
+    computeBitmapTextLocalBoundsRectangle(out, text);
+    expect(out.x).toBe(0);
+    expect(out.y).toBe(0);
+    expect(out.width).toBe(6);
+    expect(out.height).toBe(8);
+  });
+
+  it('is safe when out aliases the cached bounds rectangle', () => {
+    const text = createBitmapText(createTestGlyphSource(), { text: 'A' });
+    updateBitmapText(text);
+    const cached = (getDisplayObjectRuntime(text) as BitmapTextRuntime).localBoundsRectangle;
+    expect(cached).not.toBeNull();
+    computeBitmapTextLocalBoundsRectangle(cached!, text);
+    expect(cached!.width).toBe(6);
+    expect(cached!.height).toBe(8);
+  });
+
+  it('writes zeros before the first layout', () => {
+    const text = createBitmapText(createTestGlyphSource());
+    const out = createRectangle();
+    out.width = 99;
+    computeBitmapTextLocalBoundsRectangle(out, text);
+    expect(out.width).toBe(0);
+  });
+});
+
+describe('createBitmapText', () => {
+  it('creates a BitmapText node with a backing QuadBatch child', () => {
+    const text = createBitmapText(createTestGlyphSource());
+    expect(text.kind).toBe(BitmapTextKind);
+    const batches = getBitmapTextQuadBatches(text);
+    expect(batches).toHaveLength(1);
+    expect(getDisplayObjectRuntime(text).children).toContain(batches[0]);
+  });
+
+  it('applies construction options to node data', () => {
+    const text = createBitmapText(createTestGlyphSource(), {
+      align: 'center',
+      color: 0xff0000ff,
+      letterSpacing: 2,
+      lineHeight: 1.5,
+      text: 'Hi',
+      wrapWidth: 120,
+    });
+    expect(text.data.align).toBe('center');
+    expect(text.data.color).toBe(0xff0000ff);
+    expect(text.data.letterSpacing).toBe(2);
+    expect(text.data.lineHeight).toBe(1.5);
+    expect(text.data.text).toBe('Hi');
+    expect(text.data.wrapWidth).toBe(120);
+  });
+
+  it('binds the supplied glyph source', () => {
+    const glyphSource = createTestGlyphSource();
+    const text = createBitmapText(glyphSource);
+    expect(text.data.glyphSource).toBe(glyphSource);
+  });
+});
+
+describe('createBitmapTextData', () => {
+  it('defaults to left-aligned white empty unwrapped text', () => {
+    const data = createBitmapTextData();
+    expect(data.align).toBe('left');
+    expect(data.color).toBe(0xffffffff);
+    expect(data.glyphSource).toBeNull();
+    expect(data.letterSpacing).toBe(0);
+    expect(data.lineHeight).toBe(1);
+    expect(data.text).toBe('');
+    expect(data.wrapWidth).toBeNull();
+  });
+
+  it('honors provided overrides', () => {
+    const data = createBitmapTextData({ align: 'right', text: 'x', wrapWidth: 50 });
+    expect(data.align).toBe('right');
+    expect(data.text).toBe('x');
+    expect(data.wrapWidth).toBe(50);
+  });
+});
+
+describe('createBitmapTextRuntime', () => {
+  it('starts with null bounds and no page batches', () => {
+    const runtime = createBitmapTextRuntime();
+    expect(runtime.localBoundsRectangle).toBeNull();
+    expect(runtime.quadBatches).toEqual([]);
+  });
+});
+
+describe('getBitmapTextBounds', () => {
+  it('allocates a rectangle covering the laid-out glyphs', () => {
+    const text = createBitmapText(createTestGlyphSource(), { text: 'AB' });
+    updateBitmapText(text);
+    const bounds = getBitmapTextBounds(text);
+    expect(bounds.x).toBe(0);
+    expect(bounds.y).toBe(0);
+    expect(bounds.width).toBe(16); // B at x=10, region width 6 → right edge 16
+    expect(bounds.height).toBe(8);
+  });
+});
+
+describe('getBitmapTextQuadBatches', () => {
+  it('returns the backing batches in page order, matching the node children', () => {
+    const text = createBitmapText(createTestGlyphSource());
+    const batches = getBitmapTextQuadBatches(text);
+    expect(batches).toHaveLength(1);
+    expect(batches[0]).toBe(getDisplayObjectRuntime(text).children![0]);
+  });
+});
+
+describe('reserveBitmapText', () => {
+  it('grows the backing quad batch capacity', () => {
+    const text = createBitmapText(createTestGlyphSource());
+    reserveBitmapText(text, 64);
+    expect(getQuadBatchCapacity(getBitmapTextQuadBatches(text)[0]!)).toBeGreaterThanOrEqual(64);
+  });
+});
+
+describe('setBitmapTextAlign', () => {
+  it('mutates the align field', () => {
+    const text = createBitmapText(createTestGlyphSource());
+    setBitmapTextAlign(text, 'justify');
+    expect(text.data.align).toBe('justify');
+  });
+});
+
+describe('setBitmapTextColor', () => {
+  it('mutates the color field', () => {
+    const text = createBitmapText(createTestGlyphSource());
+    setBitmapTextColor(text, 0x00ff00ff);
+    expect(text.data.color).toBe(0x00ff00ff);
+  });
+});
+
+describe('setBitmapTextGlyphSource', () => {
+  it('rebinds the glyph source', () => {
+    const text = createBitmapText(createTestGlyphSource());
+    const next = createTestGlyphSource();
+    setBitmapTextGlyphSource(text, next);
+    expect(text.data.glyphSource).toBe(next);
+  });
+});
+
+describe('setBitmapTextLetterSpacing', () => {
+  it('mutates the letterSpacing field', () => {
+    const text = createBitmapText(createTestGlyphSource());
+    setBitmapTextLetterSpacing(text, 3);
+    expect(text.data.letterSpacing).toBe(3);
+  });
+});
+
+describe('setBitmapTextLineHeight', () => {
+  it('mutates the lineHeight field', () => {
+    const text = createBitmapText(createTestGlyphSource());
+    setBitmapTextLineHeight(text, 2);
+    expect(text.data.lineHeight).toBe(2);
+  });
+});
+
+describe('setBitmapTextText', () => {
+  it('mutates the text field', () => {
+    const text = createBitmapText(createTestGlyphSource());
+    setBitmapTextText(text, 'changed');
+    expect(text.data.text).toBe('changed');
+  });
+});
+
+describe('setBitmapTextWrapWidth', () => {
+  it('mutates the wrapWidth field', () => {
+    const text = createBitmapText(createTestGlyphSource());
+    setBitmapTextWrapWidth(text, 200);
+    expect(text.data.wrapWidth).toBe(200);
+    setBitmapTextWrapWidth(text, null);
+    expect(text.data.wrapWidth).toBeNull();
+  });
+});

package/src/updateBitmapText.test.ts

@@ -0,0 +1,240 @@
+import { getDisplayObjectColorAdjustments } from '@flighthq/displayobject';
+import type { ColorTransformAdjustment, GlyphEntry, GlyphSource, ImageResource } from '@flighthq/types';
+import { describe, expect, it } from 'vitest';
+
+import { createBitmapText, getBitmapTextBounds, getBitmapTextQuadBatches, setBitmapTextColor } from './bitmapText';
+import { updateBitmapText } from './updateBitmapText';
+
+// A deterministic single-page glyph source: every visible glyph is 6x8 with advance 10 and bearingY 8
+// (so line tops sit at y=0), a space advances 5 with no pixels, and the pair (A, B) kerns by -2. All
+// glyphs live on page 0, whose atlas image is a stub `ImageResource`.
+function createTestGlyphSource(): GlyphSource {
+  const entries = new Map<number, GlyphEntry>();
+  const add = (cp: number, x: number): void => {
+    entries.set(cp, { advance: 10, bearingX: 0, bearingY: 8, height: 8, page: 0, width: 6, x, y: 0 });
+  };
+  add(0x41, 0); // A
+  add(0x42, 6); // B
+  entries.set(0x20, { advance: 5, bearingX: 0, bearingY: 0, height: 0, page: 0, width: 0, x: 0, y: 0 }); // space
+  const kerning = new Map<number, number>([[(0x41 << 16) | 0x42, -2]]);
+  const image = {} as ImageResource;
+  return {
+    getGlyphAtlasImage: (page = 0) => (page === 0 ? image : null),
+    getGlyphEntry: (cp) => entries.get(cp) ?? null,
+    getGlyphKerning: (l, r) => kerning.get((l << 16) | r) ?? 0,
+    getGlyphMetrics: () => ({ ascent: 8, descent: 2, lineGap: 0 }),
+  };
+}
+
+// A two-page glyph source: 'A' lives on page 0, 'B' on page 1, each page a DISTINCT stub image.
+function createTwoPageGlyphSource(): { source: GlyphSource; page0Image: ImageResource; page1Image: ImageResource } {
+  const page0Image = {} as ImageResource;
+  const page1Image = {} as ImageResource;
+  const entries = new Map<number, GlyphEntry>([
+    [0x41, { advance: 10, bearingX: 0, bearingY: 8, height: 8, page: 0, width: 6, x: 0, y: 0 }], // A → page 0
+    [0x42, { advance: 10, bearingX: 0, bearingY: 8, height: 8, page: 1, width: 6, x: 3, y: 0 }], // B → page 1
+  ]);
+  const source: GlyphSource = {
+    getGlyphAtlasImage: (page = 0) => (page === 0 ? page0Image : page === 1 ? page1Image : null),
+    getGlyphEntry: (cp) => entries.get(cp) ?? null,
+    getGlyphKerning: () => 0,
+    getGlyphMetrics: () => ({ ascent: 8, descent: 2, lineGap: 0 }),
+  };
+  return { source, page0Image, page1Image };
+}
+
+describe('updateBitmapText', () => {
+  it('places each glyph at its cumulative advance, applying kerning', () => {
+    const text = createBitmapText(createTestGlyphSource(), { text: 'AB' });
+    updateBitmapText(text);
+    const data = getBitmapTextQuadBatches(text)[0]!.data;
+    expect(data.instanceCount).toBe(2);
+    expect(data.transforms[0]).toBe(0); // A.x
+    expect(data.transforms[1]).toBe(0); // A.y
+    expect(data.transforms[2]).toBe(8); // B.x = 10 (advance) - 2 (kerning)
+    expect(data.transforms[3]).toBe(0); // B.y
+  });
+
+  it('builds one atlas region per distinct glyph and references it by id', () => {
+    const text = createBitmapText(createTestGlyphSource(), { text: 'AB' });
+    updateBitmapText(text);
+    const data = getBitmapTextQuadBatches(text)[0]!.data;
+    expect(data.atlas!.regions).toHaveLength(2);
+    expect(data.ids[0]).toBe(0);
+    expect(data.ids[1]).toBe(1);
+    expect(data.atlas!.regions[0].x).toBe(0); // A rect
+    expect(data.atlas!.regions[1].x).toBe(6); // B rect
+  });
+
+  it('reuses one region for repeated codepoints', () => {
+    const text = createBitmapText(createTestGlyphSource(), { text: 'AA' });
+    updateBitmapText(text);
+    const data = getBitmapTextQuadBatches(text)[0]!.data;
+    expect(data.instanceCount).toBe(2);
+    expect(data.atlas!.regions).toHaveLength(1);
+    expect(data.ids[0]).toBe(0);
+    expect(data.ids[1]).toBe(0);
+  });
+
+  it('starts a new line at the metric line advance on an explicit newline', () => {
+    const text = createBitmapText(createTestGlyphSource(), { text: 'A\nB' });
+    updateBitmapText(text);
+    const data = getBitmapTextQuadBatches(text)[0]!.data;
+    expect(data.instanceCount).toBe(2);
+    expect(data.transforms[0]).toBe(0); // line 0 A.x
+    expect(data.transforms[1]).toBe(0); // line 0 A.y
+    expect(data.transforms[2]).toBe(0); // line 1 B.x
+    expect(data.transforms[3]).toBe(10); // line 1 B.y = 1 * (8 + 2 + 0)
+  });
+
+  it('scales the line advance by lineHeight', () => {
+    const text = createBitmapText(createTestGlyphSource(), { text: 'A\nB', lineHeight: 2 });
+    updateBitmapText(text);
+    const data = getBitmapTextQuadBatches(text)[0]!.data;
+    expect(data.transforms[3]).toBe(20); // 2 * (8 + 2 + 0)
+  });
+
+  it('word-wraps at a word boundary when the width is exceeded', () => {
+    const text = createBitmapText(createTestGlyphSource(), { text: 'AA AA', wrapWidth: 30 });
+    updateBitmapText(text);
+    const data = getBitmapTextQuadBatches(text)[0]!.data;
+    expect(data.instanceCount).toBe(4);
+    let firstLine = 0;
+    let secondLine = 0;
+    for (let i = 0; i < data.instanceCount; i++) {
+      if (data.transforms[i * 2 + 1] === 0) firstLine++;
+      else if (data.transforms[i * 2 + 1] === 10) secondLine++;
+    }
+    expect(firstLine).toBe(2);
+    expect(secondLine).toBe(2);
+  });
+
+  it('keeps words on one line and honors space advance when no wrap is set', () => {
+    const text = createBitmapText(createTestGlyphSource(), { text: 'AA AA' });
+    updateBitmapText(text);
+    const data = getBitmapTextQuadBatches(text)[0]!.data;
+    expect(data.instanceCount).toBe(4);
+    for (let i = 0; i < data.instanceCount; i++) expect(data.transforms[i * 2 + 1]).toBe(0);
+    expect(data.transforms[4]).toBe(25); // third glyph: word1 width 20 + space 5
+    expect(data.transforms[6]).toBe(35);
+  });
+
+  it('offsets a line for center alignment', () => {
+    const text = createBitmapText(createTestGlyphSource(), { text: 'AB', wrapWidth: 100, align: 'center' });
+    updateBitmapText(text);
+    const data = getBitmapTextQuadBatches(text)[0]!.data;
+    expect(data.transforms[0]).toBe(41); // (100 - 18) / 2
+    expect(data.transforms[2]).toBe(49); // 41 + 8
+  });
+
+  it('offsets a line for right alignment', () => {
+    const text = createBitmapText(createTestGlyphSource(), { text: 'AB', wrapWidth: 100, align: 'right' });
+    updateBitmapText(text);
+    const data = getBitmapTextQuadBatches(text)[0]!.data;
+    expect(data.transforms[0]).toBe(82); // 100 - 18
+  });
+
+  it('stretches inter-word gaps for justify on non-final lines', () => {
+    const text = createBitmapText(createTestGlyphSource(), { text: 'AA AA AA', wrapWidth: 50, align: 'justify' });
+    updateBitmapText(text);
+    const data = getBitmapTextQuadBatches(text)[0]!.data;
+    // Line 0 = "AA AA" justified to 50: gap 5 grows by (50 - 45) / 1 = 5, so word 2 starts at 30.
+    expect(data.transforms[4]).toBe(30);
+    expect(data.transforms[6]).toBe(40);
+    // Line 1 = trailing "AA" (paragraph end) stays left.
+    const line1 = [];
+    for (let i = 0; i < data.instanceCount; i++)
+      if (data.transforms[i * 2 + 1] === 10) line1.push(data.transforms[i * 2]);
+    expect(line1).toEqual([0, 10]);
+  });
+
+  it('omits a missing glyph with no quad and no advance', () => {
+    const text = createBitmapText(createTestGlyphSource(), { text: 'A?B' });
+    updateBitmapText(text);
+    const data = getBitmapTextQuadBatches(text)[0]!.data;
+    expect(data.instanceCount).toBe(2);
+    expect(data.transforms[0]).toBe(0); // A
+    expect(data.transforms[2]).toBe(8); // B placed as if '?' were absent (10 - 2 kerning)
+  });
+
+  it('adds letterSpacing after each glyph advance', () => {
+    const text = createBitmapText(createTestGlyphSource(), { text: 'AB', letterSpacing: 1 });
+    updateBitmapText(text);
+    const data = getBitmapTextQuadBatches(text)[0]!.data;
+    expect(data.transforms[2]).toBe(9); // 10 + 1 (spacing) - 2 (kerning)
+  });
+
+  it('lays out an empty string as an empty batch without throwing', () => {
+    const text = createBitmapText(createTestGlyphSource(), { text: '' });
+    expect(() => updateBitmapText(text)).not.toThrow();
+    expect(getBitmapTextQuadBatches(text)[0]!.data.instanceCount).toBe(0);
+    const bounds = getBitmapTextBounds(text);
+    expect(bounds.width).toBe(0);
+    expect(bounds.height).toBe(0);
+  });
+
+  it('reports laid-out bounds covering the glyph extent', () => {
+    const text = createBitmapText(createTestGlyphSource(), { text: 'AB' });
+    updateBitmapText(text);
+    const bounds = getBitmapTextBounds(text);
+    expect(bounds.x).toBe(0);
+    expect(bounds.y).toBe(0);
+    expect(bounds.width).toBe(14); // B at x=8, region width 6 → right edge 14
+    expect(bounds.height).toBe(8);
+  });
+
+  it('sets a whole-batch color-transform tint only for non-white colors', () => {
+    const text = createBitmapText(createTestGlyphSource(), { text: 'AB' });
+    updateBitmapText(text);
+    expect(getDisplayObjectColorAdjustments(getBitmapTextQuadBatches(text)[0]!)).toBeNull();
+    setBitmapTextColor(text, 0xff0000ff);
+    updateBitmapText(text);
+    // One color-transform adjustment on the batch's runtime slot — a single whole-batch tint, not per-glyph.
+    const adjustments = getDisplayObjectColorAdjustments(getBitmapTextQuadBatches(text)[0]!);
+    expect(adjustments).not.toBeNull();
+    expect(adjustments!).toHaveLength(1);
+    const colorTransform = (adjustments![0] as ColorTransformAdjustment).colorTransform;
+    expect(colorTransform.redMultiplier).toBe(1);
+    expect(colorTransform.greenMultiplier).toBe(0);
+  });
+
+  it('produces exactly one batch bound to the page-0 image for a single-page source', () => {
+    const source = createTestGlyphSource();
+    const text = createBitmapText(source, { text: 'AB' });
+    updateBitmapText(text);
+    const batches = getBitmapTextQuadBatches(text);
+    expect(batches).toHaveLength(1);
+    expect(batches[0].data.instanceCount).toBe(2);
+    expect(batches[0].data.atlas!.image).toBe(source.getGlyphAtlasImage(0));
+  });
+
+  it('partitions glyphs into one QuadBatch per page, each bound to its own page image', () => {
+    const { source, page0Image, page1Image } = createTwoPageGlyphSource();
+    const text = createBitmapText(source, { text: 'AB' });
+    updateBitmapText(text);
+    const batches = getBitmapTextQuadBatches(text);
+    expect(batches).toHaveLength(2);
+
+    // Page 0 holds 'A' only, sampling page0Image; page 1 holds 'B' only, sampling page1Image.
+    const page0 = batches[0].data;
+    const page1 = batches[1].data;
+    expect(page0.instanceCount).toBe(1);
+    expect(page1.instanceCount).toBe(1);
+    expect(page0.atlas!.image).toBe(page0Image);
+    expect(page1.atlas!.image).toBe(page1Image);
+    expect(page0.atlas!.regions[0].x).toBe(0); // A's rect on page 0
+    expect(page1.atlas!.regions[0].x).toBe(3); // B's rect on page 1
+    expect(page0.transforms[0]).toBe(0); // A at pen origin
+    expect(page1.transforms[0]).toBe(10); // B after A's advance (no kerning)
+  });
+
+  it('spans every page when computing bounds', () => {
+    const { source } = createTwoPageGlyphSource();
+    const text = createBitmapText(source, { text: 'AB' });
+    updateBitmapText(text);
+    const bounds = getBitmapTextBounds(text);
+    expect(bounds.x).toBe(0);
+    expect(bounds.width).toBe(16); // B (page 1) at x=10, width 6 → right edge 16
+    expect(bounds.height).toBe(8);
+  });
+});