@osmix/shared 0.0.6 → 0.0.7

package/dist/transform-bytes.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Transform stream utilities.
+ *
+ * Helpers for piping byte arrays through TransformStreams (e.g., compression).
+ *
+ * @module
+ */
+/**
+ * Pipe a byte array through a TransformStream and return the result.
+ *
+ * Useful for applying compression/decompression or other transformations
+ * to byte data using the Web Streams API.
+ *
+ * @param bytes - The input bytes.
+ * @param transformStream - The transform to apply (e.g., CompressionStream).
+ * @returns A Promise resolving to the transformed bytes.
+ *
+ * @example
+ * ```ts
+ * const compressed = await transformBytes(data, new CompressionStream('gzip'))
+ * ```
+ */
+export declare function transformBytes(bytes: Uint8Array<ArrayBuffer>, transformStream: TransformStream<Uint8Array<ArrayBuffer>, Uint8Array<ArrayBuffer>>): Promise<Uint8Array<ArrayBuffer>>;
+//# sourceMappingURL=transform-bytes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transform-bytes.d.ts","sourceRoot":"","sources":["../src/transform-bytes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CACnC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,EAC9B,eAAe,EAAE,eAAe,CAC/B,UAAU,CAAC,WAAW,CAAC,EACvB,UAAU,CAAC,WAAW,CAAC,CACvB,GACC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAElC"}

package/dist/transform-bytes.js

@@ -0,0 +1,28 @@
+/**
+ * Transform stream utilities.
+ *
+ * Helpers for piping byte arrays through TransformStreams (e.g., compression).
+ *
+ * @module
+ */
+import { bytesToStream } from "./bytes-to-stream";
+import { streamToBytes } from "./stream-to-bytes";
+/**
+ * Pipe a byte array through a TransformStream and return the result.
+ *
+ * Useful for applying compression/decompression or other transformations
+ * to byte data using the Web Streams API.
+ *
+ * @param bytes - The input bytes.
+ * @param transformStream - The transform to apply (e.g., CompressionStream).
+ * @returns A Promise resolving to the transformed bytes.
+ *
+ * @example
+ * ```ts
+ * const compressed = await transformBytes(data, new CompressionStream('gzip'))
+ * ```
+ */
+export async function transformBytes(bytes, transformStream) {
+    return streamToBytes(bytesToStream(bytes).pipeThrough(transformStream));
+}
+//# sourceMappingURL=transform-bytes.js.map

