@flighthq/textlayout 0.1.0

package/src/textLayoutMeasure.test.ts

@@ -0,0 +1,36 @@
+import { measureText, setTextShaperBackend } from '@flighthq/textshaper';
+
+import { getTextLayoutMeasureProvider, setTextLayoutMeasureProvider } from './textLayoutMeasure';
+
+afterEach(() => {
+  setTextLayoutMeasureProvider(null);
+  setTextShaperBackend(null);
+});
+
+describe('getTextLayoutMeasureProvider', () => {
+  it('returns null before a provider or shaper backend is set', () => {
+    expect(getTextLayoutMeasureProvider()).toBeNull();
+  });
+
+  it('falls back to the textshaper seam when a backend is registered', () => {
+    setTextShaperBackend({ measureText: (text) => text.length });
+    expect(getTextLayoutMeasureProvider()).toBe(measureText);
+  });
+
+  it('prefers an explicitly set provider over the shaper backend', () => {
+    const measure = (text: string) => text.length;
+    setTextShaperBackend({ measureText: () => 99 });
+    setTextLayoutMeasureProvider(measure);
+    expect(getTextLayoutMeasureProvider()).toBe(measure);
+  });
+});
+
+describe('setTextLayoutMeasureProvider', () => {
+  it('stores the provider and clears it with null', () => {
+    const measure = (text: string) => text.length;
+    setTextLayoutMeasureProvider(measure);
+    expect(getTextLayoutMeasureProvider()).toBe(measure);
+    setTextLayoutMeasureProvider(null);
+    expect(getTextLayoutMeasureProvider()).toBeNull();
+  });
+});

package/src/textLayoutRuntime.test.ts

@@ -0,0 +1,30 @@
+import type { TextLabelRuntime } from '@flighthq/types';
+
+import { clearTextLayoutResult, getTextLayoutResult } from './textLayoutRuntime';
+
+function createRuntime(): TextLabelRuntime {
+  return { textLayout: null } as TextLabelRuntime;
+}
+
+describe('clearTextLayoutResult', () => {
+  it('clears the attached layout result', () => {
+    const runtime = createRuntime();
+    getTextLayoutResult(runtime);
+    clearTextLayoutResult(runtime);
+    expect(runtime.textLayout).toBeNull();
+  });
+});
+
+describe('getTextLayoutResult', () => {
+  it('attaches a layout result to runtime state', () => {
+    const runtime = createRuntime();
+    const result = getTextLayoutResult(runtime);
+    expect(runtime.textLayout).toBe(result);
+  });
+
+  it('reuses an existing layout result', () => {
+    const runtime = createRuntime();
+    const result = getTextLayoutResult(runtime);
+    expect(getTextLayoutResult(runtime)).toBe(result);
+  });
+});

package/src/textLineBreaks.test.ts

@@ -0,0 +1,73 @@
+import { getTextLineBreakIndex, getTextLineBreaks } from './textLineBreaks';
+
+describe('getTextLineBreakIndex', () => {
+  it('returns the first break at or after startIndex', () => {
+    expect(getTextLineBreakIndex([3, 7, 12], 5)).toBe(7);
+  });
+
+  it('returns the first break when startIndex is 0', () => {
+    expect(getTextLineBreakIndex([3, 7], 0)).toBe(3);
+  });
+
+  it('returns an exact match when startIndex equals a break', () => {
+    expect(getTextLineBreakIndex([3, 7, 12], 7)).toBe(7);
+  });
+
+  it('returns -1 when no break is at or after startIndex', () => {
+    expect(getTextLineBreakIndex([3, 7], 10)).toBe(-1);
+  });
+
+  it('returns -1 for empty break list', () => {
+    expect(getTextLineBreakIndex([], 0)).toBe(-1);
+  });
+
+  it('works correctly with a single-element array', () => {
+    expect(getTextLineBreakIndex([5], 3)).toBe(5);
+    expect(getTextLineBreakIndex([5], 5)).toBe(5);
+    expect(getTextLineBreakIndex([5], 6)).toBe(-1);
+  });
+
+  it('correctly finds the first break in a large sorted array (binary search)', () => {
+    const breaks = Array.from({ length: 100 }, (_, i) => i * 10);
+    expect(getTextLineBreakIndex(breaks, 55)).toBe(60);
+    expect(getTextLineBreakIndex(breaks, 60)).toBe(60);
+    expect(getTextLineBreakIndex(breaks, 0)).toBe(0);
+    expect(getTextLineBreakIndex(breaks, 999)).toBe(-1);
+  });
+});
+
+describe('getTextLineBreaks', () => {
+  const out: number[] = [];
+
+  it('returns empty array for text with no line breaks', () => {
+    getTextLineBreaks(out, 'hello world');
+    expect(out).toEqual([]);
+  });
+
+  it('finds LF positions', () => {
+    getTextLineBreaks(out, 'a\nb\nc');
+    expect(out).toEqual([1, 3]);
+  });
+
+  it('finds CR positions', () => {
+    getTextLineBreaks(out, 'a\rb\rc');
+    expect(out).toEqual([1, 3]);
+  });
+
+  it('prefers the earlier of CR and LF when both are present', () => {
+    getTextLineBreaks(out, 'a\nb\rc');
+    expect(out).toEqual([1, 3]);
+    getTextLineBreaks(out, 'a\rb\nc');
+    expect(out).toEqual([1, 3]);
+  });
+
+  it('handles trailing newline', () => {
+    getTextLineBreaks(out, 'ab\n');
+    expect(out).toEqual([2]);
+  });
+
+  it('returns empty array for empty text', () => {
+    getTextLineBreaks(out, '');
+    expect(out).toEqual([]);
+  });
+});

package/src/textMetrics.test.ts

@@ -0,0 +1,19 @@
+import type { TextLayoutResult } from '@flighthq/types';
+
+import { createTextMetrics, getTextMetrics } from './textMetrics';
+
+describe('createTextMetrics', () => {
+  it('creates a zeroed metrics object', () => {
+    expect(createTextMetrics()).toEqual({ height: 0, numLines: 0, width: 0 });
+  });
+});
+
+describe('getTextMetrics', () => {
+  it('fills the measured content size from a layout, ceiling fractional extents', () => {
+    const out = createTextMetrics();
+    getTextMetrics(out, { numLines: 2, textHeight: 8.7, textWidth: 12.2 } as unknown as TextLayoutResult);
+    expect(out.width).toBe(13);
+    expect(out.height).toBe(9);
+    expect(out.numLines).toBe(2);
+  });
+});