@math.gl/geospatial 5.0.0-alpha.2 → 5.0.0-alpha.20

package/dist/wkb/wkb-reader.js

@@ -0,0 +1,251 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import { getWellKnownDimensionSize } from "./types.js";
+const GEOMETRY_TYPES = [
+    'Point',
+    'LineString',
+    'Polygon',
+    'MultiPoint',
+    'MultiLineString',
+    'MultiPolygon',
+    'GeometryCollection'
+];
+/** Inspects one WKB/ISO WKB/EWKB header without reading its coordinate payload. */
+export function inspectWKBHeader(input, byteOffset = 0) {
+    return inspectWKBHeaderView(getDataView(input), byteOffset);
+}
+/**
+ * Traverses exactly one WKB geometry without constructing coordinate or geometry objects.
+ * Returns the number of bytes consumed.
+ */
+export function visitWKB(input, visitor, options = {}) {
+    const view = getDataView(input);
+    const state = {
+        maximumDepth: validateLimit(options.maximumDepth, 64, 'maximumDepth'),
+        maximumElements: validateLimit(options.maximumElements, 100000000, 'maximumElements'),
+        elementCount: 0,
+        visitor
+    };
+    const byteLength = visitGeometry(view, 0, state, 0).byteOffset;
+    if (byteLength !== view.byteLength)
+        throw new Error('WKB contains trailing bytes');
+    return byteLength;
+}
+/** Collects geometry counts and XYZM bounds without materializing geometry rows. */
+export function scanWKB(input, options = {}) {
+    const header = inspectWKBHeader(input);
+    const geometryCounts = {
+        Point: 0,
+        LineString: 0,
+        Polygon: 0,
+        MultiPoint: 0,
+        MultiLineString: 0,
+        MultiPolygon: 0,
+        GeometryCollection: 0
+    };
+    const geometryTypes = new Set();
+    const bounds = {};
+    let coordinateCount = 0;
+    let ringCount = 0;
+    let geometryCount = 0;
+    let maximumDepth = 0;
+    const byteLength = visitWKB(input, {
+        geometry: (geometryHeader, _count, depth) => {
+            geometryCounts[geometryHeader.geometryType]++;
+            geometryTypes.add(geometryHeader.geometryType);
+            geometryCount++;
+            maximumDepth = Math.max(maximumDepth, depth);
+        },
+        ring: () => ringCount++,
+        coordinate: (x, y, z, m) => {
+            coordinateCount++;
+            updateBounds(bounds, 'x', x);
+            updateBounds(bounds, 'y', y);
+            if (z !== undefined)
+                updateBounds(bounds, 'z', z);
+            if (m !== undefined)
+                updateBounds(bounds, 'm', m);
+        }
+    }, options);
+    const concreteBounds = makeBounds(bounds);
+    return {
+        header,
+        byteLength,
+        coordinateCount,
+        ringCount,
+        geometryCount,
+        maximumDepth,
+        geometryTypes: GEOMETRY_TYPES.filter(type => geometryTypes.has(type)),
+        geometryCounts,
+        ...(concreteBounds ? { bounds: concreteBounds } : {})
+    };
+}
+function visitGeometry(view, byteOffset, state, depth, expectedType) {
+    if (depth > state.maximumDepth)
+        throw new Error('WKB geometry nesting exceeds maximumDepth');
+    const header = inspectWKBHeaderView(view, byteOffset);
+    if (expectedType && header.geometryType !== expectedType) {
+        throw new Error(`WKB ${expectedType} collection contains a ${header.geometryType} child`);
+    }
+    byteOffset = header.bodyByteOffset;
+    switch (header.geometryType) {
+        case 'Point':
+            state.visitor.geometry?.(header, undefined, depth);
+            byteOffset = visitCoordinate(view, byteOffset, header, state.visitor, depth);
+            break;
+        case 'LineString': {
+            const pointCount = readCount(view, byteOffset, header.littleEndian, state);
+            byteOffset += 4;
+            state.visitor.geometry?.(header, pointCount, depth);
+            byteOffset = visitCoordinateSequence(view, byteOffset, pointCount, header, state, depth);
+            break;
+        }
+        case 'Polygon': {
+            const ringCount = readCount(view, byteOffset, header.littleEndian, state);
+            byteOffset += 4;
+            state.visitor.geometry?.(header, ringCount, depth);
+            for (let ringIndex = 0; ringIndex < ringCount; ringIndex++) {
+                const pointCount = readCount(view, byteOffset, header.littleEndian, state);
+                byteOffset += 4;
+                state.visitor.ring?.(pointCount, ringIndex, depth);
+                byteOffset = visitCoordinateSequence(view, byteOffset, pointCount, header, state, depth);
+            }
+            break;
+        }
+        case 'MultiPoint':
+        case 'MultiLineString':
+        case 'MultiPolygon':
+        case 'GeometryCollection': {
+            const childCount = readCount(view, byteOffset, header.littleEndian, state);
+            byteOffset += 4;
+            state.visitor.geometry?.(header, childCount, depth);
+            const childType = header.geometryType === 'MultiPoint'
+                ? 'Point'
+                : header.geometryType === 'MultiLineString'
+                    ? 'LineString'
+                    : header.geometryType === 'MultiPolygon'
+                        ? 'Polygon'
+                        : undefined;
+            for (let childIndex = 0; childIndex < childCount; childIndex++) {
+                byteOffset = visitGeometry(view, byteOffset, state, depth + 1, childType).byteOffset;
+            }
+            break;
+        }
+    }
+    return { byteOffset, header };
+}
+function visitCoordinateSequence(view, byteOffset, pointCount, header, state, depth) {
+    for (let pointIndex = 0; pointIndex < pointCount; pointIndex++) {
+        byteOffset = visitCoordinate(view, byteOffset, header, state.visitor, depth);
+    }
+    return byteOffset;
+}
+function visitCoordinate(view, byteOffset, header, visitor, depth) {
+    const coordinateByteLength = getWellKnownDimensionSize(header.dimension) * 8;
+    assertRemaining(view, byteOffset, coordinateByteLength);
+    if (!visitor.coordinate)
+        return byteOffset + coordinateByteLength;
+    const x = view.getFloat64(byteOffset, header.littleEndian);
+    const y = view.getFloat64(byteOffset + 8, header.littleEndian);
+    const third = header.dimension === 'xy' ? undefined : view.getFloat64(byteOffset + 16, header.littleEndian);
+    const fourth = header.dimension === 'xyzm' ? view.getFloat64(byteOffset + 24, header.littleEndian) : undefined;
+    const z = header.dimension === 'xyz' || header.dimension === 'xyzm' ? third : undefined;
+    const m = header.dimension === 'xym' ? third : fourth;
+    visitor.coordinate?.(x, y, z, m, header.dimension, byteOffset, depth);
+    return byteOffset + coordinateByteLength;
+}
+function inspectWKBHeaderView(view, byteOffset) {
+    const startByteOffset = byteOffset;
+    assertRemaining(view, byteOffset, 5);
+    const byteOrder = view.getUint8(byteOffset++);
+    if (byteOrder !== 0 && byteOrder !== 1)
+        throw new Error('Invalid WKB byte order');
+    const littleEndian = byteOrder === 1;
+    const typeCode = view.getUint32(byteOffset, littleEndian);
+    byteOffset += 4;
+    const hasZ = Boolean(typeCode & 0x80000000);
+    const hasM = Boolean(typeCode & 0x40000000);
+    const hasSrid = Boolean(typeCode & 0x20000000);
+    let geometryCode = typeCode & 0x1fffffff;
+    let dimension;
+    if (geometryCode >= 3000 && geometryCode < 4000) {
+        dimension = 'xyzm';
+        geometryCode -= 3000;
+    }
+    else if (geometryCode >= 2000 && geometryCode < 3000) {
+        dimension = 'xym';
+        geometryCode -= 2000;
+    }
+    else if (geometryCode >= 1000 && geometryCode < 2000) {
+        dimension = 'xyz';
+        geometryCode -= 1000;
+    }
+    else {
+        dimension = hasZ && hasM ? 'xyzm' : hasZ ? 'xyz' : hasM ? 'xym' : 'xy';
+    }
+    const geometryType = GEOMETRY_TYPES[geometryCode - 1];
+    if (!geometryType)
+        throw new Error(`Unsupported WKB geometry type ${geometryCode}`);
+    let srid;
+    if (hasSrid) {
+        assertRemaining(view, byteOffset, 4);
+        srid = view.getUint32(byteOffset, littleEndian);
+        byteOffset += 4;
+    }
+    const dialect = hasZ || hasM || hasSrid ? 'ewkb' : dimension === 'xy' ? 'wkb' : 'iso-wkb';
+    return {
+        geometryType,
+        dimension,
+        dialect,
+        littleEndian,
+        byteOffset: startByteOffset,
+        bodyByteOffset: byteOffset,
+        byteLength: byteOffset - startByteOffset,
+        ...(srid === undefined ? {} : { srid })
+    };
+}
+function readCount(view, byteOffset, littleEndian, state) {
+    assertRemaining(view, byteOffset, 4);
+    const count = view.getUint32(byteOffset, littleEndian);
+    state.elementCount += count;
+    if (state.elementCount > state.maximumElements) {
+        throw new Error('WKB element count exceeds maximumElements');
+    }
+    return count;
+}
+function updateBounds(bounds, axis, value) {
+    if (!Number.isFinite(value))
+        return;
+    const minimum = `${axis}min`;
+    const maximum = `${axis}max`;
+    bounds[minimum] = bounds[minimum] === undefined ? value : Math.min(bounds[minimum], value);
+    bounds[maximum] = bounds[maximum] === undefined ? value : Math.max(bounds[maximum], value);
+}
+function makeBounds(bounds) {
+    if (bounds.xmin === undefined ||
+        bounds.ymin === undefined ||
+        bounds.xmax === undefined ||
+        bounds.ymax === undefined) {
+        return undefined;
+    }
+    return bounds;
+}
+function getDataView(input) {
+    return ArrayBuffer.isView(input)
+        ? new DataView(input.buffer, input.byteOffset, input.byteLength)
+        : new DataView(input);
+}
+function assertRemaining(view, byteOffset, byteLength) {
+    if (byteOffset < 0 || byteOffset + byteLength > view.byteLength) {
+        throw new Error('Unexpected end of WKB');
+    }
+}
+function validateLimit(value, fallback, name) {
+    const limit = value ?? fallback;
+    if (!Number.isSafeInteger(limit) || limit < 0) {
+        throw new Error(`${name} must be a non-negative safe integer`);
+    }
+    return limit;
+}
+//# sourceMappingURL=wkb-reader.js.map

