@mailwoman/map-tui 9.1.0

package/README.md

@@ -0,0 +1,15 @@
+# @mailwoman/map-tui
+
+A frame-first terminal map renderer. It decodes vector tiles from a
+[PMTiles](https://protomaps.com/) archive, rasterizes the visible layers, and
+resolves the result to a grid of terminal cells — braille-glyph map frames
+suitable for TUIs and other character-grid displays.
+
+The unit of output is a `MapFrame`: frames are values, not side effects.
+Rendering never writes to stdout, an Ink component, or any other presentation
+layer directly — a caller reads the frame's cells and decides how (and
+whether) to draw them.
+
+Tiles are never bundled with this package. Every render takes a caller-supplied
+PMTiles path (local file or remote archive), so callers own their own tile
+sourcing and coverage.

package/frame.ts

@@ -0,0 +1,170 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+
+/**
+ * Braille frame value + conversion for map-tui's debug view.
+ *
+ * `rasterizeToFrame` turns an `RGBAGrid` (drawn by ./raster.ts) into a `MapFrame`: one codepoint and one packed color
+ * per cell. The braille dither/luminance work is asciify's — `FrameRasterizer` subclasses `AsciifyTerminal` with a
+ * no-op sink purely to reach its protected `_computeBrailleCells`, `_cellChars`, `_cellColors`, so this module never
+ * re-implements the dot math. `frameToANSILines` and `overlayText` then work on the plain `MapFrame` value, with no
+ * further asciify dependency.
+ */
+
+import { AsciifyTerminal } from "@sister.software/asciify/tui"
+
+import type { RGBAGrid } from "./raster.ts"
+import type { RGB } from "./style.ts"
+
+const SGR_RESET = "\u001B[0m"
+
+/**
+ * A rendered braille frame: one codepoint and one packed color per cell, row-major.
+ */
+export interface MapFrame {
+	columns: number
+	rows: number
+	/**
+	 * Codepoint per cell, row-major (braille U+2800.. or overlay text).
+	 */
+	chars: Uint32Array
+	/**
+	 * 0xRRGGBB per cell; 0 = inkless.
+	 */
+	colors: Uint32Array
+	attribution: string
+}
+
+/**
+ * Reaches asciify's protected braille conversion from the outside. Constructed fresh per {@link rasterizeToFrame} call
+ * — cheap, since the state is just two typed arrays sized to the cell grid. The `write` sink is never invoked: this
+ * class only ever calls `_computeBrailleCells` directly, never `rasterize`/`flush`.
+ */
+class FrameRasterizer extends AsciifyTerminal {
+	constructor(columns: number, rows: number) {
+		super({ write: () => true, columns, rows }, { mode: "braille", colorDepth: "truecolor", synchronizedOutput: false })
+		this.setSize(columns, rows)
+	}
+
+	toCells(buffer: Uint8ClampedArray): { chars: Uint32Array; colors: Uint32Array } {
+		this._computeBrailleCells(buffer, false)
+
+		return { chars: this._cellChars.slice(), colors: this._cellColors.slice() }
+	}
+}
+
+/**
+ * Converts a 2×4-subpixel RGBA grid into braille cells. Grid must be `columns * 2` x `rows * 4`.
+ *
+ * @throws If the grid's dimensions don't match `columns * 2` x `rows * 4` — a caller sizing bug, not something to
+ *   silently clip.
+ */
+export function rasterizeToFrame(grid: RGBAGrid, columns: number, rows: number, attribution: string): MapFrame {
+	if (grid.width !== columns * 2 || grid.height !== rows * 4) {
+		throw new Error(
+			`rasterizeToFrame: grid is ${grid.width}x${grid.height}, expected ${columns * 2}x${rows * 4} for ${columns}x${rows} cells`
+		)
+	}
+
+	const rasterizer = new FrameRasterizer(columns, rows)
+	const { chars, colors } = rasterizer.toCells(grid.data)
+
+	return { columns, rows, chars, colors, attribution }
+}
+
+/**
+ * One SGR-styled string per row. `color: false` strips styling (NO_COLOR consumers).
+ *
+ * Inkless cells (packed color 0) never emit a color escape, matching asciify's own damage emitter — a cell going from
+ * inked to inkless shouldn't touch color state. Each styled line ends with the SGR reset so a truncated terminal write
+ * never bleeds color into whatever follows.
+ */
+export function frameToANSILines(frame: MapFrame, options?: { color?: boolean }): string[] {
+	const colorEnabled = options?.color ?? true
+	const lines: string[] = []
+
+	for (let row = 0; row < frame.rows; row++) {
+		let line = ""
+		let activeColor = -1
+
+		for (let column = 0; column < frame.columns; column++) {
+			const cellIndex = row * frame.columns + column
+			const char = frame.chars[cellIndex]!
+			const color = frame.colors[cellIndex]!
+			const inked = color !== 0
+
+			if (colorEnabled && inked && color !== activeColor) {
+				line += `\u001B[38;2;${(color >> 16) & 0xff};${(color >> 8) & 0xff};${color & 0xff}m`
+				activeColor = color
+			}
+
+			line += char === 0 ? " " : String.fromCodePoint(char)
+		}
+
+		lines.push(colorEnabled ? line + SGR_RESET : line)
+	}
+
+	return lines
+}
+
+/**
+ * Writes text into cells (clipped); occupied is the label-collision bitmap, updated in place.
+ *
+ * When `occupied` is given, every target cell plus one cell of padding on each side is checked before anything is
+ * written — a single colliding cell rejects the whole label rather than partially overlaying it. Without `occupied`,
+ * writes proceed unconditionally (still clipped to the frame's bounds) and always report success.
+ */
+export function overlayText(
+	frame: MapFrame,
+	column: number,
+	row: number,
+	text: string,
+	color: number,
+	occupied?: Uint8Array
+): boolean {
+	if (row < 0 || row >= frame.rows) return false
+
+	const codePoints = Array.from(text)
+
+	if (occupied) {
+		for (let i = 0; i < codePoints.length; i++) {
+			const cellColumn = column + i
+
+			for (let padding = -1; padding <= 1; padding++) {
+				const checkColumn = cellColumn + padding
+
+				if (checkColumn < 0 || checkColumn >= frame.columns) continue
+
+				if (occupied[row * frame.columns + checkColumn]) return false
+			}
+		}
+	}
+
+	for (let i = 0; i < codePoints.length; i++) {
+		const cellColumn = column + i
+
+		if (cellColumn < 0 || cellColumn >= frame.columns) continue
+
+		const cellIndex = row * frame.columns + cellColumn
+
+		frame.chars[cellIndex] = codePoints[i]!.codePointAt(0)!
+		frame.colors[cellIndex] = color
+
+		if (occupied) {
+			occupied[cellIndex] = 1
+		}
+	}
+
+	return true
+}
+
+/**
+ * Packs RGB channels into the frame's 0xRRGGBB color representation. Shared with Task 8's marker colors so both sides
+ * of the frame boundary agree on the packing.
+ */
+export function rgbToPacked(color: RGB): number {
+	return (color[0] << 16) | (color[1] << 8) | color[2]
+}

