@mailwoman/map-tui 9.1.0

package/out/mvt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mvt.js","sourceRoot":"","sources":["../mvt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,GAAG,MAAM,KAAK,CAAA;AAqBrB,MAAM,UAAU,SAAS,CAAC,IAAgB;IACzC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;IAE1C,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE;QACxD,MAAM,QAAQ,GAAqB,EAAE,CAAA;QAErC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;YACnD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YAEpC,QAAQ,CAAC,IAAI,CAAC;gBACb,IAAI,EAAE,OAAO,CAAC,IAAiB;gBAC/B,QAAQ,EAAE,OAAO,CAAC,YAAY,EAAE;gBAChC,UAAU,EAAE,OAAO,CAAC,UAAqC;aACzD,CAAC,CAAA;QACH,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAA;IAChD,CAAC,CAAC,CAAA;AACH,CAAC"}

package/out/raster.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * RGBA pixel rasterizer for map-tui's debug view.
+ *
+ * Rasterizes vector geometry (polylines, filled polygons, circles) onto a plain RGBA byte grid — the shape asciify's
+ * rasterize step consumes. Every draw call clips through {@link RGBAGrid.setPixel}, so callers never need to
+ * bounds-check geometry themselves. The polyline and circle primitives floor their coordinates to integers on entry;
+ * {@link fillPolygon} does not — its scanline edge math keeps ring vertices as given, see its own docstring.
+ */
+import type { RGB } from "./style.ts";
+/**
+ * A row-major RGBA pixel buffer. Alpha starts at 0 (unlit/transparent) everywhere; drawing a pixel sets it to 255,
+ * which is how callers (including this module's own tests) distinguish "lit" from "background".
+ */
+export declare class RGBAGrid {
+    readonly width: number;
+    readonly height: number;
+    /**
+     * RGBA, row-major, width * height * 4 bytes — the shape asciify's rasterize consumes.
+     */
+    readonly data: Uint8ClampedArray;
+    constructor(width: number, height: number);
+    /**
+     * Writes a pixel's RGB channels and sets alpha to fully opaque (255). Coordinates outside the grid are silently
+     * ignored — this is the one clipping boundary every drawing primitive in this module routes through, so geometry that
+     * runs off the grid (or arrives with negative/oversized coordinates) never needs special-casing upstream.
+     */
+    setPixel(x: number, y: number, color: RGB): void;
+}
+/**
+ * Draws a connected polyline through `points`, one Bresenham segment per consecutive pair. `width > 1` stamps a
+ * `width`-sized square at every plotted step instead of a single pixel, thickening the line. Segments that run outside
+ * the grid clip through `setPixel` rather than throwing.
+ */
+export declare function drawPolyline(grid: RGBAGrid, points: ReadonlyArray<{
+    x: number;
+    y: number;
+}>, color: RGB, width: number): void;
+/**
+ * Fills one or more polygon rings with the even-odd rule: a pixel is interior when a ray from it crosses an odd number
+ * of ring edges. Rings after the first behave as holes wherever they overlap the first ring, and holes nested inside
+ * holes fill again, purely as a consequence of the parity count — no explicit hole/outer distinction is tracked.
+ * Scanlines sample row centers (`y + 0.5`) rather than integer row coordinates, which is what keeps horizontal edges
+ * and grid-aligned polygon boundaries from producing degenerate (zero-width or doubled) intersections. Coordinates are
+ * floored to the grid via `setPixel`; edge math itself uses the ring vertices as given.
+ */
+export declare function fillPolygon(grid: RGBAGrid, rings: ReadonlyArray<ReadonlyArray<{
+    x: number;
+    y: number;
+}>>, color: RGB): void;
+/**
+ * Draws a circle's outline (ring, not a filled disc) with the midpoint circle algorithm, plotting all eight symmetric
+ * octant points per step. `centerX`/`centerY`/`radius` are floored on entry; every plotted point routes through
+ * `setPixel`, so a circle that runs off the grid clips rather than throwing.
+ */
+export declare function drawCircle(grid: RGBAGrid, centerX: number, centerY: number, radius: number, color: RGB): void;
+//# sourceMappingURL=raster.d.ts.map

