osmix 0.0.2 → 0.0.6

package/CHANGELOG.md

@@ -1,5 +1,78 @@
 # osmix
 
+## 0.0.6
+
+### Patch Changes
+
+- 0cd8a2e: Explore patterns for extending Osmix worker
+- Updated dependencies [3846a0c]
+- Updated dependencies [2c03b6c]
+- Updated dependencies [0cd8a2e]
+- Updated dependencies [cdab4db]
+  - @osmix/change@0.0.6
+  - @osmix/core@0.0.6
+  - @osmix/vt@0.0.6
+  - @osmix/shared@0.0.6
+  - @osmix/geojson@0.0.4
+  - @osmix/json@0.0.6
+  - @osmix/pbf@0.0.3
+  - @osmix/raster@0.0.6
+
+## 0.0.5
+
+### Patch Changes
+
+- bb629cf: Simplify raster drawing when geometry is smaller than a pixel
+- 345b716: Move functionality outside of the Changeset
+- edbb26b: Handle more Relation types
+- 45b1802: Add `transformOsmPbfToJson` helper
+- 69a36bd: Switch Nodes coordinate storage to Int32Array
+- Updated dependencies [bb629cf]
+- Updated dependencies [a33a280]
+- Updated dependencies [345b716]
+- Updated dependencies [edbb26b]
+- Updated dependencies [69a36bd]
+  - @osmix/raster@0.0.5
+  - @osmix/shared@0.0.5
+  - @osmix/vt@0.0.5
+  - @osmix/core@0.0.5
+  - @osmix/change@0.0.5
+  - @osmix/geojson@0.0.3
+  - @osmix/json@0.0.5
+  - @osmix/pbf@0.0.3
+
+## 0.0.4
+
+### Patch Changes
+
+- d001d9a: Refactor to align around new main external API
+- Updated dependencies [572cbd8]
+- Updated dependencies [d001d9a]
+- Updated dependencies [b2f14d3]
+- Updated dependencies [4303c40]
+  - @osmix/raster@0.0.4
+  - @osmix/shared@0.0.4
+  - @osmix/geojson@0.0.2
+  - @osmix/change@0.0.4
+  - @osmix/core@0.0.4
+  - @osmix/json@0.0.4
+  - @osmix/pbf@0.0.3
+  - @osmix/vt@0.0.4
+
+## 0.0.3
+
+### Patch Changes
+
+- Updated dependencies [b4a3ff2]
+- Updated dependencies [c0193dd]
+  - @osmix/raster@0.0.3
+  - @osmix/shared@0.0.3
+  - @osmix/core@0.0.3
+  - @osmix/json@0.0.3
+  - @osmix/vt@0.0.3
+  - @osmix/change@0.0.3
+  - @osmix/pbf@0.0.2
+
 ## 0.0.2
 
 ### Patch Changes

package/README.md

