@flighthq/text-markup 0.1.0

package/dist/textMarkup.js

@@ -0,0 +1,365 @@
+import { createRichTextContent, createTextFormatRange } from '@flighthq/textlayout';
+import { createMarkupTagRegistry, registerStandardMarkupTags } from './markupTagRegistry';
+/**
+ * Serializes a `RichTextContent` back into `htmlText`-subset markup — the inverse of
+ * `parseTextMarkup` for everything the rich-text model can express. The emitted tag set is the fixed
+ * standard dialect that reproduces the `formatRanges`: `<b>`/`<i>`/`<u>`/`<s>` for the style booleans,
+ * `<font color size face>` for color/size/font, `<a href target>` for links, `<p align>` for
+ * alignment, `<li>` for bullets, and `<textformat …>` for the block metrics. Colors always emit as
+ * `#rrggbb` (a named-color source like `red` normalizes to `#ff0000`). Text is escaped (`&` `<` `>`);
+ * attribute values additionally escape `"`.
+ *
+ * The round-trip guarantee is `parseTextMarkup(formatTextMarkup(parseTextMarkup(x)))` equals
+ * `parseTextMarkup(x)` — a fixed point over the modeled tags. `<p>`/`<li>` imply a collapsing line
+ * break before their content; the resulting `\n` carries no block format and re-parses as a plain
+ * newline that the block tag's own collapse rule does not double, so the fixed point holds. Format
+ * fields with no `htmlText` representation (`kerning`, `letterSpacing`) cannot be expressed and are
+ * omitted; `parseTextMarkup` never produces them, so the fixed point is unaffected.
+ */
+export function formatTextMarkup(content) {
+    const text = content.text;
+    if (text.length === 0)
+        return '';
+    const formats = resolveMarkupFormats(content);
+    let output = '';
+    let runStart = 0;
+    while (runStart < text.length) {
+        const format = formats[runStart];
+        let runEnd = runStart + 1;
+        while (runEnd < text.length && equalsMarkupFormat(formats[runEnd], format))
+            runEnd++;
+        output += formatMarkupRun(format, text.slice(runStart, runEnd));
+        runStart = runEnd;
+    }
+    return output;
+}
+/**
+ * Parses `htmlText`-style markup into Flight's rich-text model — a plain `text` string plus the
+ * `TextFormatRange[]` a `RichText`/`TextLabel` node renders. This is the explicit, Flight-way
+ * replacement for the `textField.htmlText = "…"` magic property: the caller invokes it and assigns
+ * the result, rather than the runtime silently parsing markup on assignment.
+ *
+ * Parsing is two layers. The parse layer here tokenizes the markup (a lenient, text-node-preserving
+ * pass — not the strict document tree of `@flighthq/xml`) and owns composition: it walks the tags,
+ * maintains a format stack (push a tag's handler contribution on open, pop on close), and emits the
+ * `text` and `TextFormatRange[]`. The meaning layer is the `registry` — an open map of tag name →
+ * handler that decides what each tag contributes. When no `registry` is passed the standard
+ * `htmlText` dialect is used (`registerStandardMarkupTags`), so the default is backward-compatible;
+ * pass a custom registry to add, replace, or narrow the supported tags.
+ *
+ * Nested tags compose — `<font color="#f00"><b>x</b></font>` yields one range carrying both `color`
+ * and `bold`. An unregistered tag keeps its enclosed text but applies no format. Entities
+ * (`&amp; &lt; &gt; &quot; &apos; &#nn; &#xhh;`) decode; unknown named entities are left verbatim.
+ *
+ * Malformed markup is recovered best-effort, never thrown: unclosed tags simply extend to the end of
+ * the text, a stray `<` with no `>` stays literal text, and an extra closing tag is ignored. The
+ * result is always a valid `RichTextContent`.
+ */
+export function parseTextMarkup(html, registry) {
+    const handlers = (registry ?? getDefaultMarkupTagRegistry()).handlers;
+    const content = createRichTextContent();
+    const stack = [{}];
+    const tagPattern = /<[^>]*>/g;
+    let index = 0;
+    let match;
+    while ((match = tagPattern.exec(html)) !== null) {
+        appendMarkupText(content, html.slice(index, match.index), stack[stack.length - 1]);
+        handleMarkupToken(content, handlers, match[0], stack);
+        index = match.index + match[0].length;
+    }
+    appendMarkupText(content, html.slice(index), stack[stack.length - 1]);
+    return content;
+}
+// Inserts a collapsing block break — the implicit newline before a `<p>`/`<li>`. Suppressed at the
+// start of the output and against an existing trailing newline so block tags never stack blank lines.
+// The break carries no format, which keeps it indistinguishable from a plain newline on re-parse and
+// preserves the serialize/parse fixed point.
+function appendMarkupBreakBefore(content) {
+    const text = content.text;
+    if (text.length === 0 || text.endsWith('\n'))
+        return;
+    appendMarkupString(content, '\n', emptyMarkupFormat);
+}
+// Appends a literal string (already decoded — a handler's `text`, or a decoded text node).
+function appendMarkupString(content, value, format) {
+    if (value.length === 0)
+        return;
+    const start = content.text.length;
+    content.text += value;
+    pushMarkupRange(content.formatRanges, format, start, content.text.length);
+}
+// Appends a raw text node, decoding entities first.
+function appendMarkupText(content, raw, format) {
+    appendMarkupString(content, decodeMarkupEntities(raw), format);
+}
+function codePointToString(code, fallback) {
+    if (!Number.isFinite(code) || code < 0 || code > 0x10ffff)
+        return fallback;
+    return String.fromCodePoint(code);
+}
+function decodeMarkupEntities(value) {
+    if (value.indexOf('&') === -1)
+        return value;
+    return value.replace(/&(#x[0-9a-f]+|#[0-9]+|[a-z]+);/gi, (matched, entity) => {
+        const lower = entity.toLowerCase();
+        if (lower.startsWith('#x'))
+            return codePointToString(Number.parseInt(lower.slice(2), 16), matched);
+        if (lower.startsWith('#'))
+            return codePointToString(Number.parseInt(lower.slice(1), 10), matched);
+        return markupNamedEntities[lower] ?? matched;
+    });
+}
+function equalsMarkupFormat(a, b) {
+    const aKeys = Object.keys(a);
+    const bKeys = Object.keys(b);
+    if (aKeys.length !== bKeys.length)
+        return false;
+    for (const key of aKeys) {
+        const aValue = a[key];
+        const bValue = b[key];
+        if (Array.isArray(aValue) && Array.isArray(bValue)) {
+            if (aValue.length !== bValue.length)
+                return false;
+            for (let i = 0; i < aValue.length; i++) {
+                if (aValue[i] !== bValue[i])
+                    return false;
+            }
+        }
+        else if (aValue !== bValue) {
+            return false;
+        }
+    }
+    return true;
+}
+function escapeMarkupAttribute(value) {
+    return value.replace(/[&<>"]/g, (character) => markupAttributeEscapes[character]);
+}
+function escapeMarkupText(value) {
+    return value.replace(/[&<>]/g, (character) => markupTextEscapes[character]);
+}
+function formatMarkupAnchorTag(format) {
+    let tag = '<a';
+    if (format.url !== undefined)
+        tag += ` href="${escapeMarkupAttribute(format.url)}"`;
+    if (format.target !== undefined)
+        tag += ` target="${escapeMarkupAttribute(format.target)}"`;
+    return `${tag}>`;
+}
+function formatMarkupColor(color) {
+    return `#${((color >>> 0) & 0xffffff).toString(16).padStart(6, '0')}`;
+}
+function formatMarkupFontTag(format) {
+    const hasColor = format.color !== undefined;
+    const hasSize = format.size !== undefined;
+    const hasFace = format.font !== undefined;
+    if (!hasColor && !hasSize && !hasFace)
+        return null;
+    let tag = '<font';
+    if (hasColor)
+        tag += ` color="${formatMarkupColor(format.color)}"`;
+    if (hasSize)
+        tag += ` size="${format.size}"`;
+    if (hasFace)
+        tag += ` face="${escapeMarkupAttribute(format.font)}"`;
+    return `${tag}>`;
+}
+function formatMarkupListTag(format) {
+    if (format.listMarker !== undefined)
+        return `<li type="${format.listMarker}">`;
+    return '<li>';
+}
+function formatMarkupRun(format, text) {
+    const open = [];
+    const close = [];
+    const textformat = formatMarkupTextformatTag(format);
+    if (textformat !== null) {
+        open.push(textformat);
+        close.unshift('</textformat>');
+    }
+    if (format.align !== undefined) {
+        open.push(`<p align="${format.align}">`);
+        close.unshift('</p>');
+    }
+    if (format.bullet === true) {
+        open.push(formatMarkupListTag(format));
+        close.unshift('</li>');
+    }
+    if (format.url !== undefined || format.target !== undefined) {
+        open.push(formatMarkupAnchorTag(format));
+        close.unshift('</a>');
+    }
+    const font = formatMarkupFontTag(format);
+    if (font !== null) {
+        open.push(font);
+        close.unshift('</font>');
+    }
+    if (format.bold === true) {
+        open.push('<b>');
+        close.unshift('</b>');
+    }
+    if (format.italic === true) {
+        open.push('<i>');
+        close.unshift('</i>');
+    }
+    if (format.underline === true) {
+        open.push('<u>');
+        close.unshift('</u>');
+    }
+    if (format.strikethrough === true) {
+        open.push('<s>');
+        close.unshift('</s>');
+    }
+    return open.join('') + escapeMarkupText(text) + close.join('');
+}
+function formatMarkupTextformatTag(format) {
+    let tag = '<textformat';
+    let any = false;
+    if (format.blockIndent !== undefined) {
+        tag += ` blockindent="${format.blockIndent}"`;
+        any = true;
+    }
+    if (format.indent !== undefined) {
+        tag += ` indent="${format.indent}"`;
+        any = true;
+    }
+    if (format.leading !== undefined) {
+        tag += ` leading="${format.leading}"`;
+        any = true;
+    }
+    if (format.leftMargin !== undefined) {
+        tag += ` leftmargin="${format.leftMargin}"`;
+        any = true;
+    }
+    if (format.rightMargin !== undefined) {
+        tag += ` rightmargin="${format.rightMargin}"`;
+        any = true;
+    }
+    if (format.tabStops !== undefined) {
+        tag += ` tabstops="${format.tabStops.join(',')}"`;
+        any = true;
+    }
+    return any ? `${tag}>` : null;
+}
+// The default standard-dialect registry, built lazily and memoized. Not a module-load side effect:
+// nothing runs until the first `parseTextMarkup` call that omits a registry. Kept internal so the
+// standard tags stay immutable from outside; a caller wanting custom tags builds their own registry.
+function getDefaultMarkupTagRegistry() {
+    let registry = defaultMarkupTagRegistry;
+    if (registry === null) {
+        registry = createMarkupTagRegistry();
+        registerStandardMarkupTags(registry);
+        defaultMarkupTagRegistry = registry;
+    }
+    return registry;
+}
+// The dispatch + build binder: resolves one tag token against the registry and applies its result to
+// the format stack and emitted content. Structure (tokenizing, the stack) stays free of TextFormat
+// specifics beyond what a handler returns, so a general markup-binding engine could lift this shape
+// out later against a different handler result type.
+function handleMarkupToken(content, handlers, token, stack) {
+    // The tag body is everything between the angle brackets; drop comments (`<!-- -->`), doctypes
+    // (`<!…>`), processing instructions (`<?…>`), and the degenerate empty `<>`.
+    const inner = token.slice(1, -1).trim();
+    if (inner.length === 0 || inner.startsWith('!') || inner.startsWith('?'))
+        return;
+    const closing = inner.startsWith('/');
+    const selfClosing = inner.endsWith('/');
+    const body = (closing ? inner.slice(1) : inner).replace(/\/$/, '').trim();
+    const separator = body.search(/\s/);
+    const name = (separator === -1 ? body : body.slice(0, separator)).toLowerCase();
+    if (closing) {
+        // Guard the base format: an extra closing tag with nothing open is ignored, not an error.
+        if (stack.length > 1)
+            stack.pop();
+        return;
+    }
+    const top = stack[stack.length - 1];
+    const handler = handlers.get(name);
+    if (handler === undefined) {
+        // Unregistered tag: keep the enclosed text, apply no format. Push a copy of the current format so
+        // the matching close pops it without disturbing an enclosing tag.
+        if (!selfClosing)
+            stack.push({ ...top });
+        return;
+    }
+    const attributes = parseMarkupAttributes(separator === -1 ? '' : body.slice(separator + 1));
+    const result = normalizeMarkupTagResult(handler(attributes));
+    // A void insertion tag (text, no format) inserts literal text and never pushes — e.g. `<br>`.
+    if (result.format === undefined && result.text !== undefined) {
+        appendMarkupString(content, result.text, top);
+        return;
+    }
+    if (result.breakBefore === true)
+        appendMarkupBreakBefore(content);
+    if (result.text !== undefined)
+        appendMarkupString(content, result.text, top);
+    const merged = { ...top, ...result.format };
+    if (!selfClosing)
+        stack.push(merged);
+}
+// Normalizes a handler result to the `MarkupTagEffect` shape. The common `Partial<TextFormat>` return
+// carries none of the reserved effect keys, so it is wrapped as `{ format }`; a richer return is used
+// as-is. `TextFormat` shares no field name with `format`/`breakBefore`/`text`, so the test is exact.
+function normalizeMarkupTagResult(result) {
+    if ('format' in result || 'breakBefore' in result || 'text' in result)
+        return result;
+    return { format: result };
+}
+function parseMarkupAttributes(source) {
+    const attributes = {};
+    const pattern = /([^\s=]+)(?:\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s"'>]+)))?/g;
+    let match;
+    while ((match = pattern.exec(source)) !== null) {
+        const name = match[1].toLowerCase();
+        attributes[name] = decodeMarkupEntities(match[2] ?? match[3] ?? match[4] ?? '');
+    }
+    return attributes;
+}
+function pushMarkupRange(ranges, format, start, end) {
+    if (start === end)
+        return;
+    // Unformatted text carries no range — plain text produces an empty `formatRanges`.
+    if (Object.keys(format).length === 0)
+        return;
+    const previous = ranges[ranges.length - 1];
+    if (previous !== undefined && previous.end === start && equalsMarkupFormat(previous.format, format)) {
+        previous.end = end;
+        return;
+    }
+    ranges.push(createTextFormatRange({ ...format }, start, end));
+}
+function resolveMarkupFormats(content) {
+    const length = content.text.length;
+    const formats = new Array(length);
+    for (let i = 0; i < length; i++)
+        formats[i] = {};
+    // Ranges apply in array order; a later range overrides an earlier one on overlap.
+    for (const range of content.formatRanges) {
+        const start = Math.max(0, Math.min(length, range.start));
+        const end = Math.max(start, Math.min(length, range.end));
+        for (let i = start; i < end; i++)
+            formats[i] = { ...formats[i], ...range.format };
+    }
+    return formats;
+}
+let defaultMarkupTagRegistry = null;
+const emptyMarkupFormat = {};
+const markupAttributeEscapes = {
+    '"': '&quot;',
+    '&': '&amp;',
+    '<': '&lt;',
+    '>': '&gt;',
+};
+const markupNamedEntities = {
+    amp: '&',
+    apos: "'",
+    gt: '>',
+    lt: '<',
+    quot: '"',
+};
+const markupTextEscapes = {
+    '&': '&amp;',
+    '<': '&lt;',
+    '>': '&gt;',
+};
+//# sourceMappingURL=textMarkup.js.map

package/dist/textMarkup.js.map

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

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@flighthq/text-markup",
+  "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/textlayout": "0.1.0",
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Tree-shakable styled-text markup codec — parse/serialize the htmlText tag set to the rich-text model",
+  "sideEffects": false
+}

package/src/markupClassStyles.test.ts

@@ -0,0 +1,65 @@
+import type { RichTextContent, TextFormat } from '@flighthq/types';
+import { describe, expect, it } from 'vitest';
+
+import { registerMarkupClassStyles } from './markupClassStyles';
+import { createMarkupTagRegistry, registerStandardMarkupTags } from './markupTagRegistry';
+import { parseTextMarkup } from './textMarkup';
+
+function formatAt(content: RichTextContent, index: number): TextFormat {
+  for (const range of content.formatRanges) {
+    if (index >= range.start && index < range.end) return range.format;
+  }
+  return {};
+}
+
+describe('registerMarkupClassStyles', () => {
+  it('styles a span by its class after being registered', () => {
+    const registry = createMarkupTagRegistry();
+    registerStandardMarkupTags(registry);
+    registerMarkupClassStyles(registry, { warn: { bold: true, color: 0xff0000 } });
+    const content = parseTextMarkup('<span class="warn">x</span>', registry);
+    expect(content.text).toBe('x');
+    expect(formatAt(content, 0)).toEqual({ bold: true, color: 0xff0000 });
+  });
+
+  it('leaves a span inert when its class is not in the map', () => {
+    const registry = createMarkupTagRegistry();
+    registerStandardMarkupTags(registry);
+    registerMarkupClassStyles(registry, { warn: { bold: true } });
+    const content = parseTextMarkup('<span class="unknown">x</span>', registry);
+    expect(content.text).toBe('x');
+    expect(content.formatRanges).toEqual([]);
+  });
+
+  it('merges several space-separated classes left to right', () => {
+    const registry = createMarkupTagRegistry();
+    registerStandardMarkupTags(registry);
+    registerMarkupClassStyles(registry, {
+      big: { size: 24 },
+      loud: { bold: true, color: 0x0000ff },
+      quiet: { color: 0x333333 },
+    });
+    // `loud` then `quiet` both name color; the later `quiet` wins the shared field, `size` survives.
+    expect(formatAt(parseTextMarkup('<span class="big loud quiet">x</span>', registry), 0)).toEqual({
+      bold: true,
+      color: 0x333333,
+      size: 24,
+    });
+  });
+
+  it('matches class names case-sensitively', () => {
+    const registry = createMarkupTagRegistry();
+    registerStandardMarkupTags(registry);
+    registerMarkupClassStyles(registry, { Warn: { bold: true } });
+    expect(formatAt(parseTextMarkup('<span class="warn">x</span>', registry), 0)).toEqual({});
+    expect(formatAt(parseTextMarkup('<span class="Warn">x</span>', registry), 0)).toEqual({ bold: true });
+  });
+
+  it('is last-write-wins over a previously installed class resolver', () => {
+    const registry = createMarkupTagRegistry();
+    registerStandardMarkupTags(registry);
+    registerMarkupClassStyles(registry, { tag: { bold: true } });
+    registerMarkupClassStyles(registry, { tag: { italic: true } });
+    expect(formatAt(parseTextMarkup('<span class="tag">x</span>', registry), 0)).toEqual({ italic: true });
+  });
+});

package/src/markupNamedColors.test.ts

@@ -0,0 +1,51 @@
+import type { RichTextContent, TextFormat } from '@flighthq/types';
+import { describe, expect, it } from 'vitest';
+
+import { registerMarkupNamedColors } from './markupNamedColors';
+import { createMarkupTagRegistry, registerStandardMarkupTags } from './markupTagRegistry';
+import { parseTextMarkup } from './textMarkup';
+
+function formatAt(content: RichTextContent, index: number): TextFormat {
+  for (const range of content.formatRanges) {
+    if (index >= range.start && index < range.end) return range.format;
+  }
+  return {};
+}
+
+describe('registerMarkupNamedColors', () => {
+  it('resolves CSS named font colors after being registered', () => {
+    const registry = createMarkupTagRegistry();
+    registerStandardMarkupTags(registry);
+    registerMarkupNamedColors(registry);
+    expect(formatAt(parseTextMarkup('<font color="red">x</font>', registry), 0).color).toBe(0xff0000);
+    expect(formatAt(parseTextMarkup('<font color="RebeccaPurple">x</font>', registry), 0).color).toBe(0x663399);
+    expect(formatAt(parseTextMarkup('<font color="cornflowerblue">x</font>', registry), 0).color).toBe(0x6495ed);
+  });
+
+  it('still resolves hex colors once named colors are registered', () => {
+    const registry = createMarkupTagRegistry();
+    registerStandardMarkupTags(registry);
+    registerMarkupNamedColors(registry);
+    expect(formatAt(parseTextMarkup('<font color="#f00">x</font>', registry), 0).color).toBe(0xff0000);
+    expect(formatAt(parseTextMarkup('<font color="0x00ff00">x</font>', registry), 0).color).toBe(0x00ff00);
+  });
+
+  it('leaves an unknown color name unresolved rather than erroring', () => {
+    const registry = createMarkupTagRegistry();
+    registerStandardMarkupTags(registry);
+    registerMarkupNamedColors(registry);
+    expect(formatAt(parseTextMarkup('<font color="notacolor">x</font>', registry), 0).color).toBeUndefined();
+  });
+
+  it('augments the color seam in place without disturbing the standard font handler', () => {
+    const registry = createMarkupTagRegistry();
+    registerStandardMarkupTags(registry);
+    registerMarkupNamedColors(registry);
+    // size and face still parse through the same `<font>` handler.
+    expect(formatAt(parseTextMarkup('<font color="red" size="24" face="Arial">x</font>', registry), 0)).toEqual({
+      color: 0xff0000,
+      font: 'Arial',
+      size: 24,
+    });
+  });
+});