@osmix/shared 0.0.2 → 0.0.7

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # @osmix/shared
 
+## 0.0.7
+
+### Patch Changes
+
+- 68d6bd8: Fix publishing for packages.
+
+## 0.0.6
+
+### Patch Changes
+
+- 0cd8a2e: Explore patterns for extending Osmix worker
+
+## 0.0.5
+
+### Patch Changes
+
+- bb629cf: Simplify raster drawing when geometry is smaller than a pixel
+- edbb26b: Handle more Relation types
+- 69a36bd: Switch Nodes coordinate storage to Int32Array
+
+## 0.0.4
+
+### Patch Changes
+
+- 572cbd8: Raster tile updates
+- d001d9a: Refactor to align around new main external API
+
+## 0.0.3
+
+### Patch Changes
+
+- b4a3ff2: Improve Relation handling and display
+
 ## 0.0.2
 
 ### Patch Changes

package/README.md

@@ -1,30 +1,60 @@
 # @osmix/shared
 
-`@osmix/shared` exposes small geometry helpers that packages across the Osmix workspace rely on.
+`@osmix/shared` hosts the low-level geometry, math, and infrastructure helpers
+used across every Osmix package. Modules are published via subpath exports, so
+import the functions you need directly from `@osmix/shared/<module>`.
 
 ## Highlights
 