@@ -0,0 +1,177 @@
+# osmix
+
+`osmix` is the high-level entrypoint for the Osmix toolkit. It layers ingestion,
+streaming, and worker orchestration utilities on top of the low-level
+`@osmix/core` index so you can load `.osm.pbf` files, convert GeoJSON, and
+request raster/vector tiles with a single import.
+
+## Installation
+
+```sh
+bun install osmix
+```
+
+## Usage
+
+### Load a PBF and inspect it
+
+```ts
+import { fromPbf, fromGeoJSON, toPbfBuffer } from "osmix"
+
+const monacoPbf = await Bun.file("./monaco.pbf").arrayBuffer()
+const osm = await fromPbf(monacoPbf)
+
+console.log(osm.nodes.size, osm.ways.size, osm.relations.size)
+
+const geojsonFile = await fetch("/fixtures/buildings.geojson").then((r) => r.arrayBuffer())
+const geoOsm = await fromGeoJSON(geojsonFile)
+const pbfBytes = await toPbfBuffer(geoOsm)
+```
+
+### Work off the main thread with `OsmixRemote`
+
+```ts
+import { createRemote } from "osmix"
+
+const remote = await createRemote()
+const monacoOsmInfo = await remote.fromPbf(monacoPbf)
+const patchOsmInfo = await remote.fromPbf(Bun.file("patch.osm.pbf").stream(), {
+	id: "patch",
+})
+await remote.merge(monacoOsmInfo, patchOsmInfo)
+const rasterTile = await remote.getRasterTile(monacoOsmInfo, [10561, 22891, 16])
+```
+
+#### How?
+
+`OsmixRemote` automatically transfers typed arrays across workers (using
+`SharedArrayBuffer` when available) and exposes the same helpers exposed in the main import: `fromPbf`, `fromGeoJSON`, `getVectorTile`, `getRasterTile`,
+`search`, `merge`, `generateChangeset`, etc. Use `collectTransferables` +
+`transfer` when you need to post Osmix payloads through your own worker setup.
+
+### Routing with workers
+
+`OsmixRemote` provides off-thread routing via `@osmix/router`. The routing graph
+builds lazily on first use, so there's no upfront cost until you actually route.
+
+```ts
+import { createRemote } from "osmix"
+
+const remote = await createRemote()
+const osmInfo = await remote.fromPbf(monacoPbf)
+
+// Find nearest routable nodes to coordinates
+const from = await remote.findNearestRoutableNode(osmInfo.id, [7.42, 43.73], 0.5)
+const to = await remote.findNearestRoutableNode(osmInfo.id, [7.43, 43.74], 0.5)
+
+if (from && to) {
+	// Calculate route with statistics and path info
+	const result = await remote.route(osmInfo.id, from.nodeIndex, to.nodeIndex, {
+		includeStats: true,
+		includePathInfo: true,
+	})
+
+	if (result) {
+		console.log(result.coordinates) // Route geometry
+		console.log(result.distance) // Distance in meters
+		console.log(result.time) // Time in seconds
+		console.log(result.segments) // Per-way breakdown
+	}
+}
+```
+
+The routing graph is automatically shared across all workers when using
+`SharedArrayBuffer`, so any worker can handle routing requests.
+
+### Extract, stream, and write back to PBF
+
+```ts
+import { fromPbf, createExtract, toPbfStream } from "osmix"
+
+const osm = await fromPbf(Bun.file('./monaco.pbf').stream())
+const downtown = createExtract(osm, [-122.35, 47.60, -122.32, 47.62])
+await toPbfStream(downtown).pipeTo(fileWritableStream)
+```
+
+`createExtract` can either clip ways/members to the bbox (`strategy: "simple"`)
+or include complete ways/relations. `toPbfStream` and `toPbfBuffer`
+reuse the streaming builders from `@osmix/json`/`@osmix/pbf`, so outputs stay
+spec-compliant without staging everything in memory.
+
+## API
+
+### Loading
+
+- `fromPbf(data, options?)` - Load OSM data from PBF (buffer, stream, or File).
+- `fromGeoJSON(data, options?)` - Load OSM data from GeoJSON.
+- `readOsmPbfHeader(data)` - Read only the PBF header without loading entities.
+
+### Export
+
+- `toPbfStream(osm)` - Stream Osm to PBF bytes (memory-efficient).
+- `toPbfBuffer(osm)` - Convert Osm to a single PBF buffer.
+
+### Extraction
+
+- `createExtract(osm, bbox, strategy?)` - Create geographic extract.
+  - `"simple"` - Strict spatial cut.
+  - `"complete_ways"` - Include complete way geometry.
+  - `"smart"` - Complete ways + resolved multipolygons.
+
+### Tiles
+
+- `drawToRasterTile(osm, tile, tileSize?)` - Render Osm to raster tile.
+
+### Workers (OsmixRemote)
+
+- `createRemote(options?)` - Create worker pool manager.
+- `remote.fromPbf(data, options?)` - Load in worker.
+- `remote.fromGeoJSON(data, options?)` - Load in worker.
+- `remote.getVectorTile(osmId, tile)` - Generate MVT in worker.
+- `remote.getRasterTile(osmId, tile, tileSize?)` - Generate raster in worker.
+- `remote.merge(baseId, patchId, options?)` - Merge datasets in worker.
+- `remote.search(osmId, key, val?)` - Search by tag.
+- `remote.toPbf(osmId, stream)` - Export to PBF.
+
+#### Routing
+
+- `remote.buildRoutingGraph(osmId, filter?, speeds?)` - Explicitly build routing graph (optional, builds lazily on first use).
+- `remote.hasRoutingGraph(osmId)` - Check if routing graph exists.
+- `remote.findNearestRoutableNode(osmId, point, maxKm)` - Snap coordinate to nearest routable node.
+- `remote.route(osmId, fromIndex, toIndex, options?)` - Calculate route between nodes.
+  - `options.includeStats` - Include `distance` and `time` in result.
+  - `options.includePathInfo` - Include `segments` and `turnPoints` in result.
+
+### Utilities
+
+- `collectTransferables(value)` - Find transferable buffers in nested objects.
+- `transfer(data)` - Wrap data for zero-copy worker transfer.
+
+## Related Packages
+
+- [`@osmix/core`](../core/README.md) - In-memory OSM index with typed arrays and spatial queries.
+- [`@osmix/pbf`](../pbf/README.md) - Low-level PBF reading and writing.
+- [`@osmix/json`](../json/README.md) - PBF to JSON entity conversion.
+- [`@osmix/geojson`](../geojson/README.md) - GeoJSON import/export.
+- [`@osmix/change`](../change/README.md) - Changeset management and merge workflows.
+- [`@osmix/raster`](../raster/README.md) - Raster tile rendering.
+- [`@osmix/vt`](../vt/README.md) - Vector tile encoding.
+- [`@osmix/router`](../router/README.md) - Pathfinding on OSM road networks.
+- [`@osmix/shared`](../shared/README.md) - Shared utilities and types.
+
+## Environment and limitations
+
+- Requires runtimes that expose Web Streams plus modern typed array + compression
+  APIs (Node 20+, Bun, current browsers). `OsmixRemote` also requires `Worker`
+  support and, for multi-worker concurrency, `SharedArrayBuffer`.
+- `fromPbf` expects dense-node blocks; sparse node encodings are not yet supported.
+- Raster helpers rely on `OffscreenCanvas` + `ImageData`.
+
+## Development
+
+- `bun run test packages/osmix`
+- `bun run lint packages/osmix`
+- `bun run typecheck packages/osmix`
+
+Run `bun run check` from the repo root before publishing to keep formatting,
+lint, and types consistent.

