@datamoc/mw_games 0.43.0 → 0.45.0

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

@@ -1,129 +0,0 @@
-import { Container } from 'pixi.js';
-import * as Input from '../../core/Input.js';
-import { ListView } from './ListView.js';
-/**
- * A ready-made rebinding flow over `Input`'s existing `bind`/`keysFor`/`actionsForKey`, the
- * same way `IconGrid` is a ready-made inventory screen over `Inventory` rather than something
- * every game builds by hand. `confirm` on a row starts capturing the next physical key
- * pressed; that capture reads the raw `onKey` signal rather than a named action, since the
- * whole point is accepting a key nothing is bound to yet.
- *
- * Capturing a key replaces that action's *entire* existing binding, the same way a settings
- * screen's "press a key" always means "this is the key now", not "add one more" - a row shows
- * every key `Input.keysFor` currently returns, but confirming it always ends with exactly one.
- *
- * Pressing the physical Escape key while capturing cancels it rather than binding Escape
- * itself - the same reservation `DEFAULT_BINDINGS` already makes for `'cancel'`, and the only
- * way to back out of a capture once started.
- *
- * @example
- * ```ts
- * import { RebindScreen } from '@datamoc/mw_games/two-d/ui';
- *
- * const screen = new RebindScreen({
- * 	width: 200,
- * 	height: 120,
- * 	actions: ['moveUp', 'moveDown', 'confirm'],
- * 	label: (action) => action, // a game usually maps this to a translated string
- * });
- *
- * screen.handleAction('confirm'); // starts capturing a new key for the highlighted action
- * console.log(screen.isCapturing); // true
- * ```
- */
-export class RebindScreen extends Container {
-    constructor(options) {
-        super();
-        this.capturing = null;
-        this.onKeyCaptured = (event) => {
-            if (!this.capturing)
-                return false;
-            event.preventDefault(); // Tab, Space and the arrow keys all have a default action to suppress
-            if (event.code === 'Escape')
-                this.cancelCapture();
-            else
-                this.finishCapture(this.capturing, event.code);
-            return true; // swallow the key so it never also reaches gameplay bindings
-        };
-        this.actions = [...options.actions];
-        this.labelFor = options.label ?? ((action) => action);
-        this.onConflict = options.onConflict ?? (() => true);
-        this.list = new ListView({
-            width: options.width,
-            height: options.height,
-            rowHeight: options.rowHeight,
-            items: this.rows(),
-        });
-        this.addChild(this.list);
-    }
-    rows() {
-        return this.actions.map((action) => ({
-            text: this.rowText(action),
-            value: action,
-            disabled: this.capturing !== null && this.capturing !== action,
-        }));
-    }
-    rowText(action) {
-        if (this.capturing === action)
-            return `${this.labelFor(action)}: press a key...`;
-        const keys = Input.keysFor(action);
-        return `${this.labelFor(action)}: ${keys.length ? keys.join(', ') : '(unbound)'}`;
-    }
-    refresh() {
-        const selected = this.list.selectedIndex;
-        this.list.setItems(this.rows());
-        this.list.select(selected);
-    }
-    startCapture(action) {
-        this.capturing = action;
-        this.refresh();
-        //`onAction` (which routes here through `confirm`) fires before `onKey` for the very
-        //same physical keydown, both from the one Input.handleKeyDown call - adding the raw
-        //listener synchronously would let that same keydown finish dispatching straight into
-        //it, capturing "Enter" as the binding. Deferring past the current microtask lands
-        //after that dispatch has fully unwound, so only the *next* key press is captured.
-        queueMicrotask(() => {
-            if (this.capturing === action)
-                Input.onKey.add(this.onKeyCaptured);
-        });
-    }
-    cancelCapture() {
-        Input.onKey.remove(this.onKeyCaptured);
-        this.capturing = null;
-        this.refresh();
-    }
-    finishCapture(action, key) {
-        Input.onKey.remove(this.onKeyCaptured);
-        this.capturing = null;
-        const previousOwners = Input.actionsForKey(key).filter((other) => other !== action);
-        if (previousOwners.length > 0 && !this.onConflict(key, action, previousOwners)) {
-            this.refresh(); // capture refused; every binding is left exactly as it was
-            return;
-        }
-        for (const other of previousOwners)
-            Input.bind(other, Input.keysFor(other).filter((k) => k !== key));
-        Input.bind(action, [key]);
-        this.refresh();
-    }
-    /** true while waiting for the next physical key press to bind */
-    get isCapturing() {
-        return this.capturing !== null;
-    }
-    /** @returns true when the action was used */
-    handleAction(action) {
-        if (this.capturing)
-            return true; // the raw key listener handles everything while capturing
-        if (action === 'confirm') {
-            const selected = this.list.selected?.value;
-            if (selected)
-                this.startCapture(selected);
-            return true;
-        }
-        return this.list.handleAction(action);
-    }
-    destroy(options) {
-        Input.onKey.remove(this.onKeyCaptured);
-        super.destroy(options);
-    }
-}
-//# sourceMappingURL=RebindScreen.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"RebindScreen.js","sourceRoot":"","sources":["../../../src/two-d/ui/RebindScreen.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,KAAK,KAAK,MAAM,qBAAqB,CAAC;AAE7C,OAAO,EAAE,QAAQ,EAAiB,MAAM,eAAe,CAAC;AAwBxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,OAAO,YAAa,SAAQ,SAAS;IAe1C,YAAY,OAA4B;QACvC,KAAK,EAAE,CAAC;QAXD,cAAS,GAAkB,IAAI,CAAC;QAChC,kBAAa,GAAG,CAAC,KAAoB,EAAW,EAAE;YACzD,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO,KAAK,CAAC;YAClC,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC,sEAAsE;YAE9F,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;gBAAE,IAAI,CAAC,aAAa,EAAE,CAAC;;gBAC7C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACpD,OAAO,IAAI,CAAC,CAAC,6DAA6D;QAC3E,CAAC,CAAC;QAID,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAErD,IAAI,CAAC,IAAI,GAAG,IAAI,QAAQ,CAAC;YACxB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE;SAClB,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAEO,IAAI;QACX,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YACpC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;YAC1B,KAAK,EAAE,MAAM;YACb,QAAQ,EAAE,IAAI,CAAC,SAAS,KAAK,IAAI,IAAI,IAAI,CAAC,SAAS,KAAK,MAAM;SAC9D,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,OAAO,CAAC,MAAc;QAC7B,IAAI,IAAI,CAAC,SAAS,KAAK,MAAM;YAAE,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,kBAAkB,CAAC;QACjF,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACnC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACnF,CAAC;IAEO,OAAO;QACd,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAEO,YAAY,CAAC,MAAc;QAClC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC;QACxB,IAAI,CAAC,OAAO,EAAE,CAAC;QAEf,oFAAoF;QACpF,oFAAoF;QACpF,qFAAqF;QACrF,kFAAkF;QAClF,kFAAkF;QAClF,cAAc,CAAC,GAAG,EAAE;YACnB,IAAI,IAAI,CAAC,SAAS,KAAK,MAAM;gBAAE,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACpE,CAAC,CAAC,CAAC;IACJ,CAAC;IAEO,aAAa;QACpB,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,OAAO,EAAE,CAAC;IAChB,CAAC;IAEO,aAAa,CAAC,MAAc,EAAE,GAAW;QAChD,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QAEtB,MAAM,cAAc,GAAG,KAAK,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC;QACpF,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,CAAC;YAChF,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,2DAA2D;YAC3E,OAAO;QACR,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,cAAc;YACjC,KAAK,CAAC,IAAI,CACT,KAAK,EACL,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAC7C,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,OAAO,EAAE,CAAC;IAChB,CAAC;IAED,iEAAiE;IACjE,IAAI,WAAW;QACd,OAAO,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC;IAChC,CAAC;IAED,6CAA6C;IAC7C,YAAY,CAAC,MAAc;QAC1B,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO,IAAI,CAAC,CAAC,0DAA0D;QAE3F,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,KAA2B,CAAC;YACjE,IAAI,QAAQ;gBAAE,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC;QACb,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACvC,CAAC;IAEQ,OAAO,CAAC,OAA6C;QAC7D,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACvC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;CACD"}

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

