@flighthq/text 0.1.0

package/dist/textLabel.js

@@ -0,0 +1,121 @@
+import { createDisplayObjectGeneric, createDisplayObjectRuntime, getDisplayObjectRuntime, } from '@flighthq/displayobject';
+import { invalidateNodeLocalBounds, invalidateNodeLocalContent } from '@flighthq/node';
+import { computeTextBoundsRectangle, createTextFormatRange } from '@flighthq/textlayout';
+import { TextLabelKind } from '@flighthq/types';
+import { ensureTextLayout, getTextLayout } from './textLabelLayout';
+// Per-kind layout-params hook for ensureTextLayout: a TextLabel is a single run, so it lays out its
+// whole string with one format range and no wrap — the lean path that skips RichText's range/html
+// assembly and wrap/multiline machinery. Local: only assigned onto the runtime in createTextLabelRuntime.
+function buildTextLabelLayoutParams(source, measure) {
+    const data = source.data;
+    return {
+        formatRanges: [createTextFormatRange(data.textFormat, 0, data.text.length)],
+        height: data.height,
+        measure,
+        text: data.text,
+        width: data.width,
+    };
+}
+export function appendTextLabelString(source, value) {
+    if (value.length === 0)
+        return;
+    source.data.text += value;
+    invalidateNodeLocalContent(source);
+}
+// The field-box bounds in local space, mirroring computeRichTextLocalBoundsRectangle. A fixed field
+// (autoSize 'none') is the user width/height at the origin. Under autoSize, the box is the measured
+// content (textWidth/textHeight + gutter) positioned by the left/right/center anchor. The layout is
+// ensured on demand here, so a TextLabel's autoSize bounds are queryable before it is ever rendered.
+// Falls back to the fixed box until a measure provider is registered.
+export function computeTextLabelLocalBoundsRectangle(out, source) {
+    const label = source;
+    const data = label.data;
+    if (data.autoSize === 'none') {
+        out.x = 0;
+        out.y = 0;
+        out.width = data.width;
+        out.height = data.height;
+        return;
+    }
+    ensureTextLayout(label);
+    const layout = getTextLayout(label);
+    if (layout === null) {
+        out.x = 0;
+        out.y = 0;
+        out.width = data.width;
+        out.height = data.height;
+        return;
+    }
+    computeTextBoundsRectangle(out, data, layout);
+}
+export function createTextLabel(obj) {
+    return createDisplayObjectGeneric(TextLabelKind, obj, createTextLabelData, createTextLabelRuntime);
+}
+export function createTextLabelData(data) {
+    return {
+        autoSize: data?.autoSize ?? 'none',
+        height: data?.height ?? 100,
+        text: data?.text ?? '',
+        textFormat: data?.textFormat ?? {},
+        width: data?.width ?? 100,
+    };
+}
+export function createTextLabelRuntime() {
+    const out = createDisplayObjectRuntime(defaultMethods);
+    // buildTextLayoutParams is a text-specific per-kind seam, not a display-object trait, so no
+    // trait-init copies it off defaultMethods — assign it onto the runtime directly.
+    out.buildTextLayoutParams = buildTextLabelLayoutParams;
+    out.textLayout = null;
+    out.textLayoutUsingContentId = -1;
+    return out;
+}
+export function getTextLabelFormat(source) {
+    return source.data.textFormat;
+}
+export function getTextLabelRuntime(source) {
+    return getDisplayObjectRuntime(source);
+}
+export function getTextLabelString(source) {
+    return source.data.text;
+}
+export function setTextLabelAutoSize(source, value) {
+    const data = source.data;
+    if (data.autoSize === value)
+        return;
+    data.autoSize = value;
+    invalidateNodeLocalContent(source);
+    invalidateNodeLocalBounds(source);
+}
+// Replaces the format wholesale. textFormat is an object reference, so callers pass a new format to
+// apply; the content revision bumps unconditionally because field-level equality is not tracked.
+export function setTextLabelFormat(source, value) {
+    source.data.textFormat = value;
+    invalidateNodeLocalContent(source);
+}
+export function setTextLabelHeight(source, value) {
+    const data = source.data;
+    if (data.height === value)
+        return;
+    data.height = value;
+    invalidateNodeLocalContent(source);
+    invalidateNodeLocalBounds(source);
+}
+export function setTextLabelString(source, value) {
+    const data = source.data;
+    if (data.text === value)
+        return;
+    data.text = value;
+    invalidateNodeLocalContent(source);
+}
+export function setTextLabelWidth(source, value) {
+    const data = source.data;
+    if (data.width === value)
+        return;
+    data.width = value;
+    invalidateNodeLocalContent(source);
+    invalidateNodeLocalBounds(source);
+}
+const defaultMethods = {
+    computeLocalBoundsRectangle: computeTextLabelLocalBoundsRectangle,
+};
+//# sourceMappingURL=textLabel.js.map