package/dist/src/extract.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Geographic extraction from OSM indexes.
+ *
+ * Creates subsets of OSM data within bounding boxes using various strategies
+ * that control how ways and relations at the boundary are handled.
+ *
+ * @module
+ */
+import { Osm } from "@osmix/core";
+import { type ProgressEvent } from "@osmix/shared/progress";
+import type { GeoBbox2D } from "@osmix/shared/types";
+/**
+ * Strategy for handling entities at extract boundaries.
+ * - `"simple"`: Strict spatial cut, may have incomplete geometries.
+ * - `"complete_ways"`: Preserves complete way geometry, adds nodes outside bbox.
+ * - `"smart"`: Like complete_ways, plus fully resolves multipolygon relations.
+ */
+export type ExtractStrategy = "simple" | "complete_ways" | "smart";
+/**
+ * Create a geographic extract from an existing Osm instance within a bounding box.
+ *
+ * Strategy "simple":
+ * 1. Selects all nodes inside the bbox.
+ * 2. Selects ways with at least one node inside the bbox, filtering refs to only include nodes inside the bbox.
+ * 3. Selects relations with at least one member inside the bbox, filtering members to only include nodes and ways inside the bbox.
+ *
+ * Strategy "complete_ways":
+ * 1. Selects all nodes inside the bbox.
+ * 2. Selects ways with at least one node inside the bbox, adding missing way nodes from outside the bbox. All ways will be reference complete.
+ * 3. Selects relations with at least one member inside the bbox leaving out any members that are not inside the bbox. Relations are not reference complete.
+ *
+ * Strategy "smart":
+ * 1 & 2. Same as "complete_ways".
+ * 3. Selects relations with at least one member inside the bbox, adding missing relation members from outside the bbox. Relations are reference complete.
+ *
+ * The "complete_ways" strategy preserves way geometry integrity but includes entities outside the bbox.
+ * The "simple" strategy creates a strict spatial cut but may result in incomplete geometries.
+ * Both strategies handle nested relations by resolving all descendant members.
+ *
+ * See https://osmcode.org/osmium-tool/manual.html#creating-geographic-extracts for more details.
+ */
+export declare function createExtract(osm: Osm, bbox: GeoBbox2D, strategy?: ExtractStrategy, onProgress?: (progress: ProgressEvent) => void): Osm;
+//# sourceMappingURL=extract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/extract.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAA;AACjC,OAAO,EAEN,KAAK,aAAa,EAElB,MAAM,wBAAwB,CAAA;AAE/B,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,qBAAqB,CAAA;AAGjE;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,eAAe,GAAG,OAAO,CAAA;AAElE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAC5B,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,SAAS,EACf,QAAQ,GAAE,eAAiC,EAC3C,UAAU,GAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAkB,GACzD,GAAG,CA6HL"}

