1681-engine 0.5.8 → 0.5.9

package/dist/types/ui/index.d.ts.map

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

package/dist/types/ui/rich/RichText.d.ts

@@ -0,0 +1,48 @@
+import { type DestroyOptions } from 'pixi.js';
+import type { TextureRegistry } from '../../core/TextureRegistry.js';
+import { Widget } from '../Widget.js';
+import type { RichFont } from './richFonts.js';
+import { type RichAlign, type RichLayout, type RichLayoutOptions } from './richLayout.js';
+import { type RichMarkupOptions } from './richMarkup.js';
+export interface RichTextOptions extends RichLayoutOptions, RichMarkupOptions {
+    /** What the runs are drawn with: `CanvasRichFont`, `BitmapRichFont`, or a game's own. */
+    font: RichFont;
+    /** Where `[icon=…]` keys are looked up; without it icons take no room and draw nothing. */
+    textures?: TextureRegistry;
+}
+/**
+ * Text with inline markup — colour, bold, italic, size and icons (see `parseRichText`) — wrapped to a width and
+ * aligned. A `Widget`, so it stacks and pins like a `Label`, and a plain Pixi container in the world too.
+ *
+ * It does its work only when the text or the layout options change: no per-frame cost. Its runs and icons are kept
+ * and reused when the text changes, so a log line rewritten keeps its display objects. Under a pixel-perfect UI root
+ * (or with `pixelPerfect`) every run and icon lands on a whole pixel and icons scale by whole multiples.
+ */
+export declare class RichText extends Widget {
+    private source;
+    private last;
+    private readonly runs;
+    private readonly icons;
+    private readonly measure;
+    private readonly options;
+    /** Whether the last layout was on whole pixels. */
+    private snapped;
+    constructor(markup: string, options: RichTextOptions);
+    /** The markup shown. */
+    get markup(): string;
+    /** Where every line, run and icon was placed, for hit-testing a word or drawing behind one. */
+    get layout(): RichLayout;
+    /** Changes the text; the same markup again costs nothing. */
+    setText(markup: string): this;
+    /** Wraps to a new width (undefined: only at `\n`). */
+    setWrapWidth(width: number | undefined): this;
+    setAlign(align: RichAlign): this;
+    /** Lays out and draws again: after the font's colours or the icons' textures were swapped under it. */
+    relayout(): void;
+    destroy(options?: DestroyOptions): void;
+    protected redraw(): void;
+    private pixelPerfect;
+    private addRun;
+    private addIcon;
+}
+//# sourceMappingURL=RichText.d.ts.map

package/dist/types/ui/rich/RichText.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RichText.d.ts","sourceRoot":"","sources":["../../../../src/ui/rich/RichText.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,SAAS,CAAC;AACtE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAkB,KAAK,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAoB,MAAM,cAAc,CAAC;AACzH,OAAO,EAAiB,KAAK,iBAAiB,EAAkB,MAAM,cAAc,CAAC;AAErF,MAAM,WAAW,eAAgB,SAAQ,iBAAiB,EAAE,iBAAiB;IAC3E,yFAAyF;IACzF,IAAI,EAAE,QAAQ,CAAC;IACf,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,eAAe,CAAC;CAC5B;AAED;;;;;;;GAOG;AACH,qBAAa,QAAS,SAAQ,MAAM;IAClC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,IAAI,CAAkD;IAC9D,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,mDAAmD;IACnD,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe;IAmBpD,wBAAwB;IACxB,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,+FAA+F;IAC/F,IAAI,MAAM,IAAI,UAAU,CAEvB;IAED,6DAA6D;IAC7D,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO7B,sDAAsD;IACtD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAQ7C,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAOhC,uGAAuG;IACvG,QAAQ,IAAI,IAAI;IAoCP,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,IAAI;IAKhD,SAAS,CAAC,MAAM,IAAI,IAAI;IAIxB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,MAAM;IAOd,OAAO,CAAC,OAAO;CAOhB"}

package/dist/types/ui/rich/richFonts.d.ts

