@osmix/shared 0.0.1 → 0.0.6

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

@@ -0,0 +1,30 @@
+/**
+ * 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 = [];
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done) {
+            break;
+        }
+        chunks.push(value);
+    }
+    return concatBytes(chunks);
+}
+//# sourceMappingURL=stream-to-bytes.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,36 @@
+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<ArrayBuffer>>;
+export declare function getFixtureFileWriteStream(url: string): WritableStream<Uint8Array<ArrayBufferLike>>;
+export type PbfFixture = {
+    url: string;
+    bbox: {
+        bottom: number;
+        top: number;
+        left: number;
+        right: number;
+    };
+    nodesWithTags: number;
+    nodes: number;
+    ways: number;
+    relations: number;
+    node0: {
+        lat: number;
+        lon: number;
+        id: number;
+    };
+    way0: number;
+    relation0: number;
+    uniqueStrings: number;
+    primitiveGroups: number;
+};
+export declare const AllPBFs: Record<string, PbfFixture>;
+/**
+ * A subset of the PBFs that we want to use for current tests. Do not check in changes to this list as it will cause CI to
+ * attempt to download PBFs that are not checked into the repository.
+ */
+export declare const PBFs: Record<string, PbfFixture>;
+//# sourceMappingURL=fixtures.d.ts.map

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

