@flighthq/bitmaptext 0.5.1-next.597.ab004dd → 0.5.1-next.638.d4dbd4e

package/README.md

@@ -13,5 +13,5 @@ Import the supported application-facing API from `@flighthq/bitmaptext`. The `@f
 This package is part of the locked-version Flight SDK graph. Applications may instead install and import `@flighthq/sdk` when package-level tree shaking is sufficient.
 
 - [Flight project](https://github.com/flighthq/flight)
-- [Source for @flighthq/bitmaptext@0.5.1-next.597.ab004dd](https://github.com/flighthq/flight/tree/ab004ddc85b350cbd99a944e1e8108a016ae8af0/packages/bitmaptext)
-- [License](https://github.com/flighthq/flight/blob/ab004ddc85b350cbd99a944e1e8108a016ae8af0/LICENSE.md)
+- [Source for @flighthq/bitmaptext@0.5.1-next.638.d4dbd4e](https://github.com/flighthq/flight/tree/d4dbd4e347dc8be10b180c85a766ab50333dcb51/packages/bitmaptext)
+- [License](https://github.com/flighthq/flight/blob/d4dbd4e347dc8be10b180c85a766ab50333dcb51/LICENSE.md)

package/dist/bitmapText.d.ts

@@ -5,6 +5,7 @@ export declare function createBitmapTextData(data?: Readonly<Partial<BitmapTextD
 export declare function createBitmapTextRuntime(): BitmapTextRuntime;
 export declare function getBitmapTextBounds(source: Readonly<BitmapText>): Rectangle;
 export declare function getBitmapTextPages(source: Readonly<BitmapText>): readonly BitmapTextPage[];
+export declare function isBitmapTextGlyphLayoutStale(source: Readonly<BitmapText>): boolean;
 export declare function reserveBitmapText(target: BitmapText, glyphCapacity: number): void;
 export declare function setBitmapTextAlign(target: BitmapText, align: BitmapTextAlign): void;
 export declare function setBitmapTextGlyphSource(target: BitmapText, glyphSource: GlyphSource | null): void;

package/dist/bitmapText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bitmapText.d.ts","sourceRoot":"","sources":["../src/bitmapText.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,WAAW,EAGX,SAAS,EACV,MAAM,0BAA0B,CAAC;AASlC,wBAAgB,qCAAqC,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,CAWxG;AASD,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,UAAU,CAanH;AAED,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,GAAG,cAAc,CAS7F;AAED,wBAAgB,uBAAuB,IAAI,iBAAiB,CAK3D;AAID,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,SAAS,CAI3E;AAID,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,SAAS,cAAc,EAAE,CAE1F;AAKD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAMjF;AAGD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAEnF;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"}
+{"version":3,"file":"bitmapText.d.ts","sourceRoot":"","sources":["../src/bitmapText.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,WAAW,EAGX,SAAS,EACV,MAAM,0BAA0B,CAAC;AASlC,wBAAgB,qCAAqC,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,IAAI,CAWxG;AASD,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,iBAAiB,CAAC,GAAG,UAAU,CAanH;AAED,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,GAAG,cAAc,CAS7F;AAED,wBAAgB,uBAAuB,IAAI,iBAAiB,CAQ3D;AAID,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,SAAS,CAI3E;AAID,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,SAAS,cAAc,EAAE,CAE1F;AAOD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,GAAG,OAAO,CAIlF;AAKD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAMjF;AAGD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAEnF;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

@@ -48,6 +48,9 @@ export function createBitmapTextData(data) {
 }
 export function createBitmapTextRuntime() {
     const runtime = createNode2DRuntime(defaultMethods);
+    // -1 is below every real version, so a node that has never been laid out reads stale and one
+    // `refreshBitmapTextGlyphLayout` brings it up — no separate "was it ever updated" flag.
+    runtime.glyphLayoutVersion = -1;
     runtime.localBoundsRectangle = null;
     runtime.pages = [];
     return runtime;
@@ -64,6 +67,17 @@ export function getBitmapTextBounds(source) {
 export function getBitmapTextPages(source) {
     return getNode2DRuntime(source).pages;
 }
+// True when the page regions baked by the last `updateBitmapText` no longer describe the glyphs they
+// were built for, because the bound glyph source has repacked since. Rects that have gone stale stay
+// well-formed — they simply cover other glyphs now — so this version comparison is the only way to
+// tell, and it is the check `refreshBitmapTextGlyphLayout` performs. A node that has never been laid
+// out reads true; a node with no glyph source, or one bound to a static font, reads false forever.
+export function isBitmapTextGlyphLayoutStale(source) {
+    const glyphSource = source.data.glyphSource;
+    if (glyphSource === null)
+        return false;
+    return getNode2DRuntime(source).glyphLayoutVersion !== glyphSource.getGlyphLayoutVersion();
+}
 // Grows each page's quad arrays 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 over-allocates for multi-page text but never under-sizes.

package/dist/bitmapText.js.map

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

package/dist/contract.d.ts

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

package/dist/contract.d.ts.map

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

package/dist/contract.js

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

package/dist/contract.js.map

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

package/dist/enableBitmapTextGuards.d.ts

@@ -0,0 +1,20 @@
+/** Uninstalls the guard installed by `enableBitmapTextGuards`. */
+export declare function disableBitmapTextGuards(): void;
+/**
+ * Installs the caller-facing bitmap-text guard (opt-in, dev-only). It warns once — through
+ * `@flighthq/log` — when a layout never settles:
+ *
+ * **The layout did not converge.** `updateBitmapText` re-runs a layout whose glyph rects a repack
+ * invalidated mid-pass, and it ran out of passes. The string needs more glyphs resident at once than
+ * the atlas can hold, so rasterizing the end of it evicts the start, every pass invalidates the one
+ * before, and the quads that get drawn sample whatever displaced them. Unlike a full cache this does
+ * not resolve itself with use: the atlas has to be bigger or the font smaller.
+ *
+ * Pair with `isBitmapTextGlyphLayoutStale` for a pull-style answer about one node, and with
+ * `enableGlyphAtlasGuards` for the atlas-side view of the same pressure — that one reports the repacks
+ * and the glyphs they drop, this one reports the text that could not be laid out through them. Not
+ * importing this module costs production nothing: the wording and the `@flighthq/log` dependency live
+ * only here.
+ */
+export declare function enableBitmapTextGuards(): void;
+//# sourceMappingURL=enableBitmapTextGuards.d.ts.map

package/dist/enableBitmapTextGuards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enableBitmapTextGuards.d.ts","sourceRoot":"","sources":["../src/enableBitmapTextGuards.ts"],"names":[],"mappings":"AAKA,kEAAkE;AAClE,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}

package/dist/enableBitmapTextGuards.js

@@ -0,0 +1,35 @@
+import { logOnce } from '@flighthq/log/contract';
+import { LogLevel } from '@flighthq/types/contract';
+import { setBitmapTextLayoutGuard } from './updateBitmapText';
+/** Uninstalls the guard installed by `enableBitmapTextGuards`. */
+export function disableBitmapTextGuards() {
+    setBitmapTextLayoutGuard(null);
+}
+/**
+ * Installs the caller-facing bitmap-text guard (opt-in, dev-only). It warns once — through
+ * `@flighthq/log` — when a layout never settles:
+ *
+ * **The layout did not converge.** `updateBitmapText` re-runs a layout whose glyph rects a repack
+ * invalidated mid-pass, and it ran out of passes. The string needs more glyphs resident at once than
+ * the atlas can hold, so rasterizing the end of it evicts the start, every pass invalidates the one
+ * before, and the quads that get drawn sample whatever displaced them. Unlike a full cache this does
+ * not resolve itself with use: the atlas has to be bigger or the font smaller.
+ *
+ * Pair with `isBitmapTextGlyphLayoutStale` for a pull-style answer about one node, and with
+ * `enableGlyphAtlasGuards` for the atlas-side view of the same pressure — that one reports the repacks
+ * and the glyphs they drop, this one reports the text that could not be laid out through them. Not
+ * importing this module costs production nothing: the wording and the `@flighthq/log` dependency live
+ * only here.
+ */
+export function enableBitmapTextGuards() {
+    setBitmapTextLayoutGuard(warnOnBitmapTextLayoutBlocked);
+}
+function warnOnBitmapTextLayoutBlocked(_reason, attempts) {
+    logOnce('bitmaptext:layout-did-not-converge', LogLevel.Warn, {
+        message: `updateBitmapText: the glyph source repacked during all ${attempts} layout passes, so this text ` +
+            'never settled — its glyphs cannot all be resident in the atlas at once, and the quads drawn from ' +
+            'the final pass sample stale rects. Enlarge the glyph atlas or reduce the font size; ' +
+            'enableGlyphAtlasGuards reports the repacks from the atlas side.',
+    }, 'bitmaptext');
+}
+//# sourceMappingURL=enableBitmapTextGuards.js.map

package/dist/enableBitmapTextGuards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enableBitmapTextGuards.js","sourceRoot":"","sources":["../src/enableBitmapTextGuards.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAE9D,kEAAkE;AAClE,MAAM,UAAU,uBAAuB;IACrC,wBAAwB,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,sBAAsB;IACpC,wBAAwB,CAAC,6BAA6B,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,6BAA6B,CAAC,OAAe,EAAE,QAAgB;IACtE,OAAO,CACL,oCAAoC,EACpC,QAAQ,CAAC,IAAI,EACb;QACE,OAAO,EACL,0DAA0D,QAAQ,+BAA+B;YACjG,mGAAmG;YACnG,sFAAsF;YACtF,iEAAiE;KACpE,EACD,YAAY,CACb,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { computeBitmapTextLocalBoundsRectangle, createBitmapText, getBitmapTextBounds, getBitmapTextPages, reserveBitmapText, setBitmapTextAlign, setBitmapTextGlyphSource, setBitmapTextLetterSpacing, setBitmapTextLineHeight, setBitmapTextText, setBitmapTextWrapWidth, updateBitmapText, } from './contract';
+export { computeBitmapTextLocalBoundsRectangle, createBitmapText, disableBitmapTextGuards, enableBitmapTextGuards, getBitmapTextBounds, getBitmapTextPages, isBitmapTextGlyphLayoutStale, refreshBitmapTextGlyphLayout, reserveBitmapText, setBitmapTextAlign, setBitmapTextGlyphSource, setBitmapTextLetterSpacing, setBitmapTextLineHeight, setBitmapTextText, setBitmapTextWrapWidth, updateBitmapText, } from './contract';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qCAAqC,EACrC,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qCAAqC,EACrC,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,4BAA4B,EAC5B,4BAA4B,EAC5B,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { computeBitmapTextLocalBoundsRectangle, createBitmapText, getBitmapTextBounds, getBitmapTextPages, reserveBitmapText, setBitmapTextAlign, setBitmapTextGlyphSource, setBitmapTextLetterSpacing, setBitmapTextLineHeight, setBitmapTextText, setBitmapTextWrapWidth, updateBitmapText, } from './contract';
+export { computeBitmapTextLocalBoundsRectangle, createBitmapText, disableBitmapTextGuards, enableBitmapTextGuards, getBitmapTextBounds, getBitmapTextPages, isBitmapTextGlyphLayoutStale, refreshBitmapTextGlyphLayout, reserveBitmapText, setBitmapTextAlign, setBitmapTextGlyphSource, setBitmapTextLetterSpacing, setBitmapTextLineHeight, setBitmapTextText, setBitmapTextWrapWidth, updateBitmapText, } from './contract';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qCAAqC,EACrC,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qCAAqC,EACrC,gBAAgB,EAChB,uBAAuB,EACvB,sBAAsB,EACtB,mBAAmB,EACnB,kBAAkB,EAClB,4BAA4B,EAC5B,4BAA4B,EAC5B,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,GACjB,MAAM,YAAY,CAAC"}

package/dist/updateBitmapText.d.ts

@@ -1,3 +1,8 @@
 import type { BitmapText } from '@flighthq/types/contract';
+export declare function refreshBitmapTextGlyphLayout(bitmapText: BitmapText): boolean;
+/** Installs the bitmap-text guard, or clears it with `null`. The seam keeps the wording and the
+ *  `@flighthq/log` dependency in the separately-importable guard module rather than in layout; not
+ *  importing that module costs production nothing. Called by `enableBitmapTextGuards`. */
+export declare function setBitmapTextLayoutGuard(guard: ((reason: string, attempts: number) => void) | null): void;
 export declare function updateBitmapText(bitmapText: BitmapText): void;
 //# sourceMappingURL=updateBitmapText.d.ts.map

package/dist/updateBitmapText.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"updateBitmapText.d.ts","sourceRoot":"","sources":["../src/updateBitmapText.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,UAAU,EAOX,MAAM,0BAA0B,CAAC;AAgBlC,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CA2E7D"}
+{"version":3,"file":"updateBitmapText.d.ts","sourceRoot":"","sources":["../src/updateBitmapText.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,UAAU,EAOX,MAAM,0BAA0B,CAAC;AAWlC,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAI5E;AAED;;0FAE0F;AAC1F,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAEzG;AAsBD,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAwB7D"}

package/dist/updateBitmapText.js

@@ -3,9 +3,26 @@ import { invalidateNodeLocalBounds } from '@flighthq/node/contract';
 import { getNode2DRuntime } from '@flighthq/scene2d/contract';
 import { createTexture, setTextureSource } from '@flighthq/texture/contract';
 import { addTextureAtlasRegion, createTextureAtlas } from '@flighthq/textureatlas/contract';
-const BITMAP_TEXT_TRANSFORM_STRIDE = 2;
-const CARRIAGE_RETURN = 0x0d;
-const SPACE = 0x20;
+import { isBitmapTextGlyphLayoutStale } from './bitmapText';
+// Re-lays-out `bitmapText` when, and only when, its glyph source has repacked since the last layout —
+// the pairing that keeps a dynamic atlas correct. Returns whether it re-laid-out, so a caller can count
+// churn. Call it once per frame per BitmapText bound to a `@flighthq/glyphatlas` source: a repack
+// triggered by ANY consumer of that atlas (another BitmapText adding a glyph, a direct
+// `getGlyphAtlasEntry`) relocates this node's glyphs, and its baked page regions then sample whatever
+// took their place. The comparison is one number against one number, so the frames where nothing
+// repacked cost nothing. A node bound to a static bitmap font never re-lays-out here.
+export function refreshBitmapTextGlyphLayout(bitmapText) {
+    if (!isBitmapTextGlyphLayoutStale(bitmapText))
+        return false;
+    updateBitmapText(bitmapText);
+    return true;
+}
+/** Installs the bitmap-text guard, or clears it with `null`. The seam keeps the wording and the
+ *  `@flighthq/log` dependency in the separately-importable guard module rather than in layout; not
+ *  importing that module costs production nothing. Called by `enableBitmapTextGuards`. */
+export function setBitmapTextLayoutGuard(guard) {
+    _layoutGuard = guard;
+}
 // Lays out `bitmapText`'s current string and rewrites its `BitmapTextPage` quads: one quad per visible
 // glyph, partitioned by the glyph's atlas page into one page's quads, positioned by the glyph source's
 // advances and kerning, broken on explicit newlines and (when `wrapWidth` is set) at word boundaries,
@@ -16,84 +33,40 @@ const SPACE = 0x20;
 // glyphs are skipped. Missing glyphs (`getGlyphEntry` → null) are omitted entirely — no quad and no
 // advance. Bounds span every drawn glyph across all pages. Tint is the node's own color-adjustment stack,
 // not touched here.
+//
+// A dynamic glyph source can repack DURING this call: rasterizing a glyph late in the string can evict
+// one placed early in it. A repack that merely relocates a survivor needs nothing from this pass — the
+// atlas moves the same entry object the pass is holding, so the emit below reads the new rect. What
+// this loop exists for is a repack that DROPS a glyph: the entry the pass captured is then orphaned at
+// a rect another glyph has taken over, and only re-running the pass reaches the fresh one. So the
+// layout runs against a placement version and repeats while that version moves under it, and the
+// version the winning pass agreed with is what gets stamped for `isBitmapTextGlyphLayoutStale`. Passes
+// are bounded — a string whose glyphs cannot all be resident at once would otherwise evict each other
+// forever — and the guard layer reports a string that never settles.
 export function updateBitmapText(bitmapText) {
-    const data = bitmapText.data;
     const runtime = getNode2DRuntime(bitmapText);
-    const bounds = ensureBoundsRectangle(runtime);
-    // Clear every existing page; pages with glyphs this layout are refilled below, pages that fall silent
-    // stay as empty pages drawing nothing.
-    for (const page of runtime.pages) {
-        page.instanceCount = 0;
-        page.atlas.regions.length = 0;
-    }
-    const glyphSource = data.glyphSource;
-    if (glyphSource === null || data.text.length === 0) {
-        setEmptyRectangle(bounds);
-        invalidateNodeLocalBounds(bitmapText);
+    const glyphSource = bitmapText.data.glyphSource;
+    if (glyphSource === null) {
+        layoutBitmapTextPages(bitmapText, runtime);
+        runtime.glyphLayoutVersion = -1;
         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 context = ensureBitmapTextPage(runtime, glyphSource, pages, entry.page);
-                if (context === null)
-                    continue;
-                const quadX = penX + glyph.penWithinWord + entry.bearingX;
-                const quadY = baselineY - entry.bearingY;
-                let regionId = context.regionByCodepoint.get(glyph.codepoint);
-                if (regionId === undefined) {
-                    addTextureAtlasRegion(context.page.atlas, entry.x, entry.y, entry.width, entry.height);
-                    regionId = context.page.atlas.regions.length - 1;
-                    context.regionByCodepoint.set(glyph.codepoint, regionId);
-                }
-                appendBitmapTextPageQuad(context.page, 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;
+    for (let attempt = 1; attempt <= BITMAP_TEXT_LAYOUT_ATTEMPTS; attempt++) {
+        const version = glyphSource.getGlyphLayoutVersion();
+        layoutBitmapTextPages(bitmapText, runtime);
+        if (glyphSource.getGlyphLayoutVersion() === version) {
+            runtime.glyphLayoutVersion = version;
+            return;
         }
     }
-    if (minX === Infinity) {
-        setEmptyRectangle(bounds);
-    }
-    else {
-        bounds.x = minX;
-        bounds.y = minY;
-        bounds.width = maxX - minX;
-        bounds.height = maxY - minY;
-    }
-    invalidateNodeLocalBounds(bitmapText);
+    // Out of passes. The last layout is the best available and some of its rects are already wrong, and
+    // the current version is still what gets stamped: another pass would reach the same place, so leaving
+    // the node marked stale would only re-lay-out it every frame forever. The atlas is too small for this
+    // string, which is a sizing decision the caller has to make — hence the guard rather than a retry
+    // budget. A node here does come right on its own if the atlas stops repacking, because the version
+    // then holds still and the next refresh's single pass sees one placement.
+    runtime.glyphLayoutVersion = glyphSource.getGlyphLayoutVersion();
+    _layoutGuard?.('layout-did-not-converge', BITMAP_TEXT_LAYOUT_ATTEMPTS);
 }
 // Appends one glyph quad (region id + vector2 pen position) to `page`, auto-growing its arrays. The
 // page-local twin of `appendQuadBatchInstance`, over plain owned arrays rather than a QuadBatch node.
@@ -220,6 +193,86 @@ function layoutBitmapTextLines(glyphSource, data) {
     }
     return lines;
 }
+// One layout pass: the glyph placement itself, with no version bookkeeping. Split out from
+// `updateBitmapText` so the retry above re-runs exactly the work a repack invalidated.
+function layoutBitmapTextPages(bitmapText, runtime) {
+    const data = bitmapText.data;
+    const bounds = ensureBoundsRectangle(runtime);
+    // Clear every existing page; pages with glyphs this layout are refilled below, pages that fall silent
+    // stay as empty pages drawing nothing.
+    for (const page of runtime.pages) {
+        page.instanceCount = 0;
+        page.atlas.regions.length = 0;
+    }
+    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 context = ensureBitmapTextPage(runtime, glyphSource, pages, entry.page);
+                if (context === null)
+                    continue;
+                const quadX = penX + glyph.penWithinWord + entry.bearingX;
+                const quadY = baselineY - entry.bearingY;
+                let regionId = context.regionByCodepoint.get(glyph.codepoint);
+                if (regionId === undefined) {
+                    addTextureAtlasRegion(context.page.atlas, entry.x, entry.y, entry.width, entry.height);
+                    regionId = context.page.atlas.regions.length - 1;
+                    context.regionByCodepoint.set(glyph.codepoint, regionId);
+                }
+                appendBitmapTextPageQuad(context.page, 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);
+}
 function maxLineWidth(lines) {
     let max = 0;
     for (const line of lines)
@@ -233,4 +286,14 @@ function setEmptyRectangle(out) {
     out.width = 0;
     out.height = 0;
 }
+// How many times `updateBitmapText` re-runs a layout that a repack invalidated under it. Two would
+// leave no room to distinguish "the first pass warmed the atlas" from "this string cannot settle";
+// three is one full pass past a warm atlas, and every pass past that is the same evict-repack cycle.
+const BITMAP_TEXT_LAYOUT_ATTEMPTS = 3;
+// Two floats (x, y) per glyph quad — the vector2 (translation-only) transform stride the BitmapText
+// renderer reads. Kept internal so callers never hand-write i*2.
+const BITMAP_TEXT_TRANSFORM_STRIDE = 2;
+const CARRIAGE_RETURN = 0x0d;
+const SPACE = 0x20;
+let _layoutGuard = null;
 //# sourceMappingURL=updateBitmapText.js.map

package/dist/updateBitmapText.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flighthq/bitmaptext",
-  "version": "0.5.1-next.597.ab004dd",
+  "version": "0.5.1-next.638.d4dbd4e",
   "author": "Joshua Granick and other contributors",
   "license": "MIT",
   "repository": {
@@ -38,12 +38,13 @@
     "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
   },
   "dependencies": {
-    "@flighthq/scene2d": "0.5.1-next.597.ab004dd",
-    "@flighthq/geometry": "0.5.1-next.597.ab004dd",
-    "@flighthq/node": "0.5.1-next.597.ab004dd",
-    "@flighthq/texture": "0.5.1-next.597.ab004dd",
-    "@flighthq/textureatlas": "0.5.1-next.597.ab004dd",
-    "@flighthq/types": "0.5.1-next.597.ab004dd"
+    "@flighthq/scene2d": "0.5.1-next.638.d4dbd4e",
+    "@flighthq/geometry": "0.5.1-next.638.d4dbd4e",
+    "@flighthq/log": "0.5.1-next.638.d4dbd4e",
+    "@flighthq/node": "0.5.1-next.638.d4dbd4e",
+    "@flighthq/texture": "0.5.1-next.638.d4dbd4e",
+    "@flighthq/textureatlas": "0.5.1-next.638.d4dbd4e",
+    "@flighthq/types": "0.5.1-next.638.d4dbd4e"
   },
   "devDependencies": {
     "@flighthq/glyphatlas": "*",

package/src/bitmapText.test.ts

@@ -11,6 +11,7 @@ import {
   createBitmapTextRuntime,
   getBitmapTextBounds,
   getBitmapTextPages,
+  isBitmapTextGlyphLayoutStale,
   reserveBitmapText,
   setBitmapTextAlign,
   setBitmapTextGlyphSource,
@@ -35,6 +36,7 @@ function createTestGlyphSource(): GlyphSource {
     getGlyphAtlasImage: (page = 0) => (page === 0 ? image : null),
     getGlyphEntry: (cp) => entries.get(cp) ?? null,
     getGlyphKerning: () => 0,
+    getGlyphLayoutVersion: () => 0,
     getGlyphMetrics: () => ({ ascent: 8, descent: 2, lineGap: 0 }),
   };
 }
@@ -125,6 +127,8 @@ describe('createBitmapTextRuntime', () => {
     const runtime = createBitmapTextRuntime();
     expect(runtime.localBoundsRectangle).toBeNull();
     expect(runtime.pages).toEqual([]);
+    // Below every real version, so a node that has never been laid out reads stale.
+    expect(runtime.glyphLayoutVersion).toBe(-1);
   });
 });
 
@@ -149,6 +153,34 @@ describe('getBitmapTextPages', () => {
   });
 });
 
+describe('isBitmapTextGlyphLayoutStale', () => {
+  it('reads stale before the first layout and settled after it', () => {
+    const text = createBitmapText(createTestGlyphSource(), { text: 'AB' });
+    expect(isBitmapTextGlyphLayoutStale(text)).toBe(true);
+    updateBitmapText(text);
+    expect(isBitmapTextGlyphLayoutStale(text)).toBe(false);
+  });
+
+  // A node with nothing bound has no rects to go stale, so it must not report work to do — otherwise
+  // a per-frame refresh would re-lay-out every empty node in the scene forever.
+  it('reads settled for a node with no glyph source', () => {
+    expect(isBitmapTextGlyphLayoutStale(createBitmapText(null, { text: 'AB' }))).toBe(false);
+  });
+
+  // Version numbering is per source, so a stamp from one source says nothing about another and this
+  // query does NOT detect a rebind: two sources at version 0 compare equal. That is why
+  // `setBitmapTextGlyphSource` documents an explicit `updateBitmapText` afterwards rather than leaving
+  // the rebind to the refresh path. Asserted so a later reader does not mistake the gap for coverage.
+  it('does not report a rebound glyph source as stale', () => {
+    const text = createBitmapText(createTestGlyphSource(), { text: 'AB' });
+    updateBitmapText(text);
+
+    setBitmapTextGlyphSource(text, createTestGlyphSource());
+
+    expect(isBitmapTextGlyphLayoutStale(text)).toBe(false);
+  });
+});
+
 describe('reserveBitmapText', () => {
   it('grows each page quad-array capacity', () => {
     const text = createBitmapText(createTestGlyphSource());

package/src/enableBitmapTextGuards.test.ts

@@ -0,0 +1,77 @@
+import { createGlyphAtlas, createGlyphSourceFromGlyphAtlas } from '@flighthq/glyphatlas/contract';
+import { setLogSink } from '@flighthq/log/contract';
+import type { GlyphAtlas, GlyphRasterizerBackend, LogEntry } from '@flighthq/types/contract';
+import { afterEach, beforeEach, describe, expect, it } from 'vitest';
+
+import { createBitmapText } from './bitmapText';
+import { disableBitmapTextGuards, enableBitmapTextGuards } from './enableBitmapTextGuards';
+import { updateBitmapText } from './updateBitmapText';
+
+let entries: LogEntry[];
+
+beforeEach(() => {
+  entries = [];
+  setLogSink((entry) => entries.push(entry));
+});
+
+afterEach(() => {
+  disableBitmapTextGuards();
+  setLogSink(null);
+});
+
+function messages(): string {
+  return entries.map((e) => String((e.data as { message?: unknown } | undefined)?.message ?? '')).join('\n');
+}
+
+// Holds exactly nine 8x8 glyphs, so a string of more distinct characters than that can never have all
+// of them resident at once: laying out its tail evicts its head, every pass invalidates the last, and
+// the layout cannot settle however many passes it is given.
+function createTinyGlyphAtlas(): GlyphAtlas {
+  const backend: GlyphRasterizerBackend = {
+    rasterize: () => ({
+      advance: 8,
+      bearingX: 0,
+      bearingY: 8,
+      height: 8,
+      pixels: new Uint8ClampedArray(8 * 8 * 4),
+      width: 8,
+    }),
+  };
+  return createGlyphAtlas({
+    fontFamily: 'block',
+    fontSize: 8,
+    height: 32,
+    padding: 1,
+    rasterizerBackend: backend,
+    width: 32,
+  });
+}
+
+describe('disableBitmapTextGuards', () => {
+  it('stops the guard reporting later layouts', () => {
+    enableBitmapTextGuards();
+    disableBitmapTextGuards();
+    const source = createGlyphSourceFromGlyphAtlas(createTinyGlyphAtlas());
+    updateBitmapText(createBitmapText(source, { text: 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' }));
+    expect(messages()).toBe('');
+  });
+});
+
+describe('enableBitmapTextGuards', () => {
+  it('says nothing for a layout that settles', () => {
+    enableBitmapTextGuards();
+    const source = createGlyphSourceFromGlyphAtlas(createTinyGlyphAtlas());
+    updateBitmapText(createBitmapText(source, { text: 'ABC' }));
+    expect(messages()).toBe('');
+  });
+
+  // Without this the failure is silent and looks like a rendering bug: the text draws, every quad is
+  // where layout put it, and the pixels under them belong to other glyphs.
+  it('warns when a string needs more glyphs at once than the atlas can hold', () => {
+    enableBitmapTextGuards();
+    const source = createGlyphSourceFromGlyphAtlas(createTinyGlyphAtlas());
+    updateBitmapText(createBitmapText(source, { text: 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' }));
+    expect(messages()).toContain('never settled');
+    expect(messages()).toContain('Enlarge the glyph atlas');
+  });
+});

package/src/updateBitmapText.test.ts

@@ -2,14 +2,22 @@ import {
   createGlyphAtlas,
   createGlyphSourceFromGlyphAtlas,
   createStubGlyphRasterizerBackend,
+  getGlyphAtlasBitmap,
   setGlyphRasterizerBackend,
 } from '@flighthq/glyphatlas/contract';
 import { getTextureSource } from '@flighthq/texture/contract';
-import type { GlyphEntry, GlyphSource, Image } from '@flighthq/types/contract';
-import { describe, expect, it } from 'vitest';
+import type {
+  Bitmap,
+  GlyphAtlas,
+  GlyphEntry,
+  GlyphRasterizerBackend,
+  GlyphSource,
+  Image,
+} from '@flighthq/types/contract';
+import { afterEach, describe, expect, it } from 'vitest';
 
-import { createBitmapText, getBitmapTextBounds, getBitmapTextPages } from './bitmapText';
-import { updateBitmapText } from './updateBitmapText';
+import { createBitmapText, getBitmapTextBounds, getBitmapTextPages, isBitmapTextGlyphLayoutStale } from './bitmapText';
+import { refreshBitmapTextGlyphLayout, setBitmapTextLayoutGuard, 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
@@ -28,6 +36,7 @@ function createTestGlyphSource(): GlyphSource {
     getGlyphAtlasImage: (page = 0) => (page === 0 ? image : null),
     getGlyphEntry: (cp) => entries.get(cp) ?? null,
     getGlyphKerning: (l, r) => kerning.get((l << 16) | r) ?? 0,
+    getGlyphLayoutVersion: () => 0,
     getGlyphMetrics: () => ({ ascent: 8, descent: 2, lineGap: 0 }),
   };
 }
@@ -44,12 +53,234 @@ function createTwoPageGlyphSource(): { source: GlyphSource; page0Image: Image; p
     getGlyphAtlasImage: (page = 0) => (page === 0 ? page0Image : page === 1 ? page1Image : null),
     getGlyphEntry: (cp) => entries.get(cp) ?? null,
     getGlyphKerning: () => 0,
+    getGlyphLayoutVersion: () => 0,
     getGlyphMetrics: () => ({ ascent: 8, descent: 2, lineGap: 0 }),
   };
   return { source, page0Image, page1Image };
 }
 
+// Rasterizes every glyph as a solid block whose RED channel IS the codepoint, so a rect in the atlas
+// bitmap identifies which glyph actually occupies it. That is the oracle this file needs: after a
+// repack every rect is still a well-formed rect over real pixels, so only reading the pixels can tell a
+// correct region from one that now covers the wrong glyph. Codepoints stay under 0x100 for the channel
+// to hold them exactly.
+function createCodepointColorRasterizerBackend(size: number): GlyphRasterizerBackend {
+  return {
+    rasterize(codepoint) {
+      const pixels = new Uint8ClampedArray(size * size * 4);
+      for (let i = 0; i < size * size; i++) {
+        pixels[i * 4] = codepoint;
+        pixels[i * 4 + 3] = 0xff;
+      }
+      return { advance: size, bearingX: 0, bearingY: size, height: size, pixels, width: size };
+    },
+  };
+}
+
+// The codepoint whose pixels sit at `region`'s top-left in the atlas bitmap, per the rasterizer above.
+function readGlyphCodepointAtRegion(bitmap: Readonly<Bitmap>, x: number, y: number): number {
+  return bitmap.data[(y * bitmap.width + x) * 4];
+}
+
+// A source that REPLACES 'A' with a relocated entry and bumps its layout version once, on the `nth`
+// glyph lookup — a repack landing part way through a layout, driven at the seam so the moment is exact.
+//
+// Replacing the object rather than moving the one already handed out is the whole point. A repack that
+// only relocates survivors mutates their entries in place, so a pass that captured those references
+// picks the move up for free and never needs re-running. The case that genuinely needs it is a repack
+// that DROPS a glyph: the reference the pass captured is orphaned at its old rect, and the next lookup
+// mints a fresh entry somewhere else. `nth: 0` never fires, for the held-still half of the pair.
+function createMidLayoutRelocatingGlyphSource(nth: number): GlyphSource {
+  const image = {} as Image;
+  const entries = new Map<number, GlyphEntry>();
+  for (let codepoint = 0x41; codepoint <= 0x5a; codepoint++) {
+    entries.set(codepoint, { advance: 10, bearingX: 0, bearingY: 8, height: 8, page: 0, width: 6, x: 0, y: 0 });
+  }
+  let lookups = 0;
+  let version = 0;
+  return {
+    getGlyphAtlasImage: (page = 0) => (page === 0 ? image : null),
+    getGlyphEntry(codepoint) {
+      lookups++;
+      if (lookups === nth) {
+        entries.set(0x41, { ...entries.get(0x41)!, x: RELOCATED_GLYPH_X });
+        version++;
+      }
+      return entries.get(codepoint) ?? null;
+    },
+    getGlyphKerning: () => 0,
+    getGlyphLayoutVersion: () => version,
+    getGlyphMetrics: () => ({ ascent: 8, descent: 2, lineGap: 0 }),
+  };
+}
+
+// An atlas small enough that a modest run of glyphs exhausts it and forces the evict-then-repack path
+// that relocates everything already cached — the situation `refreshBitmapTextGlyphLayout` exists for.
+function createRepackingGlyphAtlas(): GlyphAtlas {
+  return createGlyphAtlas({
+    fontFamily: 'codepoint-color',
+    fontSize: 8,
+    height: 32,
+    padding: 1,
+    rasterizerBackend: createCodepointColorRasterizerBackend(8),
+    width: 32,
+  });
+}
+
+describe('refreshBitmapTextGlyphLayout', () => {
+  // The defect this whole seam exists for: a repack relocates and re-uses atlas space, so a node laid
+  // out BEFORE it keeps regions that now cover other glyphs. Nothing about the node, the entry object,
+  // or the atlas image changes to reveal it — the pixels under the baked rect are the only witness.
+  it('re-bakes regions that a repack left covering the wrong glyphs', () => {
+    const atlas = createRepackingGlyphAtlas();
+    const source = createGlyphSourceFromGlyphAtlas(atlas);
+    const text = createBitmapText(source, { text: 'A' });
+    updateBitmapText(text);
+
+    const baked = getBitmapTextPages(text)[0].atlas.regions[0];
+    const bitmap = getGlyphAtlasBitmap(atlas);
+    expect(readGlyphCodepointAtRegion(bitmap, baked.x, baked.y)).toBe(0x41);
+
+    // Fill the atlas from elsewhere — a second text node, a direct lookup, any other consumer of the
+    // same atlas would do. 'A' is the least recently used, so it is evicted and its space handed on.
+    for (let codepoint = 0x42; codepoint <= 0x5a; codepoint++) source.getGlyphEntry(codepoint);
+
+    expect(isBitmapTextGlyphLayoutStale(text)).toBe(true);
+    expect(readGlyphCodepointAtRegion(bitmap, baked.x, baked.y)).not.toBe(0x41);
+
+    expect(refreshBitmapTextGlyphLayout(text)).toBe(true);
+    const rebaked = getBitmapTextPages(text)[0].atlas.regions[0];
+    expect(readGlyphCodepointAtRegion(bitmap, rebaked.x, rebaked.y)).toBe(0x41);
+    expect(isBitmapTextGlyphLayoutStale(text)).toBe(false);
+  });
+
+  it('does nothing and reports nothing done when the glyph placement has not moved', () => {
+    const atlas = createRepackingGlyphAtlas();
+    const text = createBitmapText(createGlyphSourceFromGlyphAtlas(atlas), { text: 'A' });
+    updateBitmapText(text);
+    const before = getBitmapTextPages(text)[0].atlas.regions[0];
+
+    expect(refreshBitmapTextGlyphLayout(text)).toBe(false);
+    expect(getBitmapTextPages(text)[0].atlas.regions[0]).toBe(before);
+  });
+
+  it('lays out a node that has never been laid out', () => {
+    const atlas = createRepackingGlyphAtlas();
+    const text = createBitmapText(createGlyphSourceFromGlyphAtlas(atlas), { text: 'A' });
+
+    expect(refreshBitmapTextGlyphLayout(text)).toBe(true);
+    expect(getBitmapTextPages(text)[0].instanceCount).toBe(1);
+  });
+
+  // Fan-out is the reason the seam versions rather than the consumer comparing rects: one atlas backs
+  // every node bound to it, and the node that triggered the repack must not be the only one repaired.
+  it('repairs every node sharing the atlas, not only the one that forced the repack', () => {
+    const atlas = createRepackingGlyphAtlas();
+    const source = createGlyphSourceFromGlyphAtlas(atlas);
+    const first = createBitmapText(source, { text: 'A' });
+    updateBitmapText(first);
+
+    const second = createBitmapText(source, { text: 'BCDEFGHIJKLMNOPQRSTUVWXYZ' });
+    updateBitmapText(second);
+
+    expect(isBitmapTextGlyphLayoutStale(first)).toBe(true);
+    refreshBitmapTextGlyphLayout(first);
+    const bitmap = getGlyphAtlasBitmap(atlas);
+    const region = getBitmapTextPages(first)[0].atlas.regions[0];
+    expect(readGlyphCodepointAtRegion(bitmap, region.x, region.y)).toBe(0x41);
+  });
+});
+
+describe('setBitmapTextLayoutGuard', () => {
+  afterEach(() => setBitmapTextLayoutGuard(null));
+
+  it('reports the reason and the passes spent when a layout cannot settle', () => {
+    const seen: [string, number][] = [];
+    setBitmapTextLayoutGuard((reason, attempts) => seen.push([reason, attempts]));
+    const source = createGlyphSourceFromGlyphAtlas(createRepackingGlyphAtlas());
+
+    updateBitmapText(createBitmapText(source, { text: 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' }));
+
+    expect(seen).toEqual([['layout-did-not-converge', 3]]);
+  });
+
+  it('stays silent for a layout that settles', () => {
+    const seen: string[] = [];
+    setBitmapTextLayoutGuard((reason) => seen.push(reason));
+    const source = createGlyphSourceFromGlyphAtlas(createRepackingGlyphAtlas());
+
+    updateBitmapText(createBitmapText(source, { text: 'AB' }));
+
+    expect(seen).toEqual([]);
+  });
+
+  it('stops reporting once cleared with null', () => {
+    let calls = 0;
+    setBitmapTextLayoutGuard(() => (calls += 1));
+    const source = createGlyphSourceFromGlyphAtlas(createRepackingGlyphAtlas());
+
+    updateBitmapText(createBitmapText(source, { text: 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' }));
+    setBitmapTextLayoutGuard(null);
+    updateBitmapText(createBitmapText(source, { text: 'ABCDEFGHIJKLMNOPQRSTUVWXYZ' }));
+
+    expect(calls).toBe(1);
+  });
+});
+
 describe('updateBitmapText', () => {
+  // A repack can land DURING a layout — a glyph late in the string evicting one placed early in it —
+  // and the pass that saw both placements is wrong about the first. The retry is what makes a single
+  // `updateBitmapText` call self-consistent rather than merely detectably stale afterwards.
+  // A pass that read a rect BEFORE the relocation and one that read it after cannot both be right, and
+  // the pass has no way to go back for the ones it already consumed. Re-running is what makes a single
+  // `updateBitmapText` call self-consistent rather than merely detectably stale afterwards.
+  it('re-runs a layout whose glyph placement moved part way through it', () => {
+    const source = createMidLayoutRelocatingGlyphSource(2);
+    const text = createBitmapText(source, { text: 'ABC' });
+
+    updateBitmapText(text);
+
+    // 'A' is the first region baked, and the relocation landed after the pass had already read it.
+    expect(getBitmapTextPages(text)[0].atlas.regions[0].x).toBe(RELOCATED_GLYPH_X);
+    expect(isBitmapTextGlyphLayoutStale(text)).toBe(false);
+  });
+
+  it('does not re-run a layout whose glyph placement held still', () => {
+    const source = createMidLayoutRelocatingGlyphSource(0);
+    const text = createBitmapText(source, { text: 'ABC' });
+    const seen: string[] = [];
+    setBitmapTextLayoutGuard((reason) => seen.push(reason));
+
+    updateBitmapText(text);
+
+    expect(getBitmapTextPages(text)[0].atlas.regions[0].x).toBe(0);
+    expect(seen).toEqual([]);
+    setBitmapTextLayoutGuard(null);
+  });
+
+  // The end-to-end companion to the seam-driven pair above, over the real atlas. It passes without the
+  // retry as well — this atlas only relocates, and relocation moves the entry the pass is holding — so
+  // it is here to prove the whole path stays coherent, not to exercise the re-run.
+  it('ends coherent through an atlas that repacks during the layout', () => {
+    const atlas = createRepackingGlyphAtlas();
+    const source = createGlyphSourceFromGlyphAtlas(atlas);
+    // Fill most of the atlas with glyphs this text does not use, so laying it out has to evict and
+    // repack partway through — over the glyphs the same pass already placed.
+    for (let codepoint = 0x61; codepoint <= 0x66; codepoint++) source.getGlyphEntry(codepoint);
+    const text = createBitmapText(source, { text: 'ABCDEF' });
+    updateBitmapText(text);
+
+    const bitmap = getGlyphAtlasBitmap(atlas);
+    const page = getBitmapTextPages(text)[0];
+    expect(page.instanceCount).toBeGreaterThan(0);
+    for (let id = 0; id < page.atlas.regions.length; id++) {
+      const region = page.atlas.regions[id];
+      const codepoint = readGlyphCodepointAtRegion(bitmap, region.x, region.y);
+      expect(codepoint).toBe(0x41 + id);
+    }
+    expect(isBitmapTextGlyphLayoutStale(text)).toBe(false);
+  });
+
   it('emits non-empty glyph quads end-to-end from a stub-fed glyph atlas (headless, issue #8)', () => {
     // The real headless path: glyphatlas → GlyphSource → bitmaptext, with the deterministic stub
     // rasterizer standing in for a web font that is unavailable in jsdom/CI. Proves BitmapText renders
@@ -246,3 +477,7 @@ describe('updateBitmapText', () => {
     expect(bounds.height).toBe(8);
   });
 });
+
+// Where the mid-layout relocation moves 'A' to — distinct from every rect the source starts with, so
+// a region carrying it can only have come from a pass that ran AFTER the move.
+const RELOCATED_GLYPH_X = 17;