dexterm-cli 0.0.0-stage → 0.1.2

package/dist/packages/tui/src/keymap.js

@@ -0,0 +1,357 @@
+// @dexterm/tui — key decoding and keymap (SPEC §7.7: vim keys plus arrows, single-key verbs).
+// parseKeys() turns a raw stdin chunk into named keys; Keymap maps named keys to actions,
+// with per-screen overrides layered on a global table.
+const CSI_FINAL = {
+    A: 'up', B: 'down', C: 'right', D: 'left', H: 'home', F: 'end',
+    '1~': 'home', '2~': 'delete', '3~': 'delete', '4~': 'end', '5~': 'pageup', '6~': 'pagedown', '7~': 'home', '8~': 'end',
+    '11~': 'f1', '12~': 'f2', '13~': 'f3', '14~': 'f4', '15~': 'f5', '17~': 'f6', '18~': 'f7', '19~': 'f8', '20~': 'f9', '21~': 'f10', '23~': 'f11', '24~': 'f12',
+};
+const SS3_FINAL = { A: 'up', B: 'down', C: 'right', D: 'left', H: 'home', F: 'end', P: 'f1', Q: 'f2', R: 'f3', S: 'f4' };
+/** Decode one raw stdin chunk (utf8 string) into zero or more keys. */
+export function parseKeys(data) {
+    const keys = [];
+    let i = 0;
+    while (i < data.length) {
+        const c = data[i];
+        if (c === '\x1b') {
+            const next = data[i + 1];
+            if (next === '[') {
+                // CSI: ESC [ params final
+                let j = i + 2;
+                let params = '';
+                while (j < data.length && /[0-9;]/.test(data[j]))
+                    params += data[j++];
+                const fin = data[j];
+                if (fin === undefined) {
+                    keys.push({ name: 'esc', raw: c });
+                    i = data.length;
+                    break;
+                }
+                // task-1388: bracketed-paste markers (ESC [ 200~ / 201~). dexterm never enables the mode, but a
+                // terminal/multiplexer that does would otherwise wrap a paste in them and the unknown-CSI branch
+                // below would surface each as `esc` — cancelling the go-to prompt before the pasted mint arrives.
+                // Swallow the markers so the printable paste flows through as plain chars.
+                if (fin === '~' && (params === '200' || params === '201')) {
+                    i = j + 1;
+                    continue;
+                }
+                const raw = data.slice(i, j + 1);
+                const parts = params.split(';');
+                const mod = parts.length > 1 ? Number(parts[1]) - 1 : 0;
+                const key = fin === '~' ? CSI_FINAL[`${parts[0]}~`] : CSI_FINAL[fin];
+                if (key) {
+                    keys.push({ name: key, raw, shift: !!(mod & 1), alt: !!(mod & 2), ctrl: !!(mod & 4) });
+                }
+                else {
+                    keys.push({ name: 'esc', raw }); // unknown CSI, surface as esc so the UI still reacts
+                }
+                i = j + 1;
+                continue;
+            }
+            if (next === 'O' && data[i + 2] && SS3_FINAL[data[i + 2]]) {
+                keys.push({ name: SS3_FINAL[data[i + 2]], raw: data.slice(i, i + 3) });
+                i += 3;
+                continue;
+            }
+            if (next !== undefined && next !== '\x1b') {
+                // alt+key
+                const inner = parseKeys(next);
+                for (const k of inner)
+                    keys.push({ ...k, alt: true, raw: c + k.raw });
+                i += 2;
+                continue;
+            }
+            keys.push({ name: 'esc', raw: c });
+            i += 1;
+            continue;
+        }
+        if (c === '\r' || c === '\n') {
+            keys.push({ name: 'enter', raw: c });
+            i++;
+            continue;
+        }
+        if (c === '\t') {
+            keys.push({ name: 'tab', raw: c });
+            i++;
+            continue;
+        }
+        if (c === '\x7f' || c === '\b') {
+            keys.push({ name: 'backspace', raw: c });
+            i++;
+            continue;
+        }
+        if (c === ' ') {
+            keys.push({ name: 'space', ch: ' ', raw: c });
+            i++;
+            continue;
+        }
+        const code = c.charCodeAt(0);
+        if (code < 32) {
+            keys.push({ name: 'char', ch: String.fromCharCode(code + 96), ctrl: true, raw: c });
+            i++;
+            continue;
+        }
+        // printable (may be a surrogate pair)
+        const cp = data.codePointAt(i);
+        const s = String.fromCodePoint(cp);
+        keys.push({ name: 'char', ch: s, raw: s });
+        i += s.length;
+    }
+    return keys;
+}
+/**
+ * Canonical key id used in bindings: 'j', 'enter', 'up', 'ctrl+c', 'ctrl+l', 'alt+x', 'shift+tab'.
+ * Printable characters are case-sensitive ('G' and 'g' differ).
+ */
+export function keyId(k) {
+    const base = k.name === 'char' ? (k.ch ?? '') : k.name;
+    let id = '';
+    if (k.ctrl)
+        id += 'ctrl+';
+    if (k.alt)
+        id += 'alt+';
+    if (k.shift && k.name !== 'char')
+        id += 'shift+';
+    return id + base;
+}
+export class Keymap {
+    global = new Map();
+    perScreen = new Map();
+    /** First keys of two-key chords ("ctrl+w s" → "ctrl+w"), task-1358. */
+    prefixes = new Set();
+    bindings = [];
+    constructor(bindings = []) {
+        for (const b of bindings)
+            this.bind(b);
+    }
+    bind(b) {
+        this.bindings.push(b);
+        const target = b.screen ? this.getScreen(b.screen) : this.global;
+        for (const k of b.keys) {
+            target.set(k, b);
+            const sp = k.indexOf(' ');
+            if (sp > 0)
+                this.prefixes.add(k.slice(0, sp));
+        }
+        return this;
+    }
+    /** Whether `id` starts a two-key chord (the loop then waits for the second key). */
+    isPrefix(id) { return this.prefixes.has(id); }
+    /** Resolve an already-formed key id (or chord id like "ctrl+w s"): screen bindings first, then global. */
+    resolveId(id, screen) {
+        if (screen) {
+            const hit = this.perScreen.get(screen)?.get(id);
+            if (hit)
+                return hit.action;
+        }
+        return this.global.get(id)?.action;
+    }
+    getScreen(screen) {
+        let m = this.perScreen.get(screen);
+        if (!m) {
+            m = new Map();
+            this.perScreen.set(screen, m);
+        }
+        return m;
+    }
+    /** Resolve a decoded key to an action: screen bindings first, then global. */
+    resolve(k, screen) {
+        const id = keyId(k);
+        if (screen) {
+            const hit = this.perScreen.get(screen)?.get(id);
+            if (hit)
+                return hit.action;
+        }
+        return this.global.get(id)?.action;
+    }
+    /** Resolve a raw stdin chunk; returns one action per decoded key that matched. */
+    resolveRaw(data, screen) {
+        const out = [];
+        for (const k of parseKeys(data)) {
+            const a = this.resolve(k, screen);
+            if (a !== undefined)
+                out.push(a);
+        }
+        return out;
+    }
+    /** Bindings visible on a screen (global + that screen), for footers and the `?` overlay. */
+    forScreen(screen) {
+        return this.bindings.filter((b) => !b.screen || b.screen === screen);
+    }
+}
+/** The prototype's key table (README of dexterm/prototype) plus the SPEC §4.1 screener keys. */
+export const DEFAULT_KEYMAP = new Keymap([
+    { keys: ['q', 'ctrl+c'], action: 'quit', label: 'quit' },
+    { keys: ['1'], action: 'screen.screener', label: 'screener' },
+    { keys: ['2'], action: 'screen.newpairs', label: 'new pairs' },
+    { keys: ['3'], action: 'screen.watchlist', label: 'watchlist' },
+    { keys: ['4'], action: 'screen.analyst', label: 'analyst' },
+    { keys: ['tab'], action: 'screen.next', label: 'screens' },
+    { keys: ['j', 'down'], action: 'move.down', label: 'move' },
+    { keys: ['k', 'up'], action: 'move.up', label: 'move' },
+    { keys: ['g', 'home'], action: 'move.top', label: 'top' },
+    { keys: ['G', 'end'], action: 'move.bottom', label: 'bottom' },
+    // task-1388 GO-TO prompt: `g` on the list and token screens opens the "open any coin" input. Per-screen so it
+    // overrides the global `g` (move to top) only here; `home` still moves to top on these screens. Collision-free
+    // with every other verb on these screens (the token screen's `g` was only "scroll answer to top", kept on home).
+    { keys: ['g'], action: 'goto.open', label: 'go to coin', screen: 'screener' },
+    { keys: ['g'], action: 'goto.open', label: 'go to coin', screen: 'newpairs' },
+    { keys: ['g'], action: 'goto.open', label: 'go to coin', screen: 'watchlist' },
+    { keys: ['g'], action: 'goto.open', label: 'go to coin', screen: 'token' },
+    { keys: ['pagedown', 'ctrl+f'], action: 'move.pagedown', label: 'page' },
+    { keys: ['pageup', 'ctrl+b'], action: 'move.pageup', label: 'page' },
+    { keys: ['enter'], action: 'open', label: 'open' },
+    { keys: ['esc', 'backspace'], action: 'back', label: 'back' },
+    { keys: ['a'], action: 'analyst.toggle', label: 'ask claude' },
+    // task-1282 JARVIS voice: push-to-talk toggle (hold not possible in a terminal). Lowercase v is free
+    // on every screen; the loop auto-enables voice mode on first use and shows a live mic indicator.
+    { keys: ['v'], action: 'voice.talk', label: 'voice' },
+    // task-1311: `i` focuses the chat input on the token / analyst screens (QA B1–B3); the loop only
+    // captures keystrokes into the input while it is focused, so the number keys and `q` never type.
+    { keys: ['i'], action: 'input.focus', label: 'ask', screen: 'token' },
+    { keys: ['i'], action: 'input.focus', label: 'ask', screen: 'analyst' },
+    { keys: ['?'], action: 'help.toggle', label: 'help' },
+    { keys: ['t'], action: 'theme.next', label: 'theme' },
+    { keys: ['p'], action: 'pause.toggle', label: 'pause' },
+    // task-1366: `$` (unbound on every screen) toggles price ⇄ market cap on every screen + both charts; persisted.
+    { keys: ['$'], action: 'display.priceMode', label: 'price ⇄ mcap' },
+    // task-1401: `E` exports the current view (PNG + text report, local only). Free on every screen.
+    { keys: ['E'], action: 'export.view', label: 'export PNG + report' },
+    { keys: ['/'], action: 'filter.edit', label: 'filter', screen: 'screener' },
+    { keys: ['\\'], action: 'filter.clear', label: 'clear filter', screen: 'screener' },
+    { keys: ['s'], action: 'sort.menu', label: 'sort', screen: 'screener' },
+    { keys: [']', 'right', 'l'], action: 'preset.next', label: 'preset', screen: 'screener' },
+    { keys: ['[', 'left', 'h'], action: 'preset.prev', label: 'preset', screen: 'screener' },
+    { keys: ['r'], action: 'refresh', label: 'refresh', screen: 'screener' },
+    // task-1298 live screens: watchlist keys and the token screen's timeframe tabs (SPEC §4.3 footer `1-6`)
+    { keys: ['w'], action: 'watch.add', label: 'watch' },
+    { keys: ['d'], action: 'watch.remove', label: 'remove', screen: 'watchlist' },
+    { keys: ['b'], action: 'alert.propose', label: 'alert' },
+    { keys: ['y'], action: 'alert.confirm', label: 'confirm alert' },
+    { keys: ['x'], action: 'alert.dismiss', label: 'dismiss alert' },
+    { keys: ['1'], action: 'tf.1', label: '1m', screen: 'token' },
+    { keys: ['2'], action: 'tf.2', label: '5m', screen: 'token' },
+    { keys: ['3'], action: 'tf.3', label: '15m', screen: 'token' },
+    { keys: ['4'], action: 'tf.4', label: '1h', screen: 'token' },
+    { keys: ['5'], action: 'tf.5', label: '4h', screen: 'token' },
+    { keys: ['6'], action: 'tf.6', label: '1d', screen: 'token' },
+    // task-1311 (QA B5): copy the full contract address from the token screen. Overrides the global
+    // `y` (confirm alert) on this screen only.
+    { keys: ['y'], action: 'copy.ca', label: 'copy CA', screen: 'token' },
+    { keys: ['r'], action: 'refresh', label: 'refresh', screen: 'token' },
+    { keys: ['r'], action: 'refresh', label: 'refresh', screen: 'newpairs' },
+    { keys: ['r'], action: 'refresh', label: 'refresh', screen: 'watchlist' },
+    // task-1310 PAPER trading. Capital B/S on the token screen open the ticket (collision-free with the
+    // global `b` alert and screener `s` sort); `P` opens the positions screen from anywhere.
+    { keys: ['B'], action: 'trade.buy', label: 'paper buy', screen: 'token' },
+    { keys: ['S'], action: 'trade.sell', label: 'paper sell', screen: 'token' },
+    { keys: ['P'], action: 'screen.positions', label: 'positions' },
+    { keys: ['r'], action: 'refresh', label: 'refresh', screen: 'positions' },
+    // task-1315 LARP detector: open the coin's advertised links from the token screen. Capital letters
+    // stay collision-free with the lowercase verbs (t theme, w watch, x dismiss) and the B/S/P pattern.
+    { keys: ['W'], action: 'open.web', label: 'open site', screen: 'token' },
+    { keys: ['V'], action: 'analyst.larp', label: 'vet product (Claude)', screen: 'token' },
+    { keys: ['X'], action: 'open.x', label: 'open X', screen: 'token' },
+    { keys: ['T'], action: 'open.tg', label: 'open TG', screen: 'token' },
+    { keys: ['L'], action: 'open.links', label: 'links', screen: 'token' },
+    // task-1290 popup host: `C` on the token screen opens/toggles the frameless live-chart HUD window for
+    // the open coin. (`P` is already the global positions key, so chart uses `C`.) Collision-free with the
+    // token screen's other capitals (B/S trade, W/X/T/L links, V vet).
+    { keys: ['C'], action: 'popup.chart', label: 'chart popup', screen: 'token' },
+    // task-1359: `I` on the token screen opens/toggles the TOKEN-DETAIL HUD (identity, market, risk, snipers/bundled
+    // from the wallet-intel scan); `M` on the trending screen opens/toggles the FEEDS HUD (the keyless social feed +
+    // official news, newest first; ⏎ in the window opens that coin here). Both are read-only windows. `I` is unused
+    // on the token screen (lowercase `i` stays "ask"); `M` on trending matches the M = popup pattern of the
+    // narrative / bubbles / plans screens.
+    { keys: ['I'], action: 'popup.token', label: 'token popup', screen: 'token' },
+    { keys: ['M'], action: 'popup.feeds', label: 'feeds popup', screen: 'trending' },
+    // task-1323: `F` flips the token screen's lower-right panel between BUY/SELL FLOW (default) and the raw
+    // trade tape. `T` is already "open Telegram" on this screen, so the tape uses F (flow ⇄ tape).
+    { keys: ['F'], action: 'tape.toggle', label: 'flow ⇄ tape', screen: 'token' },
+    // task-1324 AI SCAN MODE: `Z` toggles the scan anywhere (unused elsewhere, collision-free with every
+    // lowercase verb and the token screen's capitals B/S/P/W/V/X/T/L/C/F); `R` resumes scanning after a
+    // lock (lowercase `r` stays refresh). Both are inert while the PAPER ticket or a text input has the keys.
+    { keys: ['Z'], action: 'scan.toggle', label: 'AI scan' },
+    { keys: ['R'], action: 'scan.resume', label: 'resume scan' },
+    // task-1330 keyless social layer. `T` opens TRENDING IN THE SPACE from every screen except the token screen
+    // (where `T` stays "open Telegram", task-1315; esc then T). `K` opens the KOL lists anywhere (unused before).
+    // On the token screen lowercase `s` (unbound there) toggles the SOCIAL panel in place of ON-CHAIN/HOLDERS.
+    // On the trending screen: f cycles the source filter, x shows/hides spam + squat rows, n cycles the narrative
+    // filter, s shows the sources/health panel, a asks the analyst for the board summary (one chat turn), r refreshes.
+    { keys: ['T'], action: 'screen.trending', label: 'trending' },
+    { keys: ['K'], action: 'social.kol', label: 'KOL lists' },
+    // task-1356 narrative board: global N opens it; on the board, w flips the 1h/24h window and M opens the HUD popup.
+    { keys: ['N'], action: 'screen.narrative', label: 'narrative board' },
+    { keys: ['w'], action: 'narrative.window', label: '1h/24h', screen: 'narrative' },
+    { keys: ['M'], action: 'narrative.popup', label: 'popup', screen: 'narrative' },
+    { keys: ['s'], action: 'social.toggle', label: 'social', screen: 'token' },
+    { keys: ['f'], action: 'social.filter', label: 'filter', screen: 'trending' },
+    { keys: ['x'], action: 'social.spam', label: 'hidden spam', screen: 'trending' },
+    { keys: ['n'], action: 'social.narrative', label: 'narrative', screen: 'trending' },
+    { keys: ['s'], action: 'social.sources', label: 'sources', screen: 'trending' },
+    { keys: ['a'], action: 'social.summary', label: 'summary (claude)', screen: 'trending' },
+    { keys: ['r'], action: 'refresh', label: 'refresh', screen: 'trending' },
+    { keys: ['f'], action: 'social.filter', label: 'filter', screen: 'token' },
+    // KOL screen: space toggles the selected list for the trending feed, m mutes/unmutes the selected handle,
+    // d removes the selected handle from a manual list, i types a new handle into the selected manual list.
+    { keys: ['space'], action: 'kol.toggle', label: 'enable/disable list', screen: 'kol' },
+    { keys: ['m'], action: 'kol.mute', label: 'mute/unmute', screen: 'kol' },
+    { keys: ['d'], action: 'kol.remove', label: 'remove handle', screen: 'kol' },
+    { keys: ['i'], action: 'kol.add', label: 'add handle', screen: 'kol' },
+    // task-1357 Login with X: X imports the user's OWN X lists (handles only, needs `dexterm x login`); o focuses the
+    // trending board + token panel on the selected handle (press again or f to clear).
+    { keys: ['X'], action: 'kol.importx', label: 'import X lists', screen: 'kol' },
+    { keys: ['o'], action: 'kol.focus', label: 'only this handle', screen: 'kol' },
+    // task-1340 wallet intel. `M` on the token screen opens the BUBBLE MAP (holder graph: clusters by funding
+    // source / same-slot buys / transfers, colour = rule) for the open coin; collision-free with the token screen's
+    // other capitals (B/S/P/W/V/X/T/L/C/F/Z/R/K). On the bubble screen `M` opens/closes the popup HUD window, `m`
+    // flips bubbles ⇄ treemap, `z` zooms the selected cluster, `D` forces a deep scan, `r` rescans, j/k select.
+    { keys: ['M'], action: 'intel.bubbles', label: 'bubble map', screen: 'token' },
+    { keys: ['M'], action: 'popup.bubbles', label: 'popup', screen: 'bubbles' },
+    { keys: ['m'], action: 'bubbles.view', label: 'treemap ⇄ bubbles', screen: 'bubbles' },
+    { keys: ['z'], action: 'bubbles.zoom', label: 'zoom cluster', screen: 'bubbles' },
+    { keys: ['D'], action: 'bubbles.deep', label: 'deep scan', screen: 'bubbles' },
+    { keys: ['r'], action: 'refresh', label: 'rescan', screen: 'bubbles' },
+    // task-1355 order plans & standing mandates. `O` opens the PLANS screen from anywhere (collision-free with
+    // every lowercase verb and the capitals B/S/P/W/V/X/T/L/C/F/Z/R/K/M/N/D). On the plans screen: tab flips
+    // plans ⇄ mandates, `a` arms the selected row (opens the hold-to-confirm modal — a captured physical keypress
+    // is the ONLY thing that arms; voice/agents can never reach this), `c` cancels the selected plan / `r` revokes
+    // the selected mandate, `!` panics (revokes all), `M` opens the read-only popup. j/k select, esc backs out.
+    { keys: ['O'], action: 'screen.plans', label: 'order plans' },
+    { keys: ['tab'], action: 'plans.tab', label: 'plans ⇄ mandates', screen: 'plans' },
+    { keys: ['a'], action: 'plans.arm', label: 'arm (hold)', screen: 'plans' },
+    { keys: ['c'], action: 'plans.cancel', label: 'cancel plan', screen: 'plans' },
+    { keys: ['r'], action: 'plans.revoke', label: 'revoke mandate', screen: 'plans' },
+    { keys: ['!'], action: 'plans.panic', label: 'PANIC', screen: 'plans' },
+    { keys: ['M'], action: 'plans.popup', label: 'popup', screen: 'plans' },
+    { keys: ['G'], action: 'plans.gate', label: 'hands-free gate', screen: 'plans' },
+    { keys: ['L'], action: 'plans.live', label: 'fire path paper/live', screen: 'plans' },
+    // task-1360 copy trading. `U` opens the FOLLOWED WALLETS screen from anywhere (free capital: not B/S/P/W/V/X/T/L/C/F/Z/R/
+    // K/M/N/D/O/G/I). On it: `i` types a wallet address (+ optional label) to follow, `d` unfollows the selected wallet,
+    // `r` (global refresh) polls now. Nothing on this screen trades: a buy/sell alert is information only.
+    { keys: ['U'], action: 'screen.follows', label: 'followed wallets' },
+    { keys: ['i'], action: 'follows.add', label: 'follow a wallet', screen: 'follows' },
+    { keys: ['d'], action: 'follows.remove', label: 'unfollow', screen: 'follows' },
+    { keys: ['r'], action: 'refresh', label: 'poll now', screen: 'follows' },
+    { keys: ['m'], action: 'follows.mirror', label: 'mirror ticket', screen: 'follows' },
+    { keys: ['A'], action: 'follows.auto', label: 'auto-mirror', screen: 'follows' },
+    // task-1358 workspaces (ctrl+w chord, global). `ctrl+w` itself is free everywhere except the chat input,
+    // which owns it (delete word) while focused — the keymap never sees it there.
+    { keys: ['ctrl+w w'], action: 'workspace.list', label: 'workspaces' },
+    { keys: ['ctrl+w n', 'ctrl+w tab'], action: 'workspace.next', label: 'next workspace' },
+    { keys: ['ctrl+w N'], action: 'workspace.prev', label: 'previous workspace' },
+    { keys: ['ctrl+w s'], action: 'workspace.save', label: 'save workspace' },
+    { keys: ['ctrl+w m'], action: 'workspace.morning', label: 'morning HUD' },
+    { keys: ['ctrl+w o'], action: 'workspace.popups', label: 'open workspace popups' },
+    { keys: ['ctrl+w d'], action: 'workspace.default', label: 'default workspace' },
+    // task-1358 Tier 3 rules (ctrl+r global; the screen's own verbs below). Nothing here arms or signs: a rule's
+    // ticket/ask is a PROPOSAL card; ⏎ on it opens the paper ticket editor / asks the analyst, where the user still confirms.
+    { keys: ['ctrl+r'], action: 'screen.rules', label: 'rules' },
+    { keys: ['i'], action: 'rules.new', label: 'new rule', screen: 'rules' },
+    { keys: ['enter'], action: 'rules.act', label: 'edit / act', screen: 'rules' },
+    { keys: ['e'], action: 'rules.edit', label: 'edit rule', screen: 'rules' },
+    { keys: ['space'], action: 'rules.toggle', label: 'enable/disable', screen: 'rules' },
+    { keys: ['d'], action: 'rules.remove', label: 'delete rule', screen: 'rules' },
+    { keys: ['tab'], action: 'rules.tab', label: 'rules ⇄ proposals', screen: 'rules' },
+    { keys: ['x'], action: 'rules.dismiss', label: 'dismiss proposal', screen: 'rules' },
+]);

