azeroth-shell 0.0.0-stage → 0.1.1

package/src/cli/tuiWiki.mjs

@@ -0,0 +1,181 @@
+// The wiki (phonecraft ui/wiki): look anything up in the data the game runs on. / searches every catalog
+// (items, spells, quests, NPCs, talents, recipes, zones, dungeons, objects, factions); Tab narrows to one kind.
+// A page lists what links to it (where an item drops, who sells it, which quest rewards it, who teaches a spell)
+// as rows: Enter follows a link, Esc goes back. Search and sources are phonecraft's own pure indexes.
+import { bold, dim, yellow, green, red, cyan, qualityPaint, wrapLines } from './text.mjs';
+import { itemLines, spellLines, creatureLines, rewardLines } from './tuiViews.mjs';
+import { wikiIndex, wikiTokens, wikiSearch, WIKI_KINDS, WIKI_KIND_LABEL, WIKI_KIND_ONE } from './wikiIndex.ts';
+import { wikiSourceIndexSync } from './wikiSources.ts';
+import { moneyText } from '../domain/economy/money.ts';
+import { className } from '../domain/core/ids.ts';
+
+const H = (text) => ({ text, header: true });
+const MAX_RESULTS = 300;
+const SOURCE_LABEL = {
+  drop: 'Dropped by', object: 'Found in', gather: 'Gathered from', skin: 'Skinned from', pickpocket: 'Pickpocketed from',
+  fishing: 'Fished in', disenchant: 'Disenchanted from', container: 'Inside', spell: 'Made by the spell', mail: 'Sent by mail',
+  vendor: 'Sold by', 'quest-reward': 'Reward from', crafted: 'Crafted with', 'starts-quest': 'Starts', 'quest-objective': 'Needed for',
+};
+
+/** The search window. `query` starts it filled in (from :wiki <words>). */
+export function wikiDialog(app, query = '') {
+  const s = { query, kind: null };
+  const view = {
+    id: 'wiki', title: 'Wiki', hint: '/: search   Tab: kind',
+    keys: {
+      '/': { hint: 'search', fn: (a) => a.prompt('Search the wiki: ', (t) => { s.query = t; view.cursor = 0; view.scroll = 0; a.render(); }, s.query) },
+      tab: { hint: 'kind', fn: () => { const i = s.kind == null ? 0 : WIKI_KINDS.indexOf(s.kind) + 1; s.kind = WIKI_KINDS[i] ?? null; view.cursor = 0; view.scroll = 0; } },
+    },
+    rows(a) {
+      const ix = wikiIndex(a.ds);
+      const tabs = [s.kind == null ? bold('[All]') : dim('All'), ...WIKI_KINDS.map((k) => (k === s.kind ? bold(`[${WIKI_KIND_LABEL[k]}]`) : dim(WIKI_KIND_LABEL[k])))].join(' ');
+      const rows = [H(tabs), H(s.query ? `Search: ${yellow(s.query)}` : dim('Press / and type a name: an item, a spell, a quest, an NPC, a zone...')), H('')];
+      if (!s.query.trim()) return rows;
+      const pool = s.kind ? ix.byKind[s.kind] : ix.all;
+      const hits = wikiSearch(pool, wikiTokens(s.query));
+      if (!hits.length) rows.push(H(dim('  Nothing by that name.')));
+      for (const r of hits.slice(0, MAX_RESULTS)) {
+        rows.push({ text: `${linkName(a, r.kind, r.id, r.name)}  ${dim(`${s.kind ? '' : `${WIKI_KIND_ONE[r.kind]}  `}${r.sub ?? ''}`)}`, detail: () => pageLines(a, r.kind, r.id).slice(0, 40), act: (a2) => a2.push(wikiPage(a2, r.kind, r.id)) });
+      }
+      if (hits.length > MAX_RESULTS) rows.push(H(dim(`  ${hits.length - MAX_RESULTS} more. Narrow the search.`)));
+      return rows;
+    },
+  };
+  return view;
+}
+
+function linkName(app, kind, id, fallback) {
+  if (kind === 'item') { const it = app.ds.item(id); return qualityPaint(it?.quality)(it?.name ?? fallback); }
+  return fallback ?? String(id);
+}
+
+/** A link row to another page. */
+function link(app, kind, id, label) {
+  return { text: `  ${label}`, act: (a) => a.push(wikiPage(a, kind, id)) };
+}
+
+/** The text half of a page (no links), also used as the search detail pane. */
+function pageLines(app, kind, id) {
+  const ds = app.ds;
+  switch (kind) {
+    case 'item': return itemLines(app, ds.item(id));
+    case 'spell': return ds.spell(id) ? spellLines(app, ds.spell(id)) : [`spell ${id}`];
+    case 'npc': return ds.creature(id) ? creatureLines(app, ds.creature(id)) : [`creature ${id}`];
+    case 'quest': {
+      const q = ds.quest(id);
+      if (!q) return [`quest ${id}`];
+      return [bold(q.title), dim(`Level ${q.questLevel}, from level ${q.minLevel}`), '', ...wrapLines(q.objectivesText ?? '', 60), '', ...rewardLines(app, q)];
+    }
+    case 'recipe': {
+      const r = ds.recipe(id);
+      if (!r) return [`recipe ${id}`];
+      return [bold(r.name), dim(`${ds.profession(r.skill)?.name ?? r.skill} ${r.orange}`), '', ...r.reagents.map((g) => `  ${g.count} ${app.itemLabel(g.item)}`)];
+    }
+    case 'zone': { const z = ds.zone(id); return z ? [bold(z.name), dim(`levels ${z.levelRange[0]}-${z.levelRange[1]}${z.faction ? `, ${z.faction}` : ''}`)] : [String(id)]; }
+    case 'dungeon': { const d = ds.instance(id); return d ? [bold(d.name), dim(`levels ${d.levelRange[0]}-${d.levelRange[1]}, from ${d.minLevel}${d.maxPlayers ? `, ${d.maxPlayers} players` : ''}`), ...(d.description ? ['', ...wrapLines(d.description, 60)] : [])] : [String(id)]; }
+    case 'object': { const o = ds.gameObject(id); return o ? [bold(o.name), dim(`object type ${o.type}`)] : [`object ${id}`]; }
+    case 'faction': { const f = ds.faction(id); return f ? [bold(f.name), '', ...wrapLines(f.description ?? '', 60)] : [`faction ${id}`]; }
+    case 'talent': {
+      const t = ds.talent(id);
+      if (!t) return [`talent ${id}`];
+      return [bold(t.name), dim(`${t.maxRank} rank${t.maxRank === 1 ? '' : 's'}, tier ${t.tier + 1}`), '', ...wrapLines(t.ranks?.[t.maxRank - 1]?.description ?? t.ranks?.[0]?.description ?? '', 60)];
+    }
+    default: return [String(id)];
+  }
+}
+
+/** The links half of a page. */
+function pageLinks(app, kind, id) {
+  const ds = app.ds;
+  const src = wikiSourceIndexSync(ds);
+  const rows = [];
+  const section = (title, list) => { if (list.length) rows.push(H(''), H(cyan(title)), ...list); };
+  if (kind === 'item') {
+    const { sources, more } = src.itemSources(id);
+    const byKind = new Map();
+    for (const s of sources) { if (!byKind.has(s.kind)) byKind.set(s.kind, []); byKind.get(s.kind).push(s); }
+    for (const [k, list] of byKind) {
+      section(SOURCE_LABEL[k] ?? k, list.map((s) => {
+        const pct = s.chance != null ? dim(`  ${Math.round(s.chance * 10) / 10}%${s.questOnly ? ' (quest)' : ''}`) : '';
+        const count = s.minCount && (s.minCount > 1 || s.maxCount > 1) ? dim(`  x${s.minCount === s.maxCount ? s.minCount : `${s.minCount}-${s.maxCount}`}`) : '';
+        if (k === 'drop' || k === 'skin' || k === 'pickpocket' || k === 'vendor') return link(app, 'npc', s.ref, `${ds.creature(s.ref)?.name ?? ds.vendor?.(s.ref)?.name ?? s.ref}${pct}${count}`);
+        if (k === 'object' || k === 'fishing') return ds.gameObject(s.ref) ? link(app, 'object', s.ref, `${ds.gameObject(s.ref).name}${pct}${count}`) : H(`  ${s.zone ?? s.ref}${pct}`);
+        if (k === 'quest-reward' || k === 'starts-quest' || k === 'quest-objective') return link(app, 'quest', s.ref, `${ds.quest(s.ref)?.title ?? s.ref}${s.choice ? dim('  (a choice)') : ''}`);
+        if (k === 'crafted') return link(app, 'recipe', s.ref, ds.recipe(s.ref)?.name ?? String(s.ref));
+        if (k === 'container' || k === 'disenchant') return link(app, 'item', s.ref, `${app.itemLabel(s.ref)}${pct}${count}`);
+        if (k === 'spell') return link(app, 'spell', s.ref, ds.spell(s.ref)?.name ?? String(s.ref));
+        if (k === 'gather') return H(`  ${ds.gatherNode?.(s.ref)?.name ?? `node ${s.ref}`}${s.zone ? dim(`  ${ds.zone(s.zone)?.name ?? s.zone}`) : ''}${pct}`);
+        return H(`  ${s.ref}${pct}`);
+      }));
+    }
+    if (more) rows.push(H(dim(`  and ${more} more drops`)));
+    section('Reagent for', src.reagentFor(id).map((r) => link(app, 'recipe', r, ds.recipe(r)?.name ?? String(r))));
+    const it = ds.item(id);
+    if (it?.teachRecipe) section('Teaches', [link(app, 'recipe', it.teachRecipe, ds.recipe(it.teachRecipe)?.name ?? String(it.teachRecipe))]);
+    if (it?.startQuest) section('Starts', [link(app, 'quest', it.startQuest, ds.quest(it.startQuest)?.title ?? String(it.startQuest))]);
+  } else if (kind === 'spell') {
+    const s = src.spellSources(id);
+    section('Taught by', s.trainers.map((e) => link(app, 'npc', e, ds.creature(e)?.name ?? ds.trainer(e)?.name ?? String(e))));
+    section('From the item', s.items.map((e) => link(app, 'item', e, app.itemLabel(e))));
+    section('From the talent', s.talents.map((t) => link(app, 'talent', t, ds.talent(t)?.name ?? String(t))));
+    section('Reward from', s.quests.map((q) => link(app, 'quest', q, ds.quest(q)?.title ?? String(q))));
+  } else if (kind === 'npc') {
+    const q = src.questsForCreature(id);
+    section('Starts', q.starts.map((e) => link(app, 'quest', e, ds.quest(e)?.title ?? String(e))));
+    section('Ends', q.ends.map((e) => link(app, 'quest', e, ds.quest(e)?.title ?? String(e))));
+    const v = ds.vendor(id);
+    if (v) section('Sells', v.items.slice(0, 60).map((e) => link(app, 'item', e, app.itemLabel(e))));
+  } else if (kind === 'quest') {
+    const q = ds.quest(id);
+    if (q) {
+      section('Kill', q.killTargets.map((k) => link(app, 'npc', k.creatureEntry, `${ds.creature(k.creatureEntry)?.name ?? k.creatureEntry} x${k.count}`)));
+      section('Bring', (q.itemTargets ?? []).map((k) => link(app, 'item', k.item, `${app.itemLabel(k.item)} x${k.count}`)));
+      section('Rewards', [...q.rewItems, ...(q.rewChoiceItems ?? [])].map((r) => link(app, 'item', r.item, `${app.itemLabel(r.item)}${r.count > 1 ? ` x${r.count}` : ''}`)));
+      section('Teaches', (q.rewSpells ?? []).map((sp) => link(app, 'spell', sp, ds.spell(sp)?.name ?? String(sp))));
+      section('Reputation', (q.rewRep ?? []).filter((r) => r.value).map((r) => link(app, 'faction', r.faction, `${ds.faction(r.faction)?.name ?? r.faction} ${r.value > 0 ? '+' : ''}${r.value}`)));
+      const chain = [q.prevQuest && ['Comes after', q.prevQuest], q.nextQuest && ['Leads to', q.nextQuest]].filter(Boolean);
+      for (const [label, e] of chain) section(label, [link(app, 'quest', e, ds.quest(e)?.title ?? String(e))]);
+      rows.push(H(''), H(dim(`From ${q.starterName || '?'}, to ${q.enderName || '?'}${q.rewMoney ? `, ${moneyText(q.rewMoney)}` : ''}`)));
+    }
+  } else if (kind === 'recipe') {
+    const r = ds.recipe(id);
+    if (r) {
+      section('Makes', [link(app, 'item', r.product.item, `${app.itemLabel(r.product.item)}${r.product.count > 1 ? ` x${r.product.count}` : ''}`)]);
+      section('Reagents', r.reagents.map((g) => link(app, 'item', g.item, `${app.itemLabel(g.item)} x${g.count}`)));
+    }
+  } else if (kind === 'zone') {
+    const z = ds.zone(id);
+    if (z) {
+      section('Dungeons', ds.instances().filter((d) => d.portalZone === id).map((d) => link(app, 'dungeon', d.id, d.name)));
+      section('Creatures', (z.huntable ?? []).map((e) => ds.creature(e)).filter(Boolean).sort((a, b) => a.level - b.level).slice(0, 80).map((c) => link(app, 'npc', c.entry, `${c.name} ${dim(`L${c.level}`)}`)));
+      section('Next door', (z.neighbors ?? []).map((n) => link(app, 'zone', n, ds.zone(n)?.name ?? n)));
+    }
+  } else if (kind === 'dungeon') {
+    const d = ds.instance(id);
+    if (d) {
+      section('Bosses', d.encounters.filter((e) => e.kind === 'boss').map((e) => link(app, 'npc', e.creatureEntry, e.name)));
+      section('Quests', (d.quests ?? []).map((q) => link(app, 'quest', q, ds.quest(q)?.title ?? String(q))));
+      if (d.portalZone) section('Entrance', [link(app, 'zone', d.portalZone, ds.zone(d.portalZone)?.name ?? d.portalZone)]);
+    }
+  } else if (kind === 'object') {
+    const o = ds.gameObject(id);
+    if (o) {
+      const loot = o.lootId ? ds.lootTable(o.lootId) : [];
+      section('Holds', loot.slice(0, 40).map((l) => link(app, 'item', l.item, `${app.itemLabel(l.item)}${l.chance != null ? dim(`  ${Math.abs(l.chance)}%`) : ''}`)));
+      section('Starts', (o.questsStarted ?? []).map((q) => link(app, 'quest', q, ds.quest(q)?.title ?? String(q))));
+      section('Ends', (o.questsEnded ?? []).map((q) => link(app, 'quest', q, ds.quest(q)?.title ?? String(q))));
+    }
+  }
+  return rows;
+}
+
+export function wikiPage(app, kind, id) {
+  return {
+    id: 'wiki-page', title: `${WIKI_KIND_ONE[kind] ?? kind}`, hint: 'Enter: follow the link   Esc: back', noDetail: true,
+    rows(a) {
+      const rows = pageLines(a, kind, id).map((l) => H(l));
+      rows.push(...pageLinks(a, kind, id));
+      return rows;
+    },
+  };
+}