package/out/raster.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"raster.d.ts","sourceRoot":"","sources":["../raster.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AAErC;;;GAGG;AACH,qBAAa,QAAQ;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;gBAEpB,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAMzC;;;;OAIG;IACH,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;CAahD;AAuDD;;;;GAIG;AACH,wBAAgB,YAAY,CAC3B,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,aAAa,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EAC/C,KAAK,EAAE,GAAG,EACV,KAAK,EAAE,MAAM,GACX,IAAI,CAON;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAC1B,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,EAC7D,KAAK,EAAE,GAAG,GACR,IAAI,CAkCN;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAgC7G"}

package/out/raster.js

@@ -0,0 +1,168 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * A row-major RGBA pixel buffer. Alpha starts at 0 (unlit/transparent) everywhere; drawing a pixel sets it to 255,
+ * which is how callers (including this module's own tests) distinguish "lit" from "background".
+ */
+export class RGBAGrid {
+    width;
+    height;
+    /**
+     * RGBA, row-major, width * height * 4 bytes — the shape asciify's rasterize consumes.
+     */
+    data;
+    constructor(width, height) {
+        this.width = width;
+        this.height = height;
+        this.data = new Uint8ClampedArray(width * height * 4);
+    }
+    /**
+     * Writes a pixel's RGB channels and sets alpha to fully opaque (255). Coordinates outside the grid are silently
+     * ignored — this is the one clipping boundary every drawing primitive in this module routes through, so geometry that
+     * runs off the grid (or arrives with negative/oversized coordinates) never needs special-casing upstream.
+     */
+    setPixel(x, y, color) {
+        const px = Math.floor(x);
+        const py = Math.floor(y);
+        if (px < 0 || px >= this.width || py < 0 || py >= this.height)
+            return;
+        const offset = (py * this.width + px) * 4;
+        this.data[offset] = color[0];
+        this.data[offset + 1] = color[1];
+        this.data[offset + 2] = color[2];
+        this.data[offset + 3] = 255;
+    }
+}
+/**
+ * Stamps a `width`-sized square centered on (x, y) — used by {@link drawPolyline} for `width > 1`. `width === 1` callers
+ * should use `grid.setPixel` directly rather than pay the square-stamp loop.
+ */
+function stampSquare(grid, x, y, color, width) {
+    const half = Math.floor(width / 2);
+    for (let dy = 0; dy < width; dy++) {
+        for (let dx = 0; dx < width; dx++) {
+            grid.setPixel(x - half + dx, y - half + dy, color);
+        }
+    }
+}
+/**
+ * Draws a single line segment with the integer Bresenham algorithm. Coordinates are floored on entry; every plotted
+ * point routes through `grid.setPixel`, so segments that run partly or fully off-grid clip for free.
+ */
+function drawSegment(grid, x0, y0, x1, y1, color, width) {
+    let x = Math.floor(x0);
+    let y = Math.floor(y0);
+    const endX = Math.floor(x1);
+    const endY = Math.floor(y1);
+    const dx = Math.abs(endX - x);
+    const dy = -Math.abs(endY - y);
+    const stepX = x < endX ? 1 : -1;
+    const stepY = y < endY ? 1 : -1;
+    let error = dx + dy;
+    for (;;) {
+        if (width > 1) {
+            stampSquare(grid, x, y, color, width);
+        }
+        else {
+            grid.setPixel(x, y, color);
+        }
+        if (x === endX && y === endY)
+            break;
+        const doubleError = 2 * error;
+        if (doubleError >= dy) {
+            error += dy;
+            x += stepX;
+        }
+        if (doubleError <= dx) {
+            error += dx;
+            y += stepY;
+        }
+    }
+}
+/**
+ * Draws a connected polyline through `points`, one Bresenham segment per consecutive pair. `width > 1` stamps a
+ * `width`-sized square at every plotted step instead of a single pixel, thickening the line. Segments that run outside
+ * the grid clip through `setPixel` rather than throwing.
+ */
+export function drawPolyline(grid, points, color, width) {
+    for (let index = 0; index < points.length - 1; index++) {
+        const a = points[index];
+        const b = points[index + 1];
+        drawSegment(grid, a.x, a.y, b.x, b.y, color, width);
+    }
+}
+/**
+ * Fills one or more polygon rings with the even-odd rule: a pixel is interior when a ray from it crosses an odd number
+ * of ring edges. Rings after the first behave as holes wherever they overlap the first ring, and holes nested inside
+ * holes fill again, purely as a consequence of the parity count — no explicit hole/outer distinction is tracked.
+ * Scanlines sample row centers (`y + 0.5`) rather than integer row coordinates, which is what keeps horizontal edges
+ * and grid-aligned polygon boundaries from producing degenerate (zero-width or doubled) intersections. Coordinates are
+ * floored to the grid via `setPixel`; edge math itself uses the ring vertices as given.
+ */
+export function fillPolygon(grid, rings, color) {
+    for (let y = 0; y < grid.height; y++) {
+        const scanY = y + 0.5;
+        const intersections = [];
+        for (const ring of rings) {
+            for (let i = 0; i < ring.length; i++) {
+                const a = ring[i];
+                const b = ring[(i + 1) % ring.length];
+                // Skip horizontal edges — they contribute no crossing at any non-integer scanY.
+                if (a.y === b.y)
+                    continue;
+                const yMin = Math.min(a.y, b.y);
+                const yMax = Math.max(a.y, b.y);
+                if (scanY < yMin || scanY >= yMax)
+                    continue;
+                const t = (scanY - a.y) / (b.y - a.y);
+                intersections.push(a.x + t * (b.x - a.x));
+            }
+        }
+        intersections.sort((left, right) => left - right);
+        for (let i = 0; i + 1 < intersections.length; i += 2) {
+            const startX = Math.ceil(intersections[i] - 0.5);
+            const endX = Math.ceil(intersections[i + 1] - 0.5);
+            for (let x = startX; x < endX; x++) {
+                grid.setPixel(x, y, color);
+            }
+        }
+    }
+}
+/**
+ * Draws a circle's outline (ring, not a filled disc) with the midpoint circle algorithm, plotting all eight symmetric
+ * octant points per step. `centerX`/`centerY`/`radius` are floored on entry; every plotted point routes through
+ * `setPixel`, so a circle that runs off the grid clips rather than throwing.
+ */
+export function drawCircle(grid, centerX, centerY, radius, color) {
+    const cx = Math.floor(centerX);
+    const cy = Math.floor(centerY);
+    const r = Math.floor(radius);
+    let x = r;
+    let y = 0;
+    let error = 1 - r;
+    const plotOctants = (px, py) => {
+        grid.setPixel(cx + px, cy + py, color);
+        grid.setPixel(cx - px, cy + py, color);
+        grid.setPixel(cx + px, cy - py, color);
+        grid.setPixel(cx - px, cy - py, color);
+        grid.setPixel(cx + py, cy + px, color);
+        grid.setPixel(cx - py, cy + px, color);
+        grid.setPixel(cx + py, cy - px, color);
+        grid.setPixel(cx - py, cy - px, color);
+    };
+    while (x >= y) {
+        plotOctants(x, y);
+        y++;
+        if (error < 0) {
+            error += 2 * y + 1;
+        }
+        else {
+            x--;
+            error += 2 * (y - x) + 1;
+        }
+    }
+}
+//# sourceMappingURL=raster.js.map

package/out/raster.js.map

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

package/out/renderer.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * Viewport-to-braille-frame renderer for map-tui's debug view.
+ *
+ * `MapRenderer.renderFrame` is the package's single public entry point: given a `Viewport` (center lon/lat, zoom, cell
+ * columns/rows), it fetches the covering tiles from a `TileSource`, rasterizes styled geometry (./style.ts,
+ * ./raster.ts) into a subpixel RGBA grid, converts that grid to braille cells (./frame.ts), then overlays collected
+ * labels and marker/ring annotations on top. Draw order is fill → line → label per the layer style table, with overlays
+ * (ring, labels, markers) layered afterward in that order — markers deliberately skip the label collision bitmap so a
+ * requested marker always wins the cell.
+ */
+import { type MapFrame } from "./frame.ts";
+import { type RGB } from "./style.ts";
+import type { TileSource } from "./tile-source.ts";
+export interface Viewport {
+    centerLon: number;
+    centerLat: number;
+    zoom: number;
+    columns: number;
+    rows: number;
+}
+export interface MarkerSpec {
+    lon: number;
+    lat: number;
+    char?: string;
+    color?: RGB;
+}
+export interface RingSpec {
+    lon: number;
+    lat: number;
+    radiusMeters: number;
+}
+/**
+ * Walks a viewport's rendering pipeline: tile fetch, style-ordered rasterization, braille conversion, then overlay
+ * annotations (ring, labels, markers). One `MapRenderer` can render any number of viewports against the same
+ * `TileSource` — it holds no per-frame state itself.
+ */
+export declare class MapRenderer {
+    private readonly source;
+    constructor(source: TileSource);
+    renderFrame(viewport: Viewport, overlays?: {
+        markers?: MarkerSpec[];
+        ring?: RingSpec;
+    }): Promise<MapFrame>;
+}
+//# sourceMappingURL=renderer.d.ts.map