package/dist/packages/tui/src/layout.js

@@ -0,0 +1,11 @@
+// @dexterm/tui — breakpoints (SPEC §7.4): compact < 100 cols, standard 100..139, wide ≥ 140.
+export const BREAKPOINTS = { compact: 0, standard: 100, wide: 140 };
+export function breakpoint(w) {
+    if (w < BREAKPOINTS.standard)
+        return 'compact';
+    if (w < BREAKPOINTS.wide)
+        return 'standard';
+    return 'wide';
+}
+/** Minimum supported terminal (SPEC §7.4): screener only, 7 columns. */
+export const MIN_SIZE = { w: 80, h: 24 };

package/dist/packages/tui/src/raster-font.js

@@ -0,0 +1,195 @@
+// @dexterm/tui — a 5×9 bitmap font for the PNG exporter (task-1401). Drawn for dexterm (no third-party font data):
+// rows 0–6 are the cap height, rows 7–8 the descenders. Box drawing, block elements and braille are not here:
+// raster.ts draws those procedurally so they join up across cells exactly like a terminal does.
+const G = {
+    ' ': [],
+    '!': ['..#..', '..#..', '..#..', '..#..', '..#..', '.....', '..#..'],
+    '"': ['.#.#.', '.#.#.', '.#.#.'],
+    '#': ['.#.#.', '.#.#.', '#####', '.#.#.', '#####', '.#.#.', '.#.#.'],
+    '$': ['..#..', '.####', '#.#..', '.###.', '..#.#', '####.', '..#..'],
+    '%': ['##...', '##..#', '...#.', '..#..', '.#...', '#..##', '...##'],
+    '&': ['.##..', '#..#.', '#.#..', '.#...', '#.#.#', '#..#.', '.##.#'],
+    "'": ['..#..', '..#..', '.#...'],
+    '(': ['...#.', '..#..', '.#...', '.#...', '.#...', '..#..', '...#.'],
+    ')': ['.#...', '..#..', '...#.', '...#.', '...#.', '..#..', '.#...'],
+    '*': ['.....', '..#..', '#.#.#', '.###.', '#.#.#', '..#..', '.....'],
+    '+': ['.....', '..#..', '..#..', '#####', '..#..', '..#..', '.....'],
+    ',': ['.....', '.....', '.....', '.....', '.....', '..#..', '..#..', '.#...'],
+    '-': ['.....', '.....', '.....', '#####', '.....', '.....', '.....'],
+    '.': ['.....', '.....', '.....', '.....', '.....', '.##..', '.##..'],
+    '/': ['.....', '....#', '...#.', '..#..', '.#...', '#....', '.....'],
+    '0': ['.###.', '#...#', '#..##', '#.#.#', '##..#', '#...#', '.###.'],
+    '1': ['..#..', '.##..', '..#..', '..#..', '..#..', '..#..', '.###.'],
+    '2': ['.###.', '#...#', '....#', '...#.', '..#..', '.#...', '#####'],
+    '3': ['#####', '...#.', '..#..', '...#.', '....#', '#...#', '.###.'],
+    '4': ['...#.', '..##.', '.#.#.', '#..#.', '#####', '...#.', '...#.'],
+    '5': ['#####', '#....', '####.', '....#', '....#', '#...#', '.###.'],
+    '6': ['..##.', '.#...', '#....', '####.', '#...#', '#...#', '.###.'],
+    '7': ['#####', '....#', '...#.', '..#..', '.#...', '.#...', '.#...'],
+    '8': ['.###.', '#...#', '#...#', '.###.', '#...#', '#...#', '.###.'],
+    '9': ['.###.', '#...#', '#...#', '.####', '....#', '...#.', '.##..'],
+    ':': ['.....', '.##..', '.##..', '.....', '.##..', '.##..', '.....'],
+    ';': ['.....', '.##..', '.##..', '.....', '.##..', '.##..', '.#...'],
+    '<': ['...#.', '..#..', '.#...', '#....', '.#...', '..#..', '...#.'],
+    '=': ['.....', '.....', '#####', '.....', '#####', '.....', '.....'],
+    '>': ['.#...', '..#..', '...#.', '....#', '...#.', '..#..', '.#...'],
+    '?': ['.###.', '#...#', '....#', '...#.', '..#..', '.....', '..#..'],
+    '@': ['.###.', '#...#', '....#', '.##.#', '#.#.#', '#.#.#', '.###.'],
+    'A': ['.###.', '#...#', '#...#', '#####', '#...#', '#...#', '#...#'],
+    'B': ['####.', '#...#', '#...#', '####.', '#...#', '#...#', '####.'],
+    'C': ['.###.', '#...#', '#....', '#....', '#....', '#...#', '.###.'],
+    'D': ['###..', '#..#.', '#...#', '#...#', '#...#', '#..#.', '###..'],
+    'E': ['#####', '#....', '#....', '####.', '#....', '#....', '#####'],
+    'F': ['#####', '#....', '#....', '####.', '#....', '#....', '#....'],
+    'G': ['.###.', '#...#', '#....', '#.###', '#...#', '#...#', '.####'],
+    'H': ['#...#', '#...#', '#...#', '#####', '#...#', '#...#', '#...#'],
+    'I': ['.###.', '..#..', '..#..', '..#..', '..#..', '..#..', '.###.'],
+    'J': ['..###', '...#.', '...#.', '...#.', '...#.', '#..#.', '.##..'],
+    'K': ['#...#', '#..#.', '#.#..', '##...', '#.#..', '#..#.', '#...#'],
+    'L': ['#....', '#....', '#....', '#....', '#....', '#....', '#####'],
+    'M': ['#...#', '##.##', '#.#.#', '#.#.#', '#...#', '#...#', '#...#'],
+    'N': ['#...#', '#...#', '##..#', '#.#.#', '#..##', '#...#', '#...#'],
+    'O': ['.###.', '#...#', '#...#', '#...#', '#...#', '#...#', '.###.'],
+    'P': ['####.', '#...#', '#...#', '####.', '#....', '#....', '#....'],
+    'Q': ['.###.', '#...#', '#...#', '#...#', '#.#.#', '#..#.', '.##.#'],
+    'R': ['####.', '#...#', '#...#', '####.', '#.#..', '#..#.', '#...#'],
+    'S': ['.####', '#....', '#....', '.###.', '....#', '....#', '####.'],
+    'T': ['#####', '..#..', '..#..', '..#..', '..#..', '..#..', '..#..'],
+    'U': ['#...#', '#...#', '#...#', '#...#', '#...#', '#...#', '.###.'],
+    'V': ['#...#', '#...#', '#...#', '#...#', '#...#', '.#.#.', '..#..'],
+    'W': ['#...#', '#...#', '#...#', '#.#.#', '#.#.#', '#.#.#', '.#.#.'],
+    'X': ['#...#', '#...#', '.#.#.', '..#..', '.#.#.', '#...#', '#...#'],
+    'Y': ['#...#', '#...#', '.#.#.', '..#..', '..#..', '..#..', '..#..'],
+    'Z': ['#####', '....#', '...#.', '..#..', '.#...', '#....', '#####'],
+    '[': ['.###.', '.#...', '.#...', '.#...', '.#...', '.#...', '.###.'],
+    '\\': ['.....', '#....', '.#...', '..#..', '...#.', '....#', '.....'],
+    ']': ['.###.', '...#.', '...#.', '...#.', '...#.', '...#.', '.###.'],
+    '^': ['..#..', '.#.#.', '#...#'],
+    '_': ['.....', '.....', '.....', '.....', '.....', '.....', '.....', '#####'],
+    '`': ['.#...', '..#..', '...#.'],
+    'a': ['.....', '.....', '.###.', '....#', '.####', '#...#', '.####'],
+    'b': ['#....', '#....', '#.##.', '##..#', '#...#', '#...#', '####.'],
+    'c': ['.....', '.....', '.###.', '#....', '#....', '#...#', '.###.'],
+    'd': ['....#', '....#', '.##.#', '#..##', '#...#', '#...#', '.####'],
+    'e': ['.....', '.....', '.###.', '#...#', '#####', '#....', '.###.'],
+    'f': ['..##.', '.#..#', '.#...', '###..', '.#...', '.#...', '.#...'],
+    'g': ['.....', '.....', '.####', '#...#', '#...#', '.####', '....#', '....#', '.###.'],
+    'h': ['#....', '#....', '#.##.', '##..#', '#...#', '#...#', '#...#'],
+    'i': ['..#..', '.....', '.##..', '..#..', '..#..', '..#..', '.###.'],
+    'j': ['...#.', '.....', '..##.', '...#.', '...#.', '...#.', '...#.', '#..#.', '.##..'],
+    'k': ['#....', '#....', '#..#.', '#.#..', '##...', '#.#..', '#..#.'],
+    'l': ['.##..', '..#..', '..#..', '..#..', '..#..', '..#..', '.###.'],
+    'm': ['.....', '.....', '##.#.', '#.#.#', '#.#.#', '#...#', '#...#'],
+    'n': ['.....', '.....', '#.##.', '##..#', '#...#', '#...#', '#...#'],
+    'o': ['.....', '.....', '.###.', '#...#', '#...#', '#...#', '.###.'],
+    'p': ['.....', '.....', '####.', '#...#', '#...#', '####.', '#....', '#....', '#....'],
+    'q': ['.....', '.....', '.####', '#...#', '#...#', '.####', '....#', '....#', '....#'],
+    'r': ['.....', '.....', '#.##.', '##..#', '#....', '#....', '#....'],
+    's': ['.....', '.....', '.####', '#....', '.###.', '....#', '####.'],
+    't': ['.#...', '.#...', '###..', '.#...', '.#...', '.#..#', '..##.'],
+    'u': ['.....', '.....', '#...#', '#...#', '#...#', '#..##', '.##.#'],
+    'v': ['.....', '.....', '#...#', '#...#', '#...#', '.#.#.', '..#..'],
+    'w': ['.....', '.....', '#...#', '#...#', '#.#.#', '#.#.#', '.#.#.'],
+    'x': ['.....', '.....', '#...#', '.#.#.', '..#..', '.#.#.', '#...#'],
+    'y': ['.....', '.....', '#...#', '#...#', '#...#', '.####', '....#', '....#', '.###.'],
+    'z': ['.....', '.....', '#####', '...#.', '..#..', '.#...', '#####'],
+    '{': ['...#.', '..#..', '..#..', '.#...', '..#..', '..#..', '...#.'],
+    '|': ['..#..', '..#..', '..#..', '..#..', '..#..', '..#..', '..#..'],
+    '}': ['.#...', '..#..', '..#..', '...#.', '..#..', '..#..', '.#...'],
+    '~': ['.....', '.....', '.#...', '#.#.#', '...#.', '.....', '.....'],
+    // symbols the screens use
+    '·': ['.....', '.....', '.....', '..#..', '.....', '.....', '.....'],
+    '•': ['.....', '.....', '.###.', '.###.', '.###.', '.....', '.....'],
+    '●': ['.....', '.###.', '#####', '#####', '#####', '.###.', '.....'],
+    '◉': ['.....', '.###.', '#...#', '#.#.#', '#...#', '.###.', '.....'],
+    '○': ['.....', '.###.', '#...#', '#...#', '#...#', '.###.', '.....'],
+    '◌': ['.....', '.#.#.', '#...#', '.....', '#...#', '.#.#.', '.....'],
+    '◐': ['.....', '.###.', '##..#', '##..#', '##..#', '.###.', '.....'],
+    '◈': ['..#..', '.#.#.', '#.#.#', '.#.#.', '..#..', '.....', '.....'],
+    '◆': ['..#..', '.###.', '#####', '.###.', '..#..', '.....', '.....'],
+    '◇': ['..#..', '.#.#.', '#...#', '.#.#.', '..#..', '.....', '.....'],
+    '■': ['.....', '#####', '#####', '#####', '#####', '#####', '.....'],
+    '□': ['.....', '#####', '#...#', '#...#', '#...#', '#####', '.....'],
+    '▪': ['.....', '.....', '.###.', '.###.', '.###.', '.....', '.....'],
+    '★': ['..#..', '..#..', '#####', '.###.', '.#.#.', '#...#', '.....'],
+    '☆': ['..#..', '..#..', '##.##', '.#.#.', '.#.#.', '#...#', '.....'],
+    '▲': ['.....', '..#..', '..#..', '.###.', '.###.', '#####', '.....'],
+    '▼': ['.....', '#####', '.###.', '.###.', '..#..', '..#..', '.....'],
+    '△': ['.....', '..#..', '..#..', '.#.#.', '.#.#.', '#####', '.....'],
+    '▽': ['.....', '#####', '.#.#.', '.#.#.', '..#..', '..#..', '.....'],
+    '▶': ['.#...', '.##..', '.###.', '.####', '.###.', '.##..', '.#...'],
+    '◀': ['...#.', '..##.', '.###.', '####.', '.###.', '..##.', '...#.'],
+    '▸': ['.....', '.#...', '.##..', '.###.', '.##..', '.#...', '.....'],
+    '◂': ['.....', '...#.', '..##.', '.###.', '..##.', '...#.', '.....'],
+    '✦': ['..#..', '..#..', '.###.', '#####', '.###.', '..#..', '..#..'],
+    '✧': ['..#..', '..#..', '.#.#.', '##.##', '.#.#.', '..#..', '..#..'],
+    '⚠': ['..#..', '.#.#.', '.#.#.', '#.#.#', '#...#', '#.#.#', '#####'],
+    '…': ['.....', '.....', '.....', '.....', '.....', '.....', '#.#.#'],
+    '→': ['.....', '..#..', '...#.', '#####', '...#.', '..#..', '.....'],
+    '←': ['.....', '..#..', '.#...', '#####', '.#...', '..#..', '.....'],
+    '↑': ['..#..', '.###.', '#.#.#', '..#..', '..#..', '..#..', '.....'],
+    '↓': ['.....', '..#..', '..#..', '..#..', '#.#.#', '.###.', '..#..'],
+    '↗': ['.....', '..###', '...##', '..#.#', '.#...', '#....', '.....'],
+    '↘': ['.....', '#....', '.#...', '..#.#', '...##', '..###', '.....'],
+    '↳': ['#....', '#....', '#..#.', '#...#', '#####', '....#', '...#.'],
+    '↪': ['.....', '.###.', '#...#', '#..#.', '#.###', '....#', '.....'],
+    '⎿': ['#....', '#....', '#....', '#....', '#####', '.....', '.....'],
+    '✔': ['.....', '....#', '...##', '#.##.', '###..', '.#...', '.....'],
+    '✖': ['.....', '##.##', '.###.', '..#..', '.###.', '##.##', '.....'],
+    '⚡': ['...##', '..##.', '.##..', '#####', '..##.', '.##..', '##...'],
+    '⇄': ['...#.', '#####', '...#.', '.#...', '#####', '.#...', '.....'],
+    '⏎': ['....#', '....#', '..#.#', '.####', '..#..', '.....', '.....'],
+    '✓': ['.....', '....#', '...#.', '#.#..', '.#...', '.....', '.....'],
+    '✗': ['.....', '#...#', '.#.#.', '..#..', '.#.#.', '#...#', '.....'],
+    '✕': ['.....', '#...#', '.#.#.', '..#..', '.#.#.', '#...#', '.....'],
+    '×': ['.....', '.....', '#...#', '.#.#.', '..#..', '.#.#.', '#...#'],
+    '—': ['.....', '.....', '.....', '#####', '.....', '.....', '.....'],
+    '–': ['.....', '.....', '.....', '.####', '.....', '.....', '.....'],
+    '≥': ['.#...', '..#..', '...#.', '..#..', '.#...', '.....', '#####'],
+    '≤': ['...#.', '..#..', '.#...', '..#..', '...#.', '.....', '#####'],
+    '≈': ['.....', '.#...', '#.#.#', '...#.', '.#...', '#.#.#', '...#.'],
+    '±': ['..#..', '..#..', '#####', '..#..', '..#..', '.....', '#####'],
+    '°': ['.##..', '#..#.', '.##..'],
+    '€': ['..###', '.#...', '####.', '.#...', '####.', '.#...', '..###'],
+    '£': ['..##.', '.#..#', '.#...', '###..', '.#...', '.#..#', '#.##.'],
+    'ᵖ': ['###..', '#.#..', '###..', '#....'],
+    '‹': ['.....', '...#.', '..#..', '.#...', '..#..', '...#.', '.....'],
+    '›': ['.....', '.#...', '..#..', '...#.', '..#..', '.#...', '.....'],
+    '«': ['.....', '..#.#', '.#.#.', '#.#..', '.#.#.', '..#.#', '.....'],
+    '»': ['.....', '#.#..', '.#.#.', '..#.#', '.#.#.', '#.#..', '.....'],
+    '‘': ['..#..', '.#...', '.#...'],
+    '’': ['..#..', '..#..', '.#...'],
+    '“': ['.#.#.', '#.#..', '#.#..'],
+    '”': ['.#.#.', '.#.#.', '#.#..'],
+};
+/** Glyph width and height in font pixels. */
+export const FONT_W = 5;
+export const FONT_H = 9;
+// Small 3×5 digits for subscripts (₀-₉: the price formatter's zero-count, e.g. $0.0₅3105) and superscripts (⁰-⁹).
+// A subscript must never render as a full-size digit: that would turn 0.0₅31 into 0.0531.
+const SMALL = [
+    ['###', '#.#', '#.#', '#.#', '###'], ['.#.', '##.', '.#.', '.#.', '###'], ['###', '..#', '###', '#..', '###'],
+    ['###', '..#', '.##', '..#', '###'], ['#.#', '#.#', '###', '..#', '..#'], ['###', '#..', '###', '..#', '###'],
+    ['###', '#..', '###', '#.#', '###'], ['###', '..#', '.#.', '.#.', '.#.'], ['###', '#.#', '###', '#.#', '###'],
+    ['###', '#.#', '###', '..#', '###'],
+];
+const SUB = '₀₁₂₃₄₅₆₇₈₉', SUP = '⁰¹²³⁴⁵⁶⁷⁸⁹';
+for (let d = 0; d < 10; d++) {
+    const rows = SMALL[d].map((r) => `.${r}.`);
+    G[SUB[d]] = ['.....', '.....', '.....', '.....', ...rows];
+    G[SUP[d]] = rows;
+}
+const BITS = new Map();
+for (const [ch, rows] of Object.entries(G)) {
+    const b = new Uint8Array(FONT_W * FONT_H);
+    rows.forEach((r, y) => { for (let x = 0; x < FONT_W; x++)
+        if (r[x] === '#')
+            b[y * FONT_W + x] = 1; });
+    BITS.set(ch, b);
+}
+/** The 5×9 bitmap for a character (1 = ink), or null when the font has no glyph for it. */
+export function glyphBits(ch) {
+    return BITS.get(ch) ?? null;
+}
+/** Every character with a bitmap glyph (tests check the printable ASCII range is complete). */
+export function fontChars() { return [...BITS.keys()]; }