@flighthq/textlayout 0.1.0

package/dist/textLayoutGroup.d.ts

@@ -0,0 +1,3 @@
+import type { TextFormat, TextLayoutGroup } from '@flighthq/types';
+export declare function createTextLayoutGroup(format: TextFormat, startIndex: number, endIndex: number): TextLayoutGroup;
+//# sourceMappingURL=textLayoutGroup.d.ts.map

package/dist/textLayoutGroup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textLayoutGroup.d.ts","sourceRoot":"","sources":["../src/textLayoutGroup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEnE,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAe/G"}

package/dist/textLayoutGroup.js

@@ -0,0 +1,17 @@
+export function createTextLayoutGroup(format, startIndex, endIndex) {
+    return {
+        ascent: 0,
+        descent: 0,
+        endIndex,
+        format,
+        height: 0,
+        leading: 0,
+        lineIndex: 0,
+        offsetX: 0,
+        offsetY: 0,
+        positions: [],
+        startIndex,
+        width: 0,
+    };
+}
+//# sourceMappingURL=textLayoutGroup.js.map

package/dist/textLayoutGroup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textLayoutGroup.js","sourceRoot":"","sources":["../src/textLayoutGroup.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,qBAAqB,CAAC,MAAkB,EAAE,UAAkB,EAAE,QAAgB;IAC5F,OAAO;QACL,MAAM,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;QACV,QAAQ;QACR,MAAM;QACN,MAAM,EAAE,CAAC;QACT,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;QACV,SAAS,EAAE,EAAE;QACb,UAAU;QACV,KAAK,EAAE,CAAC;KACT,CAAC;AACJ,CAAC"}

package/dist/textLayoutMeasure.d.ts

@@ -0,0 +1,4 @@
+import type { TextMeasureFunction } from '@flighthq/types';
+export declare function getTextLayoutMeasureProvider(): TextMeasureFunction | null;
+export declare function setTextLayoutMeasureProvider(measure: TextMeasureFunction | null): void;
+//# sourceMappingURL=textLayoutMeasure.d.ts.map

package/dist/textLayoutMeasure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textLayoutMeasure.d.ts","sourceRoot":"","sources":["../src/textLayoutMeasure.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAS3D,wBAAgB,4BAA4B,IAAI,mBAAmB,GAAG,IAAI,CAIzE;AAKD,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,GAAG,IAAI,CAEtF"}

package/dist/textLayoutMeasure.js

@@ -0,0 +1,23 @@
+import { getTextShaperBackend, measureText } from '@flighthq/textshaper';
+// Resolves the text-measurement provider text-layout uses to turn characters into advances. Shaping
+// is now owned by the @flighthq/textshaper seam: when a shaper backend is registered (the canvas
+// backend from @flighthq/textshaper-canvas, or a future HarfBuzz one), this returns measureText,
+// which is itself a TextMeasureFunction. An explicitly set provider (setTextLayoutMeasureProvider) still
+// takes precedence — it is the direct-injection escape hatch for tests and bespoke hosts. Null when
+// neither exists, exactly as before, so ensureRichTextLayout leaves the layout stale until shaping is
+// available.
+export function getTextLayoutMeasureProvider() {
+    if (_measureProvider !== null)
+        return _measureProvider;
+    if (getTextShaperBackend() !== null)
+        return measureText;
+    return null;
+}
+// Installs an explicit measure provider, bypassing the shaper seam. Pass null to clear it and fall
+// back to the registered shaper backend. Prefer setTextShaperBackend for normal setup; this remains
+// for direct injection (tests, a host wiring its own measure without a full TextShaperBackend).
+export function setTextLayoutMeasureProvider(measure) {
+    _measureProvider = measure;
+}
+let _measureProvider = null;
+//# sourceMappingURL=textLayoutMeasure.js.map