package/dist/src/extract.js

@@ -0,0 +1,156 @@
+/**
+ * Geographic extraction from OSM indexes.
+ *
+ * Creates subsets of OSM data within bounding boxes using various strategies
+ * that control how ways and relations at the boundary are handled.
+ *
+ * @module
+ */
+import { Osm } from "@osmix/core";
+import { logProgress, progressEvent, } from "@osmix/shared/progress";
+import { resolveRelationMembers } from "@osmix/shared/relation-kind";
+import { isMultipolygonRelation } from "@osmix/shared/utils";
+/**
+ * Create a geographic extract from an existing Osm instance within a bounding box.
+ *
+ * Strategy "simple":
+ * 1. Selects all nodes inside the bbox.
+ * 2. Selects ways with at least one node inside the bbox, filtering refs to only include nodes inside the bbox.
+ * 3. Selects relations with at least one member inside the bbox, filtering members to only include nodes and ways inside the bbox.
+ *
+ * Strategy "complete_ways":
+ * 1. Selects all nodes inside the bbox.
+ * 2. Selects ways with at least one node inside the bbox, adding missing way nodes from outside the bbox. All ways will be reference complete.
+ * 3. Selects relations with at least one member inside the bbox leaving out any members that are not inside the bbox. Relations are not reference complete.
+ *
+ * Strategy "smart":
+ * 1 & 2. Same as "complete_ways".
+ * 3. Selects relations with at least one member inside the bbox, adding missing relation members from outside the bbox. Relations are reference complete.
+ *
+ * The "complete_ways" strategy preserves way geometry integrity but includes entities outside the bbox.
+ * The "simple" strategy creates a strict spatial cut but may result in incomplete geometries.
+ * Both strategies handle nested relations by resolving all descendant members.
+ *
+ * See https://osmcode.org/osmium-tool/manual.html#creating-geographic-extracts for more details.
+ */
+export function createExtract(osm, bbox, strategy = "complete_ways", onProgress = logProgress) {
+    if (!osm.isReady())
+        throw Error("Osm is not ready for extraction.");
+    onProgress(progressEvent(`Creating extract ${osm.id} with strategy=${strategy} in bbox ${bbox.join(", ")}...`));
+    const [minLon, minLat, maxLon, maxLat] = bbox;
+    const extracted = new Osm({
+        id: osm.id,
+        header: {
+            ...osm.header,
+            bbox: {
+                left: minLon,
+                bottom: minLat,
+                right: maxLon,
+                top: maxLat,
+            },
+        },
+    });
+    const nodeIds = new Set();
+    const wayIds = new Set();
+    const relationIds = new Set();
+    const addNodeIfMissing = (id) => {
+        if (nodeIds.has(id))
+            return;
+        const node = osm.nodes.getById(id);
+        if (!node)
+            throw Error(`Node ${id} not found`);
+        extracted.nodes.addNode(node);
+        nodeIds.add(id);
+    };
+    const addWayIfMissing = (id) => {
+        if (wayIds.has(id))
+            return;
+        const way = osm.ways.getById(id);
+        if (!way)
+            throw Error(`Way ${id} not found`);
+        for (const ref of way.refs)
+            addNodeIfMissing(ref);
+        extracted.ways.addWay(way);
+        wayIds.add(id);
+    };
+    const addRelationIfMissing = (relation) => {
+        if (relationIds.has(relation.id))
+            return;
+        relationIds.add(relation.id);
+        for (const member of relation.members) {
+            if (member.type === "node")
+                addNodeIfMissing(member.ref);
+            if (member.type === "way")
+                addWayIfMissing(member.ref);
+            if (member.type === "relation") {
+                const nestedRelation = osm.relations.getById(member.ref);
+                if (nestedRelation)
+                    addRelationIfMissing(nestedRelation);
+            }
+        }
+        extracted.relations.addRelation(relation);
+    };
+    onProgress(progressEvent("Extracting nodes..."));
+    for (const nodeIndex of osm.nodes.findIndexesWithinBbox(bbox)) {
+        const node = osm.nodes.getByIndex(nodeIndex);
+        extracted.nodes.addNode(node);
+        nodeIds.add(node.id);
+    }
+    onProgress(progressEvent("Extracting ways..."));
+    for (const way of osm.ways.sorted()) {
+        if (way.refs.some((ref) => nodeIds.has(ref))) {
+            wayIds.add(way.id);
+            if (strategy === "complete_ways" || strategy === "smart") {
+                for (const ref of way.refs)
+                    addNodeIfMissing(ref);
+                extracted.ways.addWay(way);
+            }
+            else if (strategy === "simple") {
+                extracted.ways.addWay({
+                    ...way,
+                    refs: way.refs.filter((ref) => nodeIds.has(ref)),
+                });
+            }
+        }
+    }
+    onProgress(progressEvent("Extracting relations..."));
+    for (const relation of osm.relations.sorted()) {
+        // Resolve nested relations to get all descendant nodes and ways
+        const resolved = resolveRelationMembers(relation, (relId) => osm.relations.getById(relId), 10);
+        // Check if relation has any members that intersect the bbox
+        const hasIntersectingMembers = resolved.nodes.some((id) => nodeIds.has(id)) ||
+            resolved.ways.some((id) => wayIds.has(id));
+        if (hasIntersectingMembers) {
+            if (isMultipolygonRelation(relation) && strategy === "smart") {
+                // Add relation and recursively add direct members even if they're outside the bbox
+                addRelationIfMissing(relation);
+            }
+            else {
+                // Otherwise, filter out members that are outside the bbox
+                extracted.relations.addRelation({
+                    ...relation,
+                    members: relation.members.filter((m) => {
+                        if (m.type === "node")
+                            return nodeIds.has(m.ref);
+                        if (m.type === "way")
+                            return wayIds.has(m.ref);
+                        if (m.type === "relation") {
+                            const nestedRelation = osm.relations.getById(m.ref);
+                            if (!nestedRelation)
+                                return false;
+                            // Include nested relation if it has intersecting members
+                            const nestedResolved = resolveRelationMembers(nestedRelation, (relId) => osm.relations.getById(relId));
+                            return (nestedResolved.nodes.some((id) => nodeIds.has(id)) ||
+                                nestedResolved.ways.some((id) => wayIds.has(id)));
+                        }
+                        return false;
+                    }),
+                });
+            }
+        }
+    }
+    extracted.buildIndexes();
+    extracted.buildSpatialIndexes();
+    return extracted;
+}
+//# sourceMappingURL=extract.js.map