package/dist/wkb/wkb-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wkb-reader.js","sourceRoot":"","sources":["../../src/wkb/wkb-reader.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAG5D,OAAO,EAAC,yBAAyB,EAAC,mBAAgB;AAmGlD,MAAM,cAAc,GAA+B;IACjD,OAAO;IACP,YAAY;IACZ,SAAS;IACT,YAAY;IACZ,iBAAiB;IACjB,cAAc;IACd,oBAAoB;CACrB,CAAC;AAEF,mFAAmF;AACnF,MAAM,UAAU,gBAAgB,CAC9B,KAAwC,EACxC,UAAU,GAAG,CAAC;IAEd,OAAO,oBAAoB,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,CAAC;AAC9D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,KAAwC,EACxC,OAAmB,EACnB,UAA+B,EAAE;IAEjC,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAChC,MAAM,KAAK,GAAmB;QAC5B,YAAY,EAAE,aAAa,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,EAAE,cAAc,CAAC;QACrE,eAAe,EAAE,aAAa,CAAC,OAAO,CAAC,eAAe,EAAE,SAAW,EAAE,iBAAiB,CAAC;QACvF,YAAY,EAAE,CAAC;QACf,OAAO;KACR,CAAC;IACF,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;IAC/D,IAAI,UAAU,KAAK,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACnF,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,OAAO,CACrB,KAAwC,EACxC,UAA+B,EAAE;IAEjC,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,cAAc,GAAoC;QACtD,KAAK,EAAE,CAAC;QACR,UAAU,EAAE,CAAC;QACb,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,CAAC;QACb,eAAe,EAAE,CAAC;QAClB,YAAY,EAAE,CAAC;QACf,kBAAkB,EAAE,CAAC;KACtB,CAAC;IACF,MAAM,aAAa,GAAG,IAAI,GAAG,EAAmB,CAAC;IACjD,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,MAAM,UAAU,GAAG,QAAQ,CACzB,KAAK,EACL;QACE,QAAQ,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE;YAC1C,cAAc,CAAC,cAAc,CAAC,YAAY,CAAC,EAAE,CAAC;YAC9C,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,CAAC,CAAC;YAC/C,aAAa,EAAE,CAAC;YAChB,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,EAAE,GAAG,EAAE,CAAC,SAAS,EAAE;QACvB,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE;YACzB,eAAe,EAAE,CAAC;YAClB,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;YAC7B,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;YAC7B,IAAI,CAAC,KAAK,SAAS;gBAAE,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;YAClD,IAAI,CAAC,KAAK,SAAS;gBAAE,YAAY,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QACpD,CAAC;KACF,EACD,OAAO,CACR,CAAC;IAEF,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO;QACL,MAAM;QACN,UAAU;QACV,eAAe;QACf,SAAS;QACT,aAAa;QACb,YAAY;QACZ,aAAa,EAAE,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrE,cAAc;QACd,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAC,MAAM,EAAE,cAAc,EAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KACpD,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,IAAc,EACd,UAAkB,EAClB,KAAqB,EACrB,KAAa,EACb,YAA8B;IAE9B,IAAI,KAAK,GAAG,KAAK,CAAC,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC7F,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACtD,IAAI,YAAY,IAAI,MAAM,CAAC,YAAY,KAAK,YAAY,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,OAAO,YAAY,0BAA0B,MAAM,CAAC,YAAY,QAAQ,CAAC,CAAC;IAC5F,CAAC;IACD,UAAU,GAAG,MAAM,CAAC,cAAc,CAAC;IAEnC,QAAQ,MAAM,CAAC,YAAY,EAAE,CAAC;QAC5B,KAAK,OAAO;YACV,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;YACnD,UAAU,GAAG,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC7E,MAAM;QACR,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YAC3E,UAAU,IAAI,CAAC,CAAC;YAChB,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;YACpD,UAAU,GAAG,uBAAuB,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YACzF,MAAM;QACR,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YAC1E,UAAU,IAAI,CAAC,CAAC;YAChB,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;YACnD,KAAK,IAAI,SAAS,GAAG,CAAC,EAAE,SAAS,GAAG,SAAS,EAAE,SAAS,EAAE,EAAE,CAAC;gBAC3D,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;gBAC3E,UAAU,IAAI,CAAC,CAAC;gBAChB,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;gBACnD,UAAU,GAAG,uBAAuB,CAAC,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;YAC3F,CAAC;YACD,MAAM;QACR,CAAC;QACD,KAAK,YAAY,CAAC;QAClB,KAAK,iBAAiB,CAAC;QACvB,KAAK,cAAc,CAAC;QACpB,KAAK,oBAAoB,CAAC,CAAC,CAAC;YAC1B,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YAC3E,UAAU,IAAI,CAAC,CAAC;YAChB,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;YACpD,MAAM,SAAS,GACb,MAAM,CAAC,YAAY,KAAK,YAAY;gBAClC,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,MAAM,CAAC,YAAY,KAAK,iBAAiB;oBACzC,CAAC,CAAC,YAAY;oBACd,CAAC,CAAC,MAAM,CAAC,YAAY,KAAK,cAAc;wBACtC,CAAC,CAAC,SAAS;wBACX,CAAC,CAAC,SAAS,CAAC;YACpB,KAAK,IAAI,UAAU,GAAG,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE,UAAU,EAAE,EAAE,CAAC;gBAC/D,UAAU,GAAG,aAAa,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC,UAAU,CAAC;YACvF,CAAC;YACD,MAAM;QACR,CAAC;IACH,CAAC;IACD,OAAO,EAAC,UAAU,EAAE,MAAM,EAAC,CAAC;AAC9B,CAAC;AAED,SAAS,uBAAuB,CAC9B,IAAc,EACd,UAAkB,EAClB,UAAkB,EAClB,MAAiB,EACjB,KAAqB,EACrB,KAAa;IAEb,KAAK,IAAI,UAAU,GAAG,CAAC,EAAE,UAAU,GAAG,UAAU,EAAE,UAAU,EAAE,EAAE,CAAC;QAC/D,UAAU,GAAG,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,SAAS,eAAe,CACtB,IAAc,EACd,UAAkB,EAClB,MAAiB,EACjB,OAAmB,EACnB,KAAa;IAEb,MAAM,oBAAoB,GAAG,yBAAyB,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC7E,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,oBAAoB,CAAC,CAAC;IACxD,IAAI,CAAC,OAAO,CAAC,UAAU;QAAE,OAAO,UAAU,GAAG,oBAAoB,CAAC;IAClE,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IAC3D,MAAM,CAAC,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,GAAG,CAAC,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IAC/D,MAAM,KAAK,GACT,MAAM,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,GAAG,EAAE,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC;IAChG,MAAM,MAAM,GACV,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,GAAG,EAAE,EAAE,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClG,MAAM,CAAC,GAAG,MAAM,CAAC,SAAS,KAAK,KAAK,IAAI,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACxF,MAAM,CAAC,GAAG,MAAM,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IACtD,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,SAAS,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;IACtE,OAAO,UAAU,GAAG,oBAAoB,CAAC;AAC3C,CAAC;AAED,SAAS,oBAAoB,CAAC,IAAc,EAAE,UAAkB;IAC9D,MAAM,eAAe,GAAG,UAAU,CAAC;IACnC,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;IAC9C,IAAI,SAAS,KAAK,CAAC,IAAI,SAAS,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAClF,MAAM,YAAY,GAAG,SAAS,KAAK,CAAC,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAC1D,UAAU,IAAI,CAAC,CAAC;IAEhB,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,UAAU,CAAC,CAAC;IAC/C,IAAI,YAAY,GAAG,QAAQ,GAAG,UAAU,CAAC;IACzC,IAAI,SAA6B,CAAC;IAClC,IAAI,YAAY,IAAI,IAAI,IAAI,YAAY,GAAG,IAAI,EAAE,CAAC;QAChD,SAAS,GAAG,MAAM,CAAC;QACnB,YAAY,IAAI,IAAI,CAAC;IACvB,CAAC;SAAM,IAAI,YAAY,IAAI,IAAI,IAAI,YAAY,GAAG,IAAI,EAAE,CAAC;QACvD,SAAS,GAAG,KAAK,CAAC;QAClB,YAAY,IAAI,IAAI,CAAC;IACvB,CAAC;SAAM,IAAI,YAAY,IAAI,IAAI,IAAI,YAAY,GAAG,IAAI,EAAE,CAAC;QACvD,SAAS,GAAG,KAAK,CAAC;QAClB,YAAY,IAAI,IAAI,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,SAAS,GAAG,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IACzE,CAAC;IACD,MAAM,YAAY,GAAG,cAAc,CAAC,YAAY,GAAG,CAAC,CAAC,CAAC;IACtD,IAAI,CAAC,YAAY;QAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,YAAY,EAAE,CAAC,CAAC;IAEpF,IAAI,IAAwB,CAAC;IAC7B,IAAI,OAAO,EAAE,CAAC;QACZ,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;QACrC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QAChD,UAAU,IAAI,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GACX,IAAI,IAAI,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,OAAO;QACL,YAAY;QACZ,SAAS;QACT,OAAO;QACP,YAAY;QACZ,UAAU,EAAE,eAAe;QAC3B,cAAc,EAAE,UAAU;QAC1B,UAAU,EAAE,UAAU,GAAG,eAAe;QACxC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAC,IAAI,EAAC,CAAC;KACtC,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAChB,IAAc,EACd,UAAkB,EAClB,YAAqB,EACrB,KAAqB;IAErB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IACvD,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC;IAC5B,IAAI,KAAK,CAAC,YAAY,GAAG,KAAK,CAAC,eAAe,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,YAAY,CAAC,MAAqB,EAAE,IAA2B,EAAE,KAAa;IACrF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO;IACpC,MAAM,OAAO,GAAG,GAAG,IAAI,KAA4B,CAAC;IACpD,MAAM,OAAO,GAAG,GAAG,IAAI,KAA4B,CAAC;IACpD,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAE,EAAE,KAAK,CAAC,CAAC;IAC5F,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAE,EAAE,KAAK,CAAC,CAAC;AAC9F,CAAC;AAED,SAAS,UAAU,CAAC,MAAqB;IACvC,IACE,MAAM,CAAC,IAAI,KAAK,SAAS;QACzB,MAAM,CAAC,IAAI,KAAK,SAAS;QACzB,MAAM,CAAC,IAAI,KAAK,SAAS;QACzB,MAAM,CAAC,IAAI,KAAK,SAAS,EACzB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,MAAmB,CAAC;AAC7B,CAAC;AAED,SAAS,WAAW,CAAC,KAAwC;IAC3D,OAAO,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;QAC9B,CAAC,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC;QAChE,CAAC,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,eAAe,CAAC,IAAc,EAAE,UAAkB,EAAE,UAAkB;IAC7E,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,UAAU,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAyB,EAAE,QAAgB,EAAE,IAAY;IAC9E,MAAM,KAAK,GAAG,KAAK,IAAI,QAAQ,CAAC;IAChC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,sCAAsC,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/wkb/wkb.d.ts

