@osmix/shared 0.0.2 → 0.0.7

package/dist/src/relation-multipolygon.js

@@ -0,0 +1,195 @@
+/**
+ * Multipolygon relation building utilities.
+ *
+ * Implements the OSM multipolygon relation specification to construct
+ * polygon geometries from way members. Handles outer/inner roles,
+ * way connection, and ring closure.
+ *
+ * @see https://wiki.openstreetmap.org/wiki/Relation:multipolygon
+ *
+ * @module
+ */
+/**
+ * Get way members from a relation, grouped by role (outer/inner).
+ */
+export function getWayMembersByRole(relation) {
+    const outer = [];
+    const inner = [];
+    for (const member of relation.members) {
+        if (member.type !== "way")
+            continue;
+        const role = member.role?.toLowerCase() ?? "";
+        if (role === "outer") {
+            outer.push(member);
+        }
+        else if (role === "inner") {
+            inner.push(member);
+        }
+    }
+    return { outer, inner };
+}
+/**
+ * Connect ways that share endpoints to form a continuous ring.
+ * Returns an array of rings (each ring is an array of way IDs in order).
+ *
+ * This function handles:
+ * - Ways that are reversed (end matches end, or start matches start).
+ * - Closed ways (single ways that form a ring).
+ * - Disconnected chains (multiple independent rings).
+ */
+export function connectWaysToRings(wayMembers) {
+    if (wayMembers.length === 0)
+        return [];
+    const rings = [];
+    const used = new Set();
+    const wayMap = new Map();
+    // Build map of way ID to member
+    for (const member of wayMembers) {
+        wayMap.set(member.id, member);
+    }
+    // Helper to reverse a way's refs
+    const reverseWay = (way) => ({
+        ...way,
+        refs: [...way.refs].reverse(),
+    });
+    // Build rings by connecting ways
+    for (const startWay of wayMembers) {
+        if (used.has(startWay.id))
+            continue;
+        if (startWay.refs.length < 2)
+            throw Error("Way has less than 2 refs");
+        const ring = [startWay];
+        used.add(startWay.id);
+        let currentStart = startWay.refs[0];
+        let currentEnd = startWay.refs[startWay.refs.length - 1];
+        // Try to extend the ring forward
+        while (true) {
+            let found = false;
+            for (const nextWay of wayMembers) {
+                if (used.has(nextWay.id))
+                    continue;
+                if (nextWay.refs.length < 2)
+                    throw Error("Way has less than 2 refs");
+                const nextStart = nextWay.refs[0];
+                const nextEnd = nextWay.refs[nextWay.refs.length - 1];
+                // Check if next way connects to current end
+                if (currentEnd === nextStart) {
+                    ring.push(nextWay);
+                    used.add(nextWay.id);
+                    currentEnd = nextEnd;
+                    found = true;
+                    break;
+                }
+                if (currentEnd === nextEnd) {
+                    // Need to reverse next way
+                    ring.push(reverseWay(nextWay));
+                    used.add(nextWay.id);
+                    currentEnd = nextStart;
+                    found = true;
+                    break;
+                }
+            }
+            if (!found)
+                break;
+        }
+        // Try to extend the ring backward
+        currentStart = startWay.refs[0];
+        currentEnd = startWay.refs[startWay.refs.length - 1];
+        while (true) {
+            let found = false;
+            for (const nextWay of wayMembers) {
+                if (used.has(nextWay.id))
+                    continue;
+                if (nextWay.refs.length < 2)
+                    throw Error("Way has less than 2 refs");
+                const nextStart = nextWay.refs[0];
+                const nextEnd = nextWay.refs[nextWay.refs.length - 1];
+                // Check if next way connects to current start
+                if (currentStart === nextEnd) {
+                    ring.unshift(nextWay);
+                    used.add(nextWay.id);
+                    currentStart = nextStart;
+                    found = true;
+                    break;
+                }
+                if (currentStart === nextStart) {
+                    // Need to reverse next way
+                    ring.unshift(reverseWay(nextWay));
+                    used.add(nextWay.id);
+                    currentStart = nextEnd;
+                    found = true;
+                    break;
+                }
+            }
+            if (!found)
+                break;
+        }
+        // Only add ring if it's closed (first and last node are the same)
+        if (ring.length > 0) {
+            const firstWay = ring[0];
+            const lastWay = ring[ring.length - 1];
+            if (firstWay?.refs[0] === lastWay?.refs[lastWay.refs.length - 1]) {
+                rings.push(ring);
+            }
+        }
+    }
+    return rings;
+}
+/**
+ * Build polygon rings from way members of a relation.
+ * Returns an array where each element is an array of coordinate rings (outer + inner).
+ *
+ * Based on OSM multipolygon relation specification:
+ * https://wiki.openstreetmap.org/wiki/Relation:multipolygon
+ *
+ * This implementation connects way members into closed rings, and then groups them
+ * into polygons. Currently, it associates all inner rings with every outer ring
+ * found in the relation, which is a simplification. A robust implementation would
+ * use point-in-polygon checks to strictly nest holes inside their parent outer ring.
+ */
+export function buildRelationRings(relation, getWay, getNodeCoordinates) {
+    const { outer, inner } = getWayMembersByRole(relation);
+    // Connect outer ways into rings
+    const outerRings = connectWaysToRings(outer.map((m) => getWay(m.ref)).filter((w) => w !== null));
+    // Connect inner ways into rings
+    const innerRings = connectWaysToRings(inner.map((m) => getWay(m.ref)).filter((w) => w !== null));
+    const wayRingToCoords = (ring) => {
+        const coords = [];
+        for (const way of ring) {
+            for (const nodeId of way.refs) {
+                const coord = getNodeCoordinates(nodeId);
+                if (coord)
+                    coords.push(coord);
+            }
+        }
+        // Ensure ring is closed
+        if (coords.length > 0) {
+            const first = coords[0];
+            const last = coords[coords.length - 1];
+            if (first && last && (first[0] !== last[0] || first[1] !== last[1])) {
+                coords.push([first[0], first[1]]);
+            }
+        }
+        return coords;
+    };
+    // Convert way rings to coordinate rings
+    const coordinateRings = [];
+    for (const outerRing of outerRings) {
+        const outerCoordinates = wayRingToCoords(outerRing);
+        if (outerCoordinates.length >= 3) {
+            // Find inner rings that belong to this outer ring
+            const innerCoordinates = [];
+            for (const innerRing of innerRings) {
+                const innerCoords = wayRingToCoords(innerRing);
+                if (innerCoords.length >= 3) {
+                    // TODO: do proper point-in-polygon test with https://github.com/rowanwins/point-in-polygon-hao
+                    innerCoordinates.push(innerCoords);
+                }
+            }
+            // Create polygon: [outer ring, ...inner rings]
+            coordinateRings.push([outerCoordinates, ...innerCoordinates]);
+        }
+    }
+    return coordinateRings;
+}
+//# sourceMappingURL=relation-multipolygon.js.map

