azeroth-shell 0.0.0-stage → 0.1.0

package/src/cli/tuiHonor.mjs

@@ -0,0 +1,74 @@
+// The Honor window (phonecraft panels/honorPanel.ts): your PvP rank and title, kills and honor for today,
+// yesterday, this week and last week, honor points, lifetime, when the week's standings are posted, and a City
+// Defender's free capital teleports, and the arena brackets. The weekly pass (rank points from the week's
+// standing) runs on load.
+import { bold, dim, yellow, green, red, cyan } from './text.mjs';
+import { afterDeparture } from './tuiWorld.mjs';
+import { isCityDefender, newHonorState, PVP_RANKS, rankForRp, rankTitle, visualRankDecimal } from '../domain/run/honor.ts';
+import { daysToNextMaintenance, nextMaintenanceDate } from '../domain/run/honorWeek.ts';
+import { factionOf } from '../domain/character/races.ts';
+import { arenaRows, battlegroundRows } from './tuiArena.mjs';
+
+const H = (text) => ({ text, header: true });
+const kv = (label, value, paint = (x) => x) => H(`  ${label.padEnd(20)} ${paint(String(value))}`);
+
+export function honorFaction(app) {
+  return factionOf(app.ds, app.ch.race) === 'horde' ? 'horde' : 'alliance';
+}
+
+/** "Sergeant (Rank 3.4)" or "No rank". */
+export function honorRankLine(app) {
+  const h = app.ch.honor ?? newHonorState();
+  const rank = rankForRp(h.rp);
+  if (!rank) return 'No rank';
+  const tenths = Math.round(visualRankDecimal(h.rp) * 10) / 10;
+  return `${rankTitle(rank, honorFaction(app))} (Rank ${tenths > 0 && !Number.isInteger(tenths) ? tenths.toFixed(1) : rank.rank})`;
+}
+
+function postedLine(now = Date.now()) {
+  const days = daysToNextMaintenance(now);
+  const weekday = new Date(`${nextMaintenanceDate(now)}T00:00:00`).toLocaleDateString('en-US', { weekday: 'long' });
+  return days === 1 ? `${weekday} (tomorrow)` : `${weekday} (in ${days} days)`;
+}
+
+/** Run the week's standings pass(es) the save owes; say so when one ran. */
+export function weeklyHonorPass(app) {
+  const before = app.ch.honor?.rp ?? 0;
+  const n = app.g.runWeeklyHonorPass();
+  if (n > 0) app.say(cyan(`The honor standings are posted${n > 1 ? ` (${n} weeks)` : ''}. ${honorRankLine(app)}`) + dim(`  rank points ${before} → ${app.ch.honor?.rp ?? 0}`));
+  return n;
+}
+
+export function honorDialog(app) {
+  weeklyHonorPass(app);
+  return {
+    id: 'honor', title: 'Honor', hint: '', noDetail: true,
+    rows(a) {
+      const h = a.ch.honor ?? newHonorState();
+      const fac = honorFaction(a);
+      const highest = h.highestRank >= 1 && h.highestRank <= PVP_RANKS.length ? rankTitle(PVP_RANKS[h.highestRank - 1], fac) : 'none';
+      const rows = [H(`${bold(honorRankLine(a))}   ${fac === 'horde' ? red('Horde') : cyan('Alliance')}`)];
+      rows.push(...battlegroundRows(a), ...arenaRows(a));
+      // City Defender (rank 15 standing): the capital teleports cost no rune and no mana.
+      if (isCityDefender(h)) {
+        const ports = a.g.classTravelOptions().filter((t) => t.free);
+        if (ports.length) {
+          rows.push(H(''), H(cyan('Capital teleports')), H(dim('  No reagent, no mana.')));
+          for (const t of ports) {
+            const zone = a.ds.zone(t.toZone)?.name ?? t.toZone;
+            rows.push(t.toZone === a.ch.zoneId ? H(dim(`  ${zone} (you are here)`)) : { text: `  ${zone}`, act: (a2) => { if (a2.result(a2.g.castTeleport(t.spellId))) { afterDeparture(a2, () => `You teleport to ${a2.zone()?.name}.`); a2.switchTab(0); } } });
+          }
+        }
+      }
+      rows.push(
+        H(''), H(cyan('Today')), kv('Honorable kills', h.todayHk, green), kv('Dishonorable kills', h.todayDk, red),
+        H(''), H(cyan('Yesterday')), kv('Honorable kills', h.yesterdayHk, green), kv('Honor', h.yesterdayHonor, yellow),
+        H(''), H(cyan('This week')), kv('Honorable kills', h.thisWeekHk, green), kv('Honor', Math.trunc(h.cp), yellow), kv('Standings posted', postedLine()),
+        H(''), H(cyan('Last week')), kv('Honorable kills', h.lastWeekHk, green), kv('Honor', h.lastWeekHonor, yellow), kv('Standing', h.lastWeekStanding > 0 ? h.lastWeekStanding : '-'),
+        H(''), H(cyan('Honor points')), kv('To spend', h.honorPoints, yellow), kv('Earned all time', h.lifetimeHonorPoints, yellow),
+        H(''), H(cyan('Lifetime')), kv('Honorable kills', h.lifetimeKills, green), kv('Dishonorable kills', h.dishonorableKills, red), kv('Highest rank', highest),
+      );
+      return rows;
+    },
+  };
+}