package/dist/textLayoutMeasure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textLayoutMeasure.js","sourceRoot":"","sources":["../src/textLayoutMeasure.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGzE,oGAAoG;AACpG,iGAAiG;AACjG,iGAAiG;AACjG,yGAAyG;AACzG,oGAAoG;AACpG,sGAAsG;AACtG,aAAa;AACb,MAAM,UAAU,4BAA4B;IAC1C,IAAI,gBAAgB,KAAK,IAAI;QAAE,OAAO,gBAAgB,CAAC;IACvD,IAAI,oBAAoB,EAAE,KAAK,IAAI;QAAE,OAAO,WAAW,CAAC;IACxD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mGAAmG;AACnG,oGAAoG;AACpG,gGAAgG;AAChG,MAAM,UAAU,4BAA4B,CAAC,OAAmC;IAC9E,gBAAgB,GAAG,OAAO,CAAC;AAC7B,CAAC;AAED,IAAI,gBAAgB,GAA+B,IAAI,CAAC"}

package/dist/textLayoutRuntime.d.ts

@@ -0,0 +1,4 @@
+import type { TextLabelRuntime, TextLayoutResult } from '@flighthq/types';
+export declare function clearTextLayoutResult(runtime: TextLabelRuntime): void;
+export declare function getTextLayoutResult(runtime: TextLabelRuntime): TextLayoutResult;
+//# sourceMappingURL=textLayoutRuntime.d.ts.map

package/dist/textLayoutRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textLayoutRuntime.d.ts","sourceRoot":"","sources":["../src/textLayoutRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAI1E,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAErE;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,CAK/E"}

package/dist/textLayoutRuntime.js

@@ -0,0 +1,11 @@
+import { createTextLayoutResult } from './textLayout';
+export function clearTextLayoutResult(runtime) {
+    runtime.textLayout = null;
+}
+export function getTextLayoutResult(runtime) {
+    if (runtime.textLayout === null) {
+        runtime.textLayout = createTextLayoutResult();
+    }
+    return runtime.textLayout;
+}
+//# sourceMappingURL=textLayoutRuntime.js.map

package/dist/textLayoutRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textLayoutRuntime.js","sourceRoot":"","sources":["../src/textLayoutRuntime.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAEtD,MAAM,UAAU,qBAAqB,CAAC,OAAyB;IAC7D,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAyB;IAC3D,IAAI,OAAO,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QAChC,OAAO,CAAC,UAAU,GAAG,sBAAsB,EAAE,CAAC;IAChD,CAAC;IACD,OAAO,OAAO,CAAC,UAAU,CAAC;AAC5B,CAAC"}

package/dist/textLineBreaks.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Binary search for the first break index at or after `startIndex`.
+ * Returns -1 when no such break exists. The `lineBreaks` array must be sorted
+ * in ascending order (as produced by `getTextLineBreaks`).
+ */
+export declare function getTextLineBreakIndex(lineBreaks: readonly number[], startIndex?: number): number;
+export declare function getTextLineBreaks(out: number[], text: string): void;
+//# sourceMappingURL=textLineBreaks.d.ts.map

package/dist/textLineBreaks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textLineBreaks.d.ts","sourceRoot":"","sources":["../src/textLineBreaks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,EAAE,UAAU,SAAI,GAAG,MAAM,CAe3F;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAanE"}

package/dist/textLineBreaks.js

