@datamoc/mw_games 0.44.2 → 0.45.0

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

@@ -1,221 +0,0 @@
-import { Signal } from '../../core/Signal.js';
-/**
- * The model behind a tabbed, searchable, paged list - an inventory, journal, shop or codex -
- * kept apart from how it is drawn, the same split `SelectionModel` already draws for plain
- * lists. The caller supplies the tabs and the rows per tab (any type it likes, so no item
- * taxonomy is assumed), plus optionally how a row labels, filters and disables itself; this
- * owns the tab choice, the query, the selection, the page and the detail/close state.
- *
- * The page is derived from the selection rather than tracked beside it: a selection index
- * into the filtered rows decides which page is visible, so the two can never disagree and
- * `nextPage` is just a selection move of one page. `move` skips disabled rows.
- *
- * Rendering is the caller's: read `pageRows` and `selectedIndex` each frame, or listen to
- * `onChange`.
- *
- * @example
- * ```ts
- * import { TabbedList } from '@datamoc/mw_games/two-d/ui';
- *
- * const items = [
- *   { name: 'Sword', kind: 'weapon' },
- *   { name: 'Bread', kind: 'food' },
- *   { name: 'Shield', kind: 'armor' },
- * ];
- *
- * const list = new TabbedList<(typeof items)[number]>({
- *   tabs: [{ id: 'all', label: 'All' }, { id: 'weapon', label: 'Weapons' }],
- *   rowsFor: (tab) => (tab === 'all' ? items : items.filter((item) => item.kind === tab)),
- *   label: (item) => item.name,
- *   pageSize: 2,
- * });
- *
- * console.log(list.selected?.name); // 'Sword'
- * list.setQuery('sh'); // filter down to Shield; selection and page reset
- * console.log(list.rows.length, list.page); // 1 0
- * list.openDetail(); // true, with the current row
- * ```
- */
-export class TabbedList {
-    constructor(options) {
-        /** fires whenever the tab, query, selection, page or detail state changes */
-        this.onChange = new Signal();
-        this.currentTabIndex = 0;
-        this.currentQuery = '';
-        this.rows_ = [];
-        this.currentSelectedIndex = 0;
-        this.detail = false;
-        if (options.tabs.length === 0)
-            throw new Error('TabbedList needs at least one tab');
-        this.tabList = [...options.tabs];
-        this.rowsFor = options.rowsFor;
-        this.pageSize = Math.max(0, Math.floor(options.pageSize ?? 0));
-        this.labelOf = options.label ?? ((row) => String(row));
-        this.filterOf =
-            options.filter ??
-                ((row, query) => (query === '' ? true : this.labelOf(row).toLowerCase().includes(query.toLowerCase())));
-        this.disabledOf = options.disabled ?? (() => false);
-        this.recompute();
-    }
-    /** every tab, in display order, for a tab strip to draw */
-    get tabs() {
-        return this.tabList;
-    }
-    /** the currently open tab */
-    get tab() {
-        return this.tabList[this.currentTabIndex];
-    }
-    get query() {
-        return this.currentQuery;
-    }
-    /** the filtered rows of the current tab, across every page */
-    get rows() {
-        return this.rows_;
-    }
-    /** how many pages `rows` fills; always at least 1, so an empty list is one empty page */
-    get pageCount() {
-        if (this.pageSize <= 0)
-            return 1;
-        return Math.max(1, Math.ceil(this.rows_.length / this.pageSize));
-    }
-    /** the page the selection is on, derived from it rather than tracked next to it */
-    get page() {
-        if (this.pageSize <= 0)
-            return 0;
-        return Math.floor(this.currentSelectedIndex / this.pageSize);
-    }
-    /** the rows the current page shows */
-    get pageRows() {
-        if (this.pageSize <= 0)
-            return this.rows_;
-        const start = this.page * this.pageSize;
-        return this.rows_.slice(start, start + this.pageSize);
-    }
-    /** the selection's index into `rows` (not into `pageRows`) */
-    get selectedIndex() {
-        return this.currentSelectedIndex;
-    }
-    get selected() {
-        return this.rows_[this.currentSelectedIndex] ?? null;
-    }
-    /** whether the detail view has been opened for the current selection */
-    get detailOpen() {
-        return this.detail;
-    }
-    /** opens `id`'s tab; a disabled tab or an unknown id is ignored */
-    selectTab(id) {
-        const index = this.tabList.findIndex((tab) => tab.id === id);
-        if (index === -1 || this.tabList[index].disabled)
-            return;
-        if (index === this.currentTabIndex)
-            return;
-        this.currentTabIndex = index;
-        this.recompute();
-        this.emit();
-    }
-    /** moves to the next enabled tab, `delta` steps on (wrapping); skips disabled tabs */
-    nextTab(delta = 1) {
-        if (delta === 0)
-            return;
-        const step = delta > 0 ? 1 : -1;
-        let index = this.currentTabIndex;
-        for (let moved = 0; moved < Math.abs(delta); moved++) {
-            do {
-                index = (index + step + this.tabList.length) % this.tabList.length;
-            } while (this.tabList[index].disabled && index !== this.currentTabIndex);
-        }
-        if (index === this.currentTabIndex)
-            return;
-        this.currentTabIndex = index;
-        this.recompute();
-        this.emit();
-    }
-    /** replaces the query; the selection and page reset to the first row that survives it */
-    setQuery(query) {
-        if (query === this.currentQuery)
-            return;
-        this.currentQuery = query;
-        this.recompute();
-        this.emit();
-    }
-    /** moves the selection `delta` rows, skipping disabled ones and clamping at both ends */
-    move(delta) {
-        if (delta === 0 || this.rows_.length === 0)
-            return;
-        const step = delta > 0 ? 1 : -1;
-        let index = this.currentSelectedIndex;
-        for (let moved = 0; moved < Math.abs(delta); moved++) {
-            let candidate = index;
-            do {
-                candidate += step;
-            } while (candidate >= 0 && candidate < this.rows_.length && this.disabledOf(this.rows_[candidate]));
-            if (candidate < 0 || candidate >= this.rows_.length)
-                break;
-            index = candidate;
-        }
-        if (index === this.currentSelectedIndex)
-            return;
-        this.currentSelectedIndex = index;
-        this.emit();
-    }
-    /** jumps to a page by number, clamped; the selection moves to its first selectable row */
-    setPage(page) {
-        const target = Math.max(0, Math.min(this.pageCount - 1, Math.floor(page)));
-        if (this.pageSize <= 0)
-            return;
-        const first = this.firstSelectableOnPage(target);
-        if (first === this.currentSelectedIndex)
-            return;
-        this.currentSelectedIndex = first;
-        this.emit();
-    }
-    /** moves `delta` pages; the selection lands on the target page's first selectable row */
-    nextPage(delta) {
-        this.setPage(this.page + delta);
-    }
-    /** opens the detail view for the current selection; false when there is nothing to open */
-    openDetail() {
-        if (this.selected === null || this.disabledOf(this.selected))
-            return false;
-        if (!this.detail) {
-            this.detail = true;
-            this.emit();
-        }
-        return true;
-    }
-    closeDetail() {
-        if (!this.detail)
-            return;
-        this.detail = false;
-        this.emit();
-    }
-    /** the first row on `page` that is not disabled, or its first row when all are */
-    firstSelectableOnPage(page) {
-        const start = page * this.pageSize;
-        const end = Math.min(this.rows_.length, start + this.pageSize);
-        for (let i = start; i < end; i++) {
-            if (!this.disabledOf(this.rows_[i]))
-                return i;
-        }
-        return Math.min(start, Math.max(0, this.rows_.length - 1));
-    }
-    firstSelectable(from) {
-        for (let i = from; i < this.rows_.length; i++) {
-            if (!this.disabledOf(this.rows_[i]))
-                return i;
-        }
-        return 0;
-    }
-    /** rebuilds the visible rows and parks the selection on the first selectable one */
-    recompute() {
-        const all = this.rowsFor(this.tab.id);
-        const filtered = all.filter((row) => this.filterOf(row, this.currentQuery));
-        this.rows_ = filtered;
-        this.currentSelectedIndex = filtered.length === 0 ? 0 : this.firstSelectable(0);
-        this.detail = false;
-    }
-    emit() {
-        this.onChange.dispatch();
-    }
-}
-//# sourceMappingURL=TabbedList.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"TabbedList.js","sourceRoot":"","sources":["../../../src/two-d/ui/TabbedList.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAkC9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,OAAO,UAAU;IAiBtB,YAAY,OAA6B;QAhBzC,6EAA6E;QACpE,aAAQ,GAAG,IAAI,MAAM,EAAQ,CAAC;QAS/B,oBAAe,GAAG,CAAC,CAAC;QACpB,iBAAY,GAAG,EAAE,CAAC;QAClB,UAAK,GAAQ,EAAE,CAAC;QAChB,yBAAoB,GAAG,CAAC,CAAC;QACzB,WAAM,GAAG,KAAK,CAAC;QAGtB,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACpF,IAAI,CAAC,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC;QAC/D,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACvD,IAAI,CAAC,QAAQ;YACZ,OAAO,CAAC,MAAM;gBACd,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;QACzG,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QACpD,IAAI,CAAC,SAAS,EAAE,CAAC;IAClB,CAAC;IAED,2DAA2D;IAC3D,IAAI,IAAI;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,6BAA6B;IAC7B,IAAI,GAAG;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,YAAY,CAAC;IAC1B,CAAC;IAED,8DAA8D;IAC9D,IAAI,IAAI;QACP,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IAED,yFAAyF;IACzF,IAAI,SAAS;QACZ,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,mFAAmF;IACnF,IAAI,IAAI;QACP,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC;QACjC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9D,CAAC;IAED,sCAAsC;IACtC,IAAI,QAAQ;QACX,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC,KAAK,CAAC;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;QACxC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvD,CAAC;IAED,8DAA8D;IAC9D,IAAI,aAAa;QAChB,OAAO,IAAI,CAAC,oBAAoB,CAAC;IAClC,CAAC;IAED,IAAI,QAAQ;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,IAAI,CAAC;IACtD,CAAC;IAED,wEAAwE;IACxE,IAAI,UAAU;QACb,OAAO,IAAI,CAAC,MAAM,CAAC;IACpB,CAAC;IAED,mEAAmE;IACnE,SAAS,CAAC,EAAU;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7D,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ;YAAE,OAAO;QACzD,IAAI,KAAK,KAAK,IAAI,CAAC,eAAe;YAAE,OAAO;QAC3C,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;QAC7B,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;IAED,sFAAsF;IACtF,OAAO,CAAC,KAAK,GAAG,CAAC;QAChB,IAAI,KAAK,KAAK,CAAC;YAAE,OAAO;QACxB,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC;QACjC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;YACtD,GAAG,CAAC;gBACH,KAAK,GAAG,CAAC,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;YACpE,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC,eAAe,EAAE;QAC1E,CAAC;QACD,IAAI,KAAK,KAAK,IAAI,CAAC,eAAe;YAAE,OAAO;QAC3C,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;QAC7B,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;IAED,yFAAyF;IACzF,QAAQ,CAAC,KAAa;QACrB,IAAI,KAAK,KAAK,IAAI,CAAC,YAAY;YAAE,OAAO;QACxC,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,SAAS,EAAE,CAAC;QACjB,IAAI,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;IAED,yFAAyF;IACzF,IAAI,CAAC,KAAa;QACjB,IAAI,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACnD,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,KAAK,GAAG,IAAI,CAAC,oBAAoB,CAAC;QACtC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;YACtD,IAAI,SAAS,GAAG,KAAK,CAAC;YACtB,GAAG,CAAC;gBACH,SAAS,IAAI,IAAI,CAAC;YACnB,CAAC,QAAQ,SAAS,IAAI,CAAC,IAAI,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE;YACpG,IAAI,SAAS,GAAG,CAAC,IAAI,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM;gBAAE,MAAM;YAC3D,KAAK,GAAG,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,KAAK,KAAK,IAAI,CAAC,oBAAoB;YAAE,OAAO;QAChD,IAAI,CAAC,oBAAoB,GAAG,KAAK,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;IAED,0FAA0F;IAC1F,OAAO,CAAC,IAAY;QACnB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,GAAG,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3E,IAAI,IAAI,CAAC,QAAQ,IAAI,CAAC;YAAE,OAAO;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,KAAK,KAAK,IAAI,CAAC,oBAAoB;YAAE,OAAO;QAChD,IAAI,CAAC,oBAAoB,GAAG,KAAK,CAAC;QAClC,IAAI,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;IAED,yFAAyF;IACzF,QAAQ,CAAC,KAAa;QACrB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,2FAA2F;IAC3F,UAAU;QACT,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QAC3E,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YAClB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,IAAI,EAAE,CAAC;QACb,CAAC;QACD,OAAO,IAAI,CAAC;IACb,CAAC;IAED,WAAW;QACV,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,IAAI,EAAE,CAAC;IACb,CAAC;IAED,kFAAkF;IAC1E,qBAAqB,CAAC,IAAY;QACzC,MAAM,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/D,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAClC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;IAEO,eAAe,CAAC,IAAY;QACnC,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBAAE,OAAO,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,CAAC,CAAC;IACV,CAAC;IAED,oFAAoF;IAC5E,SAAS;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC;QAC5E,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC;QACtB,IAAI,CAAC,oBAAoB,GAAG,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAChF,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACrB,CAAC;IAEO,IAAI;QACX,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;CACD"}

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