@@ -0,0 +1,21 @@
+import type { WellKnownDimension, WellKnownGeometry } from "./types.js";
+/** Defensive limits applied before WKB allocates geometry arrays. */
+export type WKBParseOptions = Readonly<{
+    /** Maximum recursive geometry nesting. Defaults to 64. */
+    maximumDepth?: number;
+    /** Maximum total declared child elements. Defaults to 100 million. */
+    maximumElements?: number;
+}>;
+/** One completely parsed WKB value and metadata declared by its root header. */
+export type WKBParseResult = Readonly<{
+    geometry: WellKnownGeometry;
+    byteLength: number;
+    dimension: WellKnownDimension;
+    /** EWKB SRID when the root header carries one. */
+    srid?: number;
+}>;
+/** Parses exactly one little- or big-endian ISO WKB or EWKB geometry. */
+export declare function parseWKB(bytes: Uint8Array, options?: WKBParseOptions): WKBParseResult;
+/** Writes one geometry as little-endian ISO WKB. */
+export declare function writeWKB(geometry: WellKnownGeometry, dimension?: WellKnownDimension): Uint8Array;
+//# sourceMappingURL=wkb.d.ts.map

package/dist/wkb/wkb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wkb.d.ts","sourceRoot":"","sources":["../../src/wkb/wkb.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,kBAAkB,EAAE,iBAAiB,EAAC,mBAAgB;AAInE,qEAAqE;AACrE,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,0DAA0D;IAC1D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC,CAAC;AAEH,gFAAgF;AAChF,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAeH,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,GAAE,eAAoB,GAAG,cAAc,CAezF;AAED,oDAAoD;AACpD,wBAAgB,QAAQ,CACtB,QAAQ,EAAE,iBAAiB,EAC3B,SAAS,GAAE,kBAA8D,GACxE,UAAU,CAIZ"}