@@ -0,0 +1,36 @@
+/**
+ * Binary search for the first break index at or after `startIndex`.
+ * Returns -1 when no such break exists. The `lineBreaks` array must be sorted
+ * in ascending order (as produced by `getTextLineBreaks`).
+ */
+export function getTextLineBreakIndex(lineBreaks, startIndex = 0) {
+    if (lineBreaks.length === 0)
+        return -1;
+    let lo = 0;
+    let hi = lineBreaks.length - 1;
+    let result = -1;
+    while (lo <= hi) {
+        const mid = (lo + hi) >>> 1;
+        if (lineBreaks[mid] >= startIndex) {
+            result = lineBreaks[mid];
+            hi = mid - 1;
+        }
+        else {
+            lo = mid + 1;
+        }
+    }
+    return result;
+}
+export function getTextLineBreaks(out, text) {
+    out.length = 0;
+    let index = -1;
+    while (index < text.length) {
+        const lf = text.indexOf('\n', index + 1);
+        const cr = text.indexOf('\r', index + 1);
+        if (lf === -1 && cr === -1)
+            break;
+        index = cr === -1 ? lf : lf === -1 ? cr : Math.min(cr, lf);
+        out.push(index);
+    }
+}
+//# sourceMappingURL=textLineBreaks.js.map

package/dist/textLineBreaks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textLineBreaks.js","sourceRoot":"","sources":["../src/textLineBreaks.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAA6B,EAAE,UAAU,GAAG,CAAC;IACjF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC;IACvC,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,IAAI,EAAE,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IAC/B,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC;IAChB,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;QAChB,MAAM,GAAG,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,UAAU,EAAE,CAAC;YAClC,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;YACzB,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;QACf,CAAC;aAAM,CAAC;YACN,EAAE,GAAG,GAAG,GAAG,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAa,EAAE,IAAY;IAC3D,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;IAEf,OAAO,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACzC,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAEzC,IAAI,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAAE,MAAM;QAElC,KAAK,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3D,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/textMetrics.d.ts

@@ -0,0 +1,4 @@
+import type { TextLayoutResult, TextMetrics } from '@flighthq/types';
+export declare function createTextMetrics(): TextMetrics;
+export declare function getTextMetrics(out: TextMetrics, layout: Readonly<TextLayoutResult>): void;
+//# sourceMappingURL=textMetrics.d.ts.map

package/dist/textMetrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textMetrics.d.ts","sourceRoot":"","sources":["../src/textMetrics.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAErE,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C;AAKD,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAIzF"}

package/dist/textMetrics.js

@@ -0,0 +1,12 @@
+export function createTextMetrics() {
+    return { height: 0, numLines: 0, width: 0 };
+}
+// Fills `out` with the measured content size from a computed layout (the glyph extent, ceil'd to whole
+// pixels to match computeRichTextTextWidth/Height). Pure read — call after the layout is current, e.g. via
+// ensureRichTextLayout.
+export function getTextMetrics(out, layout) {
+    out.width = Math.ceil(layout.textWidth);
+    out.height = Math.ceil(layout.textHeight);
+    out.numLines = layout.numLines;
+}
+//# sourceMappingURL=textMetrics.js.map

package/dist/textMetrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textMetrics.js","sourceRoot":"","sources":["../src/textMetrics.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAC9C,CAAC;AAED,uGAAuG;AACvG,2GAA2G;AAC3G,wBAAwB;AACxB,MAAM,UAAU,cAAc,CAAC,GAAgB,EAAE,MAAkC;IACjF,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACxC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC1C,GAAG,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;AACjC,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@flighthq/textlayout",
+  "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/textshaper": "0.1.0",
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Renderer-agnostic text layout engine: measures and positions glyphs into layout groups",
+  "sideEffects": false
+}

package/src/richTextContent.test.ts