@@ -1,90 +0,0 @@
-export interface TextModelOptions {
-    value?: string;
-    /** the most characters the field will hold; unlimited when omitted */
-    maxLength?: number;
-    /** a password-style field: `maskedValue` replaces every character with a dot */
-    mask?: boolean;
-    /** the character `maskedValue` repeats; a bullet when omitted */
-    maskCharacter?: string;
-    /**
-     * a multiline field: Enter inserts a real newline and the line helpers below
-     * navigate rows. Off by default, in which case newlines never survive an edit -
-     * a single-line name entry cannot grow a second row no matter what is pasted.
-     */
-    multiline?: boolean;
-}
-/**
- * The editing state behind a text field, with no renderer attached - the counterpart to
- * `core.Input`'s `onText`, which supplies the characters: the DOM gives a key, this decides
- * where it goes, and a game draws `value` (or `maskedValue`) with the caret it reports.
- *
- * The caret is an index into `value`; a selection is the caret plus an anchor, so every edit
- * replaces the selection when there is one and inserts at the caret when there is not, which is
- * the behaviour a plain `<input>` has and a title screen's name entry expects.
- *
- * @example
- * ```ts
- * import { TextModel } from '@datamoc/mw_games/two-d/ui';
- *
- * const name = new TextModel({ maxLength: 8, value: 'Hero' });
- * name.selectAll();
- * name.insert('Ash');
- * console.log(name.value); // 'Ash'
- * ```
- */
-export declare class TextModel {
-    private text;
-    private caretIndex;
-    private anchor;
-    private readonly maxLength?;
-    private readonly mask;
-    private readonly maskCharacter;
-    private readonly multiline;
-    private goalColumn;
-    constructor(options?: TextModelOptions);
-    get value(): string;
-    /**
-     * what to draw for a password field: every character replaced by the mask, except
-     * newlines, which stay newlines so a masked multiline value keeps its rows
-     */
-    get maskedValue(): string;
-    get length(): number;
-    get caret(): number;
-    get selectionStart(): number;
-    get selectionEnd(): number;
-    get hasSelection(): boolean;
-    get selectedText(): string;
-    /** replaces everything; the caret goes to the end and a new string is never longer than `maxLength` */
-    setValue(value: string): void;
-    setCaret(index: number, extend?: boolean): void;
-    /** inserts at the caret, replacing the selection, as a keystroke from `onText` does */
-    insert(text: string): void;
-    /** the backspace key: removes the selection, or the character before the caret */
-    backspace(): void;
-    /** the delete key: removes the selection, or the character after the caret */
-    deleteForward(): void;
-    /** arrow keys: moves the caret, extending the selection when the shift key is held */
-    moveCaret(delta: number, extend?: boolean): void;
-    moveToStart(extend?: boolean): void;
-    moveToEnd(extend?: boolean): void;
-    selectAll(): void;
-    clearSelection(): void;
-    /** replaces the selection (or inserts at the caret) and leaves the caret after the new text */
-    replaceSelection(text: string): void;
-    /** newlines as the field keeps them: rows in a multiline field, stripped away otherwise */
-    private shape;
-    /** rows in a multiline field; always 1 for a single-line one, even when empty */
-    get lineCount(): number;
-    /** the 0-based row the caret sits on */
-    get caretLine(): number;
-    /** [start, end) of a row, the end stopping before its newline; out-of-range rows clamp */
-    lineRange(line: number): readonly [number, number];
-    /**
-     * Up/down between rows, holding the column: the caret lands as far along the new
-     * row as it goes, the way a `<textarea>` moves. Rows here are newline-delimited,
-     * since only the renderer knows where a long row wraps on screen.
-     */
-    moveCaretLine(delta: number, extend?: boolean): void;
-    private limit;
-}
-//# sourceMappingURL=TextModel.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"TextModel.d.ts","sourceRoot":"","sources":["../../../src/two-d/ui/TextModel.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,iEAAiE;IACjE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,SAAS;IACrB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAU;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,UAAU,CAAuB;IAEzC,YAAY,OAAO,GAAE,gBAAqB,EAQzC;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED;;;OAGG;IACH,IAAI,WAAW,IAAI,MAAM,CAMxB;IAED,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,uGAAuG;IACvG,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAK5B;IAED,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,IAAI,CAI5C;IAED,uFAAuF;IACvF,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAGzB;IAED,kFAAkF;IAClF,SAAS,IAAI,IAAI,CAQhB;IAED,8EAA8E;IAC9E,aAAa,IAAI,IAAI,CAQpB;IAED,sFAAsF;IACtF,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,IAAI,CAE7C;IAED,WAAW,CAAC,MAAM,UAAQ,GAAG,IAAI,CAEhC;IAED,SAAS,CAAC,MAAM,UAAQ,GAAG,IAAI,CAE9B;IAED,SAAS,IAAI,IAAI,CAIhB;IAED,cAAc,IAAI,IAAI,CAErB;IAED,+FAA+F;IAC/F,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAYnC;IAED,2FAA2F;IAC3F,OAAO,CAAC,KAAK;IAIb,iFAAiF;IACjF,IAAI,SAAS,IAAI,MAAM,CAGtB;IAED,wCAAwC;IACxC,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,0FAA0F;IAC1F,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAMjD;IAED;;;;OAIG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,IAAI,CAMjD;IAED,OAAO,CAAC,KAAK;CAGb"}

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