@@ -1,62 +0,0 @@
-import { HTMLText, type HTMLTextStyleOptions } from 'pixi.js';
-import { type ThemedTextOptions } from './themedText.ts';
-export interface RichLabelOptions extends ThemedTextOptions {
-    /** Text texture resolution; omit to use the renderer default. */
-    resolution?: number;
-    /**
-     * Pixi `HTMLText` tag styles for custom inline tags, the same option a bare `Text2D` takes:
-     * supplying `<quest>`, say, makes `<quest>...</quest>` a styled run rather than escaped text.
-     */
-    tagStyles?: Record<string, HTMLTextStyleOptions>;
-}
-/**
- * A label that renders basic inline markdown (`**bold**`, `__bold__`, `*italic*`,
- * `_italic*`, combined `***both***`) through Pixi's `HTMLText`, which is what makes
- * mixed styles inside one string possible at all - plain `Text` styles the whole string
- * or nothing, which is exactly what `Label` stays for.
- *
- * Costs more than a `Label`: HTML text measures and re-renders through the DOM rather
- * than one canvas texture upload, so this is for descriptions, dialogue lines and help
- * bodies, not for a number updated every frame. For the same reason it does not suit
- * `MessageBox`'s typewriter reveal - a half-revealed `**bo` shows its markers literally.
- *
- * @example
- * ```ts
- * import { RichLabel } from '@datamoc/mw_games/two-d/ui';
- *
- * const blurb = new RichLabel({ text: 'Take **two** *small* coins' });
- *
- * blurb.setText('Take **three** coins'); // skips the re-render if the string is unchanged
- * ```
- */
-export declare class RichLabel extends HTMLText {
-    private readonly opts;
-    private readonly tags;
-    private readonly themeListener;
-    private revealSpans;
-    private reveal;
-    constructor(options?: RichLabelOptions | string);
-    /** avoids the re-render when the markdown source has not actually changed */
-    setText(value: string): void;
-    /**
-     * Shows markdown `value` progressively, `speed` visible characters per second -
-     * markers never count toward the total and never leak half-shown, which is exactly
-     * what a plain character slice over the source would get wrong. Driven by
-     * `updateReveal(dt)` like `Label`'s own reveal, for the same reason: a label owns no
-     * update loop of its own.
-     */
-    showProgressive(value: string, speed?: number): void;
-    /** advances an in-progress reveal; returns true when nothing is left to show */
-    updateReveal(dt: number): boolean;
-    /** shows the whole in-progress text at once */
-    completeReveal(): void;
-    private renderRevealed;
-    /**
-     * Reapplies whichever style fields were never given an explicit option, the same rule
-     * `Label`'s own restyle follows: an explicit `color`/`size` survives a theme change
-     * while theme defaults pick up the new one.
-     */
-    private restyle;
-    destroy(options?: Parameters<HTMLText['destroy']>[0]): void;
-}
-//# sourceMappingURL=RichLabel.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"RichLabel.d.ts","sourceRoot":"","sources":["../../../src/two-d/ui/RichLabel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAiB,KAAK,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAE7E,OAAO,EAAqC,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAI5F,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;IAC1D,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CACjD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,SAAU,SAAQ,QAAQ;IACtC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiC;IAC/D,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,MAAM,CAA4B;IAE1C,YAAY,OAAO,GAAE,gBAAgB,GAAG,MAAW,EAyBlD;IAED,6EAA6E;IAC7E,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAM3B;IAED;;;;;;OAMG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAInD;IAED,gFAAgF;IAChF,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAKhC;IAED,+CAA+C;IAC/C,cAAc,IAAI,IAAI,CAIrB;IAED,OAAO,CAAC,cAAc;IAOtB;;;;OAIG;IACH,OAAO,CAAC,OAAO;IAUN,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAGnE;CACD"}

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

