@datamoc/mw_games 0.43.0 → 0.45.0

package/dist/two-d/ui/markup.d.ts

@@ -1,189 +0,0 @@
-import type { MarkdownSpan } from './markdown.ts';
-/**
- * One run of styled text from inline markup.
- *
- * It is a `MarkdownSpan` with what markup can say and markdown cannot, so anything that renders
- * markdown can render this: colour, a size, and a span that is an image rather than text. Colour and
- * size are kept as written (`red`, `#c0ffee`, `14`) because resolving them is the renderer's
- * business, not this parser's - which is what makes the contract renderer-neutral, and why an image
- * span carries a path for whoever asked rather than a texture.
- */
-export interface MarkupSpan extends MarkdownSpan {
-    /** a named or explicit colour, as written: `color='red'`, `color='#c0ffee'` */
-    color?: string;
-    /** a font size in pixels, as written: `size='14'` */
-    size?: number;
-    /** an image rather than text: `<img>path</img>`; the `text` of such a span is empty */
-    image?: string;
-    /** the custom tag this run came from, when it came from one; the renderer decides its style */
-    tag?: string;
-}
-export interface MarkupOptions {
-    /**
-     * What a `$name` in the text becomes. A name that is not here is left as it was written, which is
-     * what Wesnoth does with an unset variable - dropping it would silently eat a player's name.
-     */
-    readonly variables?: Readonly<Record<string, string>>;
-    /**
-     * Extra tag names to treat as styling containers, beyond the built-in `b`/`i`/`span`/`br`/`img`.
-     * A run inside one carries its name in `MarkupSpan.tag`, so a renderer can look its style up
-     * (Pixi's `tagStyles`, for example) while the parser stays renderer-neutral.
-     */
-    readonly tags?: ReadonlySet<string>;
-}
-/**
- * Reads `source` as inline markup and returns one span per styled run.
- *
- * Known tags are `<b>`, `<i>`, `<span color='…' size='…'>`, `<br/>` (or `<br>`, which becomes a
- * newline in the text) and `<img>path</img>` (or `<img src='path'/>`). Nesting works the way it
- * reads: a `<b>` inside an `<i>` is both, and a closing tag restores exactly the style it opened
- * over. `&lt;`, `&gt;`, `&amp;`, `&quot;` and `&apos;` are the escapes for the characters that would
- * otherwise be syntax.
- *
- * Two rules are deliberate, because content written by hand meets both. An **unknown or malformed**
- * tag - `<blink>`, a `</b>` that closes nothing, an `<img>` with no `</img>` - is kept literally in
- * the text rather than dropped or guessed at, so the worst case is text that reads oddly instead of
- * text that lost a piece. And a `$name` that nothing supplies is kept literally too, for the same
- * reason.
- *
- * @example
- * ```ts
- * import { escapeHtml, markupToHtml, parseMarkup, stripMarkup } from '@datamoc/mw_games/two-d/ui';
- *
- * const spans = parseMarkup("Hail, <b>$name</b>! <span color='#c0ffee'>Four</span> coins<br/>And an<img>gold.png</img>", {
- *   variables: { name: 'Kalenz' },
- * });
- *
- * console.log(spans[1]); // { text: 'Kalenz', bold: true, italic: false }
- * console.log(spans[2]); // { text: 'Four', bold: false, italic: false, color: '#c0ffee' }
- * console.log(spans[3].text); // '\nAnd an'
- * console.log(spans[4].image); // 'gold.png'
- * console.log(stripMarkup('<b>Bold</b> and <i>italic</i>')); // 'Bold and italic'
- * console.log(markupToHtml(spans)); // escaped text with <b>/<i> around the emphasis
- * ```
- */
-export declare function parseMarkup(source: string, options?: MarkupOptions): MarkupSpan[];
-/** The same text with the markup taken out, for a place that cannot render any of it. */
-export declare function stripMarkup(source: string, options?: MarkupOptions): string;
-/**
- * Spans as an HTML fragment for a renderer that speaks HTML text, which is what the ui's `RichLabel`
- * is. Emphasis, colour and size all render - `HTMLText`'s dialect is real CSS, so a `color`/`size`
- * span becomes a `<span style="...">` wrapper - and the text is escaped, so `a < b` can never turn
- * into a tag. An image span renders as nothing here: `HTMLText` has no inline-image primitive, so a
- * caller that wants the image drawn positions a sprite itself, at the position `layoutMarkupLines`
- * reports for that span.
- */
-export declare function markupToHtml(spans: readonly MarkupSpan[]): string;
-/**
- * The plain-text projection for a place that cannot render any markup at all - a screen reader, a
- * log line, a tooltip that only takes a string. Unlike `stripMarkup` (which keeps an image span's
- * raw path, useful for round-tripping but not for reading aloud), an image becomes `describeImage`'s
- * result, defaulting to `[image]` so an image is at least announced as present rather than silently
- * dropped or read as a file path.
- *
- * @example
- * ```ts
- * import { markupAccessibilityText, parseMarkup } from '@datamoc/mw_games/two-d/ui';
- *
- * const spans = parseMarkup("Pay <b>10</b> gold<img>coin.png</img>");
- * console.log(markupAccessibilityText(spans)); // 'Pay 10 gold[image]'
- * console.log(markupAccessibilityText(spans, { describeImage: () => ' (coin icon)' }));
- * // 'Pay 10 gold (coin icon)'
- * ```
- */
-export declare function markupAccessibilityText(spans: readonly MarkupSpan[], options?: {
-    describeImage?: (path: string) => string;
-}): string;
-/** One already-measured, already-wrapped line: the spans that belong on it, and its total width. */
-export interface MarkupLine {
-    readonly spans: readonly MarkupSpan[];
-    readonly width: number;
-}
-/**
- * Measures one atomic layout piece - a word, a single space, or an image span - under whatever
- * style it carries. A canvas backend measures with `TextMetrics`; a fixed-width test double can
- * measure with a plain character count. `piece.image` is set instead of `piece.text` for an image
- * span, so a measurer can give it the icon's own width rather than treating it as zero-width text.
- */
-export type MarkupMeasure = (piece: Pick<MarkupSpan, 'text' | 'bold' | 'italic' | 'size' | 'image' | 'tag'>) => number;
-/**
- * Wraps already-parsed spans into lines, word by word, each word measured under its own span's
- * style - which is the acceptance this item was missing: wrapping computed *after* styling, not
- * before it, so a bold or larger run wraps where its own wider glyphs actually land rather than
- * where the plain text would have. An explicit line break (`<br/>`, which `parseMarkup` turns into
- * a literal `\n`) always starts a new line; otherwise a word moves to the next line only once it
- * would overflow `maxWidth`, so a single word wider than `maxWidth` still renders (not clipped) as
- * ever a caller's original design.
- *
- * Backend-neutral by construction: the same spans, the same `measure` function and the same
- * `maxWidth` given to `layoutMarkupLines` decide the exact same line breaks whether the caller then
- * draws each line through `markupToHtml`/`HTMLText` or through a canvas `Text2D` per run - which is
- * what makes the two backends render "equivalent runs" rather than each doing its own wrapping.
- *
- * @example
- * ```ts
- * import { layoutMarkupLines, parseMarkup } from '@datamoc/mw_games/two-d/ui';
- *
- * const spans = parseMarkup('Take <b>two small</b> coins');
- * const lines = layoutMarkupLines(spans, (piece) => piece.text.length * 8, 100);
- * console.log(lines.map((line) => line.spans.map((span) => span.text).join('')));
- * ```
- */
-export declare function layoutMarkupLines(spans: readonly MarkupSpan[], measure: MarkupMeasure, maxWidth: number): MarkupLine[];
-/** a line's flow direction; the same values `i18n.direction()` reports */
-export type MarkupDirection = 'ltr' | 'rtl';
-/** where a line sits within the wrap width, when it is shorter than that width */
-export type MarkupAlign = 'left' | 'center' | 'right';
-/** One run of a laid-out line, already measured and placed. */
-export interface PositionedMarkupSpan {
-    /** the span this run draws; `image` is set for an image run, `text` otherwise */
-    readonly span: MarkupSpan;
-    /** left edge of the run, in the same coordinate space the line was measured in */
-    readonly x: number;
-    /** top edge of the run's line */
-    readonly y: number;
-    /** the measured width of this run */
-    readonly width: number;
-}
-export interface MarkupLayout {
-    /** measures a piece under its own style, the same function `layoutMarkupLines` was given */
-    readonly measure: MarkupMeasure;
-    /** the wrap width the lines were laid out against, used to align each shorter line within it */
-    readonly maxWidth: number;
-    /** distance between baselines */
-    readonly lineHeight: number;
-    /** flow direction; defaults to `'ltr'` */
-    readonly direction?: MarkupDirection;
-    /** line alignment; defaults to `'right'` in `rtl`, `'left'` otherwise */
-    readonly align?: MarkupAlign;
-}
-/**
- * Positions already-laid-out lines into a flat list of placed runs, one per span, so a canvas
- * backend draws each span as its own `Text2D` (or an image as its own sprite) at the reported
- * `x`/`y`. This is the half `layoutMarkupLines` deliberately leaves out: it decides *which*
- * spans share a line, this decides *where* on the line each one lands.
- *
- * Direction is what makes the two backends equivalent rather than merely identical in text: an
- * `rtl` line places its first (logical) span at the right edge and flows left from it, while an
- * `ltr` line flows right from the left edge, so the same spans read in the language's own order
- * on either side. Alignment then moves the whole line within `maxWidth`, defaulting to the
- * direction's natural edge (`'right'` for `rtl`, `'left'` for `ltr`). A line wider than
- * `maxWidth` is not clipped - the same "a single long word still renders" rule
- * `layoutMarkupLines` already keeps - it simply starts left of zero.
- *
- * @example
- * ```ts
- * import { layoutMarkupLines, parseMarkup, positionMarkupLines } from '@datamoc/mw_games/two-d/ui';
- *
- * const spans = parseMarkup('Take <b>two</b> coins<img>coin.png</img>');
- * const measure = (piece: { text: string; image?: string }) =>
- * 	piece.image !== undefined ? 16 : piece.text.length * 8;
- * const lines = layoutMarkupLines(spans, measure, 120);
- * const runs = positionMarkupLines(lines, { measure, maxWidth: 120, lineHeight: 16 });
- * console.log(runs.map((run) => run.span.image ?? run.span.text).join(''));
- * ```
- */
-export declare function positionMarkupLines(lines: readonly MarkupLine[], layout: MarkupLayout): PositionedMarkupSpan[];
-/** escapes the five characters that would otherwise read as syntax */
-export declare function escapeHtml(text: string): string;
-//# sourceMappingURL=markup.d.ts.map