package/index.ts

@@ -0,0 +1,13 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+
+export * from "./frame.ts"
+export * from "./mercator.ts"
+export * from "./mvt.ts"
+export * from "./raster.ts"
+export * from "./renderer.ts"
+export * from "./style.ts"
+export * from "./tile-source.ts"

package/mercator.ts

@@ -0,0 +1,55 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+
+/**
+ * Web-Mercator projection math for map-tui.
+ *
+ * This module reimplements the standard Web-Mercator projection (EPSG:3857) math locally rather than importing from
+ * `@mailwoman/cartographer` or `@mailwoman/spatial`. The cartographer dependency drags maplibre-gl +
+ * `@mailwoman/tiger`; spatial drags `@mailwoman/core`'s shipped data. map-tui maintains a dependency-lean surface for
+ * the standalone `npx` story (the nuts-lookup precedent).
+ */
+
+/**
+ * Number of pixels per tile in the Web-Mercator projection (standard: 256).
+ */
+export const TILE_SIZE = 256
+
+export interface LonLat {
+	lon: number
+	lat: number
+}
+
+export interface WorldPx {
+	x: number
+	y: number
+}
+
+export function lonLatToWorldPx(lon: number, lat: number, zoom: number): WorldPx {
+	const scale = TILE_SIZE * 2 ** zoom
+	const sin = Math.sin((lat * Math.PI) / 180)
+
+	return {
+		x: scale * (lon / 360 + 0.5),
+		y: scale * (0.5 - (0.25 * Math.log((1 + sin) / (1 - sin))) / Math.PI),
+	}
+}
+
+export function worldPxToLonLat(x: number, y: number, zoom: number): LonLat {
+	const scale = TILE_SIZE * 2 ** zoom
+	const n = Math.PI * (1 - (2 * y) / scale)
+
+	return {
+		lon: (x / scale - 0.5) * 360,
+		lat: (Math.atan(Math.sinh(n)) * 180) / Math.PI,
+	}
+}
+
+const EARTH_CIRCUMFERENCE_M = 40_075_016.686
+
+export function metersPerPixel(lat: number, zoom: number): number {
+	return (EARTH_CIRCUMFERENCE_M * Math.cos((lat * Math.PI) / 180)) / (TILE_SIZE * 2 ** zoom)
+}