@@ -1,146 +0,0 @@
-import { HTMLText, HTMLTextStyle } from 'pixi.js';
-import { theme, themeChanged } from './theme.js';
-import { normalizeTextOptions, themedAlign } from './themedText.js';
-import { parseMarkdown, sliceSpans, stripMarkdown } from './markdown.js';
-import { startReveal, advanceReveal, completeReveal } from './reveal.js';
-/**
- * A label that renders basic inline markdown (`**bold**`, `__bold__`, `*italic*`,
- * `_italic*`, combined `***both***`) through Pixi's `HTMLText`, which is what makes
- * mixed styles inside one string possible at all - plain `Text` styles the whole string
- * or nothing, which is exactly what `Label` stays for.
- *
- * Costs more than a `Label`: HTML text measures and re-renders through the DOM rather
- * than one canvas texture upload, so this is for descriptions, dialogue lines and help
- * bodies, not for a number updated every frame. For the same reason it does not suit
- * `MessageBox`'s typewriter reveal - a half-revealed `**bo` shows its markers literally.
- *
- * @example
- * ```ts
- * import { RichLabel } from '@datamoc/mw_games/two-d/ui';
- *
- * const blurb = new RichLabel({ text: 'Take **two** *small* coins' });
- *
- * blurb.setText('Take **three** coins'); // skips the re-render if the string is unchanged
- * ```
- */
-export class RichLabel extends HTMLText {
-    constructor(options = {}) {
-        const opts = normalizeTextOptions(options);
-        const t = theme();
-        const tags = opts.tagStyles === undefined ? [] : Object.keys(opts.tagStyles);
-        super({
-            text: toHtml(opts.text ?? '', tags),
-            resolution: opts.resolution,
-            style: new HTMLTextStyle({
-                fontFamily: t.font.family,
-                fontSize: opts.size ?? t.font.size,
-                fontWeight: opts.bold ? 'bold' : 'normal',
-                fill: opts.color ?? t.color.text,
-                lineHeight: (opts.size ?? t.font.size) * t.font.lineHeight,
-                align: themedAlign(opts, t),
-                wordWrap: opts.wrapWidth !== undefined,
-                wordWrapWidth: opts.wrapWidth ?? 0,
-                breakWords: true,
-                tagStyles: opts.tagStyles,
-            }),
-        });
-        this.themeListener = (t) => this.restyle(t);
-        this.revealSpans = null;
-        this.reveal = null;
-        this.opts = opts;
-        this.tags = tags;
-        themeChanged.add(this.themeListener);
-    }
-    /** avoids the re-render when the markdown source has not actually changed */
-    setText(value) {
-        //an instant set cancels any reveal in progress - the two never interleave
-        this.revealSpans = null;
-        this.reveal = null;
-        const html = toHtml(value, this.tags);
-        if (this.text !== html)
-            this.text = html;
-    }
-    /**
-     * Shows markdown `value` progressively, `speed` visible characters per second -
-     * markers never count toward the total and never leak half-shown, which is exactly
-     * what a plain character slice over the source would get wrong. Driven by
-     * `updateReveal(dt)` like `Label`'s own reveal, for the same reason: a label owns no
-     * update loop of its own.
-     */
-    showProgressive(value, speed) {
-        this.revealSpans = parseMarkdown(value);
-        this.reveal = startReveal(stripMarkdown(value).length, speed);
-        this.renderRevealed();
-    }
-    /** advances an in-progress reveal; returns true when nothing is left to show */
-    updateReveal(dt) {
-        if (!this.reveal)
-            return true;
-        const done = advanceReveal(this.reveal, dt);
-        this.renderRevealed();
-        return done;
-    }
-    /** shows the whole in-progress text at once */
-    completeReveal() {
-        if (!this.reveal)
-            return;
-        completeReveal(this.reveal);
-        this.renderRevealed();
-    }
-    renderRevealed() {
-        if (!this.reveal || !this.revealSpans)
-            return;
-        //through the field rather than setText, which cancels a reveal in progress
-        const html = toHtmlSpans(sliceSpans(this.revealSpans, this.reveal.revealed), this.tags);
-        if (this.text !== html)
-            this.text = html;
-    }
-    /**
-     * Reapplies whichever style fields were never given an explicit option, the same rule
-     * `Label`'s own restyle follows: an explicit `color`/`size` survives a theme change
-     * while theme defaults pick up the new one.
-     */
-    restyle(t) {
-        this.style.fontFamily = t.font.family;
-        if (this.opts.color === undefined)
-            this.style.fill = t.color.text;
-        if (this.opts.size === undefined) {
-            this.style.fontSize = t.font.size;
-            this.style.lineHeight = t.font.size * t.font.lineHeight;
-        }
-        if (this.opts.align === undefined)
-            this.style.align = themedAlign(this.opts, t);
-    }
-    destroy(options) {
-        themeChanged.remove(this.themeListener);
-        super.destroy(options);
-    }
-}
-/** styled spans to an HTML fragment; literal text is escaped so `a < b` never parses */
-function toHtml(source, tags) {
-    return toHtmlSpans(parseMarkdown(source), tags);
-}
-function toHtmlSpans(spans, tags) {
-    return spans
-        .map((span) => {
-        let text = escapeHtml(span.text, tags);
-        if (span.italic)
-            text = `<i>${text}</i>`;
-        if (span.bold)
-            text = `<b>${text}</b>`;
-        return text;
-    })
-        .join('');
-}
-/**
- * Escapes literal text, then un-escapes the registered custom tags again, so `a < b` never parses
- * but `<quest>...</quest>` survives as a real element for `HTMLText`'s own `tagStyles` to match.
- */
-function escapeHtml(text, tags) {
-    let html = text.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;');
-    for (const tag of tags) {
-        html = html.replaceAll(`&lt;${tag}&gt;`, `<${tag}>`).replaceAll(`&lt;/${tag}&gt;`, `</${tag}>`);
-    }
-    return html;
-}
-//# sourceMappingURL=RichLabel.js.map

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

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

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