@@ -0,0 +1,201 @@
+import type { RichTextData, RichTextRuntime } from '@flighthq/types';
+
+import {
+  clearRichTextContent,
+  computeRichTextContent,
+  createRichTextContent,
+  getRichTextContent,
+} from './richTextContent';
+
+function createData(data: Partial<RichTextData> = {}): RichTextData {
+  return {
+    autoSize: 'none',
+    background: false,
+    backgroundColor: 0xffffff,
+    border: false,
+    borderColor: 0,
+    condenseWhite: false,
+    defaultTextFormat: {},
+    height: 100,
+    htmlText: '',
+    maxChars: -1,
+    mouseWheelEnabled: true,
+    multiline: true,
+    scrollH: 0,
+    scrollV: 1,
+    selectable: true,
+    styleSheet: null,
+    text: '',
+    textColor: 0,
+    textFormat: {},
+    textFormatRanges: [],
+    width: 100,
+    wordWrap: false,
+    ...data,
+  };
+}
+
+function createRuntime(): RichTextRuntime {
+  return { richTextContent: null, textLayout: null } as RichTextRuntime;
+}
+
+describe('clearRichTextContent', () => {
+  it('clears the attached content', () => {
+    const runtime = createRuntime();
+    getRichTextContent(runtime);
+    clearRichTextContent(runtime);
+    expect(runtime.richTextContent).toBeNull();
+  });
+});
+
+describe('computeRichTextContent', () => {
+  it('uses plain text when htmlText is empty', () => {
+    const content = createRichTextContent();
+    computeRichTextContent(content, createData({ text: 'hello', textColor: 0x336699 }));
+    expect(content.text).toBe('hello');
+    expect(content.formatRanges).toHaveLength(1);
+    expect(content.formatRanges[0].format.color).toBe(0x336699);
+  });
+
+  it('prefers htmlText over text', () => {
+    const content = createRichTextContent();
+    computeRichTextContent(content, createData({ htmlText: '<b>rich</b>', text: 'plain' }));
+    expect(content.text).toBe('rich');
+    expect(content.formatRanges[0].format.bold).toBe(true);
+  });
+
+  it('decodes entities and br tags', () => {
+    const content = createRichTextContent();
+    computeRichTextContent(content, createData({ htmlText: 'A&amp;B<br>C' }));
+    expect(content.text).toBe('A&B\nC');
+  });
+
+  it('applies inline font tags', () => {
+    const content = createRichTextContent();
+    computeRichTextContent(content, createData({ htmlText: '<font face="Arial" color="#ff00aa" size="18">Hi</font>' }));
+    expect(content.formatRanges[0].format.font).toBe('Arial');
+    expect(content.formatRanges[0].format.color).toBe(0xff00aa);
+    expect(content.formatRanges[0].format.size).toBe(18);
+  });
+
+  it('applies nested text style tags', () => {
+    const content = createRichTextContent();
+    computeRichTextContent(content, createData({ htmlText: '<b>bold <i>both</i></b> normal' }));
+    expect(content.text).toBe('bold both normal');
+    expect(content.formatRanges[0].format.bold).toBe(true);
+    expect(content.formatRanges[1].format.bold).toBe(true);
+    expect(content.formatRanges[1].format.italic).toBe(true);
+    expect(content.formatRanges[2].format.bold).toBeUndefined();
+  });
+
+  it('applies paragraph and textformat attributes', () => {
+    const content = createRichTextContent();
+    computeRichTextContent(
+      content,
+      createData({ htmlText: '<p align="center"><textformat leftmargin="4" leading="3">Hi</textformat></p>' }),
+    );
+    expect(content.text).toBe('Hi\n');
+    expect(content.formatRanges[0].format.align).toBe('center');
+    expect(content.formatRanges[0].format.leftMargin).toBe(4);
+    expect(content.formatRanges[0].format.leading).toBe(3);
+  });
+
+  it('applies anchor link attributes', () => {
+    const content = createRichTextContent();
+    computeRichTextContent(content, createData({ htmlText: '<a href="https://example.com" target="_blank">Link</a>' }));
+    expect(content.text).toBe('Link');
+    expect(content.formatRanges[0].format.url).toBe('https://example.com');
+    expect(content.formatRanges[0].format.target).toBe('_blank');
+  });
+
+  it('applies style sheet selectors and inline CSS', () => {
+    const content = createRichTextContent();
+    computeRichTextContent(
+      content,
+      createData({
+        htmlText: '<p class="callout" style="font-weight:bold;text-decoration:underline">Styled</p>',
+        styleSheet: {
+          '.callout': { color: 0x445566, size: 20 },
+          p: { align: 'right' },
+        },
+      }),
+    );
+    expect(content.formatRanges[0].format.align).toBe('right');
+    expect(content.formatRanges[0].format.bold).toBe(true);
+    expect(content.formatRanges[0].format.color).toBe(0x445566);
+    expect(content.formatRanges[0].format.size).toBe(20);
+    expect(content.formatRanges[0].format.underline).toBe(true);
+  });
+
+  it('condenses whitespace', () => {
+    const content = createRichTextContent();
+    computeRichTextContent(content, createData({ condenseWhite: true, htmlText: '  A \n\t B  ' }));
+    expect(content.text).toBe('A B ');
+  });
+
+  it('honors maxChars', () => {
+    const content = createRichTextContent();
+    computeRichTextContent(content, createData({ htmlText: '<b>Hello</b> world', maxChars: 7 }));
+    expect(content.text).toBe('Hello w');
+    expect(content.formatRanges[content.formatRanges.length - 1].end).toBe(7);
+  });
+
+  it('masks every character when a password character is supplied', () => {
+    const content = createRichTextContent();
+    computeRichTextContent(content, createData({ htmlText: '<b>ignored</b>', text: 'secret' }), '*');
+    expect(content.text).toBe('******');
+    expect(content.formatRanges[0].format.bold).toBeUndefined();
+  });
+
+  it('falls back to the bullet mask when the password character is empty', () => {
+    const content = createRichTextContent();
+    computeRichTextContent(content, createData({ text: 'ab' }), '');
+    expect(content.text).toBe('••');
+  });
+
+  it('applies serialized text format ranges over plain text', () => {
+    const content = createRichTextContent();
+    computeRichTextContent(
+      content,
+      createData({
+        text: 'hello',
+        textFormatRanges: [{ start: 1, end: 4, format: { italic: true } }],
+      }),
+    );
+    expect(content.formatRanges.map((range) => [range.start, range.end, range.format.italic])).toEqual([
+      [0, 1, undefined],
+      [1, 4, true],
+      [4, 5, undefined],
+    ]);
+  });
+
+  it('merges serialized text format ranges over htmlText', () => {
+    const content = createRichTextContent();
+    computeRichTextContent(
+      content,
+      createData({
+        htmlText: '<b>hello</b>',
+        textFormatRanges: [{ start: 1, end: 4, format: { color: 0xff0000 } }],
+      }),
+    );
+    expect(content.formatRanges[1].format.bold).toBe(true);
+    expect(content.formatRanges[1].format.color).toBe(0xff0000);
+  });
+});
+
+describe('createRichTextContent', () => {
+  it('creates empty text and ranges', () => {
+    const content = createRichTextContent();
+    expect(content.text).toBe('');
+    expect(content.formatRanges).toEqual([]);
+  });
+});
+
+describe('getRichTextContent', () => {
+  it('attaches reusable content to runtime state', () => {
+    const runtime = createRuntime();
+    const content = getRichTextContent(runtime);
+    expect(runtime.richTextContent).toBe(content);
+    expect(getRichTextContent(runtime)).toBe(content);
+  });
+});