package/dist/textLabel.js.map

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

package/dist/textLabelLayout.d.ts

@@ -0,0 +1,5 @@
+import type { TextLabel, TextLayoutResult, TextMetrics } from '@flighthq/types';
+export declare function ensureTextLayout(source: Readonly<TextLabel>): void;
+export declare function getTextLayout(source: Readonly<TextLabel>): TextLayoutResult | null;
+export declare function getTextLayoutMetrics(out: TextMetrics, source: Readonly<TextLabel>): void;
+//# sourceMappingURL=textLabelLayout.d.ts.map

package/dist/textLabelLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textLabelLayout.d.ts","sourceRoot":"","sources":["../src/textLabelLayout.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAoB,gBAAgB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAWlG,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,IAAI,CAYlE;AAID,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,gBAAgB,GAAG,IAAI,CAGlF;AAID,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,SAAS,CAAC,GAAG,IAAI,CASxF"}

package/dist/textLabelLayout.js

@@ -0,0 +1,44 @@
+import { getDisplayObjectRuntime } from '@flighthq/displayobject';
+import { getNodeLocalContentRevision } from '@flighthq/node';
+import { computeTextLayout, getTextLayoutMeasureProvider, getTextLayoutResult, getTextMetrics, } from '@flighthq/textlayout';
+// Lazily refreshes the cached text layout for `source` — TextLabel or RichText alike —
+// mirroring the node graph's ensure* pattern (e.g. ensureNodeLocalBoundsRectangle). If the
+// local-content revision changed since the layout was last computed, it asks the node's kind to
+// assemble its layout params (the single per-kind difference) via runtime.buildTextLayoutParams,
+// recomputes, and restamps. Cheap and idempotent when already current. Callable from anywhere needing
+// text metrics, bounds, or rendering — no render pass required, which is what lets text be measured
+// before (or without) it is ever drawn. If no measure provider is registered yet, the layout is left
+// as-is (null or stale) until setTextLayoutMeasureProvider is called, after which the next ensure
+// refreshes it.
+export function ensureTextLayout(source) {
+    const runtime = getDisplayObjectRuntime(source);
+    const contentId = getNodeLocalContentRevision(source);
+    if (runtime.textLayout !== null && runtime.textLayoutUsingContentId === contentId)
+        return;
+    const measure = getTextLayoutMeasureProvider();
+    if (measure === null)
+        return;
+    const params = runtime.buildTextLayoutParams(source, measure);
+    const result = getTextLayoutResult(runtime);
+    computeTextLayout(result, params);
+    runtime.textLayoutUsingContentId = contentId;
+}
+// Ensures the layout is current and returns it, or null if no measure provider has been registered
+// yet (so a caller can distinguish "no text" from "not yet measurable").
+export function getTextLayout(source) {
+    ensureTextLayout(source);
+    return getDisplayObjectRuntime(source).textLayout;
+}
+// Ensures the layout is current and fills `out` with the measured content size (Flash
+// textWidth/textHeight). Zeroes `out` when no layout is available (no measure provider registered).
+export function getTextLayoutMetrics(out, source) {
+    const layout = getTextLayout(source);
+    if (layout === null) {
+        out.height = 0;
+        out.numLines = 0;
+        out.width = 0;
+        return;
+    }
+    getTextMetrics(out, layout);
+}
+//# sourceMappingURL=textLabelLayout.js.map