package/dist/src/extract.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,58 @@
+/**
+ * osmix - High-level entrypoint for the Osmix toolkit.
+ *
+ * This package provides a unified API for loading, manipulating, and exporting
+ * OpenStreetMap data. It layers ingestion, streaming, and worker orchestration
+ * on top of the lower-level @osmix/* packages.
+ *
+ * Key capabilities:
+ * - **Loading**: Load PBF files and GeoJSON into memory-efficient Osm indexes.
+ * - **Streaming**: Convert between PBF and JSON entity streams.
+ * - **Extraction**: Create geographic extracts with various strategies.
+ * - **Tiles**: Generate raster and vector tiles from OSM data.
+ * - **Workers**: Offload heavy operations to Web Workers with `OsmixRemote`.
+ * - **Merging**: Combine datasets with deduplication and intersection creation.
+ *
+ * @example
+ * ```ts
+ * import { fromPbf, toPbfBuffer, createExtract } from "osmix"
+ *
+ * // Load from PBF
+ * const osm = await fromPbf(pbfFile.stream())
+ *
+ * // Create extract
+ * const downtown = createExtract(osm, [-122.35, 47.60, -122.32, 47.62])
+ *
+ * // Export to PBF
+ * const pbfBytes = await toPbfBuffer(downtown)
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Use workers for off-thread processing
+ * import { createRemote } from "osmix"
+ *
+ * const remote = await createRemote()
+ * const osmInfo = await remote.fromPbf(pbfFile)
+ * const tile = await remote.getVectorTile(osmInfo.id, [9372, 12535, 15])
+ * ```
+ *
+ * @module osmix
+ */
+export * from "@osmix/change";
+export * from "@osmix/core";
+export * from "@osmix/geojson";
+export * from "@osmix/json";
+export * from "@osmix/pbf";
+export * from "@osmix/raster";
+export * from "@osmix/router";
+export * from "@osmix/shared/types";
+export * from "@osmix/vt";
+export * from "./extract";
+export * from "./pbf";
+export * from "./raster";
+export * from "./remote";
+export * from "./settings";
+export * from "./utils";
+export * from "./worker";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAGH,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,qBAAqB,CAAA;AACnC,cAAc,WAAW,CAAA;AAGzB,cAAc,WAAW,CAAA;AACzB,cAAc,OAAO,CAAA;AACrB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA"}

