@mailwoman/map-tui 10.0.0 → 10.1.0

package/out/browser.js

@@ -3,21 +3,6 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  */
-/**
- * The interactive map browser — a full-screen, alternate-screen terminal app over `MapRenderer`.
- *
- * `MapBrowser` owns exactly three things the frame-first library deliberately does not: terminal MODE (alternate
- * screen, hidden cursor, raw stdin, mouse reporting), viewport STATE (center, zoom, drag anchor), and the write path.
- * Frames still come from `MapRenderer.renderFrame` as values; `blitFrame` copies one into an `AsciifyTerminal`, whose
- * damage diff decides what actually goes down the wire.
- *
- * The pane is the terminal minus its bottom row, which is the status bar. `AsciifyTerminal` is told that size and never
- * addresses a cell outside it, so the two writers never fight over a cell.
- *
- * Every mode change made in {@link MapBrowser.start} is undone by {@link MapBrowser.restore}, which is idempotent so a
- * signal handler, an `exit` hook and the normal path can all call it. A terminal left in raw mode with mouse reporting
- * on is not a recoverable shell, so restore is the one operation that must survive any exit path.
- */
 import { errorMessage } from "@mailwoman/core/errors/schema";
 import { clamp } from "@mailwoman/core/numeric";
 import { AsciifyTerminal, cursorTo, SGR_RESET } from "@sister.software/asciify/tui";
@@ -32,40 +17,28 @@ const CURSOR_SHOW = "\u001B[?25h";
 const CLEAR_SCREEN = "\u001B[2J";
 const CLEAR_LINE = "\u001B[2K";
 const REVERSE_VIDEO = "\u001B[7m";
-/**
- * Rows reserved at the bottom of the terminal for the status bar.
- */
 const STATUS_BAR_ROWS = 1;
-/**
- * Size assumed when the output reports none. A pty opened without a window size (util-linux `script`, some CI
- * harnesses) reports 0 columns and 0 rows, which is neither an error nor a usable grid.
- */
 const FALLBACK_COLUMNS = 80;
 const FALLBACK_ROWS = 24;
 /**
- * Floor on the pane's dimensions. Below this the renderer is being asked for a grid too small to mean anything, and a
- * zero-sized one would divide by zero in the projection.
+ * A zero-sized pane would divide by zero in the projection.
  */
 const MIN_COLUMNS = 4;
 const MIN_PANE_ROWS = 1;
-/**
- * How much of the pane one arrow-key press travels. An eighth is far enough to feel like progress at a keystroke and
- * short enough that the next frame still overlaps the last.
- */
 const PAN_FRACTION = 0.125;
-/**
- * Web-Mercator's latitude cutoff — the projection is undefined at the poles, and the square tile pyramid ends here.
- */
 const MERCATOR_LATITUDE_LIMIT = 85.05112878;
 const COORDINATE_DIGITS = 4;
 /**
- * Clips a string to a cell budget, counting codepoints — the status bar's arrows are one cell each but two UTF-16
- * units, and `String.prototype.slice` would split one in half.
+ * Code-point counts keep `slice` from splitting a surrogate pair.
  */
 function clipToCells(text, cells) {
     const codePoints = Array.from(text);
     return codePoints.length <= cells ? text : codePoints.slice(0, cells).join("");
 }