package/dist/textLabelLayout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textLabelLayout.js","sourceRoot":"","sources":["../src/textLabelLayout.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EACL,iBAAiB,EACjB,4BAA4B,EAC5B,mBAAmB,EACnB,cAAc,GACf,MAAM,sBAAsB,CAAC;AAG9B,uFAAuF;AACvF,2FAA2F;AAC3F,gGAAgG;AAChG,iGAAiG;AACjG,sGAAsG;AACtG,oGAAoG;AACpG,qGAAqG;AACrG,kGAAkG;AAClG,gBAAgB;AAChB,MAAM,UAAU,gBAAgB,CAAC,MAA2B;IAC1D,MAAM,OAAO,GAAG,uBAAuB,CAAC,MAAM,CAAqB,CAAC;IACpE,MAAM,SAAS,GAAG,2BAA2B,CAAC,MAAM,CAAC,CAAC;IACtD,IAAI,OAAO,CAAC,UAAU,KAAK,IAAI,IAAI,OAAO,CAAC,wBAAwB,KAAK,SAAS;QAAE,OAAO;IAE1F,MAAM,OAAO,GAAG,4BAA4B,EAAE,CAAC;IAC/C,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO;IAE7B,MAAM,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAC5C,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC;AAC/C,CAAC;AAED,mGAAmG;AACnG,yEAAyE;AACzE,MAAM,UAAU,aAAa,CAAC,MAA2B;IACvD,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACzB,OAAQ,uBAAuB,CAAC,MAAM,CAAsB,CAAC,UAAU,CAAC;AAC1E,CAAC;AAED,sFAAsF;AACtF,oGAAoG;AACpG,MAAM,UAAU,oBAAoB,CAAC,GAAgB,EAAE,MAA2B;IAChF,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;QACf,GAAG,CAAC,QAAQ,GAAG,CAAC,CAAC;QACjB,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC;QACd,OAAO;IACT,CAAC;IACD,cAAc,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC9B,CAAC"}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@flighthq/text",
+  "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/displayobject": "0.1.0",
+    "@flighthq/entity": "0.1.0",
+    "@flighthq/geometry": "0.1.0",
+    "@flighthq/node": "0.1.0",
+    "@flighthq/signals": "0.1.0",
+    "@flighthq/textlayout": "0.1.0",
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Text display objects: single-format TextLabel and multi-format RichText built on the text-layout spine",
+  "sideEffects": false
+}

package/src/nativeText.test.ts