@@ -1,175 +0,0 @@
-/**
- * The editing state behind a text field, with no renderer attached - the counterpart to
- * `core.Input`'s `onText`, which supplies the characters: the DOM gives a key, this decides
- * where it goes, and a game draws `value` (or `maskedValue`) with the caret it reports.
- *
- * The caret is an index into `value`; a selection is the caret plus an anchor, so every edit
- * replaces the selection when there is one and inserts at the caret when there is not, which is
- * the behaviour a plain `<input>` has and a title screen's name entry expects.
- *
- * @example
- * ```ts
- * import { TextModel } from '@datamoc/mw_games/two-d/ui';
- *
- * const name = new TextModel({ maxLength: 8, value: 'Hero' });
- * name.selectAll();
- * name.insert('Ash');
- * console.log(name.value); // 'Ash'
- * ```
- */
-export class TextModel {
-    constructor(options = {}) {
-        this.goalColumn = null;
-        this.multiline = options.multiline ?? false;
-        this.text = this.limit(this.shape(options.value ?? ''));
-        this.maxLength = options.maxLength;
-        this.mask = options.mask ?? false;
-        this.maskCharacter = options.maskCharacter ?? '\u2022';
-        this.caretIndex = this.text.length;
-        this.anchor = this.caretIndex;
-    }
-    get value() {
-        return this.text;
-    }
-    /**
-     * what to draw for a password field: every character replaced by the mask, except
-     * newlines, which stay newlines so a masked multiline value keeps its rows
-     */
-    get maskedValue() {
-        if (!this.mask)
-            return this.text;
-        return this.text
-            .split('')
-            .map((char) => (char === '\n' ? '\n' : this.maskCharacter))
-            .join('');
-    }
-    get length() {
-        return this.text.length;
-    }
-    get caret() {
-        return this.caretIndex;
-    }
-    get selectionStart() {
-        return Math.min(this.caretIndex, this.anchor);
-    }
-    get selectionEnd() {
-        return Math.max(this.caretIndex, this.anchor);
-    }
-    get hasSelection() {
-        return this.caretIndex !== this.anchor;
-    }
-    get selectedText() {
-        return this.text.slice(this.selectionStart, this.selectionEnd);
-    }
-    /** replaces everything; the caret goes to the end and a new string is never longer than `maxLength` */
-    setValue(value) {
-        this.text = this.limit(this.shape(value));
-        this.caretIndex = this.text.length;
-        this.anchor = this.caretIndex;
-        this.goalColumn = null;
-    }
-    setCaret(index, extend = false) {
-        this.caretIndex = Math.max(0, Math.min(this.text.length, index));
-        this.goalColumn = null;
-        if (!extend)
-            this.anchor = this.caretIndex;
-    }
-    /** inserts at the caret, replacing the selection, as a keystroke from `onText` does */
-    insert(text) {
-        if (text.length === 0)
-            return;
-        this.replaceSelection(text);
-    }
-    /** the backspace key: removes the selection, or the character before the caret */
-    backspace() {
-        if (this.hasSelection) {
-            this.replaceSelection('');
-            return;
-        }
-        if (this.caretIndex === 0)
-            return;
-        this.text = this.text.slice(0, this.caretIndex - 1) + this.text.slice(this.caretIndex);
-        this.setCaret(this.caretIndex - 1);
-    }
-    /** the delete key: removes the selection, or the character after the caret */
-    deleteForward() {
-        if (this.hasSelection) {
-            this.replaceSelection('');
-            return;
-        }
-        if (this.caretIndex >= this.text.length)
-            return;
-        this.text = this.text.slice(0, this.caretIndex) + this.text.slice(this.caretIndex + 1);
-        this.setCaret(this.caretIndex);
-    }
-    /** arrow keys: moves the caret, extending the selection when the shift key is held */
-    moveCaret(delta, extend = false) {
-        this.setCaret(this.caretIndex + delta, extend);
-    }
-    moveToStart(extend = false) {
-        this.setCaret(0, extend);
-    }
-    moveToEnd(extend = false) {
-        this.setCaret(this.text.length, extend);
-    }
-    selectAll() {
-        this.anchor = 0;
-        this.caretIndex = this.text.length;
-        this.goalColumn = null;
-    }
-    clearSelection() {
-        this.anchor = this.caretIndex;
-    }
-    /** replaces the selection (or inserts at the caret) and leaves the caret after the new text */
-    replaceSelection(text) {
-        const start = this.selectionStart;
-        const end = this.selectionEnd;
-        const base = this.text.slice(0, start) + this.text.slice(end);
-        const shaped = this.shape(text);
-        //a paste into a field with little room left stops at the cap rather than being rejected whole
-        const inserted = this.maxLength !== undefined && base.length + shaped.length > this.maxLength
-            ? shaped.slice(0, Math.max(0, this.maxLength - base.length))
-            : shaped;
-        this.text = this.text.slice(0, start) + inserted + this.text.slice(end);
-        this.setCaret(start + inserted.length);
-    }
-    /** newlines as the field keeps them: rows in a multiline field, stripped away otherwise */
-    shape(text) {
-        return text.replace(/\r\n|\r|\n/g, this.multiline ? '\n' : '');
-    }
-    /** rows in a multiline field; always 1 for a single-line one, even when empty */
-    get lineCount() {
-        if (!this.multiline)
-            return 1;
-        return this.text.split('\n').length;
-    }
-    /** the 0-based row the caret sits on */
-    get caretLine() {
-        return this.text.slice(0, this.caretIndex).split('\n').length - 1;
-    }
-    /** [start, end) of a row, the end stopping before its newline; out-of-range rows clamp */
-    lineRange(line) {
-        const clamped = Math.max(0, Math.min(this.lineCount - 1, line));
-        let start = 0;
-        for (let i = 0; i < clamped; i++)
-            start = this.text.indexOf('\n', start) + 1;
-        const end = this.text.indexOf('\n', start);
-        return [start, end === -1 ? this.text.length : end];
-    }
-    /**
-     * Up/down between rows, holding the column: the caret lands as far along the new
-     * row as it goes, the way a `<textarea>` moves. Rows here are newline-delimited,
-     * since only the renderer knows where a long row wraps on screen.
-     */
-    moveCaretLine(delta, extend = false) {
-        const [start] = this.lineRange(this.caretLine);
-        const column = this.goalColumn ?? this.caretIndex - start;
-        const [nextStart, nextEnd] = this.lineRange(this.caretLine + delta);
-        this.setCaret(nextStart + Math.min(column, nextEnd - nextStart), extend);
-        this.goalColumn = column;
-    }
-    limit(value) {
-        return this.maxLength !== undefined && value.length > this.maxLength ? value.slice(0, this.maxLength) : value;
-    }
-}
-//# sourceMappingURL=TextModel.js.map

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

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

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