package/src/cli/tuiWorld.mjs

@@ -0,0 +1,361 @@
+// World-tab extras that are not a creature fight, a quest or a vendor: pick pocket for rogues (P on a creature)
+// real-time journeys, riding (instructors, mounts), and the zone's objects (chests, books, quest objects).
+import { bold, dim, yellow, red, green, cyan, bar, wrapLines } from './text.mjs';
+import { startFight } from './tuiFight.mjs';
+import { knownUsableSpells } from '../domain/character/characterSpells.ts';
+import { activeStealthAura } from '../domain/character/buildCombatant.ts';
+import { pickpocketLootKey, canRestockPickpocket } from '../domain/professions/pickpocket.ts';
+import { moneyText } from '../domain/economy/money.ts';
+import { vendorPriceMultiplierFor, trainerSpellCost } from '../engine/game/vendorOffers.ts';
+import { questDialog } from './tuiViews.mjs';
+import { mailDialog } from './tuiCity.mjs';
+import { autoLootOn, openLoot, takeAll } from './tuiLoot.mjs';
+import { zoneGameObjects, zoneGoListedForPlayer, makeGoPlayerVisibility, questReferencedGoEntries, questTargets } from '../world/world.ts';
+import { goQuestGiverOffer, goDialogMarkerFromOffer, questStatusFromLog } from '../domain/quests/questlog.ts';
+import { isGoQuestGiver, interactVerbForGoType, goRuntimeAvailability } from '../domain/world/gameObjects.ts';
+import { pruneWildSummoned } from '../engine/game/summonObjectWild.ts';
+import { offeredQuests } from '../quests/quests.ts';
+import { pageText } from '../data/pageTexts.ts';
+import { meetingStonesForPortalZone, instanceForMeetingStoneArea } from '../world/meetingStones.ts';
+import { getVariable } from '../engine/game/worldState.ts';
+import { WORLD_STATE_ADD, WORLD_STATE_EP_TOWER_COUNT_ALLIANCE, WORLD_STATE_EP_TOWER_COUNT_HORDE, WORLD_STATE_EP_NORTHPASS_ALLIANCE, WORLD_STATE_EP_NORTHPASS_HORDE, WORLD_STATE_EP_CROWNGUARD_ALLIANCE, WORLD_STATE_EP_CROWNGUARD_HORDE, WORLD_STATE_EP_EASTWALL_ALLIANCE, WORLD_STATE_EP_EASTWALL_HORDE, WORLD_STATE_EP_PLAGUEWOOD_ALLIANCE, WORLD_STATE_EP_PLAGUEWOOD_HORDE, GO_TOWER_BANNER_NORTHPASS, GO_TOWER_BANNER_CROWNGUARD, GO_TOWER_BANNER_EASTWALL, GO_TOWER_BANNER_PLAGUEWOOD, WORLD_STATE_SI_GATHERED_A, WORLD_STATE_SI_GATHERED_H, WORLD_STATE_SI_SILITHYST_MAX, MAX_SILITHYST } from '../engine/game/outdoorPvp.ts';
+import { applyMeetingStoneQueue, meetingStoneQueueStateFromApply, leaveMeetingStoneQueue, formatMeetingStonePlace, formatMeetingStoneLevel, ERR_MEETING_STONE_IN_QUEUE_S, ERR_MEETING_STONE_LEFT_QUEUE_S, MEETINGSTONE_STATUS_JOINED_QUEUE } from '../engine/game/meetingStoneQueue.ts';
+
+/** The Pick Pocket rank you know, or undefined. */
+export function pickPocketSpell(app) {
+  return knownUsableSpells(app.ch, app.g.state.spellbook, app.ds).find((s) => s.effects?.some((e) => e.kind === 'pickpocket'));
+}
+
+/** '' when there is nothing to steal from this creature, else what P would do right now. */
+export function pickPocketState(app, creature) {
+  if (!pickPocketSpell(app) || !app.ds.lootTable(pickpocketLootKey(creature.entry)).length) return '';
+  if (!canRestockPickpocket(app.g.state.pickpocketRestock, `${app.ch.zoneId}:${creature.entry}`, Date.now())) return 'empty';
+  return activeStealthAura(app.ch, app.ds, Date.now()) ? 'ready' : 'stealth';
+}
+
+/** P on a creature: the cast pays energy and checks Stealth; a resist turns into a fight with just that mob. */
+export function pickPocket(app, creature) {
+  const sp = pickPocketSpell(app);
+  if (!sp) { app.flashMsg('Only rogues pick pockets.'); return; }
+  const state = pickPocketState(app, creature);
+  if (!state) { app.flashMsg(`${creature.name} carries nothing worth stealing.`); return; }
+  if (state === 'empty') { app.flashMsg('Those pockets are empty. They refill ten minutes after a pick.'); return; }
+  const r = app.g.castOutOfCombat(sp.id, { targetCreature: creature.entry });
+  if (r.ok) { app.say(green(`You pick ${creature.name}'s pocket.`)); return; }
+  app.say(red(r.reason || 'You fail to pick the pocket.'));
+  if (r.aggroCreature != null) {
+    app.say(yellow(`${creature.name} notices you!`));
+    startFight(app, r.aggroCreature, { begin: () => app.g.beginFight(r.aggroCreature, { withSquad: true, noAoe: true }) });
+  }
+}
+
+export function pickPocketTag(app, creature) {
+  const st = pickPocketState(app, creature);
+  return st === 'ready' ? dim('  P: pick pocket') : st === 'empty' ? dim('  pockets empty') : '';
+}
+
+// ---- journeys ------------------------------------------------------------------------------------------
+// With a real-time travel pace (Settings) a trip takes wall-clock time: the game loop calls journeyTick, the
+// header shows where you are headed, and the World tab opens on this card. Instant pace never gets here.
+
+const PACES = ['instant', 1, 2, 4];
+export const paceLabel = (p) => (p === 'instant' ? 'instant' : `${p}x real time`);
+export const nextPace = (p) => PACES[(PACES.indexOf(p) + 1) % PACES.length];
+const mmss = (sec) => { const s = Math.max(0, Math.ceil(sec)); return s >= 60 ? `${Math.floor(s / 60)}m ${String(s % 60).padStart(2, '0')}s` : `${s}s`; };
+
+/** "→ Westfall 1m 05s" for the header, or null when not travelling. */
+export function journeyHeader(app) {
+  const st = app.g.state.char.journey ? app.g.journeyStatus() : null;
+  if (!st) return null;
+  return `→ ${app.ds.zone(st.destination)?.name ?? st.destination} ${mmss(st.progress.remainingSeconds)}${app.travelPaused ? ' paused' : ''}`;
+}
+
+/** After a departure: say you are on the road, or that you are there (instant pace lands at once). */
+export function afterDeparture(app, arrivedText) {
+  if (!app.g.state.char.journey) { app.say(arrivedText()); return true; }
+  const st = app.g.journeyStatus();
+  app.say(`You set off for ${app.ds.zone(st?.destination)?.name ?? 'the road'}. ${dim(st ? `${mmss(st.progress.remainingSeconds)} at ${st.timeScale}x` : '')}`);
+  app.journeyWas = st?.destination ?? null;
+  return false;
+}
+
+/** Called from the game loop and after keys: advance the trip, announce arrival. */
+export function journeyTick(app) {
+  if (!app.g?.state.char.journey) return;
+  app.g.journeyTick();
+  if (!app.g.state.char.journey) {
+    app.say(green(`You arrive in ${app.zone()?.name ?? app.ch.zoneId}.`));
+    app.journeyWas = null;
+    const world = app.tabs[0]?.view;
+    if (world) { world.cursor = 0; world.scroll = 0; }
+  }
+}
+
+export function journeyRows(app) {
+  const st = app.g.state.char.journey ? app.g.journeyStatus() : null;
+  if (!st) return [];
+  const dest = app.ds.zone(st.destination)?.name ?? st.destination;
+  const total = st.progress.totalElapsedSeconds + st.progress.remainingSeconds;
+  const leg = st.legs[st.progress.legIndex];
+  return [
+    { text: `On the road to ${dest}`, header: true },
+    { text: `${bar(st.progress.totalElapsedSeconds, total, 30, cyan)} ${mmss(st.progress.remainingSeconds)} left${app.travelPaused ? yellow('  paused') : ''}`, header: true },
+    {
+      text: `${leg ? `${leg.kind} ${app.ds.zone(leg.from)?.name ?? leg.from} → ${app.ds.zone(leg.to)?.name ?? leg.to}` : ''}  ${dim(`${st.timeScale}x   Enter: journey options`)}`,
+      detail: () => [bold(`To ${dest}`), '', ...st.legs.map((l, i) => `${i < st.progress.legIndex ? green('✓') : i === st.progress.legIndex ? cyan('▶') : dim('·')} ${l.kind} ${app.ds.zone(l.from)?.name ?? l.from} → ${app.ds.zone(l.to)?.name ?? l.to} ${dim(mmss(l.seconds))}`), '', dim('Enter: speed, pause, arrive now, turn back')],
+      act: (a) => journeyMenu(a),
+    },
+    { text: '', header: true },
+  ];
+}
+
+export function journeyMenu(app) {
+  const g = app.g;
+  const st = g.journeyStatus();
+  if (!st) return;
+  app.pick('Journey', [
+    { label: 'Arrive now', value: () => { if (app.result(app.arriveNow())) { app.journeyWas = null; app.say(green(`You arrive in ${app.zone()?.name}.`)); } } },
+    ...[1, 2, 4].filter((x) => x !== st.timeScale).map((x) => ({ label: `Travel at ${x}x real time`, value: () => app.result(g.setJourneySpeed(x), `Now travelling at ${x}x.`) })),
+    { label: app.travelPaused ? 'Carry on' : 'Pause the trip', value: () => { app.travelPaused = !app.travelPaused; g.setIdlePaused(app.travelPaused); app.say(dim(app.travelPaused ? 'You stop by the road.' : 'You carry on.')); } },
+    { label: red('Turn back here'), value: () => { const r = g.cancelJourney(); if (app.result(r, `You stop in ${app.zone()?.name}.`)) app.journeyWas = null; } },
+  ], (fn) => fn());
+}
+
+// ---- riding and mounts ---------------------------------------------------------------------------------
+
+/** Riding instructors in this zone, as World-tab People rows. */
+export function ridingRows(app) {
+  const ids = app.zone()?.ridingTrainers ?? [];
+  if (!ids.length || !app.ds.ridingSpells().length) return [];
+  return ids.map((entry) => {
+    const name = app.ds.creature(entry)?.name ?? `Riding Instructor (${entry})`;
+    return {
+      text: `${name} ${dim('<Riding Instructor>')}${app.ch.ridingSkill ? dim(`  you ride at ${app.ch.ridingSkill}`) : ''}`,
+      detail: () => [bold(name), 'Riding instructor', `Your riding: ${app.ch.ridingSkill ?? 0}`, '', dim('Enter: learn to ride')],
+      act: (a) => ridingDialog(a, entry),
+    };
+  });
+}
+
+function ridingDialog(app, entry) {
+  const mod = vendorPriceMultiplierFor(app.ds, app.ch, entry);
+  const have = app.ch.ridingSkill ?? 0;
+  const seen = new Set();
+  const opts = [];
+  for (const sp of app.ds.ridingSpells()) {
+    if (seen.has(sp.rank)) continue;
+    seen.add(sp.rank);
+    const cost = trainerSpellCost(sp.cost, mod);
+    const why = have >= sp.rank ? 'known' : sp.step > 1 && have < 75 ? 'needs Apprentice Riding' : app.ch.level < sp.reqLevel ? `level ${sp.reqLevel}` : app.ch.gold < cost ? 'not enough money' : '';
+    opts.push({ label: `${why ? dim(`Riding ${sp.rank}`) : green(`Riding ${sp.rank}`)}  ${dim(`level ${sp.reqLevel}, ${moneyText(cost)}`)}${why ? dim(`  ${why}`) : ''}`, value: sp.rank });
+  }
+  app.pick(`${app.ds.creature(entry)?.name ?? 'Riding instructor'}`, opts, (rank) => {
+    const r = app.g.trainRiding(entry, rank);
+    app.result(r, r.ok ? `You learn Riding (${r.rank}) for ${moneyText(r.spent)}.` : '');
+  });
+}
+
+export const isMountItem = (it) => it != null && (it.mountSpell != null || it.mountSpeedPct != null);
+
+/** Enter on a mount in the bags: get on, or off when it is the one you ride. */
+export function toggleMount(app, entry) {
+  if (app.ch.mountedItem === entry) { app.result(app.g.dismount(), 'You dismount.'); return; }
+  app.result(app.g.useMount(entry), `You mount ${app.itemLabel(entry)}.`);
+}
+
+// ---- world objects ---------------------------------------------------------------------------------
+// Chests, books, signposts, quest objects and banners in this zone (phonecraft worldView.ts goList). Herb and
+// ore nodes stay on the gathering rows. Enter on one is interactObject; a quest object offers its quests first.
+
+function zoneObjectList(app) {
+  const ds = app.ds, g = app.g, c = app.ch, log = g.state.questlog;
+  const refs = questReferencedGoEntries(ds);
+  const view = makeGoPlayerVisibility(ds, log, !!c.skills?.fishing);
+  const seen = new Set(), out = [];
+  const add = (go) => { if (go && !seen.has(go.entry)) { seen.add(go.entry); out.push(go); } };
+  for (const go of zoneGameObjects(ds, c.zoneId)) if (zoneGoListedForPlayer(ds, go, refs, view)) add(go);
+  for (const e of questTargets(ds, log).objects) { const go = ds.gameObject(e); if (go && zoneGoListedForPlayer(ds, go, refs, view)) add(go); }
+  for (const w of pruneWildSummoned(g.state.wildSummonedObjects, Date.now())) add(ds.gameObject(w.goEntry));
+  // Meeting stones are not in the zone lists: they stand by the portals of this zone's dungeons.
+  for (const stone of meetingStonesForPortalZone(ds, c.zoneId)) add(stone);
+  for (const o of offeredQuests(ds, c.zoneId, c, log)) if (o.quest.goStarter) add(ds.gameObject(o.quest.goStarter));
+  for (const qs of log.quests) if (qs.status !== 'turnedIn') { const q = ds.quest(qs.entry); if (q?.goEnder) add(ds.gameObject(q.goEnder)); }
+  return out;
+}
+
+function goOffer(app, go) {
+  if (!isGoQuestGiver(go)) return null;
+  const c = app.ch, log = app.g.state.questlog;
+  return goQuestGiverOffer(go, log, { level: c.level, classId: c.cls, raceId: c.race, questStatus: questStatusFromLog(log) }, (e) => app.ds.quest(e), app.g.state.inventory, {
+    questDefFor: (id) => app.ds.quest(id),
+    fallbackStarted: !go.questsStarted?.length ? offeredQuests(app.ds, c.zoneId, c, log).filter((o) => o.quest.goStarter === go.entry).map((o) => o.quest.entry) : undefined,
+    fallbackEnded: !go.questsEnded?.length ? log.quests.filter((qs) => app.ds.quest(qs.entry)?.goEnder === go.entry).map((qs) => qs.entry) : undefined,
+  });
+}
+
+export function objectRows(app) {
+  const list = zoneObjectList(app);
+  if (!list.length) return [];
+  const rows = [{ text: '', header: true }, { text: `Objects (${list.length})`, header: true }];
+  const rt = app.g.state.goRuntime ?? {};
+  for (const go of list) {
+    const offer = goOffer(app, go);
+    const mark = offer ? goDialogMarkerFromOffer(offer) : null;
+    const tag = mark === 'reward' ? green('? ') : mark === 'available' ? yellow('! ') : mark === 'incomplete' ? dim('? ') : '';
+    const avail = goRuntimeAvailability(rt[`${app.ch.zoneId}:${go.entry}`], Date.now());
+    const verb = interactVerbForGoType(go.type);
+    const state = avail.kind === 'consumed' ? dim('  gone') : avail.kind === 'restock' ? dim(`  back in ${Math.ceil((avail.readyAtMs - Date.now()) / 1000)}s`) : dim(`  ${verb.toLowerCase()}`);
+    rows.push({
+      text: `${tag}${go.name}${state}`, data: { object: go },
+      detail: () => [
+        bold(go.name), '',
+        ...(offer ? [
+          ...offer.acceptable.map((q) => yellow(`! ${app.ds.quest(q)?.title}`)),
+          ...offer.turnInReady.map((q) => green(`? ${app.ds.quest(q)?.title}`)),
+          ...offer.incomplete.map((q) => dim(`? ${app.ds.quest(q)?.title} (in progress)`)),
+        ] : []),
+        '', dim(`Enter: ${verb.toLowerCase()}`),
+      ],
+      act: (a) => useObject(a, go),
+    });
+  }
+  return rows;
+}
+
+/** Enter on an object: its quests if it has any to give or take, else use it (open, read, take). */
+export function useObject(app, go) {
+  if (go.meetingstone?.areaId) { meetingStoneMenu(app, go); return; }
+  const offer = goOffer(app, go);
+  if (offer && (offer.acceptable.length || offer.turnInReady.length)) {
+    const opts = [
+      ...offer.turnInReady.map((q) => ({ label: `${green('?')} ${app.ds.quest(q)?.title}`, value: () => app.push(questDialog(app, app.ds.quest(q), 'log')) })),
+      ...offer.acceptable.map((q) => ({ label: `${yellow('!')} ${app.ds.quest(q)?.title}`, value: () => app.push(questDialog(app, app.ds.quest(q), 'offer')) })),
+      { label: dim(interactVerbForGoType(go.type)), value: () => interact(app, go) },
+    ];
+    app.pick(go.name, opts, (fn) => fn());
+    return;
+  }
+  interact(app, go);
+}
+
+function interact(app, go) {
+  const r = app.g.interactObject(go.entry, { hold: true });
+  if (!app.result(r)) return;
+  const verb = interactVerbForGoType(go.type).toLowerCase();
+  if (r.mailboxOpen) { app.push(mailDialog(app)); return; }
+  if (r.boarded) { afterDeparture(app, () => `You ride to ${app.zone()?.name}.`); return; }
+  if (r.pageId > 0) { app.push(bookDialog(app, go.name, r.pageId)); return; }
+  if (r.keyUsed) app.say(dim(`The ${app.itemLabel(r.keyUsed)} turns.`));
+  if (app.g.pendingLoot()) {
+    app.say(green(`You ${verb} ${go.name}.`) + (r.workedBy ? dim(`  ${r.workedBy} works it.`) : '') + (r.skillUp ? cyan(`  Skill ${r.skillUp}.`) : ''));
+    if (autoLootOn(app)) takeAll(app);
+    openLoot(app);
+    return;
+  }
+  const bits = [
+    ...(r.questsOffered ?? []).map((q) => `${yellow('!')} ${app.ds.quest(q)?.title}`),
+    ...(r.questsTurnIn ?? []).map((q) => `${green('?')} ${app.ds.quest(q)?.title}`),
+    ...(r.questsIncomplete ?? []).map((q) => dim(`${app.ds.quest(q)?.title} is not done yet`)),
+  ];
+  app.say(`You ${verb} ${go.name}.${bits.length ? `  ${bits.join('   ')}` : r.yielded?.length ? '' : dim('  Nothing happens.')}`);
+}
+
+/** A book, plaque or letter: one page at a time; Enter on Next page turns it, b goes back. */
+export function bookDialog(app, title, firstPage) {
+  const pages = [];
+  for (let id = firstPage, n = 0; id > 0 && n < 50; n++) { const p = pageText(id); if (!p) break; pages.push(p.text); id = p.next ?? 0; }
+  const view = {
+    id: 'book', title, hint: pages.length > 1 ? 'Enter: next page' : '', noDetail: true, page: 0,
+    keys: { b: { hint: 'previous page', fn: () => { view.page = Math.max(0, view.page - 1); } } },
+    rows(a) {
+      const text = pages[view.page] ?? '(blank)';
+      const width = Math.max(40, a.layout().W - 4);
+      const rows = [{ text: `${bold(title)}  ${dim(`page ${view.page + 1} of ${pages.length}`)}`, header: true }, { text: '', header: true }];
+      for (const para of text.split(/\n/)) for (const l of wrapLines(para, width)) rows.push({ text: ` ${l}`, header: true });
+      rows.push({ text: '', header: true }, {
+        text: view.page + 1 < pages.length ? 'Next page' : 'Close',
+        act: (a2) => { if (view.page + 1 < pages.length) { view.page++; view.cursor = 0; view.scroll = 0; } else a2.pop(); },
+      });
+      return rows;
+    },
+  };
+  return view;
+}
+
+// ---- meeting stones ------------------------------------------------------------------------------------
+// The stone by a dungeon puts you (or your party) in the queue for it, as SCRIPT_COMMAND_MEETINGSTONE does; the
+// World tab shows the queue card until you leave it. Cite: LFGMgr.cpp:38-90 via engine/game/meetingStoneQueue.ts.
+
+function stonePlace(app, areaId) {
+  return instanceForMeetingStoneArea(app.ds, areaId)?.name ?? `area ${areaId}`;
+}
+
+function meetingStoneMenu(app, go) {
+  const areaId = go.meetingstone.areaId;
+  const place = stonePlace(app, areaId);
+  const q = app.g.state.meetingStoneQueue;
+  const queuedHere = q?.status === MEETINGSTONE_STATUS_JOINED_QUEUE && q.areaId === areaId;
+  const band = go.meetingstone.maxLevel ? `  ${dim(formatMeetingStoneLevel(go.meetingstone.minLevel ?? 1, go.meetingstone.maxLevel))}` : '';
+  app.pick(go.name, [
+    queuedHere
+      ? { label: 'Leave the queue', value: () => leaveQueue(app) }
+      : { label: `Join the queue for ${place}${band}`, value: () => joinQueue(app, areaId) },
+  ], (fn) => fn());
+}
+
+function joinQueue(app, areaId) {
+  const applied = applyMeetingStoneQueue({ areaId, hasGroup: (app.g.state.squad?.length ?? 0) > 0, isLeader: true });
+  const queued = meetingStoneQueueStateFromApply(applied);
+  if (!queued) { app.flashMsg('Only the party leader can queue the party.'); return; }
+  app.g.state.meetingStoneQueue = queued;
+  app.say(cyan(formatMeetingStonePlace(ERR_MEETING_STONE_IN_QUEUE_S, stonePlace(app, areaId))) + dim(queued.mode === 'group' ? '  (your party)' : ''));
+}
+
+function leaveQueue(app) {
+  const left = leaveMeetingStoneQueue(app.g.state.meetingStoneQueue);
+  if (!left.left) return;
+  app.g.state.meetingStoneQueue = null;
+  app.say(dim(formatMeetingStonePlace(ERR_MEETING_STONE_LEFT_QUEUE_S, stonePlace(app, left.areaId))));
+}
+
+/** The queue card at the top of the World tab while you are queued. */
+export function meetingStoneQueueRows(app) {
+  const q = app.g.state.meetingStoneQueue;
+  if (!q || q.status !== MEETINGSTONE_STATUS_JOINED_QUEUE) return [];
+  const place = stonePlace(app, q.areaId);
+  return [
+    { text: `${cyan('Looking for more')} for ${place}  ${dim(q.mode === 'group' ? 'your party is queued' : 'you are queued')}   ${dim('Enter: leave the queue')}`, act: (a) => leaveQueue(a) },
+    { text: '', header: true },
+  ];
+}
+
+// ---- outdoor PvP ---------------------------------------------------------------------------------------
+// Eastern Plaguelands' four towers and Silithus' silithyst count, read from the world states. Read only for now:
+// the banners are GameObject type 29 (capture point), which useGameObject has no case for, so interactObject
+// refuses before its OutdoorPvPEP capture hook runs. That is a phonecraft engine fix.
+
+const EP_TOWERS = [
+  ['Northpass Tower', GO_TOWER_BANNER_NORTHPASS, WORLD_STATE_EP_NORTHPASS_ALLIANCE, WORLD_STATE_EP_NORTHPASS_HORDE],
+  ['Crown Guard Tower', GO_TOWER_BANNER_CROWNGUARD, WORLD_STATE_EP_CROWNGUARD_ALLIANCE, WORLD_STATE_EP_CROWNGUARD_HORDE],
+  ['Eastwall Tower', GO_TOWER_BANNER_EASTWALL, WORLD_STATE_EP_EASTWALL_ALLIANCE, WORLD_STATE_EP_EASTWALL_HORDE],
+  ['Plaguewood Tower', GO_TOWER_BANNER_PLAGUEWOOD, WORLD_STATE_EP_PLAGUEWOOD_ALLIANCE, WORLD_STATE_EP_PLAGUEWOOD_HORDE],
+];
+
+export function outdoorPvpRows(app) {
+  const vars = app.g.state.worldStates;
+  const zone = app.ch.zoneId;
+  if (zone === 'easternplaguelands') {
+    const a = getVariable(vars, WORLD_STATE_EP_TOWER_COUNT_ALLIANCE), h = getVariable(vars, WORLD_STATE_EP_TOWER_COUNT_HORDE);
+    const rows = [{ text: '', header: true }, { text: `Towers  ${cyan(`Alliance ${a}`)}  ${red(`Horde ${h}`)}`, header: true }];
+    for (const [name, banner, sa, sh] of EP_TOWERS) {
+      const owner = getVariable(vars, sa) === WORLD_STATE_ADD ? cyan('Alliance') : getVariable(vars, sh) === WORLD_STATE_ADD ? red('Horde') : dim('nobody');
+      rows.push({ text: `  ${name}  ${owner}`, header: true, data: { tower: banner } });
+    }
+    return rows;
+  }
+  if (zone === 'silithus') {
+    const max = getVariable(vars, WORLD_STATE_SI_SILITHYST_MAX) || MAX_SILITHYST;
+    return [{ text: '', header: true }, { text: `Silithyst gathered  ${cyan(`Alliance ${getVariable(vars, WORLD_STATE_SI_GATHERED_A)}/${max}`)}  ${red(`Horde ${getVariable(vars, WORLD_STATE_SI_GATHERED_H)}/${max}`)}`, header: true }];
+  }
+  return [];
+}