@maka/maka-cli 5.47.0 → 5.49.0

package/bundle/typescript/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maka/maka-cli",
-  "version": "5.47.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,7 +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>;
+    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,11 +37,26 @@ 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.');
             return lines.join('\n');
         }
+        // THE MINIMAP (player request 2026-08-24): the room graph laid out
+        // 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. 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, '');
+        }
         lines.push('Exits:');
         for (const [direction, exit] of room.exits.entries()) {
             if (exit instanceof Door) {

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":"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"}
+{"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();