package/dist/two-d/ui/markup.d.ts.map

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

package/dist/two-d/ui/markup.js

@@ -1,387 +0,0 @@
-/** the tags this parser knows; anything else is literal text, not a tag */
-const KNOWN_TAGS = new Set(['b', 'i', 'span', 'br', 'img']);
-/**
- * Reads `source` as inline markup and returns one span per styled run.
- *
- * Known tags are `<b>`, `<i>`, `<span color='…' size='…'>`, `<br/>` (or `<br>`, which becomes a
- * newline in the text) and `<img>path</img>` (or `<img src='path'/>`). Nesting works the way it
- * reads: a `<b>` inside an `<i>` is both, and a closing tag restores exactly the style it opened
- * over. `&lt;`, `&gt;`, `&amp;`, `&quot;` and `&apos;` are the escapes for the characters that would
- * otherwise be syntax.
- *
- * Two rules are deliberate, because content written by hand meets both. An **unknown or malformed**
- * tag - `<blink>`, a `</b>` that closes nothing, an `<img>` with no `</img>` - is kept literally in
- * the text rather than dropped or guessed at, so the worst case is text that reads oddly instead of
- * text that lost a piece. And a `$name` that nothing supplies is kept literally too, for the same
- * reason.
- *
- * @example
- * ```ts
- * import { escapeHtml, markupToHtml, parseMarkup, stripMarkup } from '@datamoc/mw_games/two-d/ui';
- *
- * const spans = parseMarkup("Hail, <b>$name</b>! <span color='#c0ffee'>Four</span> coins<br/>And an<img>gold.png</img>", {
- *   variables: { name: 'Kalenz' },
- * });
- *
- * console.log(spans[1]); // { text: 'Kalenz', bold: true, italic: false }
- * console.log(spans[2]); // { text: 'Four', bold: false, italic: false, color: '#c0ffee' }
- * console.log(spans[3].text); // '\nAnd an'
- * console.log(spans[4].image); // 'gold.png'
- * console.log(stripMarkup('<b>Bold</b> and <i>italic</i>')); // 'Bold and italic'
- * console.log(markupToHtml(spans)); // escaped text with <b>/<i> around the emphasis
- * ```
- */
-export function parseMarkup(source, options = {}) {
-    const variables = options.variables ?? {};
-    const customTags = options.tags;
-    const spans = [];
-    const stack = [];
-    let style = { bold: false, italic: false };
-    let text = '';
-    const flush = () => {
-        if (!text)
-            return;
-        const span = { text, bold: style.bold, italic: style.italic };
-        if (style.color !== undefined)
-            span.color = style.color;
-        if (style.size !== undefined)
-            span.size = style.size;
-        if (style.tag !== undefined)
-            span.tag = style.tag;
-        spans.push(span);
-        text = '';
-    };
-    for (let index = 0; index < source.length; index++) {
-        const char = source[index];
-        if (char === '&') {
-            const entity = readEntity(source, index);
-            if (entity) {
-                text += entity.text;
-                index = entity.end;
-                continue;
-            }
-        }
-        if (char === '$') {
-            const variable = readVariable(source, index);
-            const value = variable ? variables[variable.name] : undefined;
-            if (variable && value !== undefined) {
-                text += value;
-                index = variable.end;
-                continue;
-            }
-        }
-        if (char === '<') {
-            const tag = readTag(source, index);
-            if (tag && (KNOWN_TAGS.has(tag.name) || customTags?.has(tag.name))) {
-                if (tag.name === 'img') {
-                    const image = readImage(source, tag);
-                    if (image) {
-                        flush();
-                        spans.push({ text: '', bold: false, italic: false, image: image.src });
-                        index = image.end;
-                        continue;
-                    }
-                }
-                else if (tag.name === 'br') {
-                    text += '\n';
-                    index = tag.end;
-                    continue;
-                }
-                else if (!tag.closing) {
-                    //flush before the style moves: the text so far belongs to the style it was written
-                    //in, and accumulating across a tag would give all of it the last style seen
-                    flush();
-                    stack.push({ tag: tag.name, style });
-                    style = opened(style, tag.name, tag.body);
-                    index = tag.end;
-                    continue;
-                }
-                else {
-                    const top = stack[stack.length - 1];
-                    if (top?.tag === tag.name) {
-                        flush();
-                        style = top.style;
-                        stack.pop();
-                        index = tag.end;
-                        continue;
-                    }
-                }
-            }
-        }
-        text += char;
-    }
-    flush();
-    return spans;
-}
-/** The same text with the markup taken out, for a place that cannot render any of it. */
-export function stripMarkup(source, options = {}) {
-    return parseMarkup(source, options)
-        .map((span) => span.image ?? span.text)
-        .join('');
-}
-/**
- * Spans as an HTML fragment for a renderer that speaks HTML text, which is what the ui's `RichLabel`
- * is. Emphasis, colour and size all render - `HTMLText`'s dialect is real CSS, so a `color`/`size`
- * span becomes a `<span style="...">` wrapper - and the text is escaped, so `a < b` can never turn
- * into a tag. An image span renders as nothing here: `HTMLText` has no inline-image primitive, so a
- * caller that wants the image drawn positions a sprite itself, at the position `layoutMarkupLines`
- * reports for that span.
- */
-export function markupToHtml(spans) {
-    return spans
-        .map((span) => {
-        if (span.image !== undefined)
-            return '';
-        let text = escapeHtml(span.text);
-        if (span.italic)
-            text = `<i>${text}</i>`;
-        if (span.bold)
-            text = `<b>${text}</b>`;
-        const style = [
-            span.color !== undefined ? `color:${span.color}` : undefined,
-            span.size !== undefined ? `font-size:${span.size}px` : undefined,
-        ].filter((declaration) => declaration !== undefined);
-        if (style.length > 0)
-            text = `<span style="${style.join(';')}">${text}</span>`;
-        //a custom tag is preserved so an HTML-speaking renderer's own tag styles can match it
-        if (span.tag !== undefined)
-            text = `<${span.tag}>${text}</${span.tag}>`;
-        return text;
-    })
-        .join('');
-}
-/**
- * The plain-text projection for a place that cannot render any markup at all - a screen reader, a
- * log line, a tooltip that only takes a string. Unlike `stripMarkup` (which keeps an image span's
- * raw path, useful for round-tripping but not for reading aloud), an image becomes `describeImage`'s
- * result, defaulting to `[image]` so an image is at least announced as present rather than silently
- * dropped or read as a file path.
- *
- * @example
- * ```ts
- * import { markupAccessibilityText, parseMarkup } from '@datamoc/mw_games/two-d/ui';
- *
- * const spans = parseMarkup("Pay <b>10</b> gold<img>coin.png</img>");
- * console.log(markupAccessibilityText(spans)); // 'Pay 10 gold[image]'
- * console.log(markupAccessibilityText(spans, { describeImage: () => ' (coin icon)' }));
- * // 'Pay 10 gold (coin icon)'
- * ```
- */
-export function markupAccessibilityText(spans, options = {}) {
-    const describeImage = options.describeImage ?? (() => '[image]');
-    return spans.map((span) => (span.image !== undefined ? describeImage(span.image) : span.text)).join('');
-}
-/**
- * Wraps already-parsed spans into lines, word by word, each word measured under its own span's
- * style - which is the acceptance this item was missing: wrapping computed *after* styling, not
- * before it, so a bold or larger run wraps where its own wider glyphs actually land rather than
- * where the plain text would have. An explicit line break (`<br/>`, which `parseMarkup` turns into
- * a literal `\n`) always starts a new line; otherwise a word moves to the next line only once it
- * would overflow `maxWidth`, so a single word wider than `maxWidth` still renders (not clipped) as
- * ever a caller's original design.
- *
- * Backend-neutral by construction: the same spans, the same `measure` function and the same
- * `maxWidth` given to `layoutMarkupLines` decide the exact same line breaks whether the caller then
- * draws each line through `markupToHtml`/`HTMLText` or through a canvas `Text2D` per run - which is
- * what makes the two backends render "equivalent runs" rather than each doing its own wrapping.
- *
- * @example
- * ```ts
- * import { layoutMarkupLines, parseMarkup } from '@datamoc/mw_games/two-d/ui';
- *
- * const spans = parseMarkup('Take <b>two small</b> coins');
- * const lines = layoutMarkupLines(spans, (piece) => piece.text.length * 8, 100);
- * console.log(lines.map((line) => line.spans.map((span) => span.text).join('')));
- * ```
- */
-export function layoutMarkupLines(spans, measure, maxWidth) {
-    const pieces = [];
-    for (const span of spans) {
-        if (span.image !== undefined) {
-            pieces.push({ ...span });
-            continue;
-        }
-        const parts = span.text.split('\n');
-        parts.forEach((part, index) => {
-            if (index > 0)
-                pieces.push({ text: '', bold: span.bold, italic: span.italic, hardBreak: true });
-            for (const word of part.match(/\S+|\s+/g) ?? []) {
-                pieces.push({
-                    text: word,
-                    bold: span.bold,
-                    italic: span.italic,
-                    color: span.color,
-                    size: span.size,
-                    tag: span.tag,
-                });
-            }
-        });
-    }
-    const lines = [];
-    let current = [];
-    let width = 0;
-    const flushLine = () => {
-        //trailing whitespace never counts toward a line's own width or survives into it
-        while (current.length > 0 &&
-            current[current.length - 1].text.trim() === '' &&
-            !current[current.length - 1].image) {
-            width -= measure(current[current.length - 1]);
-            current.pop();
-        }
-        lines.push({ spans: mergeMarkupSpans(current), width: Math.max(0, width) });
-        current = [];
-        width = 0;
-    };
-    for (const piece of pieces) {
-        if (piece.hardBreak) {
-            flushLine();
-            continue;
-        }
-        const pieceWidth = measure(piece);
-        const isSpace = piece.image === undefined && piece.text.trim() === '';
-        if (width > 0 && !isSpace && width + pieceWidth > maxWidth)
-            flushLine();
-        current.push(piece);
-        width += pieceWidth;
-    }
-    if (current.length > 0 || lines.length === 0)
-        flushLine();
-    return lines;
-}
-function mergeMarkupSpans(pieces) {
-    const merged = [];
-    for (const piece of pieces) {
-        const last = merged[merged.length - 1];
-        if (last &&
-            piece.image === undefined &&
-            last.image === undefined &&
-            last.bold === piece.bold &&
-            last.italic === piece.italic &&
-            last.color === piece.color &&
-            last.size === piece.size &&
-            last.tag === piece.tag) {
-            last.text += piece.text;
-        }
-        else {
-            merged.push({ ...piece });
-        }
-    }
-    return merged;
-}
-/**
- * Positions already-laid-out lines into a flat list of placed runs, one per span, so a canvas
- * backend draws each span as its own `Text2D` (or an image as its own sprite) at the reported
- * `x`/`y`. This is the half `layoutMarkupLines` deliberately leaves out: it decides *which*
- * spans share a line, this decides *where* on the line each one lands.
- *
- * Direction is what makes the two backends equivalent rather than merely identical in text: an
- * `rtl` line places its first (logical) span at the right edge and flows left from it, while an
- * `ltr` line flows right from the left edge, so the same spans read in the language's own order
- * on either side. Alignment then moves the whole line within `maxWidth`, defaulting to the
- * direction's natural edge (`'right'` for `rtl`, `'left'` for `ltr`). A line wider than
- * `maxWidth` is not clipped - the same "a single long word still renders" rule
- * `layoutMarkupLines` already keeps - it simply starts left of zero.
- *
- * @example
- * ```ts
- * import { layoutMarkupLines, parseMarkup, positionMarkupLines } from '@datamoc/mw_games/two-d/ui';
- *
- * const spans = parseMarkup('Take <b>two</b> coins<img>coin.png</img>');
- * const measure = (piece: { text: string; image?: string }) =>
- * 	piece.image !== undefined ? 16 : piece.text.length * 8;
- * const lines = layoutMarkupLines(spans, measure, 120);
- * const runs = positionMarkupLines(lines, { measure, maxWidth: 120, lineHeight: 16 });
- * console.log(runs.map((run) => run.span.image ?? run.span.text).join(''));
- * ```
- */
-export function positionMarkupLines(lines, layout) {
-    const direction = layout.direction ?? 'ltr';
-    const align = layout.align ?? (direction === 'rtl' ? 'right' : 'left');
-    const placed = [];
-    for (let lineIndex = 0; lineIndex < lines.length; lineIndex++) {
-        const line = lines[lineIndex];
-        const y = lineIndex * layout.lineHeight;
-        const widths = line.spans.map((span) => layout.measure(span));
-        const total = widths.reduce((sum, width) => sum + width, 0);
-        const startX = align === 'left' ? 0 : align === 'right' ? layout.maxWidth - total : (layout.maxWidth - total) / 2;
-        let cursor = direction === 'rtl' ? startX + total : startX;
-        for (let index = 0; index < line.spans.length; index++) {
-            const width = widths[index];
-            const x = direction === 'rtl' ? cursor - width : cursor;
-            cursor = direction === 'rtl' ? cursor - width : cursor + width;
-            placed.push({ span: line.spans[index], x, y, width });
-        }
-    }
-    return placed;
-}
-/** escapes the five characters that would otherwise read as syntax */
-export function escapeHtml(text) {
-    return text
-        .replaceAll('&', '&amp;')
-        .replaceAll('<', '&lt;')
-        .replaceAll('>', '&gt;')
-        .replaceAll('"', '&quot;')
-        .replaceAll("'", '&#39;');
-}
-function opened(style, name, body) {
-    if (name === 'b')
-        return { ...style, bold: true };
-    if (name === 'i')
-        return { ...style, italic: true };
-    //a custom tag is an opaque styling container: it carries its own name, nothing else
-    if (name !== 'span')
-        return { ...style, tag: name };
-    const color = attribute(body, 'color');
-    const size = Number(attribute(body, 'size') ?? '');
-    const next = { ...style };
-    if (color)
-        next.color = color;
-    if (Number.isFinite(size) && size > 0)
-        next.size = size;
-    return next;
-}
-/** the value of one attribute, quoted or bare; `undefined` when it is not there */
-function attribute(body, name) {
-    const match = new RegExp(`(?:^|\\s)${name}\\s*=\\s*(?:"([^"]*)"|'([^']*)'|([^\\s"'>]+))`).exec(body);
-    return match ? (match[1] ?? match[2] ?? match[3]) : undefined;
-}
-function readTag(source, at) {
-    const match = /^<(\/?)([a-zA-Z]+)([^>]*)>/.exec(source.slice(at));
-    if (!match)
-        return null;
-    const body = match[3].trimEnd();
-    return {
-        name: match[2].toLowerCase(),
-        closing: match[1] === '/',
-        selfClosing: body.endsWith('/') && match[1] === '',
-        body: body.replace(/\/$/, '').trim(),
-        end: at + match[0].length - 1,
-    };
-}
-/** `<img>path</img>` or `<img src='path'/>`, whichever shape was written; null when neither is */
-function readImage(source, tag) {
-    if (tag.selfClosing) {
-        const src = attribute(tag.body, 'src');
-        return src ? { src, end: tag.end } : null;
-    }
-    const close = source.indexOf('</img>', tag.end + 1);
-    if (close < 0)
-        return null;
-    const src = source.slice(tag.end + 1, close).trim();
-    return src ? { src, end: close + '</img>'.length - 1 } : null;
-}
-function readEntity(source, at) {
-    const named = { lt: '<', gt: '>', amp: '&', quot: '"', apos: "'" };
-    const match = /^&(lt|gt|amp|quot|apos);/.exec(source.slice(at));
-    if (match)
-        return { text: named[match[1]], end: at + match[0].length - 1 };
-    const numeric = /^&#(\d+);/.exec(source.slice(at));
-    if (numeric)
-        return { text: String.fromCodePoint(Number(numeric[1])), end: at + numeric[0].length - 1 };
-    return null;
-}
-function readVariable(source, at) {
-    const match = /^\$([A-Za-z_][A-Za-z0-9_]*)/.exec(source.slice(at));
-    return match ? { name: match[1], end: at + match[0].length - 1 } : null;
-}
-//# sourceMappingURL=markup.js.map

