@mailwoman/map-tui 9.1.0 → 9.2.0

package/out/browser.d.ts

@@ -0,0 +1,126 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import type { TileSource } from "./tile-source.ts";
+/**
+ * The subset of a readable stream the browser drives. Structural so `process.stdin` satisfies it without the app being
+ * welded to it — the same reasoning asciify applies to its own output type.
+ */
+export interface BrowserInput {
+    setRawMode?(mode: boolean): unknown;
+    setEncoding(encoding: "utf8"): unknown;
+    resume(): unknown;
+    pause(): unknown;
+    on(event: "data", listener: (chunk: string) => void): unknown;
+    off(event: "data", listener: (chunk: string) => void): unknown;
+}
+/**
+ * The subset of a writable terminal the browser drives.
+ */
+export interface BrowserOutput {
+    write(chunk: string): unknown;
+    columns?: number | undefined;
+    rows?: number | undefined;
+    on(event: "resize", listener: () => void): unknown;
+    off(event: "resize", listener: () => void): unknown;
+}
+export interface MapBrowserOptions {
+    source: TileSource;
+    input: BrowserInput;
+    output: BrowserOutput;
+    lat: number;
+    lon: number;
+    zoom: number;
+}
+export declare class MapBrowser {
+    private readonly source;
+    private readonly renderer;
+    private readonly input;
+    private readonly output;
+    private readonly terminal;
+    private centerLon;
+    private centerLat;
+    private zoom;
+    private columns;
+    private paneRows;
+    private drag;
+    private renderInFlight;
+    private renderQueued;
+    private started;
+    private restored;
+    private error;
+    private resolveExit;
+    /**
+     * 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.
+     */
+    private pendingInput;
+    private readonly onData;
+    private readonly onResize;
+    constructor(options: MapBrowserOptions);
+    /**
+     * 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.
+     */
+    run(): Promise<number>;
+    /**
+     * 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.
+     */
+    requestExit(code: number): void;
+    /**
+     * Enters the alternate screen and takes over input. Paired with {@link restore}.
+     */
+    start(): void;
+    /**
+     * 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(): void;
+    private handleInput;
+    private panBySteps;
+    /**
+     * 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.
+     */
+    private panByCells;
+    private setCenter;
+    /**
+     * Longitude/latitude at the center of a pane cell.
+     */
+    private cellToLonLat;
+    /**
+     * 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.
+     */
+    private zoomBy;
+    private withinPane;
+    private beginDrag;
+    /**
+     * 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.
+     */
+    private continueDrag;
+    /**
+     * 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.
+     */
+    private endDrag;
+    /**
+     * Reads the terminal's size and re-sizes the pane around the status bar.
+     */
+    private measure;
+    /**
+     * 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.
+     */
+    private scheduleRender;
+    private renderLoop;
+    private renderOnce;
+    private statusText;
+    private drawStatusBar;
+}
+//# sourceMappingURL=browser.d.ts.map

package/out/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../browser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAwBH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAgDlD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B,UAAU,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAA;IACnC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAA;IACtC,MAAM,IAAI,OAAO,CAAA;IACjB,KAAK,IAAI,OAAO,CAAA;IAChB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAA;IAC7D,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAA;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAA;IAClD,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAA;CACnD;AAED,MAAM,WAAW,iBAAiB;IACjC,MAAM,EAAE,UAAU,CAAA;IAClB,KAAK,EAAE,YAAY,CAAA;IACnB,MAAM,EAAE,aAAa,CAAA;IACrB,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;CACZ;AAkCD,qBAAa,UAAU;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAa;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAE1C,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,IAAI,CAAQ;IAEpB,OAAO,CAAC,OAAO,CAAmB;IAClC,OAAO,CAAC,QAAQ,CAAkC;IAElD,OAAO,CAAC,IAAI,CAA0B;IACtC,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,WAAW,CAAwC;IAE3D;;;;OAIG;IACH,OAAO,CAAC,YAAY,CAAK;IAEzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAQtB;IAED,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAKxB;gBAEW,OAAO,EAAE,iBAAiB;IAiBtC;;;OAGG;IACG,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC;IAY5B;;;OAGG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAS/B;;OAEG;IACH,KAAK,IAAI,IAAI;IAgBb;;;OAGG;IACH,OAAO,IAAI,IAAI;IAaf,OAAO,CAAC,WAAW;IA4BnB,OAAO,CAAC,UAAU;IAQlB;;;OAGG;IACH,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,SAAS;IAKjB;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB;;;OAGG;IACH,OAAO,CAAC,MAAM;IA+Bd,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,SAAS;IAajB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAmBpB;;;OAGG;IACH,OAAO,CAAC,OAAO;IAiBf;;OAEG;IACH,OAAO,CAAC,OAAO;IAWf;;;OAGG;IACH,OAAO,CAAC,cAAc;YAUR,UAAU;YAcV,UAAU;IAkCxB,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,aAAa;CAOrB"}