package/mvt.ts

@@ -0,0 +1,54 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+
+/**
+ * Mapbox Vector Tile (MVT) decoding for map-tui.
+ *
+ * Wraps @mapbox/vector-tile + pbf behind a plain-data shape (DecodedLayer / DecodedFeature) so the rest of map-tui
+ * never touches the upstream library's lazy-geometry classes.
+ */
+
+import { VectorTile } from "@mapbox/vector-tile"
+import Pbf from "pbf"
+
+export interface DecodedFeature {
+	/**
+	 * 1 = point, 2 = line, 3 = polygon (MVT geometry types).
+	 */
+	type: 1 | 2 | 3
+
+	/**
+	 * Rings/lines/points in tile-local integer coords (0..extent).
+	 */
+	geometry: Array<Array<{ x: number; y: number }>>
+	properties: Record<string, unknown>
+}
+
+export interface DecodedLayer {
+	name: string
+	extent: number
+	features: DecodedFeature[]
+}
+
+export function decodeMVT(data: Uint8Array): DecodedLayer[] {
+	const tile = new VectorTile(new Pbf(data))
+
+	return Object.entries(tile.layers).map(([name, layer]) => {
+		const features: DecodedFeature[] = []
+
+		for (let index = 0; index < layer.length; index++) {
+			const feature = layer.feature(index)
+
+			features.push({
+				type: feature.type as 1 | 2 | 3,
+				geometry: feature.loadGeometry(),
+				properties: feature.properties as Record<string, unknown>,
+			})
+		}
+
+		return { name, extent: layer.extent, features }
+	})
+}

package/out/frame.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import type { RGBAGrid } from "./raster.ts";
+import type { RGB } from "./style.ts";
+/**
+ * A rendered braille frame: one codepoint and one packed color per cell, row-major.
+ */
+export interface MapFrame {
+    columns: number;
+    rows: number;
+    /**
+     * Codepoint per cell, row-major (braille U+2800.. or overlay text).
+     */
+    chars: Uint32Array;
+    /**
+     * 0xRRGGBB per cell; 0 = inkless.
+     */
+    colors: Uint32Array;
+    attribution: string;
+}
+/**
+ * Converts a 2×4-subpixel RGBA grid into braille cells. Grid must be `columns * 2` x `rows * 4`.
+ *
+ * @throws If the grid's dimensions don't match `columns * 2` x `rows * 4` — a caller sizing bug, not something to
+ *   silently clip.
+ */
+export declare function rasterizeToFrame(grid: RGBAGrid, columns: number, rows: number, attribution: string): MapFrame;
+/**
+ * One SGR-styled string per row. `color: false` strips styling (NO_COLOR consumers).
+ *
+ * Inkless cells (packed color 0) never emit a color escape, matching asciify's own damage emitter — a cell going from
+ * inked to inkless shouldn't touch color state. Each styled line ends with the SGR reset so a truncated terminal write
+ * never bleeds color into whatever follows.
+ */
+export declare function frameToANSILines(frame: MapFrame, options?: {
+    color?: boolean;
+}): string[];
+/**
+ * Writes text into cells (clipped); occupied is the label-collision bitmap, updated in place.
+ *
+ * When `occupied` is given, every target cell plus one cell of padding on each side is checked before anything is
+ * written — a single colliding cell rejects the whole label rather than partially overlaying it. Without `occupied`,
+ * writes proceed unconditionally (still clipped to the frame's bounds) and always report success.
+ */
+export declare function overlayText(frame: MapFrame, column: number, row: number, text: string, color: number, occupied?: Uint8Array): boolean;
+/**
+ * Packs RGB channels into the frame's 0xRRGGBB color representation. Shared with Task 8's marker colors so both sides
+ * of the frame boundary agree on the packing.
+ */
+export declare function rgbToPacked(color: RGB): number;
+//# sourceMappingURL=frame.d.ts.map

