azeroth-shell 0.2.0 → 0.3.0

package/README.md

@@ -13,7 +13,7 @@ front end. No graphics, no browser, no build step.
 - [Install](#install)
 - [Keys](#keys)
 - [Playing](#playing): [character](#new-character) · [world and autopilot](#world-and-the-autopilot) ·
-  [fights](#fights) · [rotation](#rotation) · [gear](#gear-and-bags) · [vendors, trainers, talents](#vendors-trainers-talents) ·
+  [fights](#fights) · [rotation](#rotation) · [gear](#character-and-bags) · [vendors, trainers, talents](#vendors-trainers-talents) ·
   [professions](#professions) · [companions](#companions) · [dungeons](#dungeons) · [city services](#city-services)
 - [Art and terminals](#art-and-terminals)
 - [Line mode and saves](#line-mode-and-saves)
@@ -23,11 +23,19 @@ front end. No graphics, no browser, no build step.
 ## Install
 
 ```sh
-npx azeroth-shell             # run it straight from npm
+npx azeroth-shell                  # run it straight from npm
 npm install -g azeroth-shell  # or install it once, then:
-azeroth-shell                 # pick a character or roll one (azsh for short)
+azeroth-shell                         # or just azsh
+azeroth-shell --art                 # optional: fetch the full-size art (179 MB) now instead of when asked
 ```
 
+The package is the whole game. The one extra download is the full-size art, which only terminals
+that draw sixel images use. It never comes down on its own: on such a terminal azsh asks first,
+showing the size and the folder, or you fetch it with `--art` (that also works through
+`npx azeroth-shell --art`). It comes from this repo's `art-1` GitHub release, and every file is
+checked against the sha256 in `src/data/hd-art.json` before it is used. You don't need to know
+beforehand whether your terminal draws sixel, because azsh checks that itself.
+
 From a checkout: `npm install -g .` or `node bin/azsh.mjs`.
 
 Needs Node 22.18 or newer (it strips TypeScript types natively). No dependencies. The tree is
@@ -42,7 +50,7 @@ every screen redraws in place.
 
 | Key | Does |
 | --- | --- |
-| `1`-`9` `0`, `Tab`, `Left` `Right` | World, Quests, Bags, Gear, Spells, Rotation, Talents, Travel, Professions, Companions; Character is the last tab (`Tab`/`Left`) |
+| `1`-`9` `0`, `Tab`, `Left` `Right` | World, Quests, Bags, Character, Spells, Rotation, Talents, Travel, Professions, Companions; Settings is the last tab (`Tab`/`Left`) |
 | `Up` `Down` `j` `k` | move the cursor; the right pane describes the row |
 | `Enter` | act on the row: fight, open a quest, talk to a vendor or trainer, equip, cast, travel |
 | `Esc` | close the window on top; on a tab, back to World |
@@ -156,21 +164,24 @@ conditions hold fires.
 | `D` | target dummy: run the rotation against a dummy |
 | `A` | autopilot settings |
 
-### Gear and Bags
+### Character and Bags
 
-**Gear** shows every slot with what you wear. `Enter` on a slot lists everything in your bags (and
+**Character** shows every slot with what you wear, and your health, power, experience, money,
+attributes and combat ratings under the item tooltip; `s` opens the rest (weapon skills,
+professions, auras, home, pet, honor, reputation). `Enter` on a slot lists everything in your bags (and
 in the bank, in a bank town) that fits it, with the stat, armor and damage difference in the detail
 pane; `Enter` there puts it on. The engine's equipment helper scores your bags against what you
 wear: upgrades are listed at the top of the tab and marked `▲` in Bags. From 160 columns the tab is
 a character sheet: you in your gear in the middle, the worn pieces' icons down both sides, Shift+arrows
 walking the slots.
 
-![The Gear tab as a character sheet: a level 60 shaman in raid gear, the slots' icons on both sides, the cursor walking them](media/gear.gif)
+![The Character tab as a sheet: a level 60 shaman in raid gear, the slots' icons on both sides, the cursor walking them](media/gear.gif)
 
 | Key | Does |
 | --- | --- |
 | `Enter` on a slot | list what fits, then `Enter` to equip |
-| `u` (Gear or Bags) | put on every upgrade at once |
+| `s` | your stats, skills, auras, pet, honor and reputation |
+| `u` (Character or Bags) | put on every upgrade at once |
 | `x` | take a piece off |
 | `b` (Bags) | open the bank, in a bank town |
 | `g` (Bags) | open Send goods (see [Professions](#professions)) |
@@ -294,21 +305,41 @@ terminal's own retro effect (Windows Terminal: `"experimental.retroTerminalEffec
 profile; cool-retro-term elsewhere).
 
 At 90 columns or wider the creature you face is drawn beside the fight frames and under its detail
-on the World tab. Your own character, in the gear you wear, stands on the Character tab, on the
+on the World tab. Your own character, in the gear you wear, stands on the Character tab and its stats page, on the
 character picker, at creation and (from 130 columns) on the other side of the fight, and a
 companion's page shows them the same way. It is truecolour half-block art baked from the game's
 models; a terminal without 24-bit colour shows it in the nearest colours it has.
 
 A terminal that draws sixel images (Windows Terminal 1.22+, WezTerm, foot, iTerm2; VS Code with
-`terminal.integrated.enableImages`) gets every creature, every character in their gear and every
+`terminal.integrated.enableImages`) can draw every creature, every character in their gear and every
 icon in real pixels instead. azsh asks the terminal at start.
 
+The Travel tab has the world map under whatever you point at: both continents, a gold pin where you
+stand, a cyan one on the zone under the cursor and the planned route dotted between them, legs by
+sea and air included; on the road the pin walks its leg. It is the same terrain map the browser game
+pans around, as half-block cells or, on a sixel terminal, as pixels. Both of its packs are small enough
+to ship, so the map needs no download. The pane is short on a short terminal, and so is the map:
+give the window forty rows or more and it grows into them.
+
+The full-size art for that is not in the npm package: it is about 179 MB, too much to ship to every
+terminal that cannot draw it. When azsh finds a sixel terminal without it, it offers to download it
+from the project's GitHub release into `~/.azsh/art/`. Each file is checked against a sha256 the
+package carries. Answer "Not now" and it asks again next run; "Never ask" stops the prompt. `azsh --art` fetches it
+from the shell without starting the game. Until the
+art is there, the half-block art stays.
+
+| Command | Does |
+| --- | --- |
+| `:art` | say whether this terminal draws sixel and whether the full-size art is here |
+| `:art download` | fetch the full-size art now (progress on the hint row, the screen redraws when done) |
+
 ![The same hero on the create screen: half-block art on the left, sixel on the right](media/art-compare.png)
 
 | Variable | Does |
 | --- | --- |
 | `AZSH_SIXEL=0` | keep the half-block art |
 | `AZSH_SIXEL=1` | turn sixel on for a terminal that does not say |
+| `AZSH_ART_DIR` | read the full-size art from (and download it to) this folder instead |
 | `AZSH_HOME` | move the save folder (default `~/.azsh`) |
 
 ## Line mode and saves
@@ -368,6 +399,8 @@ npm run data:pack    # gzip the bake after a data refresh; data:unpack reverses
 npm run art:bake     # rebuild src/data/model-art.bin.gz from phonecraft's creature renders (needs ffmpeg)
 npm run art:gear     # rebuild src/data/gear-art.bin.gz from phonecraft's paperdoll bake (needs Python with Pillow)
 npm run art:icons    # rebuild src/data/icon-art.bin.gz from phonecraft's spell and item icons (needs ffmpeg)
+npm run art:map      # rebuild the Travel tab's world map, src/data/world-map.bin.gz and world-map-sixel.bin.br,
+                     # from phonecraft's combined Azeroth terrain map (needs ffmpeg)
 npm run art:hd       # rebuild the full-size art sixel draws: model-art-hd.bin.br, icon-art-hd.bin.br and
                      # gear-art-hd/<body>.bin.br (needs ffmpeg, and Python with Pillow for the gear)
 ```

package/bin/azsh.mjs

@@ -6,8 +6,22 @@ if (major < 22 || (major === 22 && minor < 18)) {
   console.error(`azsh needs Node 22.18 or newer (found ${process.versions.node}).`);
   process.exit(1);
 }
-await import('../src/cli/register.mjs');
 const argv = process.argv.slice(2);
+if (argv.includes('--art')) {
+  // Fetch the full-size art up front instead of waiting for the in-game offer; says what and from where first.
+  const { hdManifest, missingHdBytes, downloadHdArt, downloadDir } = await import('../src/cli/hdArt.mjs');
+  const m = hdManifest(), bytes = missingHdBytes();
+  if (!m) { console.error('This build has no art manifest.'); process.exit(1); }
+  if (!bytes) { console.log(`The full-size art is all here (${downloadDir()}).`); process.exit(0); }
+  console.log(`Fetching ${Math.round(bytes / 1e6)} MB of full-size art (${m.files.length} files, sha256-checked)\n  from ${m.base}\n  into ${downloadDir()}`);
+  const res = await downloadHdArt((done, total) => {
+    if (process.stdout.isTTY) process.stdout.write(`\r  ${Math.round(done / 1e6)} of ${Math.round(total / 1e6)} MB`);
+  });
+  if (process.stdout.isTTY) process.stdout.write('\n');
+  console.log(res.ok ? 'Done. A sixel terminal now draws creatures, characters and icons in real pixels.' : `Stopped: ${res.reason}`);
+  process.exit(res.ok ? 0 : 1);
+}
+await import('../src/cli/register.mjs');
 const wantRepl = argv.includes('--repl') || (!argv.includes('--tui') && (!process.stdin.isTTY || !process.stdout.isTTY));
 if (wantRepl) {
   const { main } = await import('../src/cli/repl.mjs');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "azeroth-shell",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "type": "module",
   "description": "Azeroth shell. A WoW Classic 1.12 text RPG for the terminal, built on CMaNGOS data.",
   "keywords": [
@@ -30,6 +30,8 @@
     "src/",
     "!src/data/*-hd.bin.br",
     "!src/data/gear-art-hd/",
+    "!src/data/*.only.bin.br",
+    "!src/data/gear-art-hd.only/",
     "docs/"
   ],
   "engines": {
@@ -41,9 +43,10 @@
     "check": "node --import ./src/cli/register.mjs src/cli/bootCheck.mjs",
     "data:pack": "node scripts/pack-data.mjs",
     "data:unpack": "node scripts/pack-data.mjs --unpack",
-    "art:bake": "node scripts/bake-model-art.mjs",
+    "art:bake": "node scripts/bake-model-art.mjs && node scripts/bake-model-art.mjs --worn",
     "art:gear": "python scripts/bake-gear-art.py",
     "art:icons": "node scripts/bake-icon-art.mjs",
+    "art:map": "node scripts/bake-world-map.mjs && node scripts/bake-world-map.mjs --sixel",
     "art:hd": "node scripts/bake-model-art.mjs --hd && node scripts/bake-icon-art.mjs --hd && python scripts/bake-gear-art.py --hd",
     "art:publish": "node scripts/publish-hd-art.mjs",
     "build:exe": "node scripts/build-exe.mjs",

package/src/cli/hdArt.mjs

@@ -1,5 +1,5 @@
 // The full-size art sixel draws (sixel.mjs, modelArt.mjs): creature sprites, icons and one gear file per body,
-// about 72 MB, too much to ship to every terminal that cannot draw it. The package carries only the manifest
+// about 179 MB, too much to ship to every terminal that cannot draw it. The package carries only the manifest
 // (src/data/hd-art.json: the release tag, and each file's name, size and sha256); the files are assets of that
 // GitHub release, fetched on request into ~/.azsh/art/<tag>/ and checked against the manifest.
 //

package/src/cli/iconArt.mjs

@@ -8,7 +8,7 @@
 import { readFileSync } from 'node:fs';
 import { gunzipSync } from 'node:zlib';
 import { useColor, vis, wrapLines } from './text.mjs';
-import { sixelIconCells } from './sixel.mjs';
+import { sixelIconCells, sixelOn } from './sixel.mjs';
 
 const PACK_URL = new URL('../data/icon-art.bin.gz', import.meta.url);
 const SIZES = [8, 6, 4];
@@ -94,6 +94,16 @@ export function iconArt(name, cols = 4, tone = '') {
   return iconCells(name, cols, tone)?.map((row) => row.join('')) ?? null;
 }
 
+/**
+ * A one-line icon two cells wide and a space, to lead a line of text in a list (what someone wears, a
+ * quest's rewards). Only where the terminal draws sixel: as half-block cells it would be a smudge of colour,
+ * so there it is ''. A name with no art keeps the column with blanks.
+ */
+export function miniIcon(name) {
+  if (!sixelOn()) return '';
+  return `${iconArt(name, 2)?.[0] ?? '  '} `;
+}
+
 /** A blank the size of an icon, for rows in a list that mixes icons and none. */
 export const iconBlank = (cols = 4) => Array.from({ length: cols / 2 }, () => ' '.repeat(cols));
 

package/src/cli/modelArt.mjs

@@ -175,18 +175,21 @@ const gearHd = new Map(); // slug -> { buf, pal, canvas, skins, overlays } or nu
 export function forgetHdArt() { forgetSixelPacks(); gearHd.clear(); cache.clear(); }
 
 /** A body's hd file (scripts/bake-gear-art.py --hd): its palette, then the body section the small pack has
- *  for it. Read the first time the body is drawn; about 11 MB each once unpacked. */
+ *  for it. Version 1 (a release's 128 px bodies) holds the canvas and each x y w h in a byte, version 2 (256 px,
+ *  past a byte) in a u16. Read the first time the body is drawn. */
 function gearBodyHd(slug) {
   if (gearHd.has(slug)) return gearHd.get(slug);
   let body = null;
   try {
     const buf = brotliDecompressSync(readFileSync(hdArtPath(`gear-art-hd/${slug}.bin.br`)));
-    if (buf.toString('ascii', 0, 7) === 'AZGEARB' && buf[7] === 1) {
+    const version = buf[7];
+    if (buf.toString('ascii', 0, 7) === 'AZGEARB' && (version === 1 || version === 2)) {
       let off = 8;
+      const n = version === 2 ? 2 : 1, num = (o) => (n === 2 ? buf.readUInt16LE(o) : buf[o]);
       const palLen = buf[off++];
       const pal = buf.subarray(off, off + palLen * 3); off += palLen * 3;
       off += 1 + buf[off]; // the slug again
-      const canvas = buf[off++];
+      const canvas = num(off); off += n;
       body = { buf, pal, canvas, skins: new Map(), overlays: new Map() };
       const skinCount = buf[off++];
       for (let i = 0; i < skinCount; i++) { body.skins.set(buf[off], off + 1); off += 1 + canvas * canvas; }
@@ -194,7 +197,7 @@ function gearBodyHd(slug) {
       for (let i = 0; i < ovCount; i++) {
         const keyLen = buf[off++];
         const key = buf.toString('ascii', off, off + keyLen); off += keyLen;
-        const x = buf[off], y = buf[off + 1], w = buf[off + 2], h = buf[off + 3]; off += 4;
+        const x = num(off), y = num(off + n), w = num(off + 2 * n), h = num(off + 3 * n); off += 4 * n;
         body.overlays.set(key, { off, x, y, w, h });
         off += w * h;
       }

package/src/cli/oocPrep.mjs

@@ -0,0 +1,32 @@
+// Out-of-combat prep before a pull: the rotation's buffs phase (armours, Intellect, imbues, conjures, the pet)
+// cast standing still, not on the fight's first ticks. phonecraft autopilotController.ts prepOoc (:889) without
+// its fillMana: the mana the buffs cost stays spent, and the autopilot drinks it back before it pulls.
+import { pickOocAction, useOocPrepItem } from '../autopilot/combatRotation.ts';
+import { maxPower } from '../domain/character/character.ts';
+import { powerType } from '../domain/character/characterStats.ts';
+
+const MAX_PREP_ACTIONS = 8; // each pick is a guarded rule cast once; the cap keeps a refused rule from looping
+
+/** Cast what the buffs phase wants up. Returns the names cast and the mana left as a fraction (1 for non-mana). */
+export function prepOoc(g, ds) {
+  const cast = [];
+  for (let i = 0; i < MAX_PREP_ACTIONS; i++) {
+    const action = pickOocAction(g.rotation(), g.state, ds);
+    if (!action) break;
+    if (action.kind === 'spell') {
+      if (!g.castOutOfCombat(action.spellId).ok) break;
+      cast.push(ds.spell(action.spellId)?.name ?? `spell ${action.spellId}`);
+    } else if (action.kind === 'item') {
+      if (!useOocPrepItem(g, action)) break;
+      cast.push(ds.item(action.itemEntry)?.name ?? `item ${action.itemEntry}`);
+    } else break;
+  }
+  const ch = g.state.char;
+  const max = powerType(ch) === 'mana' ? maxPower(ch, ds) : 0;
+  return { cast: [...new Set(cast)], manaPct: max > 0 ? ch.power / max : 1 };
+}
+
+/** The log line for a prep that cast something, or null. */
+export function prepText(prep) {
+  return prep.cast.length ? `Buffed up: ${prep.cast.join(', ')}` : null;
+}

package/src/cli/repl.mjs

@@ -17,6 +17,7 @@ import { planStep, noteQuestDefeat } from '../autopilot/plan.ts';
 
 // Deaths on one quest before world questing gives up on it and moves to the next.
 const QUEST_SKIP_DEFEATS = 2;
+import { prepOoc, prepText } from './oocPrep.mjs';
 import { pullOpts, squadLogNames, squadModeOf, setSquadMode, SQUAD_MODE_LABEL, SQUAD_MODE_WORDS, COMPANION_HINT_LINES } from './squad.mjs';
 
 const useColor = stdout.isTTY && !process.env.NO_COLOR;
@@ -264,6 +265,8 @@ export function createCommands({ g, ds, out, persist, slot, arrive, skipJourney
 
   /** g.fight with the squad when the squad mode says so; the log names the companions. */
   const quickFight = (entry) => {
+    const buffed = prepText(prepOoc(g, ds));
+    if (buffed) out(dim(`  ${buffed}`));
     const opts = pullOpts(g, ds, buffPace, entry, (l) => out(dim(`  ${l}`)));
     const r = g.fight(entry, opts);
     return { r, logNames: opts ? squadLogNames(g, entry, names()) : names() };
@@ -603,6 +606,7 @@ export function createCommands({ g, ds, out, persist, slot, arrive, skipJourney
     let done = false;
     let lastKind = null;
     let lastQuest = null; // the quest the latest step worked on, blamed when the planner gives up
+    let restedForBuffs = false; // the pull's buffs already sent the run to rest once
     let stopReason = null; // why the run ended: the planner's stop step, or 'steps' when the step budget ran out
     const skipped = [];
     const inLog = (entry) => g.state.questlog.quests.some((qs) => qs.entry === entry && qs.status !== 'turnedIn');
@@ -653,6 +657,18 @@ export function createCommands({ g, ds, out, persist, slot, arrive, skipJourney
         switch (step.kind) {
           case 'fight': {
             const c = ds.creature(step.creatureEntry);
+            // Buff before the pull, then drink back what the buffs cost: casting them on the fight's first ticks
+            // sent a mage in at three quarters of its bar. Once per pull, so a buff that falls off while it
+            // drinks is recast without another rest.
+            const prep = prepOoc(g, ds);
+            const buffed = prepText(prep);
+            if (buffed && !restedForBuffs && cfg.restMode === 'eat-then-wait' && prep.manaPct < cfg.recoverToPct) {
+              restedForBuffs = true; prog.recovering = true; lastKind = 'buff';
+              line = `${buffed}  ${dim('rest before the pull')}`;
+              break;
+            }
+            restedForBuffs = false;
+            if (buffed) out(`${dim(String(i).padStart(3) + '.')} ${buffed}`);
             if (liveFight) {
               const started = liveFight(step, (r) => settle(r, step));
               if (!started.ok) { sets.blockedFights.add(step.creatureEntry); line = red(`fight ${c?.name}: ${started.reason}`); }

package/src/cli/sixel.mjs

@@ -9,8 +9,9 @@
 //
 // The pixels come from model-art-hd.bin.br (scripts/bake-model-art.mjs --hd): the same sprites as the
 // half-block pack at the renders' own size, up to 128 px wide; icons from icon-art-hd.bin.br. Neither ships in
-// the package: hdArt.mjs finds them (downloaded, or a checkout's bake). No pack, no sprite, or no sixel: null,
-// and the caller draws the half-block art. AZSH_SIXEL=0 turns it off, AZSH_SIXEL=1 on without asking.
+// the package: hdArt.mjs finds them (downloaded, or a checkout's bake). model-art-worn.bin.br does ship: the
+// forms and costumes a player wears, read for any sprite the hd pack lacks. No pack, no sprite, or no sixel:
+// null, and the caller draws the half-block art. AZSH_SIXEL=0 turns it off, AZSH_SIXEL=1 on without asking.
 import { readFileSync } from 'node:fs';
 import { brotliDecompressSync } from 'node:zlib';
 import { useColor } from './text.mjs';
@@ -36,35 +37,46 @@ export function noteDeviceAttributes(params) {
 export function noteCellSize(h, w) {
   if (h > 0 && w > 0) { cellH = h; cellW = w; }
 }
+/** The cell in pixels, { w, h }: what a caller fitting its own picture to a pane sizes by. */
+export const cellSize = () => ({ w: cellW, h: cellH });
 
 // ---- the source images ------------------------------------------------------------------------------
 
-let index = null; // displayId -> byte offset of the sprite in `pack` (the half-block pack's layout, AZART v1)
-let pack = null;
+const WORN_URL = new URL('../data/model-art-worn.bin.br', import.meta.url);
+let index = null; // displayId -> { pack, off }: the sprite's bytes (the half-block pack's layout, AZART v1)
 
-function load() {
-  if (index) return index;
-  index = new Map();
+/** Index one pack's sprites; an id already indexed keeps the pack it came from. */
+function indexPack(file) {
   try {
-    pack = brotliDecompressSync(readFileSync(hdArtPath('model-art-hd.bin.br')));
-    if (pack.toString('ascii', 0, 5) !== 'AZART' || pack[5] !== 1) return index;
+    const pack = brotliDecompressSync(readFileSync(file));
+    if (pack.toString('ascii', 0, 5) !== 'AZART' || pack[5] !== 1) return;
     const count = pack.readUInt32LE(6);
     let off = 10;
     for (let i = 0; i < count && off + 7 <= pack.length; i++) {
-      index.set(pack.readUInt32LE(off), off);
+      const id = pack.readUInt32LE(off);
+      if (!index.has(id)) index.set(id, { pack, off });
       off += 7 + pack[off + 6] * 3 + pack[off + 4] * pack[off + 5];
     }
-  } catch { pack = null; }
+  } catch { /* no pack: its sprites draw half-block */ }
+}
+
+function load() {
+  if (index) return index;
+  index = new Map();
+  const hd = hdArtPath('model-art-hd.bin.br');
+  if (hd) indexPack(hd);
+  indexPack(WORN_URL);
   return index;
 }
 
 /** Forget the packs (and what was missing) so the next draw reads them again: after a download. */
-export function forgetSixelPacks() { index = pack = iconIndex = iconPack = null; images.clear(); byKey.clear(); }
+export function forgetSixelPacks() { index = iconIndex = iconPack = null; images.clear(); byKey.clear(); }
 
 /** The sprite for a display id as { w, h, rgba } (already cropped to its opaque box), or null. */
 function sourceOf(displayId) {
-  const off = load().get(displayId);
-  if (off == null) return null;
+  const at = load().get(displayId);
+  if (!at) return null;
+  const { pack, off } = at;
   const w = pack[off + 4], h = pack[off + 5], palLen = pack[off + 6], pal = off + 7, idx = pal + palLen * 3;
   const rgba = new Uint8Array(w * h * 4);
   for (let i = 0; i < w * h; i++) {

package/src/cli/text.mjs

@@ -1,6 +1,7 @@
 // Text helpers shared by the line REPL and the windowed TUI: quest text codes, wrapping, fuzzy
 // picking, ANSI colour and visible-width maths. Nothing here touches game state.
 import { className, raceName } from '../domain/core/ids.ts';
+import { coinParts, moneyText } from '../domain/economy/money.ts';
 
 export const useColor = !process.env.NO_COLOR;
 // A reset inside the painted text (a coloured item name in a green sentence) re-opens this paint,
@@ -25,6 +26,21 @@ export function qualityPaint(quality) { return QUALITY_PAINT[quality ?? 1] ?? wh
 /** An item record's name in its quality colour; `fallback` when the record is missing. */
 export function itemText(it, fallback = 'item') { return qualityPaint(it?.quality)(it?.name ?? fallback); }
 
+// The client's coin colours. A count is followed by its coin, as the money frame draws it: 1● 20● 5●.
+const COIN_RGB = { g: [255, 210, 0], s: [205, 205, 215], c: [205, 120, 55] };
+const COIN = Object.fromEntries(Object.entries(COIN_RGB).map(([k, [r, g, b]]) => [k, `\x1b[38;2;${r};${g};${b}m●\x1b[0m`]));
+/** One coin, 'g', 's' or 'c', for a count written by hand; the letter without colour. */
+export const coin = (k) => (useColor ? COIN[k] : k);
+/** Copper as counts and coins (gold, silver, copper in their colours), an empty copper left off after a
+ *  bigger coin as the client does; `zero` stands in for nothing when given ('free'). Without colour the
+ *  letters: 1g 20s 5c. The counts take whatever paint is round them. */
+export function coinText(copper, zero) {
+  if (zero != null && !(copper > 0)) return zero;
+  if (!useColor) return moneyText(copper);
+  const parts = coinParts(copper);
+  return parts.filter((p, i) => p.n || i === 0).map((p) => `${p.n}${COIN[p.k]}`).join(' ');
+}
+
 const GENDER_TOKEN = /\$[Gg]\s*([^:]*):([^;]*);/g;
 /** $N name, $C class, $R race, $B break, $G male:female; (SharedDefines.h:26). Same codes as phonecraft questText. */
 export function questText(raw, ch) {

package/src/cli/tui.mjs

@@ -24,7 +24,7 @@ import { honorDialog, weeklyHonorPass } from './tuiHonor.mjs';
 import { devCommand } from './tuiDev.mjs';
 import { savePicker } from './tuiSaves.mjs';
 import { wikiDialog } from './tuiWiki.mjs';
-import { bold, dim, cyan, yellow, green, red, inverse, fit, vis, cut, bar, pct, brightYellow, magenta, brightBlue, strip, qualityPaint } from './text.mjs';
+import { bold, dim, cyan, yellow, green, red, inverse, fit, vis, cut, bar, pct, brightYellow, magenta, brightBlue, strip, qualityPaint, coinText } from './text.mjs';
 import { iconsOn, iconArt, iconBlank, wrapIconLines } from './iconArt.mjs';
 import { createGame } from '../engine/game.ts';
 import { toSave } from '../persistence/saveShape.ts';
@@ -33,7 +33,7 @@ import { characterCreation } from './tuiCreate.mjs';
 import { missingHdBytes, downloadHdArt, downloadDir } from './hdArt.mjs';
 import { forgetHdArt } from './modelArt.mjs';
 import { sixelOn } from './sixel.mjs';
-import { moneyText, coinsText } from '../domain/economy/money.ts';
+import { coinsText } from '../domain/economy/money.ts';
 import { maxHealth, maxPower } from '../domain/character/character.ts';
 import { powerType } from '../domain/character/characterStats.ts';
 import { addItem } from '../domain/items/inventory.ts';
@@ -55,6 +55,7 @@ const HELP_LINES = [
   '                           a in the search (or S on World) widens it to the whole world. Enter goes or opens.',
   '  z                        sit and rest 30 s       ?               this help',
   '  Ctrl-C / :quit           save and leave          Ctrl-L          repaint a garbled screen',
+  '  c (World tab) / :logout  save and go back to the character list',
   '',
   'In the world',
   '  Enter on a creature starts a live fight; f fights it instantly. Enter on a quest, vendor, trainer or',
@@ -75,22 +76,23 @@ const HELP_LINES = [
   '  W walks the floor instead: pick a place, the party walks the nav mesh, patrols walk, and what sees you pulls.',
   '',
   'Gear and bags',
-  '  Gear tab: Enter on a slot lists everything in your bags (and the bank, in a bank town) that fits it.',
+  '  Character tab: your gear around you. Enter on a slot lists everything in your bags (and the bank, in a bank town) that fits it.',
+  '  Your stats sit under the tooltip; s opens the rest: weapon skills, professions, auras, home, pet, honor, reputation.',
   '  ▲ marks an upgrade the equipment helper found; u puts on every upgrade at once, x takes a piece off.',
   '  r repairs one piece, R everything; o opens the Outfitter (gear sets). :outfit <name> wears a set from anywhere.',
-  '  In a big enough window the Gear tab is a character sheet (the Talents tab the three trees): Up and Down walk the icons in order, Shift+arrows move across them.',
+  '  In a big enough window the Character tab is a paperdoll (the Talents tab the three trees): Up and Down walk the icons in order, Shift+arrows move across them.',
   '  Bags tab: Enter uses, equips, opens, unwraps or learns; m lists every verb for the stack. s sells to the open',
   '  vendor, j sells junk, b opens the bank, d destroys, S sorts, / splits a stack, [ ] move it, A uses the whole stack.',
   '  D lists every green, blue or epic the group can disenchant; L lists every book someone can learn. G runs it.',
   '  :dev item|quest|recipe|prof skips the rules (testing). New character offers a random world bot.',
-  '  :settings sets auto-loot, the upgrade helper, auto-disenchant, the junk rules and which nodes get gathered.',
+  '  Settings tab (or :settings) sets auto-loot, the upgrade helper, auto-disenchant, the junk rules and which nodes get gathered.',
   '  Spells tab: b edits your action bars, m your macros. :macro <name> runs one; a macro on bar 1 fires by its key in a fight.',
   '  Loot: with :autoloot off a corpse opens the loot window. Enter takes a row, a takes all, Esc leaves the rest.',
   '',
   'In a fight',
   '  1-9 press an ability    a toggle auto-play    space pause    + - speed    l log    Esc run away',
   '  t gives a companion an order: attack a target, cast one ability, or hold ground (the fight waits).',
-  '  c cancels one of your buffs (also from the Character tab, out of a fight).',
+  '  c cancels one of your buffs (also from s on the Character tab, out of a fight).',
   '  r (in a fight you started with Enter) fights the same creature again after each win, until r again or Esc.',
   '  The ability bar runs along the bottom of the stage with its cooldowns; a takes the keys off the rotation.',
   '',
@@ -239,6 +241,22 @@ export class App {
     this.onQuit?.();
   }
 
+  /** Save, let go of the character and go back to the character picker. Not in the middle of a fight or a run. */
+  async logout() {
+    if (!this.g) return;
+    if (this.fight || this.auto) { this.flashMsg('Finish the fight or stop the run first.'); this.render(); return; }
+    for (const t of this.timers) this.term.clearInterval(t);
+    this.timers = [];
+    await this.persist();
+    if (this.slot != null) this.repo.unlock?.(this.slot);
+    this.say(dim(`Saved ${this.g.state.char.name}.`));
+    this.g = null; this.slot = null; this.cmds = null; this.vendor = null;
+    this.tabs = []; this.tab = 0; this.stack = [];
+    this.meter = null; this.lootTally = null; this.lastActivity = null;
+    await this.toPicker?.();
+    this.render();
+  }
+
   // ---- small helpers the views lean on -------------------------------------------------------------
 
   get ch() { return this.g.state.char; }
@@ -291,7 +309,7 @@ export class App {
   pick(title, options, onPick, { hint, keepOpen } = {}) {
     const view = {
       id: 'pick', title, hint: hint ?? 'Enter: choose   Esc: back',
-      rows: () => options.map((o) => ({ text: o.label, data: o.value, detail: o.detail ? () => (typeof o.detail === 'function' ? o.detail() : o.detail) : undefined, act: () => { if (!keepOpen) this.pop(); onPick(o.value, o); } })),
+      rows: () => options.map((o) => ({ text: o.label, icon: o.icon, sub: o.sub, data: o.value, detail: o.detail ? () => (typeof o.detail === 'function' ? o.detail() : o.detail) : undefined, act: () => { if (!keepOpen) this.pop(); onPick(o.value, o); } })),
       noDetail: !options.some((o) => o.detail),
     };
     this.push(view);
@@ -502,6 +520,7 @@ export class App {
     const [, cmd = '', args = ''] = line.match(/^(\S+)\s*(.*)$/) ?? [];
     const c = cmd.toLowerCase();
     if (c === 'quit' || c === 'exit' || c === 'q') { await this.quit(); return; }
+    if (c === 'logout' || c === 'characters') { await this.logout(); return; }
     if (c === 'auto') { const m = args.match(/^(\d+)?\s*(?:farm\s+(.+))?$/i); startAutopilot(this, m?.[1] ? Number(m[1]) : Infinity, m?.[2]); return; }
     if (c === 'art') {
       const missing = missingHdBytes();
@@ -610,7 +629,7 @@ export class App {
     const dead = this.isDead() ? red(bold('  DEAD')) : ch.mountedItem != null ? dim('  mounted') : '';
     const title = ` ${bold(ch.name)} ${dim(`L${ch.level} ${raceName(ch.race)} ${className(ch.cls)}`)}${dead}`;
     const road = journeyHeader(this);
-    const right = `${road ? yellow(road) : cyan(z?.name ?? ch.zoneId)}  ${yellow(moneyText(ch.gold) || '0c')} `;
+    const right = `${road ? yellow(road) : cyan(z?.name ?? ch.zoneId)}  ${coinText(ch.gold)} `;
     const l0 = fit(title, L.W - vis(right)) + right;
     // In a fight the bars follow the live session, so the header is the player's frame and no panel needs another.
     const live = this.fight?.session?.playerView?.() ?? null;
@@ -690,7 +709,11 @@ export class App {
     if (showDetail) {
       const d = cursorRow?.detail?.(this, cursorRow) ?? view.detail?.(this, cursorRow) ?? [];
       detailLines = wrapIconLines(d, L.detailW - 2);
-      if (detailLines.length > L.mainH) detailLines = detailLines.slice(0, L.mainH - 1).concat(dim('…'));
+      // A view's foot (the Character tab's stats) sits at the bottom of the pane when the tooltip keeps room above it.
+      const foot = view.detailFoot ? wrapIconLines(view.detailFoot(this, L.detailW - 2), L.detailW - 2) : [];
+      const room = foot.length && L.mainH - foot.length >= 16 ? L.mainH - foot.length - 1 : L.mainH;
+      if (detailLines.length > room) detailLines = detailLines.slice(0, room - 1).concat(dim('…'));
+      if (room < L.mainH) detailLines = [...detailLines, ...Array(L.mainH - foot.length - detailLines.length).fill(''), ...foot];
     }
     for (let i = 0; i < L.mainH; i++) {
       const left = fit(listLines[i] ?? '', listW);
@@ -766,6 +789,7 @@ export async function runTui({ term = new RealTerm(), argv = [] } = {}) {
     app.render();
   };
   const reopenPicker = () => savePicker(app, { onPlay: (save) => { void begin(save); }, onNew: createFlow });
+  app.toPicker = reopenPicker;
   const createFlow = () => characterCreation(app, (state) => {
     app.stack = [];
     app.startGame(state, `${state.char.name.toLowerCase()}-${Date.now().toString(36)}`, Date.now(), true);

package/src/cli/tuiAutopilot.mjs

@@ -2,12 +2,12 @@
 // you browse, the run panel between fights (now, next, quests, this run's numbers, what stops it), the Run
 // pane at the bottom (one row per planner step) and the end card. The run itself is the controller in
 // tuiFight.mjs (startAutopilot); the planner is repl.mjs createAutopilot. Everything here only reads.
-import { bold, dim, cyan, yellow, green, red, magenta, inverse, fit, vis, cut, bar, strip, pct, secondsText, wrapLines } from './text.mjs';
+import { bold, dim, cyan, yellow, green, red, magenta, inverse, fit, vis, cut, bar, strip, pct, secondsText, wrapLines, coinText } from './text.mjs';
 import { idlePlayerFrame, startAutopilot, fightArt, flankArt } from './tuiFight.mjs';
 import { objectiveLines, questDialog } from './tuiViews.mjs';
 import { autopilotSettingsDialog } from './tuiAutopilotSettings.mjs';
 import { squadModeOf } from './squad.mjs';
-import { moneyText } from '../domain/economy/money.ts';
+import { iconsOn, iconArt, iconBlank } from './iconArt.mjs';
 import { maxHealth, maxPower } from '../domain/character/character.ts';
 
 const H = (text) => ({ text, header: true, plain: true });
@@ -15,7 +15,7 @@ const H = (text) => ({ text, header: true, plain: true });
 const wrapRows = (lead, text, W) => wrapLines(text, Math.max(20, W - 13)).map((l, i) => H(`${i ? ' '.repeat(11) : lead}${l}`));
 const num = (n) => Math.round(n).toLocaleString('en-US');
 const clock = (ms) => { const s = Math.max(0, Math.floor(ms / 1000)); return `${Math.floor(s / 60)}:${String(s % 60).padStart(2, '0')}`; };
-const signedMoney = (copper) => (copper < 0 ? `-${moneyText(-copper)}` : `+${moneyText(copper) || '0c'}`);
+const signedMoney = (copper) => (copper < 0 ? `-${coinText(-copper)}` : `+${coinText(copper)}`);
 
 /** "questing in Redridge Mountains", "farming Redridge Mystic in …", "doing A Baying of Gnolls". */
 export function runWhat(app, ctl) {
@@ -149,14 +149,23 @@ export function bagsPaneLines(app, L) {
   const items = rows.map((r, i) => i).filter((i) => !rows[i].header);
   if (!items.length) return [` ${bold('Bags')}`, dim(' Nothing in your bags.')];
   if (!items.includes(st.cursor)) st.cursor = items.find((i) => i >= st.cursor) ?? items[items.length - 1];
-  const room = L.logH - 1;
+  // With icons a row is two lines like the Bags tab's list: the icon down the left, the name beside the top
+  // and the row's kind and price beside the bottom.
+  const icons = iconsOn() && L.W >= 40;
+  const room = Math.floor((L.logH - 1) / (icons ? 2 : 1));
   const at = items.indexOf(st.cursor);
   const start = Math.max(0, Math.min(at - Math.floor(room / 2), items.length - room));
   const lines = [` ${bold('Bags')}   ${dim('Up Down: pick   Enter: use, equip, open   the run plays on')}`];
   for (const i of items.slice(start, start + room)) {
-    const r = rows[i];
-    const text = fit(i === st.cursor ? `▶ ${r.text}` : `  ${r.text}`, L.W - 1);
-    lines.push(i === st.cursor ? inverse(text) : ` ${text}`);
+    const r = rows[i], sel = i === st.cursor;
+    if (icons) {
+      const art = iconArt(r.icon, 4) ?? iconBlank(4);
+      const t1 = fit(` ${r.text}`, L.W - 6), t2 = fit(` ${r.sub ?? ''}`, L.W - 6);
+      lines.push(`${sel ? '▶' : ' '}${art[0]}${sel ? inverse(t1) : t1}`, ` ${art[1]}${sel ? inverse(t2) : t2}`);
+      continue;
+    }
+    const text = fit(sel ? `▶ ${r.text}` : `  ${r.text}`, L.W - 1);
+    lines.push(sel ? inverse(text) : ` ${text}`);
   }
   return lines;
 }
@@ -229,7 +238,7 @@ function runLine(app, ctl) {
 // ---- the Run pane ----------------------------------------------------------------------------------
 
 const GLYPH = {
-  fight: red('⚔'), wait: dim('~'), consume: dim('~'), cannibalize: dim('~'), turnin: green('✓'), accept: green('+'), travel: cyan('→'),
+  fight: red('⚔'), buff: cyan('↑'), wait: dim('~'), consume: dim('~'), cannibalize: dim('~'), turnin: green('✓'), accept: green('+'), travel: cyan('→'),
   gather: yellow('⚒'), skin: yellow('⚒'), buy: yellow('$'), equip: green('▲'), skip: yellow('✗'), dead: red('☠'), stop: yellow('■'),
 };