package/src/cli/tuiLoot.mjs

@@ -0,0 +1,97 @@
+// The loot window (phonecraft's LootFrame): what a corpse, chest or opened container is still holding. The engine
+// keeps the haul in `state.pendingLoot`; Enter takes one row into the bags, a takes everything that fits, Esc
+// closes it (outdoor leftovers are gone then, an opened bag item keeps its remainder). With auto-loot on (the
+// default) fights never hold their loot and this window does not open.
+import { bold, dim, yellow, green, red, qualityPaint } from './text.mjs';
+import { itemLines } from './tuiViews.mjs';
+import { moneyText } from '../domain/economy/money.ts';
+import { formatItemName } from '../domain/items/itemDisplayName.ts';
+import { farmNext } from './tuiFight.mjs';
+import { noteLoot } from './tuiFightPanes.mjs';
+
+const KIND_LABEL = { corpse: 'Corpse', chest: 'Chest', object: 'Object', mining: 'Mining', herbalism: 'Herbs', fishing: 'Fishing', skinning: 'Skinning', container: 'Container' };
+
+export const autoLootOn = (app) => app.prefs.get('autoLoot') !== false;
+
+/** Display name of a held row, with a rolled suffix ("of the Bear") when it carries one. */
+function rowName(app, r) {
+  const it = app.ds.item(r.item);
+  const pid = r.instance?.randomPropertyId;
+  const suffix = pid != null && pid > 0 ? app.ds.itemRandomProperty?.(pid)?.nameSuffix : undefined;
+  return qualityPaint(it?.quality)(formatItemName(it?.name ?? `item ${r.item}`, suffix));
+}
+
+function toggleAutoLoot(app) {
+  const on = !autoLootOn(app);
+  app.prefs.set('autoLoot', on);
+  app.say(dim(on ? 'Auto-loot on: fights put their loot straight into your bags.' : 'Auto-loot off: a corpse opens the loot window and you take what you want.'));
+}
+
+export function takeAll(app) {
+  const r = app.g.takeAllLoot();
+  if (!app.result(r)) return;
+  noteLoot(app, r.taken, r.copper);
+  for (const t of r.taken) app.say(`  ${yellow('You receive')} ${app.itemLabel(t.item)}${t.count > 1 ? ` x${t.count}` : ''}`);
+  if (r.copper) app.say(`  ${yellow('You loot')} ${moneyText(r.copper)}`);
+  if (r.remaining) app.say(red(`  ${r.remaining} left in there: your bags are full.`));
+  if (r.emptied && app.top()?.id === 'loot') app.pop();
+}
+
+/** Open the window over whatever is on screen, when something is held. */
+export function openLoot(app) {
+  if (!app.g.pendingLoot()) return false;
+  if (app.top()?.id === 'loot') return true;
+  app.push(lootDialog(app));
+  return true;
+}
+
+export function lootDialog(app) {
+  const first = app.g.pendingLoot();
+  return {
+    id: 'loot', title: `Loot: ${first?.title ?? 'nothing'}`, hint: 'Enter: take',
+    keys: {
+      a: { hint: 'take all', fn: (a) => takeAll(a) },
+      o: { hint: 'auto-loot', fn: (a) => toggleAutoLoot(a) },
+    },
+    onClose(a) {
+      const left = a.g.pendingLoot();
+      if (!left) { queueMicrotask(() => farmNext(a)); return; }
+      const n = left.rows.length + (left.copper > 0 ? 1 : 0);
+      a.g.closeLoot();
+      if (left.kind === 'container') a.say(dim(`You close ${left.title}. What is left stays inside.`));
+      else a.say(dim(`You leave ${n === 1 ? 'one thing' : `${n} things`} on ${left.title}.`));
+      // A repeating fight waits for the loot window; closing it starts the next pull.
+      queueMicrotask(() => farmNext(a));
+    },
+    rows(a) {
+      const L = a.g.pendingLoot();
+      if (!L) return [{ text: dim('Nothing left.'), header: true }];
+      const rows = [{ text: `${KIND_LABEL[L.kind] ?? L.kind}: ${L.title}`, header: true }];
+      if (L.copper > 0) {
+        rows.push({
+          text: yellow(moneyText(L.copper)),
+          detail: () => [bold('Money'), moneyText(L.copper)],
+          act: (a2) => { const r = a2.g.takeLootMoney(); if (a2.result(r)) { noteLoot(a2, [], r.copper); a2.say(`  ${yellow('You loot')} ${moneyText(r.copper)}`); if (r.emptied) a2.pop(); } },
+        });
+      }
+      L.rows.forEach((r, i) => {
+        rows.push({
+          text: `${rowName(a, r)}${r.count > 1 ? ` x${r.count}` : ''}${r.blocked ? red('  bags full') : ''}`,
+          detail: () => itemLines(a, a.ds.item(r.item), r.blocked ? ['', red('No room in your bags for this.')] : []),
+          act: (a2) => {
+            const res = a2.g.takeLoot(i);
+            if (!a2.result(res)) return;
+            noteLoot(a2, [{ item: res.item, count: res.count }]);
+            const where = res.mailed ? dim(' (mailed: bags full)') : res.sold ? dim(' (sold)') : res.destroyed ? dim(' (destroyed)') : '';
+            a2.say(`  ${yellow('You receive')} ${a2.itemLabel(res.item)}${res.count > 1 ? ` x${res.count}` : ''}${where}`);
+            if (res.emptied) a2.pop();
+          },
+        });
+      });
+      rows.push({ text: '', header: true });
+      rows.push({ text: green('Take all'), act: (a2) => takeAll(a2) });
+      rows.push({ text: `Auto-loot: ${autoLootOn(a) ? green('on') : dim('off')}  ${dim('(next time)')}`, act: (a2) => toggleAutoLoot(a2) });
+      return rows;
+    },
+  };
+}