package/out/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../frame.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAIrC;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,KAAK,EAAE,WAAW,CAAA;IAClB;;OAEG;IACH,MAAM,EAAE,WAAW,CAAA;IACnB,WAAW,EAAE,MAAM,CAAA;CACnB;AAoBD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,QAAQ,CAW7G;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,MAAM,EAAE,CA0BzF;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAC1B,KAAK,EAAE,QAAQ,EACf,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,UAAU,GACnB,OAAO,CAmCT;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAE9C"}

package/out/frame.js

@@ -0,0 +1,117 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * Braille frame value + conversion for map-tui's debug view.
+ *
+ * `rasterizeToFrame` turns an `RGBAGrid` (drawn by ./raster.ts) into a `MapFrame`: one codepoint and one packed color
+ * per cell. The braille dither/luminance work is asciify's — `FrameRasterizer` subclasses `AsciifyTerminal` with a
+ * no-op sink purely to reach its protected `_computeBrailleCells`, `_cellChars`, `_cellColors`, so this module never
+ * re-implements the dot math. `frameToANSILines` and `overlayText` then work on the plain `MapFrame` value, with no
+ * further asciify dependency.
+ */
+import { AsciifyTerminal } from "@sister.software/asciify/tui";
+const SGR_RESET = "\u001B[0m";
+/**
+ * Reaches asciify's protected braille conversion from the outside. Constructed fresh per {@link rasterizeToFrame} call
+ * — cheap, since the state is just two typed arrays sized to the cell grid. The `write` sink is never invoked: this
+ * class only ever calls `_computeBrailleCells` directly, never `rasterize`/`flush`.
+ */
+class FrameRasterizer extends AsciifyTerminal {
+    constructor(columns, rows) {
+        super({ write: () => true, columns, rows }, { mode: "braille", colorDepth: "truecolor", synchronizedOutput: false });
+        this.setSize(columns, rows);
+    }
+    toCells(buffer) {
+        this._computeBrailleCells(buffer, false);
+        return { chars: this._cellChars.slice(), colors: this._cellColors.slice() };
+    }
+}
+/**
+ * Converts a 2×4-subpixel RGBA grid into braille cells. Grid must be `columns * 2` x `rows * 4`.
+ *
+ * @throws If the grid's dimensions don't match `columns * 2` x `rows * 4` — a caller sizing bug, not something to
+ *   silently clip.
+ */
+export function rasterizeToFrame(grid, columns, rows, attribution) {
+    if (grid.width !== columns * 2 || grid.height !== rows * 4) {
+        throw new Error(`rasterizeToFrame: grid is ${grid.width}x${grid.height}, expected ${columns * 2}x${rows * 4} for ${columns}x${rows} cells`);
+    }
+    const rasterizer = new FrameRasterizer(columns, rows);
+    const { chars, colors } = rasterizer.toCells(grid.data);
+    return { columns, rows, chars, colors, attribution };
+}
+/**
+ * One SGR-styled string per row. `color: false` strips styling (NO_COLOR consumers).
+ *
+ * Inkless cells (packed color 0) never emit a color escape, matching asciify's own damage emitter — a cell going from
+ * inked to inkless shouldn't touch color state. Each styled line ends with the SGR reset so a truncated terminal write
+ * never bleeds color into whatever follows.
+ */
+export function frameToANSILines(frame, options) {
+    const colorEnabled = options?.color ?? true;
+    const lines = [];
+    for (let row = 0; row < frame.rows; row++) {
+        let line = "";
+        let activeColor = -1;
+        for (let column = 0; column < frame.columns; column++) {
+            const cellIndex = row * frame.columns + column;
+            const char = frame.chars[cellIndex];
+            const color = frame.colors[cellIndex];
+            const inked = color !== 0;
+            if (colorEnabled && inked && color !== activeColor) {
+                line += `\u001B[38;2;${(color >> 16) & 0xff};${(color >> 8) & 0xff};${color & 0xff}m`;
+                activeColor = color;
+            }
+            line += char === 0 ? " " : String.fromCodePoint(char);
+        }
+        lines.push(colorEnabled ? line + SGR_RESET : line);
+    }
+    return lines;
+}
+/**
+ * Writes text into cells (clipped); occupied is the label-collision bitmap, updated in place.
+ *
+ * When `occupied` is given, every target cell plus one cell of padding on each side is checked before anything is
+ * written — a single colliding cell rejects the whole label rather than partially overlaying it. Without `occupied`,
+ * writes proceed unconditionally (still clipped to the frame's bounds) and always report success.
+ */
+export function overlayText(frame, column, row, text, color, occupied) {
+    if (row < 0 || row >= frame.rows)
+        return false;
+    const codePoints = Array.from(text);
+    if (occupied) {
+        for (let i = 0; i < codePoints.length; i++) {
+            const cellColumn = column + i;
+            for (let padding = -1; padding <= 1; padding++) {
+                const checkColumn = cellColumn + padding;
+                if (checkColumn < 0 || checkColumn >= frame.columns)
+                    continue;
+                if (occupied[row * frame.columns + checkColumn])
+                    return false;
+            }
+        }
+    }
+    for (let i = 0; i < codePoints.length; i++) {
+        const cellColumn = column + i;
+        if (cellColumn < 0 || cellColumn >= frame.columns)
+            continue;
+        const cellIndex = row * frame.columns + cellColumn;
+        frame.chars[cellIndex] = codePoints[i].codePointAt(0);
+        frame.colors[cellIndex] = color;
+        if (occupied) {
+            occupied[cellIndex] = 1;
+        }
+    }
+    return true;
+}
+/**
+ * Packs RGB channels into the frame's 0xRRGGBB color representation. Shared with Task 8's marker colors so both sides
+ * of the frame boundary agree on the packing.
+ */
+export function rgbToPacked(color) {
+    return (color[0] << 16) | (color[1] << 8) | color[2];
+}
+//# sourceMappingURL=frame.js.map