package/dist/wkb/wkb.js

@@ -0,0 +1,204 @@
+// math.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import { getWellKnownDimensionSize, inferWellKnownGeometryDimension } from "./types.js";
+import { inspectWKBHeader } from "./wkb-reader.js";
+/** Parses exactly one little- or big-endian ISO WKB or EWKB geometry. */
+export function parseWKB(bytes, options = {}) {
+    const state = {
+        maximumDepth: validateLimit(options.maximumDepth, 64, 'maximumDepth'),
+        maximumElements: validateLimit(options.maximumElements, 100000000, 'maximumElements'),
+        elementCount: 0
+    };
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const result = readWKBGeometry(view, 0, state, 0);
+    if (result.offset !== bytes.byteLength)
+        throw new Error('WKB contains trailing bytes');
+    return {
+        geometry: result.geometry,
+        byteLength: result.offset,
+        dimension: result.dimension,
+        ...(result.srid === undefined ? {} : { srid: result.srid })
+    };
+}
+/** Writes one geometry as little-endian ISO WKB. */
+export function writeWKB(geometry, dimension = inferWellKnownGeometryDimension(geometry)) {
+    const bytes = [];
+    writeWKBGeometry(bytes, geometry, dimension);
+    return Uint8Array.from(bytes);
+}
+function readWKBGeometry(view, startOffset, state, depth) {
+    if (depth > state.maximumDepth)
+        throw new Error('WKB geometry nesting exceeds maximumDepth');
+    const header = inspectWKBHeader(view, startOffset);
+    let offset = header.bodyByteOffset;
+    const { dimension, geometryType, littleEndian, srid } = header;
+    const dimensions = getWellKnownDimensionSize(dimension);
+    const readCoordinate = () => {
+        assertRemaining(view, offset, dimensions * 8);
+        const coordinate = new Array(dimensions);
+        for (let index = 0; index < dimensions; index++) {
+            coordinate[index] = view.getFloat64(offset, littleEndian);
+            offset += 8;
+        }
+        return coordinate;
+    };
+    const readCount = () => {
+        assertRemaining(view, offset, 4);
+        const count = view.getUint32(offset, littleEndian);
+        offset += 4;
+        state.elementCount += count;
+        if (state.elementCount > state.maximumElements) {
+            throw new Error('WKB element count exceeds maximumElements');
+        }
+        return count;
+    };
+    const readCoordinates = () => {
+        const count = readCount();
+        return Array.from({ length: count }, readCoordinate);
+    };
+    let geometry;
+    switch (geometryType) {
+        case 'Point':
+            geometry = { type: 'Point', coordinates: readCoordinate() };
+            break;
+        case 'LineString':
+            geometry = { type: 'LineString', coordinates: readCoordinates() };
+            break;
+        case 'Polygon':
+            geometry = { type: 'Polygon', coordinates: Array.from({ length: readCount() }, readCoordinates) };
+            break;
+        case 'MultiPoint':
+        case 'MultiLineString':
+        case 'MultiPolygon':
+        case 'GeometryCollection': {
+            const children = [];
+            for (let index = 0, count = readCount(); index < count; index++) {
+                const child = readWKBGeometry(view, offset, state, depth + 1);
+                children.push(child.geometry);
+                offset = child.offset;
+            }
+            if (geometryType === 'MultiPoint') {
+                geometry = {
+                    type: 'MultiPoint',
+                    coordinates: children.map(assertPoint).map(point => point.coordinates)
+                };
+            }
+            else if (geometryType === 'MultiLineString') {
+                geometry = {
+                    type: 'MultiLineString',
+                    coordinates: children.map(assertLineString).map(line => line.coordinates)
+                };
+            }
+            else if (geometryType === 'MultiPolygon') {
+                geometry = {
+                    type: 'MultiPolygon',
+                    coordinates: children.map(assertPolygon).map(polygon => polygon.coordinates)
+                };
+            }
+            else {
+                geometry = { type: 'GeometryCollection', geometries: children };
+            }
+            break;
+        }
+    }
+    return { geometry, offset, dimension, ...(srid === undefined ? {} : { srid }) };
+}
+function writeWKBGeometry(bytes, geometry, dimension) {
+    bytes.push(1);
+    const size = getWellKnownDimensionSize(dimension);
+    const dimensionOffset = dimension === 'xyz' ? 1000 : dimension === 'xym' ? 2000 : dimension === 'xyzm' ? 3000 : 0;
+    writeUint32(bytes, getWKBType(geometry.type) + dimensionOffset);
+    const writeCoordinate = (coordinate) => {
+        for (let index = 0; index < size; index++)
+            writeFloat64(bytes, coordinate[index] ?? 0);
+    };
+    const writeCoordinates = (coordinates) => {
+        writeUint32(bytes, coordinates.length);
+        for (const coordinate of coordinates)
+            writeCoordinate(coordinate);
+    };
+    switch (geometry.type) {
+        case 'Point':
+            writeCoordinate(geometry.coordinates.length === 0 ? new Array(size).fill(Number.NaN) : geometry.coordinates);
+            break;
+        case 'LineString':
+            writeCoordinates(geometry.coordinates);
+            break;
+        case 'Polygon':
+            writeUint32(bytes, geometry.coordinates.length);
+            for (const ring of geometry.coordinates)
+                writeCoordinates(ring);
+            break;
+        case 'MultiPoint':
+            writeUint32(bytes, geometry.coordinates.length);
+            for (const coordinate of geometry.coordinates) {
+                writeWKBGeometry(bytes, { type: 'Point', coordinates: coordinate }, dimension);
+            }
+            break;
+        case 'MultiLineString':
+            writeUint32(bytes, geometry.coordinates.length);
+            for (const coordinates of geometry.coordinates) {
+                writeWKBGeometry(bytes, { type: 'LineString', coordinates }, dimension);
+            }
+            break;
+        case 'MultiPolygon':
+            writeUint32(bytes, geometry.coordinates.length);
+            for (const coordinates of geometry.coordinates) {
+                writeWKBGeometry(bytes, { type: 'Polygon', coordinates }, dimension);
+            }
+            break;
+        case 'GeometryCollection':
+            writeUint32(bytes, geometry.geometries.length);
+            for (const child of geometry.geometries)
+                writeWKBGeometry(bytes, child, dimension);
+            break;
+    }
+}
+function getWKBType(type) {
+    return ([
+        'Point',
+        'LineString',
+        'Polygon',
+        'MultiPoint',
+        'MultiLineString',
+        'MultiPolygon',
+        'GeometryCollection'
+    ].indexOf(type) + 1);
+}
+function writeUint32(bytes, value) {
+    bytes.push(value & 255, (value >>> 8) & 255, (value >>> 16) & 255, (value >>> 24) & 255);
+}
+function writeFloat64(bytes, value) {
+    const buffer = new ArrayBuffer(8);
+    new DataView(buffer).setFloat64(0, value, true);
+    bytes.push(...new Uint8Array(buffer));
+}
+function assertRemaining(view, offset, length) {
+    if (offset + length > view.byteLength)
+        throw new Error('Unexpected end of WKB');
+}
+function assertPoint(value) {
+    if (value.type !== 'Point')
+        throw new Error('WKB MultiPoint contains a non-Point child');
+    return value;
+}
+function assertLineString(value) {
+    if (value.type !== 'LineString') {
+        throw new Error('WKB MultiLineString contains a non-LineString child');
+    }
+    return value;
+}
+function assertPolygon(value) {
+    if (value.type !== 'Polygon')
+        throw new Error('WKB MultiPolygon contains a non-Polygon child');
+    return value;
+}
+function validateLimit(value, fallback, name) {
+    const limit = value ?? fallback;
+    if (!Number.isSafeInteger(limit) || limit < 0) {
+        throw new Error(`${name} must be a non-negative safe integer`);
+    }
+    return limit;
+}
+//# sourceMappingURL=wkb.js.map