package/src/cli/tuiMacros.mjs

@@ -0,0 +1,144 @@
+// Macros (phonecraft's MacroFrame): your own and account-wide macros, a line-by-line editor, the template list,
+// and a run out of combat through the world host. In a fight a macro on bar 1 fires through the combat host
+// (tuiFight.mjs), so both go through the same planner (domain/macro) and the same calls a key press makes.
+import { bold, dim, yellow, green, red, cyan } from './text.mjs';
+import { createWorldMacroHost } from './macroHostWorld.ts';
+import { castWithPicker, useItemWithPicker } from './tuiEnchantTarget.mjs';
+import { filterMacroTemplates, macroTemplateNest, macroTemplateCompat, uniqueMacroName, MACROS_PER_SCOPE, macroScopeOf, parseMacroBody, describeMacroLineText } from '../domain/macro/index.ts';
+
+const H = (text) => ({ text, header: true });
+const SCOPE_LABEL = { character: 'This character', account: 'Every character' };
+
+/** The world host for this game: casts, uses and equips through the same facade calls the screens use. */
+export function worldMacroHost(app) {
+  app.macroWorldHost ??= new WeakMap();
+  let host = app.macroWorldHost.get(app.g);
+  if (host) return host;
+  host = createWorldMacroHost({
+    game: app.g, ds: app.ds, now: () => Date.now(),
+    mods: () => ({ shift: false, ctrl: false, alt: false }),
+    // A weapon imbue or an armor kit may open the slot picker; the step counts as taken while it is open.
+    castSpell: (id) => castWithPicker(app, id) !== false,
+    useItem: (entry) => useItemWithPicker(app, entry, () => green(`You use ${app.itemLabel(entry)}.`)) !== false,
+    equipItem: (entry, offhand) => app.result(app.g.equip(entry, offhand ? 'offhand' : undefined), `You equip ${app.itemLabel(entry)}.`),
+    notify: (m) => app.say(yellow(m)),
+  });
+  app.macroWorldHost.set(app.g, host);
+  return host;
+}
+
+export function runMacro(app, def) {
+  app.say(cyan(`> ${def.name}`));
+  if (!worldMacroHost(app).press(def)) app.flashMsg(`${def.name} did nothing.`);
+}
+
+/** What pressing it now would do, line by line, for the detail pane. */
+function planLines(app, def) {
+  const plan = worldMacroHost(app).plan(def);
+  const out = [];
+  for (const st of plan.steps) {
+    if (st.kind === 'cast') out.push(green(`casts ${app.ds.spell(st.spellId)?.name ?? st.spellId}`));
+    else if (st.kind === 'use') out.push(green(`uses ${app.itemLabel(st.entry)}`));
+    else if (st.kind === 'equip') out.push(green(`equips ${app.itemLabel(st.entry)}${st.offhand ? ' in the off hand' : ''}`));
+    else out.push(dim(`/${st.kind}${st.name ? ` ${st.name}` : ''}`));
+  }
+  for (const r of plan.refusals) out.push(red(r));
+  return out.length ? out : [dim('nothing right now')];
+}
+
+function save(app, scope, def, changes) {
+  const r = app.g.saveMacro(scope, { id: def?.id, name: def?.name ?? 'Macro', icon: def?.icon, body: def?.body ?? '', ...changes });
+  app.result(r);
+  return r.ok ? r.id : null;
+}
+
+export function macrosDialog(app) {
+  const withMacro = (fn) => (a, row) => { if (row?.data?.macro) fn(a, row.data.macro); };
+  return {
+    id: 'macros', title: 'Macros', hint: 'Enter: edit',
+    keys: {
+      r: { hint: 'run', fn: withMacro((a, m) => runMacro(a, m)) },
+      T: { hint: 'templates', fn: (a) => pickTemplate(a, 'character') },
+      x: { hint: 'delete', fn: withMacro((a, m) => a.confirm(`Delete the macro ${m.name}? It comes off every bar.`, () => a.result(a.g.deleteMacro(m.id), `${m.name} deleted.`))) },
+    },
+    rows(a) {
+      const rows = [];
+      for (const scope of ['character', 'account']) {
+        const list = a.g.macros(scope);
+        rows.push(H(''), H(`${SCOPE_LABEL[scope]}  ${dim(`${list.length}/${MACROS_PER_SCOPE}`)}`));
+        for (const m of list) {
+          const first = m.body.split('\n').find((l) => l.trim() && !l.startsWith('#')) ?? '';
+          rows.push({
+            text: `${bold(m.name)}  ${dim(first)}`, data: { macro: m },
+            detail: () => [bold(m.name), dim(SCOPE_LABEL[macroScopeOf(m.id)] ?? ''), '', ...m.body.split('\n').map((l) => cyan(l)), '', bold('Pressed now'), ...planLines(a, m), '', dim('Enter: edit   r: run   x: delete')],
+            act: (a2) => a2.push(macroEditor(a2, m.id)),
+          });
+        }
+        rows.push({ text: green(`+ New ${scope === 'account' ? 'account ' : ''}macro`), act: (a2) => a2.prompt('Name: ', (name) => { const id = save(a2, scope, null, { name, body: '' }); if (id) a2.push(macroEditor(a2, id)); else a2.afterAction(); }) });
+      }
+      rows.shift();
+      rows.push(H(''), { text: `Templates  ${dim('ready-made macros for your class (T)')}`, act: (a2) => pickTemplate(a2, 'character') });
+      rows.push(H(''), H(dim('Put a macro on bar 1 (Spells tab, b) and its key fires it in a fight.')));
+      return rows;
+    },
+  };
+}
+
+function pickTemplate(app, scope) {
+  const list = [...filterMacroTemplates({ scope: 'class', cls: app.ch.cls, tag: null }), ...filterMacroTemplates({ scope: 'general', cls: app.ch.cls, tag: null })];
+  if (!list.length) { app.flashMsg('No templates for your class.'); return; }
+  app.pick('Templates', list.map((t) => ({
+    label: `${t.name}${macroTemplateCompat(t.body).kind === 'manual' ? dim('  manual only') : ''}`,
+    detail: () => [bold(t.name), t.description, '', ...t.body.split('\n').map((l) => cyan(l))],
+    value: t,
+  })), (t) => {
+    const taken = app.g.macros().map((m) => m.name);
+    // A template that calls another ({Name}) brings that one along first so the call resolves.
+    for (const helper of macroTemplateNest(t)) {
+      if (taken.some((n) => n.toLowerCase() === helper.name.toLowerCase())) continue;
+      if (!save(app, scope, null, { name: helper.name, icon: helper.icon, body: helper.body })) return;
+      taken.push(helper.name);
+    }
+    const id = save(app, scope, null, { name: uniqueMacroName(t.name, taken), icon: t.icon, body: t.body });
+    if (id) { app.say(green(`Added ${t.name}.`)); app.push(macroEditor(app, id)); }
+  });
+}
+
+/** One macro, a line per row: Enter edits a line, o adds one under it, x deletes it, n renames. */
+export function macroEditor(app, id) {
+  const def = () => app.g.macroById(id);
+  const scope = macroScopeOf(id) ?? 'character';
+  const setLines = (a, lines) => save(a, scope, def(), { body: lines.join('\n') });
+  const lines = () => (def()?.body ?? '').split('\n');
+  const addAfter = (a, at) => a.prompt('New line: ', (text) => { const ls = lines().filter((l, i) => l !== '' || i < lines().length - 1); ls.splice(at + 1, 0, text); setLines(a, ls); a.afterAction(); });
+  return {
+    id: 'macro-edit', title: 'Edit macro', hint: 'Enter: edit the line',
+    keys: {
+      o: { hint: 'add a line', fn: (a, row) => addAfter(a, row?.data?.line ?? lines().length - 1) },
+      x: { hint: 'delete the line', fn: (a, row) => { if (row?.data?.line == null) return; const ls = lines(); ls.splice(row.data.line, 1); setLines(a, ls); } },
+      n: { hint: 'rename', fn: (a) => a.prompt('Name: ', (name) => { save(a, scope, def(), { name }); a.afterAction(); }, def()?.name ?? '') },
+      r: { hint: 'run', fn: (a) => { if (def()) runMacro(a, def()); } },
+    },
+    rows(a) {
+      const m = def();
+      if (!m) return [H(dim('That macro is gone.'))];
+      const rows = [H(`${bold(m.name)}   ${dim(SCOPE_LABEL[scope])}`), H('')];
+      const ls = m.body ? m.body.split('\n') : [];
+      const parsed = parseMacroBody(m.body ?? '');
+      ls.forEach((l, i) => {
+        const pl = parsed.lines.find((x) => x.n === i + 1);
+        const issue = parsed.issues.find((x) => x.line === i + 1);
+        rows.push({
+          text: `${dim(String(i + 1).padStart(2))} ${cyan(l || ' ')}${issue ? red('  ✗') : ''}`, data: { line: i },
+          detail: () => [bold(`Line ${i + 1}`), l, '', ...(pl ? [describeMacroLineText(pl)] : []), ...(issue ? [red(issue.message)] : []), '', dim('Enter: edit   o: add a line under it   x: delete')],
+          act: (a2) => a2.prompt('Line: ', (text) => { const cur = lines(); cur[i] = text; setLines(a2, cur); a2.afterAction(); }, l),
+        });
+      });
+      rows.push({ text: green('+ Add a line'), act: (a2) => addAfter(a2, ls.length - 1) });
+      rows.push(H(''), H(bold('Pressed now, out of a fight')));
+      for (const l of planLines(a, m)) rows.push(H(`  ${l}`));
+      rows.push(H(''), { text: green('Run it'), act: (a2) => runMacro(a2, def()) });
+      return rows;
+    },
+  };
+}

