dexterm-cli 0.1.1 → 0.1.3

package/dist/packages/popup/src/pages/spectator.js

@@ -0,0 +1,74 @@
+// dexterm popup — spectator page (task-1406, "watch the agent cook"). Renders the SpectatorPopupVM: the
+// screen the agent moved to, the connected agents with an 'agent' badge and status, and an activity feed
+// with timing and data ages. Every string is already REDACTED TUI-side (wallet addresses/keys masked) and
+// is rendered with textContent only — never innerHTML. The ONLY messages this page sends are the
+// allow-listed spectator.pause / resume / takeover / kill events (by agent name); it can never arm, sign,
+// raise a cap or touch a wallet (no such control exists and the server drops anything off the allow-list).
+(() => {
+  'use strict';
+  const DT = window.DT; DT.page = 'spectator';
+  const $ = (id) => document.getElementById(id);
+  const el = (tag, cls, text) => { const e = document.createElement(tag); if (cls) e.className = cls; if (text != null) e.textContent = String(text); return e; };
+  const ago = (t) => { if (!t) return '—'; const s = Math.max(0, Math.round((Date.now() - t) / 1000)); return s < 60 ? `${s}s` : s < 3600 ? `${Math.floor(s / 60)}m` : `${Math.floor(s / 3600)}h`; };
+  const age = (s) => (s == null ? '' : s < 60 ? `${Math.round(s)}s old` : s < 3600 ? `${Math.floor(s / 60)}m old` : `${Math.floor(s / 3600)}h old`);
+
+  let vm = null;
+
+  function render() {
+    if (!vm) return;
+
+    const scr = $('screen'); scr.textContent = '';
+    const s = vm.screen || {};
+    scr.appendChild(el('span', 'spec-screen-k', `screen: ${s.screen || '—'}`));
+    if (s.selectedMint) scr.appendChild(el('span', 'spec-screen-dim', ` · token ${s.selectedMint}`));
+    if (s.feed) scr.appendChild(el('span', 'spec-screen-dim', ` · feed ${s.feed}`));
+    if (s.filter) scr.appendChild(el('span', 'spec-screen-dim', ` · filter ${s.filter}`));
+    if (s.highlight) scr.appendChild(el('span', 'spec-screen-dim', ` · ★ ${s.highlight}`));
+    if (vm.control === 'user') scr.appendChild(el('span', 'spec-takeover', ' · YOU HAVE TAKEN OVER'));
+
+    const host = $('agents'); host.textContent = '';
+    if (!vm.agents || !vm.agents.length) host.appendChild(el('div', 'spec-dim', 'no agents connected yet'));
+    for (const a of (vm.agents || [])) {
+      const row = el('div', 'spec-agent' + (a.status !== 'active' ? ' off' : ''));
+      row.appendChild(el('span', 'spec-badge', 'agent'));           // the 'agent' badge
+      row.appendChild(el('span', 'spec-name', a.name));             // textContent — redacted/firewalled, safe
+      if (a.tier) row.appendChild(el('span', 'spec-tier tier-' + a.tier, a.tier));
+      row.appendChild(el('span', 'spec-status status-' + a.status, a.status));
+      row.appendChild(el('span', 'spec-dim', ` · ${ago(a.lastAt)}`));
+      const ctl = el('div', 'spec-ctl');
+      const mk = (label, name, danger) => { const b = el('button', 'spec-btn' + (danger ? ' danger' : ''), label); b.type = 'button'; b.addEventListener('click', () => DT.send({ type: 'event', name, payload: { agent: a.name } })); return b; };
+      if (a.status === 'active') { ctl.appendChild(mk('pause', 'spectator.pause')); ctl.appendChild(mk('take over', 'spectator.takeover')); }
+      else ctl.appendChild(mk('resume', 'spectator.resume'));
+      ctl.appendChild(mk('kill', 'spectator.kill', true));          // panic
+      row.appendChild(ctl);
+      host.appendChild(row);
+    }
+
+    const act = $('activity'); act.textContent = '';
+    for (const r of (vm.activity || []).slice().reverse().slice(0, 80)) {
+      const line = el('div', 'spec-act' + (r.ok ? '' : ' bad') + (r.phase === 'nav' ? ' nav' : ''));
+      line.appendChild(el('span', 'spec-act-t', ago(r.t)));
+      line.appendChild(el('span', 'spec-badge sm', 'agent'));
+      line.appendChild(el('span', 'spec-act-agent', r.agent));
+      line.appendChild(el('span', 'spec-act-phase', r.phase));
+      if (r.tool) line.appendChild(el('span', 'spec-act-tool', r.tool));
+      line.appendChild(el('span', 'spec-act-sum', r.summary || ''));  // textContent — redacted upstream
+      if (r.ms != null) line.appendChild(el('span', 'spec-act-ms', `${Math.round(r.ms)}ms`));
+      if (r.dataAgeSec != null) line.appendChild(el('span', 'spec-act-age', age(r.dataAgeSec)));
+      act.appendChild(line);
+    }
+
+    $('redact').textContent = vm.redacted ? 'redacted' : 'local (full)';
+    const live = (vm.agents || []).filter((a) => a.status === 'active').length;
+    DT.status(`${live} cooking`, live ? 'up' : 'muted');
+  }
+
+  DT.onHello(() => { DT.mountRain('rain'); const r = DT.rain(); if (r) { r.setActivity(0.3); r.setMood('rain'); } });
+  DT.onData((payload) => { vm = payload; render(); });
+  DT.onUpdate(() => { /* spectator is pushed as full `data` frames */ });
+  DT.wireChrome();
+  let lastTick = 0;
+  DT.rainEvery = 2; DT.fpsCap = 30;
+  DT.loop((now) => { if (now - lastTick > 1000) { lastTick = now; if (vm) render(); } });
+  DT.connect();
+})();

