@datamoc/mw_games 0.26.1 → 0.30.0

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

@@ -4,17 +4,22 @@ import { theme } from './theme.js';
 /** the default per-level text colours; `info` and `highlight` follow the active theme */
 const LEVEL_COLORS = { positive: 0x55dd77, negative: 0xff5555, warning: 0xffb347 };
 /**
- * How many of the oldest entries to drop so the rest fit in `maxLines`. The budget is in
- * wrapped lines, not entries, so one long message costs the room of the several short ones
- * it is worth. The newest entry always stays, even when it alone is over budget.
+ * The newest `count` entries of a retained log, oldest first. Pure so the readback
+ * contract is testable without a renderer: a `count` of 0 (or negative) reads
+ * nothing, a `count past what is retained reads everything retained.
  *
  * @example
  * ```ts
- * import { linesToDrop } from '@datamoc/mw_games/two-d/ui';
+ * import { takeLastEntries } from '@datamoc/mw_games/two-d/ui';
  *
- * console.log(linesToDrop([1, 2, 2], 3)); // 2 - the two oldest go, leaving one 2-line entry
+ * console.log(takeLastEntries(['a', 'b', 'c'], 2)); // ['b', 'c']
  * ```
  */
+export function takeLastEntries(entries, count) {
+    if (!(count > 0))
+        return [];
+    return entries.slice(Math.max(0, entries.length - Math.floor(count)));
+}
 export function linesToDrop(lineCounts, maxLines) {
     let total = 0;
     for (const lines of lineCounts)
@@ -54,6 +59,18 @@ export class MessageLog extends Container {
     get contentHeight() {
         return this.blocks.reduce((height, block) => height + block.label.height, 0);
     }
+    /**
+     * The newest `count` entries as plain `{ text, level }` records, oldest first -
+     * the readback for automated checks and secondary displays, without scraping
+     * rendered children. Entries the wrapped-line budget already dropped are gone, so
+     * what "last" means is bounded by `entryCount`: a `count` past that returns
+     * everything retained, and a `count` of 0 (or negative) returns `[]`. The
+     * records are copies; mutating them cannot corrupt the log. (There is no
+     * `snapshot()` on this widget, so there is nothing further to include.)
+     */
+    lastEntries(count) {
+        return takeLastEntries(this.blocks.map((block) => ({ text: block.text, level: block.level })), count);
+    }
     add(text, level = 'info') {
         const label = new Label({
             text,
@@ -63,7 +80,7 @@ export class MessageLog extends Container {
             resolution: this.options.resolution,
         });
         this.addChild(label);
-        this.blocks.push({ label, level });
+        this.blocks.push({ label, level, text });
         this.trim();
         this.layout();
     }

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

@@ -1 +1 @@
-{"version":3,"file":"MessageLog.js","sourceRoot":"","sources":["../../../src/two-d/ui/MessageLog.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MessageLog.js","sourceRoot":"","sources":["../../../src/two-d/ui/MessageLog.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAKnC,yFAAyF;AACzF,MAAM,YAAY,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAW,CAAC;AAoB5F;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAI,OAAqB,EAAE,KAAa;IACtE,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5B,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,UAA6B,EAAE,QAAgB;IAC1E,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,KAAK,MAAM,KAAK,IAAI,UAAU;QAAE,KAAK,IAAI,KAAK,CAAC;IAC/C,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,OAAO,KAAK,GAAG,QAAQ,IAAI,OAAO,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,IAAI,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3F,OAAO,OAAO,CAAC;AAChB,CAAC;AAeD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,UAAW,SAAQ,SAAS;IAKxC,YAAY,OAA0B;QACrC,KAAK,EAAE,CAAC;QALQ,WAAM,GAA0D,EAAE,CAAC;QAMnF,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,UAAU;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC3B,CAAC;IAED,uFAAuF;IACvF,IAAI,aAAa;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;;OAQG;IACH,WAAW,CAAC,KAAa;QACxB,OAAO,eAAe,CACrB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,EACtE,KAAK,CACL,CAAC;IACH,CAAC;IAED,GAAG,CAAC,IAAY,EAAE,KAAK,GAAiB,MAAM;QAC7C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;YACvB,IAAI;YACJ,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;YACvB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;YAC1B,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YACjC,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;SACnC,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,MAAM,EAAE,CAAC;IACf,CAAC;IAED,WAAW,CAAC,KAAa;QACxB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,MAAM,EAAE,CAAC;IACf,CAAC;IAED,YAAY,CAAC,KAAa;QACzB,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,KAAK,CAAC;QAC/B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM;YAAE,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,GAAG,KAAK,CAAC;QACzE,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,MAAM,EAAE,CAAC;IACf,CAAC;IAED,KAAK;QACJ,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAAE,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IAClE,CAAC;IAEO,OAAO,CAAC,KAAmB;QAClC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,GAAG,CAAC;QAClC,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,KAAK,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;QAChD,IAAI,KAAK,KAAK,WAAW;YAAE,OAAO,KAAK,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC;QAC9D,OAAO,YAAY,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAEO,OAAO,CAAC,KAAY;QAC3B,mFAAmF;QACnF,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;IAC3D,CAAC;IAEO,IAAI;QACX,MAAM,IAAI,GAAG,WAAW,CACvB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EACrD,IAAI,CAAC,QAAQ,CACb,CAAC;QACF,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC;YAAE,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;IACxE,CAAC;IAEO,MAAM;QACb,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACjC,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/B,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;QACzB,CAAC;IACF,CAAC;CACD"}

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

@@ -0,0 +1,91 @@
+import { Container } from 'pixi.js';
+import { type Action } from '../../core/Input.ts';
+/** one key: what it is labelled, what it types, or which action it fires */
+export interface KeyboardKey {
+    /** the key's own caption */
+    label: string;
+    /**
+     * What the key types through `core.Input`'s `onText`. Defaults to `label`, so an
+     * ordinary letter key is just `{ label: 'A' }`; a wider gap or an accented glyph
+     * can say `{ label: 'a`', text: 'à' }`.
+     */
+    text?: string;
+    /**
+     * The named action the key fires instead of typing - `backspace`/`delete`/`left`/
+     * `right`/`confirm`/`cancel`, the same vocabulary a physical key is bound to. A
+     * key with an action types nothing.
+     */
+    action?: Action;
+    /** row units wide; a space bar is wide, an ordinary key is 1. Default 1 */
+    span?: number;
+}
+/**
+ * Rows of keys as plain data - the shape a game authors, never code. Ragged rows are
+ * fine: each starts at the left edge and ends where it ends.
+ */
+export interface KeyboardLayout {
+    /** the rows, top to bottom */
+    rows: KeyboardKey[][];
+}
+/**
+ * One shipped default: the uppercase alphabet over a digit row, then the editing tail
+ * (`Bksp`, caret moves, space, `OK`, `Esc`). A game with its own needs - digits only, a
+ * seed code's letters and hyphens - authors its own layout; the default exists so a
+ * first game does not start from a blank page.
+ */
+export declare const UPPERCASE_KEYBOARD: KeyboardLayout;
+/**
+ * What pressing a key does: a typing key feeds `core.Input`'s `onText`, an action key
+ * fires its action through `onAction` - the same two paths a physical key travels, so
+ * a prompt or menu cannot tell an on-screen tap from a keyboard press. Pure, so the
+ * dispatch semantics are testable without a renderer.
+ */
+export declare function pressKey(key: KeyboardKey): void;
+/** where one laid-out key sits, and which key it is */
+export interface LaidOutKey {
+    key: KeyboardKey;
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * The rows-to-buttons arithmetic as a pure function: a row's span units share its width
+ * minus the gaps, wide keys take their units plus the gaps between them, and rows stack
+ * at a fixed height. The class below is the thin Button shell over this.
+ */
+export declare function layoutKeys(layout: KeyboardLayout, options: {
+    width: number;
+    keyHeight: number;
+    gap: number;
+}): LaidOutKey[];
+/**
+ * An on-screen keyboard: rows of keys as data, rendered through the theme's own
+ * `Button`, each tap pressing its key through `pressKey` - `dispatchText` for a typing
+ * key, `dispatchAction` for an action key - so a `TextPrompt` (or any listener of
+ * `onText`/`onAction`) cannot tell the tap from a physical key press. Pointer-only
+ * devices get a way to type; nothing game-specific lives here.
+ *
+ * @example
+ * ```ts
+ * import { OnScreenKeyboard, UPPERCASE_KEYBOARD } from '@datamoc/mw_games/two-d/ui';
+ * import type { Container2D } from '@datamoc/mw_games/two-d/render';
+ *
+ * declare const layer: Container2D;
+ *
+ * const keyboard = new OnScreenKeyboard(UPPERCASE_KEYBOARD, { width: 320 });
+ * keyboard.x = 20;
+ * keyboard.y = 240;
+ * layer.addChild(keyboard);
+ * // taps type through core.Input, exactly like a physical key
+ * ```
+ */
+export declare class OnScreenKeyboard extends Container {
+    private readonly laidOutHeight;
+    constructor(layout: KeyboardLayout, options: {
+        width: number;
+    });
+    /** the laid-out height, so a host window can size itself to the keyboard */
+    get contentHeight(): number;
+}
+//# sourceMappingURL=OnScreenKeyboard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OnScreenKeyboard.d.ts","sourceRoot":"","sources":["../../../src/two-d/ui/OnScreenKeyboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,OAAO,EAAgC,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAIhF,4EAA4E;AAC5E,MAAM,WAAW,WAAW;IAC3B,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,8BAA8B;IAC9B,IAAI,EAAE,WAAW,EAAE,EAAE,CAAC;CACtB;AAID;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,cAehC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAG/C;AAED,uDAAuD;AACvD,MAAM,WAAW,UAAU;IAC1B,GAAG,EAAE,WAAW,CAAC;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CACzB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACxD,UAAU,EAAE,CAkBd;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,gBAAiB,SAAQ,SAAS;IAC9C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAEvC,YAAY,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,EAkB7D;IAED,4EAA4E;IAC5E,IAAI,aAAa,IAAI,MAAM,CAE1B;CACD"}

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

@@ -0,0 +1,109 @@
+import { Container } from 'pixi.js';
+import { dispatchAction, dispatchText } from '../../core/Input.js';
+import { Button } from './Button.js';
+import { theme } from './theme.js';
+const letters = (word) => word.split('').map((label) => ({ label }));
+/**
+ * One shipped default: the uppercase alphabet over a digit row, then the editing tail
+ * (`Bksp`, caret moves, space, `OK`, `Esc`). A game with its own needs - digits only, a
+ * seed code's letters and hyphens - authors its own layout; the default exists so a
+ * first game does not start from a blank page.
+ */
+export const UPPERCASE_KEYBOARD = {
+    rows: [
+        letters('QWERTYUIOP'),
+        letters('ASDFGHJKL'),
+        letters('ZXCVBNM'),
+        letters('1234567890'),
+        [
+            { label: 'Bksp', action: 'backspace' },
+            { label: 'Left', action: 'left' },
+            { label: 'Right', action: 'right' },
+            { label: 'Space', text: ' ', span: 3 },
+            { label: 'OK', action: 'confirm' },
+            { label: 'Esc', action: 'cancel' },
+        ],
+    ],
+};
+/**
+ * What pressing a key does: a typing key feeds `core.Input`'s `onText`, an action key
+ * fires its action through `onAction` - the same two paths a physical key travels, so
+ * a prompt or menu cannot tell an on-screen tap from a keyboard press. Pure, so the
+ * dispatch semantics are testable without a renderer.
+ */
+export function pressKey(key) {
+    if (key.action !== undefined)
+        dispatchAction(key.action);
+    else
+        dispatchText(key.text ?? key.label);
+}
+/**
+ * The rows-to-buttons arithmetic as a pure function: a row's span units share its width
+ * minus the gaps, wide keys take their units plus the gaps between them, and rows stack
+ * at a fixed height. The class below is the thin Button shell over this.
+ */
+export function layoutKeys(layout, options) {
+    const laid = [];
+    let y = 0;
+    for (const row of layout.rows) {
+        const units = row.reduce((sum, key) => sum + (key.span ?? 1), 0);
+        //a row is span-units wide with a gap between every unit slot, so a span-S key
+        //covers S slots plus its internal gaps and the row consumes its width exactly
+        const unitWidth = (options.width - options.gap * (units - 1)) / units;
+        let x = 0;
+        for (const key of row) {
+            const span = key.span ?? 1;
+            const width = unitWidth * span + options.gap * (span - 1);
+            laid.push({ key, x, y, width, height: options.keyHeight });
+            x += width + options.gap;
+        }
+        y += options.keyHeight + options.gap;
+    }
+    return laid;
+}
+/**
+ * An on-screen keyboard: rows of keys as data, rendered through the theme's own
+ * `Button`, each tap pressing its key through `pressKey` - `dispatchText` for a typing
+ * key, `dispatchAction` for an action key - so a `TextPrompt` (or any listener of
+ * `onText`/`onAction`) cannot tell the tap from a physical key press. Pointer-only
+ * devices get a way to type; nothing game-specific lives here.
+ *
+ * @example
+ * ```ts
+ * import { OnScreenKeyboard, UPPERCASE_KEYBOARD } from '@datamoc/mw_games/two-d/ui';
+ * import type { Container2D } from '@datamoc/mw_games/two-d/render';
+ *
+ * declare const layer: Container2D;
+ *
+ * const keyboard = new OnScreenKeyboard(UPPERCASE_KEYBOARD, { width: 320 });
+ * keyboard.x = 20;
+ * keyboard.y = 240;
+ * layer.addChild(keyboard);
+ * // taps type through core.Input, exactly like a physical key
+ * ```
+ */
+export class OnScreenKeyboard extends Container {
+    constructor(layout, options) {
+        super();
+        const gap = theme().spacing;
+        const keyHeight = Math.max(theme().font.size * 2, 18);
+        let maxY = 0;
+        for (const laid of layoutKeys(layout, { width: options.width, keyHeight, gap })) {
+            const button = new Button({
+                width: laid.width,
+                height: laid.height,
+                text: laid.key.label,
+                onClick: () => pressKey(laid.key),
+            });
+            button.position.set(laid.x, laid.y);
+            this.addChild(button);
+            maxY = Math.max(maxY, laid.y + laid.height);
+        }
+        this.laidOutHeight = maxY;
+    }
+    /** the laid-out height, so a host window can size itself to the keyboard */
+    get contentHeight() {
+        return this.laidOutHeight;
+    }
+}
+//# sourceMappingURL=OnScreenKeyboard.js.map

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

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

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

@@ -0,0 +1,122 @@
+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

@@ -0,0 +1 @@
+{"version":3,"file":"TextPrompt.d.ts","sourceRoot":"","sources":["../../../src/two-d/ui/TextPrompt.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,KAAK,MAAM,EAAyB,MAAM,qBAAqB,CAAC;AAEhG,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAK9E,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IAEf,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,cAAc,CAAC;IAE1B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAE5C,oDAAoD;IACpD,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAEnC,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IAEtB,mEAAmE;IACnE,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB,sCAAsC;IACtC,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAC;IAErC;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB,iFAAiF;IACjF,SAAS,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;CAC3C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,qBAAa,UAAW,SAAQ,MAAM;IACrC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAmC;IAC7D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IACpD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAa;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiC;IAE3D,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,WAAW,CAAuB;IAE1C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAC1D,OAAO,CAAC,YAAY,CAAsB;IAC1C,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,QAAQ,CAAkB;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC,OAAO,CAAC,eAAe,CAAmC;IAC1D,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,YAAY,CAAK;IAEzB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA8B;IAElE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAI3B;IAEF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAYlC;IAEF,YAAY,OAAO,EAAE,iBAAiB,EAyDrC;IAED,+BAA+B;IAC/B,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,qCAAqC;IACrC,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,yEAAyE;IACzE,IAAI,KAAK,IAAI,MAAM,GAAG,IAAI,CAEzB;IAEQ,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CA6B7C;IAEQ,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAMhC;IAEQ,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAMjE;IAED,iFAAiF;IACjF,OAAO,CAAC,IAAI;IAOZ,OAAO,CAAC,OAAO;IAYf,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,MAAM;CA4Bd"}

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

@@ -0,0 +1,236 @@
+import { Graphics } from 'pixi.js';
+import { onComposition, onText } from '../../core/Input.js';
+import { TextModel } from './TextModel.js';
+import { Window } from './Window.js';
+import { Label } from './Label.js';
+import { theme, themeChanged } from './theme.js';
+import { screenReader } from './a11y.js';
+import { OnScreenKeyboard } from './OnScreenKeyboard.js';
+/** seconds per caret blink half-cycle */
+const BLINK_PERIOD = 0.5;
+/**
+ * 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 class TextPrompt extends Window {
+    constructor(options) {
+        super({
+            width: options.width,
+            height: options.height,
+            title: options.title,
+            modal: true,
+            closable: false,
+            dims: options.dims,
+            blocker: options.blocker ?? true,
+            anchor: options.anchor ?? 'center',
+        });
+        this.preview = '';
+        this.promptError = null;
+        this.keyboard = null;
+        this.messageLabel = null;
+        this.caretBar = new Graphics();
+        this.measurer = new Label();
+        this.canMeasureCaret = typeof document !== 'undefined';
+        this.blinkOn = true;
+        this.blinkElapsed = 0;
+        this.promptThemeListener = () => this.restylePrompt();
+        this.textListener = (text) => {
+            if (this.closed)
+                return false;
+            this.edit(() => this.model.insert(text));
+            return true;
+        };
+        this.compositionListener = (input) => {
+            if (this.closed)
+                return false;
+            if (input.phase === 'end') {
+                this.edit(() => {
+                    this.preview = '';
+                    this.model.insert(input.text);
+                });
+            }
+            else {
+                this.preview = input.phase === 'start' ? '' : input.text;
+                this.render();
+            }
+            return true;
+        };
+        this.model = new TextModel({ value: options.initialValue ?? '', maxLength: options.maxLength });
+        this.validate = options.validate;
+        this.onConfirm = options.onConfirm;
+        this.onCancel = options.onCancel;
+        this.announce = options.announce ?? true;
+        this.announcer = options.announcer ?? screenReader;
+        const t = theme();
+        this.lineHeight = t.font.size * t.font.lineHeight;
+        const gap = t.spacing;
+        if (options.message !== undefined) {
+            this.messageLabel = new Label({ text: options.message });
+            this.content.addChild(this.messageLabel);
+        }
+        this.valueY = this.messageLabel ? this.lineHeight + gap : 0;
+        this.valueLabel = new Label();
+        this.valueLabel.y = this.valueY;
+        this.content.addChild(this.valueLabel);
+        this.previewLabel = new Label({ color: t.color.textDim });
+        this.previewLabel.y = this.valueY + this.lineHeight + gap;
+        this.content.addChild(this.previewLabel);
+        this.errorLabel = new Label({ color: t.color.textHighlight });
+        this.errorLabel.y = this.previewLabel.y + this.lineHeight + gap;
+        this.content.addChild(this.errorLabel);
+        this.content.addChild(this.caretBar);
+        //the touch half: rows of keys under the field, sized into the window
+        if (options.keyboard) {
+            this.keyboard = new OnScreenKeyboard(options.keyboard, { width: this.contentWidth });
+            this.keyboard.y = this.errorLabel.y + this.lineHeight + gap;
+            this.content.addChild(this.keyboard);
+            this.resize(options.width, options.height + this.keyboard.contentHeight + gap);
+        }
+        onText.add(this.textListener);
+        onComposition.add(this.compositionListener);
+        themeChanged.add(this.promptThemeListener);
+        this.render();
+        if (this.announce && options.message !== undefined)
+            this.announcer.announce(options.message);
+    }
+    /** the field's current text */
+    get value() {
+        return this.model.value;
+    }
+    /** the caret's index into `value` */
+    get caretIndex() {
+        return this.model.caret;
+    }
+    /** the last validation error, or null when the value currently passes */
+    get error() {
+        return this.promptError;
+    }
+    handleAction(action) {
+        if (this.delegate)
+            return super.handleAction(action);
+        if (this.closed)
+            return false;
+        switch (action) {
+            case 'left':
+                this.model.moveCaret(-1);
+                this.render();
+                return true;
+            case 'right':
+                this.model.moveCaret(1);
+                this.render();
+                return true;
+            case 'backspace':
+                this.edit(() => this.model.backspace());
+                return true;
+            case 'delete':
+                this.edit(() => this.model.deleteForward());
+                return true;
+            case 'confirm':
+                this.confirm();
+                return true;
+            case 'cancel':
+                this.onCancel?.();
+                this.close();
+                return true;
+            default:
+                return false;
+        }
+    }
+    update(dt) {
+        this.blinkElapsed += dt;
+        if (this.blinkElapsed < BLINK_PERIOD)
+            return;
+        this.blinkElapsed = 0;
+        this.blinkOn = !this.blinkOn;
+        this.caretBar.visible = this.blinkOn && this.canMeasureCaret;
+    }
+    destroy(options) {
+        onText.remove(this.textListener);
+        onComposition.remove(this.compositionListener);
+        themeChanged.remove(this.promptThemeListener);
+        this.measurer.destroy();
+        super.destroy(options);
+    }
+    /** runs an edit, dropping a stale validation error only when the text changed */
+    edit(run) {
+        const before = this.model.value;
+        run();
+        if (this.model.value !== before)
+            this.promptError = null;
+        this.render();
+    }
+    confirm() {
+        const problem = this.validate?.(this.model.value) ?? null;
+        if (problem) {
+            this.promptError = problem;
+            this.render();
+            if (this.announce)
+                this.announcer.announce(problem, { assertive: true });
+            return;
+        }
+        this.onConfirm(this.model.value);
+        this.close();
+    }
+    restylePrompt() {
+        const t = theme();
+        this.previewLabel.setColor(t.color.textDim);
+        this.errorLabel.setColor(t.color.textHighlight);
+        this.render();
+    }
+    render() {
+        this.valueLabel.setText(this.model.value);
+        //the caret sits after the text before it, measured through a label that is never
+        //added to the scene: reading any width needs a canvas, which `node --test` has
+        //not got, so where there is no document the position is unknowable and the caret
+        //stays hidden rather than guessing
+        this.measurer.setText(this.model.value.slice(0, this.model.caret));
+        let caretX = 0;
+        if (this.canMeasureCaret) {
+            try {
+                caretX = this.measurer.width;
+            }
+            catch {
+                this.canMeasureCaret = false;
+            }
+        }
+        this.caretBar
+            .clear()
+            .rect(this.valueLabel.x + caretX, this.valueY, 2, this.lineHeight)
+            .fill({ color: theme().color.text });
+        this.caretBar.visible = this.blinkOn && this.canMeasureCaret;
+        this.previewLabel.setText(this.preview);
+        this.previewLabel.visible = this.preview.length > 0;
+        this.errorLabel.setText(this.promptError ?? '');
+        this.errorLabel.visible = this.promptError !== null;
+    }
+}
+//# sourceMappingURL=TextPrompt.js.map