package/out/renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.d.ts","sourceRoot":"","sources":["../renderer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,QAAQ,EAA8C,MAAM,YAAY,CAAA;AAItF,OAAO,EAAmB,KAAK,GAAG,EAAa,MAAM,YAAY,CAAA;AACjE,OAAO,KAAK,EAAe,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE/D,MAAM,WAAW,QAAQ;IACxB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;CACZ;AAED,MAAM,WAAW,UAAU;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,GAAG,CAAA;CACX;AAED,MAAM,WAAW,QAAQ;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,EAAE,MAAM,CAAA;CACpB;AAgKD;;;;GAIG;AACH,qBAAa,WAAW;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;gBAEvB,MAAM,EAAE,UAAU;IAIxB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;CAiFhH"}

package/out/renderer.js

@@ -0,0 +1,168 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * Viewport-to-braille-frame renderer for map-tui's debug view.
+ *
+ * `MapRenderer.renderFrame` is the package's single public entry point: given a `Viewport` (center lon/lat, zoom, cell
+ * columns/rows), it fetches the covering tiles from a `TileSource`, rasterizes styled geometry (./style.ts,
+ * ./raster.ts) into a subpixel RGBA grid, converts that grid to braille cells (./frame.ts), then overlays collected
+ * labels and marker/ring annotations on top. Draw order is fill → line → label per the layer style table, with overlays
+ * (ring, labels, markers) layered afterward in that order — markers deliberately skip the label collision bitmap so a
+ * requested marker always wins the cell.
+ */
+import { overlayText, rasterizeToFrame, rgbToPacked } from "./frame.js";
+import { lonLatToWorldPx, metersPerPixel, TILE_SIZE } from "./mercator.js";
+import { drawCircle, drawPolyline, fillPolygon, RGBAGrid } from "./raster.js";
+import { stylesFor } from "./style.js";
+const DEFAULT_MARKER_CHAR = "●";
+const DEFAULT_MARKER_COLOR = [255, 80, 80];
+/**
+ * Subpixel dimensions per braille cell: 2 columns wide, 4 rows tall.
+ */
+const SUBPIXEL_COLUMNS_PER_CELL = 2;
+const SUBPIXEL_ROWS_PER_CELL = 4;
+/**
+ * Minimum ring radius (in device pixels) worth drawing — smaller than this, the midpoint circle algorithm degenerates
+ * to a single point or nothing useful.
+ */
+const MIN_RING_RADIUS_PX = 2;
+function clamp(value, min, max) {
+    return Math.min(Math.max(value, min), max);
+}
+function projectPoint(projection, gx, gy) {
+    return {
+        x: projection.tileX * TILE_SIZE + gx * projection.scale - projection.origin.x,
+        y: projection.tileY * TILE_SIZE + gy * projection.scale - projection.origin.y,
+    };
+}
+function rasterizeFill(grid, feature, projection, color) {
+    const rings = feature.geometry.map((ring) => ring.map((point) => projectPoint(projection, point.x, point.y)));
+    fillPolygon(grid, rings, color);
+}
+function rasterizeLine(grid, feature, projection, color, width) {
+    for (const part of feature.geometry) {
+        const points = part.map((point) => projectPoint(projection, point.x, point.y));
+        drawPolyline(grid, points, color, width);
+    }
+}
+function collectLabels(feature, property, color, projection, pendingLabels) {
+    const text = String(feature.properties[property] ?? "");
+    if (!text.length)
+        return;
+    const packedColor = rgbToPacked(color);
+    for (const part of feature.geometry) {
+        for (const point of part) {
+            const projected = projectPoint(projection, point.x, point.y);
+            pendingLabels.push({
+                text,
+                column: Math.floor(projected.x / SUBPIXEL_COLUMNS_PER_CELL),
+                row: Math.floor(projected.y / SUBPIXEL_ROWS_PER_CELL),
+                color: packedColor,
+            });
+        }
+    }
+}
+/**
+ * Rasterizes (or, for labels, collects) one feature under one style. The `style.kind` dispatch is the only branching
+ * here — the actual per-kind work lives in {@link rasterizeFill}/{@link rasterizeLine}/{@link collectLabels} so this
+ * stays a flat one-level `if`/`else` regardless of how deeply its caller is already nested.
+ */
+function rasterizeFeature(grid, feature, style, renderZoom, projection, pendingLabels) {
+    if (style.kind === "fill") {
+        rasterizeFill(grid, feature, projection, style.color);
+    }
+    else if (style.kind === "line") {
+        rasterizeLine(grid, feature, projection, style.color, style.width(renderZoom));
+    }
+    else {
+        collectLabels(feature, style.property, style.color, projection, pendingLabels);
+    }
+}
+/**
+ * Rasterizes every layer/style/feature in one tile matching `kind`. Pulled out of {@link MapRenderer.renderFrame} so
+ * that method's own tile loop doesn't accumulate this function's three nested loops on top of its own.
+ */
+function rasterizeTileForKind(grid, tile, tileX, tileY, kind, renderZoom, origin, pendingLabels) {
+    for (const layer of tile.layers) {
+        const styles = stylesFor(layer.name, renderZoom).filter((style) => style.kind === kind);
+        if (!styles.length)
+            continue;
+        const projection = { tileX, tileY, scale: TILE_SIZE / layer.extent, origin };
+        for (const style of styles) {
+            for (const feature of layer.features) {
+                rasterizeFeature(grid, feature, style, renderZoom, projection, pendingLabels);
+            }
+        }
+    }
+}
+/**
+ * Walks a viewport's rendering pipeline: tile fetch, style-ordered rasterization, braille conversion, then overlay
+ * annotations (ring, labels, markers). One `MapRenderer` can render any number of viewports against the same
+ * `TileSource` — it holds no per-frame state itself.
+ */
+export class MapRenderer {
+    source;
+    constructor(source) {
+        this.source = source;
+    }
+    async renderFrame(viewport, overlays) {
+        const { centerLon, centerLat, columns, rows } = viewport;
+        const subpixelW = columns * SUBPIXEL_COLUMNS_PER_CELL;
+        const subpixelH = rows * SUBPIXEL_ROWS_PER_CELL;
+        const renderZoom = clamp(Math.round(viewport.zoom), this.source.minZoom, this.source.maxZoom);
+        const center = lonLatToWorldPx(centerLon, centerLat, renderZoom);
+        const origin = { x: center.x - subpixelW / 2, y: center.y - subpixelH / 2 };
+        const zoomTileCount = 2 ** renderZoom;
+        const minTileX = clamp(Math.floor(origin.x / TILE_SIZE), 0, zoomTileCount - 1);
+        const maxTileX = clamp(Math.floor((origin.x + subpixelW) / TILE_SIZE), 0, zoomTileCount - 1);
+        const minTileY = clamp(Math.floor(origin.y / TILE_SIZE), 0, zoomTileCount - 1);
+        const maxTileY = clamp(Math.floor((origin.y + subpixelH) / TILE_SIZE), 0, zoomTileCount - 1);
+        const tileCoords = [];
+        for (let tileY = minTileY; tileY <= maxTileY; tileY++) {
+            for (let tileX = minTileX; tileX <= maxTileX; tileX++) {
+                tileCoords.push({ x: tileX, y: tileY });
+            }
+        }
+        const tiles = await Promise.all(tileCoords.map((coord) => this.source.getTile(renderZoom, coord.x, coord.y)));
+        const grid = new RGBAGrid(subpixelW, subpixelH);
+        const pendingLabels = [];
+        for (const kind of ["fill", "line", "label"]) {
+            for (let i = 0; i < tileCoords.length; i++) {
+                const tile = tiles[i];
+                if (!tile)
+                    continue;
+                const { x: tileX, y: tileY } = tileCoords[i];
+                rasterizeTileForKind(grid, tile, tileX, tileY, kind, renderZoom, origin, pendingLabels);
+            }
+        }
+        if (overlays?.ring) {
+            const { lon, lat, radiusMeters } = overlays.ring;
+            const radiusPx = radiusMeters / metersPerPixel(lat, renderZoom);
+            if (radiusPx >= MIN_RING_RADIUS_PX) {
+                const ringCenterWorld = lonLatToWorldPx(lon, lat, renderZoom);
+                const ringColor = [255, 255, 255];
+                drawCircle(grid, ringCenterWorld.x - origin.x, ringCenterWorld.y - origin.y, radiusPx, ringColor);
+            }
+        }
+        const frame = rasterizeToFrame(grid, columns, rows, this.source.attribution);
+        const occupied = new Uint8Array(columns * rows);
+        for (const label of pendingLabels) {
+            overlayText(frame, label.column, label.row, label.text, label.color, occupied);
+        }
+        if (overlays?.markers) {
+            for (const marker of overlays.markers) {
+                const markerWorld = lonLatToWorldPx(marker.lon, marker.lat, renderZoom);
+                const px = markerWorld.x - origin.x;
+                const py = markerWorld.y - origin.y;
+                const column = Math.floor(px / SUBPIXEL_COLUMNS_PER_CELL);
+                const row = Math.floor(py / SUBPIXEL_ROWS_PER_CELL);
+                overlayText(frame, column, row, marker.char ?? DEFAULT_MARKER_CHAR, rgbToPacked(marker.color ?? DEFAULT_MARKER_COLOR));
+            }
+        }
+        return frame;
+    }
+}
+//# sourceMappingURL=renderer.js.map

