@loaders.gl/gis 4.3.4 → 4.4.0-alpha.10

package/dist/lib/geometry-converters/wkb/helpers/parse-wkb-header.js

@@ -0,0 +1,175 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { EWKB_FLAG_Z, EWKB_FLAG_M, EWKB_FLAG_SRID, MAX_SRID, WKT_MAGIC_STRINGS, WKT_MAGIC_BYTES } from "./wkb-types.js";
+/**
+ * Check if a string is WKT.
+ * @param input A potential WKT geometry string
+ * @return `true` if input appears to be a WKT geometry string, `false` otherwise
+
+ * @note We only support the "geojson" subset of the OGC simple features standard
+ * @todo Does not handle leading spaces which appear to be permitted per the spec:
+ * "A WKT string contains no white space outside of double quotes.
+ * However padding with white space to improve human readability is permitted;
+ * the examples of WKT that are included in this document have
+ * spaces and line feeds inserted to improve clarity. Any padding is stripped out or ignored by parsers."
+ */
+export function isWKT(input) {
+    return getWKTGeometryType(input) !== null;
+}
+/**
+ * Get the geometry type of a WKT string.
+ * @param input A potential WKT geometry string
+ * @return `true` if input appears to be a WKT geometry string, `false` otherwise
+
+ * @note We only support the "geojson" subset of the OGC simple features standard
+ * @todo Does not handle leading spaces which appear to be permitted per the spec:
+ * "A WKT string contains no white space outside of double quotes.
+ * However padding with white space to improve human readability is permitted;
+ * the examples of WKT that are included in this document have
+ * spaces and line feeds inserted to improve clarity. Any padding is stripped out or ignored by parsers."
+ */
+export function getWKTGeometryType(input) {
+    if (typeof input === 'string') {
+        const index = WKT_MAGIC_STRINGS.findIndex((magicString) => input.startsWith(magicString));
+        return index >= 0 ? (index + 1) : null;
+    }
+    const inputArray = new Uint8Array(input);
+    const index = WKT_MAGIC_BYTES.findIndex((magicBytes) => magicBytes.every((value, index) => value === inputArray[index]));
+    return index >= 0 ? (index + 1) : null;
+}
+/**
+ * Check if an array buffer might be a TWKB array buffer
+ * @param arrayBuffer The array buffer to check
+ * @returns false if this is definitely not a TWKB array buffer, true if it might be a TWKB array buffer
+ */
+export function isTWKB(arrayBuffer) {
+    const dataView = new DataView(arrayBuffer);
+    const byteOffset = 0;
+    const type = dataView.getUint8(byteOffset);
+    const geometryType = type & 0x0f;
+    // Only geometry types 1 to 7 (point to geometry collection are currently defined)
+    if (geometryType < 1 || geometryType > 7) {
+        return false;
+    }
+    return true;
+}
+/** Sanity checks that first to 5-9 bytes could represent a supported WKB dialect header */
+export function isWKB(arrayBuffer) {
+    const dataView = new DataView(arrayBuffer);
+    let byteOffset = 0;
+    const endianness = dataView.getUint8(byteOffset);
+    byteOffset += 1;
+    // Check valid endianness (only 0 or 1 are allowed)
+    if (endianness > 1) {
+        return false;
+    }
+    const littleEndian = endianness === 1;
+    const geometry = dataView.getUint32(byteOffset, littleEndian);
+    byteOffset += 4;
+    // check valid geometry type (we don't support extension geometries)
+    const geometryType = geometry & 0x07;
+    if (geometryType === 0 || geometryType > 7) {
+        return false;
+    }
+    const geometryFlags = geometry - geometryType;
+    // Accept iso-wkb flags
+    if (geometryFlags === 0 ||
+        geometryFlags === 1000 ||
+        geometryFlags === 2000 ||
+        geometryFlags === 3000) {
+        return true;
+    }
+    // Accept ewkb flags but reject otherwise
+    if ((geometryFlags & ~(EWKB_FLAG_Z | EWKB_FLAG_M | EWKB_FLAG_SRID)) !== 0) {
+        return false;
+    }
+    if (geometryFlags & EWKB_FLAG_SRID) {
+        const srid = dataView.getUint32(byteOffset, littleEndian);
+        byteOffset += 4;
+        if (srid > MAX_SRID) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Parses header and provides a byteOffset to start of geometry data
+ * @param dataView
+ * @param target optionally supply a WKBHeader object to avoid creating a new object for every call
+ * @returns a header object describing the WKB data
+ */
+// eslint-disable-next-line max-statements, complexity
+export function parseWKBHeader(dataView, target) {
+    const wkbHeader = Object.assign(target || {}, {
+        type: 'wkb',
+        variant: 'wkb',
+        geometryType: 1,
+        dimensions: 2,
+        coordinates: 'xy',
+        littleEndian: true,
+        byteOffset: 0
+    });
+    if (isWKT(dataView.buffer)) {
+        // TODO - WKB header could include WKT type
+        throw new Error('WKB: Cannot parse WKT data');
+    }
+    // Check endianness of data
+    wkbHeader.littleEndian = dataView.getUint8(wkbHeader.byteOffset) === 1;
+    wkbHeader.byteOffset++;
+    // 4-digit code representing dimension and type of geometry
+    const geometryCode = dataView.getUint32(wkbHeader.byteOffset, wkbHeader.littleEndian);
+    wkbHeader.byteOffset += 4;
+    wkbHeader.geometryType = (geometryCode & 0x7);
+    // Check if iso-wkb variant: iso-wkb adds 1000, 2000 or 3000 to the geometry code
+    const isoType = (geometryCode - wkbHeader.geometryType) / 1000;
+    switch (isoType) {
+        case 0:
+            break;
+        case 1:
+            wkbHeader.variant = 'iso-wkb';
+            wkbHeader.dimensions = 3;
+            wkbHeader.coordinates = 'xyz';
+            break;
+        case 2:
+            wkbHeader.variant = 'iso-wkb';
+            wkbHeader.dimensions = 3;
+            wkbHeader.coordinates = 'xym';
+            break;
+        case 3:
+            wkbHeader.variant = 'iso-wkb';
+            wkbHeader.dimensions = 4;
+            wkbHeader.coordinates = 'xyzm';
+            break;
+        default:
+            throw new Error(`WKB: Unsupported iso-wkb type: ${isoType}`);
+    }
+    // Check if EWKB variant. Uses bitmasks for Z&M dimensions as well as optional SRID field
+    const ewkbZ = geometryCode & EWKB_FLAG_Z;
+    const ewkbM = geometryCode & EWKB_FLAG_M;
+    const ewkbSRID = geometryCode & EWKB_FLAG_SRID;
+    if (ewkbZ && ewkbM) {
+        wkbHeader.variant = 'ewkb';
+        wkbHeader.dimensions = 4;
+        wkbHeader.coordinates = 'xyzm';
+    }
+    else if (ewkbZ) {
+        wkbHeader.variant = 'ewkb';
+        wkbHeader.dimensions = 3;
+        wkbHeader.coordinates = 'xyz';
+    }
+    else if (ewkbM) {
+        wkbHeader.variant = 'ewkb';
+        wkbHeader.dimensions = 3;
+        wkbHeader.coordinates = 'xym';
+    }
+    // If SRID present read four more bytes
+    if (ewkbSRID) {
+        wkbHeader.variant = 'ewkb';
+        // 4-digit code representing dimension and type of geometry
+        wkbHeader.srid = dataView.getUint32(wkbHeader.byteOffset, wkbHeader.littleEndian);
+        wkbHeader.byteOffset += 4;
+    }
+    return wkbHeader;
+}
+//# sourceMappingURL=parse-wkb-header.js.map

package/dist/lib/geometry-converters/wkb/helpers/parse-wkb-header.js.map

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

package/dist/lib/geometry-converters/wkb/helpers/wkb-types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Integer codes for geometry types in WKB and related formats
+ * @see: https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry#Well-known_binary
+ */
+export declare enum WKBGeometryType {
+    Point = 1,
+    LineString = 2,
+    Polygon = 3,
+    MultiPoint = 4,
+    MultiLineString = 5,
+    MultiPolygon = 6,
+    GeometryCollection = 7
+}
+/** Parsed WKB header */
+export type WKBHeader = {
+    /** WKB or TWKB */
+    type: 'wkb' | 'twkb';
+    /** WKB variant */
+    variant: 'wkb' | 'ewkb' | 'iso-wkb' | 'twkb';
+    /** geometry type encoded in this WKB: point, line, polygon etc */
+    geometryType: 1 | 2 | 3 | 4 | 5 | 6 | 7;
+    /** Number of dimensions for coordinate data */
+    dimensions: 2 | 3 | 4;
+    /** Coordinate names, Z and M are controlled by flags */
+    coordinates: 'xy' | 'xyz' | 'xym' | 'xyzm';
+    /** WKB Geometry has a spatial coordinate reference system id */
+    srid?: number;
+    /** true if binary data is stored as little endian */
+    littleEndian: boolean;
+    /** Offset to start of geometry */
+    byteOffset: number;
+};
+/**
+ * Options for writing WKB
+ */
+export type WKBOptions = {
+    /** Does the GeoJSON input have Z values? */
+    hasZ?: boolean;
+    /** Does the GeoJSON input have M values? */
+    hasM?: boolean;
+    /** Spatial reference for input GeoJSON */
+    srid?: any;
+};
+/** WKB Geometry has a z coordinate */
+export declare const EWKB_FLAG_Z = 2147483648;
+/** WKB Geometry has an m coordinate */
+export declare const EWKB_FLAG_M = 1073741824;
+/** WKB Geometry has a spatial coordinate reference system id */
+export declare const EWKB_FLAG_SRID = 536870912;
+/** @todo: Assume no more than 10K SRIDs are defined */
+export declare const MAX_SRID = 10000;
+/**
+ * @see: https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry#Well-known_binary
+ * @note Order matches WKBGeometryType enum (need to add 1)
+ * @note: We only support this "geojson" subset of the OGC simple features standard
+ */
+export declare const WKT_MAGIC_STRINGS: string[];
+/**
+ * @see: https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry#Well-known_binary
+ * @note Order matches WKBGeometryType enum (need to add 1)
+ * @note: We only support this "geojson" subset of the OGC simple features standard
+ */
+export declare const WKT_MAGIC_BYTES: Uint8Array[];
+//# sourceMappingURL=wkb-types.d.ts.map

package/dist/lib/geometry-converters/wkb/helpers/wkb-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wkb-types.d.ts","sourceRoot":"","sources":["../../../../../src/lib/geometry-converters/wkb/helpers/wkb-types.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,oBAAY,eAAe;IACzB,KAAK,IAAI;IACT,UAAU,IAAI;IACd,OAAO,IAAI;IACX,UAAU,IAAI;IACd,eAAe,IAAI;IACnB,YAAY,IAAI;IAChB,kBAAkB,IAAI;CACvB;AAED,wBAAwB;AACxB,MAAM,MAAM,SAAS,GAAG;IACtB,kBAAkB;IAClB,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,kBAAkB;IAClB,OAAO,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IAC7C,kEAAkE;IAClE,YAAY,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACxC,+CAA+C;IAC/C,UAAU,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACtB,wDAAwD;IACxD,WAAW,EAAE,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC3C,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,YAAY,EAAE,OAAO,CAAC;IACtB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,4CAA4C;IAC5C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0CAA0C;IAC1C,IAAI,CAAC,EAAE,GAAG,CAAC;CACZ,CAAC;AAEF,sCAAsC;AACtC,eAAO,MAAM,WAAW,aAAa,CAAC;AACtC,uCAAuC;AACvC,eAAO,MAAM,WAAW,aAAa,CAAC;AACtC,gEAAgE;AAChE,eAAO,MAAM,cAAc,YAAa,CAAC;AACzC,uDAAuD;AACvD,eAAO,MAAM,QAAQ,QAAQ,CAAC;AAE9B;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,UAQ7B,CAAC;AAIF;;;;GAIG;AACH,eAAO,MAAM,eAAe,cAAgE,CAAC"}

package/dist/lib/geometry-converters/wkb/helpers/wkb-types.js

@@ -0,0 +1,47 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ * Integer codes for geometry types in WKB and related formats
+ * @see: https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry#Well-known_binary
+ */
+export var WKBGeometryType;
+(function (WKBGeometryType) {
+    WKBGeometryType[WKBGeometryType["Point"] = 1] = "Point";
+    WKBGeometryType[WKBGeometryType["LineString"] = 2] = "LineString";
+    WKBGeometryType[WKBGeometryType["Polygon"] = 3] = "Polygon";
+    WKBGeometryType[WKBGeometryType["MultiPoint"] = 4] = "MultiPoint";
+    WKBGeometryType[WKBGeometryType["MultiLineString"] = 5] = "MultiLineString";
+    WKBGeometryType[WKBGeometryType["MultiPolygon"] = 6] = "MultiPolygon";
+    WKBGeometryType[WKBGeometryType["GeometryCollection"] = 7] = "GeometryCollection";
+})(WKBGeometryType || (WKBGeometryType = {}));
+/** WKB Geometry has a z coordinate */
+export const EWKB_FLAG_Z = 0x80000000;
+/** WKB Geometry has an m coordinate */
+export const EWKB_FLAG_M = 0x40000000;
+/** WKB Geometry has a spatial coordinate reference system id */
+export const EWKB_FLAG_SRID = 0x20000000;
+/** @todo: Assume no more than 10K SRIDs are defined */
+export const MAX_SRID = 10000;
+/**
+ * @see: https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry#Well-known_binary
+ * @note Order matches WKBGeometryType enum (need to add 1)
+ * @note: We only support this "geojson" subset of the OGC simple features standard
+ */
+export const WKT_MAGIC_STRINGS = [
+    'POINT(',
+    'LINESTRING(',
+    'POLYGON(',
+    'MULTIPOINT(',
+    'MULTILINESTRING(',
+    'MULTIPOLYGON(',
+    'GEOMETRYCOLLECTION('
+];
+const textEncoder = new TextEncoder();
+/**
+ * @see: https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry#Well-known_binary
+ * @note Order matches WKBGeometryType enum (need to add 1)
+ * @note: We only support this "geojson" subset of the OGC simple features standard
+ */
+export const WKT_MAGIC_BYTES = WKT_MAGIC_STRINGS.map((string) => textEncoder.encode(string));
+//# sourceMappingURL=wkb-types.js.map

package/dist/lib/geometry-converters/wkb/helpers/wkb-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wkb-types.js","sourceRoot":"","sources":["../../../../../src/lib/geometry-converters/wkb/helpers/wkb-types.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAEpC;;;GAGG;AACH,MAAM,CAAN,IAAY,eAQX;AARD,WAAY,eAAe;IACzB,uDAAS,CAAA;IACT,iEAAc,CAAA;IACd,2DAAW,CAAA;IACX,iEAAc,CAAA;IACd,2EAAmB,CAAA;IACnB,qEAAgB,CAAA;IAChB,iFAAsB,CAAA;AACxB,CAAC,EARW,eAAe,KAAf,eAAe,QAQ1B;AAkCD,sCAAsC;AACtC,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AACtC,uCAAuC;AACvC,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AACtC,gEAAgE;AAChE,MAAM,CAAC,MAAM,cAAc,GAAG,UAAU,CAAC;AACzC,uDAAuD;AACvD,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,CAAC;AAE9B;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ;IACR,aAAa;IACb,UAAU;IACV,aAAa;IACb,kBAAkB;IAClB,eAAe;IACf,qBAAqB;CACtB,CAAC;AAEF,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;AAEtC;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC"}

package/dist/lib/geometry-converters/wkb/helpers/wkb-utils.d.ts

@@ -0,0 +1,21 @@
+import type { WKBOptions } from "./wkb-types.js";
+import { WKBGeometryType } from "./wkb-types.js";
+declare const WKBGeometryTypeNames: {
+    readonly Point: WKBGeometryType.Point;
+    readonly LineString: WKBGeometryType.LineString;
+    readonly Polygon: WKBGeometryType.Polygon;
+    readonly MultiPoint: WKBGeometryType.MultiPoint;
+    readonly MultiLineString: WKBGeometryType.MultiLineString;
+    readonly MultiPolygon: WKBGeometryType.MultiPolygon;
+    readonly GeometryCollection: WKBGeometryType.GeometryCollection;
+};
+/** Convert a WKB geometry type integer to GeoJSON style geometry type string*/
+export declare function getGeometryTypeFromWKBType(wkbGeometryType: WKBGeometryType): keyof typeof WKBGeometryTypeNames;
+/** Convert a GeoJSON style geometry type string to a WKB geometry type integer*/
+export declare function getWKBTypeFromGeometryType(geometryType: keyof typeof WKBGeometryTypeNames): WKBGeometryType;
+/** Sanity: Adjust Z/M dimensions with actual point size */
+export declare function matchWKBOptionsToPointSize(pointSize: number, options?: WKBOptions): Required<WKBOptions>;
+/** Get coordinate size given Z/M dimensions */
+export declare function getCoordinateByteSize(options?: WKBOptions): number;
+export {};
+//# sourceMappingURL=wkb-utils.d.ts.map

package/dist/lib/geometry-converters/wkb/helpers/wkb-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wkb-utils.d.ts","sourceRoot":"","sources":["../../../../../src/lib/geometry-converters/wkb/helpers/wkb-utils.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,UAAU,EAAC,uBAAoB;AAC5C,OAAO,EAAC,eAAe,EAAC,uBAAoB;AAE5C,QAAA,MAAM,oBAAoB;;;;;;;;CAQ0B,CAAC;AAErD,+EAA+E;AAC/E,wBAAgB,0BAA0B,CACxC,eAAe,EAAE,eAAe,GAC/B,MAAM,OAAO,oBAAoB,CAOnC;AAED,iFAAiF;AACjF,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,MAAM,OAAO,oBAAoB,GAC9C,eAAe,CAEjB;AAED,2DAA2D;AAC3D,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,UAAU,GACnB,QAAQ,CAAC,UAAU,CAAC,CA8BtB;AAED,+CAA+C;AAC/C,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,MAAM,CAWlE"}

package/dist/lib/geometry-converters/wkb/helpers/wkb-utils.js

@@ -0,0 +1,65 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { WKBGeometryType } from "./wkb-types.js";
+const WKBGeometryTypeNames = {
+    Point: WKBGeometryType.Point,
+    LineString: WKBGeometryType.LineString,
+    Polygon: WKBGeometryType.Polygon,
+    MultiPoint: WKBGeometryType.MultiPoint,
+    MultiLineString: WKBGeometryType.MultiLineString,
+    MultiPolygon: WKBGeometryType.MultiPolygon,
+    GeometryCollection: WKBGeometryType.GeometryCollection
+};
+/** Convert a WKB geometry type integer to GeoJSON style geometry type string*/
+export function getGeometryTypeFromWKBType(wkbGeometryType) {
+    for (const key in WKBGeometryTypeNames) {
+        if (WKBGeometryTypeNames[key] === wkbGeometryType) {
+            return key;
+        }
+    }
+    throw new Error(String(wkbGeometryType));
+}
+/** Convert a GeoJSON style geometry type string to a WKB geometry type integer*/
+export function getWKBTypeFromGeometryType(geometryType) {
+    return WKBGeometryTypeNames[geometryType];
+}
+/** Sanity: Adjust Z/M dimensions with actual point size */
+export function matchWKBOptionsToPointSize(pointSize, options) {
+    const wkbOptions = { hasZ: false, hasM: false, srid: undefined, ...options };
+    // Align options with actual point size
+    switch (pointSize) {
+        case 4:
+            wkbOptions.hasZ = true;
+            wkbOptions.hasM = true;
+            break;
+        case 3:
+            // Prefer Z over M
+            if (wkbOptions.hasZ && wkbOptions.hasM) {
+                wkbOptions.hasM = false;
+            }
+            if (!wkbOptions.hasZ && !wkbOptions.hasM) {
+                wkbOptions.hasZ = true;
+            }
+            break;
+        case 2:
+            wkbOptions.hasZ = false;
+            wkbOptions.hasM = false;
+            break;
+        default:
+        // ignore - broken input data?
+    }
+    return wkbOptions;
+}
+/** Get coordinate size given Z/M dimensions */
+export function getCoordinateByteSize(options) {
+    let coordinateByteSize = 16;
+    if (options?.hasZ) {
+        coordinateByteSize += 8;
+    }
+    if (options?.hasM) {
+        coordinateByteSize += 8;
+    }
+    return coordinateByteSize;
+}
+//# sourceMappingURL=wkb-utils.js.map

package/dist/lib/geometry-converters/wkb/helpers/wkb-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wkb-utils.js","sourceRoot":"","sources":["../../../../../src/lib/geometry-converters/wkb/helpers/wkb-utils.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAGpC,OAAO,EAAC,eAAe,EAAC,uBAAoB;AAE5C,MAAM,oBAAoB,GAAG;IAC3B,KAAK,EAAE,eAAe,CAAC,KAAK;IAC5B,UAAU,EAAE,eAAe,CAAC,UAAU;IACtC,OAAO,EAAE,eAAe,CAAC,OAAO;IAChC,UAAU,EAAE,eAAe,CAAC,UAAU;IACtC,eAAe,EAAE,eAAe,CAAC,eAAe;IAChD,YAAY,EAAE,eAAe,CAAC,YAAY;IAC1C,kBAAkB,EAAE,eAAe,CAAC,kBAAkB;CACJ,CAAC;AAErD,+EAA+E;AAC/E,MAAM,UAAU,0BAA0B,CACxC,eAAgC;IAEhC,KAAK,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;QACvC,IAAI,oBAAoB,CAAC,GAAG,CAAC,KAAK,eAAe,EAAE,CAAC;YAClD,OAAO,GAAwC,CAAC;QAClD,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,0BAA0B,CACxC,YAA+C;IAE/C,OAAO,oBAAoB,CAAC,YAAY,CAAC,CAAC;AAC5C,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,0BAA0B,CACxC,SAAiB,EACjB,OAAoB;IAEpB,MAAM,UAAU,GAAyB,EAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,OAAO,EAAC,CAAC;IAEjG,uCAAuC;IACvC,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,CAAC;YACJ,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC;YACvB,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC;YACvB,MAAM;QAER,KAAK,CAAC;YACJ,kBAAkB;YAClB,IAAI,UAAU,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;gBACvC,UAAU,CAAC,IAAI,GAAG,KAAK,CAAC;YAC1B,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;gBACzC,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC;YACzB,CAAC;YACD,MAAM;QAER,KAAK,CAAC;YACJ,UAAU,CAAC,IAAI,GAAG,KAAK,CAAC;YACxB,UAAU,CAAC,IAAI,GAAG,KAAK,CAAC;YACxB,MAAM;QAER,QAAQ;QACR,8BAA8B;IAChC,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,qBAAqB,CAAC,OAAoB;IACxD,IAAI,kBAAkB,GAAG,EAAE,CAAC;IAE5B,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;QAClB,kBAAkB,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;QAClB,kBAAkB,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO,kBAAkB,CAAC;AAC5B,CAAC"}

package/dist/lib/geometry-converters/wkb/helpers/write-wkb-header.d.ts

@@ -0,0 +1,8 @@
+import { BinaryWriter } from "../../../utils/binary-writer.js";
+import type { WKBOptions } from "./wkb-types.js";
+/**
+ * Construct and write WKB integer code
+ * Reference: https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry#Well-known_binary
+ */
+export declare function writeWkbHeader(writer: BinaryWriter, geometryType: number, options?: WKBOptions): void;
+//# sourceMappingURL=write-wkb-header.d.ts.map

package/dist/lib/geometry-converters/wkb/helpers/write-wkb-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-wkb-header.d.ts","sourceRoot":"","sources":["../../../../../src/lib/geometry-converters/wkb/helpers/write-wkb-header.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,YAAY,EAAC,wCAAqC;AAC1D,OAAO,KAAK,EAAC,UAAU,EAAC,uBAAoB;AAE5C;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EACpB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,UAAU,GACnB,IAAI,CAyBN"}

package/dist/lib/geometry-converters/wkb/helpers/write-wkb-header.js

@@ -0,0 +1,34 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ * Construct and write WKB integer code
+ * Reference: https://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry#Well-known_binary
+ */
+export function writeWkbHeader(writer, geometryType, options) {
+    // little endian
+    writer.writeInt8(1);
+    const { hasZ, hasM, srid } = options || {};
+    let dimensionType = 0;
+    if (!srid) {
+        if (hasZ && hasM) {
+            dimensionType += 3000;
+        }
+        else if (hasZ) {
+            dimensionType += 1000;
+        }
+        else if (hasM) {
+            dimensionType += 2000;
+        }
+    }
+    else {
+        if (hasZ) {
+            dimensionType |= 0x80000000;
+        }
+        if (hasM) {
+            dimensionType |= 0x40000000;
+        }
+    }
+    writer.writeUInt32LE((dimensionType + geometryType) >>> 0);
+}
+//# sourceMappingURL=write-wkb-header.js.map

package/dist/lib/geometry-converters/wkb/helpers/write-wkb-header.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-wkb-header.js","sourceRoot":"","sources":["../../../../../src/lib/geometry-converters/wkb/helpers/write-wkb-header.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAKpC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAoB,EACpB,YAAoB,EACpB,OAAoB;IAEpB,gBAAgB;IAChB,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IACpB,MAAM,EAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAC,GAAG,OAAO,IAAI,EAAE,CAAC;IAEzC,IAAI,aAAa,GAAG,CAAC,CAAC;IAEtB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;YACjB,aAAa,IAAI,IAAI,CAAC;QACxB,CAAC;aAAM,IAAI,IAAI,EAAE,CAAC;YAChB,aAAa,IAAI,IAAI,CAAC;QACxB,CAAC;aAAM,IAAI,IAAI,EAAE,CAAC;YAChB,aAAa,IAAI,IAAI,CAAC;QACxB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,IAAI,IAAI,EAAE,CAAC;YACT,aAAa,IAAI,UAAU,CAAC;QAC9B,CAAC;QACD,IAAI,IAAI,EAAE,CAAC;YACT,aAAa,IAAI,UAAU,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,MAAM,CAAC,aAAa,CAAC,CAAC,aAAa,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7D,CAAC"}

package/dist/lib/table-converters/convert-geoarrow-table.d.ts

@@ -0,0 +1,27 @@
+import * as arrow from 'apache-arrow';
+import type { Table, ArrayRowTable, ColumnarTable, ObjectRowTable, GeoJSONTable, ArrowTable } from '@loaders.gl/schema';
+/**
+ * * Convert a loaders.gl Table to an Apache Arrow Table
+ * @param mesh
+ * @param metadata
+ * @param batchSize
+ * @returns
+ */
+export declare function convertTableToArrow(table: Table, options?: {
+    batchSize?: number;
+}): arrow.Table;
+export declare function makeTableToArrowBatchesIterator(table: Table, options?: {
+    batchSize?: number;
+}): IterableIterator<arrow.RecordBatch>;
+/**
+ * Convert an Apache Arrow table to a loaders.gl Table
+ * @note Currently does not convert schema
+ */
+export declare function convertGeoArrowToTable(arrow: arrow.Table, shape: 'arrow-table'): ArrowTable;
+export declare function convertGeoArrowToTable(arrow: arrow.Table, shape: 'columnar-table'): ColumnarTable;
+export declare function convertGeoArrowToTable(arrow: arrow.Table, shape: 'object-row-table'): ObjectRowTable;
+export declare function convertGeoArrowToTable(arrow: arrow.Table, shape: 'array-row-table'): ArrayRowTable;
+export declare function convertGeoArrowToTable(arrow: arrow.Table, shape: 'geojson-table'): GeoJSONTable;
+export declare function convertGeoArrowToTable(arrow: arrow.Table, shape: 'columnar-table'): ColumnarTable;
+export declare function convertGeoArrowToTable(arrow: arrow.Table, shape: Table['shape']): Table;
+//# sourceMappingURL=convert-geoarrow-table.d.ts.map

package/dist/lib/table-converters/convert-geoarrow-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-geoarrow-table.d.ts","sourceRoot":"","sources":["../../../src/lib/table-converters/convert-geoarrow-table.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,EACV,KAAK,EACL,aAAa,EACb,aAAa,EACb,cAAc,EACd,YAAY,EACZ,UAAU,EAEX,MAAM,oBAAoB,CAAC;AAa5B;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAC,GAAG,KAAK,CAAC,KAAK,CAe7F;AAED,wBAAiB,+BAA+B,CAC9C,KAAK,EAAE,KAAK,EACZ,OAAO,CAAC,EAAE;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAC,GAC7B,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC,CAoCrC;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,GAAG,UAAU,CAAC;AAC7F,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,gBAAgB,GAAG,aAAa,CAAC;AACnG,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,KAAK,EAAE,kBAAkB,GACxB,cAAc,CAAC;AAClB,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,iBAAiB,GAAG,aAAa,CAAC;AACpG,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,eAAe,GAAG,YAAY,CAAC;AACjG,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,gBAAgB,GAAG,aAAa,CAAC;AACnG,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC"}

package/dist/lib/table-converters/convert-geoarrow-table.js

@@ -0,0 +1,155 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import * as arrow from 'apache-arrow';
+import { convertTable, convertArrowToSchema, convertSchemaToArrow, getTableLength, getTableNumCols, getTableCellAt } from '@loaders.gl/schema-utils';
+import { getGeometryColumnsFromSchema } from '@loaders.gl/geoarrow';
+import { convertGeoArrowGeometryToGeoJSON } from "../geometry-converters/convert-geoarrow-to-geojson.js";
+/**
+ * * Convert a loaders.gl Table to an Apache Arrow Table
+ * @param mesh
+ * @param metadata
+ * @param batchSize
+ * @returns
+ */
+export function convertTableToArrow(table, options) {
+    switch (table.shape) {
+        case 'arrow-table':
+            return table.data;
+        case 'columnar-table':
+        // TODO - optimized implementation is possible
+        // return convertColumnarTableToArrow(table, options);
+        // fall through
+        default:
+            const arrowBatchIterator = makeTableToArrowBatchesIterator(table, options);
+            return new arrow.Table(arrowBatchIterator);
+    }
+}
+export function* makeTableToArrowBatchesIterator(table, options) {
+    const arrowSchema = convertSchemaToArrow(table.schema);
+    const length = getTableLength(table);
+    const numColumns = getTableNumCols(table);
+    const batchSize = options?.batchSize || length;
+    const builders = arrowSchema?.fields.map((arrowField) => arrow.makeBuilder(arrowField));
+    const structField = new arrow.Struct(arrowSchema.fields);
+    let batchLength = 0;
+    for (let rowIndex = 0; rowIndex < length; rowIndex++) {
+        for (let columnIndex = 0; columnIndex < numColumns; ++columnIndex) {
+            const value = getTableCellAt(table, rowIndex, columnIndex);
+            const builder = builders[columnIndex];
+            builder.append(value);
+            batchLength++;
+            if (batchLength >= batchSize) {
+                const datas = builders.map((builder) => builder.flush());
+                const structData = new arrow.Data(structField, 0, batchLength, 0, undefined, datas);
+                yield new arrow.RecordBatch(arrowSchema, structData);
+                batchLength = 0;
+            }
+        }
+    }
+    if (batchLength > 0) {
+        const datas = builders.map((builder) => builder.flush());
+        const structData = new arrow.Data(structField, 0, batchLength, 0, undefined, datas);
+        yield new arrow.RecordBatch(arrowSchema, structData);
+        batchLength = 0;
+    }
+    builders.map((builder) => builder.finish());
+}
+/**
+ * Convert an Apache Arrow table to a loaders.gl Table
+ * @note Currently does not convert schema
+ */
+export function convertGeoArrowToTable(arrowTable, shape) {
+    switch (shape) {
+        case 'arrow-table':
+            return convertArrowToArrowTable(arrowTable);
+        case 'array-row-table':
+            return convertArrowToArrayRowTable(arrowTable);
+        case 'object-row-table':
+            return convertArrowToObjectRowTable(arrowTable);
+        case 'columnar-table':
+            return convertArrowToColumnarTable(arrowTable);
+        case 'geojson-table':
+            return convertArrowToGeoJSONTable(arrowTable);
+        default:
+            throw new Error(shape);
+    }
+}
+/**
+ * Wrap an apache arrow table in a loaders.gl table wrapper.
+ * From this additional conversions are available.
+ * @param arrowTable
+ * @returns
+ */
+function convertArrowToArrowTable(arrowTable) {
+    return {
+        shape: 'arrow-table',
+        schema: convertArrowToSchema(arrowTable.schema),
+        data: arrowTable
+    };
+}
+function convertArrowToArrayRowTable(arrowTable) {
+    const columnarTable = convertArrowToColumnarTable(arrowTable);
+    return convertTable(columnarTable, 'array-row-table');
+}
+function convertArrowToObjectRowTable(arrowTable) {
+    const columnarTable = convertArrowToColumnarTable(arrowTable);
+    return convertTable(columnarTable, 'object-row-table');
+}
+/**
+ * Convert an Apache Arrow table to a ColumnarTable
+ * @note Currently does not convert schema
+ */
+function convertArrowToColumnarTable(arrowTable) {
+    // TODO - avoid calling `getColumn` on columns we are not interested in?
+    // Add options object?
+    const columns = {};
+    for (const field of arrowTable.schema.fields) {
+        // This (is intended to) coalesce all record batches into a single typed array
+        const arrowColumn = arrowTable.getChild(field.name);
+        const values = arrowColumn?.toArray();
+        columns[field.name] = values;
+    }
+    const schema = convertArrowToSchema(arrowTable.schema);
+    return {
+        shape: 'columnar-table',
+        schema,
+        data: columns
+    };
+}
+/**
+ * Convert an Apache Arrow table to a GeoJSONTable
+ * @note Currently does not convert schema
+ */
+function convertArrowToGeoJSONTable(arrowTable) {
+    const schema = convertArrowToSchema(arrowTable.schema);
+    const geometryColumns = getGeometryColumnsFromSchema(schema);
+    // get encoding from geometryColumns['geometry']
+    const encoding = geometryColumns.geometry.encoding;
+    const features = [];
+    // Remove geometry columns
+    const propertyColumnNames = arrowTable.schema.fields
+        .map((field) => field.name)
+        // TODO - this deletes all geometry columns
+        .filter((name) => !(name in geometryColumns));
+    const propertiesTable = arrowTable.select(propertyColumnNames);
+    const arrowGeometryColumn = arrowTable.getChild('geometry');
+    for (let row = 0; row < arrowTable.numRows; row++) {
+        // get the geometry value from arrow geometry column
+        // Note that type can vary
+        const arrowGeometry = arrowGeometryColumn?.get(row);
+        // parse arrow geometry to geojson feature
+        const feature = convertGeoArrowGeometryToGeoJSON(arrowGeometry, encoding);
+        if (feature) {
+            const properties = propertiesTable.get(row)?.toJSON() || {};
+            features.push({ type: 'Feature', geometry: feature, properties });
+        }
+    }
+    return {
+        shape: 'geojson-table',
+        type: 'FeatureCollection',
+        schema,
+        features
+    };
+}
+//# sourceMappingURL=convert-geoarrow-table.js.map