@@ -0,0 +1 @@
+{"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,CAYtC;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

@@ -0,0 +1,172 @@
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT_DIR = resolve(__dirname, "../../../../");
+const FIXTURES_DIR = resolve(ROOT_DIR, "fixtures");
+export function getFixturePath(url) {
+    if (url.startsWith("http")) {
+        const fileName = url.split("/").pop();
+        if (!fileName)
+            throw new Error("Invalid URL");
+        return join(FIXTURES_DIR, fileName);
+    }
+    return join(FIXTURES_DIR, url);
+}
+/**
+ * Get file from the cache folder or download it from the URL
+ */
+export async function getFixtureFile(url) {
+    const filePath = getFixturePath(url);
+    try {
+        const file = await Bun.file(filePath).arrayBuffer();
+        return new Uint8Array(file);
+    }
+    catch (_error) {
+        const response = await fetch(url);
+        const buffer = await response.arrayBuffer();
+        const data = new Uint8Array(buffer);
+        await Bun.write(filePath, data);
+        return data;
+    }
+}
+export function getFixtureFileReadStream(url) {
+    return Bun.file(getFixturePath(url)).stream();
+}
+export function getFixtureFileWriteStream(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
+ * be used across packages and apps.
+ *
+ * `monaco.pbf` is checked into the repository so it can be used in CI without causing repeated downloads.
+ *
+ * Below, we export a subset of the PBFs that we want to use for current tests.
+ */
+const monacoPbfFixture = {
+    url: "monaco.pbf",
+    bbox: {
+        bottom: 43.7232244,
+        top: 43.7543687,
+        left: 7.4053929,
+        right: 7.4447259,
+    },
+    nodesWithTags: 1_254,
+    nodes: 14_286,
+    ways: 3_346,
+    relations: 46,
+    node0: {
+        lat: 43.7371175,
+        lon: 7.4229093,
+        id: 21911883,
+    },
+    way0: 4097656,
+    relation0: 3410831,
+    uniqueStrings: 1_060,
+    primitiveGroups: 7,
+};
+export const AllPBFs = {
+    monaco: monacoPbfFixture,
+    montenegro: {
+        url: "https://download.geofabrik.de/europe/montenegro-250101.osm.pbf",
+        bbox: {
+            bottom: 41.61621,
+            top: 43.562169,
+            left: 18.17282,
+            right: 20.358827,
+        },
+        nodesWithTags: 63_321,
+        nodes: 3_915_383,
+        ways: 321_330,
+        relations: 5_501,
+        node0: {
+            lat: 42.1982436,
+            lon: 18.9656482,
+            id: 26860768,
+        },
+        way0: 123,
+        relation0: 123,
+        uniqueStrings: 55_071,
+        primitiveGroups: 532,
+    },
+    croatia: {
+        url: "https://download.geofabrik.de/europe/croatia-250101.osm.pbf",
+        bbox: {
+            bottom: 42.16483,
+            top: 46.557562,
+            left: 13.08916,
+            right: 19.459968,
+        },
+        nodesWithTags: 481_613,
+        nodes: 23_063_621,
+        ways: 2_315_247,
+        relations: 39_098,
+        primitiveGroups: 3_178,
+        node0: {
+            lat: 42.9738772,
+            lon: 17.021989,
+            id: 4_511_653,
+        },
+        way0: 123,
+        relation0: 123,
+        uniqueStrings: 269_315,
+    },
+    italy: {
+        url: "https://download.geofabrik.de/europe/italy-250101.osm.pbf",
+        bbox: {
+            bottom: 35.07638,
+            left: 6.602696,
+            right: 19.12499,
+            top: 47.100045,
+        },
+        nodesWithTags: 1_513_303,
+        nodes: 250_818_620,
+        ways: 27_837_987,
+        relations: 100_000,
+        primitiveGroups: 34_901,
+        node0: {
+            lat: 41.9033,
+            lon: 12.4534,
+            id: 1,
+        },
+        way0: 123,
+        relation0: 123,
+        uniqueStrings: 3190,
+    },
+    washington: {
+        url: "https://download.geofabrik.de/north-america/us/washington-250101.osm.pbf",
+        bbox: {
+            bottom: 45.53882,
+            top: 49.00708,
+            left: -126.7423,
+            right: -116.911526,
+        },
+        nodesWithTags: 1_513_303,
+        nodes: 43_032_447,
+        ways: 4_541_651,
+        relations: 44_373,
+        node0: {
+            lat: 47.64248,
+            lon: -122.3196898,
+            id: 29445653,
+        },
+        way0: 123,
+        relation0: 123,
+        uniqueStrings: 598_993,
+        primitiveGroups: 34_901,
+    },
+};
+/**
+ * A subset of the PBFs that we want to use for current tests. Do not check in changes to this list as it will cause CI to
+ * attempt to download PBFs that are not checked into the repository.
+ */
+export const PBFs = { monaco: monacoPbfFixture };
+//# sourceMappingURL=fixtures.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,28 @@
+/**
+ * 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));
+}
+//# sourceMappingURL=transform-bytes.js.map

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

@@ -0,0 +1 @@
+{"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"}

package/dist/src/types.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Shared type definitions used across all Osmix packages.
+ *
+ * Includes geographic primitives (LonLat, Bbox), tile coordinates,
+ * and core OSM entity types (Node, Way, Relation).
+ *
+ * @module
+ */
+/** Geographic coordinate as [longitude, latitude] tuple. */
+export type LonLat = [lon: number, lat: number];
+/** 2D pixel or cartesian coordinate as [x, y] tuple. */
+export type XY = [x: number, y: number];
+/** Geographic coordinate as object with lon/lat properties. */
+export interface ILonLat {
+    lon: number;
+    lat: number;
+}
+/** XYZ tile coordinate as [x, y, z] tuple. */
+export type Tile = [x: number, y: number, z: number];
+/**
+ * Project LonLat to pixels
+ */
+export type LonLatToPixel = (ll: LonLat, zoom: number) => XY;
+export type LonLatToTilePixel = (ll: LonLat, z: number, extent: number) => XY;
+export type Rgba = [r: number, g: number, b: number, a: number] | Uint8ClampedArray;
+/**
+ * A bounding box in the format [minLon, minLat, maxLon, maxLat].
+ * GeoJSON.BBox allows for 3D bounding boxes, but we use tools that expect 2D bounding boxes.
+ */
+export type GeoBbox2D = [
+    minLon: number,
+    minLat: number,
+    maxLon: number,
+    maxLat: number
+];
+/**
+ * A pixel bounding box in the format [minX, minY, maxX, maxY]. Note: minY is north. maxY is south.
+ */
+export type TilePxBbox = [
+    minX: number,
+    minY: number,
+    maxX: number,
+    maxY: number
+];
+/**
+ * Shared OSM Types
+ */
+export type OsmEntityType = "node" | "way" | "relation";
+export interface OsmInfoParsed {
+    version?: number;
+    timestamp?: number;
+    changeset?: number;
+    uid?: number;
+    user_sid?: number;
+    visible?: boolean;
+    user?: string;
+}
+export interface OsmTags {
+    [key: string]: string | number;
+}
+interface IOsmEntity {
+    id: number;
+    info?: OsmInfoParsed;
+    tags?: OsmTags;
+}
+export interface OsmNode extends IOsmEntity, ILonLat {
+}
+export interface OsmWay extends IOsmEntity {
+    refs: number[];
+}
+export interface OsmRelationMember {
+    type: OsmEntityType;
+    ref: number;
+    role?: string;
+}
+export interface OsmRelation extends IOsmEntity {
+    members: OsmRelationMember[];
+}
+export type OsmEntity = OsmNode | OsmWay | OsmRelation;
+export interface OsmEntityTypeMap extends Record<OsmEntityType, IOsmEntity> {
+    node: OsmNode;
+    way: OsmWay;
+    relation: OsmRelation;
+}
+/**
+ * Semantic kinds of OSM relations based on their type tag and structure.
+ */
+export type RelationKind = "area" | "line" | "point" | "logic" | "super";
+/**
+ * Metadata about a relation kind, including expected roles and whether member order matters.
+ */
+export interface RelationKindMetadata {
+    kind: RelationKind;
+    expectedRoles?: string[];
+    orderMatters: boolean;
+    description: string;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/src/types.js

@@ -0,0 +1,9 @@
+/**
+ * Shared type definitions used across all Osmix packages.
+ *
+ * Includes geographic primitives (LonLat, Bbox), tile coordinates,
+ * and core OSM entity types (Node, Way, Relation).
+ *
+ * @module
+ */
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/src/utils.d.ts

@@ -0,0 +1,30 @@
+/**
+ * General OSM entity utilities.
+ *
+ * Provides type guards, equality checks, and type detection for OSM entities.
+ * Uses deep equality checking for tags, info, and entity-specific properties.
+ *
+ * @module
+ */
+import type { OsmEntity, OsmEntityType, OsmNode, OsmRelation, OsmWay } from "./types";
+/** Type guard: check if entity is a Node. */
+export declare function isNode(entity: OsmEntity): entity is OsmNode;
+/** Check if two nodes are equal (position, tags, and info). */
+export declare function isNodeEqual(a: OsmNode, b: OsmNode): boolean;
+/** Type guard: check if entity is a Way. */
+export declare function isWay(entity: OsmEntity): entity is OsmWay;
+/** Type guard: check if entity is a Relation. */
+export declare function isRelation(entity: OsmEntity): entity is OsmRelation;
+/** Check if two ways are equal (refs, tags, and info). */
+export declare function isWayEqual(a: OsmWay, b: OsmWay): boolean;
+/** Check if two relations are equal (members, tags, and info). */
+export declare function isRelationEqual(a: OsmRelation, b: OsmRelation): boolean;
+/** Check if two entities have equal properties (type-aware comparison). */
+export declare function entityPropertiesEqual(a: OsmEntity, b: OsmEntity): boolean;
+/** Get the entity type ("node", "way", or "relation") for an entity. */
+export declare function getEntityType(entity: OsmEntity): OsmEntityType;
+/**
+ * Check if a relation is a multipolygon relation.
+ */
+export declare function isMultipolygonRelation(relation: OsmRelation): boolean;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EACX,SAAS,EACT,aAAa,EACb,OAAO,EACP,WAAW,EACX,MAAM,EACN,MAAM,SAAS,CAAA;AAShB,6CAA6C;AAC7C,wBAAgB,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,IAAI,OAAO,CAE3D;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,WAEjD;AAED,4CAA4C;AAC5C,wBAAgB,KAAK,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,IAAI,MAAM,CAEzD;AAED,iDAAiD;AACjD,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,IAAI,WAAW,CAEnE;AAED,0DAA0D;AAC1D,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,WAE9C;AAED,kEAAkE;AAClE,wBAAgB,eAAe,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,WAE7D;AAED,2EAA2E;AAC3E,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,WAO/D;AAED,wEAAwE;AACxE,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,GAAG,aAAa,CAK9D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,WAAW,GAAG,OAAO,CAErE"}