package/out/renderer.js.map

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

package/out/style.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+/**
+ * Protomaps-basemap style table for the map-tui debug view.
+ *
+ * Defines fill, line, and label styles for each of the nine protomaps-basemap layers, gated by zoom level. Color
+ * palette calibrated for dark-terminal rendering: dim fills (read as stipple density via dithering), bright lines and
+ * labels.
+ */
+export type RGB = readonly [red: number, green: number, blue: number];
+export interface FillStyle {
+    kind: "fill";
+    color: RGB;
+    minZoom: number;
+}
+export interface LineStyle {
+    kind: "line";
+    color: RGB;
+    minZoom: number;
+    width: (zoom: number) => number;
+}
+export interface LabelStyle {
+    kind: "label";
+    color: RGB;
+    minZoom: number;
+    property: string;
+}
+export type LayerStyle = FillStyle | LineStyle | LabelStyle;
+/**
+ * Styles applying to a protomaps-basemap layer at a zoom, draw-ordered (fills < lines < labels). Empty for
+ * unstyled/gated layers.
+ */
+export declare function stylesFor(layerName: string, zoom: number): LayerStyle[];
+//# sourceMappingURL=style.d.ts.map

package/out/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../style.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;GAMG;AAEH,MAAM,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;AAErE,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,GAAG,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,GAAG,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,UAAU;IAC1B,IAAI,EAAE,OAAO,CAAA;IACb,KAAK,EAAE,GAAG,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAA;AAmB3D;;;GAGG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAEvE"}