package/src/richTextMetrics.test.ts

@@ -0,0 +1,124 @@
+import type { RichTextData, TextLayoutResult } from '@flighthq/types';
+
+import {
+  computeRichTextBottomScrollV,
+  computeRichTextLineCount,
+  computeRichTextMaxScrollH,
+  computeRichTextMaxScrollV,
+  computeRichTextTextHeight,
+  computeRichTextTextWidth,
+  getRichTextScrollYOffset,
+} from './richTextMetrics';
+
+function createData(data: Partial<RichTextData> = {}): RichTextData {
+  return {
+    autoSize: 'none',
+    background: false,
+    backgroundColor: 0xffffff,
+    border: false,
+    borderColor: 0,
+    condenseWhite: false,
+    defaultTextFormat: {},
+    height: 100,
+    htmlText: '',
+    maxChars: -1,
+    mouseWheelEnabled: true,
+    multiline: true,
+    scrollH: 0,
+    scrollV: 1,
+    selectable: true,
+    styleSheet: null,
+    text: '',
+    textColor: 0,
+    textFormat: {},
+    textFormatRanges: [],
+    width: 200,
+    wordWrap: false,
+    ...data,
+  };
+}
+
+function createLayout(layout: Partial<TextLayoutResult> = {}): TextLayoutResult {
+  return {
+    groups: [],
+    lineAscents: [],
+    lineDescents: [],
+    lineHeights: [],
+    lineLeadings: [],
+    lineWidths: [],
+    numLines: 1,
+    textHeight: 20,
+    textWidth: 50,
+    ...layout,
+  };
+}
+
+describe('computeRichTextBottomScrollV', () => {
+  it('returns the last visible 1-based line', () => {
+    const data = createData({ height: 34, scrollV: 2 });
+    const layout = createLayout({ lineHeights: [10, 10, 10, 10], numLines: 4 });
+    expect(computeRichTextBottomScrollV(data, layout)).toBe(4);
+  });
+
+  it('clamps to the total line count', () => {
+    const data = createData({ height: 80, scrollV: 2 });
+    const layout = createLayout({ lineHeights: [10, 10, 10], numLines: 3 });
+    expect(computeRichTextBottomScrollV(data, layout)).toBe(3);
+  });
+});
+
+describe('computeRichTextLineCount', () => {
+  it('returns the layout line count', () => {
+    expect(computeRichTextLineCount(createLayout({ numLines: 3 }))).toBe(3);
+  });
+});
+
+describe('computeRichTextMaxScrollH', () => {
+  it('returns horizontal overflow beyond the visible field width', () => {
+    const data = createData({ width: 54 });
+    const layout = createLayout({ textWidth: 80 });
+    expect(computeRichTextMaxScrollH(data, layout)).toBe(30);
+  });
+
+  it('returns zero when text fits horizontally', () => {
+    expect(computeRichTextMaxScrollH(createData({ width: 100 }), createLayout({ textWidth: 50 }))).toBe(0);
+  });
+});
+
+describe('computeRichTextMaxScrollV', () => {
+  it('returns the first scrollV where the final line is visible', () => {
+    const data = createData({ height: 34 });
+    const layout = createLayout({ lineHeights: [10, 10, 10, 10], numLines: 4 });
+    expect(computeRichTextMaxScrollV(data, layout)).toBe(2);
+  });
+
+  it('returns one for a single line', () => {
+    expect(computeRichTextMaxScrollV(createData(), createLayout({ numLines: 1 }))).toBe(1);
+  });
+});
+
+describe('computeRichTextTextHeight', () => {
+  it('returns the ceil text height', () => {
+    expect(computeRichTextTextHeight(createLayout({ textHeight: 12.2 }))).toBe(13);
+  });
+});
+
+describe('computeRichTextTextWidth', () => {
+  it('returns the ceil text width', () => {
+    expect(computeRichTextTextWidth(createLayout({ textWidth: 21.1 }))).toBe(22);
+  });
+});
+
+describe('getRichTextScrollYOffset', () => {
+  it('returns 0 when firstVisibleLine is 0', () => {
+    expect(getRichTextScrollYOffset([10, 12, 14], 0)).toBe(0);
+  });
+
+  it('returns the sum of the first N line heights', () => {
+    expect(getRichTextScrollYOffset([10, 12, 14], 2)).toBe(22);
+  });
+
+  it('clamps to the available line count', () => {
+    expect(getRichTextScrollYOffset([10, 12], 5)).toBe(22);
+  });
+});