@maka/maka-cli 5.48.0 → 5.49.0

package/bundle/typescript/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maka/maka-cli",
-  "version": "5.48.0",
+  "version": "5.49.0",
   "type": "module",
   "summary": "A command line tool for scaffolding Meteor 2.x applications using either React.",
   "description": "A command line tool for scaffolding Meteor 2.x applications using React.",

package/bundle/typescript/src/commands/game/sideQuest/commands/map.d.ts

@@ -8,17 +8,7 @@ import { Command, ICommand } from './command.js';
 export declare class MapCommand extends Command implements ICommand {
     protected static verb: string;
     protected static description: string;
-    execute(_args?: string[]): Promise<string>;
-    /** Cardinal layout deltas; up/down and anything unmapped become
-     *  annotation lines instead of cells. */
-    private static readonly DELTAS;
-    /**
-     * Lays the scene's room graph onto a 2D grid by BFS from HERE and
-     * draws it with box-drawing characters. Collisions (two rooms
-     * competing for a cell) and non-cardinal links degrade to annotation
-     * lines -- a wrong map is worse than a short one.
-     */
-    private minimap;
+    execute(args?: string[]): Promise<string>;
     /**
      * Every room in the scene as a grid icon. ● = a live host node
      * (ice and paydata country), · = thin grid (an overlay you can

package/bundle/typescript/src/commands/game/sideQuest/commands/map.js

@@ -3,6 +3,8 @@ import { hint } from '../utilities/hints.js';
 import { Door } from '../models/door.js';
 import { isWatched, camerasLive } from '../utilities/surveillance.js';
 import { capitalCase } from 'change-case';
+import { renderMapDetailed } from '../utilities/map-view.js';
+import { getPref, setPref } from '../utilities/prefs.js';
 /**
  * On-demand exits panel, replacing the always-on blessed sidebar box.
  * Registered as both "map" and "exits". Locked ways out matter most, so
@@ -12,11 +14,22 @@ import { capitalCase } from 'change-case';
 export class MapCommand extends Command {
     static verb = 'map';
     static description = 'Where you are and every way out, with lock states. Jacked in, it lights THE GRID instead: every room as an icon -- host nodes bright, thin grid dim, air-gapped hosts dark -- because a persona jumps anywhere by name, no exits needed.';
-    async execute(_args = []) {
+    async execute(args = []) {
         const room = this.actor.currentLocation;
         if (!room) {
             return "You're nowhere. This is a bug.";
         }
+        const sub = (args[0] ?? '').toLowerCase();
+        // "map overlay": toggle the persistent icon minimap (map-overlay
+        // wave 2026-08-24) -- preference sticks across sessions.
+        if (sub === 'overlay') {
+            const on = !getPref('mapOverlay', true);
+            setPref('mapOverlay', on);
+            this.game?.updateExits(room);
+            if (!on)
+                this.game?.hideMapOverlay();
+            return on ? `The overlay flickers on -- icons in the corner of your eye.` : `The overlay winks out.`;
+        }
         // THE GRID VIEW (RAW p.217-218/235; player ruling 2026-08-23):
         // jacked in, exits are furniture -- icons and hosts are visible
         // from anywhere (only silence and air gaps hide anything), and
@@ -24,6 +37,9 @@ export class MapCommand extends Command {
         if (this.actor.plane === 'matrix') {
             return this.gridMap(room);
         }
+        // No modal (ruling 2026-08-24: the modal was scrapped after two
+        // rounds -- the docked minimap is the graphic; "map" stays the
+        // text view). "map list" is kept as a working alias.
         const lines = [`=== ${room.name.toUpperCase()} ===`];
         if (room.exits.size === 0) {
             lines.push('There are no exits here.');
@@ -33,8 +49,11 @@ export class MapCommand extends Command {
         // spatially -- ▣ marks you, ✕ marks a locked or spell-sealed way,
         // ▲/▼ flag up/down exits. Box-drawing only (no emoji -- blessed's
         // width tables, see the ui.ts patch saga). The textual exits list
-        // below stays as the detail view.
-        const mini = this.minimap(room);
+        // below stays as the detail view. Renderer shared with the modal
+        // and the icon overlay (utilities/map-view.ts).
+        const mini = renderMapDetailed(this.rooms ?? {}, room, (r, d) => this.scene.barrierSealing(r, d), {
+            visited: this.actor.visitedRooms,
+        });
         if (mini.length > 0) {
             lines.push(...mini, '');
         }
@@ -60,113 +79,6 @@ export class MapCommand extends Command {
         }
         return lines.join('\n');
     }
-    /** Cardinal layout deltas; up/down and anything unmapped become
-     *  annotation lines instead of cells. */
-    static DELTAS = {
-        north: [0, -1], south: [0, 1], east: [1, 0], west: [-1, 0],
-        northeast: [1, -1], northwest: [-1, -1], southeast: [1, 1], southwest: [-1, 1],
-    };
-    /**
-     * Lays the scene's room graph onto a 2D grid by BFS from HERE and
-     * draws it with box-drawing characters. Collisions (two rooms
-     * competing for a cell) and non-cardinal links degrade to annotation
-     * lines -- a wrong map is worse than a short one.
-     */
-    minimap(here) {
-        const allRooms = this.rooms ?? {};
-        if (Object.keys(allRooms).length < 2)
-            return [];
-        const posByRoom = new Map();
-        const roomAt = new Map();
-        const notes = [];
-        const links = [];
-        const seenLink = new Set();
-        posByRoom.set(here, { x: 0, y: 0 });
-        roomAt.set('0,0', here);
-        const queue = [here];
-        while (queue.length > 0) {
-            const r = queue.shift();
-            const p = posByRoom.get(r);
-            for (const [dirRaw, exit] of r.exits.entries()) {
-                const dir = String(dirRaw).toLowerCase();
-                const target = exit instanceof Door ? exit.getOtherSide(r) : allRooms[exit];
-                if (!target)
-                    continue;
-                const locked = exit instanceof Door && exit.checkIfLocked();
-                const sealed = !!this.scene.barrierSealing(r, dir);
-                const d = MapCommand.DELTAS[dir];
-                if (!d) {
-                    // up/down (and any exotic direction): a marker line.
-                    notes.push(`${dir === 'up' ? '▲' : dir === 'down' ? '▼' : '•'} ${capitalCase(dir)}: ${target.name}${locked || sealed ? ' ✕' : ''} -- from ${r === here ? 'here' : r.name}`);
-                    continue;
-                }
-                if (!posByRoom.has(target)) {
-                    const cand = { x: p.x + d[0], y: p.y + d[1] };
-                    const key = `${cand.x},${cand.y}`;
-                    if (!roomAt.has(key)) {
-                        posByRoom.set(target, cand);
-                        roomAt.set(key, target);
-                        queue.push(target);
-                    }
-                    else {
-                        notes.push(`• ${target.name} lies ${dir} of ${r.name} (off-grid)`);
-                        continue;
-                    }
-                }
-                const q = posByRoom.get(target);
-                const linkKey = [Math.min(p.x, q.x), Math.min(p.y, q.y), Math.max(p.x, q.x), Math.max(p.y, q.y)].join(',');
-                if (!seenLink.has(linkKey)) {
-                    seenLink.add(linkKey);
-                    links.push({ ax: p.x, ay: p.y, bx: q.x, by: q.y, blocked: locked || sealed });
-                }
-            }
-        }
-        const cells = [...posByRoom.entries()];
-        const xs = cells.map(([, p]) => p.x);
-        const ys = cells.map(([, p]) => p.y);
-        const minX = Math.min(...xs), maxX = Math.max(...xs);
-        const minY = Math.min(...ys), maxY = Math.max(...ys);
-        const LABEL = 9;
-        const CELL = LABEL + 3; // "[▣........]"
-        const GAP = 3; // horizontal connector width
-        const hLink = (x, y) => links.find(l => ((l.ax === x && l.bx === x + 1) || (l.bx === x && l.ax === x + 1)) && l.ay === y && l.by === y);
-        const vLink = (x, y) => links.find(l => ((l.ay === y && l.by === y + 1) || (l.by === y && l.ay === y + 1)) && l.ax === x && l.bx === x);
-        const out = [];
-        for (let y = minY; y <= maxY; y++) {
-            let row = '';
-            for (let x = minX; x <= maxX; x++) {
-                const r = roomAt.get(`${x},${y}`);
-                if (r) {
-                    const hasUp = [...r.exits.keys()].some(dd => String(dd).toLowerCase() === 'up');
-                    const hasDown = [...r.exits.keys()].some(dd => String(dd).toLowerCase() === 'down');
-                    const tag = `${hasUp ? '▲' : ''}${hasDown ? '▼' : ''}`;
-                    const label = (r.name.length > LABEL - tag.length ? r.name.slice(0, LABEL - tag.length - 1) + '…' : r.name).padEnd(LABEL - tag.length);
-                    row += r === here ? `[{inverse}▣${label}${tag}{/inverse}]` : `[ ${label}${tag}]`;
-                }
-                else {
-                    row += ' '.repeat(CELL);
-                }
-                if (x < maxX) {
-                    const l = hLink(x, y);
-                    row += l ? (l.blocked ? '─✕─' : '───') : ' '.repeat(GAP);
-                }
-            }
-            out.push(row.trimEnd());
-            if (y < maxY) {
-                let conn = '';
-                for (let x = minX; x <= maxX; x++) {
-                    const l = vLink(x, y);
-                    const mid = Math.floor(CELL / 2);
-                    conn += l ? ' '.repeat(mid) + (l.blocked ? '✕' : '│') + ' '.repeat(CELL - mid - 1) : ' '.repeat(CELL);
-                    if (x < maxX)
-                        conn += ' '.repeat(GAP);
-                }
-                if (conn.trim().length > 0)
-                    out.push(conn.trimEnd());
-            }
-        }
-        return [...out, ...notes];
-    }
     /**
      * Every room in the scene as a grid icon. ● = a live host node
      * (ice and paydata country), · = thin grid (an overlay you can

package/bundle/typescript/src/commands/game/sideQuest/commands/map.js.map

@@ -1 +1 @@
-{"version":3,"file":"map.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/commands/map.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAY,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C;;;;;GAKG;AACH,MAAM,OAAO,UAAW,SAAQ,OAAO;IAC3B,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC;IACpB,MAAM,CAAC,WAAW,GAAG,0OAA0O,CAAC;IAE1Q,KAAK,CAAC,OAAO,CAAC,QAAkB,EAAE;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC;QACxC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,gCAAgC,CAAC;QAC1C,CAAC;QAED,+DAA+D;QAC/D,gEAAgE;QAChE,+DAA+D;QAC/D,kEAAkE;QAClE,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAED,MAAM,KAAK,GAAa,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;QAE/D,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC1B,KAAK,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;YACvC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAED,mEAAmE;QACnE,kEAAkE;QAClE,kEAAkE;QAClE,kEAAkE;QAClE,kCAAkC;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrB,KAAK,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YACrD,IAAI,IAAI,YAAY,IAAI,EAAE,CAAC;gBACzB,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;gBAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/F,KAAK,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC,SAAS,CAAC,KAAK,MAAM,GAAG,KAAK,EAAE,CAAC,CAAC;YACjE,CAAC;iBAAM,CAAC;gBACN,KAAK,CAAC,IAAI,CAAC,OAAO,WAAW,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACzC,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACf,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAC/B,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS;oBAC1B,CAAC,CAAC,4BAA4B,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,gCAAgC,CAAC,EAAE;oBAC3F,CAAC,CAAC,0BAA0B,IAAI,CAAC,gCAAgC,CAAC,EAAE,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;6CACyC;IACjC,MAAM,CAAU,MAAM,GAAqC;QACjE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1D,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;KAC/E,CAAC;IAEF;;;;;OAKG;IACK,OAAO,CAAC,IAAU;QACxB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAClC,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,EAAE,CAAC;QAEhD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkC,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAI,GAAG,EAAgB,CAAC;QACvC,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,MAAM,KAAK,GAAY,EAAE,CAAC;QAC1B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QAEnC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACxB,MAAM,KAAK,GAAW,CAAC,IAAI,CAAC,CAAC;QAE7B,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;YACzB,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC;YAC5B,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;gBAC/C,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;gBACzC,MAAM,MAAM,GAAG,IAAI,YAAY,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAc,CAAC,CAAC;gBACtF,IAAI,CAAC,MAAM;oBAAE,SAAS;gBACtB,MAAM,MAAM,GAAG,IAAI,YAAY,IAAI,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBAC5D,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;gBACnD,MAAM,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACjC,IAAI,CAAC,CAAC,EAAE,CAAC;oBACP,qDAAqD;oBACrD,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,GAAG,MAAM,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;oBAC5K,SAAS;gBACX,CAAC;gBACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;oBAC3B,MAAM,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC9C,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC;oBAClC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;wBACrB,SAAS,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;wBAC5B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;wBACxB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBACrB,CAAC;yBAAM,CAAC;wBACN,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI,SAAS,GAAG,OAAO,CAAC,CAAC,IAAI,aAAa,CAAC,CAAC;wBACnE,SAAS;oBACX,CAAC;gBACH,CAAC;gBACD,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,MAAM,CAAE,CAAC;gBACjC,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC3G,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;oBAC3B,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;oBACtB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,IAAI,MAAM,EAAE,CAAC,CAAC;gBAChF,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAAG,CAAC,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC;QACvC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;QACrD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,CAAC,CAAC;QAChB,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,CAAG,gBAAgB;QAC1C,MAAM,GAAG,GAAG,CAAC,CAAC,CAAY,6BAA6B;QAEvD,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,CAAS,EAAqB,EAAE,CACxD,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QAClH,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,CAAS,EAAqB,EAAE,CACxD,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QAElH,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;YAClC,IAAI,GAAG,GAAG,EAAE,CAAC;YACb,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;gBAClC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBAClC,IAAI,CAAC,EAAE,CAAC;oBACN,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,IAAI,CAAC,CAAC;oBAChF,MAAM,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC;oBACpF,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;oBACvD,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;oBACvI,GAAG,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,cAAc,KAAK,GAAG,GAAG,aAAa,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,GAAG,GAAG,CAAC;gBACnF,CAAC;qBAAM,CAAC;oBACN,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC;gBACD,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;oBACb,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBACtB,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC3D,CAAC;YACH,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACxB,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC;gBACb,IAAI,IAAI,GAAG,EAAE,CAAC;gBACd,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;oBAClC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;oBACtB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;oBACjC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;oBACtG,IAAI,CAAC,GAAG,IAAI;wBAAE,IAAI,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACxC,CAAC;gBACD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;oBAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;QACD,OAAO,CAAC,GAAG,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;;;OAOG;IACK,OAAO,CAAC,IAAU;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;QACjC,MAAM,KAAK,GAAa;YACtB,kBAAkB;YAClB,6EAA6E;SAC9E,CAAC;QACF,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;QAClC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;YACtE,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO;gBACpB,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,6CAA6C,CAAC,CAAC,CAAC,WAAW,CAAC;gBAC1F,CAAC,CAAC,WAAW,CAAC;YAChB,+DAA+D;YAC/D,wBAAwB;YACxB,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAClG,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,IAAI,CAAC,KAAK,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClC,IAAI,CAAC,KAAK,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACxC,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACjE,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,IAAI,OAAO,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9H,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC"}
+{"version":3,"file":"map.js","sourceRoot":"","sources":["../../../../../../../src/commands/game/sideQuest/commands/map.ts"],"names":[],"mappings":"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"}

package/bundle/typescript/src/commands/game/sideQuest/game.d.ts

@@ -50,6 +50,9 @@ export default class Game {
     private _escArmedAt;
     private _statusBox;
     private _inputBox;
+    /** The floating icon-minimap (map-overlay wave 2026-08-24). Optional:
+     *  headless sessions never build widgets. */
+    private _mapBox?;
     private _useAi;
     private _aiRefusalAnnounced;
     private _owner?;
@@ -704,6 +707,28 @@ export default class Game {
      * pieces, not a status framework built ahead of need.
      */
     private initStatusBox;
+    /**
+     * THE MINIMAP (map-overlay wave 2026-08-24): a small icon viewport
+     * DOCKED at the top of the Mechanics column -- not floated over the
+     * log (a float occluded log text and, being numerically anchored,
+     * drifted on terminal resize; percentage geometry re-solves both).
+     * The Mechanics pane shifts down while the map is shown and takes the
+     * space back when it hides. keys:false -- a keyable box appended
+     * after the input steals focus (the "eexxiitt" bug, see initInputBox).
+     * Hidden until the first setMapOverlay with content.
+     */
+    private static readonly MAP_DOCK_ROWS;
+    private initMapBox;
+    /** Shifts the Mechanics pane down (map shown) or back up (hidden). */
+    private dockMap;
+    /**
+     * Paints (or hides) the docked minimap. Solo: updateExits feeds it
+     * from the local scene; shared runs: SharedRunSession.route feeds it
+     * from the server's per-player kind:'map' events. The preference
+     * gates both paths in one place.
+     */
+    setMapOverlay(lines: string[]): void;
+    hideMapOverlay(): void;
     /**
      * Refreshes the status box from current player state. Called after any
      * command that can change what belongs there (currently "call"/"end-call")

package/bundle/typescript/src/commands/game/sideQuest/game.js

@@ -11,6 +11,8 @@ import { pushSave, burnCloudSaveFor } from './utilities/cloud-saves.js';
 import { DOCWAGON_TIERS, RESUSC_FEE, DEATH_COMP } from './utilities/docwagon.js';
 import { isFence, LIFESTYLE_TIERS } from './utilities/commerce.js';
 import { bestFakeSin, wandRead, processArrest } from './utilities/sin.js';
+import { renderMapViewport } from './utilities/map-view.js';
+import { getPref } from './utilities/prefs.js';
 import { rollPool, formatRoll } from './utilities/dice.js';
 import { Direction } from './types/shared/direction-enum.js';
 import { Logger } from './utilities/logger.js';
@@ -141,6 +143,9 @@ export default class Game {
     _escArmedAt = 0;
     _statusBox;
     _inputBox;
+    /** The floating icon-minimap (map-overlay wave 2026-08-24). Optional:
+     *  headless sessions never build widgets. */
+    _mapBox;
     _useAi = false;
     _aiRefusalAnnounced = false;
     // ACCOUNT BINDING (ruling 2026-08-23): who this runner belongs to,
@@ -1823,6 +1828,7 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         this.initLogBox(screen);
         this.initMetaBox(screen);
         this.initStatusBox(screen);
+        this.initMapBox(screen); // docked atop the Mechanics column
         this._screen = screen;
     }
     /** The engine half of startup: scene synthesis, command registration,
@@ -2985,7 +2991,12 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
             // auto-scrolls (alwaysScroll) and keys/vi still scroll it when
             // focused -- wheel-scroll wasn't worth shells full of coordinate
             // bytes every time a session died hard.
-            tags: true // Intercept tags
+            tags: true, // Intercept tags
+            // Terminal-style flow (playtest 2026-08-24: "it would work if the
+            // text scrolled from the bottom up"): content anchors to the
+            // bottom edge and pushes upward, like a shell. Probe-verified to
+            // coexist with insertBottom, tail-follow, and PgUp paging.
+            valign: 'bottom'
         });
         this._logBox = logBox;
         // Scrolling without focus (player report: "can't scroll the game log
@@ -3093,6 +3104,8 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
             scrollable: true,
             alwaysScroll: true,
             tags: true,
+            // Bottom-up flow, same as the world log (see initLogBox).
+            valign: 'bottom',
         });
         this._metaBox = metaBox;
         // Scrolling (player report: menus render here now and PgUp/PgDn
@@ -3145,6 +3158,67 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         this._statusBox = statusBox;
         screen.append(statusBox);
     }
+    /**
+     * THE MINIMAP (map-overlay wave 2026-08-24): a small icon viewport
+     * DOCKED at the top of the Mechanics column -- not floated over the
+     * log (a float occluded log text and, being numerically anchored,
+     * drifted on terminal resize; percentage geometry re-solves both).
+     * The Mechanics pane shifts down while the map is shown and takes the
+     * space back when it hides. keys:false -- a keyable box appended
+     * after the input steals focus (the "eexxiitt" bug, see initInputBox).
+     * Hidden until the first setMapOverlay with content.
+     */
+    static MAP_DOCK_ROWS = 11; // 9 viewport rows + border
+    initMapBox(screen) {
+        const mapBox = blessed.box({
+            id: 'mapBox',
+            top: 0,
+            left: '65%',
+            width: '35%',
+            height: Game.MAP_DOCK_ROWS,
+            border: { type: 'line' },
+            style: { border: { fg: 'blue' } },
+            label: ' Map ',
+            tags: true,
+            keys: false,
+            content: '',
+            hidden: true,
+        });
+        this._mapBox = mapBox;
+        screen.append(mapBox);
+    }
+    /** Shifts the Mechanics pane down (map shown) or back up (hidden). */
+    dockMap(shown) {
+        if (!this._metaBox)
+            return;
+        this._metaBox.top = shown ? Game.MAP_DOCK_ROWS : 0;
+        this._metaBox.height = shown ? `100%-${11 + Game.MAP_DOCK_ROWS}` : '100%-11';
+    }
+    /**
+     * Paints (or hides) the docked minimap. Solo: updateExits feeds it
+     * from the local scene; shared runs: SharedRunSession.route feeds it
+     * from the server's per-player kind:'map' events. The preference
+     * gates both paths in one place.
+     */
+    setMapOverlay(lines) {
+        if (!this._mapBox)
+            return;
+        if (lines.length === 0 || !getPref('mapOverlay', true)) {
+            this.hideMapOverlay();
+            return;
+        }
+        this._mapBox.setContent(lines.join('\n'));
+        this.dockMap(true);
+        this._mapBox.show();
+        this._screen?.render();
+    }
+    hideMapOverlay() {
+        if (!this._mapBox)
+            return;
+        this._mapBox.hide();
+        this.dockMap(false);
+        this._screen?.render();
+    }
     /**
      * Refreshes the status box from current player state. Called after any
      * command that can change what belongs there (currently "call"/"end-call")
@@ -3340,7 +3414,22 @@ ${client.name} won't be remembering anything. Dead Johnsons pay nothing -- and t
         this.notePresenceAffectingChange();
     }
     updateExits(_room) {
-        // Nothing to render -- the "map" command reads live room state.
+        // THE ICON OVERLAY (map-overlay wave 2026-08-24): this hook was
+        // kept as a no-op for exactly this -- it already fires on movement
+        // (go/lock/unlock, ui.ts), scene transitions, and barrier changes.
+        // Session mode: the server's per-player kind:'map' events feed the
+        // overlay instead (SharedRunSession.route).
+        if (!this._mapBox || this.remoteSession)
+            return;
+        const here = this.player.currentLocation;
+        if (!here || this.player.plane === 'matrix') {
+            this.hideMapOverlay();
+            return;
+        }
+        this.setMapOverlay(renderMapViewport(this.scene.getRooms(), here, (r, d) => this.scene.barrierSealing(r, d), {
+            visited: this.player.visitedRooms,
+            arEyes: this.player.hasMatrixEyes(),
+        }));
     }
     updateInventory(_playerInventory, _currencyName = 'currency') {
         this.updateStatus();