package/src/cli/tuiOutfitter.mjs

@@ -0,0 +1,115 @@
+// The Outfitter: named gear sets for you and each companion (phonecraft panels/outfitterPanel.ts). Enter wears or
+// takes off a set (sets stack, later ones over earlier ones); e edits which slots a set holds, taken from what is
+// worn right now. n saves what you wear as a new set, N builds one for a stat (fire resist, fishing, spell damage),
+// b rebuilds a stat set from the bags, r renames, x deletes, o switches it off, w changes whose wardrobe this is.
+import { bold, dim, yellow, green, red, cyan, qualityPaint, fit } from './text.mjs';
+import { EQUIP_SLOTS, SLOT_LABEL } from '../domain/items/equipment.ts';
+import { OUTFIT_CATEGORY_LABEL, OUTFIT_STAT_MENU, outfitsByCategory, outfitMissing, wearingOutfit, findOutfitById } from '../domain/bots/outfitter.ts';
+
+const H = (text) => ({ text, header: true });
+const allOwned = (g) => { const m = new Map(); for (const c of g.state.squad ?? []) m.set(c.id, c); for (const c of Object.values(g.state.botRoster ?? {})) m.set(c.id, c); return [...m.values()]; };
+
+function wearer(app, owner) {
+  if (owner === 'player') return { name: 'You', equipped: app.ch.equipped, bags: app.g.state.inventory, bank: app.g.state.bank };
+  const c = allOwned(app.g).find((x) => x.id === owner);
+  return c ? { name: c.name, equipped: c.equipped ?? {}, bags: c.bags, bank: c.bank } : null;
+}
+
+function wearResult(app, r) {
+  if (!r.ok) { app.result(r); return; }
+  app.say(green(`${r.wearing ? 'You put on' : 'You take off'} ${r.name}.`) + (r.missing ? yellow(`  ${r.missing} piece${r.missing === 1 ? '' : 's'} missing.`) : ''));
+  for (const p of r.party ?? []) if (!p.ok) app.say(red(`  ${p.name}: ${p.reason ?? 'could not'}`));
+}
+
+export function outfitterDialog(app, owner = 'player') {
+  const ui = { owner };
+  const ownerName = () => (ui.owner === 'player' ? 'Your' : `${wearer(app, ui.owner)?.name ?? 'Their'}'s`);
+  const withOutfit = (fn) => (a, row) => { if (row?.data?.outfit) fn(a, row.data.outfit); };
+  return {
+    id: 'outfitter', title: 'Outfitter', hint: 'Enter: wear / take off',
+    keys: {
+      e: { hint: 'slots', fn: withOutfit((a, o) => { a.g.selectOutfit(ui.owner, o.id); a.push(outfitSlotsDialog(a, ui.owner, o.id)); }) },
+      n: { hint: 'new', fn: (a) => a.prompt('Name for the set you are wearing: ', (name) => { const r = a.g.createOutfit({ owner: ui.owner, name }); a.result(r, r.ok ? `Saved ${r.name}.` : ''); a.afterAction(); }) },
+      N: { hint: 'for a stat', fn: (a) => pickStat(a, (statId, label) => { const r = a.g.generateOutfit(statId, { owner: ui.owner, name: label }); a.result(r, r.ok ? `Built ${r.name} from what you carry.` : ''); }) },
+      b: { fn: withOutfit((a, o) => a.result(a.g.rebuildOutfit(ui.owner, o.id), `${o.name} rebuilt from your bags.`)) },
+      r: { hint: 'rename', fn: withOutfit((a, o) => a.prompt(`Rename ${o.name} to: `, (name) => { a.result(a.g.renameOutfit(ui.owner, o.id, name), `Renamed to ${name}.`); a.afterAction(); }, o.name)) },
+      x: { hint: 'delete', fn: withOutfit((a, o) => a.confirm(`Delete the ${o.name} outfit?`, () => a.result(a.g.deleteOutfit(ui.owner, o.id), `${o.name} deleted.`))) },
+      o: { fn: withOutfit((a, o) => a.result(a.g.setOutfitDisabled(ui.owner, o.id, !o.disabled), `${o.name} ${o.disabled ? 'on' : 'off'}.`)) },
+      w: { hint: 'whose', fn: (a) => {
+        const opts = [{ label: 'You', value: 'player' }, ...allOwned(a.g).map((c) => ({ label: c.name, value: c.id }))];
+        if (opts.length < 2) { a.flashMsg('No companions to dress.'); return; }
+        a.pick('Whose wardrobe?', opts, (v) => { ui.owner = v; a.top().cursor = 0; });
+      } },
+    },
+    rows(a) {
+      const st = a.g.ensureOutfitter(ui.owner);
+      const w = wearer(a, ui.owner);
+      const rows = [H(`${bold(`${ownerName()} outfits`)}   ${dim(`${st.outfits.length} saved${st.stack.length ? `, wearing ${st.stack.length}` : ''}   n: save what is worn   N: build for a stat`)}`)];
+      if (!w) return rows.concat(H(dim('  That companion has left.')));
+      for (const { category, outfits } of outfitsByCategory(st)) {
+        if (!outfits.length) continue;
+        rows.push(H(''), H(OUTFIT_CATEGORY_LABEL[category] ?? category));
+        for (const o of outfits) {
+          const on = wearingOutfit(st, o.id);
+          const missing = outfitMissing(o, w.equipped, w.bags, w.bank, a.ds);
+          const pieces = Object.values(o.items).filter(Boolean).length;
+          rows.push({
+            text: `${on ? green('●') : ' '} ${o.disabled ? dim(o.name) : o.name}  ${dim(`${pieces} slot${pieces === 1 ? '' : 's'}`)}${o.statId ? dim(`  ${o.statId}`) : ''}${o.seeded ? dim('  follows what you wear') : ''}${missing ? yellow('  missing pieces') : ''}${o.disabled ? dim('  off') : ''}`,
+            data: { outfit: o },
+            detail: () => outfitLines(a, o, w, on),
+            act: (a2) => wearResult(a2, a2.g.toggleOutfit(ui.owner, o.id)),
+          });
+        }
+      }
+      return rows;
+    },
+  };
+}
+
+function outfitLines(app, o, w, on) {
+  const out = [bold(o.name), dim(`${o.category}${on ? ', worn now' : ''}${o.disabled ? ', switched off' : ''}`), ''];
+  for (const slot of EQUIP_SLOTS) {
+    const ref = o.items[slot];
+    if (!ref) continue;
+    if (ref.entry === 0) { out.push(`${fit(SLOT_LABEL[slot] ?? slot, 10)} ${dim('empty')}`); continue; }
+    const it = app.ds.item(ref.entry);
+    out.push(`${fit(SLOT_LABEL[slot] ?? slot, 10)} ${qualityPaint(it?.quality)(it?.name ?? ref.entry)}`);
+  }
+  if (out.length === 3) out.push(dim('No slots yet. e: pick slots from what is worn.'));
+  out.push('', dim(`Enter: ${on ? 'take off' : 'wear'}   e: slots   r: rename   x: delete   o: ${o.disabled ? 'switch on' : 'switch off'}${o.statId ? '   b: rebuild' : ''}`));
+  return out;
+}
+
+function pickStat(app, onPick) {
+  const opts = [];
+  for (const g of OUTFIT_STAT_MENU) for (const it of g.items) opts.push({ label: `${dim(fit(g.group, 7))} ${it.name}`, value: it });
+  app.pick('Build an outfit for', opts, (it) => onPick(it.id, it.name));
+}
+
+/** Which slots a set holds. Enter on a slot takes what is worn there into the set, or drops it. */
+function outfitSlotsDialog(app, owner, id) {
+  return {
+    id: 'outfit-slots', title: 'Slots', hint: 'Enter: take what is worn here / drop the slot',
+    keys: {
+      A: { hint: 'all worn', fn: (a) => a.result(a.g.setOutfitSlotsAll(owner, id, true), 'Every worn slot is in the set.') },
+      Z: { hint: 'none', fn: (a) => a.result(a.g.setOutfitSlotsAll(owner, id, false), 'The set is empty.') },
+    },
+    rows(a) {
+      const o = findOutfitById(a.g.outfitterState(owner), id);
+      if (!o) return [H(dim('That outfit is gone.'))];
+      const w = wearer(a, owner);
+      const rows = [H(`${bold(o.name)}   ${dim('a slot in the set is put on when the set is worn')}`), H('')];
+      for (const slot of EQUIP_SLOTS) {
+        const ref = o.items[slot];
+        const wornEntry = w?.equipped?.[slot];
+        const wornId = typeof wornEntry === 'object' && wornEntry ? wornEntry.item : wornEntry;
+        const name = ref ? (ref.entry === 0 ? dim('empty') : a.itemLabel(ref.entry)) : dim('not in the set');
+        rows.push({
+          text: `${ref ? green('✓') : dim('·')} ${fit(SLOT_LABEL[slot] ?? slot, 10)} ${name}${!ref && wornId ? cyan(`  worn: ${a.itemLabel(wornId)}`) : ''}`,
+          act: (a2) => a2.result(a2.g.setOutfitSlot(owner, id, slot, !ref)),
+        });
+      }
+      return rows;
+    },
+  };
+}