package/out/browser.js

@@ -0,0 +1,386 @@
+/**
+ * @copyright Sister Software.
+ * @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 { AsciifyTerminal, cursorTo, SGR_RESET } from "@sister.software/asciify/tui";
+import { blitFrame } from "./frame.js";
+import { decodeInputChunk, MOUSE_DISABLE, MOUSE_ENABLE } from "./input.js";
+import { lonLatToWorldPx, worldPxToLonLat } from "./mercator.js";
+import { MapRenderer } from "./renderer.js";
+const ALT_SCREEN_ENTER = "\u001B[?1049h";
+const ALT_SCREEN_EXIT = "\u001B[?1049l";
+const CURSOR_HIDE = "\u001B[?25l";
+const CURSOR_SHOW = "\u001B[?25h";
+const CLEAR_SCREEN = "\u001B[2J";
+const CLEAR_LINE = "\u001B[2K";
+const REVERSE_VIDEO = "\u001B[7m";
+/**
+ * Subpixel dimensions of one braille cell — the unit every viewport-space conversion below works in.
+ */
+const SUBPIXELS_PER_COLUMN = 2;
+const SUBPIXELS_PER_ROW = 4;
+/**
+ * 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.
+ */
+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;
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+/**
+ * Wraps a longitude into [-180, 180) so panning past the antimeridian continues rather than running off the pyramid.
+ */
+function wrapLongitude(lon) {
+    const wrapped = (((lon + 180) % 360) + 360) % 360;
+    return wrapped - 180;
+}
+/**
+ * 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 cut one in half.
+ */
+function clipToCells(text, cells) {
+    const codePoints = Array.from(text);
+    return codePoints.length <= cells ? text : codePoints.slice(0, cells).join("");
+}
+export class MapBrowser {
+    source;
+    renderer;
+    input;
+    output;
+    terminal;
+    centerLon;
+    centerLat;
+    zoom;
+    columns = FALLBACK_COLUMNS;
+    paneRows = FALLBACK_ROWS - STATUS_BAR_ROWS;
+    drag = null;
+    renderInFlight = false;
+    renderQueued = false;
+    started = false;
+    restored = false;
+    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.
+     */
+    pendingInput = "";
+    onData = (chunk) => {
+        const decoded = decodeInputChunk(chunk, this.pendingInput);
+        this.pendingInput = decoded.pending;
+        for (const event of decoded.events) {
+            this.handleInput(event);
+        }
+    };
+    onResize = () => {
+        this.measure();
+        this.output.write(CLEAR_SCREEN);
+        this.terminal.invalidate();
+        this.scheduleRender();
+    };
+    constructor(options) {
+        this.source = options.source;
+        this.renderer = new MapRenderer(options.source);
+        this.input = options.input;
+        this.output = options.output;
+        this.centerLon = wrapLongitude(options.lon);
+        this.centerLat = clamp(options.lat, -MERCATOR_LATITUDE_LIMIT, MERCATOR_LATITUDE_LIMIT);
+        this.zoom = clamp(Math.round(options.zoom), options.source.minZoom, options.source.maxZoom);
+        this.terminal = new AsciifyTerminal(this.output, {
+            mode: "braille",
+            colorDepth: "truecolor",
+            synchronizedOutput: true,
+        });
+    }
+    /**
+     * 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.
+     */
+    async run() {
+        this.start();
+        const code = await new Promise((resolve) => {
+            this.resolveExit = resolve;
+        });
+        this.restore();
+        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.
+     */
+    requestExit(code) {
+        const resolve = this.resolveExit;
+        if (!resolve)
+            return;
+        this.resolveExit = null;
+        resolve(code);
+    }
+    /**
+     * Enters the alternate screen and takes over input. Paired with {@link restore}.
+     */
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        this.output.write(ALT_SCREEN_ENTER + CURSOR_HIDE + CLEAR_SCREEN + MOUSE_ENABLE);
+        this.input.setRawMode?.(true);
+        this.input.setEncoding("utf8");
+        this.input.resume();
+        this.input.on("data", this.onData);
+        this.output.on("resize", this.onResize);
+        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;
+        this.restored = true;
+        this.input.off("data", this.onData);
+        this.output.off("resize", this.onResize);
+        this.input.setRawMode?.(false);
+        this.input.pause();
+        this.output.write(MOUSE_DISABLE + SGR_RESET + CURSOR_SHOW + ALT_SCREEN_EXIT);
+    }
+    handleInput(event) {
+        switch (event.kind) {
+            case "quit":
+                return this.requestExit(0);
+            case "interrupt":
+                return this.requestExit(130);
+            case "pan":
+                return this.panBySteps(event.dx, event.dy);
+            case "zoom":
+                return this.zoomBy(event.delta, null);
+            case "wheel":
+                return this.zoomBy(event.delta, { column: event.column, row: event.row });
+            case "press":
+                return this.beginDrag(event.column, event.row);
+            case "drag":
+                return this.continueDrag(event.column, event.row);
+            case "release":
+                return this.endDrag();
+        }
+    }
+    panBySteps(dx, dy) {
+        const columnStep = Math.max(1, Math.round(this.columns * PAN_FRACTION));
+        const rowStep = Math.max(1, Math.round(this.paneRows * PAN_FRACTION));
+        this.panByCells(dx * columnStep, dy * rowStep);
+        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.
+     */
+    panByCells(columns, rows) {
+        const center = lonLatToWorldPx(this.centerLon, this.centerLat, this.zoom);
+        const next = worldPxToLonLat(center.x + columns * SUBPIXELS_PER_COLUMN, center.y + rows * SUBPIXELS_PER_ROW, this.zoom);
+        this.setCenter(next.lon, next.lat);
+    }
+    setCenter(lon, lat) {
+        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 * SUBPIXELS_PER_COLUMN) / 2;
+        const originY = center.y - (this.paneRows * SUBPIXELS_PER_ROW) / 2;
+        return worldPxToLonLat(originX + column * SUBPIXELS_PER_COLUMN + SUBPIXELS_PER_COLUMN / 2, originY + row * SUBPIXELS_PER_ROW + SUBPIXELS_PER_ROW / 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.
+     */
+    zoomBy(delta, anchor) {
+        const next = clamp(this.zoom + delta, this.source.minZoom, this.source.maxZoom);
+        if (next === this.zoom)
+            return;
+        if (!anchor || !this.withinPane(anchor.column, anchor.row)) {
+            this.zoom = next;
+            this.scheduleRender();
+            return;
+        }
+        const target = this.cellToLonLat(anchor.column, anchor.row);
+        this.zoom = next;
+        const landed = this.cellToLonLat(anchor.column, anchor.row);
+        const center = lonLatToWorldPx(this.centerLon, this.centerLat, this.zoom);
+        const targetPx = lonLatToWorldPx(target.lon, target.lat, this.zoom);
+        const landedPx = lonLatToWorldPx(landed.lon, landed.lat, this.zoom);
+        const corrected = worldPxToLonLat(center.x + (targetPx.x - landedPx.x), center.y + (targetPx.y - landedPx.y), this.zoom);
+        this.setCenter(corrected.lon, corrected.lat);
+        this.scheduleRender();
+    }
+    withinPane(column, row) {
+        return column >= 0 && column < this.columns && row >= 0 && row < this.paneRows;
+    }
+    beginDrag(column, row) {
+        if (!this.withinPane(column, row))
+            return;
+        this.drag = {
+            column,
+            row,
+            centerLon: this.centerLon,
+            centerLat: this.centerLat,
+            zoom: this.zoom,
+            moved: false,
+        };
+    }
+    /**
+     * 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.
+     */
+    continueDrag(column, row) {
+        const anchor = this.drag;
+        if (!anchor || anchor.zoom !== this.zoom)
+            return;
+        anchor.moved = true;
+        const center = lonLatToWorldPx(anchor.centerLon, anchor.centerLat, anchor.zoom);
+        const next = worldPxToLonLat(center.x + (anchor.column - column) * SUBPIXELS_PER_COLUMN, center.y + (anchor.row - row) * SUBPIXELS_PER_ROW, anchor.zoom);
+        this.setCenter(next.lon, next.lat);
+        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.
+     */
+    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.
+        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.
+        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);
+        this.paneRows = Math.max(MIN_PANE_ROWS, rows - STATUS_BAR_ROWS);
+        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.
+     */
+    scheduleRender() {
+        if (this.renderInFlight) {
+            this.renderQueued = true;
+            return;
+        }
+        void this.renderLoop();
+    }
+    async renderLoop() {
+        this.renderInFlight = true;
+        try {
+            do {
+                this.renderQueued = false;
+                await this.renderOnce();
+            } while (this.renderQueued && !this.restored);
+        }
+        finally {
+            this.renderInFlight = false;
+        }
+    }
+    async renderOnce() {
+        const viewport = {
+            centerLon: this.centerLon,
+            centerLat: this.centerLat,
+            zoom: this.zoom,
+            columns: this.columns,
+            rows: this.paneRows,
+        };
+        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.
+            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.
+            if (frame.columns !== this.columns || frame.rows !== this.paneRows)
+                return;
+            this.error = null;
+            blitFrame(this.terminal, frame);
+            this.terminal.flush();
+            this.drawStatusBar(frame.attribution);
+        }
+        catch (error) {
+            this.error = error instanceof Error ? error.message : String(error);
+            if (!this.restored) {
+                this.drawStatusBar("");
+            }
+        }
+    }
+    statusText(attribution) {
+        if (this.error)
+            return `⚠ ${this.error}  q quit`;
+        const lat = this.centerLat.toFixed(COORDINATE_DIGITS);
+        const lon = this.centerLon.toFixed(COORDINATE_DIGITS);
+        const status = `${lat},${lon} z${this.zoom}  ←↑↓→ pan  +/- zoom  q quit`;
+        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.
+        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.
+        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}`);
+    }
+}
+//# sourceMappingURL=browser.js.map

package/out/browser.js.map

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

package/out/cli-args.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * A view request: an archive to read and where to open it.
+ */
+export interface BrowseArgs {
+    mode: "browse";
+    /**
+     * Path to the PMTiles archive.
+     */
+    tiles: string;
+    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.
+     */
+    zoom: number;
+}
+export type CLIArgs = {
+    mode: "help";
+} | {
+    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.
+ */
+export declare class CLIArgsError extends Error {
+    name: string;
+}
+/**
+ * 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.
+ */
+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.
+ */
+export declare function parseCLIArgs(argv: readonly string[], environment?: CLIEnvironment): CLIArgs;
+//# sourceMappingURL=cli-args.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cli-args.d.ts","sourceRoot":"","sources":["../cli-args.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4CH;;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;AA4FD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,WAAW,GAAE,cAAmB,GAAG,OAAO,CAuB/F"}