package/dist/wkb/wkb.js.map

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

package/dist/wkb/wkt.d.ts

@@ -0,0 +1,19 @@
+import type { WellKnownDimension, WellKnownGeometry } from "./types.js";
+/** Options for parsing WKT text. */
+export type WKTParseOptions = Readonly<{
+    /** Infer unmarked coordinate dimensions for legacy WKT such as POINT (1 2 3). */
+    inferDimensions?: boolean;
+}>;
+/** One parsed WKT geometry and its semantic dimension, including collection children. */
+export type WKTParseResult = Readonly<{
+    geometry: WellKnownGeometry;
+    dimension: WellKnownDimension;
+    children?: readonly WKTParseResult[];
+}>;
+/** Parses one WKT geometry, including Z/M/ZM, collections, alternate MultiPoint, and empties. */
+export declare function parseWKT(text: string, options?: WKTParseOptions): WellKnownGeometry;
+/** Parses WKT while preserving each geometry's declared or inferred semantic dimension. */
+export declare function parseWKTWithMetadata(text: string, options?: WKTParseOptions): WKTParseResult;
+/** Formats one geometry as WKT using an explicit or tuple-inferred semantic dimension. */
+export declare function formatWKT(geometry: WellKnownGeometry | WKTParseResult, dimension?: WellKnownDimension): string;
+//# sourceMappingURL=wkt.d.ts.map

package/dist/wkb/wkt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wkt.d.ts","sourceRoot":"","sources":["../../src/wkb/wkt.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,kBAAkB,EAAE,iBAAiB,EAAC,mBAAgB;AAGnE,oCAAoC;AACpC,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,iFAAiF;IACjF,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC,CAAC;AAEH,yFAAyF;AACzF,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,kBAAkB,CAAC;IAC9B,QAAQ,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CACtC,CAAC,CAAC;AAEH,iGAAiG;AACjG,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,iBAAiB,CAKnF;AAED,2FAA2F;AAC3F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,cAAc,CAKhG;AAED,0FAA0F;AAC1F,wBAAgB,SAAS,CACvB,QAAQ,EAAE,iBAAiB,GAAG,cAAc,EAC5C,SAAS,CAAC,EAAE,kBAAkB,GAC7B,MAAM,CAOR"}