@@ -1,122 +0,0 @@
-import { type Action } from '../../core/Input.ts';
-import { Window } from './Window.ts';
-import { type ScreenReader } from './a11y.ts';
-import { type KeyboardLayout } from './OnScreenKeyboard.ts';
-export interface TextPromptOptions {
-    width: number;
-    height: number;
-    /** the window title; also announced by `Window` itself */
-    title?: string;
-    /** the one-line question above the field, announced politely on open */
-    message?: string;
-    /** the field's starting text; the caret starts after it */
-    initialValue?: string;
-    /** the most characters the field will hold; unlimited when omitted */
-    maxLength?: number;
-    /**
-     * Rows of keys rendered beneath the field for pointer-only devices, feeding the same
-     * `onText`/`onAction` paths a physical key travels. Omit on a keyboard-first platform.
-     */
-    keyboard?: KeyboardLayout;
-    /**
-     * Decides whether the current value may be confirmed: return an error message to
-     * keep the prompt open, or null (or '') when the value is fine. Runs only on
-     * `confirm`, so typing never nags; the error clears on the next edit.
-     */
-    validate?: (value: string) => string | null;
-    /** called with the value, then the prompt closes */
-    onConfirm: (value: string) => void;
-    /** called on `cancel`, then the prompt closes; omit to just close */
-    onCancel?: () => void;
-    /** dim the world behind; true for a modal window, which this is */
-    dims?: boolean;
-    /**
-     * Whether a click under the prompt is swallowed rather than reaching the game
-     * behind it. On by default: a name not yet given is not something a stray click
-     * on the world should be able to act past.
-     */
-    blocker?: boolean;
-    /** where the stack puts the prompt */
-    anchor?: 'center' | 'bottom' | 'top';
-    /**
-     * Announce the message on open and a validation error on `confirm` through an
-     * `a11y.ScreenReader`. Default true; the calls are no-ops where there is no DOM.
-     */
-    announce?: boolean;
-    /** the reader announcements go to; the shared one by default, a fake in tests */
-    announcer?: Pick<ScreenReader, 'announce'>;
-}
-/**
- * A modal single-line text field: a name entry, a save-slot label, a seed.
- *
- * Typing arrives through `core.Input`'s `onText`, which is the signal a free text field
- * listens to, so this plays no part in key bindings for characters: whatever the
- * platform turns a key press into lands in the field. Editing and movement arrive as
- * actions instead, which a game binds the way it binds everything else: `left`/`right`
- * move the caret, `backspace`/`delete` edit, `confirm` accepts subject to `validate`,
- * `cancel` gives up. The prompt is modal and swallows each of those while open, so
- * the game underneath never walks away mid-name.
- *
- * `onText` wakes the most recently added listener first, so when two prompts overlap
- * the topmost one gets the keystrokes - the same order the window stack shows them in.
- *
- * An in-progress IME composition previews below the field and only becomes value on
- * commit, so CJK, dead keys and emoji pickers type through the same path the DOM gives
- * every other input rather than through a game-specific workaround.
- *
- * @example
- * ```ts
- * import { TextPrompt } from '@datamoc/mw_games/two-d/ui';
- *
- * const prompt = new TextPrompt({
- * 	width: 320,
- * 	height: 140,
- * 	title: 'New hero',
- * 	message: 'Name your hero (Enter keeps it)',
- * 	maxLength: 12,
- * 	validate: (value) => (value.trim() === '' ? 'Give them a name first.' : null),
- * 	onConfirm: (value) => console.log('named', value),
- * });
- * ```
- */
-export declare class TextPrompt extends Window {
-    private readonly model;
-    private readonly validate?;
-    private readonly onConfirm;
-    private readonly onCancel?;
-    private readonly announce;
-    private readonly announcer;
-    private preview;
-    private promptError;
-    private readonly keyboard;
-    private messageLabel;
-    private valueLabel;
-    private previewLabel;
-    private errorLabel;
-    private caretBar;
-    private readonly measurer;
-    private readonly lineHeight;
-    private readonly valueY;
-    private canMeasureCaret;
-    private blinkOn;
-    private blinkElapsed;
-    private readonly promptThemeListener;
-    private readonly textListener;
-    private readonly compositionListener;
-    constructor(options: TextPromptOptions);
-    /** the field's current text */
-    get value(): string;
-    /** the caret's index into `value` */
-    get caretIndex(): number;
-    /** the last validation error, or null when the value currently passes */
-    get error(): string | null;
-    handleAction(action: Action): boolean;
-    update(dt: number): void;
-    destroy(options?: Parameters<Window['destroy']>[0]): void;
-    /** runs an edit, dropping a stale validation error only when the text changed */
-    private edit;
-    private confirm;
-    private restylePrompt;
-    private render;
-}
-//# sourceMappingURL=TextPrompt.d.ts.map

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

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