package/dist/src/index.js

@@ -0,0 +1,60 @@
+/**
+ * osmix - High-level entrypoint for the Osmix toolkit.
+ *
+ * This package provides a unified API for loading, manipulating, and exporting
+ * OpenStreetMap data. It layers ingestion, streaming, and worker orchestration
+ * on top of the lower-level @osmix/* packages.
+ *
+ * Key capabilities:
+ * - **Loading**: Load PBF files and GeoJSON into memory-efficient Osm indexes.
+ * - **Streaming**: Convert between PBF and JSON entity streams.
+ * - **Extraction**: Create geographic extracts with various strategies.
+ * - **Tiles**: Generate raster and vector tiles from OSM data.
+ * - **Workers**: Offload heavy operations to Web Workers with `OsmixRemote`.
+ * - **Merging**: Combine datasets with deduplication and intersection creation.
+ *
+ * @example
+ * ```ts
+ * import { fromPbf, toPbfBuffer, createExtract } from "osmix"
+ *
+ * // Load from PBF
+ * const osm = await fromPbf(pbfFile.stream())
+ *
+ * // Create extract
+ * const downtown = createExtract(osm, [-122.35, 47.60, -122.32, 47.62])
+ *
+ * // Export to PBF
+ * const pbfBytes = await toPbfBuffer(downtown)
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Use workers for off-thread processing
+ * import { createRemote } from "osmix"
+ *
+ * const remote = await createRemote()
+ * const osmInfo = await remote.fromPbf(pbfFile)
+ * const tile = await remote.getVectorTile(osmInfo.id, [9372, 12535, 15])
+ * ```
+ *
+ * @module osmix
+ */
+// Re-export core libraries
+export * from "@osmix/change";
+export * from "@osmix/core";
+export * from "@osmix/geojson";
+export * from "@osmix/json";
+export * from "@osmix/pbf";
+export * from "@osmix/raster";
+export * from "@osmix/router";
+export * from "@osmix/shared/types";
+export * from "@osmix/vt";
+// Export new utilities
+export * from "./extract";
+export * from "./pbf";
+export * from "./raster";
+export * from "./remote";
+export * from "./settings";
+export * from "./utils";
+export * from "./worker";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,2BAA2B;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAC7B,cAAc,qBAAqB,CAAA;AACnC,cAAc,WAAW,CAAA;AAEzB,uBAAuB;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,OAAO,CAAA;AACrB,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA"}

package/dist/src/osmix.worker.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Default OsmixWorker entry point.
+ *
+ * This file serves as the default worker entry point that exposes a standard OsmixWorker.
+ * For custom workers, import {OsmixWorker} from "osmix" instead to avoid the side effect.
+ *
+ * @example
+ * // Using the default worker (via OsmixRemote with no workerUrl)
+ * const remote = await createRemote()
+ *
+ * @example
+ * // Custom worker - import from worker to avoid side effects
+ * import { OsmixWorker } from "osmix"
+ * import { expose } from "comlink"
+ *
+ * class MyWorker extends OsmixWorker {
+ *   myMethod() { ... }
+ * }
+ * expose(new MyWorker())
+ */
+export {};
+//# sourceMappingURL=osmix.worker.d.ts.map

package/dist/src/osmix.worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"osmix.worker.d.ts","sourceRoot":"","sources":["../../src/osmix.worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}

package/dist/src/osmix.worker.js

@@ -0,0 +1,24 @@
+/**
+ * Default OsmixWorker entry point.
+ *
+ * This file serves as the default worker entry point that exposes a standard OsmixWorker.
+ * For custom workers, import {OsmixWorker} from "osmix" instead to avoid the side effect.
+ *
+ * @example
+ * // Using the default worker (via OsmixRemote with no workerUrl)
+ * const remote = await createRemote()
+ *
+ * @example
+ * // Custom worker - import from worker to avoid side effects
+ * import { OsmixWorker } from "osmix"
+ * import { expose } from "comlink"
+ *
+ * class MyWorker extends OsmixWorker {
+ *   myMethod() { ... }
+ * }
+ * expose(new MyWorker())
+ */
+import { expose } from "comlink";
+import { OsmixWorker } from "./worker";
+expose(new OsmixWorker());
+//# sourceMappingURL=osmix.worker.js.map

package/dist/src/osmix.worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"osmix.worker.js","sourceRoot":"","sources":["../../src/osmix.worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAEtC,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC,CAAA"}