-- `haversineDistance` – Compute great-circle distances between lon/lat pairs in meters.
-- `clipPolyline` – Re-export of [`lineclip`](https://github.com/mourner/lineclip) for clipping projected polylines to axis-aligned bounding boxes with types added.
+- Geometry math (`haversine-distance`, `lineclip`, `relation-multipolygon`,
+  `way-is-area`) with TypeScript typings and lon/lat-friendly utilities.
+- Streaming helpers (`bytes-to-stream`, `stream-to-bytes`, `transform-bytes`)
+  that normalize Node/Bun/Web APIs.
+- Worker-friendly tooling (`progress`, `throttle`, `assert`) for consistent
+  logging and defensive checks.
 
 ## Installation
 
 ```sh
-npm install @osmix/shared
+bun install @osmix/shared
 ```
 
-## Usage
-
-```ts
-import { haversineDistance, clipPolyline } from "@osmix/shared"
-
-const meters = haversineDistance([-122.33, 47.61], [-122.30, 47.63])
-
-const segments = clipPolyline(
-	[
-		[-122.33, 47.61],
-		[-122.31, 47.62],
-	],
-	[-122.40, 47.50, -122.20, 47.70],
-)
-```
+## Frequently used modules
+
+| Module | Description |
+| --- | --- |
+| `@osmix/shared/assert` | Tiny invariant helpers that throw typed errors. |
+| `@osmix/shared/bbox-intersects` | Bounding-box intersection + containment checks. |
+| `@osmix/shared/bytes-to-stream` | Create a ReadableStream from a Uint8Array. |
+| `@osmix/shared/coordinates` | Utilities for coordinate precision (7 decimal places). |
+| `@osmix/shared/haversine-distance` | Great-circle distance (meters) for lon/lat pairs. |
+| `@osmix/shared/lineclip` | Typed wrapper around `lineclip` for polylines/polygons. |
+| `@osmix/shared/progress` | Shared `ProgressEvent` helpers + `logProgress`. |
+| `@osmix/shared/relation-kind` | Detect relation types (multipolygon, route, etc). |
+| `@osmix/shared/relation-multipolygon` | Builds multipolygon rings from relation members. |
+| `@osmix/shared/stream-to-bytes` | Consume a ReadableStream into a Uint8Array. |
+| `@osmix/shared/throttle` | Worker-safe throttling for logging/progress updates. |
+| `@osmix/shared/tile` | Utilities for working with tile coordinates. |
+| `@osmix/shared/transform-bytes` | Transform streams (gzip, etc) helper. |
+| `@osmix/shared/utils` | General OSM entity utilities (equality, type checks). |
+| `@osmix/shared/way-is-area` | Implements the OSM wiki “is area” heuristics. |
+| `@osmix/shared/zigzag` | Protobuf-style zigzag encoding helpers. |
+
+All modules are tree-shakeable; only import what you need.
+
+## Related Packages
+
+- [`@osmix/core`](../core/README.md) – In-memory OSM index using these shared utilities.
+- [`@osmix/pbf`](../pbf/README.md) – PBF parsing that uses zigzag encoding and streaming helpers.
+- [`@osmix/json`](../json/README.md) – JSON entity conversion using shared types.
+- [`@osmix/geojson`](../geojson/README.md) – GeoJSON conversion using coordinate and type utilities.
+- [`@osmix/change`](../change/README.md) – Changeset management using entity utilities.
+
+## Development
+
+- `bun run test packages/shared`
+- `bun run lint packages/shared`
+- `bun run typecheck packages/shared`
+
+Run `bun run check` at the repo root before publishing to ensure formatting,
+lint, and type coverage.

package/dist/assert.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 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/assert.d.ts.map

@@ -0,0 +1 @@
+{"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/assert.js

@@ -0,0 +1,28 @@
+/**
+ * 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) {
+        throw Error(message ?? "Value is undefined or null");
+    }
+}
+//# sourceMappingURL=assert.js.map

package/dist/assert.js.map

@@ -0,0 +1 @@
+{"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/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/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/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/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/bytes-to-stream.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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/bytes-to-stream.d.ts.map

@@ -0,0 +1 @@
+{"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/bytes-to-stream.js

@@ -0,0 +1,25 @@
+/**
+ * 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) {
+            controller.enqueue(bytes);
+            controller.close();
+        },
+    });
+}
+//# sourceMappingURL=bytes-to-stream.js.map

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

@@ -0,0 +1 @@
+{"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/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/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/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/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/concat-bytes.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Concatenates multiple `Uint8Array` segments into a contiguous array.
+ */
+export declare function concatBytes(parts: Uint8Array<ArrayBuffer>[]): Uint8Array<ArrayBuffer>;
+//# sourceMappingURL=concat-bytes.d.ts.map

package/dist/concat-bytes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concat-bytes.d.ts","sourceRoot":"","sources":["../src/concat-bytes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,WAAW,CAC1B,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,GAC9B,UAAU,CAAC,WAAW,CAAC,CASzB"}

package/dist/concat-bytes.js

@@ -0,0 +1,14 @@
+/**
+ * Concatenates multiple `Uint8Array` segments into a contiguous array.
+ */
+export function concatBytes(parts) {
+    const total = parts.reduce((n, p) => n + p.length, 0);
+    const out = new Uint8Array(new ArrayBuffer(total));
+    let offset = 0;
+    for (const p of parts) {
+        out.set(p, offset);
+        offset += p.length;
+    }
+    return out;
+}
+//# sourceMappingURL=concat-bytes.js.map

package/dist/concat-bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concat-bytes.js","sourceRoot":"","sources":["../src/concat-bytes.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,WAAW,CAC1B,KAAgC;IAEhC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IACrD,MAAM,GAAG,GAAG,IAAI,UAAU,CAAc,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,CAAA;IAC/D,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACvB,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAA;QAClB,MAAM,IAAI,CAAC,CAAC,MAAM,CAAA;IACnB,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC"}

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

@@ -0,0 +1,16 @@
+/**
+ * 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
+ */
+export declare function haversineDistance(p1: [number, number], p2: [number, number]): number;
+//# sourceMappingURL=haversine-distance.d.ts.map

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

@@ -0,0 +1 @@
+{"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/haversine-distance.js

@@ -0,0 +1,26 @@
+/**
+ * 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
+ */
+export function haversineDistance(p1, p2) {
+    const R = 6371008.8; // Earth's radius in meters
+    const dLat = (p2[1] - p1[1]) * (Math.PI / 180);
+    const dLon = (p2[0] - p1[0]) * (Math.PI / 180);
+    const lat1 = p1[1] * (Math.PI / 180);
+    const lat2 = p2[1] * (Math.PI / 180);
+    const a = Math.sin(dLat / 2) ** 2 +
+        Math.sin(dLon / 2) ** 2 * Math.cos(lat1) * Math.cos(lat2);
+    const c = 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
+    return R * c;
+}
+//# sourceMappingURL=haversine-distance.js.map

package/dist/haversine-distance.js.map

@@ -0,0 +1 @@
+{"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/lineclip.d.ts

@@ -0,0 +1,2 @@
+export { clipPolygon, clipPolyline } from "lineclip";
+//# sourceMappingURL=lineclip.d.ts.map

package/dist/lineclip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineclip.d.ts","sourceRoot":"","sources":["../src/lineclip.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA"}

package/dist/lineclip.js

@@ -0,0 +1,3 @@
+/// <reference path="./lineclip.d.ts" />
+export { clipPolygon, clipPolyline } from "lineclip";
+//# sourceMappingURL=lineclip.js.map

package/dist/lineclip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lineclip.js","sourceRoot":"","sources":["../src/lineclip.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA"}

package/dist/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/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/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/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"}