package/out/frame.js.map

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

package/out/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export * from "./frame.ts";
+export * from "./mercator.ts";
+export * from "./mvt.ts";
+export * from "./raster.ts";
+export * from "./renderer.ts";
+export * from "./style.ts";
+export * from "./tile-source.ts";
+//# sourceMappingURL=index.d.ts.map

package/out/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA"}

package/out/index.js

@@ -0,0 +1,13 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export * from "./frame.js";
+export * from "./mercator.js";
+export * from "./mvt.js";
+export * from "./raster.js";
+export * from "./renderer.js";
+export * from "./style.js";
+export * from "./tile-source.js";
+//# sourceMappingURL=index.js.map

package/out/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,kBAAkB,CAAA"}

package/out/mercator.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * Web-Mercator projection math for map-tui.
+ *
+ * This module reimplements the standard Web-Mercator projection (EPSG:3857) math locally rather than importing from
+ * `@mailwoman/cartographer` or `@mailwoman/spatial`. The cartographer dependency drags maplibre-gl +
+ * `@mailwoman/tiger`; spatial drags `@mailwoman/core`'s shipped data. map-tui maintains a dependency-lean surface for
+ * the standalone `npx` story (the nuts-lookup precedent).
+ */
+/**
+ * Number of pixels per tile in the Web-Mercator projection (standard: 256).
+ */
+export declare const TILE_SIZE = 256;
+export interface LonLat {
+    lon: number;
+    lat: number;
+}
+export interface WorldPx {
+    x: number;
+    y: number;
+}
+export declare function lonLatToWorldPx(lon: number, lat: number, zoom: number): WorldPx;
+export declare function worldPxToLonLat(x: number, y: number, zoom: number): LonLat;
+export declare function metersPerPixel(lat: number, zoom: number): number;
+//# sourceMappingURL=mercator.d.ts.map

package/out/mercator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mercator.d.ts","sourceRoot":"","sources":["../mercator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS,MAAM,CAAA;AAE5B,MAAM,WAAW,MAAM;IACtB,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;CACX;AAED,MAAM,WAAW,OAAO;IACvB,CAAC,EAAE,MAAM,CAAA;IACT,CAAC,EAAE,MAAM,CAAA;CACT;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAQ/E;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ1E;AAID,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhE"}

package/out/mercator.js