package/out/style.js

@@ -0,0 +1,28 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+// Zoom level at which roads render with 2px width instead of 1px.
+const ROAD_WIDTH_THRESHOLD = 14;
+const STYLE_TABLE = {
+    earth: [{ kind: "fill", color: [40, 44, 36], minZoom: 0 }],
+    landcover: [{ kind: "fill", color: [36, 52, 32], minZoom: 4 }],
+    landuse: [{ kind: "fill", color: [48, 48, 40], minZoom: 10 }],
+    water: [{ kind: "fill", color: [24, 48, 90], minZoom: 0 }],
+    buildings: [{ kind: "fill", color: [70, 66, 60], minZoom: 13 }],
+    boundaries: [{ kind: "line", color: [140, 110, 160], minZoom: 0, width: () => 1 }],
+    roads: [
+        { kind: "line", color: [170, 170, 150], minZoom: 6, width: (zoom) => (zoom >= ROAD_WIDTH_THRESHOLD ? 2 : 1) },
+    ],
+    places: [{ kind: "label", color: [235, 235, 220], minZoom: 2, property: "name" }],
+    pois: [{ kind: "label", color: [180, 200, 160], minZoom: 14, property: "name" }],
+};
+/**
+ * Styles applying to a protomaps-basemap layer at a zoom, draw-ordered (fills < lines < labels). Empty for
+ * unstyled/gated layers.
+ */
+export function stylesFor(layerName, zoom) {
+    return (STYLE_TABLE[layerName] ?? []).filter((style) => zoom >= style.minZoom);
+}
+//# sourceMappingURL=style.js.map