package/dist/transform-bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform-bytes.js","sourceRoot":"","sources":["../src/transform-bytes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEjD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,KAA8B,EAC9B,eAGC;IAED,OAAO,aAAa,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,CAAA;AACxE,CAAC"}

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":"AAAA;;;;;;;GAOG;AAEH,4DAA4D;AAC5D,MAAM,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAA;AAC/C,wDAAwD;AACxD,MAAM,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,CAAA;AAEvC,+DAA+D;AAC/D,MAAM,WAAW,OAAO;IACvB,GAAG,EAAE,MAAM,CAAA;IACX,GAAG,EAAE,MAAM,CAAA;CACX;AACD,8CAA8C;AAC9C,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,CAAA;AAEpD;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,EAAE,CAAA;AAE5D,MAAM,MAAM,iBAAiB,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,EAAE,CAAA;AAE7E,MAAM,MAAM,IAAI,GACb,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,GAC5C,iBAAiB,CAAA;AAEpB;;;GAGG;AACH,MAAM,MAAM,SAAS,GAAG;IACvB,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,MAAM;CACd,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACxB,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;CACZ,CAAA;AAED;;GAEG;AAEH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,GAAG,UAAU,CAAA;AAEvD,MAAM,WAAW,aAAa;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,OAAO;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;CAC9B;AAED,UAAU,UAAU;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,aAAa,CAAA;IACpB,IAAI,CAAC,EAAE,OAAO,CAAA;CACd;AAED,MAAM,WAAW,OAAQ,SAAQ,UAAU,EAAE,OAAO;CAAG;AAEvD,MAAM,WAAW,MAAO,SAAQ,UAAU;IAEzC,IAAI,EAAE,MAAM,EAAE,CAAA;CACd;AAED,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,aAAa,CAAA;IACnB,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC9C,OAAO,EAAE,iBAAiB,EAAE,CAAA;CAC5B;AAED,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,CAAA;AAEtD,MAAM,WAAW,gBAAiB,SAAQ,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC;IAC1E,IAAI,EAAE,OAAO,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,WAAW,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAA;AAExE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,IAAI,EAAE,YAAY,CAAA;IAClB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;IACxB,YAAY,EAAE,OAAO,CAAA;IACrB,WAAW,EAAE,MAAM,CAAA;CACnB"}

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.6",
+	"version": "0.0.7",
 	"description": "Shared utilities for Osmix",
 	"exports": {
 		"./*": "./src/*.ts",
@@ -36,19 +36,20 @@
 	},
 	"sideEffects": false,
 	"scripts": {
-		"build": "tsc",
+		"build": "tsc -p tsconfig.build.json",
 		"bench": "bun test --bench",
-		"prepublishOnly": "tsc",
+		"prepare": "bun run build",
+		"release": "bun publish",
 		"test": "bun test",
 		"typecheck": "tsgo --noEmit"
 	},
 	"devDependencies": {
-		"@types/bun": "catalog:",
-		"typescript": "catalog:"
+		"@types/bun": "^1.3.3",
+		"typescript": "^5.9.0"
 	},
 	"dependencies": {
-		"@mapbox/tilebelt": "^2.0.2",
-		"dequal": "catalog:",
+		"@mapbox/tilebelt": "^2.0.3",
+		"dequal": "^2.0.3",
 		"lineclip": "^2.0.0"
 	}
 }

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/progress.ts

@@ -7,6 +7,8 @@
  * @module
  */
 
+export type ProgressLevel = "info" | "warn" | "error"
+
 /**
  * Progress payload containing a message and timestamp.
  * Planned expansion to include percentage completion.
@@ -14,6 +16,7 @@
 export type Progress = {
 	msg: string
 	timestamp: number
+	level: ProgressLevel
 }
 
 /** CustomEvent carrying progress details. */
@@ -23,10 +26,11 @@ export interface ProgressEvent extends CustomEvent<Progress> {}
  * Create a Progress payload with current timestamp.
  * @param msg - The progress message.
  */
-export function progress(msg: string): Progress {
+export function progress(msg: string, level: ProgressLevel = "info"): Progress {
 	return {
 		msg,
 		timestamp: Date.now(),
+		level,
 	}
 }
 
@@ -34,8 +38,11 @@ export function progress(msg: string): Progress {
  * Create a ProgressEvent with the given message.
  * @param msg - The progress message.
  */
-export function progressEvent(msg: string): ProgressEvent {
-	return new CustomEvent("progress", { detail: progress(msg) })
+export function progressEvent(
+	msg: string,
+	level: ProgressLevel = "info",
+): ProgressEvent {
+	return new CustomEvent("progress", { detail: progress(msg, level) })
 }
 
 /**
@@ -51,5 +58,17 @@ export function progressEventMessage(event: Event): string {
  * @param progress - The progress event to log.
  */
 export function logProgress(progress: ProgressEvent) {
-	console.log(progressEventMessage(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
+	}
 }

package/src/test/fixtures.ts

@@ -25,6 +25,9 @@ export async function getFixtureFile(
 		const file = await Bun.file(filePath).arrayBuffer()
 		return new Uint8Array<ArrayBuffer>(file)
 	} catch (_error) {
+		if (process.env["CI"]) {
+			throw Error(`Do not download fixtures in CI: ${url} not found`)
+		}
 		const response = await fetch(url)
 		const buffer = await response.arrayBuffer()
 		const data = new Uint8Array<ArrayBuffer>(buffer)