@@ -0,0 +1,38 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * Web-Mercator projection math for map-tui.
+ *
+ * This module reimplements the standard Web-Mercator projection (EPSG:3857) math locally rather than importing from
+ * `@mailwoman/cartographer` or `@mailwoman/spatial`. The cartographer dependency drags maplibre-gl +
+ * `@mailwoman/tiger`; spatial drags `@mailwoman/core`'s shipped data. map-tui maintains a dependency-lean surface for
+ * the standalone `npx` story (the nuts-lookup precedent).
+ */
+/**
+ * Number of pixels per tile in the Web-Mercator projection (standard: 256).
+ */
+export const TILE_SIZE = 256;
+export function lonLatToWorldPx(lon, lat, zoom) {
+    const scale = TILE_SIZE * 2 ** zoom;
+    const sin = Math.sin((lat * Math.PI) / 180);
+    return {
+        x: scale * (lon / 360 + 0.5),
+        y: scale * (0.5 - (0.25 * Math.log((1 + sin) / (1 - sin))) / Math.PI),
+    };
+}
+export function worldPxToLonLat(x, y, zoom) {
+    const scale = TILE_SIZE * 2 ** zoom;
+    const n = Math.PI * (1 - (2 * y) / scale);
+    return {
+        lon: (x / scale - 0.5) * 360,
+        lat: (Math.atan(Math.sinh(n)) * 180) / Math.PI,
+    };
+}
+const EARTH_CIRCUMFERENCE_M = 40_075_016.686;
+export function metersPerPixel(lat, zoom) {
+    return (EARTH_CIRCUMFERENCE_M * Math.cos((lat * Math.PI) / 180)) / (TILE_SIZE * 2 ** zoom);
+}
+//# sourceMappingURL=mercator.js.map

package/out/mercator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mercator.js","sourceRoot":"","sources":["../mercator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAA;AAY5B,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,GAAW,EAAE,IAAY;IACrE,MAAM,KAAK,GAAG,SAAS,GAAG,CAAC,IAAI,IAAI,CAAA;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAA;IAE3C,OAAO;QACN,CAAC,EAAE,KAAK,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;QAC5B,CAAC,EAAE,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;KACrE,CAAA;AACF,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,CAAS,EAAE,CAAS,EAAE,IAAY;IACjE,MAAM,KAAK,GAAG,SAAS,GAAG,CAAC,IAAI,IAAI,CAAA;IACnC,MAAM,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAA;IAEzC,OAAO;QACN,GAAG,EAAE,CAAC,CAAC,GAAG,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG;QAC5B,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,EAAE;KAC9C,CAAA;AACF,CAAC;AAED,MAAM,qBAAqB,GAAG,cAAc,CAAA;AAE5C,MAAM,UAAU,cAAc,CAAC,GAAW,EAAE,IAAY;IACvD,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,IAAI,IAAI,CAAC,CAAA;AAC3F,CAAC"}

package/out/mvt.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export interface DecodedFeature {
+    /**
+     * 1 = point, 2 = line, 3 = polygon (MVT geometry types).
+     */
+    type: 1 | 2 | 3;
+    /**
+     * Rings/lines/points in tile-local integer coords (0..extent).
+     */
+    geometry: Array<Array<{
+        x: number;
+        y: number;
+    }>>;
+    properties: Record<string, unknown>;
+}
+export interface DecodedLayer {
+    name: string;
+    extent: number;
+    features: DecodedFeature[];
+}
+export declare function decodeMVT(data: Uint8Array): DecodedLayer[];
+//# sourceMappingURL=mvt.d.ts.map

package/out/mvt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mvt.d.ts","sourceRoot":"","sources":["../mvt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,MAAM,WAAW,cAAc;IAC9B;;OAEG;IACH,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAEf;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAAA;IAChD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,cAAc,EAAE,CAAA;CAC1B;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,EAAE,CAkB1D"}

package/out/mvt.js

@@ -0,0 +1,29 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * Mapbox Vector Tile (MVT) decoding for map-tui.
+ *
+ * Wraps @mapbox/vector-tile + pbf behind a plain-data shape (DecodedLayer / DecodedFeature) so the rest of map-tui
+ * never touches the upstream library's lazy-geometry classes.
+ */
+import { VectorTile } from "@mapbox/vector-tile";
+import Pbf from "pbf";
+export function decodeMVT(data) {
+    const tile = new VectorTile(new Pbf(data));
+    return Object.entries(tile.layers).map(([name, layer]) => {
+        const features = [];
+        for (let index = 0; index < layer.length; index++) {
+            const feature = layer.feature(index);
+            features.push({
+                type: feature.type,
+                geometry: feature.loadGeometry(),
+                properties: feature.properties,
+            });
+        }
+        return { name, extent: layer.extent, features };
+    });
+}
+//# sourceMappingURL=mvt.js.map