package/out/style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../style.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkCH,kEAAkE;AAClE,MAAM,oBAAoB,GAAG,EAAE,CAAA;AAE/B,MAAM,WAAW,GAAiC;IACjD,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAC1D,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAC9D,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC7D,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAC1D,SAAS,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC/D,UAAU,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;IAClF,KAAK,EAAE;QACN,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,oBAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;KAC7G;IACD,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACjF,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;CAChF,CAAA;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,SAAiB,EAAE,IAAY;IACxD,OAAO,CAAC,WAAW,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,CAAA;AAC/E,CAAC"}

package/out/tile-source.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import { type DecodedLayer } from "./mvt.ts";
+export interface DecodedTile {
+    layers: DecodedLayer[];
+}
+export declare class TileSource {
+    readonly minZoom: number;
+    readonly maxZoom: number;
+    /**
+     * Plain-text attribution from archive metadata (HTML tags stripped); empty string when absent.
+     */
+    readonly attribution: string;
+    private readonly handle;
+    private readonly pmtiles;
+    private readonly cache;
+    private constructor();
+    static open(path: string): Promise<TileSource>;
+    /**
+     * Decoded tile, LRU-cached (64 entries). null = tile absent from the archive.
+     */
+    getTile(z: number, x: number, y: number): Promise<DecodedTile | null>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=tile-source.d.ts.map

package/out/tile-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile-source.d.ts","sourceRoot":"","sources":["../tile-source.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,OAAO,EAAE,KAAK,YAAY,EAAa,MAAM,UAAU,CAAA;AAEvD,MAAM,WAAW,WAAW;IAC3B,MAAM,EAAE,YAAY,EAAE,CAAA;CACtB;AAkCD,qBAAa,UAAU;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IAExB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;IAE5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;IAEtD,OAAO;WAQM,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAiBpD;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA6BrE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG5B"}