package/src/cli/tuiPet.mjs

@@ -0,0 +1,116 @@
+// Your pet (hunter, warlock): the page with command, react, food and abilities; the stable; the pet trainer.
+// Ports phonecraft playChrome.ts's feed modal, render/petBar.ts, panels/stablePanel.ts and the pet trainer rows.
+import { bold, dim, cyan, yellow, green, red, itemText } from './text.mjs';
+import { itemLines, spellLines } from './tuiViews.mjs';
+import { moneyText } from '../domain/economy/money.ts';
+import { LOYALTY_NAMES, petHasHappiness, petKnownSpells, petAutocastOn } from '../domain/pet/pet.ts';
+import { MAX_PET_STABLES, STABLE_SLOT_PRICES } from '../domain/pet/petStable.ts';
+import { zonePetTrainers } from '../world/world.ts';
+import { MAX_SOUL_SHARD_CAP } from '../autopilot/config.ts';
+
+const H = (text) => ({ text, header: true });
+const HUNTER = 3, WARLOCK = 9;
+export const hasPetClass = (app) => app.ch.cls === HUNTER || app.ch.cls === WARLOCK;
+
+function petStatus(app, pet) {
+  const cdef = app.ds.creature(pet.creature);
+  const bits = [`${pet.health <= 0 ? red('dead') : `${pet.health} health`}`];
+  if (cdef && petHasHappiness(cdef)) bits.push(`happiness ${pet.happiness}%`, LOYALTY_NAMES[pet.loyalty ?? 1] ?? '');
+  if (pet.trainingPoints != null) bits.push(`${pet.trainingPoints} training points`);
+  return bits.filter(Boolean).join(', ');
+}
+
+/** Bag food this pet eats: the item's food type against the beast's diet (feedPet refuses the rest). */
+function bagFood(app) {
+  const seen = new Set();
+  return app.g.state.inventory.stacks.map((s) => app.ds.item(s.item)).filter((it) => it && it.consumable?.effect === 'food' && !seen.has(it.entry) && seen.add(it.entry));
+}
+
+export function petDialog(app) {
+  return {
+    id: 'pet', title: 'Pet', hint: 'Enter: choose',
+    rows(a) {
+      const g = a.g, ch = a.ch, pet = ch.pet;
+      const rows = [H(pet ? `${bold(pet.name)}  ${dim(a.ds.creature(pet.creature)?.name ?? '')}   ${petStatus(a, pet)}` : bold('No pet out'))];
+      if (!pet) {
+        rows.push(H(dim(ch.cls === HUNTER ? (ch.storedPet ? `${ch.storedPet.name} waits: Call Pet from the Spells tab.` : 'Tame a beast: t on a tameable creature on the World tab.') : 'Summon a demon from the Spells tab.')));
+      } else {
+        rows.push(H(''), H('Orders'));
+        rows.push({ text: `Command: ${cyan(pet.command ?? 'follow')}`, detail: () => [bold('Command'), '', 'Follow: it comes with you and fights beside you. Stay: it holds where it is.', '', dim('Enter: switch')], act: () => a.result(g.setPetCommand((pet.command ?? 'follow') === 'follow' ? 'stay' : 'follow')) });
+        const reacts = ['aggressive', 'defensive', 'passive'];
+        rows.push({ text: `Reaction: ${cyan(pet.react ?? 'defensive')}`, detail: () => [bold('Reaction'), '', 'Aggressive attacks what comes near; defensive answers what attacks you or it; passive never starts a fight.', '', dim('Enter: next')], act: () => a.result(g.setPetReact(reacts[(reacts.indexOf(pet.react ?? 'defensive') + 1) % 3])) });
+        const cdef = a.ds.creature(pet.creature);
+        if (cdef && petHasHappiness(cdef)) {
+          const foods = bagFood(a);
+          rows.push(H(''), H(`Food ${pet.autoFeed ? dim(`auto-feeds ${a.itemLabel(pet.autoFeed)}`) : dim('no auto-feed')}`));
+          rows.push({ text: 'Feed it…', detail: () => [bold('Feed'), '', 'Raises its happiness; a happy pet hits harder and grows loyal.'], act: () => { if (!foods.length) { a.flashMsg('No food in your bags.'); return; } a.pick('Feed it what?', foods.map((f) => ({ label: f.name, detail: () => itemLines(a, f), value: f })), (f) => a.result(g.feedPet(f.entry), `${pet.name} eats ${f.name}.`)); } });
+          rows.push({ text: 'Auto-feed…', detail: () => [bold('Auto-feed'), '', 'Between fights it eats this whenever its happiness has room for it.'], act: () => a.pick('Auto-feed with', [{ label: dim('Nothing'), value: null }, ...foods.map((f) => ({ label: itemText(f), value: f.entry }))], (e) => a.result(g.setPetAutoFeed(e), e ? `${pet.name} eats ${a.itemLabel(e)} on its own.` : 'Auto-feed off.')) });
+        }
+        if (cdef && pet.health > 0) {
+          rows.push(H(''), H(`Abilities ${dim('Enter: autocast on or off')}`));
+          for (const s of petKnownSpells(ch, cdef, a.ds)) {
+            const on = petAutocastOn(pet, s, a.ds);
+            rows.push({ text: `${on ? green('✓') : dim('·')} ${s.name}${s.rank ? dim(` (Rank ${s.rank})`) : ''}`, detail: () => spellLines(a, s, ['', on ? 'Autocast on.' : 'Autocast off: it stays learned but out of the fight kit.']), act: () => a.result(g.togglePetAutocast(s.id)) });
+          }
+        }
+        if (ch.cls === HUNTER && (ch.petSpells ?? []).length) {
+          const taught = new Set(pet.taughtSpells ?? []);
+          const teach = ch.petSpells.filter((id) => !taught.has(id)).map((id) => a.ds.spell(id)).filter(Boolean);
+          if (teach.length) rows.push({ text: `Beast Training: teach it… ${dim(`(${teach.length})`)}`, detail: () => [bold('Beast Training'), '', 'Teach your pet a rank you bought at a pet trainer, spending its training points.'], act: () => a.pick('Teach it', teach.map((sp) => ({ label: `${sp.name}${sp.rank ? dim(` (Rank ${sp.rank})`) : ''}`, detail: () => spellLines(a, sp), value: sp })), (sp) => a.result(g.teachPetSpell(sp.id), `${pet.name} learns ${sp.name}.`)) });
+        }
+        rows.push(H(''), { text: red('Dismiss it'), act: () => a.result(g.dismissPet(), `${pet.name} leaves.`) });
+      }
+      const books = a.g.state.inventory.stacks.map((s) => a.ds.item(s.item)).filter((it) => it?.teachPetSpell);
+      if (books.length) rows.push(H(''), ...books.map((b) => ({ text: `Read ${b.name}`, detail: () => itemLines(a, b), act: () => { const r = g.trainPet(b.entry); a.result(r, r.ok ? `Your pet can now learn ${r.name}.` : ''); } })));
+      if (ch.cls === HUNTER) rows.push(...stableRows(a));
+      if (ch.cls === WARLOCK) {
+        const cfg = g.autopilotConfig();
+        rows.push(H(''), { text: `Soul Shards to keep: ${cyan(String(cfg.keepSoulShards))}`, detail: () => [bold('Soul Shard cap'), '', 'Auto-play stops casting Drain Soul once you carry this many shards. 0 never farms them.', '', dim('Enter: type a number')], act: () => a.prompt(`Shards to keep (0-${MAX_SOUL_SHARD_CAP}): `, (t) => { const n = Math.max(0, Math.min(MAX_SOUL_SHARD_CAP, Math.round(Number(t)))); if (Number.isFinite(n)) g.setAutopilotConfig({ ...g.autopilotConfig(), keepSoulShards: n }); a.afterAction(); }, String(cfg.keepSoulShards)) });
+      }
+      return rows;
+    },
+  };
+}
+
+function stableRows(app) {
+  const g = app.g, ch = app.ch;
+  const slots = ch.stableSlots ?? 0;
+  const rows = [H(''), H(`Stable ${dim(`${slots} of ${MAX_PET_STABLES} slots bought`)}`)];
+  for (let i = 0; i < slots; i++) {
+    const p = ch.stablePets?.[i];
+    rows.push({ text: `  Slot ${i + 1}: ${p ? `${p.name} ${dim(app.ds.creature(p.creature)?.name ?? '')}` : dim('empty')}`, detail: () => [bold(`Stable slot ${i + 1}`), '', p ? `Enter: call ${p.name}${ch.pet ? `, stabling ${ch.pet.name} in its place` : ''}.` : 'Empty.'], act: () => { if (p) app.result(g.callStabledPet(i + 1), `${p.name} comes to you.`); } });
+  }
+  if (ch.pet || ch.storedPet) rows.push({ text: `Stable ${(ch.pet ?? ch.storedPet).name}`, act: () => { const r = g.stablePet(); app.result(r, r.ok ? `Stabled in slot ${r.slot}.` : ''); } });
+  if (slots < MAX_PET_STABLES) rows.push({ text: `Buy a stable slot ${yellow(moneyText(STABLE_SLOT_PRICES[slots] ?? 0))}`, act: () => { const r = g.buyStableSlot(); app.result(r, r.ok ? `A stable slot for ${moneyText(r.spent)}.` : ''); } });
+  return rows;
+}
+
+/** World tab rows: your pet, and the zone's pet trainers (hunters). */
+export function petWorldRows(app) {
+  if (!hasPetClass(app)) return [];
+  const pet = app.ch.pet;
+  const rows = [{ text: `${cyan('Pet')}: ${pet ? `${pet.name} ${dim(petStatus(app, pet))}` : dim('none out')}`, detail: () => [bold('Pet'), '', dim('Enter: the pet page')], act: () => app.push(petDialog(app)) }];
+  if (app.ch.cls === HUNTER) for (const t of zonePetTrainers(app.ds, app.ch.zoneId)) rows.push({ text: `${t.name} ${dim('<Pet Trainer>')}`, detail: () => [bold(t.name), 'Pet trainer', '', dim('Enter: ranks for your Beast Training')], act: () => app.push(petTrainerDialog(app, t)) });
+  return rows;
+}
+
+export function petTrainerDialog(app, trainer) {
+  return {
+    id: `pettrainer-${trainer.entry}`, title: trainer.name, hint: 'Enter: buy the rank',
+    rows(a) {
+      const known = new Set(a.ch.petSpells ?? []);
+      const rows = [H(`${bold(trainer.name)} ${dim('<Pet Trainer>')}   ${yellow(moneyText(a.ch.gold) || '0c')}`), H(dim('A rank bought here is yours for good; Beast Training teaches it to whichever pet is out.')), H('')];
+      const list = trainer.spells.map((ts) => ({ ts, sp: a.ds.spell(ts.spell) })).filter((x) => x.sp).sort((x, y) => x.ts.reqLevel - y.ts.reqLevel || x.sp.name.localeCompare(y.sp.name));
+      for (const { ts, sp } of list) {
+        const have = known.has(sp.id), low = ts.reqLevel > a.ch.level;
+        rows.push({
+          text: `${have ? green('✓ ') : '  '}${low || have ? dim(sp.name) : sp.name}${sp.rank ? dim(` (Rank ${sp.rank})`) : ''}  ${yellow(moneyText(ts.cost) || 'free')}${low ? red(`  level ${ts.reqLevel}`) : ''}`,
+          detail: () => spellLines(a, sp, ['', `Cost: ${yellow(moneyText(ts.cost) || 'free')}`]),
+          act: () => { if (!have) a.result(a.g.buyPetSpell(trainer.entry, sp.id), `You learn ${sp.name} for your pets.`); },
+        });
+      }
+      return rows;
+    },
+  };
+}
+