@osmix/shared 0.0.2 → 0.0.7

package/dist/types.d.ts

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

package/dist/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/utils.d.ts

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

package/dist/utils.d.ts.map

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

package/dist/utils.js

@@ -0,0 +1,70 @@
+/**
+ * General OSM entity utilities.
+ *
+ * Provides type guards, equality checks, and type detection for OSM entities.
+ * Uses deep equality checking for tags, info, and entity-specific properties.
+ *
+ * @module
+ */
+import { dequal } from "dequal/lite";
+/**
+ * Check if two entities have equal tags and info.
+ */
+function isTagsAndInfoEqual(a, b) {
+    return dequal(a.tags, b.tags) && dequal(a.info, b.info);
+}
+/** Type guard: check if entity is a Node. */
+export function isNode(entity) {
+    return "lon" in entity && "lat" in entity;
+}
+/** Check if two nodes are equal (position, tags, and info). */
+export function isNodeEqual(a, b) {
+    return a.lat === b.lat && a.lon === b.lon && isTagsAndInfoEqual(a, b);
+}
+/** Type guard: check if entity is a Way. */
+export function isWay(entity) {
+    return "refs" in entity;
+}
+/** Type guard: check if entity is a Relation. */
+export function isRelation(entity) {
+    return "members" in entity;
+}
+/** Check if two ways are equal (refs, tags, and info). */
+export function isWayEqual(a, b) {
+    return dequal(a.refs, b.refs) && isTagsAndInfoEqual(a, b);
+}
+/** Check if two relations are equal (members, tags, and info). */
+export function isRelationEqual(a, b) {
+    return dequal(a.members, b.members) && isTagsAndInfoEqual(a, b);
+}
+/** Check if two entities have equal properties (type-aware comparison). */
+export function entityPropertiesEqual(a, b) {
+    if (!dequal(a.tags, b.tags))
+        return false;
+    if (!dequal(a.info, b.info))
+        return false;
+    if (isNode(a) && isNode(b))
+        return isNodeEqual(a, b);
+    if (isWay(a) && isWay(b))
+        return isWayEqual(a, b);
+    if (isRelation(a) && isRelation(b))
+        return isRelationEqual(a, b);
+    return false;
+}
+/** Get the entity type ("node", "way", or "relation") for an entity. */
+export function getEntityType(entity) {
+    if (isNode(entity))
+        return "node";
+    if (isWay(entity))
+        return "way";
+    if (isRelation(entity))
+        return "relation";
+    throw Error("Unknown entity type");
+}
+/**
+ * Check if a relation is a multipolygon relation.
+ */
+export function isMultipolygonRelation(relation) {
+    return relation.tags?.["type"] === "multipolygon";
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AASpC;;GAEG;AACH,SAAS,kBAAkB,CAAC,CAAY,EAAE,CAAY;IACrD,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;AACxD,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,MAAM,CAAC,MAAiB;IACvC,OAAO,KAAK,IAAI,MAAM,IAAI,KAAK,IAAI,MAAM,CAAA;AAC1C,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,WAAW,CAAC,CAAU,EAAE,CAAU;IACjD,OAAO,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,IAAI,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AACtE,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,KAAK,CAAC,MAAiB;IACtC,OAAO,MAAM,IAAI,MAAM,CAAA;AACxB,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,UAAU,CAAC,MAAiB;IAC3C,OAAO,SAAS,IAAI,MAAM,CAAA;AAC3B,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,UAAU,CAAC,CAAS,EAAE,CAAS;IAC9C,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAC1D,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,eAAe,CAAC,CAAc,EAAE,CAAc;IAC7D,OAAO,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AAChE,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,qBAAqB,CAAC,CAAY,EAAE,CAAY;IAC/D,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAA;IACzC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAA;IACzC,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC;QAAE,OAAO,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACpD,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC;QAAE,OAAO,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACjD,IAAI,UAAU,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAChE,OAAO,KAAK,CAAA;AACb,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,aAAa,CAAC,MAAiB;IAC9C,IAAI,MAAM,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAA;IACjC,IAAI,KAAK,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAA;IAC/B,IAAI,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,UAAU,CAAA;IACzC,MAAM,KAAK,CAAC,qBAAqB,CAAC,CAAA;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAqB;IAC3D,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,KAAK,cAAc,CAAA;AAClD,CAAC"}

package/dist/way-is-area.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Area detection for OSM ways.
+ *
+ * Implements the OSM wiki heuristics for determining whether a closed way
+ * should be rendered as an area (polygon) or a closed linear feature.
+ *
+ * @see https://wiki.openstreetmap.org/wiki/Key:area
+ * @see https://wiki.openstreetmap.org/wiki/Overpass_turbo/Polygon_Features
+ *
+ * @module
+ */
+import type { OsmWay } from "./types";
+/**
+ * Determine if a way is an area based on its tags and nodes.
+ *
+ * This function implements the logic described in the OSM wiki:
+ * https://wiki.openstreetmap.org/wiki/Key:area
+ * https://wiki.openstreetmap.org/wiki/Overpass_turbo/Polygon_Features
+ *
+ * @param way - The way to check.
+ * @returns `true` if the way is an area, `false` otherwise.
+ */
+export declare function wayIsArea(way?: OsmWay): boolean;
+//# sourceMappingURL=way-is-area.d.ts.map

package/dist/way-is-area.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"way-is-area.d.ts","sourceRoot":"","sources":["../src/way-is-area.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAqDrC;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CA+B/C"}

package/dist/way-is-area.js

@@ -0,0 +1,104 @@
+/**
+ * Area detection for OSM ways.
+ *
+ * Implements the OSM wiki heuristics for determining whether a closed way
+ * should be rendered as an area (polygon) or a closed linear feature.
+ *
+ * @see https://wiki.openstreetmap.org/wiki/Key:area
+ * @see https://wiki.openstreetmap.org/wiki/Overpass_turbo/Polygon_Features
+ *
+ * @module
+ */
+/**
+ * Tags that imply an area unless their value is exactly "no"
+ */
+const IMPLIED_ANY_VALUE_BUT_NO = new Set([
+    "amenity",
+    "boundary",
+    "building",
+    "building:part",
+    "craft",
+    // 	"golf", Seeing a lot of golf=cartpath which is not an area
+    "historic",
+    "indoor",
+    "landuse",
+    "leisure",
+    "military",
+    "office",
+    "place",
+    "public_transport",
+    "ruins",
+    "shop",
+    "tourism",
+]);
+/**
+ * Tags that imply an area only for these specific values
+ */
+const INCLUDED_VALUE_TAGS = {
+    barrier: new Set([
+        "city_wall",
+        "ditch",
+        "hedge",
+        "retaining_wall",
+        "wall",
+        "spikes",
+    ]),
+    highway: new Set(["services", "rest_area", "escape", "elevator"]),
+    power: new Set(["plant", "substation", "generator", "transformer"]),
+    railway: new Set(["station", "turntable", "roundhouse", "platform"]),
+    waterway: new Set(["riverbank", "dock", "boatyard", "dam"]),
+};
+/**
+ * Tags that imply an area unless the value is in this exclusion list
+ */
+const EXCLUDED_VALUE_TAGS = {
+    aeroway: new Set(["no", "taxiway"]),
+    "area:highway": new Set(["no"]),
+    man_made: new Set(["no", "cutline", "embankment", "pipeline"]),
+    natural: new Set(["no", "coastline", "cliff", "ridge", "arete", "tree_row"]),
+};
+/**
+ * Determine if a way is an area based on its tags and nodes.
+ *
+ * This function implements the logic described in the OSM wiki:
+ * https://wiki.openstreetmap.org/wiki/Key:area
+ * https://wiki.openstreetmap.org/wiki/Overpass_turbo/Polygon_Features
+ *
+ * @param way - The way to check.
+ * @returns `true` if the way is an area, `false` otherwise.
+ */
+export function wayIsArea(way) {
+    if (!way)
+        return false;
+    const { refs, tags } = way;
+    if (refs.length < 3)
+        return false;
+    if (refs[0] !== refs[refs.length - 1])
+        return false;
+    // End refs are equal, no tags, assume it is an area.
+    if (!tags || Object.keys(tags).length === 0)
+        return true;
+    // Explicit override
+    if ("area" in tags)
+        return tags["area"] !== "no";
+    // Tags that count if value is NOT "no"
+    for (const key of IMPLIED_ANY_VALUE_BUT_NO) {
+        const v = tags[key];
+        if (v && v !== "no")
+            return true;
+    }
+    // Tags that are area only for INCLUDED values
+    for (const [key, included] of Object.entries(INCLUDED_VALUE_TAGS)) {
+        const v = tags[key];
+        if (v && included.has(`${v}`))
+            return true;
+    }
+    // Tags that are area unless value is excluded
+    for (const [key, excluded] of Object.entries(EXCLUDED_VALUE_TAGS)) {
+        const v = tags[key];
+        if (v && !excluded.has(`${v}`))
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=way-is-area.js.map

package/dist/way-is-area.js.map

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

package/dist/zigzag.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Zigzag encoding/decoding for protobuf-style varints.
+ *
+ * Zigzag encoding converts signed integers to unsigned by interleaving
+ * negative and positive values: 0, -1, 1, -2, 2, ... This allows efficient
+ * varint encoding of small negative numbers.
+ *
+ * @module
+ */
+/**
+ * Zigzag encode a number using arithmetic operations.
+ * This supports the full safe integer range (up to Number.MAX_SAFE_INTEGER).
+ * Formula: n < 0 ? -2*n - 1 : 2*n
+ *
+ * Used for encoding IDs in vector tiles to convert negative IDs to positive numbers
+ * for unsigned varint encoding.
+ */
+export declare function zigzag(num: number): number;
+/**
+ * Zigzag encode using bitwise operations (for geometry deltas only).
+ * This is faster but limited to 32-bit signed integers.
+ * Used for small coordinate deltas in geometry encoding.
+ */
+export declare function zigzag32(num: number): number;
+/**
+ * Decode zigzag-encoded number back to original value.
+ * Zigzag encoding is used to convert negative IDs to positive numbers for unsigned varint
+ * encoding in vector tiles. Uses arithmetic-based decoding to support the full safe integer range.
+ *
+ * Formula: (encoded & 1) === 1 ? -(encoded + 1) / 2 : encoded / 2
+ */
+export declare function decodeZigzag(encoded: number): number;
+//# sourceMappingURL=zigzag.d.ts.map

package/dist/zigzag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zigzag.d.ts","sourceRoot":"","sources":["../src/zigzag.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGpD"}

package/dist/zigzag.js

@@ -0,0 +1,40 @@
+/**
+ * Zigzag encoding/decoding for protobuf-style varints.
+ *
+ * Zigzag encoding converts signed integers to unsigned by interleaving
+ * negative and positive values: 0, -1, 1, -2, 2, ... This allows efficient
+ * varint encoding of small negative numbers.
+ *
+ * @module
+ */
+/**
+ * Zigzag encode a number using arithmetic operations.
+ * This supports the full safe integer range (up to Number.MAX_SAFE_INTEGER).
+ * Formula: n < 0 ? -2*n - 1 : 2*n
+ *
+ * Used for encoding IDs in vector tiles to convert negative IDs to positive numbers
+ * for unsigned varint encoding.
+ */
+export function zigzag(num) {
+    return num < 0 ? -2 * num - 1 : 2 * num;
+}
+/**
+ * Zigzag encode using bitwise operations (for geometry deltas only).
+ * This is faster but limited to 32-bit signed integers.
+ * Used for small coordinate deltas in geometry encoding.
+ */
+export function zigzag32(num) {
+    return (num << 1) ^ (num >> 31);
+}
+/**
+ * Decode zigzag-encoded number back to original value.
+ * Zigzag encoding is used to convert negative IDs to positive numbers for unsigned varint
+ * encoding in vector tiles. Uses arithmetic-based decoding to support the full safe integer range.
+ *
+ * Formula: (encoded & 1) === 1 ? -(encoded + 1) / 2 : encoded / 2
+ */
+export function decodeZigzag(encoded) {
+    // Check if encoded is odd (negative) using bitwise, then use arithmetic
+    return (encoded & 1) === 1 ? -(encoded + 1) / 2 : encoded / 2;
+}
+//# sourceMappingURL=zigzag.js.map

package/dist/zigzag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zigzag.js","sourceRoot":"","sources":["../src/zigzag.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;;;;;GAOG;AACH,MAAM,UAAU,MAAM,CAAC,GAAW;IACjC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAA;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAW;IACnC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAA;AAChC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,OAAe;IAC3C,wEAAwE;IACxE,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAA;AAC9D,CAAC"}

package/package.json

@@ -2,7 +2,7 @@
 	"$schema": "https://json.schemastore.org/package",
 	"name": "@osmix/shared",
 	"type": "module",
-	"version": "0.0.2",
+	"version": "0.0.7",
 	"description": "Shared utilities for Osmix",
 	"exports": {
 		"./*": "./src/*.ts",
@@ -36,19 +36,20 @@
 	},
 	"sideEffects": false,
 	"scripts": {
-		"build": "tsc",
-		"bench": "vitest bench",
-		"prepublishOnly": "tsc",
-		"test": "vitest",
-		"typecheck": "tsc --noEmit"
+		"build": "tsc -p tsconfig.build.json",
+		"bench": "bun test --bench",
+		"prepare": "bun run build",
+		"release": "bun publish",
+		"test": "bun test",
+		"typecheck": "tsgo --noEmit"
 	},
 	"devDependencies": {
-		"@types/node": "catalog:",
-		"typescript": "catalog:",
-		"vitest": "catalog:"
+		"@types/bun": "^1.3.3",
+		"typescript": "^5.9.0"
 	},
 	"dependencies": {
-		"@mapbox/sphericalmercator": "catalog:",
+		"@mapbox/tilebelt": "^2.0.3",
+		"dequal": "^2.0.3",
 		"lineclip": "^2.0.0"
 	}
 }

package/src/assert.ts

@@ -1,5 +1,25 @@
 /**
- * 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<T>(
 	value?: T,

package/src/bbox-intersects.ts

@@ -0,0 +1,30 @@
+/**
+ * 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 function bboxContainsOrIntersects(bb1: GeoBbox2D, bb2: GeoBbox2D) {
+	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)
+}

package/src/bytes-to-stream.ts

@@ -1,3 +1,20 @@
+/**
+ * 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: Uint8Array<ArrayBuffer>) {
 	return new ReadableStream<Uint8Array<ArrayBuffer>>({
 		start(controller) {

package/src/color.ts

@@ -0,0 +1,37 @@
+import type { Rgba } from "./types"
+
+const hexPattern = /^[0-9a-fA-F]+$/
+
+export function normalizeHexColor(
+	value: string | number | null | undefined,
+): string | undefined {
+	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: string | number | null | undefined,
+): Rgba | undefined {
+	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]
+}

package/src/coordinates.ts

@@ -0,0 +1,45 @@
+/**
+ * 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 const OSM_COORD_SCALE = 1e7
+
+/**
+ * Convert degrees to microdegrees (integer).
+ */
+export function toMicroDegrees(degrees: number): number {
+	return Math.round(degrees * OSM_COORD_SCALE)
+}
+
+/**
+ * Convert microdegrees (integer) to degrees (float).
+ */
+export function microToDegrees(microdegrees: number): number {
+	return microdegrees / OSM_COORD_SCALE
+}
+
+/**
+ * Convert a bounding box from degrees to microdegrees.
+ */
+export function bboxToMicroDegrees(
+	bbox: GeoBbox2D,
+): [minLon: number, minLat: number, maxLon: number, maxLat: number] {
+	return [
+		toMicroDegrees(bbox[0]),
+		toMicroDegrees(bbox[1]),
+		toMicroDegrees(bbox[2]),
+		toMicroDegrees(bbox[3]),
+	]
+}