@@ -0,0 +1,70 @@
+import { type Container } from 'pixi.js';
+import type { RichMeasure } from './richLayout.js';
+import type { RichStyle } from './richMarkup.js';
+/**
+ * What `RichText` draws its runs with: it measures text for the layout and makes and updates one display object a
+ * run. Two come with the engine — `CanvasRichFont` (any font, bold and italic) and `BitmapRichFont` (glyphs baked
+ * once, cheap to change) — and a game may write its own.
+ */
+export interface RichFont extends Omit<RichMeasure, 'iconSize'> {
+    /** A fresh, empty run. */
+    createRun(): Container;
+    /** Shows `text` in `style` on a run made by `createRun`; cheap when neither changed. */
+    updateRun(run: Container, text: string, style: RichStyle): void;
+}
+export interface RichFontOptions {
+    /** Must already be loaded (`document.fonts.load`), or the text measures and bakes in the fallback. */
+    fontFamily: string;
+    /** The size of text with no `[size]`. */
+    fontSize: number;
+    /** The colour of text with no `[color]`. */
+    color?: string;
+    stroke?: string;
+    strokeWidth?: number;
+    /** Texture pixels per pixel: text in the world is zoomed by the camera, so it is rasterised finer. */
+    resolution?: number;
+}
+/**
+ * Runs as canvas `Text`: any font the page has, with bold and italic. Every style used gets one Pixi `TextStyle`,
+ * shared by every run in it. Changing a run's text repaints and uploads its canvas, so text rewritten every frame
+ * belongs in a `BitmapRichFont`.
+ */
+export declare class CanvasRichFont implements RichFont {
+    private readonly options;
+    private readonly styles;
+    private readonly metrics;
+    constructor(options: RichFontOptions);
+    textWidth(text: string, style: RichStyle): number;
+    lineHeight(style: RichStyle): number;
+    ascent(style: RichStyle): number;
+    createRun(): Container;
+    updateRun(run: Container, text: string, style: RichStyle): void;
+    private metricsOf;
+    private pixiStyle;
+}
+export interface BitmapRichFontOptions extends RichFontOptions {
+    /** Letters beyond ASCII the text prints (see `installLabelFont`). */
+    glyphs?: string;
+}
+/**
+ * Runs as `BitmapText` from label fonts (`installLabelFont`): changing the text costs no canvas and no upload, and the
+ * runs batch. Each colour × size is a font of its own, baked the first time it is used — keep to a few and print each
+ * once while loading, or the first line to use one bakes it on that frame. Bitmap fonts have no bold or italic: those
+ * tags change nothing here.
+ */
+export declare class BitmapRichFont implements RichFont {
+    private readonly options;
+    private readonly styles;
+    private readonly metrics;
+    constructor(options: BitmapRichFontOptions);
+    textWidth(text: string, style: RichStyle): number;
+    lineHeight(style: RichStyle): number;
+    ascent(style: RichStyle): number;
+    createRun(): Container;
+    updateRun(run: Container, text: string, style: RichStyle): void;
+    private metricsOf;
+    /** Bold and italic do not reach a bitmap font: styles differing only by them share one. */
+    private fontKey;
+    private pixiStyle;
+}
+//# sourceMappingURL=richFonts.d.ts.map

package/dist/types/ui/rich/richFonts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"richFonts.d.ts","sourceRoot":"","sources":["../../../../src/ui/rich/richFonts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AAE5G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C;;;;GAIG;AACH,MAAM,WAAW,QAAS,SAAQ,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;IAC7D,0BAA0B;IAC1B,SAAS,IAAI,SAAS,CAAC;IACvB,wFAAwF;IACxF,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;CACjE;AAED,MAAM,WAAW,eAAe;IAC9B,sGAAsG;IACtG,UAAU,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sGAAsG;IACtG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAWD;;;;GAIG;AACH,qBAAa,cAAe,YAAW,QAAQ;IAIjC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;gBAEzB,OAAO,EAAE,eAAe;IAErD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM;IAKjD,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAIpC,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAIhC,SAAS,IAAI,SAAS;IAItB,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAO/D,OAAO,CAAC,SAAS;IAWjB,OAAO,CAAC,SAAS;CAiBlB;AAED,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,QAAQ;IAIjC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgC;IACvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;gBAEzB,OAAO,EAAE,qBAAqB;IAE3D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM;IAKjD,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAIpC,MAAM,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM;IAIhC,SAAS,IAAI,SAAS;IAItB,SAAS,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,IAAI;IAO/D,OAAO,CAAC,SAAS;IAajB,2FAA2F;IAC3F,OAAO,CAAC,OAAO;IAIf,OAAO,CAAC,SAAS;CAYlB"}

