@osmix/core 0.0.2 → 0.1.1

package/dist/test/typed-arrays.test.js

@@ -1,4 +1,4 @@
-import { describe, expect, it } from "vitest";
+import { describe, expect, it } from "bun:test";
 import { BufferConstructor, ResizeableTypedArray } from "../src/typed-arrays";
 describe("typed array helpers", () => {
     it("selects the appropriate buffer constructor", () => {
@@ -78,23 +78,25 @@ describe("typed array helpers", () => {
             expect(arr.array.length).toBe(8);
             expect(Array.from(arr.slice(0, arr.length))).toEqual([1, 2, 3, 4, 5]);
         });
-        it.runIf(typeof SharedArrayBuffer !== "undefined")("grows shared buffers in place", () => {
-            const backing = new SharedArrayBuffer(8, {
-                maxByteLength: 32,
+        if (typeof SharedArrayBuffer !== "undefined") {
+            it("grows shared buffers in place", () => {
+                const backing = new SharedArrayBuffer(8, {
+                    maxByteLength: 32,
+                });
+                const seed = new Uint8Array(backing);
+                seed.set([1, 2, 3, 4, 5, 6, 7, 8]);
+                const arr = ResizeableTypedArray.from(Uint8Array, backing);
+                arr.bufferSize = arr.buffer.byteLength;
+                arr.maxByteLength = backing.maxByteLength;
+                arr.items = arr.array.length;
+                const originalBuffer = arr.buffer;
+                arr.push(9);
+                expect(arr.buffer).toBe(originalBuffer);
+                expect(arr.array.length).toBe(16);
+                expect(arr.buffer.byteLength).toBe(16);
+                expect(Array.from(arr.slice(0, 9))).toEqual([1, 2, 3, 4, 5, 6, 7, 8, 9]);
             });
-            const seed = new Uint8Array(backing);
-            seed.set([1, 2, 3, 4, 5, 6, 7, 8]);
-            const arr = ResizeableTypedArray.from(Uint8Array, backing);
-            arr.bufferSize = arr.buffer.byteLength;
-            arr.maxByteLength = backing.maxByteLength;
-            arr.items = arr.array.length;
-            const originalBuffer = arr.buffer;
-            arr.push(9);
-            expect(arr.buffer).toBe(originalBuffer);
-            expect(arr.array.length).toBe(16);
-            expect(arr.buffer.byteLength).toBe(16);
-            expect(Array.from(arr.slice(0, 9))).toEqual([1, 2, 3, 4, 5, 6, 7, 8, 9]);
-        });
+        }
     });
 });
 //# sourceMappingURL=typed-arrays.test.js.map

package/dist/test/typed-arrays.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"typed-arrays.test.js","sourceRoot":"","sources":["../../test/typed-arrays.test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"typed-arrays.test.js","sourceRoot":"","sources":["../../test/typed-arrays.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,UAAU,CAAA;AAC/C,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE7E,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACpC,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACrD,IAAI,OAAO,iBAAiB,KAAK,WAAW,EAAE,CAAC;YAC9C,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;QAClD,CAAC;aAAM,CAAC;YACP,MAAM,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA;QAC5C,CAAC;IACF,CAAC,CAAC,CAAA;IAEF,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;QACrC,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;YACnD,MAAM,GAAG,GAAG,IAAI,oBAAoB,CAAC,YAAY,CAAC,CAAA;YAElD,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAC3B,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAE5B,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACrB,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACtB,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAC1B,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAC3B,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC5B,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;YAClC,MAAM,GAAG,GAAG,IAAI,oBAAoB,CAAC,YAAY,CAAC,CAAA;YAElD,GAAG,CAAC,QAAQ,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;YAExB,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAC1B,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAC3B,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC5B,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACzD,MAAM,GAAG,GAAG,IAAI,oBAAoB,CAAC,UAAU,CAAC,CAAA;YAEhD,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;YAE1B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAC1B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAA;YAClE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAC3B,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAC3B,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAA;YACvD,MAAM,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,CAAC,CAAA;QACvD,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;YACzD,MAAM,GAAG,GAAG,IAAI,oBAAoB,CAAC,WAAW,CAAC,CAAA;YAEjD,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YACvB,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;YAEtC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAC1B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QACtE,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;YACxD,MAAM,GAAG,GAAG,IAAI,oBAAoB,CAAC,UAAU,CAAC,CAAA;YAEhD,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YAE1B,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;YAE/B,MAAM,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAAA;YAC1C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YAE3C,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAA;YACf,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC1B,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACxC,MAAM,GAAG,GAAG,IAAI,oBAAoB,CAAC,YAAY,CAAC,CAAA;YAElD,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YAEvB,MAAM,gBAAgB,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAA;YACzC,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,EAAE,CAAA;YAC/B,MAAM,kBAAkB,GAAG,GAAG,CAAC,MAAM,GAAG,YAAY,CAAC,iBAAiB,CAAA;YAEtE,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YACjC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YACzC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,gBAAgB,CAAC,CAAA;YACvD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAA;QAC7D,CAAC,CAAC,CAAA;QAEF,EAAE,CAAC,sDAAsD,EAAE,GAAG,EAAE;YAC/D,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,EAAE,CAAC,CAAA;YACnC,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YAE1C,MAAM,GAAG,GAAG,oBAAoB,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;YAE3D,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAA;YACtC,GAAG,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,CAAA;YACnE,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAA;YAE5B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAC1B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YAElE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAEX,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAC1B,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YAChC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QACtE,CAAC,CAAC,CAAA;QAEF,IAAI,OAAO,iBAAiB,KAAK,WAAW,EAAE,CAAC;YAC9C,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;gBACxC,MAAM,OAAO,GAAG,IAAI,iBAAiB,CAAC,CAAC,EAAE;oBACxC,aAAa,EAAE,EAAE;iBACjB,CAAC,CAAA;gBACF,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,CAAA;gBACpC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;gBAElC,MAAM,GAAG,GAAG,oBAAoB,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;gBAE1D,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAA;gBACtC,GAAG,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAA;gBACzC,GAAG,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAA;gBAE5B,MAAM,cAAc,GAAG,GAAG,CAAC,MAAM,CAAA;gBAEjC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;gBAEX,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAA;gBACvC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;gBACjC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;gBACtC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YACzE,CAAC,CAAC,CAAA;QACH,CAAC;IACF,CAAC,CAAC,CAAA;AACH,CAAC,CAAC,CAAA"}

package/package.json

@@ -2,7 +2,7 @@
 	"$schema": "https://json.schemastore.org/package",
 	"name": "@osmix/core",
 	"type": "module",
-	"version": "0.0.2",
+	"version": "0.1.1",
 	"description": "An OSM PBF reader, writer, and merge tool written in TypeScript",
 	"main": "./src/index.ts",
 	"publishConfig": {
@@ -32,24 +32,22 @@
 	},
 	"sideEffects": false,
 	"scripts": {
-		"build": "tsc",
-		"bench": "vitest bench",
+		"build": "tsc --excludeDirectories test",
+		"bench": "bun test --bench",
 		"prepublishOnly": "tsc",
-		"test": "vitest",
-		"typecheck": "tsc --noEmit"
+		"test": "bun test",
+		"typecheck": "tsgo --noEmit"
 	},
 	"devDependencies": {
-		"@types/geojson": "catalog:",
-		"@types/node": "catalog:",
-		"typescript": "catalog:",
-		"vitest": "catalog:"
+		"@osmix/pbf": "workspace:*",
+		"@types/bun": "catalog:",
+		"typescript": "catalog:"
 	},
 	"dependencies": {
-		"@osmix/json": "workspace:*",
-		"@osmix/pbf": "workspace:*",
 		"@osmix/shared": "workspace:*",
 		"flatbush": "^4.4.1",
-		"kdbush": "mourner/kdbush#16416cd",
-		"sweepline-intersections": "^1.5.0"
+		"geoflatbush": "^2.0.0",
+		"geokdbush": "^2.0.1",
+		"kdbush": "mourner/kdbush#16416cd"
 	}
 }

package/src/entities.ts

@@ -1,59 +1,152 @@
-import type { OsmEntity, OsmEntityType, OsmTags } from "@osmix/json"
-import { type IdOrIndex, Ids, type IdsTransferables } from "./ids"
-import type StringTable from "./stringtable"
-import { Tags, type TagsTransferables } from "./tags"
+/**
+ * Base class for OSM entity collections.
+ *
+ * Provides common ID and tag storage, streaming iteration, and sorted access.
+ * Subclasses implement entity-specific storage and spatial indexing.
+ *
+ * @module
+ */
 
-export interface EntitiesTransferables
-	extends IdsTransferables,
-		TagsTransferables {}
+import type {
+	GeoBbox2D,
+	OsmEntity,
+	OsmEntityType,
+	OsmTags,
+} from "@osmix/shared/types"
+import type { IdOrIndex, Ids, IdsTransferables } from "./ids"
+import type { Tags, TagsTransferables } from "./tags"
+import type { BufferType } from "./typed-arrays"
+import type { ContentHasher } from "./utils"
 
+/**
+ * Serializable representation of an Entities collection for worker transfer.
+ * Combines ID and tag transferables; subclasses add entity-specific data.
+ */
+export interface EntitiesTransferables<T extends BufferType = BufferType>
+	extends IdsTransferables<T>,
+		TagsTransferables<T> {}
+
+/**
+ * Abstract base for typed entity collections.
+ *
+ * Lifecycle:
+ * 1. **Ingest**: `addEntity()` (no lookups).
+ * 2. **Finalize**: `buildIndex()`.
+ * 3. **Query**: Lookups and iteration enabled.
+ */
 export abstract class Entities<T extends OsmEntity> {
+	/** The type of entity stored in this collection ("node", "way", or "relation"). */
 	indexType: OsmEntityType
-	stringTable: StringTable
+	/** ID storage and lookup */
 	ids: Ids
+	/** Tag storage and search */
 	tags: Tags
 
-	private indexBuilt = false
+	/** Whether buildIndex() has been called */
+	protected indexBuilt = false
 
-	constructor(
-		indexType: OsmEntityType,
-		stringTable: StringTable,
-		ids?: Ids,
-		tags?: Tags,
-	) {
-		this.stringTable = stringTable
+	/**
+	 * Create a new Entities collection.
+	 * @param indexType - The entity type ("node", "way", or "relation").
+	 * @param ids - The ID storage instance.
+	 * @param tags - The tag storage instance.
+	 */
+	constructor(indexType: OsmEntityType, ids: Ids, tags: Tags) {
 		this.indexType = indexType
-		this.ids = ids ?? new Ids()
-		this.tags = tags ?? new Tags(stringTable)
+		this.ids = ids
+		this.tags = tags
+	}
+
+	/**
+	 * Get transferable objects for passing to another thread.
+	 */
+	transferables(): EntitiesTransferables {
+		return {
+			...this.ids.transferables(),
+			...this.tags.transferables(),
+		}
 	}
 
-	get isReady() {
-		return this.ids.isReady && this.tags.isReady && this.indexBuilt
+	/**
+	 * Check if the index is built and ready for use.
+	 */
+	isReady() {
+		return this.ids.isReady() && this.tags.isReady() && this.indexBuilt
 	}
 
+	/** Number of entities in this collection. */
 	get size() {
 		return this.ids.size
 	}
 
+	/**
+	 * Compact entity-specific typed arrays.
+	 * Called by `buildIndex()` after ID and tag indexes are built.
+	 * @abstract
+	 */
 	abstract buildEntityIndex(): void
 
+	/**
+	 * Finalize indexes.
+	 * Must be called after adding entities and before querying.
+	 */
 	buildIndex() {
-		console.time(`${this.indexType}Index.finish`)
+		if (this.indexBuilt) return
+		console.time(`${this.indexType}Index.buildIndex`)
 		this.ids.buildIndex()
 		this.tags.buildIndex()
 		this.buildEntityIndex()
 		this.indexBuilt = true
-		console.timeEnd(`${this.indexType}Index.finish`)
+		console.timeEnd(`${this.indexType}Index.buildIndex`)
 	}
 
+	/**
+	 * Get the bounding box of an entity.
+	 * @param idOrIndex - Entity identifier (by ID or internal index).
+	 * @returns Geographic bounding box [minLon, minLat, maxLon, maxLat].
+	 * @abstract
+	 */
+	abstract getEntityBbox(idOrIndex: IdOrIndex): GeoBbox2D
+
+	/**
+	 * Reconstruct a full entity object from index data.
+	 * @param index - Internal array index.
+	 * @param id - OSM entity ID.
+	 * @param tags - Optional pre-fetched tags.
+	 * @returns The complete entity object.
+	 * @abstract
+	 */
 	abstract getFullEntity(index: number, id: number, tags?: OsmTags): T
 
+	/**
+	 * Add an entity to the index. Tags can be provided as an array of keys and values, or as an object.
+	 */
+	addEntity(id: number, tags: number[], values: number[]): number
+	addEntity(id: number, tags: OsmTags): number
+	addEntity(id: number, tags: OsmTags | number[], values?: number[]): number {
+		const entityIndex = this.ids.add(id)
+		if (Array.isArray(tags)) {
+			if (values === undefined)
+				throw Error("Values are required when tags is an array")
+			this.tags.addTagKeysAndValues(entityIndex, tags, values)
+		} else {
+			this.tags.addTags(entityIndex, tags)
+		}
+		return entityIndex
+	}
+
+	/**
+	 * Get an entity by ID or index.
+	 */
 	get(idOrIndex: IdOrIndex): T | null {
 		const [index, id] = this.ids.idOrIndex(idOrIndex)
 		if (index === -1) return null
 		return this.getFullEntity(index, id, this.tags.getTags(index))
 	}
 
+	/**
+	 * Get an entity by index.
+	 */
 	getByIndex(index: number): T {
 		return this.getFullEntity(
 			index,
@@ -62,6 +155,9 @@ export abstract class Entities<T extends OsmEntity> {
 		)
 	}
 
+	/**
+	 * Get multiple entities by their indexes.
+	 */
 	getEntitiesByIndex(indexes: number[]): T[] {
 		const entities: T[] = []
 		for (const index of indexes) {
@@ -72,12 +168,18 @@ export abstract class Entities<T extends OsmEntity> {
 		return entities
 	}
 
+	/**
+	 * Iterate over all entities in the index.
+	 */
 	*[Symbol.iterator](): Generator<T> {
 		for (let i = 0; i < this.size; i++) {
 			yield this.getFullEntity(i, this.ids.at(i), this.tags.getTags(i))
 		}
 	}
 
+	/**
+	 * Get an entity by ID.
+	 */
 	getById(id: number): T | null {
 		const index = this.ids.getIndexFromId(id)
 		if (index !== -1)
@@ -85,6 +187,9 @@ export abstract class Entities<T extends OsmEntity> {
 		return null
 	}
 
+	/**
+	 * Iterate over entities sorted by ID.
+	 */
 	*sorted(): Generator<T> {
 		for (const id of this.ids.sorted) {
 			const index = this.ids.getIndexFromId(id)
@@ -92,4 +197,24 @@ export abstract class Entities<T extends OsmEntity> {
 			yield this.getFullEntity(index, id, this.tags.getTags(index))
 		}
 	}
+
+	/**
+	 * Search for entities with a specific tag key and optional value.
+	 */
+	search(key: string, val?: string): T[] {
+		const keyIndex = this.tags.find(key)
+		const entities = this.tags
+			.hasKey(keyIndex)
+			.map((index) => this.getByIndex(index))
+		if (val === undefined) return entities
+		return entities.filter((entity) => entity.tags?.[key] === val)
+	}
+
+	/**
+	 * Update a ContentHasher with this entity collection's base data (IDs and tags).
+	 * Subclasses should override to add entity-specific data.
+	 */
+	updateHash(hasher: ContentHasher): ContentHasher {
+		return this.ids.updateHash(this.tags.updateHash(hasher))
+	}
 }

package/src/ids.ts

@@ -1,92 +1,131 @@
+/**
+ * ID storage and lookup for OSM entities.
+ *
+ * Uses a two-level binary search (anchor array + block search) to map 64-bit OSM IDs
+ * to internal array indices. Balances memory usage with O(log n) lookup speed.
+ *
+ * @module
+ */
+
 import { assertValue } from "@osmix/shared/assert"
 import {
 	BufferConstructor,
 	type BufferType,
-	ResizeableTypedArray,
+	ResizeableTypedArray as RTA,
 } from "./typed-arrays"
+import type { ContentHasher } from "./utils"
 
+/**
+ * Union type for looking up entities by either OSM ID or internal array index.
+ */
 export type IdOrIndex = { id: number } | { index: number }
 
+/**
+ * Number of IDs per anchor block for the two-level binary search.
+ * Smaller values increase anchor array size but speed up block-level search;
+ * larger values reduce anchor overhead but slow the final search.
+ */
 const BLOCK_SIZE = 256
 
-export interface IdsTransferables {
-	ids: BufferType
-	sortedIds: BufferType
-	sortedIdPositionToIndex: BufferType
-	anchors: BufferType
+/**
+ * Serializable state for worker transfer.
+ */
+export interface IdsTransferables<T extends BufferType = BufferType> {
+	/** Entity IDs in insertion order. */
+	ids: T
+	/** Sorted IDs for binary search (aliases `ids` if already sorted). */
+	sortedIds: T
+	/** Maps sorted position → original insertion index. */
+	sortedIdPositionToIndex: T
+	/** Anchor array: every BLOCK_SIZE-th sorted ID. */
+	anchors: T
+	/** True if IDs were inserted in ascending order. */
 	idsAreSorted: boolean
 }
 
 /**
- * Efficiently store and lookup IDs.
+ * Efficiently store and lookup OSM entity IDs.
  *
- * This is used to store IDs in a sorted array and then use binary search to find the index of an ID.
- * Maps max out at 2^32 IDs.
+ * Stores 64-bit IDs in a Float64Array and maintains a sorted index for O(log n) lookups.
+ * Max capacity: ~2^32 entities.
  */
 export class Ids {
-	private ids: ResizeableTypedArray<Float64Array>
+	/** All IDs in insertion order */
+	private ids: RTA<Float64Array>
+	/** Whether buildIndex() has been called */
 	private indexBuilt = false
+	/** True if IDs were added in ascending order (allows index optimization) */
 	private idsAreSorted = true
+	/** Sorted view of IDs for binary search */
 	private idsSorted: Float64Array
+	/** Maps position in sorted array → original insertion index */
 	private sortedIdPositionToIndex: Uint32Array
+	/** Anchor array for two-level binary search: every BLOCK_SIZE-th sorted ID */
 	private anchors: Float64Array
 
-	static from({
-		ids,
-		sortedIds,
-		sortedIdPositionToIndex,
-		anchors,
-		idsAreSorted,
-	}: IdsTransferables) {
-		const idIndex = new Ids()
-		idIndex.ids = ResizeableTypedArray.from(Float64Array, ids)
-		idIndex.idsSorted = new Float64Array(sortedIds)
-		idIndex.sortedIdPositionToIndex = new Uint32Array(sortedIdPositionToIndex)
-		idIndex.anchors = new Float64Array(anchors)
-		idIndex.indexBuilt = true
-		idIndex.idsAreSorted = idsAreSorted
-		return idIndex
-	}
-
-	constructor() {
-		this.ids = new ResizeableTypedArray(Float64Array)
-		this.idsSorted = new Float64Array(new BufferConstructor(0))
-		this.sortedIdPositionToIndex = new Uint32Array(new BufferConstructor(0))
-		this.anchors = new Float64Array(new BufferConstructor(0))
-	}
-
-	transferables(): IdsTransferables {
-		return {
-			ids: this.ids.array.buffer,
-			sortedIds: this.idsSorted.buffer,
-			sortedIdPositionToIndex: this.sortedIdPositionToIndex.buffer,
-			anchors: this.anchors.buffer,
-			idsAreSorted: this.idsAreSorted,
+	/**
+	 * Create a new Ids index.
+	 * @param transferables - Optional serialized state to reconstruct from.
+	 */
+	constructor(transferables?: IdsTransferables) {
+		if (transferables) {
+			this.ids = RTA.from(Float64Array, transferables.ids)
+			this.idsSorted = new Float64Array(transferables.sortedIds)
+			this.sortedIdPositionToIndex = new Uint32Array(
+				transferables.sortedIdPositionToIndex,
+			)
+			this.anchors = new Float64Array(transferables.anchors)
+			this.idsAreSorted = transferables.idsAreSorted
+			this.indexBuilt = true
+		} else {
+			this.ids = new RTA(Float64Array)
+			this.idsSorted = new Float64Array(new BufferConstructor(0))
+			this.sortedIdPositionToIndex = new Uint32Array(new BufferConstructor(0))
+			this.anchors = new Float64Array(new BufferConstructor(0))
 		}
 	}
 
+	/** Number of IDs stored in this index. */
 	get size() {
 		return this.ids.length
 	}
 
-	get isReady() {
+	/** Returns true if buildIndex() has been called and lookups are enabled. */
+	isReady() {
 		return this.indexBuilt
 	}
 
+	/** Returns true if IDs were inserted in ascending order. */
 	isSorted() {
 		return this.idsAreSorted
 	}
 
-	add(id: number): void {
+	/**
+	 * Add an ID to the index.
+	 * @param id - The OSM entity ID to add.
+	 * @returns The internal array index where this ID was stored.
+	 * @throws If the index has already been built.
+	 */
+	add(id: number): number {
 		if (this.indexBuilt) throw Error("ID index already built.")
 		if (this.ids.length > 0 && id < this.ids.at(-1)) this.idsAreSorted = false
-		this.ids.push(id)
+		return this.ids.push(id)
 	}
 
+	/**
+	 * Get the ID at a specific internal index.
+	 * @param index - The internal array index.
+	 * @returns The OSM entity ID at that index.
+	 */
 	at(index: number): number {
 		return this.ids.at(index)
 	}
 
+	/**
+	 * Check if an ID exists in this index.
+	 * @param id - The OSM entity ID to check.
+	 * @returns True if the ID exists in this index.
+	 */
 	has(id: number): boolean {
 		return this.getIndexFromId(id) !== -1
 	}
@@ -158,7 +197,13 @@ export class Ids {
 		this.indexBuilt = true
 	}
 
-	// Lookup id → index
+	/**
+	 * Look up the internal array index for an OSM entity ID.
+	 *
+	 * @param id - The OSM entity ID to look up.
+	 * @returns The internal array index, or -1 if not found.
+	 * @throws If the index has not been built.
+	 */
 	getIndexFromId(id: number): number {
 		if (!this.indexBuilt) throw Error("IdIndex not built.")
 
@@ -204,7 +249,43 @@ export class Ids {
 		return [i.index, this.at(i.index)]
 	}
 
+	/** Returns the sorted array of IDs for iteration. */
 	get sorted() {
 		return this.idsSorted
 	}
+
+	/**
+	 * Get transferable buffers for passing to another thread.
+	 * @returns Serializable representation of this index.
+	 */
+	transferables(): IdsTransferables {
+		return {
+			ids: this.ids.array.buffer,
+			sortedIds: this.idsSorted.buffer,
+			sortedIdPositionToIndex: this.sortedIdPositionToIndex.buffer,
+			anchors: this.anchors.buffer,
+			idsAreSorted: this.idsAreSorted,
+		}
+	}
+
+	/**
+	 * Get the approximate memory requirements for a given number of IDs in bytes.
+	 */
+	static getBytesRequired(count: number) {
+		if (count === 0) return 0
+		return (
+			count * Float64Array.BYTES_PER_ELEMENT + // ids
+			count * Float64Array.BYTES_PER_ELEMENT + // sortedIds
+			count * Uint32Array.BYTES_PER_ELEMENT + // sortedIdPositionToIndex
+			Math.ceil(count / BLOCK_SIZE) * Float64Array.BYTES_PER_ELEMENT // anchors
+		)
+	}
+
+	/**
+	 * Update a ContentHasher with the IDs data.
+	 * Uses the sorted IDs for consistent hashing regardless of insertion order.
+	 */
+	updateHash(hasher: ContentHasher): ContentHasher {
+		return hasher.update(this.idsSorted)
+	}
 }

package/src/index.ts

@@ -1,7 +1,36 @@
+/**
+ * @osmix/core - In-memory OSM entity storage with spatial indexing.
+ *
+ * Efficiently stores and queries OpenStreetMap entities (nodes, ways, relations).
+ *
+ * Features:
+ * - **Memory-efficient**: Uses typed arrays and Int32Array microdegrees.
+ * - **Spatial indexing**: KDBush (points) and Flatbush (bboxes) for fast geographic queries.
+ * - **Worker-ready**: Zero-copy transfer via `transferables()`.
+ * - **Tag indexing**: Fast reverse lookup by tag key.
+ *
+ * @example
+ * ```ts
+ * import { Osm } from "@osmix/core"
+ * const osm = new Osm({ id: "example" })
+ * osm.nodes.addNode({ id: 1, lon: -122.4, lat: 47.6, tags: { name: "Seattle" } })
+ * osm.buildIndexes()
+ * osm.buildSpatialIndexes()
+ * const nearby = osm.nodes.findIndexesWithinRadius(-122.4, 47.6, 10)
+ * ```
+ *
+ * @module @osmix/core
+ */
+
 /// <reference path="./types/kdbush.d.ts" />
+/// <reference path="./types/geokdbush.d.ts" />
+/// <reference path="./types/geoflatbush.d.ts" />
 
-export { Nodes } from "./nodes"
-export { Osmix } from "./osmix"
-export { Relations } from "./relations"
-export { throttle } from "./utils"
-export { Ways } from "./ways"
+export * from "./nodes"
+export * from "./osm"
+export * from "./relations"
+export * from "./stringtable"
+export * from "./tags"
+export { BufferConstructor, type BufferType } from "./typed-arrays"
+export * from "./utils" // TODO Move into shared?
+export * from "./ways"