@osmix/shared 0.0.2 → 0.0.7

package/dist/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/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/assert.d.ts

@@ -1,5 +1,24 @@
 /**
- * Short utility for checking index access.
+ * Assertion utilities for defensive programming.
+ *
+ * Provides typed assertion helpers that throw errors when conditions are not met,
+ * commonly used for index bounds checking and null/undefined guards.
+ *
+ * @module
+ */
+/**
+ * Assert that a value is neither null nor undefined.
+ *
+ * @param value - The value to check.
+ * @param message - Optional error message if assertion fails.
+ * @throws Error if value is null or undefined.
+ *
+ * @example
+ * ```ts
+ * const item = array[index]
+ * assertValue(item, `No item at index ${index}`)
+ * // TypeScript now knows item is non-nullable
+ * ```
  */
 export declare function assertValue<T>(value?: T, message?: string): asserts value is NonNullable<T>;
 //# sourceMappingURL=assert.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/assert.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC5B,KAAK,CAAC,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,CAIjC"}
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/assert.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC5B,KAAK,CAAC,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC,CAAC,CAAC,CAIjC"}

package/dist/src/assert.js

@@ -1,5 +1,24 @@
 /**
- * Short utility for checking index access.
+ * Assertion utilities for defensive programming.
+ *
+ * Provides typed assertion helpers that throw errors when conditions are not met,
+ * commonly used for index bounds checking and null/undefined guards.
+ *
+ * @module
+ */
+/**
+ * Assert that a value is neither null nor undefined.
+ *
+ * @param value - The value to check.
+ * @param message - Optional error message if assertion fails.
+ * @throws Error if value is null or undefined.
+ *
+ * @example
+ * ```ts
+ * const item = array[index]
+ * assertValue(item, `No item at index ${index}`)
+ * // TypeScript now knows item is non-nullable
+ * ```
  */
 export function assertValue(value, message) {
     if (value === undefined || value === null) {

package/dist/src/assert.js.map

@@ -1 +1 @@
-{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../src/assert.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,WAAW,CAC1B,KAAS,EACT,OAAgB;IAEhB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC3C,MAAM,KAAK,CAAC,OAAO,IAAI,4BAA4B,CAAC,CAAA;IACrD,CAAC;AACF,CAAC"}
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../src/assert.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,WAAW,CAC1B,KAAS,EACT,OAAgB;IAEhB,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAC3C,MAAM,KAAK,CAAC,OAAO,IAAI,4BAA4B,CAAC,CAAA;IACrD,CAAC;AACF,CAAC"}

package/dist/src/bbox-intersects.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Bounding box intersection and containment utilities.
+ *
+ * Provides functions for checking spatial relationships between
+ * geographic bounding boxes (west, south, east, north format).
+ *
+ * @module
+ */
+import type { GeoBbox2D } from "./types";
+/**
+ * Check if two bounding boxes intersect or contain each other.
+ * Handles both partial overlaps and complete containment.
+ */
+export declare function bboxContainsOrIntersects(bb1: GeoBbox2D, bb2: GeoBbox2D): boolean;
+//# sourceMappingURL=bbox-intersects.d.ts.map

package/dist/src/bbox-intersects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bbox-intersects.d.ts","sourceRoot":"","sources":["../../src/bbox-intersects.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExC;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,WActE"}

package/dist/src/bbox-intersects.js

@@ -0,0 +1,24 @@
+/**
+ * Bounding box intersection and containment utilities.
+ *
+ * Provides functions for checking spatial relationships between
+ * geographic bounding boxes (west, south, east, north format).
+ *
+ * @module
+ */
+/**
+ * Check if two bounding boxes intersect or contain each other.
+ * Handles both partial overlaps and complete containment.
+ */
+export function bboxContainsOrIntersects(bb1, bb2) {
+    const westIn = (bb1[0] >= bb2[0] && bb1[0] <= bb2[2]) ||
+        (bb2[0] >= bb1[0] && bb2[0] <= bb1[2]);
+    const eastIn = (bb1[2] >= bb2[0] && bb1[2] <= bb2[2]) ||
+        (bb2[2] >= bb1[0] && bb2[2] <= bb1[2]);
+    const northIn = (bb1[1] >= bb2[1] && bb1[1] <= bb2[3]) ||
+        (bb2[1] >= bb1[1] && bb2[1] <= bb1[3]);
+    const southIn = (bb1[3] >= bb2[1] && bb1[3] <= bb2[3]) ||
+        (bb2[3] >= bb1[1] && bb2[3] <= bb1[3]);
+    return (westIn || eastIn) && (northIn || southIn);
+}
+//# sourceMappingURL=bbox-intersects.js.map

package/dist/src/bbox-intersects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bbox-intersects.js","sourceRoot":"","sources":["../../src/bbox-intersects.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,GAAc,EAAE,GAAc;IACtE,MAAM,MAAM,GACX,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QACtC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACvC,MAAM,MAAM,GACX,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QACtC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACvC,MAAM,OAAO,GACZ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QACtC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACvC,MAAM,OAAO,GACZ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QACtC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAA;IACvC,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,CAAA;AAClD,CAAC"}

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

@@ -1,2 +1,18 @@
-export declare function bytesToStream(bytes: Uint8Array<ArrayBuffer>): import("stream/web").ReadableStream<Uint8Array<ArrayBuffer>>;
+/**
+ * Byte array to stream conversion.
+ *
+ * Wraps a Uint8Array in a ReadableStream for use with streaming APIs.
+ *
+ * @module
+ */
+/**
+ * Create a ReadableStream from a Uint8Array.
+ *
+ * The stream will emit the entire byte array as a single chunk,
+ * then close immediately.
+ *
+ * @param bytes - The byte array to wrap.
+ * @returns A ReadableStream that emits the bytes.
+ */
+export declare function bytesToStream(bytes: Uint8Array<ArrayBuffer>): ReadableStream<Uint8Array<ArrayBuffer>>;
 //# sourceMappingURL=bytes-to-stream.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"bytes-to-stream.d.ts","sourceRoot":"","sources":["../../src/bytes-to-stream.ts"],"names":[],"mappings":"AAAA,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,gEAO3D"}
+{"version":3,"file":"bytes-to-stream.d.ts","sourceRoot":"","sources":["../../src/bytes-to-stream.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,2CAO3D"}

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

@@ -1,3 +1,19 @@
+/**
+ * Byte array to stream conversion.
+ *
+ * Wraps a Uint8Array in a ReadableStream for use with streaming APIs.
+ *
+ * @module
+ */
+/**
+ * Create a ReadableStream from a Uint8Array.
+ *
+ * The stream will emit the entire byte array as a single chunk,
+ * then close immediately.
+ *
+ * @param bytes - The byte array to wrap.
+ * @returns A ReadableStream that emits the bytes.
+ */
 export function bytesToStream(bytes) {
     return new ReadableStream({
         start(controller) {

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

@@ -1 +1 @@
-{"version":3,"file":"bytes-to-stream.js","sourceRoot":"","sources":["../../src/bytes-to-stream.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,aAAa,CAAC,KAA8B;IAC3D,OAAO,IAAI,cAAc,CAA0B;QAClD,KAAK,CAAC,UAAU;YACf,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YACzB,UAAU,CAAC,KAAK,EAAE,CAAA;QACnB,CAAC;KACD,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"bytes-to-stream.js","sourceRoot":"","sources":["../../src/bytes-to-stream.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAAC,KAA8B;IAC3D,OAAO,IAAI,cAAc,CAA0B;QAClD,KAAK,CAAC,UAAU;YACf,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YACzB,UAAU,CAAC,KAAK,EAAE,CAAA;QACnB,CAAC;KACD,CAAC,CAAA;AACH,CAAC"}

package/dist/src/color.d.ts

@@ -0,0 +1,4 @@
+import type { Rgba } from "./types";
+export declare function normalizeHexColor(value: string | number | null | undefined): string | undefined;
+export declare function hexColorToRgba(value: string | number | null | undefined): Rgba | undefined;
+//# sourceMappingURL=color.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/color.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAA;AAInC,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GACvC,MAAM,GAAG,SAAS,CAiBpB;AAED,wBAAgB,cAAc,CAC7B,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,GACvC,IAAI,GAAG,SAAS,CASlB"}

package/dist/src/color.js

@@ -0,0 +1,33 @@
+const hexPattern = /^[0-9a-fA-F]+$/;
+export function normalizeHexColor(value) {
+    if (value === null || value === undefined)
+        return;
+    const raw = String(value).trim();
+    if (!raw)
+        return;
+    let hex = raw.startsWith("#") ? raw.slice(1) : raw;
+    if (!hexPattern.test(hex))
+        return;
+    if (hex.length === 3 || hex.length === 4) {
+        hex = hex
+            .split("")
+            .map((char) => `${char}${char}`)
+            .join("");
+    }
+    else if (hex.length !== 6 && hex.length !== 8) {
+        return;
+    }
+    return `#${hex.toUpperCase()}`;
+}
+export function hexColorToRgba(value) {
+    const normalized = normalizeHexColor(value);
+    if (!normalized)
+        return;
+    const hex = normalized.slice(1);
+    const r = Number.parseInt(hex.slice(0, 2), 16);
+    const g = Number.parseInt(hex.slice(2, 4), 16);
+    const b = Number.parseInt(hex.slice(4, 6), 16);
+    const a = hex.length === 8 ? Number.parseInt(hex.slice(6, 8), 16) : 255;
+    return [r, g, b, a];
+}
+//# sourceMappingURL=color.js.map

package/dist/src/color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../../src/color.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG,gBAAgB,CAAA;AAEnC,MAAM,UAAU,iBAAiB,CAChC,KAAyC;IAEzC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAM;IACjD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAA;IAChC,IAAI,CAAC,GAAG;QAAE,OAAM;IAChB,IAAI,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;IAClD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAM;IAEjC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1C,GAAG,GAAG,GAAG;aACP,KAAK,CAAC,EAAE,CAAC;aACT,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC;aAC/B,IAAI,CAAC,EAAE,CAAC,CAAA;IACX,CAAC;SAAM,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAM;IACP,CAAC;IAED,OAAO,IAAI,GAAG,CAAC,WAAW,EAAE,EAAE,CAAA;AAC/B,CAAC;AAED,MAAM,UAAU,cAAc,CAC7B,KAAyC;IAEzC,MAAM,UAAU,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAA;IAC3C,IAAI,CAAC,UAAU;QAAE,OAAM;IACvB,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAC/B,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAC9C,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAC9C,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAC9C,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAA;IACvE,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;AACpB,CAAC"}

package/dist/src/coordinates.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Coordinate precision utilities for OSM data.
+ *
+ * OSM stores coordinates as integer microdegrees (7 decimal places) for
+ * compact storage and consistent precision. This module provides conversions
+ * between floating-point degrees and integer microdegrees.
+ *
+ * @module
+ */
+import type { GeoBbox2D } from "./types";
+/**
+ * OSM coordinate scale: coordinates are stored as integer microdegrees.
+ * 1 microdegree = 1e-7 degrees = 0.0000001 degrees
+ */
+export declare const OSM_COORD_SCALE = 10000000;
+/**
+ * Convert degrees to microdegrees (integer).
+ */
+export declare function toMicroDegrees(degrees: number): number;
+/**
+ * Convert microdegrees (integer) to degrees (float).
+ */
+export declare function microToDegrees(microdegrees: number): number;
+/**
+ * Convert a bounding box from degrees to microdegrees.
+ */
+export declare function bboxToMicroDegrees(bbox: GeoBbox2D): [minLon: number, minLat: number, maxLon: number, maxLat: number];
+//# sourceMappingURL=coordinates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coordinates.d.ts","sourceRoot":"","sources":["../../src/coordinates.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAExC;;;GAGG;AACH,eAAO,MAAM,eAAe,WAAM,CAAA;AAElC;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CACjC,IAAI,EAAE,SAAS,GACb,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAOlE"}

package/dist/src/coordinates.js

@@ -0,0 +1,38 @@
+/**
+ * Coordinate precision utilities for OSM data.
+ *
+ * OSM stores coordinates as integer microdegrees (7 decimal places) for
+ * compact storage and consistent precision. This module provides conversions
+ * between floating-point degrees and integer microdegrees.
+ *
+ * @module
+ */
+/**
+ * OSM coordinate scale: coordinates are stored as integer microdegrees.
+ * 1 microdegree = 1e-7 degrees = 0.0000001 degrees
+ */
+export const OSM_COORD_SCALE = 1e7;
+/**
+ * Convert degrees to microdegrees (integer).
+ */
+export function toMicroDegrees(degrees) {
+    return Math.round(degrees * OSM_COORD_SCALE);
+}
+/**
+ * Convert microdegrees (integer) to degrees (float).
+ */
+export function microToDegrees(microdegrees) {
+    return microdegrees / OSM_COORD_SCALE;
+}
+/**
+ * Convert a bounding box from degrees to microdegrees.
+ */
+export function bboxToMicroDegrees(bbox) {
+    return [
+        toMicroDegrees(bbox[0]),
+        toMicroDegrees(bbox[1]),
+        toMicroDegrees(bbox[2]),
+        toMicroDegrees(bbox[3]),
+    ];
+}
+//# sourceMappingURL=coordinates.js.map

package/dist/src/coordinates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinates.js","sourceRoot":"","sources":["../../src/coordinates.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAA;AAElC;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,eAAe,CAAC,CAAA;AAC7C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,YAAoB;IAClD,OAAO,YAAY,GAAG,eAAe,CAAA;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CACjC,IAAe;IAEf,OAAO;QACN,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACvB,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;KACvB,CAAA;AACF,CAAC"}

package/dist/src/haversine-distance.d.ts

@@ -1,5 +1,13 @@
 /**
- * Calculate the haversine distance between two LonLat points.
+ * Great-circle distance calculation using the Haversine formula.
+ *
+ * Computes the shortest distance between two points on a sphere,
+ * accounting for Earth's curvature. Accurate for most geographic distances.
+ *
+ * @module
+ */
+/**
+ * Calculate the great-circle distance between two geographic points.
  * @param p1 - The first point
  * @param p2 - The second point
  * @returns The haversine distance in meters

package/dist/src/haversine-distance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"haversine-distance.d.ts","sourceRoot":"","sources":["../../src/haversine-distance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAChC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EACpB,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAClB,MAAM,CAWR"}
+{"version":3,"file":"haversine-distance.d.ts","sourceRoot":"","sources":["../../src/haversine-distance.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAChC,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EACpB,EAAE,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAClB,MAAM,CAWR"}

package/dist/src/haversine-distance.js

@@ -1,5 +1,13 @@
 /**
- * Calculate the haversine distance between two LonLat points.
+ * Great-circle distance calculation using the Haversine formula.
+ *
+ * Computes the shortest distance between two points on a sphere,
+ * accounting for Earth's curvature. Accurate for most geographic distances.
+ *
+ * @module
+ */
+/**
+ * Calculate the great-circle distance between two geographic points.
  * @param p1 - The first point
  * @param p2 - The second point
  * @returns The haversine distance in meters

package/dist/src/haversine-distance.js.map

@@ -1 +1 @@
-{"version":3,"file":"haversine-distance.js","sourceRoot":"","sources":["../../src/haversine-distance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAChC,EAAoB,EACpB,EAAoB;IAEpB,MAAM,CAAC,GAAG,SAAS,CAAA,CAAC,2BAA2B;IAC/C,MAAM,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,CAAA;IAC9C,MAAM,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,CAAA;IAC9C,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,CAAA;IACpC,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,CAAA;IACpC,MAAM,CAAC,GACN,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC1D,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACxD,OAAO,CAAC,GAAG,CAAC,CAAA;AACb,CAAC"}
+{"version":3,"file":"haversine-distance.js","sourceRoot":"","sources":["../../src/haversine-distance.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAChC,EAAoB,EACpB,EAAoB;IAEpB,MAAM,CAAC,GAAG,SAAS,CAAA,CAAC,2BAA2B;IAC/C,MAAM,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,CAAA;IAC9C,MAAM,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,CAAA;IAC9C,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,CAAA;IACpC,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC,CAAA;IACpC,MAAM,CAAC,GACN,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC1D,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACxD,OAAO,CAAC,GAAG,CAAC,CAAA;AACb,CAAC"}

package/dist/src/progress.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Progress event helpers for long-running operations.
+ *
+ * Provides a standard interface for reporting progress from workers and
+ * async operations. Uses CustomEvent for cross-context communication.
+ *
+ * @module
+ */
+export type ProgressLevel = "info" | "warn" | "error";
+/**
+ * Progress payload containing a message and timestamp.
+ * Planned expansion to include percentage completion.
+ */
+export type Progress = {
+    msg: string;
+    timestamp: number;
+    level: ProgressLevel;
+};
+/** CustomEvent carrying progress details. */
+export interface ProgressEvent extends CustomEvent<Progress> {
+}
+/**
+ * Create a Progress payload with current timestamp.
+ * @param msg - The progress message.
+ */
+export declare function progress(msg: string, level?: ProgressLevel): Progress;
+/**
+ * Create a ProgressEvent with the given message.
+ * @param msg - The progress message.
+ */
+export declare function progressEvent(msg: string, level?: ProgressLevel): ProgressEvent;
+/**
+ * Extract the message string from a progress event.
+ * @param event - The event to extract from.
+ */
+export declare function progressEventMessage(event: Event): string;
+/**
+ * Log a progress event's message to the console.
+ * @param progress - The progress event to log.
+ */
+export declare function logProgress(progress: ProgressEvent): void;
+//# sourceMappingURL=progress.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../src/progress.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAErD;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG;IACtB,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,EAAE,MAAM,CAAA;IACjB,KAAK,EAAE,aAAa,CAAA;CACpB,CAAA;AAED,6CAA6C;AAC7C,MAAM,WAAW,aAAc,SAAQ,WAAW,CAAC,QAAQ,CAAC;CAAG;AAE/D;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE,aAAsB,GAAG,QAAQ,CAM7E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC5B,GAAG,EAAE,MAAM,EACX,KAAK,GAAE,aAAsB,GAC3B,aAAa,CAEf;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,aAAa,QAclD"}

package/dist/src/progress.js

@@ -0,0 +1,53 @@
+/**
+ * Progress event helpers for long-running operations.
+ *
+ * Provides a standard interface for reporting progress from workers and
+ * async operations. Uses CustomEvent for cross-context communication.
+ *
+ * @module
+ */
+/**
+ * Create a Progress payload with current timestamp.
+ * @param msg - The progress message.
+ */
+export function progress(msg, level = "info") {
+    return {
+        msg,
+        timestamp: Date.now(),
+        level,
+    };
+}
+/**
+ * Create a ProgressEvent with the given message.
+ * @param msg - The progress message.
+ */
+export function progressEvent(msg, level = "info") {
+    return new CustomEvent("progress", { detail: progress(msg, level) });
+}
+/**
+ * Extract the message string from a progress event.
+ * @param event - The event to extract from.
+ */
+export function progressEventMessage(event) {
+    return event.detail.msg;
+}
+/**
+ * Log a progress event's message to the console.
+ * @param progress - The progress event to log.
+ */
+export function logProgress(progress) {
+    const level = progress.detail.level;
+    const message = progressEventMessage(progress);
+    switch (level) {
+        case "info":
+            console.log(message);
+            break;
+        case "warn":
+            console.warn(message);
+            break;
+        case "error":
+            console.error(message);
+            break;
+    }
+}
+//# sourceMappingURL=progress.js.map

package/dist/src/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../src/progress.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW,EAAE,QAAuB,MAAM;IAClE,OAAO;QACN,GAAG;QACH,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,KAAK;KACL,CAAA;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC5B,GAAW,EACX,QAAuB,MAAM;IAE7B,OAAO,IAAI,WAAW,CAAC,UAAU,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;AACrE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAY;IAChD,OAAQ,KAAuB,CAAC,MAAM,CAAC,GAAG,CAAA;AAC3C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,QAAuB;IAClD,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAA;IACnC,MAAM,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAA;IAC9C,QAAQ,KAAK,EAAE,CAAC;QACf,KAAK,MAAM;YACV,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YACpB,MAAK;QACN,KAAK,MAAM;YACV,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACrB,MAAK;QACN,KAAK,OAAO;YACX,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;YACtB,MAAK;IACP,CAAC;AACF,CAAC"}