package/dist/two-d/ui/markup.js.map

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

package/dist/two-d/ui/reveal.d.ts

@@ -1,41 +0,0 @@
-/**
- * Progressive text display - the typewriter reveal every dialogue box wants, shared
- * rather than reimplemented per widget. `MessageBox` pages, `Label` lines and `RichLabel`
- * markdown all run on this one character count; what differs is only what each widget
- * counts (`Label` counts string characters, `RichLabel` visible ones via
- * `sliceSpans`, markers excluded) and who calls `advanceReveal` each frame.
- *
- * Pure logic, no Pixi dependency: a game driving its own reveal (a title screen, a
- * tutorial toast) can use this without any widget at all.
- *
- * @example
- * ```ts
- * import { startReveal, advanceReveal, completeReveal, revealComplete } from '@datamoc/mw_games/two-d/ui';
- *
- * const reveal = startReveal('Hello.'.length, 40);
- * advanceReveal(reveal, 0.5); // 20 characters per half second at speed 40
- * revealComplete(reveal); // false
- * completeReveal(reveal); // skip ahead, for a confirm press mid-reveal
- * revealComplete(reveal); // true
- * ```
- */
-export interface RevealState {
-    /** characters to reveal in total, counted the caller's way */
-    total: number;
-    /** characters per second; 0 starts fully revealed */
-    speed: number;
-    /** characters revealed so far, possibly fractional between frames */
-    revealed: number;
-}
-/** starts a reveal; a zero speed (or zero length) is already complete, like `MessageBox` */
-export declare function startReveal(total: number, speed?: number): RevealState;
-/**
- * Moves the reveal forward by `dt` seconds, clamped to the total. Returns whether the
- * reveal is now complete, so a game can prompt, auto-advance, or play a blip on the
- * exact frame the last character lands.
- */
-export declare function advanceReveal(state: RevealState, dt: number): boolean;
-/** shows everything at once - the confirm-press-skips-the-reveal behaviour */
-export declare function completeReveal(state: RevealState): void;
-export declare function revealComplete(state: RevealState): boolean;
-//# sourceMappingURL=reveal.d.ts.map

package/dist/two-d/ui/reveal.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"reveal.d.ts","sourceRoot":"","sources":["../../../src/two-d/ui/reveal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,WAAW;IAC3B,8DAA8D;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,WAAW,CAGlE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAGrE;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,IAAI,CAEvD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAE1D"}