package/dist/types/ui/rich/richLayout.d.ts

@@ -0,0 +1,76 @@
+import type { RichSpan, RichStyle } from './richMarkup.js';
+/**
+ * Line breaking and placement for `RichText`, pure: every width and height comes from a `RichMeasure` the caller
+ * hands in, so the same layout runs under node in a test, with a canvas font, or with a bitmap font.
+ *
+ * Lines break only at spaces and `\n`; a word wider than the whole line is broken between letters. Text and icons
+ * with no space between them (`[icon=coin]50`) stay together. Text of one style that ends up side by side on a line
+ * is one item, so a paragraph in one colour costs one display object a line.
+ */
+export interface RichMeasure {
+    /** Advance width of `text` in `style` (spaces included: they are measured on their own). */
+    textWidth(text: string, style: RichStyle): number;
+    /** Height of a line of text in `style`. */
+    lineHeight(style: RichStyle): number;
+    /** Baseline from the top of such a line; 0.8 of the line height when not given. */
+    ascent?(style: RichStyle): number;
+    /** Size of an icon's frame in texture pixels. */
+    iconSize(key: string, frame: string | undefined): {
+        width: number;
+        height: number;
+    };
+}
+export type RichAlign = 'left' | 'center' | 'right';
+export interface RichLayoutOptions {
+    /** Wrap lines to this width; unset, lines break only at `\n`. */
+    wrapWidth?: number;
+    align?: RichAlign;
+    /** Extra pixels between lines. */
+    lineSpacing?: number;
+    /**
+     * `'line'` (default): an icon is as tall as its style's line — on a pixel-perfect layout the largest whole multiple
+     * of its frame that fits, never below 1×, so its texels stay square. A number: that scale, whatever the line.
+     */
+    iconScale?: 'line' | number;
+    /** Whole-pixel positions and icon scales (a pixel-art game). */
+    pixelPerfect?: boolean;
+}
+export interface RichTextItem {
+    kind: 'text';
+    text: string;
+    style: RichStyle;
+    x: number;
+    /** Top of the text's own line box. */
+    y: number;
+    width: number;
+    height: number;
+}
+export interface RichIconItem {
+    kind: 'icon';
+    key: string;
+    frame?: string;
+    style: RichStyle;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export type RichItem = RichTextItem | RichIconItem;
+export interface RichLine {
+    y: number;
+    width: number;
+    height: number;
+    /** Baseline from the line's top. */
+    baseline: number;
+    items: RichItem[];
+}
+export interface RichLayout {
+    /** The box: `wrapWidth` when wrapping, else the widest line. */
+    width: number;
+    height: number;
+    lines: RichLine[];
+}
+/** Breaks spans into lines and places every run and icon. */
+export declare function layoutRichText(spans: readonly RichSpan[], measure: RichMeasure, options?: RichLayoutOptions): RichLayout;
+export declare function sameStyle(a: RichStyle, b: RichStyle): boolean;
+//# sourceMappingURL=richLayout.d.ts.map

package/dist/types/ui/rich/richLayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"richLayout.d.ts","sourceRoot":"","sources":["../../../../src/ui/rich/richLayout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAExD;;;;;;;GAOG;AAEH,MAAM,WAAW,WAAW;IAC1B,4FAA4F;IAC5F,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;IAClD,2CAA2C;IAC3C,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;IACrC,mFAAmF;IACnF,MAAM,CAAC,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;IAClC,iDAAiD;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACrF;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEpD,MAAM,WAAW,iBAAiB;IAChC,iEAAiE;IACjE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,gEAAgE;IAChE,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,sCAAsC;IACtC,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,SAAS,CAAC;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,YAAY,CAAC;AAEnD,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB;AAaD,6DAA6D;AAC7D,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,GAAE,iBAAsB,GAAG,UAAU,CA+D5H;AA4HD,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,GAAG,OAAO,CAE7D"}

package/dist/types/ui/rich/richMarkup.d.ts

@@ -0,0 +1,48 @@
+/**
+ * The markup `RichText` reads: square-bracket tags, like BBCode, chosen because a translator can type them, a chat
+ * line can carry them, and nothing in ordinary prose looks like one.
+ *
+ * | Markup | Means |
+ * |---|---|
+ * | `[color=#f0c060]…[/color]` | colour: `#rgb`, `#rrggbb`, or a name the caller defines (`colors: { gold: '#f0c060' }`) |
+ * | `[b]…[/b]`, `[i]…[/i]` | bold, italic (where the font has them) |
+ * | `[size=16]…[/size]` | font size in pixels |
+ * | `[icon=coin]`, `[icon=items:12]` | an inline icon: a texture key, and after the last `:` a frame of it |
+ * | `[[` | a literal `[` |
+ *
+ * Anything else in brackets — an unknown tag, a bad value, a close with nothing open — is printed as written, so a
+ * typo shows on screen instead of swallowing the text after it. Tags still open at the end are closed there; closing
+ * an outer tag closes the ones opened inside it. Text from players (names, chat) goes through `escapeRichText` first.
+ * Pure: no Pixi, no DOM.
+ */
+/** How a run of text is drawn. Unset fields fall back to the font's own. */
+export interface RichStyle {
+    color?: string;
+    bold: boolean;
+    italic: boolean;
+    size?: number;
+}
+export interface RichTextSpan {
+    kind: 'text';
+    text: string;
+    style: RichStyle;
+}
+export interface RichIconSpan {
+    kind: 'icon';
+    key: string;
+    frame?: string;
+    /** The style around it: its size decides the icon's height. */
+    style: RichStyle;
+}
+export type RichSpan = RichTextSpan | RichIconSpan;
+export interface RichMarkupOptions {
+    /** Colour names the markup may use besides hex (`[color=gold]`). */
+    colors?: Readonly<Record<string, string>>;
+}
+/** Makes text safe to put inside markup: every `[` doubled, so a player named `[b]` prints as typed. */
+export declare function escapeRichText(text: string): string;
+/** Parses markup into spans; adjacent text of one style is one span. */
+export declare function parseRichText(source: string, options?: RichMarkupOptions): RichSpan[];
+/** Plain text of markup: tags gone, icons gone, escapes undone (for measuring, logs, screen readers). */
+export declare function stripRichText(source: string, options?: RichMarkupOptions): string;
+//# sourceMappingURL=richMarkup.d.ts.map

package/dist/types/ui/rich/richMarkup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"richMarkup.d.ts","sourceRoot":"","sources":["../../../../src/ui/rich/richMarkup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,YAAY,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IAChC,oEAAoE;IACpE,MAAM,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC3C;AAMD,wGAAwG;AACxG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,QAAQ,EAAE,CAwCzF;AAED,yGAAyG;AACzG,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAIrF"}

package/dist/ui/Bar.js

@@ -51,4 +51,3 @@ class v extends d {
 export {
   v as Bar
 };
-//# sourceMappingURL=Bar.js.map

package/dist/ui/Button.js

@@ -55,4 +55,3 @@ class v extends d {
 export {
   v as Button
 };
-//# sourceMappingURL=Button.js.map

package/dist/ui/Dialog.js

@@ -53,4 +53,3 @@ class H extends p {
 export {
   H as Dialog
 };
-//# sourceMappingURL=Dialog.js.map

package/dist/ui/FocusManager.js

@@ -94,4 +94,3 @@ export {
   f as DEFAULT_NAV,
   x as FocusManager
 };
-//# sourceMappingURL=FocusManager.js.map

package/dist/ui/Label.js

@@ -33,4 +33,3 @@ class i extends c {
 export {
   i as Label
 };
-//# sourceMappingURL=Label.js.map

package/dist/ui/List.js

@@ -42,4 +42,3 @@ class m extends c {
 export {
   m as List
 };
-//# sourceMappingURL=List.js.map

package/dist/ui/Panel.js

@@ -35,4 +35,3 @@ class x extends f {
 export {
   x as Panel
 };
-//# sourceMappingURL=Panel.js.map

package/dist/ui/ScrollView.js

@@ -93,4 +93,3 @@ class w extends n {
 export {
   w as ScrollView
 };
-//# sourceMappingURL=ScrollView.js.map

package/dist/ui/Slider.js

@@ -52,4 +52,3 @@ class b extends l {
 export {
   b as Slider
 };
-//# sourceMappingURL=Slider.js.map

package/dist/ui/Stack.js

@@ -25,4 +25,3 @@ class f extends h {
 export {
   f as Stack
 };
-//# sourceMappingURL=Stack.js.map

package/dist/ui/Toggle.js

@@ -34,4 +34,3 @@ class o extends a {
 export {
   o as Toggle
 };
-//# sourceMappingURL=Toggle.js.map

package/dist/ui/UiHost.js

@@ -6,4 +6,3 @@ function e(r) {
 export {
   e as uiHostOf
 };
-//# sourceMappingURL=UiHost.js.map

package/dist/ui/UiPointerGate.js

@@ -22,4 +22,3 @@ const u = {
 export {
   u as UiPointerGate
 };
-//# sourceMappingURL=UiPointerGate.js.map

package/dist/ui/UiRoot.js

@@ -90,4 +90,3 @@ class y extends h {
 export {
   y as UiRoot
 };
-//# sourceMappingURL=UiRoot.js.map

package/dist/ui/Widget.js

@@ -87,4 +87,3 @@ export {
   n as Widget,
   b as sizeOf
 };
-//# sourceMappingURL=Widget.js.map

package/dist/ui/dom/DomOverlay.js

@@ -56,4 +56,3 @@ class r {
 export {
   r as DomOverlay
 };
-//# sourceMappingURL=DomOverlay.js.map

package/dist/ui/dom/DomWorldAnchors.js

@@ -56,4 +56,3 @@ class m {
 export {
   m as DomWorldAnchors
 };
-//# sourceMappingURL=DomWorldAnchors.js.map

package/dist/ui/dom/InputShield.js

@@ -24,4 +24,3 @@ class a {
 export {
   a as InputShield
 };
-//# sourceMappingURL=InputShield.js.map

package/dist/ui/dom/createStore.js

@@ -39,4 +39,3 @@ function l(f) {
 export {
   l as createStore
 };
-//# sourceMappingURL=createStore.js.map

package/dist/ui/dom/shieldDecision.js

@@ -33,4 +33,3 @@ export {
   i as isInside,
   u as shouldShield
 };
-//# sourceMappingURL=shieldDecision.js.map

package/dist/ui/dom/worldToScreen.js

@@ -8,4 +8,3 @@ export {
   f as onScreen,
   x as worldToScreen
 };
-//# sourceMappingURL=worldToScreen.js.map

package/dist/ui/layout/anchor.js

@@ -17,4 +17,3 @@ function b(e, t, o, g = 0, n = !1) {
 export {
   b as anchorPosition
 };
-//# sourceMappingURL=anchor.js.map

package/dist/ui/layout/barDrain.js

@@ -22,4 +22,3 @@ export {
   d as setDrainValue,
   f as stepDrain
 };
-//# sourceMappingURL=barDrain.js.map

package/dist/ui/layout/fitToViewport.js

@@ -14,4 +14,3 @@ function W(h, a, n = {}) {
 export {
   W as fitToViewport
 };
-//# sourceMappingURL=fitToViewport.js.map

package/dist/ui/layout/focusNav.js

@@ -39,4 +39,3 @@ export {
   G as linearFocus,
   F as nextFocus
 };
-//# sourceMappingURL=focusNav.js.map

package/dist/ui/layout/geometry.js

@@ -18,4 +18,3 @@ export {
   i as snapPx,
   u as snapRect
 };
-//# sourceMappingURL=geometry.js.map

package/dist/ui/layout/listWidth.js

@@ -7,4 +7,3 @@ function m(i, n, t = {}) {
 export {
   m as listWidth
 };
-//# sourceMappingURL=listWidth.js.map

package/dist/ui/layout/placeTooltip.js

@@ -25,4 +25,3 @@ function a(e, t, s, h = {}) {
 export {
   a as placeTooltip
 };
-//# sourceMappingURL=placeTooltip.js.map

package/dist/ui/layout/scroll.js

@@ -21,4 +21,3 @@ export {
   a as scrollIntoView,
   p as stepFling
 };
-//# sourceMappingURL=scroll.js.map

package/dist/ui/layout/slider.js

@@ -17,4 +17,3 @@ export {
   i as sliderFraction,
   s as sliderValueAt
 };
-//# sourceMappingURL=slider.js.map

package/dist/ui/layout/stack.js

@@ -24,4 +24,3 @@ function M(h, s = {}) {
 export {
   M as stackLayout
 };
-//# sourceMappingURL=stack.js.map

package/dist/ui/layout/wrapRow.js

@@ -10,4 +10,3 @@ function p(s, h, u = 0) {
 export {
   p as wrapRow
 };
-//# sourceMappingURL=wrapRow.js.map

package/dist/ui/rich/RichText.js

@@ -0,0 +1,87 @@
+import { Sprite as a } from "pixi.js";
+import { Widget as c } from "../Widget.js";
+import { layoutRichText as d } from "./richLayout.js";
+import { parseRichText as p } from "./richMarkup.js";
+class b extends c {
+  source = "";
+  last = { width: 0, height: 0, lines: [] };
+  runs = [];
+  icons = [];
+  measure;
+  options;
+  /** Whether the last layout was on whole pixels. */
+  snapped = !1;
+  constructor(t, h) {
+    super(), this.options = { ...h };
+    const s = h.font;
+    this.measure = {
+      textWidth: (i, o) => s.textWidth(i, o),
+      lineHeight: (i) => s.lineHeight(i),
+      ascent: (i) => s.ascent?.(i) ?? s.lineHeight(i) * 0.8,
+      iconSize: (i, o) => {
+        const r = h.textures?.get(i, o);
+        return r ? { width: r.orig.width, height: r.orig.height } : { width: 0, height: 0 };
+      }
+    }, this.source = t, this.relayout(), h.pixelPerfect === void 0 && this.on("added", () => this.pixelPerfect() !== this.snapped && this.relayout());
+  }
+  /** The markup shown. */
+  get markup() {
+    return this.source;
+  }
+  /** Where every line, run and icon was placed, for hit-testing a word or drawing behind one. */
+  get layout() {
+    return this.last;
+  }
+  /** Changes the text; the same markup again costs nothing. */
+  setText(t) {
+    return t === this.source ? this : (this.source = t, this.relayout(), this);
+  }
+  /** Wraps to a new width (undefined: only at `\n`). */
+  setWrapWidth(t) {
+    return t === this.options.wrapWidth ? this : (t === void 0 ? delete this.options.wrapWidth : this.options.wrapWidth = t, this.relayout(), this);
+  }
+  setAlign(t) {
+    return t === (this.options.align ?? "left") ? this : (this.options.align = t, this.relayout(), this);
+  }
+  /** Lays out and draws again: after the font's colours or the icons' textures were swapped under it. */
+  relayout() {
+    const t = this.snapped = this.pixelPerfect(), h = p(this.source, this.options);
+    this.last = d(h, this.measure, { ...this.options, pixelPerfect: t });
+    let s = 0, i = 0;
+    for (const l of this.last.lines)
+      for (const e of l.items) {
+        if (e.kind === "text") {
+          const u = this.runs[s] ?? this.addRun();
+          s++, this.options.font.updateRun(u, e.text, e.style), u.position.set(e.x, e.y), u.visible = !0;
+          continue;
+        }
+        if (!this.options.textures || e.width === 0) continue;
+        const n = this.icons[i] ?? this.addIcon();
+        i++, n.texture = this.options.textures.get(e.key, e.frame), n.position.set(e.x, e.y), n.setSize(e.width, e.height), n.visible = !0;
+      }
+    for (; s < this.runs.length; s++) this.runs[s].visible = !1;
+    for (; i < this.icons.length; i++) this.icons[i].visible = !1;
+    const o = this.boxW, r = this.boxH;
+    this.boxW = Math.ceil(this.last.width), this.boxH = Math.ceil(this.last.height), (this.boxW !== o || this.boxH !== r) && this.notifyResized();
+  }
+  destroy(t) {
+    super.destroy(typeof t == "object" ? { ...t, children: !0, texture: !1 } : { children: !0 });
+  }
+  redraw() {
+    this.alpha = this.enabled ? 1 : 0.5;
+  }
+  pixelPerfect() {
+    return this.options.pixelPerfect ?? this.host?.pixelPerfect ?? !1;
+  }
+  addRun() {
+    const t = this.options.font.createRun();
+    return this.runs.push(t), this.addChild(t), t;
+  }
+  addIcon() {
+    const t = new a();
+    return t.roundPixels = !0, this.icons.push(t), this.addChild(t), t;
+  }
+}
+export {
+  b as RichText
+};