@@ -1,157 +0,0 @@
-import { Container } from 'pixi.js';
-import { Signal } from '../../core/Signal.ts';
-/**
- * Clamps a scroll offset so the content never pulls away from the top or leaves a gap past the
- * bottom. When the content is shorter than the viewport the only offset is 0.
- *
- * @example
- * ```ts
- * import { scrollOffset } from '@datamoc/mw_games/two-d/ui';
- *
- * console.log(scrollOffset(-5, 500, 200)); // 0
- * console.log(scrollOffset(900, 500, 200)); // 300
- * ```
- */
-export declare function scrollOffset(offset: number, contentSize: number, viewportSize: number): number;
-/**
- * Touch scrolling as plain numbers: feed it pointer positions and it says how far the content moves
- * while the finger is down, then keeps coasting after release with a friction that decays the speed.
- * No pointer events or clock of its own, so it is the same under a test as under a finger.
- *
- * @example
- * ```ts
- * import { ScrollDrag } from '@datamoc/mw_games/two-d/ui';
- *
- * const drag = new ScrollDrag();
- * drag.start(200, 0);
- * console.log(drag.move(170, 0.1)); // 30: the content follows the finger up
- * drag.end();
- * console.log(drag.step(1 / 60) > 0); // true: it keeps coasting
- * ```
- */
-export declare class ScrollDrag {
-    /** content pixels per second the content keeps moving at after release; 0 when at rest */
-    velocity: number;
-    dragging: boolean;
-    /** how far the pointer has travelled since `start`, to tell a drag from a tap */
-    travelled: number;
-    private lastY;
-    private lastTime;
-    private readonly friction;
-    private readonly minSpeed;
-    /**
-     * @param friction fraction of the speed lost per second of coasting; 0.92 when omitted
-     * @param minSpeed the speed, in pixels per second, below which it counts as at rest; 8 when omitted
-     */
-    constructor(friction?: number, minSpeed?: number);
-    start(y: number, time: number): void;
-    /** @returns how far the content should move for this pointer position */
-    move(y: number, time: number): number;
-    end(): void;
-    /** @returns how far the content coasts in `dt` seconds, 0 once it has stopped */
-    step(dt: number): number;
-    /** stops coasting, for when the content hit an end */
-    stop(): void;
-}
-export interface ScrollBoxOptions {
-    width: number;
-    /** the viewport's height, or its largest height when `autoHeight` is on */
-    height: number;
-    /** how tall the content is; set it again with `setContentHeight` as the content changes */
-    contentHeight?: number;
-    offset?: number;
-    /** dragging the content scrolls it and it coasts on release (`update(dt)` drives the coasting) */
-    touch?: boolean;
-    /** `handleKey` scrolls by line, page and to the ends */
-    keyboard?: boolean;
-    /** a viewport as tall as the content, up to `height` */
-    autoHeight?: boolean;
-    /** how far an arrow key scrolls; 24 when omitted */
-    lineHeight?: number;
-}
-/** the key names `ScrollBox.handleKey` answers to, as `KeyboardEvent.key` spells them */
-export type ScrollKey = 'ArrowUp' | 'ArrowDown' | 'PageUp' | 'PageDown' | 'Home' | 'End';
-/**
- * A clipped viewport with a scrollbar: put rows in `content` and they scroll inside the box,
- * everything outside it hidden by a mask. The scrollbar is drawn from the theme; the wheel,
- * `scrollBy` and `scrollIntoView` all run through `scrollOffset`, so they clamp the same way.
- *
- * `touch: true` lets a finger drag the content (a drag ends the tap on the rows under it) and coast
- * on release, `keyboard: true` makes `handleKey` scroll by line, page and to the ends, the scrollbar's
- * thumb can be dragged and its track clicked, and `autoHeight` sizes the viewport to the content up
- * to `height`. Call `update(dt)` each frame for the coasting.
- *
- * @example
- * ```ts
- * import { ScrollBox } from '@datamoc/mw_games/two-d/ui';
- *
- * const box = new ScrollBox({ width: 200, height: 120, contentHeight: 400 });
- * box.scrollBy(60);
- * console.log(box.offset); // 60
- * ```
- */
-export declare class ScrollBox extends Container {
-    readonly onChange: Signal<number>;
-    /** add the rows to scroll here */
-    readonly content: Container<import("pixi.js").ContainerChild>;
-    private maskShape;
-    private track;
-    private thumb;
-    private width_;
-    private maxHeight_;
-    private height_;
-    private contentHeight_;
-    private offset_;
-    private readonly auto;
-    private readonly lineHeight;
-    private readonly drag;
-    private dragMoved;
-    private thumbGrab;
-    private readonly themeListener;
-    constructor(options: ScrollBoxOptions);
-    get offset(): number;
-    get contentHeight(): number;
-    get viewportHeight(): number;
-    /** the viewport's height: the content's, capped at the maximum, when `autoHeight` is on */
-    private fit;
-    /** how far the content can scroll; 0 when it all fits */
-    get maxOffset(): number;
-    get scrollable(): boolean;
-    setContentHeight(height: number): void;
-    resize(width: number, height: number): void;
-    scrollBy(delta: number): void;
-    scrollTo(offset: number): void;
-    /** scrolls just enough to bring a `height`-tall item at `top` fully into view */
-    scrollIntoView(top: number, height: number): void;
-    /**
-     * Scrolls for a key a keyboard-driven list was handed (`KeyboardEvent.key`).
-     *
-     * @returns true when the key is one this box scrolls by, so a caller can stop it going further
-     */
-    handleKey(key: string): boolean;
-    /** a finger or button went down at `y` (any one coordinate space, `time` in seconds) */
-    dragStart(y: number, time: number): void;
-    /** the pointer moved while down; the content follows once it has travelled a few pixels */
-    dragMove(y: number, time: number): void;
-    dragEnd(): void;
-    /** true once the pointer travelled far enough to count as a drag rather than a tap */
-    get dragged(): boolean;
-    /** advances touch coasting; call once a frame from the owning scene's `update` */
-    update(dt: number): void;
-    /** where the scrollbar's thumb sits and how tall it is, in the box's own space */
-    get thumbMetrics(): {
-        y: number;
-        height: number;
-    };
-    /** the thumb was grabbed at `y` */
-    thumbDragStart(y: number): void;
-    /** the thumb moved to `y`: the offset follows in proportion to the thumb's travel */
-    thumbDragMove(y: number): void;
-    /** a click on the track at local `y` puts the thumb's centre there */
-    scrollToThumbCentre(y: number): void;
-    private setOffset;
-    private readonly handleWheel;
-    private draw;
-    destroy(options?: Parameters<Container['destroy']>[0]): void;
-}
-//# sourceMappingURL=ScrollBox.d.ts.map

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

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