package/dist/src/relation-multipolygon.js.map

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

package/dist/src/stream-to-bytes.d.ts

@@ -1,2 +1,18 @@
+/**
+ * Stream to byte array conversion.
+ *
+ * Consumes a ReadableStream and concatenates all chunks into a single Uint8Array.
+ *
+ * @module
+ */
+/**
+ * Consume a ReadableStream and return all data as a single Uint8Array.
+ *
+ * Reads all chunks from the stream and concatenates them.
+ * The stream will be fully consumed after this function returns.
+ *
+ * @param stream - The stream to consume.
+ * @returns A Promise resolving to the concatenated bytes.
+ */
 export declare function streamToBytes(stream: ReadableStream<Uint8Array<ArrayBuffer>>): Promise<Uint8Array<ArrayBuffer>>;
 //# sourceMappingURL=stream-to-bytes.d.ts.map

package/dist/src/stream-to-bytes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"stream-to-bytes.d.ts","sourceRoot":"","sources":["../../src/stream-to-bytes.ts"],"names":[],"mappings":"AAEA,wBAAsB,aAAa,CAClC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,GAC7C,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAelC"}
+{"version":3,"file":"stream-to-bytes.d.ts","sourceRoot":"","sources":["../../src/stream-to-bytes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAClC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,GAC7C,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAelC"}

package/dist/src/stream-to-bytes.js

@@ -1,4 +1,20 @@
+/**
+ * Stream to byte array conversion.
+ *
+ * Consumes a ReadableStream and concatenates all chunks into a single Uint8Array.
+ *
+ * @module
+ */
 import { concatBytes } from "./concat-bytes";
+/**
+ * Consume a ReadableStream and return all data as a single Uint8Array.
+ *
+ * Reads all chunks from the stream and concatenates them.
+ * The stream will be fully consumed after this function returns.
+ *
+ * @param stream - The stream to consume.
+ * @returns A Promise resolving to the concatenated bytes.
+ */
 export async function streamToBytes(stream) {
     const reader = stream.getReader();
     const chunks = [];

package/dist/src/stream-to-bytes.js.map

@@ -1 +1 @@
-{"version":3,"file":"stream-to-bytes.js","sourceRoot":"","sources":["../../src/stream-to-bytes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE5C,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,MAA+C;IAE/C,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAA;IACjC,MAAM,MAAM,GAA8B,EAAE,CAAA;IAE5C,OAAO,IAAI,EAAE,CAAC;QACb,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;QAE3C,IAAI,IAAI,EAAE,CAAC;YACV,MAAK;QACN,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACnB,CAAC;IAED,OAAO,WAAW,CAAC,MAAM,CAAC,CAAA;AAC3B,CAAC"}
+{"version":3,"file":"stream-to-bytes.js","sourceRoot":"","sources":["../../src/stream-to-bytes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAE5C;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,MAA+C;IAE/C,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAA;IACjC,MAAM,MAAM,GAA8B,EAAE,CAAA;IAE5C,OAAO,IAAI,EAAE,CAAC;QACb,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;QAE3C,IAAI,IAAI,EAAE,CAAC;YACV,MAAK;QACN,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;IACnB,CAAC;IAED,OAAO,WAAW,CAAC,MAAM,CAAC,CAAA;AAC3B,CAAC"}

package/dist/src/test/fixtures.d.ts

@@ -3,7 +3,7 @@ export declare function getFixturePath(url: string): string;
  * Get file from the cache folder or download it from the URL
  */
 export declare function getFixtureFile(url: string): Promise<Uint8Array<ArrayBufferLike>>;
-export declare function getFixtureFileReadStream(url: string): ReadableStream<Uint8Array<ArrayBufferLike>>;
+export declare function getFixtureFileReadStream(url: string): ReadableStream<Uint8Array<ArrayBuffer>>;
 export declare function getFixtureFileWriteStream(url: string): WritableStream<Uint8Array<ArrayBufferLike>>;
 export type PbfFixture = {
     url: string;

package/dist/src/test/fixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../../src/test/fixtures.ts"],"names":[],"mappings":"AAUA,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,UAOzC;AAED;;GAEG;AACH,wBAAsB,cAAc,CACnC,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAYtC;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAGnC,cAAc,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAC3D;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAGpC,cAAc,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAC3D;AAED,MAAM,MAAM,UAAU,GAAG;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE;QACL,MAAM,EAAE,MAAM,CAAA;QACd,GAAG,EAAE,MAAM,CAAA;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,CAAA;KACb,CAAA;IACD,aAAa,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE;QACN,GAAG,EAAE,MAAM,CAAA;QACX,GAAG,EAAE,MAAM,CAAA;QACX,EAAE,EAAE,MAAM,CAAA;KACV,CAAA;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;CACvB,CAAA;AAiCD,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CA0FrC,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAgC,CAAA"}
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../../src/test/fixtures.ts"],"names":[],"mappings":"AAOA,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,UAOzC;AAED;;GAEG;AACH,wBAAsB,cAAc,CACnC,GAAG,EAAE,MAAM,GACT,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAetC;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,2CAEnD;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,+CAUpD;AAED,MAAM,MAAM,UAAU,GAAG;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE;QACL,MAAM,EAAE,MAAM,CAAA;QACd,GAAG,EAAE,MAAM,CAAA;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,KAAK,EAAE,MAAM,CAAA;KACb,CAAA;IACD,aAAa,EAAE,MAAM,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE;QACN,GAAG,EAAE,MAAM,CAAA;QACX,GAAG,EAAE,MAAM,CAAA;QACX,EAAE,EAAE,MAAM,CAAA;KACV,CAAA;IACD,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;CACvB,CAAA;AAiCD,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CA0FrC,CAAA;AAEV;;;GAGG;AACH,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAgC,CAAA"}

package/dist/src/test/fixtures.js

@@ -1,7 +1,4 @@
-import { createReadStream, createWriteStream } from "node:fs";
-import { readFile, writeFile } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
-import { Readable, Writable } from "node:stream";
 import { fileURLToPath } from "node:url";
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const ROOT_DIR = resolve(__dirname, "../../../../");
@@ -21,22 +18,33 @@ export function getFixturePath(url) {
 export async function getFixtureFile(url) {
     const filePath = getFixturePath(url);
     try {
-        const file = await readFile(filePath);
-        return new Uint8Array(file.buffer);
+        const file = await Bun.file(filePath).arrayBuffer();
+        return new Uint8Array(file);
     }
     catch (_error) {
+        if (process.env["CI"]) {
+            throw Error(`Do not download fixtures in CI: ${url} not found`);
+        }
         const response = await fetch(url);
         const buffer = await response.arrayBuffer();
         const data = new Uint8Array(buffer);
-        await writeFile(filePath, data);
+        await Bun.write(filePath, data);
         return data;
     }
 }
 export function getFixtureFileReadStream(url) {
-    return Readable.toWeb(createReadStream(getFixturePath(url)));
+    return Bun.file(getFixturePath(url)).stream();
 }
 export function getFixtureFileWriteStream(url) {
-    return Writable.toWeb(createWriteStream(getFixturePath(url)));
+    const incrementalWriter = Bun.file(getFixturePath(url)).writer();
+    return new WritableStream({
+        write: (chunk) => {
+            incrementalWriter.write(chunk);
+        },
+        close: () => {
+            incrementalWriter.end();
+        },
+    });
 }
 /**
  * List of PBFs and their metadata used for testing. Cached locally in the top level fixtures directory so they can

package/dist/src/test/fixtures.js.map

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

package/dist/src/throttle.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Throttling utilities for rate-limiting function calls.
+ *
+ * Useful for limiting progress updates from workers or other high-frequency
+ * operations to avoid overwhelming the UI or logging.
+ *
+ * @module
+ */
+/**
+ * Create a throttled version of a function that only executes at most
+ * once per `timeFrame` milliseconds.
+ *
+ * @param func - The function to throttle.
+ * @param timeFrame - Minimum time between calls in milliseconds.
+ * @returns A throttled version of the function.
+ *
+ * @example
+ * ```ts
+ * const logThrottled = throttle((msg) => console.log(msg), 1000)
+ * // Only logs at most once per second
+ * for (let i = 0; i < 1000; i++) logThrottled(`Progress: ${i}`)
+ * ```
+ */
+export declare function throttle<T extends unknown[]>(func: (...args: T) => void, timeFrame: number): (...args: T) => void;
+//# sourceMappingURL=throttle.d.ts.map

package/dist/src/throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../src/throttle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,OAAO,EAAE,EAC3C,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,EAC1B,SAAS,EAAE,MAAM,IAGT,GAAG,MAAM,CAAC,UAOlB"}

package/dist/src/throttle.js

@@ -0,0 +1,34 @@
+/**
+ * Throttling utilities for rate-limiting function calls.
+ *
+ * Useful for limiting progress updates from workers or other high-frequency
+ * operations to avoid overwhelming the UI or logging.
+ *
+ * @module
+ */
+/**
+ * Create a throttled version of a function that only executes at most
+ * once per `timeFrame` milliseconds.
+ *
+ * @param func - The function to throttle.
+ * @param timeFrame - Minimum time between calls in milliseconds.
+ * @returns A throttled version of the function.
+ *
+ * @example
+ * ```ts
+ * const logThrottled = throttle((msg) => console.log(msg), 1000)
+ * // Only logs at most once per second
+ * for (let i = 0; i < 1000; i++) logThrottled(`Progress: ${i}`)
+ * ```
+ */
+export function throttle(func, timeFrame) {
+    let lastTime = 0;
+    return (...args) => {
+        const now = Date.now();
+        if (now - lastTime >= timeFrame) {
+            func(...args);
+            lastTime = now;
+        }
+    };
+}
+//# sourceMappingURL=throttle.js.map

package/dist/src/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../src/throttle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,QAAQ,CACvB,IAA0B,EAC1B,SAAiB;IAEjB,IAAI,QAAQ,GAAG,CAAC,CAAA;IAChB,OAAO,CAAC,GAAG,IAAO,EAAE,EAAE;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QACtB,IAAI,GAAG,GAAG,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;YACb,QAAQ,GAAG,GAAG,CAAA;QACf,CAAC;IACF,CAAC,CAAA;AACF,CAAC"}

package/dist/src/tile.d.ts

@@ -0,0 +1,34 @@
+/**
+ * XYZ tile coordinate utilities.
+ *
+ * Provides conversions between geographic coordinates (lon/lat) and
+ * tile pixel coordinates for XYZ tiled map systems. Supports various
+ * tile sizes and zoom levels.
+ *
+ * @module
+ */
+import type { GeoBbox2D, LonLat, Tile, TilePxBbox, XY } from "./types";
+/**
+ * Get the geographic bounding box of a tile.
+ * Returns [west, south, east, north].
+ */
+export declare function tileToBbox(tile: Tile): GeoBbox2D;
+/**
+ * Convert a bounding box from geographic coordinates to tile pixel coordinates.
+ */
+export declare function bboxToTilePx(bbox: GeoBbox2D, tile: Tile, tileSize?: number): TilePxBbox;
+/**
+ * Convert a geographic coordinate to tile pixel coordinates.
+ * Returns [x, y] in pixels relative to the top-left of the tile.
+ */
+export declare function llToTilePx(ll: LonLat, tile: Tile, tileSize?: number): XY;
+/**
+ * Convert tile pixel coordinates to geographic coordinates.
+ */
+export declare function tilePxToLonLat(px: XY, tile: Tile, tileSize?: number): LonLat;
+/**
+ * Clamp a pixel coordinate to the tile bounds and round to the nearest integer. Useful for converting a floating point pixel
+ * coordinate to a the exact tile pixel it is contained by.
+ */
+export declare function clampAndRoundPx(px: XY, tileSizeOrBbox: number | GeoBbox2D): XY;
+//# sourceMappingURL=tile.d.ts.map

package/dist/src/tile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tile.d.ts","sourceRoot":"","sources":["../../src/tile.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,SAAS,CAAA;AAatE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,CAOhD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC3B,IAAI,EAAE,SAAS,EACf,IAAI,EAAE,IAAI,EACV,QAAQ,SAAM,GACZ,UAAU,CAIZ;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,SAAM,GAAG,EAAE,CAMrE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,SAAM,GAAG,MAAM,CAKzE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,EAAE,EAAE,EAAE,EACN,cAAc,EAAE,MAAM,GAAG,SAAS,GAChC,EAAE,CASJ"}

package/dist/src/tile.js

@@ -0,0 +1,72 @@
+/**
+ * XYZ tile coordinate utilities.
+ *
+ * Provides conversions between geographic coordinates (lon/lat) and
+ * tile pixel coordinates for XYZ tiled map systems. Supports various
+ * tile sizes and zoom levels.
+ *
+ * @module
+ */
+import { pointToTileFraction } from "@mapbox/tilebelt";
+const RADIANS_TO_DEGREES = 180 / Math.PI;
+function tile2lon(x, z) {
+    return (x / 2 ** z) * 360 - 180;
+}
+function tile2lat(y, z) {
+    const n = Math.PI - (2 * Math.PI * y) / 2 ** z;
+    return RADIANS_TO_DEGREES * Math.atan(0.5 * (Math.exp(n) - Math.exp(-n)));
+}
+/**
+ * Get the geographic bounding box of a tile.
+ * Returns [west, south, east, north].
+ */
+export function tileToBbox(tile) {
+    const [tx, ty, tz] = tile;
+    const n = tile2lat(ty, tz);
+    const s = tile2lat(ty + 1, tz);
+    const e = tile2lon(tx + 1, tz);
+    const w = tile2lon(tx, tz);
+    return [w, s, e, n];
+}
+/**
+ * Convert a bounding box from geographic coordinates to tile pixel coordinates.
+ */
+export function bboxToTilePx(bbox, tile, tileSize = 256) {
+    const [minX, minY] = llToTilePx([bbox[0], bbox[3]], tile, tileSize);
+    const [maxX, maxY] = llToTilePx([bbox[2], bbox[1]], tile, tileSize);
+    return [minX, minY, maxX, maxY];
+}
+/**
+ * Convert a geographic coordinate to tile pixel coordinates.
+ * Returns [x, y] in pixels relative to the top-left of the tile.
+ */
+export function llToTilePx(ll, tile, tileSize = 256) {
+    const [tx, ty, tz] = tile;
+    const tf = pointToTileFraction(ll[0], ll[1], tz);
+    const x = (tf[0] - tx) * tileSize;
+    const y = (tf[1] - ty) * tileSize;
+    return [x, y];
+}
+/**
+ * Convert tile pixel coordinates to geographic coordinates.
+ */
+export function tilePxToLonLat(px, tile, tileSize = 256) {
+    const [tx, ty, tz] = tile;
+    const lon = tile2lon(px[0] / tileSize + tx, tz);
+    const lat = tile2lat(px[1] / tileSize + ty, tz);
+    return [lon, lat];
+}
+/**
+ * Clamp a pixel coordinate to the tile bounds and round to the nearest integer. Useful for converting a floating point pixel
+ * coordinate to a the exact tile pixel it is contained by.
+ */
+export function clampAndRoundPx(px, tileSizeOrBbox) {
+    const [minX, minY, maxX, maxY] = typeof tileSizeOrBbox === "number"
+        ? [0, 0, tileSizeOrBbox, tileSizeOrBbox]
+        : tileSizeOrBbox;
+    return [
+        Math.max(minX, Math.min(maxX, Math.round(px[0]))),
+        Math.max(minY, Math.min(maxY, Math.round(px[1]))),
+    ];
+}
+//# sourceMappingURL=tile.js.map

package/dist/src/tile.js.map

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

package/dist/src/transform-bytes.d.ts

@@ -1,2 +1,24 @@
+/**
+ * Transform stream utilities.
+ *
+ * Helpers for piping byte arrays through TransformStreams (e.g., compression).
+ *
+ * @module
+ */
+/**
+ * Pipe a byte array through a TransformStream and return the result.
+ *
+ * Useful for applying compression/decompression or other transformations
+ * to byte data using the Web Streams API.
+ *
+ * @param bytes - The input bytes.
+ * @param transformStream - The transform to apply (e.g., CompressionStream).
+ * @returns A Promise resolving to the transformed bytes.
+ *
+ * @example
+ * ```ts
+ * const compressed = await transformBytes(data, new CompressionStream('gzip'))
+ * ```
+ */
 export declare function transformBytes(bytes: Uint8Array<ArrayBuffer>, transformStream: TransformStream<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>): Promise<Uint8Array<ArrayBuffer>>;
 //# sourceMappingURL=transform-bytes.d.ts.map

package/dist/src/transform-bytes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transform-bytes.d.ts","sourceRoot":"","sources":["../../src/transform-bytes.ts"],"names":[],"mappings":"AAGA,wBAAsB,cAAc,CACnC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,EAC9B,eAAe,EAAE,eAAe,CAC/B,UAAU,CAAC,WAAW,CAAC,EACvB,UAAU,CAAC,WAAW,CAAC,CACvB,GACC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAElC"}
+{"version":3,"file":"transform-bytes.d.ts","sourceRoot":"","sources":["../../src/transform-bytes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CACnC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,EAC9B,eAAe,EAAE,eAAe,CAC/B,UAAU,CAAC,WAAW,CAAC,EACvB,UAAU,CAAC,WAAW,CAAC,CACvB,GACC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAElC"}

package/dist/src/transform-bytes.js

@@ -1,5 +1,27 @@
+/**
+ * Transform stream utilities.
+ *
+ * Helpers for piping byte arrays through TransformStreams (e.g., compression).
+ *
+ * @module
+ */
 import { bytesToStream } from "./bytes-to-stream";
 import { streamToBytes } from "./stream-to-bytes";
+/**
+ * Pipe a byte array through a TransformStream and return the result.
+ *
+ * Useful for applying compression/decompression or other transformations
+ * to byte data using the Web Streams API.
+ *
+ * @param bytes - The input bytes.
+ * @param transformStream - The transform to apply (e.g., CompressionStream).
+ * @returns A Promise resolving to the transformed bytes.
+ *
+ * @example
+ * ```ts
+ * const compressed = await transformBytes(data, new CompressionStream('gzip'))
+ * ```
+ */
 export async function transformBytes(bytes, transformStream) {
     return streamToBytes(bytesToStream(bytes).pipeThrough(transformStream));
 }

package/dist/src/transform-bytes.js.map

@@ -1 +1 @@
-{"version":3,"file":"transform-bytes.js","sourceRoot":"","sources":["../../src/transform-bytes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjD,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,KAA8B,EAC9B,eAGC;IAED,OAAO,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,CAAA;AACxE,CAAC"}
+{"version":3,"file":"transform-bytes.js","sourceRoot":"","sources":["../../src/transform-bytes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,KAA8B,EAC9B,eAGC;IAED,OAAO,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,CAAA;AACxE,CAAC"}