@@ -0,0 +1,256 @@
+import { createRectangle } from '@flighthq/geometry';
+import { getNodeLocalBoundsRevision, getNodeLocalContentRevision } from '@flighthq/node';
+import type { NativeText, NativeTextRuntime, Node, PartialNode } from '@flighthq/types';
+import { NativeTextKind } from '@flighthq/types';
+
+import {
+  computeNativeTextLocalBoundsRectangle,
+  createNativeText,
+  createNativeTextData,
+  createNativeTextRuntime,
+  getNativeTextMeasuredHeight,
+  getNativeTextMeasuredWidth,
+  getNativeTextRuntime,
+  getNativeTextString,
+  getNativeTextStyle,
+  patchNativeTextStyle,
+  setNativeTextAutoSize,
+  setNativeTextHeight,
+  setNativeTextString,
+  setNativeTextStyle,
+  setNativeTextWidth,
+} from './nativeText';
+
+describe('computeNativeTextLocalBoundsRectangle', () => {
+  it('sets out dimensions from data width and height when autoSize is none', () => {
+    const native = createNativeText({ data: { width: 200, height: 50 } });
+    const out = createRectangle();
+    computeNativeTextLocalBoundsRectangle(out, native as unknown as Node);
+    expect(out.x).toBe(0);
+    expect(out.width).toBe(200);
+    expect(out.height).toBe(50);
+  });
+
+  it('falls back to the fixed box under autoSize until the element has been measured', () => {
+    const native = createNativeText({ data: { autoSize: 'left', width: 200, height: 50 } });
+    const out = createRectangle();
+    computeNativeTextLocalBoundsRectangle(out, native as unknown as Node);
+    expect(out.width).toBe(200);
+    expect(out.height).toBe(50);
+  });
+
+  it('uses the measured size the platform renderer wrote back under autoSize', () => {
+    const native = createNativeText({ data: { autoSize: 'left', width: 200, height: 50 } });
+    const runtime = getNativeTextRuntime(native) as NativeTextRuntime;
+    runtime.measuredWidth = 80;
+    runtime.measuredHeight = 24;
+    const out = createRectangle();
+    computeNativeTextLocalBoundsRectangle(out, native as unknown as Node);
+    expect(out.width).toBe(80);
+    expect(out.height).toBe(24);
+  });
+});
+
+describe('createNativeText', () => {
+  let native: NativeText;
+
+  beforeEach(() => {
+    native = createNativeText();
+  });
+
+  it('initializes default values', () => {
+    expect(native.data.text).toBe('');
+    expect(native.data.autoSize).toBe('none');
+    expect(native.data.width).toBe(100);
+    expect(native.data.height).toBe(100);
+    expect(native.data.style).not.toBeNull();
+    expect(native.kind).toStrictEqual(NativeTextKind);
+  });
+
+  it('allows pre-defined values', () => {
+    const base: PartialNode<NativeText> = {
+      data: {
+        autoSize: 'left',
+        text: 'foo',
+        width: 300,
+        height: 40,
+      },
+    };
+    const obj = createNativeText(base);
+    expect(obj.data.autoSize).toStrictEqual(base.data!.autoSize);
+    expect(obj.data.text).toStrictEqual(base.data!.text);
+    expect(obj.data.width).toBe(300);
+    expect(obj.data.height).toBe(40);
+  });
+});
+
+describe('createNativeTextData', () => {
+  it('returns default values', () => {
+    const data = createNativeTextData();
+    expect(data.autoSize).toBe('none');
+    expect(data.height).toBe(100);
+    expect(data.text).toBe('');
+    expect(data.style).not.toBeNull();
+    expect(data.width).toBe(100);
+  });
+
+  it('allows pre-defined values', () => {
+    const data = createNativeTextData({ autoSize: 'left', text: 'hello', width: 250, height: 30 });
+    expect(data.autoSize).toBe('left');
+    expect(data.text).toBe('hello');
+    expect(data.width).toBe(250);
+    expect(data.height).toBe(30);
+  });
+});
+
+describe('createNativeTextRuntime', () => {
+  it('returns a non-null runtime with empty platform slots', () => {
+    const runtime = createNativeTextRuntime();
+    expect(runtime).not.toBeNull();
+    expect(runtime.element).toBeNull();
+    expect(runtime.measuredWidth).toBe(0);
+    expect(runtime.measuredHeight).toBe(0);
+  });
+
+  it('uses computeNativeTextLocalBoundsRectangle', () => {
+    const runtime = createNativeTextRuntime();
+    expect(runtime.computeLocalBoundsRectangle).toStrictEqual(computeNativeTextLocalBoundsRectangle);
+  });
+});
+
+describe('getNativeTextMeasuredHeight', () => {
+  it('returns 0 before the platform renderer writes a measurement', () => {
+    const native = createNativeText();
+    expect(getNativeTextMeasuredHeight(native)).toBe(0);
+  });
+
+  it('returns the value the renderer wrote back', () => {
+    const native = createNativeText();
+    (getNativeTextRuntime(native) as NativeTextRuntime).measuredHeight = 24;
+    expect(getNativeTextMeasuredHeight(native)).toBe(24);
+  });
+});
+
+describe('getNativeTextMeasuredWidth', () => {
+  it('returns 0 before the platform renderer writes a measurement', () => {
+    const native = createNativeText();
+    expect(getNativeTextMeasuredWidth(native)).toBe(0);
+  });
+
+  it('returns the value the renderer wrote back', () => {
+    const native = createNativeText();
+    (getNativeTextRuntime(native) as NativeTextRuntime).measuredWidth = 80;
+    expect(getNativeTextMeasuredWidth(native)).toBe(80);
+  });
+});
+
+describe('getNativeTextRuntime', () => {
+  it('returns the runtime for a NativeText', () => {
+    const native = createNativeText();
+    const runtime = getNativeTextRuntime(native);
+    expect(runtime).not.toBeNull();
+  });
+});
+
+describe('getNativeTextString', () => {
+  it('returns the text field', () => {
+    const native = createNativeText({ data: { text: 'hello' } });
+    expect(getNativeTextString(native)).toBe('hello');
+  });
+});
+
+describe('getNativeTextStyle', () => {
+  it('returns the style field', () => {
+    const style = { size: 16, bold: true };
+    const native = createNativeText({ data: { style } });
+    expect(getNativeTextStyle(native)).toBe(native.data.style);
+  });
+});
+
+describe('patchNativeTextStyle', () => {
+  it('merges the patch into the existing style', () => {
+    const native = createNativeText({ data: { style: { size: 14, bold: false } } });
+    patchNativeTextStyle(native, { bold: true, color: 0xff0000 });
+    expect(native.data.style.size).toBe(14);
+    expect(native.data.style.bold).toBe(true);
+    expect(native.data.style.color).toBe(0xff0000);
+  });
+
+  it('bumps content after patching', () => {
+    const native = createNativeText();
+    const content = getNodeLocalContentRevision(native);
+    patchNativeTextStyle(native, { size: 20 });
+    expect(getNodeLocalContentRevision(native)).toBe(content + 1);
+  });
+});
+
+describe('setNativeTextAutoSize', () => {
+  it('sets autoSize, bumps content, and invalidates local bounds', () => {
+    const native = createNativeText();
+    const content = getNodeLocalContentRevision(native);
+    const bounds = getNodeLocalBoundsRevision(native);
+    setNativeTextAutoSize(native, 'left');
+    expect(native.data.autoSize).toBe('left');
+    expect(getNodeLocalContentRevision(native)).toBe(content + 1);
+    expect(getNodeLocalBoundsRevision(native)).not.toBe(bounds);
+  });
+
+  it('does not bump content when the value is unchanged', () => {
+    const native = createNativeText();
+    const content = getNodeLocalContentRevision(native);
+    setNativeTextAutoSize(native, 'none');
+    expect(getNodeLocalContentRevision(native)).toBe(content);
+  });
+});
+
+describe('setNativeTextHeight', () => {
+  it('sets height, bumps content, and invalidates local bounds', () => {
+    const native = createNativeText();
+    const content = getNodeLocalContentRevision(native);
+    const bounds = getNodeLocalBoundsRevision(native);
+    setNativeTextHeight(native, 250);
+    expect(native.data.height).toBe(250);
+    expect(getNodeLocalContentRevision(native)).toBe(content + 1);
+    expect(getNodeLocalBoundsRevision(native)).not.toBe(bounds);
+  });
+});
+
+describe('setNativeTextString', () => {
+  it('sets text and bumps content', () => {
+    const native = createNativeText();
+    const content = getNodeLocalContentRevision(native);
+    setNativeTextString(native, 'hello');
+    expect(native.data.text).toBe('hello');
+    expect(getNodeLocalContentRevision(native)).toBe(content + 1);
+  });
+
+  it('does not bump content when the value is unchanged', () => {
+    const native = createNativeText({ data: { text: 'same' } });
+    const content = getNodeLocalContentRevision(native);
+    setNativeTextString(native, 'same');
+    expect(getNodeLocalContentRevision(native)).toBe(content);
+  });
+});
+
+describe('setNativeTextStyle', () => {
+  it('replaces the style and bumps content', () => {
+    const native = createNativeText();
+    const content = getNodeLocalContentRevision(native);
+    const style = { size: 24 };
+    setNativeTextStyle(native, style);
+    expect(native.data.style).toBe(style);
+    expect(getNodeLocalContentRevision(native)).toBe(content + 1);
+  });
+});
+
+describe('setNativeTextWidth', () => {
+  it('sets width, bumps content, and invalidates local bounds', () => {
+    const native = createNativeText();
+    const content = getNodeLocalContentRevision(native);
+    const bounds = getNodeLocalBoundsRevision(native);
+    setNativeTextWidth(native, 300);
+    expect(native.data.width).toBe(300);
+    expect(getNodeLocalContentRevision(native)).toBe(content + 1);
+    expect(getNodeLocalBoundsRevision(native)).not.toBe(bounds);
+  });
+});