+/**
+ * A full-screen terminal map browser built on `MapRenderer` that owns terminal modes,
+ * viewport state and output, leaving the bottom row as a status bar.
+ */
 export class MapBrowser {
     source;
     renderer;
@@ -85,9 +58,8 @@ export class MapBrowser {
     error = null;
     resolveExit = null;
     /**
-     * The trailing bytes of the last chunk that could not be decoded yet — a sequence the kernel split across two reads.
-     * Threading it back through `decodeInputChunk` is what keeps a split mouse report from being read as an Esc keypress
-     * (which used to quit); the decoder itself stays pure.
+     * The next `decodeInputChunk` call receives trailing bytes from an incomplete escape sequence
+     * so a mouse report split across reads does not decode as an Esc keypress.
      */
     pendingInput = "";
     onData = (chunk) => {
@@ -118,8 +90,8 @@ export class MapBrowser {
         });
     }
     /**
-     * Runs until the user quits, resolving with the process exit code (0 for a normal quit, 130 for Ctrl+C). The terminal
-     * is restored before this resolves.
+     * Runs until the user quits, resolving with the exit code (0 for a normal quit, 130 for Ctrl+C)
+     * after the terminal is restored.
      */
     async run() {
         this.start();
@@ -130,8 +102,8 @@ export class MapBrowser {
         return code;
     }
     /**
-     * Asks the browser to exit with a code. Safe to call from a signal handler, and a no-op once an exit is already under
-     * way.
+     * Asks the browser to exit with a code, ignoring calls after the first
+     * so that a signal handler may call it.
      */
     requestExit(code) {
         const resolve = this.resolveExit;
@@ -140,9 +112,6 @@ export class MapBrowser {
         this.resolveExit = null;
         resolve(code);
     }
-    /**
-     * Enters the alternate screen and takes over input. Paired with {@link restore}.
-     */
     start() {
         if (this.started)
             return;
@@ -156,10 +125,6 @@ export class MapBrowser {
         this.measure();
         this.scheduleRender();
     }
-    /**
-     * Puts the terminal back exactly as it was found. Idempotent: the normal exit path, a signal handler and a
-     * process-level `exit` hook may each call it.
-     */
     restore() {
         if (!this.started || this.restored)
             return;
@@ -197,8 +162,8 @@ export class MapBrowser {
         this.scheduleRender();
     }
     /**
-     * Moves the center by a cell delta, through world pixels so the step is the same distance on screen at every latitude
-     * — the naive degrees-per-keypress version crawls at the equator and sprints near the poles.
+     * Moves the center by a cell delta in world pixels, so one step covers the
+     * same screen distance at every latitude.
      */
     panByCells(columns, rows) {
         const center = lonLatToWorldPx(this.centerLon, this.centerLat, this.zoom);
@@ -209,9 +174,6 @@ export class MapBrowser {
         this.centerLon = wrapLongitude(lon);
         this.centerLat = clamp(lat, -MERCATOR_LATITUDE_LIMIT, MERCATOR_LATITUDE_LIMIT);
     }
-    /**
-     * Longitude/latitude at the center of a pane cell.
-     */
     cellToLonLat(column, row) {
         const center = lonLatToWorldPx(this.centerLon, this.centerLat, this.zoom);
         const originX = center.x - (this.columns * SUBPIXEL_COLUMNS_PER_CELL) / 2;
@@ -219,8 +181,7 @@ export class MapBrowser {
         return worldPxToLonLat(originX + column * SUBPIXEL_COLUMNS_PER_CELL + SUBPIXEL_COLUMNS_PER_CELL / 2, originY + row * SUBPIXEL_ROWS_PER_CELL + SUBPIXEL_ROWS_PER_CELL / 2, this.zoom);
     }
     /**
-     * Zooms one or more whole levels. With an anchor cell (the wheel's pointer), the center shifts so whatever was under
-     * the pointer stays under it; without one, the pane center holds.
+     * Zooms by whole levels, shifting the center so the point under an anchor cell stays under it.
      */
     zoomBy(delta, anchor) {
         const next = clamp(this.zoom + delta, this.source.minZoom, this.source.maxZoom);
@@ -257,8 +218,8 @@ export class MapBrowser {
         };
     }
     /**
-     * Pans relative to where the drag STARTED, not the previous motion report. Accumulating per-report deltas would
-     * drift, since each one is rounded to a whole cell.
+     * Pans relative to the drag's starting point, because summing per-report deltas
+     * would drift as each report is rounded to a whole cell.
      */
     continueDrag(column, row) {
         const anchor = this.drag;
@@ -271,27 +232,22 @@ export class MapBrowser {
         this.scheduleRender();
     }
     /**
-     * A press and release with no motion between them is a click, which centers the map — mapscii's behavior, and the
-     * reason centering waits for the release rather than acting on the press.
+     * A press and release without motion counts as a click that centers the map on the clicked cell.
      */
     endDrag() {
         const anchor = this.drag;
         this.drag = null;
         if (!anchor || anchor.moved)
             return;
-        // A wheel event between press and release moved the map out from under the click, so the cell no longer names
-        // the place the user pointed at.
+        // A zoom between press and release means the cell no longer covers the point the user clicked.
         if (anchor.zoom !== this.zoom)
             return;
         const target = this.cellToLonLat(anchor.column, anchor.row);
         this.setCenter(target.lon, target.lat);
         this.scheduleRender();
     }
-    /**
-     * Reads the terminal's size and re-sizes the pane around the status bar.
-     */
     measure() {
-        // `||` and not `??`: a pty with no window size reports 0, which is as unusable as absent.
+        // The `||` operator also replaces the 0 that a pty without a window size reports.
         const columns = Math.floor(this.output.columns || FALLBACK_COLUMNS);
         const rows = Math.floor(this.output.rows || FALLBACK_ROWS);
         this.columns = Math.max(MIN_COLUMNS, columns);
@@ -299,8 +255,8 @@ export class MapBrowser {
         this.terminal.setSize(this.columns, this.paneRows);
     }
     /**
-     * Requests a frame. Renders never overlap: a request arriving mid-render is coalesced into one more pass, so a held
-     * arrow key queues a single redraw rather than a backlog of them.
+     * Requests a frame, collapsing requests that arrive during a render into one
+     * follow-up so renders never overlap.
      */
     scheduleRender() {
         if (this.renderInFlight) {
@@ -331,12 +287,10 @@ export class MapBrowser {
         };
         try {
             const frame = await this.renderer.renderFrame(viewport);
-            // The terminal may have been restored while the tiles were in flight; writing then would paint over the
-            // user's shell.
+            // A write after restore would draw over the user's shell.
             if (this.restored)
                 return;
-            // A resize between the request and now leaves the frame the wrong shape for the pane — drop it and let the
-            // resize's own render answer instead.
+            // A resize during the render makes this frame the wrong shape and schedules its own render.
             if (frame.columns !== this.columns || frame.rows !== this.paneRows)
                 return;
             this.error = null;
@@ -360,11 +314,12 @@ export class MapBrowser {
         if (!attribution.length)
             return status;
         const credited = `${status}  © ${attribution}`;
-        // Attribution is a courtesy to the tile source, never a reason to push the controls off the bar.
+        // The attribution is dropped when it would push the controls off the bar.
         return Array.from(credited).length < this.columns ? credited : status;
     }
     drawStatusBar(attribution) {
-        // One cell short of the width: writing the bottom-right cell leaves some terminals in a pending-wrap state.
+        // The line stops one cell short because writing the bottom-right cell leaves
+        // some terminals in a pending-wrap state.
         const width = Math.max(0, this.columns - 1);
         const line = clipToCells(this.statusText(attribution), width).padEnd(width);
         this.output.write(`${cursorTo(0, this.paneRows)}${CLEAR_LINE}${REVERSE_VIDEO}${line}${SGR_RESET}`);

package/out/browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser.js","sourceRoot":"","sources":["../lib/browser.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../lib/browser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAA;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAA;AAC/C,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAA;AAEnF,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAClC,OAAO,EAAE,gBAAgB,EAAoB,aAAa,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACxF,OAAO,EACN,eAAe,EACf,yBAAyB,EACzB,sBAAsB,EACtB,eAAe,EACf,aAAa,GACb,MAAM,WAAW,CAAA;AAClB,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAGvC,MAAM,gBAAgB,GAAG,eAAe,CAAA;AACxC,MAAM,eAAe,GAAG,eAAe,CAAA;AACvC,MAAM,WAAW,GAAG,aAAa,CAAA;AACjC,MAAM,WAAW,GAAG,aAAa,CAAA;AACjC,MAAM,YAAY,GAAG,WAAW,CAAA;AAChC,MAAM,UAAU,GAAG,WAAW,CAAA;AAC9B,MAAM,aAAa,GAAG,WAAW,CAAA;AAEjC,MAAM,eAAe,GAAG,CAAC,CAAA;AAEzB,MAAM,gBAAgB,GAAG,EAAE,CAAA;AAC3B,MAAM,aAAa,GAAG,EAAE,CAAA;AAExB;;GAEG;AACH,MAAM,WAAW,GAAG,CAAC,CAAA;AACrB,MAAM,aAAa,GAAG,CAAC,CAAA;AAEvB,MAAM,YAAY,GAAG,KAAK,CAAA;AAE1B,MAAM,uBAAuB,GAAG,WAAW,CAAA;AAE3C,MAAM,iBAAiB,GAAG,CAAC,CAAA;AA+C3B;;GAEG;AACH,SAAS,WAAW,CAAC,IAAY,EAAE,KAAa;IAC/C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAEnC,OAAO,UAAU,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;AAC/E,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,UAAU;IACL,MAAM,CAAY;IAClB,QAAQ,CAAa;IACrB,KAAK,CAAc;IACnB,MAAM,CAAe;IACrB,QAAQ,CAAiB;IAElC,SAAS,CAAQ;IACjB,SAAS,CAAQ;IACjB,IAAI,CAAQ;IAEZ,OAAO,GAAG,gBAAgB,CAAA;IAC1B,QAAQ,GAAG,aAAa,GAAG,eAAe,CAAA;IAE1C,IAAI,GAAsB,IAAI,CAAA;IAC9B,cAAc,GAAG,KAAK,CAAA;IACtB,YAAY,GAAG,KAAK,CAAA;IACpB,OAAO,GAAG,KAAK,CAAA;IACf,QAAQ,GAAG,KAAK,CAAA;IAChB,KAAK,GAAkB,IAAI,CAAA;IAC3B,WAAW,GAAoC,IAAI,CAAA;IAE3D;;;OAGG;IACK,YAAY,GAAG,EAAE,CAAA;IAER,MAAM,GAAG,CAAC,KAAa,EAAQ,EAAE;QACjD,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,CAAC,CAAA;QAE1D,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,OAAO,CAAA;QAEnC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAA;QACxB,CAAC;IACF,CAAC,CAAA;IAEgB,QAAQ,GAAG,GAAS,EAAE;QACtC,IAAI,CAAC,OAAO,EAAE,CAAA;QACd,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;QAC/B,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAA;QAC1B,IAAI,CAAC,cAAc,EAAE,CAAA;IACtB,CAAC,CAAA;IAED,YAAY,OAA0B;QACrC,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;QAC5B,IAAI,CAAC,QAAQ,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QAC/C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;QAC1B,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;QAE5B,IAAI,CAAC,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;QAC3C,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,uBAAuB,EAAE,uBAAuB,CAAC,CAAA;QACtF,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAE3F,IAAI,CAAC,QAAQ,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,MAAM,EAAE;YAChD,IAAI,EAAE,SAAS;YACf,UAAU,EAAE,WAAW;YACvB,kBAAkB,EAAE,IAAI;SACxB,CAAC,CAAA;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG;QACR,IAAI,CAAC,KAAK,EAAE,CAAA;QAEZ,MAAM,IAAI,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;YAClD,IAAI,CAAC,WAAW,GAAG,OAAO,CAAA;QAC3B,CAAC,CAAC,CAAA;QAEF,IAAI,CAAC,OAAO,EAAE,CAAA;QAEd,OAAO,IAAI,CAAA;IACZ,CAAC;IAED;;;OAGG;IACH,WAAW,CAAC,IAAY;QACvB,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAA;QAEhC,IAAI,CAAC,OAAO;YAAE,OAAM;QAEpB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAA;QACvB,OAAO,CAAC,IAAI,CAAC,CAAA;IACd,CAAC;IAED,KAAK;QACJ,IAAI,IAAI,CAAC,OAAO;YAAE,OAAM;QAExB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAA;QACnB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,gBAAgB,GAAG,WAAW,GAAG,YAAY,GAAG,YAAY,CAAC,CAAA;QAE/E,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,IAAI,CAAC,CAAA;QAC7B,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;QAC9B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAA;QACnB,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QAClC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;QAEvC,IAAI,CAAC,OAAO,EAAE,CAAA;QACd,IAAI,CAAC,cAAc,EAAE,CAAA;IACtB,CAAC;IAED,OAAO;QACN,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAM;QAE1C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAA;QAEpB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QACnC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;QACxC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAA;QAC9B,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;QAElB,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,aAAa,GAAG,SAAS,GAAG,WAAW,GAAG,eAAe,CAAC,CAAA;IAC7E,CAAC;IAEO,WAAW,CAAC,KAAkB;QACrC,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,MAAM;gBACV,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAA;YAE3B,KAAK,WAAW;gBACf,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;YAE7B,KAAK,KAAK;gBACT,OAAO,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;YAE3C,KAAK,MAAM;gBACV,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;YAEtC,KAAK,OAAO;gBACX,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,CAAC,CAAA;YAE1E,KAAK,OAAO;gBACX,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;YAE/C,KAAK,MAAM;gBACV,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAA;YAElD,KAAK,SAAS;gBACb,OAAO,IAAI,CAAC,OAAO,EAAE,CAAA;QACvB,CAAC;IACF,CAAC;IAEO,UAAU,CAAC,EAAU,EAAE,EAAU;QACxC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,GAAG,YAAY,CAAC,CAAC,CAAA;QACvE,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAA;QAErE,IAAI,CAAC,UAAU,CAAC,EAAE,GAAG,UAAU,EAAE,EAAE,GAAG,OAAO,CAAC,CAAA;QAC9C,IAAI,CAAC,cAAc,EAAE,CAAA;IACtB,CAAC;IAED;;;OAGG;IACK,UAAU,CAAC,OAAe,EAAE,IAAY;QAC/C,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QAEzE,MAAM,IAAI,GAAG,eAAe,CAC3B,MAAM,CAAC,CAAC,GAAG,OAAO,GAAG,yBAAyB,EAC9C,MAAM,CAAC,CAAC,GAAG,IAAI,GAAG,sBAAsB,EACxC,IAAI,CAAC,IAAI,CACT,CAAA;QAED,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;IACnC,CAAC;IAEO,SAAS,CAAC,GAAW,EAAE,GAAW;QACzC,IAAI,CAAC,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,CAAA;QACnC,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,uBAAuB,EAAE,uBAAuB,CAAC,CAAA;IAC/E,CAAC;IAEO,YAAY,CAAC,MAAc,EAAE,GAAW;QAC/C,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QACzE,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,yBAAyB,CAAC,GAAG,CAAC,CAAA;QACzE,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAA;QAEvE,OAAO,eAAe,CACrB,OAAO,GAAG,MAAM,GAAG,yBAAyB,GAAG,yBAAyB,GAAG,CAAC,EAC5E,OAAO,GAAG,GAAG,GAAG,sBAAsB,GAAG,sBAAsB,GAAG,CAAC,EACnE,IAAI,CAAC,IAAI,CACT,CAAA;IACF,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,KAAa,EAAE,MAA8C;QAC3E,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QAE/E,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI;YAAE,OAAM;QAE9B,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;YAChB,IAAI,CAAC,cAAc,EAAE,CAAA;YAErB,OAAM;QACP,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;QAE3D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAEhB,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;QAC3D,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QACzE,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QACnE,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAA;QAEnE,MAAM,SAAS,GAAG,eAAe,CAChC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EACpC,MAAM,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EACpC,IAAI,CAAC,IAAI,CACT,CAAA;QAED,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,SAAS,CAAC,GAAG,CAAC,CAAA;QAC5C,IAAI,CAAC,cAAc,EAAE,CAAA;IACtB,CAAC;IAEO,UAAU,CAAC,MAAc,EAAE,GAAW;QAC7C,OAAO,MAAM,IAAI,CAAC,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAA;IAC/E,CAAC;IAEO,SAAS,CAAC,MAAc,EAAE,GAAW;QAC5C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,GAAG,CAAC;YAAE,OAAM;QAEzC,IAAI,CAAC,IAAI,GAAG;YACX,MAAM;YACN,GAAG;YACH,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,KAAK,EAAE,KAAK;SACZ,CAAA;IACF,CAAC;IAED;;;OAGG;IACK,YAAY,CAAC,MAAc,EAAE,GAAW;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAA;QAExB,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI;YAAE,OAAM;QAEhD,MAAM,CAAC,KAAK,GAAG,IAAI,CAAA;QAEnB,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;QAE/E,MAAM,IAAI,GAAG,eAAe,CAC3B,MAAM,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,yBAAyB,EAC/D,MAAM,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG,sBAAsB,EACtD,MAAM,CAAC,IAAI,CACX,CAAA;QAED,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAA;QAClC,IAAI,CAAC,cAAc,EAAE,CAAA;IACtB,CAAC;IAED;;OAEG;IACK,OAAO;QACd,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAA;QAExB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAEhB,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,KAAK;YAAE,OAAM;QAEnC,+FAA+F;QAC/F,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI;YAAE,OAAM;QAErC,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;QAE3D,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,CAAA;QACtC,IAAI,CAAC,cAAc,EAAE,CAAA;IACtB,CAAC;IAEO,OAAO;QACd,kFAAkF;QAClF,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,gBAAgB,CAAC,CAAA;QACnE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,aAAa,CAAC,CAAA;QAE1D,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;QAC7C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,aAAa,EAAE,IAAI,GAAG,eAAe,CAAC,CAAA;QAE/D,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAA;IACnD,CAAC;IAED;;;OAGG;IACK,cAAc;QACrB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACzB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAA;YAExB,OAAM;QACP,CAAC;QAED,KAAK,IAAI,CAAC,UAAU,EAAE,CAAA;IACvB,CAAC;IAEO,KAAK,CAAC,UAAU;QACvB,IAAI,CAAC,cAAc,GAAG,IAAI,CAAA;QAE1B,IAAI,CAAC;YACJ,GAAG,CAAC;gBACH,IAAI,CAAC,YAAY,GAAG,KAAK,CAAA;gBAEzB,MAAM,IAAI,CAAC,UAAU,EAAE,CAAA;YACxB,CAAC,QAAQ,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAC;QAC9C,CAAC;gBAAS,CAAC;YACV,IAAI,CAAC,cAAc,GAAG,KAAK,CAAA;QAC5B,CAAC;IACF,CAAC;IAEO,KAAK,CAAC,UAAU;QACvB,MAAM,QAAQ,GAAG;YAChB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,QAAQ;SACnB,CAAA;QAED,IAAI,CAAC;YACJ,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAA;YAEvD,0DAA0D;YAC1D,IAAI,IAAI,CAAC,QAAQ;gBAAE,OAAM;YAEzB,4FAA4F;YAC5F,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,QAAQ;gBAAE,OAAM;YAE1E,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;YAEjB,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;YAC/B,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAA;YACrB,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;YAEhC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACpB,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAA;YACvB,CAAC;QACF,CAAC;IACF,CAAC;IAEO,UAAU,CAAC,WAAmB;QACrC,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,IAAI,CAAC,KAAK,UAAU,CAAA;QAEhD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;QACrD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;QACrD,MAAM,MAAM,GAAG,GAAG,GAAG,IAAI,GAAG,KAAK,IAAI,CAAC,IAAI,8BAA8B,CAAA;QAExE,IAAI,CAAC,WAAW,CAAC,MAAM;YAAE,OAAO,MAAM,CAAA;QAEtC,MAAM,QAAQ,GAAG,GAAG,MAAM,OAAO,WAAW,EAAE,CAAA;QAE9C,0EAA0E;QAC1E,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAA;IACtE,CAAC;IAEO,aAAa,CAAC,WAAmB;QACxC,6EAA6E;QAC7E,0CAA0C;QAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAA;QAC3C,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAE3E,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,UAAU,GAAG,aAAa,GAAG,IAAI,GAAG,SAAS,EAAE,CAAC,CAAA;IACnG,CAAC;CACD"}

package/out/cli/args.d.ts

@@ -10,8 +10,10 @@ export interface BrowseArgs {
     lat: number;
     lon: number;
     /**
-     * Integer zoom level. The renderer draws whole tile-pyramid levels, so a fractional flag value is rounded here rather
-     * than carried as a lie through the viewport.
+     * Integer zoom level.
+     *
+     * The renderer draws whole tile-pyramid levels, so a fractional flag value is rounded here
+     * rather than preserved as a lie through the viewport.
      */
     zoom: number;
 }
@@ -21,27 +23,35 @@ export type CLIArgs = {
     mode: "version";
 } | BrowseArgs;
 /**
- * A rejected command line. The message is user-facing: it says what was wrong AND what to pass instead, since the bin
- * prints it verbatim to stderr.
+ * A rejected command line.
+ *
+ * The message is user-facing: it explains what was wrong and what to pass instead,
+ * since the bin prints it verbatim to stderr.
  */
 export declare class CLIArgsError extends Error {
     name: string;
 }
 /**
- * Environment keys the CLI reads. Passed in rather than read here so the parser stays pure.
+ * Environment keys the CLI reads.
+ *
+ * Passed in rather than read here so the parser stays pure.
  */
 export interface CLIEnvironment {
     MAILWOMAN_TILES?: string | undefined;
 }
 /**
- * `--help` output. It doubles as the package's key reference, so the bindings listed here and the ones ./input.ts
- * decodes are the same list said twice — a key added there without a line here is a key nobody finds.
+ * `--help` output.
+ *
+ * It doubles as the package's key reference, so the bindings listed here
+ * and the ones ./input.ts decodes are the same list said twice.
+ * A key added there without a line here is missing from CLI help.
  */
 export declare const HELP_TEXT = "map-tui \u2014 the whole world in your terminal\n\nUsage\n  npx @mailwoman/map-tui --tiles <archive.pmtiles> [options]\n\nOptions\n  --tiles <path|url>  PMTiles archive \u2014 local path or https:// URL (default: $MAILWOMAN_TILES)\n  --lat <degrees>   Initial center latitude, -90..90 (default: 0)\n  --lon <degrees>   Initial center longitude, -180..180 (default: 0)\n  --zoom <level>    Initial zoom, 0..24 (default: 2)\n  -h, --help        Print this help and exit\n  -v, --version     Print the package version and exit\n\nKeys\n  arrows, hjkl      Pan\n  +, =, a           Zoom in\n  -, _, z           Zoom out\n  q, Esc, Ctrl+C    Quit\n\nMouse\n  Wheel zooms toward the pointer, drag pans, click centers.\n\nTiles are never bundled with this package. Download a planet or region\narchive from https://protomaps.com/downloads and point --tiles at it.\n";
 /**
  * Parses a `map-tui` command line.
  *
- * @throws {CLIArgsError} On an unknown flag, an unparseable or out-of-range number, or a missing archive path.
+ * @throws {CLIArgsError} On an unknown flag, an unparseable or out-of-range number,
+ * or a missing archive path.
  */
 export declare function parseCLIArgs(argv: readonly string[], environment?: CLIEnvironment): CLIArgs;
 //# sourceMappingURL=args.d.ts.map

package/out/cli/args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../lib/cli/args.ts"],"names":[],"mappings":"AAmDA;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,QAAQ,CAAA;IACd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG,UAAU,CAAA;AAEzE;;;GAGG;AACH,qBAAa,YAAa,SAAQ,KAAK;IAC7B,IAAI,SAAiB;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACpC;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,+1BAwBrB,CAAA;AA0FD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,WAAW,GAAE,cAAmB,GAAG,OAAO,CAuB/F"}
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../../cli/args.ts"],"names":[],"mappings":"AA0DA;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,QAAQ,CAAA;IACd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX;;;;;OAKG;IACH,IAAI,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,MAAM,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GAAG,UAAU,CAAA;AAEzE;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,KAAK;IAC7B,IAAI,SAAiB;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC9B,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACpC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,+1BAwBrB,CAAA;AA8FD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,WAAW,GAAE,cAAmB,GAAG,OAAO,CAuB/F"}

package/out/cli/args.js

@@ -1,4 +1,5 @@
 import { errorMessage } from "@mailwoman/core/errors/schema";
+import { stringifyJSON } from "@mailwoman/core/json";
 import { parseArguments } from "@mailwoman/core/scripting/arguments";
 /**
  * @copyright Sister Software.
@@ -8,9 +9,12 @@ import { parseArguments } from "@mailwoman/core/scripting/arguments";
 /**
  * Argument parsing for the `map-tui` bin.
  *
- * `parseCLIArgs` is pure: it takes the argv slice and an environment record, and answers with a discriminated result
- * (`help` / `version` / `browse`) or throws {@link CLIArgsError}. Reading `process.argv` / `process.env` is the bin's
- * job (./cli.ts), which keeps every rejection path testable without a subprocess.
+ * `parseCLIArgs` is pure.
+ * It takes the argv array and an environment record, then returns a discriminated
+ * result (`help` / `version` / `browse`) or throws {@link CLIArgsError}.
+ *
+ * The bin (`./cli.ts`) reads `process.argv` and `process.env`.
+ * This keeps every rejection path testable without a subprocess.
  */
 /**
  * Center longitude when `--lon` is omitted — the world view mapscii opens on.
@@ -21,8 +25,8 @@ const DEFAULT_LON = 0;
  */
 const DEFAULT_LAT = 0;
 /**
- * Zoom when `--zoom` is omitted. z2 shows a full hemisphere in a typical terminal, so a planet archive opens on
- * something recognizable rather than a single ocean tile.
+ * Zoom when `--zoom` is omitted. z2 shows a full hemisphere in a typical terminal,
+ * so a planet archive opens on something recognizable rather than a single ocean tile.
  */
 const DEFAULT_ZOOM = 2;
 /**
@@ -30,27 +34,34 @@ const DEFAULT_ZOOM = 2;
  */
 const MIN_ZOOM = 0;
 /**
- * Deepest zoom the Web-Mercator tile pyramid is defined for. The archive's own `maxZoom` clamps further at runtime;
- * this is only the range a flag value must fall inside to be meaningful at all.
+ * Deepest zoom the Web-Mercator tile pyramid is defined for.
+ *
+ * The archive's own `maxZoom` clamps further at runtime.
+ * This is only the range a flag value must fall inside to be meaningful at all.
  */
 const MAX_ZOOM = 24;
-// True geographic bounds, not Web-Mercator's ±85.05113: the flag accepts any real latitude, and the browser clamps
-// the CENTER to the projection's MERCATOR_LATITUDE_LIMIT itself (see ./browser.ts) — rejecting 87 here would refuse a
-// value the viewport handles fine.
+// The flag accepts any real latitude.
+// The browser clamps the center to the projection's MERCATOR_LATITUDE_LIMIT (see ./browser.ts) —
+// rejecting 87 here would refuse a value the viewport handles fine.
 const MIN_LAT = -90;
 const MAX_LAT = 90;
 const MIN_LON = -180;
 const MAX_LON = 180;
 /**
- * A rejected command line. The message is user-facing: it says what was wrong AND what to pass instead, since the bin
- * prints it verbatim to stderr.
+ * A rejected command line.
+ *
+ * The message is user-facing: it explains what was wrong and what to pass instead,
+ * since the bin prints it verbatim to stderr.
  */
 export class CLIArgsError extends Error {
     name = "CLIArgsError";
 }
 /**
- * `--help` output. It doubles as the package's key reference, so the bindings listed here and the ones ./input.ts
- * decodes are the same list said twice — a key added there without a line here is a key nobody finds.
+ * `--help` output.
+ *
+ * It doubles as the package's key reference, so the bindings listed here
+ * and the ones ./input.ts decodes are the same list said twice.
+ * A key added there without a line here is missing from CLI help.
  */
 export const HELP_TEXT = `map-tui — the whole world in your terminal
 
@@ -78,15 +89,15 @@ Tiles are never bundled with this package. Download a planet or region
 archive from https://protomaps.com/downloads and point --tiles at it.
 `;
 /**
- * Reads one numeric flag, rejecting anything `Number` would quietly accept as garbage (empty string, whitespace,
- * `Infinity`) as well as out-of-range values.
+ * Reads one numeric flag, rejecting anything `Number` would quietly accept as garbage
+ * (empty string, whitespace, `Infinity`) as well as out-of-range values.
  */
 function numericFlag(name, raw, fallback, min, max) {
     if (raw == null)
         return fallback;
     const value = Number(raw.trim());
     if (!Number.isFinite(value) || !raw.trim().length) {
-        throw new CLIArgsError(`--${name} expects a number, got ${JSON.stringify(raw)}`);
+        throw new CLIArgsError(`--${name} expects a number, got ${stringifyJSON(raw)}`);
     }
     if (value < min || value > max) {
         throw new CLIArgsError(`--${name} must be between ${min} and ${max}, got ${value}`);
@@ -94,16 +105,20 @@ function numericFlag(name, raw, fallback, min, max) {
     return value;
 }
 /**
- * Flags whose value is a number, and may therefore start with a dash.
+ * Flags with numeric values.
+ * Their values may start with a dash.
  */
 const NUMERIC_FLAGS = new Set(["--lat", "--lon", "--zoom"]);
 /**
  * Joins `--lon -122.6` into `--lon=-122.6` before `parseArgs` sees it.
  *
- * `node:util`'s parser refuses a separate value that starts with a dash — it cannot tell a negative number from a
- * mistyped flag, and says so ("argument is ambiguous"). Half the planet has a negative longitude, so the space-form has
- * to work. The join is conditional on the next token parsing as a finite number, which leaves a genuinely missing value
- * (`--lon --zoom 3`) to `parseArgs` and its own error.
+ * `node:util`'s parser refuses a separate value that starts with a dash.
+ * It reports "argument is ambiguous" because a negative number can resemble a mistyped flag.
+ *
+ * Half the planet has a negative longitude, so the space-form has to work.
+ *
+ * The join occurs only when the next token parses as a finite number.
+ * `parseArgs` then handles a missing value such as `--lon --zoom 3` and returns its own error.
  */
 function joinNegativeNumbers(argv) {
     const joined = [];
@@ -120,8 +135,8 @@ function joinNegativeNumbers(argv) {
     return joined;
 }
 /**
- * `node:util`'s own rejections (unknown flag, missing value) name the flag but not the remedy, so they're re-thrown as
- * a {@link CLIArgsError} pointing at `--help`.
+ * `node:util`'s own rejections (unknown flag, missing value) name the flag but not the action,
+ * so they're re-thrown as a {@link CLIArgsError} pointing at `--help`.
  */
 function readFlags(argv) {
     try {
@@ -147,7 +162,8 @@ function readFlags(argv) {
 /**
  * Parses a `map-tui` command line.
  *
- * @throws {CLIArgsError} On an unknown flag, an unparseable or out-of-range number, or a missing archive path.
+ * @throws {CLIArgsError} On an unknown flag, an unparseable or out-of-range number,
+ * or a missing archive path.
  */
 export function parseCLIArgs(argv, environment = {}) {
     const values = readFlags(argv);

package/out/cli/args.js.map

@@ -1 +1 @@
-{"version":3,"file":"args.js","sourceRoot":"","sources":["../../lib/cli/args.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../cli/args.ts"],"names":[],"mappings":"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"}

package/out/cli/{index.d.ts → main.d.ts}

@@ -5,4 +5,4 @@
  * @author Teffen Ellis, et al.
  */
 export {};
-//# sourceMappingURL=index.d.ts.map
+//# sourceMappingURL=main.d.ts.map

package/out/cli/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../cli/main.ts"],"names":[],"mappings":";AAEA;;;;GAIG"}

package/out/cli/{index.js → main.js}

@@ -5,17 +5,11 @@
  * @author Teffen Ellis, et al.
  */
 /**
- * The `map-tui` bin — `npx @mailwoman/map-tui` opens a PMTiles archive as a full-screen terminal map.
+ * Opens a PMTiles archive as a full-screen terminal map through the `map-tui` binary.
  *
- * This file owns everything process-shaped so the rest of the package stays testable without one: argv and the
- * environment (parsed by ./cli-args.ts), the archive handle, signal handlers, and the exit code. `MapBrowser` takes
- * streams rather than reaching for `process` itself, which is what lets the PTY smoke test drive the real bin and a
- * unit test drive the parser with neither.
- *
- * Signal handling is not optional here. This is a raw-mode app on the alternate screen with mouse reporting on, and
- * there is no framework underneath to put any of that back — a process killed between `start` and `restore` leaves the
- * user with an unusable shell. So `restore` is wired to SIGINT, SIGTERM and `exit`, and it is idempotent for exactly
- * that reason.
+ * This file is the only place in the package that touches `process`.
+ * It restores the terminal on SIGINT, SIGTERM and `exit`, because a process killed
+ * while in raw mode leaves the shell unusable.
  */
 import { errorMessage } from "@mailwoman/core/errors/schema";
 import { createRequire } from "@mailwoman/core/module/resolvers";
@@ -27,11 +21,10 @@ import { TileSource } from "#tile-source";
  */
 const EXIT_USAGE = 1;
 /**
- * Reads the package's own version.
+ * Reads the package version.
  *
- * Self-reference (`@mailwoman/map-tui/...`, which the package's `exports` publishes) rather than a path relative to
- * this file: the bin runs from `out/` when installed and from the workspace root in development, and only the package
- * graph knows which. `createRequire` parses the JSON itself, so no reader here has to.
+ * The package self-reference resolves correctly both from the installed `out/`
+ * directory and from the workspace.
  */
 function readVersion() {
     const require = createRequire(import.meta.url);
@@ -39,7 +32,7 @@ function readVersion() {
     return manifest.version ?? "0.0.0";
 }
 /**
- * Opens the archive, translating the filesystem's error into something that names the flag that was wrong.
+ * Opens the tile archive and reports a failure as a usage error that mentions `--tiles`.
  */
 async function openTiles(path) {
     try {
@@ -51,7 +44,7 @@ async function openTiles(path) {
     }
 }
 /**
- * Runs the interactive browser against an already-open archive, resolving with its exit code.
+ * Runs the interactive browser on an open archive and resolves with its exit code.
  */
 async function browse(source, args) {
     const browser = new MapBrowser({
@@ -80,11 +73,8 @@ async function browse(source, args) {
 async function main() {
     let args;
     try {
-        /**
-         * `parseCLIArgs` keeps argv and the environment read on this one line, and nowhere else in the package —
-         * `@mailwoman/core/env`'s typed readers would pull core's data-backed environment schema behind a CLI whose whole
-         * premise is `npx`, so the bin passes the raw records to the pure parser instead.
-         */
+        // The bin reads raw argv and env here because `@mailwoman/core/env` depends on core's data-backed schema,
+        // Core's data-backed schema is too heavy for an `npx` entry point.
         // oxlint-disable-next-line sister-software/no-process-globals -- see above.
         args = parseCLIArgs(process.argv.slice(2), process.env);
     }
@@ -103,8 +93,7 @@ async function main() {
         return 0;
     }
     let opened;
-    // A bad `--tiles` path is a usage error, not a crash — the guard stays around the open, and ownership passes to the
-    // `using` declaration only once the open succeeded.
+    // The `using` declaration takes ownership only after the open succeeds.
     try {
         opened = await openTiles(args.tiles);
     }
@@ -116,4 +105,4 @@ async function main() {
     return await browse(source, args);
 }
 process.exitCode = await main();
-//# sourceMappingURL=index.js.map
+//# sourceMappingURL=main.js.map

package/out/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../cli/main.ts"],"names":[],"mappings":"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"}