package/dist/packages/popup/src/selftest.js

@@ -62,6 +62,25 @@ export function fixtureNarrativeVM() {
         limits: 'model output: none (deterministic lexicon v0.1.0). Name-based: X/Telegram-only narratives are missed; 6 copycat symbols.',
     };
 }
+/** A deterministic, network-free spectator view for the popup self-test / demo (task-1406). Not real agents. */
+export function fixtureSpectatorVM() {
+    const now = Date.now();
+    return {
+        title: 'watch the agent cook', now, redacted: true, control: 'agent',
+        screen: { screen: 'token', selectedMint: 'Fixt…AAAA', feed: 'new', filter: null, highlight: null },
+        agents: [
+            { name: 'claude-code', tier: 'propose', status: 'active', lastAt: now - 1200 },
+            { name: 'scanbot', tier: 'observe', status: 'paused', lastAt: now - 8000 },
+        ],
+        activity: [
+            { seq: 1, t: now - 8000, phase: 'connect', agent: 'claude-code', tier: 'propose', tool: null, summary: 'connected · claude-code 2.1', ms: null, dataAgeSec: null, ok: true, refusal: null },
+            { seq: 2, t: now - 5000, phase: 'nav', agent: 'claude-code', tier: 'propose', tool: 'open_token', summary: 'open Fixt…AAAA', ms: 6, dataAgeSec: null, ok: true, refusal: null },
+            { seq: 3, t: now - 4200, phase: 'result', agent: 'claude-code', tier: 'propose', tool: 'rugcheck', summary: 'rugcheck Fixt…', ms: 42, dataAgeSec: 3, ok: true, refusal: null },
+            { seq: 4, t: now - 2000, phase: 'proposal', agent: 'claude-code', tier: 'propose', tool: 'propose_alert', summary: 'alert when mcap crosses 1M', ms: 2, dataAgeSec: null, ok: true, refusal: null },
+            { seq: 5, t: now - 1000, phase: 'refused', agent: 'scanbot', tier: 'observe', tool: 'arm_plan', summary: 'refused: no agent may do that at any tier', ms: null, dataAgeSec: null, ok: false, refusal: 'never' },
+        ],
+    };
+}
 /** Run the self-test and resolve with the measured result. Always cleans up the window host and server. */
 export async function runSelfTest(opts = {}) {
     const seconds = Math.max(2, Math.min(30, opts.seconds ?? 6));

package/dist/packages/popup/src/server.js

@@ -52,6 +52,8 @@ export const POPUP_EVENTS = new Set([
     'event:roster.pause', 'event:roster.resume', 'event:roster.kick',
     // task-1355 order plans: cancel a plan by id (the ONLY write the plans popup can send — never arm/cap/sign)
     'event:plan.cancel',
+    // task-1406 spectator: pause / resume / take over / kill an agent by name (the only writes this popup sends)
+    'event:spectator.pause', 'event:spectator.resume', 'event:spectator.takeover', 'event:spectator.kill',
 ]);
 /**
  * task-1358 r3: the ONLY messages a pack widget's socket may send — the generic set every popup has. A widget socket
@@ -104,6 +106,10 @@ export function validateEventPayload(name, payload) {
         case 'roster.pause':
         case 'roster.resume':
         case 'roster.kick':
+        case 'spectator.pause':
+        case 'spectator.resume':
+        case 'spectator.takeover':
+        case 'spectator.kill':
             return typeof p.agent === 'string' && ROSTER_AGENT_RE.test(p.agent) ? { agent: p.agent } : null;
         case 'plan.cancel':
             return typeof p.id === 'string' && PLAN_ID_RE.test(p.id) ? { id: p.id } : null;
@@ -117,7 +123,7 @@ export function lwcLogoStyleHash(lwcSource) {
     return m ? `'sha256-${createHash('sha256').update(m[1], 'utf8').digest('base64')}'` : null;
 }
 // (r3) 'widget' is the WRAPPER page — ours, nonce-rendered like the rest; the pack html goes in its iframe
-const PAGE_KINDS = ['chart', 'token', 'feeds', 'bubbles', 'roster', 'narrative', 'plans', 'widget'];
+const PAGE_KINDS = ['chart', 'token', 'feeds', 'bubbles', 'roster', 'narrative', 'plans', 'widget', 'spectator'];
 function b64url(buf) { return buf.toString('base64url'); }
 function safeEq(a, b) {
     const ba = Buffer.from(a), bb = Buffer.from(b);

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

@@ -13,3 +13,6 @@ export * from "./sound.js";
 export * from "./bubbles.js";
 export * from "./chrome.js";
 export * from "./images/index.js";
+// task-1401: rasterize a canvas to RGBA for the export/share PNG (bitmap font + procedural box/blocks/braille).
+export * from "./raster.js";
+export { glyphBits, fontChars, FONT_W, FONT_H } from "./raster-font.js";

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

@@ -206,6 +206,12 @@ export const DEFAULT_KEYMAP = new Keymap([
     // 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-1411: in-voice controls (loop-handled; only act while voice is on). `m` mute, `,` change voice,
+    // `<`/`>` slow down / speed up the spoken reply (saved to config.voice.rate). Per-screen `m` bindings
+    // (kol/bubbles/follows) override this global one on those screens, exactly like `voice.talk`.
+    { keys: ['m'], action: 'voice.mute', label: 'mute voice' },
+    { keys: [','], action: 'voice.cycle', label: 'change voice' },
+    { keys: ['<', '>'], action: 'voice.rate', label: 'slower / faster 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' },
@@ -215,6 +221,12 @@ export const DEFAULT_KEYMAP = new Keymap([
     { 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' },
+    // task-1407: `H` (free capital everywhere) opens the PnL card preview on the screens that have fills to card.
+    { keys: ['H'], action: 'pnl.card', label: 'PnL card (share)', screen: 'token' },
+    { keys: ['H'], action: 'pnl.card', label: 'PnL card (share)', screen: 'positions' },
+    { keys: ['H'], action: 'pnl.card', label: 'PnL card (share)', screen: 'follows' },
     { 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' },

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()]; }

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

@@ -0,0 +1,213 @@
+import { ATTR_BOLD, ATTR_DIM, ATTR_UNDERLINE } from "./canvas.js";
+import { hexToRgb, mix } from "./color.js";
+import { glyphBits, FONT_W, FONT_H } from "./raster-font.js";
+class Px {
+    w;
+    h;
+    rgba;
+    constructor(w, h) { this.w = w; this.h = h; this.rgba = new Uint8Array(w * h * 4); }
+    rect(x, y, w, h, c, a = 1) {
+        const x0 = Math.max(0, Math.floor(x)), y0 = Math.max(0, Math.floor(y));
+        const x1 = Math.min(this.w, Math.floor(x + w)), y1 = Math.min(this.h, Math.floor(y + h));
+        for (let yy = y0; yy < y1; yy++)
+            for (let xx = x0; xx < x1; xx++) {
+                const i = (yy * this.w + xx) * 4;
+                if (a >= 1) {
+                    this.rgba[i] = c[0];
+                    this.rgba[i + 1] = c[1];
+                    this.rgba[i + 2] = c[2];
+                }
+                else {
+                    this.rgba[i] = Math.round(this.rgba[i] * (1 - a) + c[0] * a);
+                    this.rgba[i + 1] = Math.round(this.rgba[i + 1] * (1 - a) + c[1] * a);
+                    this.rgba[i + 2] = Math.round(this.rgba[i + 2] * (1 - a) + c[2] * a);
+                }
+                this.rgba[i + 3] = 255;
+            }
+    }
+}
+// Box drawing: up, down, left, right weights (0 none, 1 light, 2 heavy/double) and a dashed flag.
+const BOX = {
+    '─': '0011', '━': '0022', '│': '1100', '┃': '2200',
+    '┌': '0101', '╭': '0101', '┐': '0110', '╮': '0110', '└': '1001', '╰': '1001', '┘': '1010', '╯': '1010',
+    '┏': '0202', '┓': '0220', '┗': '2002', '┛': '2020',
+    '├': '1101', '┤': '1110', '┬': '0111', '┴': '1011', '┼': '1111',
+    '┣': '2202', '┫': '2220', '┳': '0222', '┻': '2022', '╋': '2222',
+    '═': '0022', '║': '2200', '╔': '0202', '╗': '0220', '╚': '2002', '╝': '2020', '╠': '2202', '╣': '2220', '╦': '0222', '╩': '2022', '╬': '2222',
+    '╴': '0010', '╵': '1000', '╶': '0001', '╷': '0100', '╸': '0020', '╹': '2000', '╺': '0002', '╻': '0200',
+};
+const DASH_H = new Set(['┄', '┅', '┈', '┉', '╌', '╍']);
+const DASH_V = new Set(['┆', '┇', '┊', '┋', '╎', '╏']);
+const EIGHTHS_LOW = '▁▂▃▄▅▆▇█';
+const EIGHTHS_LEFT = '▏▎▍▌▋▊▉█';
+const SHADES = { '░': 0.25, '▒': 0.5, '▓': 0.75 };
+// Quadrants: TL, TR, BL, BR.
+const QUAD = {
+    '▘': [1, 0, 0, 0], '▝': [0, 1, 0, 0], '▖': [0, 0, 1, 0], '▗': [0, 0, 0, 1], '▚': [1, 0, 0, 1], '▞': [0, 1, 1, 0],
+    '▛': [1, 1, 1, 0], '▜': [1, 1, 0, 1], '▙': [1, 0, 1, 1], '▟': [0, 1, 1, 1], '▀': [1, 1, 0, 0], '▄': [0, 0, 1, 1], '▌': [1, 0, 1, 0], '▐': [0, 1, 0, 1],
+};
+/** Draw one non-text glyph procedurally. Returns false when the glyph is not one of these families. */
+function drawSpecial(p, ch, x, y, cw, chh, fg, bg, scale) {
+    const box = BOX[ch];
+    if (box) {
+        const t1 = Math.max(1, scale), t2 = Math.max(2, scale * 2);
+        const [u, d, l, r] = [...box].map(Number);
+        const cx = x + Math.floor(cw / 2), cy = y + Math.floor(chh / 2);
+        const th = (wgt) => (wgt === 2 ? t2 : t1);
+        const hT = Math.max(th(l), th(r)), vT = Math.max(th(u), th(d));
+        if (l)
+            p.rect(x, cy - Math.floor(th(l) / 2), cx - x + Math.ceil(vT / 2), th(l), fg);
+        if (r)
+            p.rect(cx - Math.floor(vT / 2), cy - Math.floor(th(r) / 2), x + cw - (cx - Math.floor(vT / 2)), th(r), fg);
+        if (u)
+            p.rect(cx - Math.floor(th(u) / 2), y, th(u), cy - y + Math.ceil(hT / 2), fg);
+        if (d)
+            p.rect(cx - Math.floor(th(d) / 2), cy - Math.floor(hT / 2), th(d), y + chh - (cy - Math.floor(hT / 2)), fg);
+        return true;
+    }
+    if (DASH_H.has(ch)) {
+        const t = Math.max(1, scale);
+        const seg = Math.max(2, Math.floor(cw / 4));
+        for (let k = 0; k < cw; k += seg * 2)
+            p.rect(x + k, y + Math.floor(chh / 2) - Math.floor(t / 2), seg, t, fg);
+        return true;
+    }
+    if (DASH_V.has(ch)) {
+        const t = Math.max(1, scale);
+        const seg = Math.max(2, Math.floor(chh / 6));
+        for (let k = 0; k < chh; k += seg * 2)
+            p.rect(x + Math.floor(cw / 2) - Math.floor(t / 2), y + k, t, seg, fg);
+        return true;
+    }
+    const low = EIGHTHS_LOW.indexOf(ch);
+    if (low >= 0) {
+        const hh = Math.round((chh * (low + 1)) / 8);
+        p.rect(x, y + chh - hh, cw, hh, fg);
+        return true;
+    }
+    const left = EIGHTHS_LEFT.indexOf(ch);
+    if (left >= 0) {
+        p.rect(x, y, Math.round((cw * (left + 1)) / 8), chh, fg);
+        return true;
+    }
+    if (ch === '▔') {
+        p.rect(x, y, cw, Math.max(1, Math.round(chh / 8)), fg);
+        return true;
+    }
+    if (ch === '▕') {
+        const ww = Math.max(1, Math.round(cw / 8));
+        p.rect(x + cw - ww, y, ww, chh, fg);
+        return true;
+    }
+    const shade = SHADES[ch];
+    if (shade !== undefined) {
+        p.rect(x, y, cw, chh, [Math.round(bg[0] + (fg[0] - bg[0]) * shade), Math.round(bg[1] + (fg[1] - bg[1]) * shade), Math.round(bg[2] + (fg[2] - bg[2]) * shade)]);
+        return true;
+    }
+    const q = QUAD[ch];
+    if (q) {
+        const hw = Math.floor(cw / 2), hh = Math.floor(chh / 2);
+        if (q[0])
+            p.rect(x, y, hw, hh, fg);
+        if (q[1])
+            p.rect(x + hw, y, cw - hw, hh, fg);
+        if (q[2])
+            p.rect(x, y + hh, hw, chh - hh, fg);
+        if (q[3])
+            p.rect(x + hw, y + hh, cw - hw, chh - hh, fg);
+        return true;
+    }
+    const code = ch.codePointAt(0) ?? 0;
+    if (code >= 0x2800 && code <= 0x28ff) {
+        const bits = code - 0x2800;
+        // dot n → (column, row): 1(0,0) 2(0,1) 3(0,2) 4(1,0) 5(1,1) 6(1,2) 7(0,3) 8(1,3)
+        const dots = [[0x01, 0, 0], [0x02, 0, 1], [0x04, 0, 2], [0x08, 1, 0], [0x10, 1, 1], [0x20, 1, 2], [0x40, 0, 3], [0x80, 1, 3]];
+        const dw = Math.max(1, Math.floor(cw / 4)), dh = Math.max(1, Math.floor(chh / 8));
+        for (const [bit, col, row] of dots)
+            if (bits & bit)
+                p.rect(x + Math.floor((cw * (col * 2 + 1)) / 4) - Math.floor(dw / 2), y + Math.floor((chh * (row * 2 + 1)) / 8) - Math.floor(dh / 2), dw, dh, fg);
+        return true;
+    }
+    if (ch === '╱' || ch === '╲' || ch === '╳') {
+        const t = Math.max(1, scale);
+        for (let k = 0; k < chh; k++) {
+            const fx = Math.floor((k * cw) / chh);
+            if (ch !== '╲')
+                p.rect(x + cw - 1 - fx - Math.floor(t / 2), y + k, t, 1, fg);
+            if (ch !== '╱')
+                p.rect(x + fx - Math.floor(t / 2), y + k, t, 1, fg);
+        }
+        return true;
+    }
+    return false;
+}
+/** Rasterize every cell of a canvas: background, glyph (font or procedural), attributes, then image slots. */
+export function rasterizeCanvas(c, opts = {}) {
+    const cw = opts.cellW ?? 12, chh = opts.cellH ?? 24, scale = opts.scale ?? 2;
+    const p = new Px(c.w * cw, c.h * chh);
+    const gx = Math.floor((cw - FONT_W * scale) / 2), gy = Math.floor((chh - FONT_H * scale) / 2);
+    const rgbCache = new Map();
+    const rgb = (h) => { let v = rgbCache.get(h); if (!v) {
+        v = hexToRgb(h);
+        rgbCache.set(h, v);
+    } return v; };
+    for (let row = 0; row < c.h; row++)
+        for (let col = 0; col < c.w; col++) {
+            const i = row * c.w + col;
+            const x = col * cw, y = row * chh;
+            const bgHex = c.bg[i];
+            const bg = rgb(bgHex);
+            p.rect(x, y, cw, chh, bg);
+            const ch = c.ch[i];
+            if (ch === ' ' || ch === '')
+                continue;
+            const at = c.at[i];
+            const fg = rgb(at & ATTR_DIM ? mix(c.fg[i], bgHex, 0.45) : c.fg[i]);
+            if (drawSpecial(p, ch, x, y, cw, chh, fg, bg, scale))
+                continue;
+            let bits = glyphBits(ch);
+            // an accented LETTER falls back to its base letter (é → e); never a digit or symbol, whose compatibility form
+            // can change meaning (a subscript ₅ is not a 5)
+            if (!bits && /^\p{L}$/u.test(ch)) {
+                const base = ch.normalize('NFD').replace(/\p{M}+/gu, '');
+                if (base && base !== ch)
+                    bits = glyphBits(base[0]);
+            }
+            if (!bits) {
+                // tofu: a hollow box so an unsupported glyph is visible, never silently dropped
+                const t = Math.max(1, Math.floor(scale / 2));
+                const bx = x + gx + scale, by = y + gy + scale * 2, bw = (FONT_W - 2) * scale, bh = (FONT_H - 4) * scale;
+                p.rect(bx, by, bw, t, fg);
+                p.rect(bx, by + bh - t, bw, t, fg);
+                p.rect(bx, by, t, bh, fg);
+                p.rect(bx + bw - t, by, t, bh, fg);
+                continue;
+            }
+            const bold = (at & ATTR_BOLD) !== 0;
+            for (let yy = 0; yy < FONT_H; yy++)
+                for (let xx = 0; xx < FONT_W; xx++) {
+                    if (!bits[yy * FONT_W + xx])
+                        continue;
+                    p.rect(x + gx + xx * scale, y + gy + yy * scale, scale + (bold ? 1 : 0), scale, fg);
+                }
+            if (at & ATTR_UNDERLINE)
+                p.rect(x, y + chh - Math.max(1, scale), cw, Math.max(1, Math.floor(scale / 2)), fg);
+        }
+    // Pixel image slots (coin images) recorded by the canvas in 'pixels' mode: nearest-neighbour into the cell rect.
+    for (const s of c.images) {
+        const rx = s.x * cw, ry = s.y * chh, rw = s.w * cw, rh = s.h * chh;
+        const { w: iw, h: ih, rgba } = s.img;
+        if (!iw || !ih)
+            continue;
+        for (let yy = 0; yy < rh; yy++)
+            for (let xx = 0; xx < rw; xx++) {
+                const sx = Math.min(iw - 1, Math.floor((xx * iw) / rw)), sy = Math.min(ih - 1, Math.floor((yy * ih) / rh));
+                const si = (sy * iw + sx) * 4;
+                const a = rgba[si + 3] / 255;
+                if (a <= 0)
+                    continue;
+                p.rect(rx + xx, ry + yy, 1, 1, [rgba[si], rgba[si + 1], rgba[si + 2]], a);
+            }
+    }
+    return { w: p.w, h: p.h, rgba: p.rgba };
+}